| name | knowledge |
| description | QA 项目内置知识库管理能力（基于 llm-wiki 框架）。
触发条件：用户明确提到"知识库"、"wiki"、"消化素材"、"查询知识"、"知识结晶"等，
或通过 `/qa` 命令选择「知识库管理」选项。
|
知识库管理 (Knowledge Management)
基于 llm-wiki 框架的个人知识库构建系统，用于持续积累 QA 测试用例相关的领域知识。
核心能力
- 素材消化 (ingest)：将链接、文件、文本整理成结构化的 wiki 页面
- 知识查询 (query)：基于已有知识库回答问题
- 深度综合 (digest)：跨素材深度分析，生成综述/对比表/时间线
- 健康检查 (lint)：检测孤立页面、断链、矛盾信息
- 结晶化 (crystallize)：将有价值的对话沉淀为知识库页面
工作流路由
| 用户意图 | 工作流 |
|---|
| "消化"、"添加素材"、给链接/文件 | → ingest |
| "查询"、"XX 是什么" | → query |
| "深度分析"、"对比"、"时间线" | → digest |
| "检查知识库"、"健康检查" | → lint |
| "结晶化"、"记进知识库" | → crystallize |
前置检查
- 知识库根路径：
/Users/lanye/Documents/QA/knowledge/
- 配置文件：
knowledge/.wiki-schema.md
- 脚本目录：
knowledge/scripts/
- 模板目录：
knowledge/templates/
脚本调用约定
所有脚本通过 knowledge/scripts/ 调用：
bash knowledge/scripts/source-registry.sh list
bash knowledge/scripts/adapter-state.sh check <source_id>
bash knowledge/scripts/cache.sh check "<文件路径>"
bash knowledge/scripts/lint-runner.sh <wiki_root>
输出语言
根据 .wiki-schema.md 中的「语言」字段：
语言：中文 → 所有输出使用中文语言：English → 所有输出使用英文
当前配置：中文
外挂状态模型
当前仅支持一个可选外挂：网页文章（baoyu-url-to-markdown）。
适配器状态检查：
bash knowledge/scripts/adapter-state.sh check web_article
返回状态：
not_installed：未找到 baoyu-url-to-markdownenv_unavailable：Chrome 调试端口 9222 未监听runtime_failed：自动提取执行失败available：外挂已可用
网页文章外挂说明：
- 依赖：
baoyu-url-to-markdown（bundled，已内置到 knowledge/deps/）
- 环境要求：Chrome 需要以调试模式启动（
--remote-debugging-port=9222）
- 安装提示：
bash knowledge/install.sh --platform claude
- 环境提示：
open -na "Google Chrome" --args --remote-debugging-port=9222
- 回退方式：自动提取失败时，改为复制全文或保存为本地文件后继续
核心主线不因外挂失败而中断——外挂失败时改走手动入口即可。
工作流程详细说明
工作流 1：ingest (消化素材)
隐私自查提示（首次执行时必须显示）：
在开始分析这份素材前，请先确认里面不包含这些敏感内容：
确认无上述内容请回复 y，要中止请回复 n。
处理流程：
- 提取素材内容（URL/文件/文本）
- 保存到
knowledge/raw/ 对应目录
- 缓存检查（跳过未变化的素材）
- Step 1：结构化分析（JSON 格式）
- Step 2：生成 wiki 页面
- 更新 index.md 和 log.md
工作流 2：query (查询)
- 搜索相关 wiki 页面
- 综合回答用户问题
- 引用来源（
[[页面名]] 格式）
- 如引用≥3 个来源，提示是否保存为持久化页面
工作流 3：digest (深度综合)
输出格式（根据触发词选择）：
- 默认 → 深度报告格式
- "对比"/"比较" → 对比表格式
- "时间线"/"按时间" → 时间线格式
工作流 4：lint (健康检查)
- 脚本检查：孤立页面、断链、索引一致性
- AI 判断：矛盾信息、交叉引用缺失、置信度报告
- 输出修复建议
工作流 5：crystallize (结晶化)
将有价值的对话内容沉淀为 knowledge/wiki/synthesis/sessions/{主题}-{日期}.md
与 QA 项目的集成
本知识库是 QA 测试用例生成系统的组成部分：
- 领域知识来源：
knowledge/wiki/entities/ 和 knowledge/wiki/topics/ 为测试用例生成提供领域知识
- 需求文档沉淀：PRD、Axure、Figma 等需求文档可通过 ingest 工作流转化为知识库
- 测试用例复用：知识库中的实体和主题可用于测试用例的模块归属判断
触发边界：
- 用户通过
/qa → 「知识库管理」选项触发
- 用户直接使用 "消化"、"查询"、"知识库" 等关键词触发
- 单纯 "总结这篇文章" 不触发，需明确 "消化到知识库"
相关文档
