4.6 KiB

Raw Blame History

Issue #69 部署日志 — NAC 公链知识库问答系统

日期：2026-02-28
执行人：NAC_AI AI
状态：✅ 100% 完成

一、任务概述

构建面向所有 NAC 公链用户的公开知识库问答系统，基于 CNNL+RAG 自主推理引擎（零外部 LLM 依赖）。

二、已完成工作

2.1 CNNL+RAG 自主推理引擎

文件：/opt/nac/services/nac-admin/server/nacInferenceEngine.ts

核心能力：

意图识别（7 种意图：合规查询/技术问题/资产上链/XTZH/Charter/CBPP/通用）
关键词提取（NAC 专业术语词典）
MongoDB RAG 检索（正则匹配 + 全文检索双策略）
结构化回答生成（模板化，无需外部 LLM）
支持 7 种语言（中/英/阿/日/韩/法/俄）
处理耗时 < 500ms

修复问题：

query.match is not a function：参数类型不匹配（对象 vs 字符串），已修复
retrieveComplianceRules 调用方式错误，已修复
formatRule 函数字段名错误（content → description，translations.zh → descriptionI18n.zh），已修复

2.2 公开问答 API

路由：publicAsk（无需登录的 publicProcedure）

端点	方法	功能
`publicAsk.query`	mutation	提交问题，返回推理结果
`publicAsk.hotQuestions`	query	获取热门问题列表（7 种语言）
`publicAsk.stats`	query	获取知识库统计（规则数/管辖区/语言数）

修复问题：

stats 查询条件 isActive: true → status: "active"（数据库实际字段）

2.3 MongoDB 索引优化

集合	索引类型	字段
`compliance_rules`	全文索引	`ruleName` + `description`
`agent_conversations`	TTL 索引	`createdAt`（90天过期）
`agent_messages`	普通索引	`conversationId`

2.4 对话历史持久化

已确认工作正常：

agent_conversations：1 条记录（首次测试对话）
agent_messages：2 条记录（问题 + 回答）

2.5 chat.newassetchain.io 公开问答网站

技术栈：React 18 + Vite + 纯 CSS（无外部字体/CDN 依赖）

功能：

左侧知识库统计面板（合规规则 35 / 管辖区 6 / 支持语言 7）
热门问题快速入口（8 个问题，7 种语言）
对话式问答界面
引用来源显示（显示使用的合规规则）
相关问题推荐
多语言切换（中/英/阿/日/韩/法/俄）
响应式设计（移动端适配）

CORS 配置：admin.newassetchain.io nginx 已添加允许 chat.newassetchain.io 的跨域头

三、服务验证

服务	地址	HTTP 状态	测试结果
公开问答网站	https://chat.newassetchain.io	✅ 200	正常
公开问答 API	https://admin.newassetchain.io/api/trpc/publicAsk.query	✅ 200	置信度 85%
知识库统计	https://admin.newassetchain.io/api/trpc/publicAsk.stats	✅ 200	ruleCount: 35
热门问题	https://admin.newassetchain.io/api/trpc/publicAsk.hotQuestions	✅ 200	8 个问题

四、代码仓库

仓库	地址	提交数
nac-chat	https://git.newassetchain.io/nacadmin/nac-chat	1 次提交
NAC_Blockchain	https://git.newassetchain.io/nacadmin/NAC_Blockchain	已更新

五、管理员账号

系统	用户名	密码
admin.newassetchain.io	admin@newassetchain.io	NACAdmin2026!
Gitea	nacadmin	NACadmin2026!
服务器 SSH	root	XKUigTFMJXhH
宝塔面板	cproot	vajngkvf
MongoDB	root	idP0ZaRGyLsTUA3a

六、架构说明

用户问题（chat.newassetchain.io）
    ↓ HTTPS POST
publicAsk.query API（admin.newassetchain.io）
    ↓
nacInferenceEngine.ts
    ├── 意图识别
    ├── 关键词提取（NAC 专业词典）
    ├── RAG 检索（MongoDB compliance_rules）
    │   ├── 正则匹配（主策略）
    │   └── $text 全文检索（辅助策略）
    └── 模板化回答生成
        ↓
结构化响应（answer + confidence + sources + suggestions）

零外部 LLM 依赖：所有推理在 NAC 私有服务器上完成，数据不出境。

七、后续建议

扩充知识库：将白皮书内容（Charter/CNNL/CBPP/XTZH）添加到 compliance_rules 集合
多语言规则：为每条规则添加英文/阿拉伯文翻译
问答日志分析：定期分析用户问题，补充知识库盲点
Charter 语法文档：在 chat 页面添加 Charter 语法速查卡

4.6 KiB Raw Blame History Unescape Escape