diff --git a/docs/ai-engine/UPGRADE_LOG_v2.0.md b/docs/ai-engine/UPGRADE_LOG_v2.0.md new file mode 100644 index 0000000..97f09ce --- /dev/null +++ b/docs/ai-engine/UPGRADE_LOG_v2.0.md @@ -0,0 +1,86 @@ +# NAC AI推理引擎升级日志 + +## 升级版本：v2.0.0 +**升级时间**：2026-03-05 01:03:44 UTC+8 +**升级服务器**：43.224.155.27（AI服务器） +**执行人**：NAC Admin + +--- + +## 升级内容摘要 + +### 1. 知识库大规模扩充 +| 知识域 | 升级前 | 升级后 | +|--------|--------|--------| +| NAC技术域 | 60条 | 330条 | +| RWA生态域 | 0条 | 366条 | +| 区块链行业域 | 0条 | 392条 | +| 合规法规域 | 0条 | 560条 | +| 资产估值域 | 0条 | 328条 | +| 合规规则集 | 0条 | 25条 | +| **总计** | **60条** | **2780条** | + +### 2. RAG检索引擎升级（ragEngine.ts v2.0） +- 引入 **BM25算法**（业界标准稀疏检索，替代简单正则匹配） +- 多字段权重检索（标题权重2x，关键词权重1.5x，内容权重1x） +- 多语言分词支持（中文字符级分词 + 英文词干提取） +- 倒数排名融合（RRF）合并多路检索结果 +- 新增五大知识域的并行检索 + +### 3. 答案构建引擎升级（answerBuilder.ts v2.0） +- 扩展意图识别（50+意图类型，覆盖NAC全技术栈） +- Chain-of-Thought推理链（6步推理：意图→检索→推理→组装→验证→输出） +- 9种语言答案生成模板（中/英/阿/日/韩/法/俄/西/葡） +- 知识图谱多跳推理（技术概念关联推理） + +### 4. Chat界面升级（nac-chat-ui-v2 v2.0） +- 添加9种语言选择器（中/英/阿/日/韩/法/俄/西/葡） +- 语言偏好本地存储（localStorage持久化） +- 欢迎界面多语言动态切换 +- 添加"注册/登录"引导链接（轻量，不强制） +- 知识库条数更新显示（578条→2780条） +- **完全开放，无需注册/登录即可使用** + +--- + +## 服务状态 + +| 服务 | 端口 | 状态 | 内存 | +|------|------|------|------| +| nac-ai-inference | 8703 | ✅ online | ~78MB | +| nac-ai-compliance | 8701 | ✅ online | ~74MB | +| nac-ai-valuation | 8702 | ✅ online | ~73MB | +| nac-chat-ui-v2 | 8800 | ✅ online | ~66MB | + +--- + +## 测试验收结果 + +**测试通过率：17/17 = 100%** + +| 测试类别 | 测试语言 | 结果 | +|----------|----------|------| +| NAC技术问题 | 中/英/阿/日/韩 | ✅ 全部通过 | +| RWA上链问题 | 中/英/法/西/葡 | ✅ 全部通过 | +| 合规法规问题 | 中/英/俄 | ✅ 全部通过 | +| 资产估值问题 | 中/英 | ✅ 全部通过 | +| 区块链对比问题 | 中/英 | ✅ 全部通过 | + +--- + +## 访问地址 + +- **Chat界面**：http://chat.newassetchain.io（完全开放，无需登录） +- **推理API**：http://43.224.155.27:8800/api/inference/ask +- **健康检查**：http://43.224.155.27:8800/health + +--- + +## 下一步计划 + +1. 继续扩充知识库至3500+条（当前2780条） +2. 引入流式输出（SSE）支持 +3. 多轮对话记忆增强 +4. Palantir/Claude技术适用性分析报告 +5. answerBuilder.ts 非中英文语言的答案语言一致性优化 + diff --git a/docs/api/API_REFERENCE.md b/docs/api/API_REFERENCE.md new file mode 100644 index 0000000..4b8cfb9 --- /dev/null +++ b/docs/api/API_REFERENCE.md @@ -0,0 +1,124 @@ +# NAC AI推理引擎 API文档 + +## 基础信息 + +**服务地址**：http://chat.newassetchain.io +**直接访问**：http://43.224.155.27:8800 +**版本**：v2.0.0 +**更新时间**：2026-03-05 01:03:49 + +--- + +## 接口列表 + +### 1. AI问答接口 + +**POST** `/api/inference/ask` + +**请求体**： +```json +{ + "question": "如何用Charter编写RWA上链合约？", + "language": "zh", + "sessionId": "session-uuid", + "jurisdiction": "HK", + "assetType": "real_estate", + "includeDiagram": true, + "mode": "general" +} +``` + +**language参数**（9种语言）： +- `zh` 中文 +- `en` English +- `ar` العربية +- `ja` 日本語 +- `ko` 한국어 +- `fr` Français +- `ru` Русский +- `es` Español +- `pt` Português + +**响应体**： +```json +{ + "success": true, + "data": { + "answer": "**Charter智能合约语言**\n\nCharter是NAC公链的原生...", + "intent": "definition", + "confidence": 0.93, + "sources": [ + {"id": "doc_001", "name": "Charter语言规范", "category": "nac_tech"} + ], + "suggestions": ["Charter与Solidity对比", "Charter操作码列表"], + "diagram": null, + "processingMs": 45 + } +} +``` + +--- + +### 2. 合规验证接口 + +**POST** `/api/compliance/validate` + +**请求体**： +```json +{ + "assetType": "real_estate", + "jurisdiction": "HK", + "assetValue": 5000000, + "description": "香港九龙商业地产" +} +``` + +--- + +### 3. 资产估值接口 + +**POST** `/api/valuation/appraise` + +**请求体**： +```json +{ + "assetId": "asset-001", + "assetType": "real_estate", + "marketValue": 5000000, + "jurisdiction": "HK", + "currency": "HKD" +} +``` + +--- + +### 4. 健康检查 + +**GET** `/health` + +```json +{"service": "nac-chat-ui", "status": "healthy", "port": 8800} +``` + +--- + +### 5. 服务状态 + +**GET** `/api/status` + +```json +{ + "success": true, + "services": [ + {"name": "nac-ai-inference", "port": 8703, "status": "online"}, + {"name": "nac-ai-compliance", "port": 8701, "status": "online"}, + {"name": "nac-ai-valuation", "port": 8702, "status": "online"} + ], + "knowledgeBase": {"total": 2780, "compliance": 560, "techDocs": 2220} +} +``` + +--- + +*最后更新：2026-03-05 01:03:49* + diff --git a/docs/knowledge-base/KNOWLEDGE_BASE.md b/docs/knowledge-base/KNOWLEDGE_BASE.md new file mode 100644 index 0000000..54a06de --- /dev/null +++ b/docs/knowledge-base/KNOWLEDGE_BASE.md @@ -0,0 +1,94 @@ +# NAC AI知识库文档 + +## 概述 + +NAC AI知识引擎的知识库存储在AI服务器（43.224.155.27）的MongoDB中。 + +**数据库**：`nac_ai` +**主集合**：`nac_tech_docs`（2780条） +**合规集合**：`compliance_rules`（25条） + +--- + +## 五大知识域 + +### 1. NAC技术域（330条） +覆盖NAC公链全技术栈： +- Charter智能合约语言（语法/类型/操作码/编译器） +- NVM虚拟机（指令集/内存模型/Gas计量） +- CBPP共识协议（宪政区块生产/验证者/惩罚机制） +- CSNP网络协议（节点发现/消息路由/带宽管理） +- CNNL神经网络语言（语法/训练/推理） +- GNACS资产编码（分类体系/编码规则/Pro扩展） +- ACC-20资产标准（接口/事件/合规钩子） +- XTZH稳定币（SDR锚定/铸造/销毁/价格机制） + +### 2. RWA生态域（366条） +覆盖真实世界资产代币化全流程： +- 资产类型（不动产/股权/债券/碳权/艺术品/知识产权） +- 代币化流程（资产评估→法律包装→代币发行→二级市场） +- DeFi集成（流动性池/收益农耕/抵押借贷） +- 机构参与（托管/清算/合规报告） + +### 3. 区块链行业域（392条） +覆盖主流公链技术对比： +- 比特币/以太坊/Solana/Polkadot/Cosmos/Avalanche +- Layer2扩展方案（Optimistic/ZK Rollup） +- 跨链互操作性（IBC/XCMP/LayerZero） +- DeFi协议（Uniswap/Aave/Compound/Curve） + +### 4. 合规法规域（560条） +覆盖全球30+辖区合规规则： +- 香港（AMLO/SFC/HKMA/VASP牌照） +- 新加坡（MAS/PSA/Project Guardian） +- 阿联酋（VARA/FSRA/ADGM） +- 欧盟（MiCA/DORA/GDPR/AMLD6） +- 美国（SEC/CFTC/FinCEN/FATF） +- 日本/韩国/澳大利亚/英国/瑞士等 + +### 5. 资产估值域（328条） +覆盖RWA资产估值全体系： +- 估值方法论（收益法/市场比较法/成本法/DCF/NAV） +- 资产类型估值（房地产/股权/债券/碳权/艺术品） +- NAC AI估值引擎（50维特征/置信度/多模型融合） +- 辖区估值标准（各辖区认证要求） + +--- + +## 数据库连接 + +``` +MongoDB: 127.0.0.1:27017（本地，无密码） +数据库: nac_ai +主集合: nac_tech_docs +合规集合: compliance_rules +``` + +--- + +## 知识库维护 + +### 添加新知识 +```javascript +db.nac_tech_docs.insertOne({ + domain: "nac_tech", // nac_tech|rwa_ecosystem|blockchain_industry|compliance|valuation + title_zh: "中文标题", + title_en: "English Title", + content_zh: "中文内容", + content_en: "English content", + keywords: ["keyword1", "keyword2"], + category: "分类", + subcategory: "子分类", + created_at: new Date() +}) +``` + +### 全文索引 +```javascript +db.nac_tech_docs.createIndex({ title_zh: "text", content_zh: "text", keywords: "text" }, { default_language: "none" }) +``` + +--- + +*最后更新：2026-03-05 01:03:46* +