# 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 私有服务器上完成，数据不出境。

---

## 七、后续建议

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