研发 FAQ 助手

工程实践 · 脱敏逻辑视图

目标与范围

面向研发人员回答流程与环境问题，把可执行步骤、可复制命令和验收方法放在同一份答案里。回答来源是只读代码库、只读集群信息、飞书文档和 agmem 知识库；来源不足时说明缺口，避免生成看似可用却无法核实的命令。

问答服务通过导航门户提供入口，常见流程沉淀为内置 FAQ；需要当前值的问题再访问只读工具或知识库。SSE 将回答和工具调用逐步传给前端，来源随结果展示；预热 Agent 池降低每次都从头准备执行环境的重复工作。

依据已有项目材料整理的逻辑图；方框表示职责，不表示独立服务数量。

收到问题后先判断是否属于已沉淀的流程，能够直接回答的内容优先返回。追问某个文件或命令的当前准确值时，再进行有限回读。答案按编号步骤、命令代码块、验收点组织，并注明来源，让用户能按顺序执行并判断结果。

执行边界采用默认拒绝：只允许满足结构约束的只读命令，拦截敏感路径和工作区外访问。助手可以解释变更命令，但不会代替用户执行写入。此取舍保留答疑价值，同时把实际变更责任留在已有发布与授权流程内。

既有材料包含提交代码问答、逐条来源展示和工具约束说明。白名单并不等同于完整安全证明；此页只描述已有执行约束与来源机制，不声称助手能够覆盖全部研发问题或自动完成生产操作。

FAQ 的知识检索由 agmem 提供。本地 Agent 可通过 agmemd 比较历史问题向量；问答服务也可直接调用云端。两种入口共享知识索引，但缓存作用域与向量模型分别管理。以下展开本地比较、云端查询分支与知识更新逻辑。

相似度严格过阈值且版本一致才复用本地结果；版本变化后重新查询。云端精确缓存与近义缓存任一命中，均不再访问共享索引。

新增或编辑时间变化的文档进入异步清洗。知识条目落库后推进版本；本地在下一次查询中发现变化，不需要下载整个知识库。