dsh-plugin-zhishe-bikeng-qa

知设装修避坑问答插件 — 基于 29788 条行业知识库（分片加载）的装修施工避坑智能问答。

装修行业的 DeepSeek Harness 插件，回答水电、瓦工、木工、油漆、防水、验收等全工种避坑问题，以专业顾问口吻给出可操作建议（含具体数据标准）。

功能

工具名	说明
bikeng_qa	装修避坑问答：输入问题返回结构化避坑建议（回答 + 风险等级 + 相关避坑要点）
bikeng_checklist	装修验收清单：按阶段生成标准化验收 checklist（水电/瓦工/木工/油漆/卫浴/地板/竣工）

部署平面

• 目标平面: 会话级工具插件（形态 A）
• 对外发布服务: 否，仅注册 DSH 工具
• 兼容版本: @deepseek-ai/dsh >= 0.1.0-rc.6

安装

# 1. 进入插件目录安装依赖
cd dsh-plugin-zhishe-bikeng-qa
npm install

# 2. 注册到 profile
dsh plugin --profile <profile> add ./dsh-plugin-zhishe-bikeng-qa

# 3. 编辑 agent 预设 YAML，追加：

plugins:
  zhishe-bikeng-qa:
    knowledgePath: data/knowledge/part_*.json   # 知识库路径，支持单文件或通配分片（可选）
    maxResults: 5                        # 最大返回条目数（可选）
    deepAnalysis: true                   # 深度风险分析（可选）
    tone: professional                   # professional=专业顾问 / concise=简洁（可选）

注意：配置为浅层键值替换，修改配置后需新会话生效（预设树在实例创建时锁定）。

配置项

字段	类型	默认值	说明
knowledgePath	string	data/knowledge/part_*.json	知识库路径，支持单文件或通配分片
maxResults	number	5	检索最大返回条目数
deepAnalysis	boolean	true	是否附加风险提示分析
tone	enum	professional	回答风格：professional/concise

知识库格式

知识库文件支持两种格式：

1. 数组格式：[{ "question": "...", "answer": "...", "tags": [...], "category": "..." }]
2. 对象格式：{ "分类名": [{ "question": "...", ... }] }

知识库路径同时支持通配分片加载：如 data/knowledge/part_*.json，加载器按文件名序合并各片为数组；同目录 MAP.json 含 order（原库 id 序）时自动按原库序重排，保证检索稳定序与主库一致。

内置知识库可从 zhishe-a2a-kb 获取（29788 条装修行业实战条目，分片 part_*.json + MAP.json）。

使用示例

用户提问：防水怎么做才不漏水？

工具返回：

• answer: 基于知识库的避坑回答（专业顾问口吻）
• risk_level: 高（命中"漏水"风险词）
• related_pitfalls: 相关避坑要点列表
• source_count: 参考条目数

License

MIT