Files
TWBG_Materials/知识库Agent构建.md

674 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 知识库 Agent 构建方案:图文手术导航项目工作区版
问题开始时间2026-05-31-00-11-41
## 0. 本次重建结论
本文件是从当前工作区重新梳理后重建的知识库 Agent 方案。它的目标不是再解释一个抽象 RAG而是把当前目录里的 PDF、Markdown、图片、JSON、成果证明和外部插件材料组织成可持续维护的“文本 + 图片 + 证据”项目知识库。
当前最重要的判断:
- `核心资料汇总_MD` 是本项目第一知识源19 份 Markdown、1718 张图片、76 个结构化 JSON。
- `核心成果汇总` 是事实证明层:伦理、专利、软著、论文、查新、获奖、荣誉、转化公示、设备图片。
- `大赛-待撰写文档及规则``大赛-提供文件清单` 是后续本地待处理任务层:包含智慧医保大赛评分细则、申报书模板和数据目录公告;这两个目录不纳入 Gitea 同步。
- `文档润色流和知识库构建流/llm-wiki.md` 提供持久 Wiki 方法raw sources 只读LLM 维护 wikischema 规定入库/查询/健康检查。
- `claude-scholar-upstream` 提供可借鉴的 KB 命令和 Obsidian 工作流:`/kb-init``/kb-ingest``/kb-promote``/kb-index``/kb-lint``/kb-map``/kb-sync`
## 1. 工作区资产盘点
### 1.1 主目录
| 路径 | 规模 | 内容 | 知识库角色 |
|---|---:|---|---|
| `核心资料汇总` | 19 个 PDF约 114M | 原始项目、论文、PPT、BP、申请书 | Raw source不改动 |
| `核心资料汇总_MD` | 1851 个文件,约 370M | Markdown、图片、JSON、origin/layout PDF | 入库主语料 |
| `核心成果汇总` | 66 个文件,约 207M | 专家共识、伦理、专利、软著、论文、查新、获奖、荣誉、转化 | 事实证明层 |
| `大赛-待撰写文档及规则` | 3 个文件,约 40K | 评分细则、申报书模板、空白基本信息 | 本地待处理,不做 Gitea 同步 |
| `大赛-提供文件清单` | 1 个 DOCX约 80K | 智慧医保大赛数据目录公告 | 本地待处理,不做 Gitea 同步 |
| `文档润色流和知识库构建流` | 约 21M | Claude Scholar、LLM Wiki、执行记录 | Agent 方法层 |
| `.git` | 已绑定远端 | 版本历史 | 备份与审计 |
### 1.2 `核心资料汇总_MD` 结构统计
| 类型 | 数量 | 用途 |
|---|---:|---|
| Markdown | 19 | 主文本阅读、章节抽取、写作素材 |
| 图片 | 1718 | 技术路线图、系统截图、实验图、证明材料、PPT 图 |
| JSON | 76 | Mineru 结构化块、图片/文本定位、自动索引 |
| PDF | 38 | `_origin.pdf``_layout.pdf`,用于复核 |
### 1.3 每份资料的图片量
| 资料 | 图片数 | 建议优先级 |
|---|---:|---|
| `※2026_2_博士毕业-毕业答辩PPT...` | 285 | P0图表和汇报逻辑密集 |
| `※2026_3_博士毕业-论文终稿...` | 252 | P0技术体系和实验证据核心 |
| `2023_微创化手术智能导航平台建设-吕毅` | 186 | P1项目建设和图文导航材料 |
| `BP-2025_...商业计划书(1)` | 183 | P1产品和商业叙事 |
| `BP-2025_...商业计划书` | 178 | P1与上一个可能重复需查重 |
| `2016_省奖推荐书` | 130 | P1历史成果与表达方式 |
| `BP-2024_云链智康...` | 82 | P1产业化与产品逻辑 |
| `2024_陕西省第八届研究生创新成果奖申报书...` | 76 | P1成果奖材料 |
| 其他 11 份 | 17-54 | P2按主题增量入库 |
### 1.4 高频主题初筛
基于 `rg``核心资料汇总_MD``核心成果汇总` 的粗检:
| 关键词 | 命中文件数 | 命中次数 | 说明 |
|---|---:|---:|---|
| 微创 | 92 | 3178 | 核心应用场景 |
| 图文 | 86 | 2717 | 报告生成主线 |
| 腔镜 | 89 | 2220 | 术中视觉主线 |
| 专利 | 85 | 1136 | 成果证明主线 |
| 手术导航 | 59 | 431 | 导航与配准主线 |
| 机器人 | 76 | 323 | 智能感知与协同机器人 |
| 医保 | 40 | 296 | 质控/费控应用 |
| 配准 | 51 | 264 | 磁定位与导航技术 |
| 伦理 | 79 | 299 | 临床/动物研究合规 |
| SurClaw | 19 | 166 | 图文报告系统品牌/项目线 |
| 质控 | 39 | 132 | 临床质量控制 |
| 磁定位 | 10 | 118 | 专项技术路线 |
| 费控 | 18 | 34 | 医保场景补充 |
| 智能感知 | 17 | 27 | 机器人申报线 |
| 自主协同 | 5 | 8 | 机器人申报线较新,需补强 |
## 2. 知识库总体架构
采用 LLM Wiki 三层结构:
```text
Raw Sources
-> LLM-maintained Wiki
-> Schema / Rules
```
### 2.1 Raw Sources
只读,不直接修改:
```text
核心资料汇总/
核心资料汇总_MD/
核心成果汇总/
大赛-待撰写文档及规则/ # local-only, excluded from Gitea sync
大赛-提供文件清单/ # local-only, excluded from Gitea sync
文档润色流和知识库构建流/llm-wiki.md
文档润色流和知识库构建流/claude-scholar-upstream/
```
### 2.2 Wiki
建议新建:
```text
项目知识库/
index.md
log.md
00-项目总览.md
01-任务面板.md
Sources/
CoreMaterials/
Achievements/
Papers/
Patents/
Ethics/
Awards/
BusinessPlans/
Competition/
Images/
Knowledge/
项目脉络.md
技术体系.md
图文手术报告生成.md
腔镜视觉智能分析.md
手术导航与配准.md
磁定位与扶镜系统.md
SurClaw系统.md
医保质控与费控.md
智能感知与自主协同机器人.md
临床价值与合规基础.md
成果转化与知识产权.md
Claim-Evidence-Ledger.md
Figures/
figure-index.md
image-notes/
Writing/
申报书素材库.md
成果总结素材库.md
答辩素材库.md
BP素材库.md
智慧医保大赛申报书素材库.md
专家问答素材库.md
Maps/
project-map.canvas
evidence-map.canvas
figure-map.canvas
Daily/
Archive/
_system/
schema.md
lint-report.md
```
如使用 Obsidian可映射到 Claude Scholar 默认结构:
```text
Research/{project-slug}/
00-Hub.md
01-Plan.md
02-Index.md
Sources/
Knowledge/
Experiments/
Results/Reports/
Writing/
Daily/
Maps/
Archive/
_system/
```
### 2.3 Schema
建议由 `项目知识库/_system/schema.md` 规定:
- 原始资料只读。
- 所有新资料先进入 `Sources/*`
- 所有可写入正文的事实必须有 Evidence Record。
- 图片必须有 Image Note 或至少进入 `figure-index.md`
- `Knowledge/*` 只存稳定综合,不存一次性摘抄。
- `Writing/*` 可以面向申报书、BP、答辩但必须回链证据。
- `index.md` 是内容导航,`log.md` 是时间线。
- 弱证据、商业表达、计划目标、正式证明要分层标注。
## 3. 数据模型
### 3.1 Source Note
每份材料一条源笔记:
```markdown
# Source: {材料名}
source_type: thesis | slides | proposal | grant | business-plan | competition-rule | competition-template | competition-data | patent | ethics | paper | award | media | other
raw_path:
md_path:
origin_pdf:
layout_pdf:
json_paths:
date_ingested:
status: draft | reviewed | promoted
## 一句话摘要
## 材料结构
## 关键事实
## 可复用表达
## 图片与图表
## Evidence Records
## 可提升到 Knowledge 的主题
## 风险与待复核
```
### 3.2 Evidence Record
用于约束事实和写作:
```markdown
## ER-{YYYYMMDD}-{source_slug}-{序号}
Source:
Source type:
Location: 章节 / 页码 / 图片路径 / JSON block id
Claim supported:
Evidence:
Related topics:
Limitations:
Claim strength: speculative | stated | observed | supported | strong
Allowed wording:
Forbidden stronger wording:
Links:
```
强度解释:
| 强度 | 含义 | 可写法 |
|---|---|---|
| `speculative` | 假设、目标、计划 | “拟”“有望”“预期” |
| `stated` | 材料声称 | “材料显示”“项目提出” |
| `observed` | 有图、表、截图、实验描述 | “初步显示”“观察到” |
| `supported` | 多材料一致支持 | “已形成基础”“已实现原型” |
| `strong` | 正式证明 | “已获批”“已授权”“已发表”“已公示” |
### 3.3 Image Note
1718 张图片不能全部一次性精读,应先建立索引,再筛关键图:
```markdown
# Image: {短标题}
image_path:
source_document:
source_md:
page_or_block:
image_type: architecture | workflow | experiment | interface | certificate | product | table | clinical | other
date_ingested:
priority: P0 | P1 | P2
## Visual Description
## OCR / Extracted Labels
## What This Image Supports
## Related Evidence Records
## Reuse Plan
- 可用于:
- 是否需要重绘:
- 建议图注:
## Links
```
### 3.4 Knowledge Page
综合页必须有证据入口:
```markdown
# {主题}
## 当前结论
## 证据表
| Claim | Strength | Evidence Record | Source |
## 主题脉络
## 相关图片
## 可用于写作的表述
## 风险与待补证据
## Links
```
## 4. 入库优先级
### Phase 1建立 Source Inventory
目标:不做深度总结,先完整登记。
输出:
- `项目知识库/index.md`
- `项目知识库/log.md`
- `Sources/CoreMaterials/*.md`
- `Sources/Achievements/*.md`
建议按以下顺序:
1. 博士论文和答辩 PPT。
2. 2026 年申报书、申请表、支撑材料。
3. BP 和成果奖材料。
4. `核心成果汇总` 的专利、软著、伦理、论文、查新、公示。
5. 智慧医保大赛评分细则、申报书模板、数据目录公告。
### Phase 2抽 Evidence Records
优先抽这些主题:
- 图文手术报告生成系统。
- SurClaw。
- 腔镜视觉智能分析。
- 手术导航与配准。
- 磁定位与扶镜系统。
- 医保质控与费控。
- 智慧医保大赛评分点与项目映射。
- 智能感知与自主协同机器人。
- 成果转化与知识产权。
- 临床伦理与合规。
输出:
- `Knowledge/Claim-Evidence-Ledger.md`
- 各主题页中的证据表。
### Phase 3筛图片
先筛 P0/P1 图片,不处理全部 1718 张。
P0 图片:
- 系统架构图。
- 技术路线图。
- 实验结果图。
- 产品/设备实物图。
- 专利、伦理、公示、获奖证明图。
- 答辩 PPT 中解释技术体系的核心图。
输出:
- `Figures/figure-index.md`
- `Figures/image-notes/*.md`
- `Maps/figure-map.canvas`
### Phase 4生成 Knowledge Pages
先建 10 个核心页:
1. `项目脉络.md`
2. `技术体系.md`
3. `图文手术报告生成.md`
4. `腔镜视觉智能分析.md`
5. `手术导航与配准.md`
6. `磁定位与扶镜系统.md`
7. `SurClaw系统.md`
8. `医保质控与费控.md`
9. `智能感知与自主协同机器人.md`
10. `成果转化与知识产权.md`
11. `智慧医保大赛项目映射.md`
### Phase 5生成 Writing Assets
面向真实输出:
- 申报书素材库。
- 科技奖励/成果总结素材库。
- 商业计划书素材库。
- 智慧医保大赛申报书素材库。
- 答辩问答素材库。
- 新闻/传播素材库。
## 5. Ingest / Query / Lint 操作
### 5.1 Ingest
目标:把新资料变成 Source Note、Evidence Record、Image Note 和 Knowledge 更新。
口令:
```text
请入库 `{path}`
1. 不修改原始文件;
2. 建 Source Note
3. 抽 Evidence Records
4. 识别关键图片并建立 Image Notes
5. 更新相关 Knowledge 页面;
6. 更新 index.md 和 log.md
7. 输出新增、更新、待复核清单。
```
### 5.2 Query
目标:优先查 Wiki再回查 raw source。
回答格式:
```markdown
## 结论
## 证据
| 论断 | 证据强度 | Evidence Record | 来源路径 |
## 可直接写入正文的表述
## 风险和待补证据
## 建议更新的知识库页面
```
口令:
```text
请基于知识库回答:本项目围绕“手术图文报告生成”和“手术导航”已经形成哪些可证明成果?
每条结论必须给出 Evidence Record 和原始路径。
```
### 5.3 Lint
目标:防止知识库变成松散摘抄。
检查项:
- Source Note 是否覆盖所有原始材料。
- Evidence Record 是否有来源路径。
- Knowledge 页是否存在无证据强论断。
- Writing 页是否引用 Evidence Record。
- 图片链接是否失效。
- 同一系统名称是否不一致。
- BP 表达是否误升格为科研事实。
- 旧结论是否被新材料更新。
口令:
```text
请对 `项目知识库` 做一次 lint
按 P0/P1/P2 输出断链、孤立页、未证实强论断、重复主题页、图片缺失、证据强度不匹配问题。
```
## 6. 与 Claude Scholar 的映射
| 本方案 | Claude Scholar 组件 | 说明 |
|---|---|---|
| 初始化项目知识库 | `/kb-init``obsidian-project-kb-core` | 创建 Hub、Plan、Index、Sources、Knowledge 等 |
| 导入资料 | `/kb-ingest``obsidian-source-ingestion` | 路由到 `Sources/*` |
| 提升知识 | `/kb-promote` | 从 Source Note 提升到 Knowledge/Writing |
| 文献综合 | `/kb-literature-review``obsidian-literature-workflow` | 后续外部论文进入 Zotero/Obsidian 后使用 |
| 刷新索引 | `/kb-index` | 更新 `02-Index.md` 或本地 `index.md` |
| 生成图谱 | `/kb-map``obsidian-kb-artifacts` | 生成 literature/project/evidence/figure canvas |
| 健康检查 | `/kb-lint` | 检查断链、registry、canvas、索引 |
| 同步维护 | `/kb-sync` | 批量更改后刷新 |
| 日志 | `/kb-log` | 写 Daily 和运行时记忆 |
## 7. 本项目专用主题图谱
建议把主题关系建成如下图谱:
```text
临床微创手术记录问题
-> 图文外科手术记录专家共识
-> 腔镜视觉智能分析
-> 图文手术报告生成 / SurClaw
-> 医保质控与费控
术中空间理解问题
-> 磁定位
-> 多模态融合配准
-> 手术导航
-> 扶镜系统
智能化系统升级
-> 多模态大模型
-> 智能感知
-> 自主协同机器人
成果证明
-> 伦理
-> 专利
-> 软著
-> 论文
-> 查新
-> 获奖
-> 转化公示
```
## 8. 多模态处理细则
### 8.1 Markdown
处理重点:
- 标题层级。
- 表格。
- 图片引用。
- 技术路线。
- 项目目标。
- 创新点。
- 前期基础。
命令:
```bash
rg "SurClaw|图文|手术导航|配准|磁定位|机器人|医保|质控|费控|伦理|专利" 核心资料汇总_MD 核心成果汇总
```
### 8.2 JSON
Mineru JSON 可用于:
- 定位文本块。
- 定位图片和表格。
- 连接图片与上下文。
- 生成 figure inventory。
优先使用:
- `*_content_list_v2.json`
- `*_content_list.json`
### 8.3 图片
处理顺序:
1. 从 Markdown 图片引用和 JSON 生成全量图片索引。
2. 按文件来源和上下文筛 P0/P1。
3. 对 P0 图片逐张查看。
4. 建 Image Note。
5. 关联 Evidence Record。
6. 标注是否适合重绘。
图片复用时必须回答:
- 这张图说明什么?
- 支撑哪个论断?
- 原始来源在哪里?
- 是否能公开使用?
- 是否需要重绘以避免截图质量或版式问题?
### 8.4 成果证明材料
`核心成果汇总` 不一定都有 Markdown因此第一阶段可先建立证明材料索引。
建议分类:
| 类别 | 文件线索 | 证据用途 |
|---|---|---|
| 专家共识 | `0. 专家共识-*` | 证明图文手术记录的行业背景 |
| 伦理 | `1. 伦理审批*``获批伦理/*` | 证明临床/动物研究合规基础 |
| 专利 | `2. 专利_*` | 证明知识产权 |
| 软著 | `3. 软著_*` | 证明软件成果 |
| 论文 | `4. 论文_*` | 证明学术产出 |
| 查新 | `5. 查新-*` | 支持新颖性和查新结论 |
| 专著 | `6. 参编专著-*` | 支持行业影响 |
| 获奖 | `7. 竞赛获奖_*` | 支持成果认可 |
| 荣誉 | `8*个人荣誉*` | 支持团队和个人基础 |
| 转化 | `9. 专利转化-*` | 支持成果转化 |
| 设备图 | `扶镜系统图片/*` | 支持实物原型和场景 |
### 8.5 智慧医保大赛材料
这两个目录是后续本地待处理材料,不纳入 Gitea 同步;正式处理时再单独入库到 `Sources/Competition/`
| 文件 | 类型 | 入库用途 |
|---|---|---|
| `大赛-待撰写文档及规则/2026全国智慧医保大赛初赛评分细则.docx` | `competition-rule` | 建立评分点、章节约束和自审 checklist |
| `大赛-待撰写文档及规则/待撰写-项目申报书.docx` | `competition-template` | 建立正文结构、标题层级、字数和格式约束 |
| `大赛-待撰写文档及规则/基本信息.md` | `competition-template` | 当前为空,可后续补团队、项目名、参赛领域 |
| `大赛-提供文件清单/2026全国智慧医保大赛提供数据目录公告(4).docx` | `competition-data` | 支撑医保数据场景、政策背景和数据价值 |
建议生成专页:
```text
Knowledge/智慧医保大赛评分规则.md
Knowledge/智慧医保大赛数据场景.md
Knowledge/智慧医保大赛项目映射.md
Writing/智慧医保大赛申报书素材库.md
Writing/智慧医保大赛评审自查表.md
```
映射逻辑:
```text
评分细则
-> 背景领域现状 / 提出问题 / 项目思路 / 技术实现 / 实施效果
医保数据目录公告
-> 医保结算 / 费用明细 / 药品追溯 / 医疗数据 / 公共数据
本项目材料
-> SurClaw / 图文手术报告 / 医保质控费控 / 多模态大模型 / 临床合规 / 成果转化
```
## 9. 推荐执行节奏
### Week 1建骨架
```text
1. 创建 `项目知识库/`。
2. 建 `index.md`、`log.md`、`_system/schema.md`。
3. 为 19 份 `核心资料汇总_MD` 建 Source Note。
4. 为 `核心成果汇总` 建成果证据索引。
5. 为大赛评分细则、申报书模板和数据目录公告建 Source Note。
```
### Week 2建证据台账
```text
1. 抽取 100-200 条高价值 Evidence Records。
2. 建 `Claim-Evidence-Ledger.md`。
3. 生成 10 个核心 Knowledge 页。
```
### Week 3建图片层
```text
1. 生成全量 figure-index。
2. 筛 50-100 张 P0/P1 图片。
3. 为关键图片建 Image Notes。
```
### Week 4写作资产
```text
1. 建申报书素材库。
2. 建成果总结素材库。
3. 建智慧医保大赛申报书素材库。
4. 建答辩问答素材库。
5. 做一次 lint。
```
## 10. 最小可执行下一步
如果现在开始真正构建知识库,建议第一条命令/任务是:
```text
请创建 `项目知识库/` 的最小骨架,并只做 inventory
1. 扫描 `核心资料汇总_MD` 的 19 个子目录;
2. 扫描 `核心成果汇总` 的所有证明材料;
3. 扫描 `大赛-待撰写文档及规则` 和 `大赛-提供文件清单`
4. 生成 `项目知识库/index.md`、`项目知识库/log.md`、`项目知识库/_system/schema.md`
5. 暂不做深度总结,只建立路径、类型、优先级和待处理状态。
```
这样可以先把知识库的地基打稳,再进入 Evidence Record 和 Image Note。
## 11. 风险控制
- 不修改 raw source。
- 不把 Mineru 转写视为绝对准确,关键事实要回查 PDF。
- 不把 BP 中的市场宣传语直接当成科研事实。
- 不把计划目标写成已完成成果。
- 不把图片文件名当作图片内容,需要查看或 OCR。
- 不编造专利、软著、伦理、论文和公示状态。
- 不让 `Knowledge/*` 堆满摘抄,必须综合和回链。
- 不让 `Writing/*` 脱离 Evidence Record。