张胜宇
bc61d5c579
## 为什么做这一步 权威文档 74 份此前**只在本机**，评审者 clone 分支后看不到任何设计文档；而仓库里那两份同名目录 是 **2026-09-16 之前的过期副本，连文件名都是旧的**（无体系编号）。本次按「**权威覆盖过期**」入库。 ## 入库内容 | 目录 | 文件数 | 体积 | 说明 | |---|---|---|---| | `客服agent/` | 24 | 0.77 MB | `D2.1`~`D2.6` 对外交付四件套 + 演示脚本/答辩报告 + `_build` 构建工具 | | `开发文档/` | 50 | 2.16 MB | `D1.x` 索引与决策、`D3.x` 方案、`D4.x` 清除与重构留痕、`D5.x` 业务流程、`D6.x` 业务事实基座、`D7.x` 交付物、`D8.x` 规范 | **旧的过期副本整体移除**（`客服Agent执行Todolist.md` → `D2.1-客服Agent执行Todolist.md` 之类 的改名 + 新增 `D2.5`/`D2.6`），入库后目录内容与权威副本**逐文件一致（零差异，已复核）**。 ## 入库前的安全扫描（必须留痕） - 扫描规则：`sk-` 类密钥 / `Bearer` 长串 / `password=`、`api_key=` 赋值 / 会话中出现过的两把明文 key 片段。 - 结论：**真实密钥只出现在 `.env`**（已被 `.gitignore` 命中，未入库）；`.env.example` 与 `config/risk.env.example` 只有**空占位**。 - 文档内唯一命中是 `D3.1` 里一处**截断的示例 JWT**（`Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`）， 末尾带省略号，是接口文档的示意值，**不是可用凭据**。
112 lines
5.5 KiB
JSON
112 lines
5.5 KiB
JSON
{
|
||
"out_file": "D2.4-客服Agent知识库设计方案.html",
|
||
"body_file": "D:\\桌面\\金融\\_body_kb.html",
|
||
"title": "南方基金·智能服务系统 — 智能客服 Agent 知识库设计方案",
|
||
"subtitle": "客服 Agent 知识库方案 v1.2 · 三集合",
|
||
"badge": "v1.2 · 三集合 · 三档可见性",
|
||
"topbar": "智能服务系统 — 智能客服 Agent 知识库设计方案",
|
||
"eyebrow": "专项设计方案 · 四份交付文档之一",
|
||
"doctitle": "南方基金·智能服务系统<br>智能客服 Agent 知识库设计方案",
|
||
"closing": "v1.2 三集合 · 三档可见性 · 与身份模型对齐版",
|
||
"meta": [
|
||
["体系编号", "D2.4 · 二、对外交付 · 编号体系见 开发文档/D1.1-文档索引与权威声明.md §4.0"],
|
||
["文档版本", "v1.2（与身份模型对齐 · 自洽性修正）"],
|
||
["文档定位", "四份交付文档之一 · 知识库分册"],
|
||
["服务对象", "访客（未登录）+ 已登录客户"],
|
||
["承载模块", "客服 Agent 检索子模块"],
|
||
["上游依据", "客服 Agent 需求文档 v2.4 / MVP 定稿 / docs-33·34"],
|
||
["文档密级", "内部公开"]
|
||
],
|
||
"toc": [
|
||
{"g": "0. 文档定位与阅读指引", "items": [
|
||
["0.1-目的与范围", "0.1 目的与范围"],
|
||
["0.2-上游依据与冲突裁决", "0.2 上游依据与冲突裁决"],
|
||
["0.3-术语与符号约定", "0.3 术语与符号约定"],
|
||
["0.4-文档修订记录", "0.4 文档修订记录"]
|
||
]},
|
||
{"g": "1. 设计目标与约束", "items": [
|
||
["1.1-业务目标", "1.1 业务目标"],
|
||
["1.2-硬约束条件", "1.2 硬约束条件"],
|
||
["1.3-设计原则", "1.3 设计原则"],
|
||
["1.4-范围边界", "1.4 范围边界"],
|
||
["1.5-与身份模型的接口", "1.5 与身份模型的接口"]
|
||
]},
|
||
{"g": "2. 核心设计思路", "items": [
|
||
["2.1-一条主线", "2.1 一条主线"],
|
||
["2.2-三个基本判断", "2.2 三个基本判断"]
|
||
]},
|
||
{"g": "3. 总体架构", "items": [
|
||
["3.1-双链路", "3.1 双链路对比"],
|
||
["3.2-组件清单与职责", "3.2 组件清单与职责"],
|
||
["3.3-数据流总览", "3.3 数据流总览"]
|
||
]},
|
||
{"g": "4. 知识组织与可见性模型", "items": [
|
||
["4.1-三集合划分", "4.1 三集合划分"],
|
||
["4.2-可见性三档模型", "4.2 可见性三档模型"],
|
||
["4.3-档位判定优先级", "4.3 档位判定优先级"],
|
||
["4.4-单文件多档内容的拆档规则", "4.4 拆档规则"],
|
||
["4.5-知识入库清单", "4.5 知识入库清单"]
|
||
]},
|
||
{"g": "5. 八个关键模块", "items": [
|
||
["5.1-文档解析与分块模块", "5.1 解析与分块"],
|
||
["5.2-档位标注模块", "5.2 档位标注模块"],
|
||
["5.3-向量化与入库模块", "5.3 向量化与入库"],
|
||
["5.4-检索模块", "5.4 检索模块（fail-closed）"],
|
||
["5.5-跨集合回退模块", "5.5 跨集合回退"],
|
||
["5.6-阈值与相关性策略", "5.6 阈值与相关性策略"],
|
||
["5.7-来源引用模块", "5.7 来源引用模块"],
|
||
["5.8-降级与词法回退", "5.8 降级与词法回退"]
|
||
]},
|
||
{"g": "6. 数据流程", "items": [
|
||
["6.1-离线入库链路", "6.1 离线入库链路（七步）"],
|
||
["6.2-在线检索链路", "6.2 在线检索链路（八步）"],
|
||
["6.3-异常分支与处置", "6.3 异常分支与处置"]
|
||
]},
|
||
{"g": "7. 八项技术选型决策", "items": [
|
||
["7.1-决策总览", "7.1 决策总览"],
|
||
["7.2-决策-2-可见性的实现方式", "7.2 决策 2 · 可见性实现方式"],
|
||
["7.3-其余七项决策要点", "7.3 其余七项决策要点"]
|
||
]},
|
||
{"g": "8. 性能与扩展性", "items": [
|
||
["8.1-容量规划", "8.1 容量规划"],
|
||
["8.2-性能目标", "8.2 性能目标"],
|
||
["8.3-优化手段", "8.3 优化手段"],
|
||
["8.4-扩展性设计", "8.4 扩展性设计"],
|
||
["8.5-性能验证", "8.5 性能验证"]
|
||
]},
|
||
{"g": "9. 安全与权限控制", "items": [
|
||
["9.1-三道防线", "9.1 三道防线"],
|
||
["9.2-越权风险清单", "9.2 越权风险清单"],
|
||
["9.3-隐私与脱敏", "9.3 隐私与脱敏"],
|
||
["9.4-输入侧安全", "9.4 输入侧安全"],
|
||
["9.5-审计与追溯", "9.5 审计与追溯"]
|
||
]},
|
||
{"g": "10. 部署与运维", "items": [
|
||
["10.1-落位与启动自检", "10.1 落位与启动自检"],
|
||
["10.2-配置项清单", "10.2 配置项清单"],
|
||
["10.3-入库操作-SOP", "10.3 入库操作 SOP"],
|
||
["10.4-知识更新与失效", "10.4 知识更新与失效"],
|
||
["10.5-监控指标", "10.5 监控指标"],
|
||
["10.6-备份与恢复", "10.6 备份与恢复"],
|
||
["10.7-故障处置预案", "10.7 故障处置预案"]
|
||
]},
|
||
{"g": "11. 验收与测试", "items": [
|
||
["11.1-测试矩阵", "11.1 测试矩阵"],
|
||
["11.2-验收标准", "11.2 验收标准"],
|
||
["11.3-端到端验证脚本", "11.3 端到端验证脚本"]
|
||
]},
|
||
{"g": "12. 待确认与已识别问题", "items": [
|
||
["12.1-待确认事项清单", "12.1 待确认事项清单"],
|
||
["12.2-已识别的问题及处理状态", "12.2 已识别的问题及处理状态"],
|
||
["12.3-改进建议", "12.3 改进建议"]
|
||
]},
|
||
{"g": "附录", "items": [
|
||
["附录A-集合-Schema-定义", "附录A 集合 Schema 定义"],
|
||
["附录B-可见性标注规则表", "附录B 可见性标注规则表"],
|
||
["附录C-配置项全集", "附录C 配置项全集"],
|
||
["附录D-检索参数速查", "附录D 检索参数速查"],
|
||
["附录E-参考资料索引", "附录E 参考资料索引"]
|
||
]}
|
||
]
|
||
}
|