diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..bf0de96 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +大赛-待撰写文档及规则/ +大赛-提供文件清单/ diff --git a/文档润色Agent.md b/文档润色Agent.md index d3b119a..f05c692 100644 --- a/文档润色Agent.md +++ b/文档润色Agent.md @@ -1,252 +1,357 @@ -# 文档润色 Agent 与 Claude Scholar 学术插件快速索引 +# 文档润色 Agent 操作手册：面向图文手术导航项目材料 -问题开始时间：2026-05-30-16-16-29 +问题开始时间：2026-05-31-00-11-41 -## 0. 本次下载与阅读范围 +## 0. 本次重建结论 -本次已在 `文档润色流和知识库构建流` 中保留并新增以下材料： +本文件是从当前工作区重新梳理后重建的“文档润色 Agent 快速索引”。它不只是 Claude Scholar 插件摘要，而是面向本项目实际材料的写作工作流说明。 -- 既有解包目录：`文档润色流和知识库构建流/claude-scholar` -- 本次 Git 下载目录：`文档润色流和知识库构建流/claude-scholar-upstream` -- GitHub 仓库： -- 当前读取提交：`105a476` +当前工作区的核心事实： -重点阅读文件： +- 原始核心资料：`核心资料汇总`，19 个 PDF，约 114M。 +- 已转换资料：`核心资料汇总_MD`，19 个 Markdown、76 个 JSON、38 个 PDF 副本/版面文件、1718 张图片，约 370M。 +- 成果证据资料：`核心成果汇总`，66 个文件，覆盖专家共识、伦理、专利、软著、论文、查新、专著、获奖、荣誉、转化公示和设备图片，约 207M。 +- 后续本地待处理材料：`大赛-待撰写文档及规则` 与 `大赛-提供文件清单`，包含 3 个 DOCX 和 1 个空 Markdown，约 120K；这两个目录不纳入 Gitea 同步。 +- 外部工作流资料：`文档润色流和知识库构建流`，包含 `claude-scholar`、`claude-scholar-upstream`、`llm-wiki.md` 和执行记录。 +- 当前根目录 Git 状态在本次重建前显示 `文档润色Agent.md` 与 `知识库Agent构建.md` 已删除；本次按用户要求重新生成，不做旧版回滚。 -- `README.zh-CN.md`、`README.md` -- `MCP_SETUP.zh-CN.md` -- `OBSIDIAN_SETUP.zh-CN.md` -- `.claude-plugin/plugin.json` -- `.claude-plugin/marketplace.json` -- `agents/*.md` -- `skills/*/SKILL.md` -- `commands/*.md` -- `rules/claude-scholar-core.md` -- `rules/agents.md` -- `rules/experiment-reproducibility.md` +## 1. 工作区地图 -## 1. 插件定位 +| 路径 | 角色 | 是否原始证据 | 主要用途 | +|---|---|---:|---| +| `核心资料汇总` | 原始项目材料 PDF | 是 | 保留未改动 PDF，作为 Mineru 转换和人工复核来源 | +| `核心资料汇总_MD` | PDF 转 Markdown 后的主语料 | 是，近似转写 | 文本抽取、图片索引、章节重组、写作素材提炼 | +| `核心成果汇总` | 成果证据包 | 是 | 证明伦理、专利、软著、论文、获奖、转化、设备实物等事实 | +| `大赛-待撰写文档及规则` | 智慧医保大赛申报目标与评分规则 | 本地待处理 | 约束后续申报书结构、评分点和字数格式；不做 Gitea 同步 | +| `大赛-提供文件清单` | 智慧医保大赛数据目录公告 | 本地待处理 | 支撑后续医保数据场景、数据价值和政策背景；不做 Gitea 同步 | +| `文档润色流和知识库构建流/claude-scholar-upstream` | 学术插件快照 | 否 | 借用 agents、skills、commands、rules 的工作流设计 | +| `文档润色流和知识库构建流/llm-wiki.md` | LLM Wiki 构建理念 | 否 | 指导持久知识库和索引/日志机制 | +| `Mineru_api_client-V2.py` | PDF 转 Markdown 工具 | 否 | 后续新增 PDF 的批量转换工具 | +| `文档润色Agent.md` | 本文件 | 否 | 指导如何用 Agent 做润色、审查和写作迁移 | +| `知识库Agent构建.md` | 配套知识库方案 | 否 | 指导如何把资料建成文本+图片知识库 | -`claude-scholar` 是面向学术研究、软件开发、实验分析、论文写作和项目知识库维护的半自动研究助手。它的核心理念不是替代研究者，而是把高重复、重结构、易遗忘的研究流程交给 Agent 维护，让人的判断仍处于中心。 +## 2. 文档润色的核心目标 -官方主线工作流可以概括为： +本项目的“润色”不应理解为单纯把文字写得更华丽，而应理解为： ```text -问题 -> 证据 -> 实验 -> 分析 -> 论断 -> 写作 +材料盘点 -> 证据抽取 -> 论断分级 -> 结构重排 -> 风格润色 -> 风险审查 -> 可追溯成稿 ``` -对本项目的价值： +优先级： -- 将 `核心资料汇总_MD` 中的申报书、博士论文、答辩 PPT、商业计划书、项目申请表等材料变成可复用知识。 -- 对文档润色建立 claim-evidence 纪律，避免把材料中的宣传性表述直接当事实。 -- 从过往获批材料、BP、博士论文中提炼结构、表达、证据节点、图文组织和申报叙事。 -- 为后续知识库、标书、成果汇总、答辩稿、项目申请书提供可追溯的写作素材。 +1. 事实准确：所有事实性表述要能回到 `核心资料汇总_MD` 或 `核心成果汇总`。 +2. 逻辑闭环：从临床问题、技术瓶颈、系统方案、验证基础到转化价值。 +3. 证据可追溯：每个强论断都要标注来源文件、章节、页码、图片或证明材料。 +4. 表达自然：减少空泛套话、机械排比和 AI 味。 +5. 面向读者：不同输出面向专家评审、项目管理、产业转化、答辩听众时语气不同。 -## 2. 安装与调用方式 +## 3. 可借用的 Claude Scholar Agent -### 2.1 完整安装 +本地插件快照包含 6 个主要 agents： -```bash -git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar -bash /tmp/claude-scholar/scripts/setup.sh -``` - -说明： - -- `main` 分支面向 Claude Code。 -- Codex CLI 官方建议使用 `codex` 分支。 -- OpenCode 用户使用 `opencode` 分支。 -- 安装器会尽量保留已有配置，把仓库托管的 `CLAUDE.md` 作为 sidecar 文件安装。 - -### 2.2 插件市场安装 - -```text -/plugin marketplace add Galaxy-Dawn/claude-scholar -/plugin install claude-scholar@claude-scholar -``` - -注意： - -- 插件市场安装会加载 skills、commands、agents、hooks。 -- Claude Code 插件不能自动分发 `rules/`，rules 需要手动复制。 -- `CLAUDE.md` 和 `settings.json` 不会自动合并到用户原配置，需要人工选择。 - -### 2.3 选择性安装 - -只复制需要的组件，例如： - -```bash -cp -r /tmp/claude-scholar/skills/research-ideation ~/.claude/skills/ -cp -r /tmp/claude-scholar/skills/ml-paper-writing ~/.claude/skills/ -cp /tmp/claude-scholar/agents/paper-miner.md ~/.claude/agents/ -cp /tmp/claude-scholar/rules/*.md ~/.claude/rules/ -``` - -## 3. Agent 快速索引 - -| Agent | 适用场景 | 核心功能 | 调用方法 | +| Agent | 原始定位 | 本项目改造用法 | 典型触发语 | |---|---|---|---| -| `literature-reviewer` | 新研究主题、文献综述、research gap、proposal 前期论证 | 多源检索论文；通过 Zotero MCP 导入 DOI/arXiv/URL；自动建 collection；读取 PDF 全文；生成综述、gap、研究问题和 BibTeX | 自然语言说“conduct literature review/search papers/identify research gaps”；或用 `/research-init`、`/zotero-review` | -| `paper-miner` | 从优秀论文、申报书、BP、答辩材料中学习写作方式 | 读取 PDF/DOCX/arXiv/网页；抽取写作模式、结构信号、可复用表达、venue signals、rebuttal 表达；写入全局 writing memory | `/mine-writing-patterns `，focus 可为 `general/introduction/method/results/rebuttal/venue` | -| `rebuttal-writer` | 审稿回复、专家意见回复、项目评审修改说明 | 拆分 reviewer comments；分类 Major/Minor/Typos/Misunderstanding；选择 Accept/Defend/Clarify/Experiment；生成逐条回复 | `/rebuttal ` 或自然语言要求“respond to reviewers/analyze review comments” | -| `code-reviewer` | 代码或脚本修改后的质量与安全审查 | 检查 git diff、硬编码密钥、输入验证、性能、测试覆盖、依赖许可、可维护性 | `/code-review` 或代码修改后自动触发 | -| `tdd-guide` | 明确要求测试先行时 | RED -> GREEN -> REFACTOR，小步编写失败测试、最小实现、验证 | `/tdd` 或明确说“用 TDD” | -| `kaggle-miner` | 学习 Kaggle 竞赛方案和工程经验 | 提取 Top solutions、技术路线、代码模板、best practices，按 NLP/CV/Tabular/Time Series/Multimodal 分类 | 提供 Kaggle URL 或请求“learn from Kaggle solutions” | +| `paper-miner` | 从论文中挖掘写作模式 | 从博士论文、申报书、BP、答辩 PPT 中提取章节结构、叙事方式、可复用表达 | “请从这份材料中抽取写作模式” | +| `literature-reviewer` | 文献综述和 research gap | 后续补充手术 AI、腔镜视觉、图文报告、导航机器人相关外部文献 | “请围绕某主题做文献综述并建立证据清单” | +| `rebuttal-writer` | 审稿意见回复 | 模拟项目评审质询、答辩问答、专家意见逐条回复 | “请模拟专家评审并给出逐条回应” | +| `code-reviewer` | 代码审查 | 审查转换脚本、知识库脚本、批处理脚本、备份命令 | “请审查这个脚本是否安全可靠” | +| `tdd-guide` | 测试驱动开发 | 后续若写自动入库脚本，用它拆测试用例 | “请用 TDD 写入库脚本” | +| `kaggle-miner` | Kaggle 技术方案挖掘 | 对本项目不是主线，只有学习竞赛 BP 或算法竞赛材料时使用 | “请学习某竞赛获奖方案” | 本项目最常用组合： ```text -paper-miner -> 学习已有材料的结构与表达 -literature-reviewer -> 补外部文献证据 -review-response / rebuttal-writer -> 模拟专家质询与修改说明 -code-reviewer -> 检查知识库脚本、批处理脚本和备份流程 +paper-miner -> citation/evidence discipline -> writing-anti-ai -> paper-self-review -> rebuttal-style QA ``` -## 4. 学术写作与润色 Skill 索引 +## 4. 可借用的 Claude Scholar Skill -| Skill | 作用 | 本项目推荐用法 | +### 4.1 写作与润色 + +| Skill | 用途 | 本项目用法 | |---|---|---| -| `research-ideation` | 5W1H、gap analysis、Research Question Card、方法选择、项目计划 | 把“手术图文报告/导航/机器人/智能感知”拆成科学问题、应用痛点、证据需求和可交付成果 | -| `ml-paper-writing` | 顶会论文写作、claim ledger、引用核验、LaTeX、related work | 借用 claim-evidence gate：每个结论都要能回到来源材料或文献 | -| `citation-verification` | 核查引用真实性、元数据、DOI/arXiv、claim 是否真的由文献支持 | 写项目背景和立项依据时避免伪引用、弱引用和过强表述 | -| `writing-anti-ai` | 中英文去 AI 味、减少机械连接词和空泛排比 | 润色申报书、成果总结、商业计划书，保留正式但更自然的表达 | -| `paper-self-review` | 投稿前自审，检查结构、逻辑、引用、图表和过度声称 | 用作标书/申报书提交前的专家预审清单 | -| `review-response` | 审稿意见分类、回复策略、逐点答复 | 可迁移为“评审意见预演/答辩问答/修改说明” | -| `doc-coauthoring` | 大型文档协作写作、结构设计、读者测试 | 用于长篇申报书、博士论文摘要、项目申请书重构 | -| `daily-paper-generator` | arXiv/bioRxiv 主题论文日报 | 围绕手术 AI、Surgical VQA、Surgical Report Generation、MIS navigation 做定期文献追踪 | -| `publication-chart-skill` | 论文级图表、pubfig/pubtab、图表 QA | 用于技术路线图、系统架构图、实验结果表的发表级整理 | -| `results-analysis` | 统计分析、图表、effect size、CI、多重比较 | 若后续有实验结果或系统评测表，用它生成可信结果叙述 | -| `results-report` | 把严格分析产物写成内部实验总结 | 将系统评测、临床验证、消融实验写成可引用报告 | -| `nature-writing` | Nature 系列文章的章节写作和论证构建 | 可借用其“高密度、证据前置、叙事清晰”的写作纪律 | -| `nature-polishing` | Nature 风格润色和语言打磨 | 用于英文摘要、英文论文或高端期刊风格材料 | -| `nature-response` | Nature 系列逐点审稿回复 | 可参考其“comment-response tracker”处理专家意见 | -| `nature-data` | 数据可得性、FAIR、数据引用 | 用于数据、代码、伦理、临床资料可得性说明 | -| `expression-skill` | 结论先行、证据支撑、风险提示、下一步明确 | 用于所有项目汇报和阶段总结 | -| `planning-with-files` | 用 `task_plan.md`、`notes.md`、deliverable 文件持久化复杂任务 | 后续知识库构建建议默认启用 | +| `doc-coauthoring` | 大型文档协作写作 | 申报书、成果总结、博士材料重组 | +| `writing-anti-ai` | 去 AI 味、改善表达自然度 | 减少“显著提升、全面赋能、系统推进”等泛化表述 | +| `ml-paper-writing` | 顶会论文写作纪律 | 借用 claim ledger，不照搬 ML 论文模板 | +| `paper-self-review` | 自审结构、逻辑、引用、图表 | 用作项目申报书提交前检查 | +| `nature-writing` | 高密度学术叙事 | 英文摘要、高级别论文/申报材料表达 | +| `nature-polishing` | Nature 风格润色 | 英文材料润色 | +| `nature-response` | 逐点审稿回复 | 专家意见回复模板 | +| `expression-skill` | 结论先行、证据支撑、风险提示 | 所有阶段性汇报和最终总结 | -## 5. 知识库与 Obsidian 相关 Skill +### 4.2 证据、文献和知识库 -| Skill | 功能 | 本项目落地方式 | +| Skill | 用途 | 本项目用法 | |---|---|---| -| `obsidian-project-kb-core` | 初始化和维护项目级 Obsidian KB，管理 Hub、Plan、Index、registry、Daily | 可把本项目绑定成 `Research/TWBG_Materials/` | -| `obsidian-source-ingestion` | 将外部资料路由到 `Sources/Papers/Web/Docs/Data/Interviews/Notes` | 把 `核心资料汇总_MD` 中 19 份材料作为 `Sources/Docs` 或 `Sources/Proposals` | -| `obsidian-literature-workflow` | 从 paper notes 生成 Literature Overview、Method Taxonomy、Research Gaps、Claim Map、literature.canvas | 后续补医学/手术 AI 文献时使用 | -| `obsidian-kb-artifacts` | 生成或修复 canvas、Bases 和派生知识图谱 | 适合生成“项目-成果-论文-专利-系统模块”关系图 | -| `zotero-obsidian-bridge` | Zotero 论文集合到 Obsidian paper notes 的桥接 | 外部文献进入 Zotero 后，再沉淀为 `Sources/Papers` | -| `defuddle` | 网页内容抽取和清理 | 把网页新闻、政策、公示、成果转化页面清理成 Markdown | +| `research-ideation` | 研究问题、gap、证据需求 | 把“图文手术报告/导航/机器人”拆成问题树 | +| `citation-verification` | 引用真实性和 claim 支持关系 | 核查论文、专利、伦理、公示是否支撑对应表述 | +| `obsidian-project-kb-core` | 项目级知识库核心 | 后续建立 `项目知识库` 或 Obsidian vault | +| `obsidian-source-ingestion` | 外部资料入库 | 把 19 份 MD 和成果证据包变成 Source Notes | +| `obsidian-literature-workflow` | 文献综合 | 外部论文进入 `Sources/Papers` 后生成综述 | +| `obsidian-kb-artifacts` | Canvas/Bases/图谱产物 | 生成项目脉络图、证据图、成果图 | +| `zotero-obsidian-bridge` | Zotero 到 Obsidian | 后续管理外部论文和 PDF | +| `defuddle` | 网页清理 | 处理媒体报道、公示网页、政策网页 | -## 6. Slash Command 快速索引 +### 4.3 结果、图表与输出 -### 6.1 文献与研究启动 - -| Command | 用途 | 示例 | +| Skill | 用途 | 本项目用法 | |---|---|---| -| `/research-init` | 初始化研究主题，创建 Zotero collection，生成 Research Question Card、文献综述或 proposal | `/research-init "surgical report generation minimally invasive surgery" focused both` | -| `/zotero-review` | 读取 Zotero collection，做深度文献分析并写入 Obsidian KB | `/zotero-review "Surgical AI Report Generation" deep` | -| `/zotero-notes` | 批量生成 Zotero 论文阅读笔记 | `/zotero-notes "Surgical Navigation" detailed` | +| `results-analysis` | 统计分析与科研图 | 后续系统评测、临床验证、消融实验 | +| `results-report` | 实验报告 | 形成可进入申报书或论文的内部结果总结 | +| `publication-chart-skill` | 论文级图表和表格 | 技术路线图、系统架构图、结果图表重绘 | +| `post-acceptance` | 海报、slides、传播材料 | 答辩、路演、项目汇报 | -### 6.2 写作与润色 +## 5. 可调用命令索引 -| Command | 用途 | 示例 | +### 5.1 文档写作相关 + +| 命令 | 作用 | 本项目示例 | |---|---|---| -| `/mine-writing-patterns` | 从论文、标书、BP 中提取写作模式 | `/mine-writing-patterns 核心资料汇总_MD/.../项目申请书.md introduction` | -| `/rebuttal` | 生成审稿/评审意见逐点回复 | `/rebuttal review-comments.md` | -| `/poster` | 设计学术会议海报 | `/poster` | -| `/presentation` | 创建会议或答辩 slides | `/presentation` | +| `/mine-writing-patterns` | 从材料中学习写法 | `/mine-writing-patterns 核心资料汇总_MD/.../博士论文.md introduction` | +| `/rebuttal` | 逐条回复评审意见 | `/rebuttal 专家意见.md` | +| `/poster` | 学术海报 | 项目成果展海报 | +| `/presentation` | 汇报 slides | 答辩 PPT、路演 PPT | -### 6.3 知识库 +### 5.2 研究和文献相关 -| Command | 用途 | 说明 | -|---|---|---| -| `/kb-init` | 初始化项目知识库 | 创建 `Research/{project-slug}/` | -| `/kb-ingest` | 导入外部材料 | PDF/Markdown/网页/数据集进入 `Sources/*` | -| `/kb-promote` | 将稳定内容提升为 canonical knowledge | 从 source note 或 Daily 提升到 `Knowledge/`、`Writing/` | -| `/kb-literature-review` | 从 `Sources/Papers` 生成文献综合 | 需要 Evidence Records 足够 | -| `/kb-index` | 刷新 `02-Index.md` | 只更新自动索引块 | -| `/kb-map` | 生成/修复 canvas 或关系图 | 默认文献图是 `Maps/literature.canvas` | -| `/kb-lint` | 健康检查 | 查断链、孤立页、registry 覆盖、canvas 有效性 | -| `/kb-sync` | 同步 scaffold、registry、index、Daily | 批量变更后使用 | -| `/kb-status` | 汇总 KB 状态 | 看绑定、计数和关键路径 | -| `/kb-log` | 更新 Daily 和项目运行时记忆 | 每次知识库工作结束后记录 | - -### 6.4 实验与代码 - -| Command | 用途 | +| 命令 | 作用 | |---|---| -| `/analyze-results` | blocker-first 实验后分析，生成统计、图表和结果报告 | -| `/code-review` | 代码质量和安全审查 | -| `/tdd` | 测试驱动开发 | -| `/verify` | 运行验证流程 | -| `/commit` | 辅助提交 | +| `/research-init` | 初始化研究主题、建立 Research Question Card、文献候选和 proposal gate | +| `/zotero-review` | 分析 Zotero collection 并生成文献综述 | +| `/zotero-notes` | 批量生成论文阅读笔记 | -## 7. Zotero MCP 能力 +### 5.3 知识库相关 -`literature-reviewer`、`/research-init`、`/zotero-review`、`/zotero-notes` 依赖 Zotero MCP 时能力最完整。 +| 命令 | 作用 | +|---|---| +| `/kb-init` | 初始化项目知识库 | +| `/kb-ingest` | 导入资料到 Sources | +| `/kb-promote` | 将稳定事实提升到 Knowledge 或 Writing | +| `/kb-literature-review` | 从论文源笔记生成文献综合 | +| `/kb-index` | 刷新索引 | +| `/kb-map` | 生成关系图或 canvas | +| `/kb-lint` | 健康检查 | +| `/kb-sync` | 批量同步 | +| `/kb-status` | 汇总状态 | +| `/kb-log` | 记录当天进展 | -主要工具： +## 6. 本项目材料的润色分工 -- 导入：`zotero_add_items_by_identifier`、`zotero_add_items_by_doi`、`zotero_add_items_by_arxiv`、`zotero_add_item_by_url` -- 读取：`zotero_get_collections`、`zotero_get_collection_items`、`zotero_search_items`、`zotero_get_item_metadata`、`zotero_get_item_fulltext` -- 更新：`zotero_create_collection`、`zotero_move_items_to_collection`、`zotero_update_item`、`zotero_update_note` -- PDF：`zotero_find_and_attach_pdfs`、`zotero_add_linked_url_attachment` -- 清理：`zotero_reconcile_collection_duplicates` +| 材料组 | 输入路径 | 适合任务 | 首选 Agent/Skill | +|---|---|---|---| +| 博士论文与答辩 | `※2026_3_博士毕业...`、`※2026_2_博士毕业...` | 提炼技术体系、方法、实验结果、学术叙事 | `paper-miner`、`ml-paper-writing` | +| 项目申请书 | `2023_...申报书`、`2026_...申报书`、`2026_申请表...` | 迁移立项依据、研究内容、技术路线、团队基础 | `doc-coauthoring`、`paper-self-review` | +| BP/商业计划书 | `BP-*` | 产品定位、市场价值、转化路径、商业表达降噪 | `paper-miner`、`writing-anti-ai` | +| 成果证据 | `核心成果汇总` | 证据支撑、事实核验、附件索引 | `citation-verification`、`obsidian-source-ingestion` | +| 图片和图表 | `核心资料汇总_MD/**/images`、`扶镜系统图片` | 技术路线图、系统架构图、证据图重绘 | `publication-chart-skill`、Image Note 流程 | +| 智慧医保大赛 | `大赛-待撰写文档及规则`、`大赛-提供文件清单` | 按评分细则撰写项目申报书，衔接医保数据目录和 SurClaw/图文报告材料 | `doc-coauthoring`、`paper-self-review`、`writing-anti-ai` | -Codex CLI 配置示例： +## 7. 文档润色标准流程 -```toml -[mcp_servers.zotero] -command = "zotero-mcp" -args = ["serve"] -enabled = true +### Step 1：明确输出类型 -[mcp_servers.zotero.env] -ZOTERO_API_KEY = "your-api-key" -ZOTERO_LIBRARY_ID = "your-user-id" -ZOTERO_LIBRARY_TYPE = "user" -UNPAYWALL_EMAIL = "your-email@example.com" -UNSAFE_OPERATIONS = "all" -NO_PROXY = "localhost,127.0.0.1" -``` +先判断目标文档： -## 8. 本项目推荐调用路径 +- 项目申报书 +- 成果总结 +- 科技奖励材料 +- 博士论文/学位材料 +- 商业计划书 +- 智慧医保大赛项目申报书 +- 答辩 PPT +- 专家意见回复 +- 新闻/宣传材料 -### 8.1 从 `核心资料汇总_MD` 学习材料写法 +不同文档有不同语气： + +| 输出类型 | 语气 | 风险 | +|---|---|---| +| 项目申报书 | 审慎、证据充分、任务明确 | 不能把目标写成已完成事实 | +| 成果总结 | 事实密集、附件可追溯 | 不能夸大应用范围 | +| BP | 清晰、有吸引力、但不过度 | 市场数据必须标注来源 | +| 智慧医保大赛申报书 | 评分点导向、政策合规、医保场景明确 | 不能脱离评分细则和数据目录公告 | +| 答辩 PPT | 结论先行、图表驱动 | 避免长段文字 | +| 论文 | 方法严谨、引用准确 | 不能伪造引用或结果 | + +### Step 2：抽取 claim-evidence + +每个强论断至少包含： ```text -请使用 paper-miner 的方式读取 `核心资料汇总_MD` 中的博士论文、项目申请书、BP 和支撑材料， -抽取以下写作模式： -1. 项目背景如何从临床问题进入技术问题； -2. 系统贡献如何分层描述； -3. 图文报告、手术导航、智能感知、机器人协同的叙事线； -4. 可迁移到新申报书的章节结构和高频表达； -5. 需要证据支撑或避免过度声称的表述。 +Claim: +Source: +Location: +Evidence: +Claim strength: +Allowed wording: +Forbidden stronger wording: ``` -### 8.2 建立 claim-evidence 台账 +推荐强度： + +| 强度 | 含义 | 可用措辞 | +|---|---|---| +| `speculative` | 假设或计划 | “拟探索”“有望”“预期” | +| `stated` | 材料中声称，但未见独立证明 | “材料显示”“项目提出” | +| `observed` | 有图表、实验、系统截图或记录 | “观察到”“初步显示” | +| `supported` | 多来源材料支持 | “已形成”“已实现”“已有基础” | +| `strong` | 有正式证明、授权、公示、论文或伦理 | “已获批”“已授权”“已发表”“已公示” | + +### Step 3：结构重排 + +常用申报书结构： ```text -请读取 `核心资料汇总_MD`，按 Evidence Record 格式建立“项目核心论断-证据台账”： -每条记录包含来源文件、页码或章节、支持的论断、证据强度、允许表述、禁止更强表述。 +临床/行业痛点 + -> 现有方法不足 + -> 本项目关键技术 + -> 前期工作基础 + -> 研究/建设内容 + -> 技术路线 + -> 创新点 + -> 预期成果与转化 ``` -### 8.3 润色项目申报书 +智慧医保大赛申报书结构应优先服从模板和评分细则： ```text -请用 writing-anti-ai + paper-self-review 的方式润色以下段落： -要求保留正式申报语气，减少套话，所有无法由 `核心资料汇总_MD` 支撑的结论标为 [需证据]。 +项目概述 +背景领域的现状分析及问题提出 + -> 背景领域的现状分析 + -> 提出问题 +项目思路 + -> 原理和流程 + -> 创新点 + -> 普遍意义 +技术实现 + -> 技术概况 + -> 技术框架 + -> 技术性能 + -> 技术效率 +实施效果 + -> 现实效果 + -> 展望效果 ``` -### 8.4 专家评审预演 +评分细则强调的高分点： + +- 背景分析：全面性、准确性、深刻性。 +- 提出问题：创新性、先导性、典型性。 +- 项目思路：原理流程清晰、符合政策法规和医保业务流程。 +- 创新点：新视角、新方法。 +- 普遍意义：可推广复制到其他场景。 +- 技术实现：软硬件环境、功能模块、技术规范、新算法、稳定性、安全性、易用性、响应速度。 + +常用成果总结结构： ```text -请使用 review-response 的思路，模拟 5 类专家质询： -技术原创性、临床转化、数据合规、系统可落地性、市场/成果转化。 -对每个问题给出建议答复和需要补强的材料路径。 +问题背景 + -> 核心成果 + -> 技术创新 + -> 证据附件 + -> 应用成效 + -> 知识产权与转化 + -> 后续推广价值 ``` -## 9. 对本项目的使用边界 +### Step 4：风格润色 -- `claude-scholar` 原生更偏计算机科学/AI 研究；本项目可借用流程，但医学、临床、伦理、成果转化相关论断仍需用本项目材料或权威文献核证。 -- `核心资料汇总_MD` 是内部 source of truth，但其中的商业计划书和申报书可能包含宣传性语言，进入知识库时要分清“已验证事实”“项目目标”“预期效果”“商业表达”。 -- 所有写作结论应能回链到具体来源材料、文献、专利、伦理、转化公示或系统截图。 -- 文档润色不是单纯“变漂亮”，优先级应为：事实准确、逻辑闭环、证据可追溯、读者能快速理解价值。 +替换原则： + +- 把“全面赋能、深度融合、显著提升”改成具体对象、指标或使用场景。 +- 把“国际领先、国内首创”改成可证明的差异点，除非有查新或正式证明。 +- 把“解决所有问题”改成“面向某场景缓解某类问题”。 +- 把“已经证实”改成“初步验证/材料显示/拟进一步验证”，除非证据充分。 + +### Step 5：自审 + +提交前检查： + +- 每个章节是否回答一个明确问题。 +- 每个强论断是否有来源。 +- 图表是否有解释和图注。 +- 专利、软著、伦理、论文、获奖是否与正文对应。 +- 是否出现同一系统多个名称且未解释。 +- 是否将 BP 的商业表述误当作科研事实。 + +## 8. 常用调用口令 + +### 8.1 学习写法 + +```text +请使用 paper-miner 的方式读取以下材料，抽取可复用写作模式： +1. 章节结构； +2. 临床痛点到技术方案的过渡； +3. 创新点表达； +4. 图文配合方式； +5. 可复用但需要降噪的商业表达。 +``` + +### 8.2 证据驱动润色 + +```text +请润色以下段落。要求： +1. 保持正式项目申报语气； +2. 删除空泛套话； +3. 所有无法由 `核心资料汇总_MD` 或 `核心成果汇总` 支撑的句子标注 [需证据]； +4. 将过强表述改成与证据强度匹配的表述。 +``` + +### 8.3 专家评审预演 + +```text +请模拟 5 类专家评审意见： +技术原创性、临床可行性、数据合规、系统落地、成果转化。 +每类给出可能质疑、建议回应、需要补充的证据路径。 +``` + +### 8.4 图表复用 + +```text +请从 `核心资料汇总_MD` 和 `核心成果汇总/扶镜系统图片` 中筛选可用于“技术路线”和“研究基础”的图片。 +对每张图输出：图片路径、图意、支撑论断、适合章节、是否建议重绘。 +``` + +### 8.5 形成成稿 + +```text +请基于已建立的 Evidence Records，起草“项目基础与创新性”章节。 +要求每段后用 HTML 注释写出来源 ID，例如： + +``` + +### 8.6 智慧医保大赛申报书 + +```text +请基于 `大赛-待撰写文档及规则/2026全国智慧医保大赛初赛评分细则.docx`、 +`大赛-待撰写文档及规则/待撰写-项目申报书.docx`、 +`大赛-提供文件清单/2026全国智慧医保大赛提供数据目录公告(4).docx`， +结合 `核心资料汇总_MD` 中 SurClaw、医保质控与费控、图文手术报告生成系统材料， +重构一版项目申报书大纲。 +要求每个二级标题对应评分点、可用项目证据、需补充数据。 +``` + +## 9. 红线 + +- 不直接修改 `核心资料汇总` 和 `核心资料汇总_MD` 中的原始转换产物，除非明确要求修复转换错误。 +- 不把商业计划书中的市场表述直接提升为科研结论。 +- 不编造论文、专利、伦理、奖项、发表状态。 +- 不把“拟研发/拟转化”写成“已完成/已应用”。 +- 不在没有证据时使用“首创、领先、唯一、显著”等强词。 +- 不在最终稿中保留无法追溯的关键数字。 + +## 10. 最小可执行工作流 + +如果下一步开始真实润色，建议按以下顺序： + +```text +1. 选定目标文档类型和读者。 +2. 从 `核心资料汇总_MD` 选 3-5 个最相关主材料。 +3. 从 `核心成果汇总` 选对应证明材料。 +4. 如果目标是智慧医保大赛，先读取 `大赛-待撰写文档及规则` 的评分细则和模板。 +5. 建 claim-evidence 台账。 +6. 先重构大纲，再润色段落。 +7. 做自审和专家质询预演。 +8. 最后生成可追溯成稿。 +``` diff --git a/文档润色流和知识库构建流/执行记录.md b/文档润色流和知识库构建流/执行记录.md index fea1e75..6c90a6d 100644 --- a/文档润色流和知识库构建流/执行记录.md +++ b/文档润色流和知识库构建流/执行记录.md @@ -7,3 +7,12 @@ - 下载 Karpathy `llm-wiki.md` 到 `文档润色流和知识库构建流/llm-wiki.md`。 - 阅读并整理 Claude Scholar agents、skills、commands、rules、Obsidian/Zotero 相关文档。 - 更新 `文档润色Agent.md` 和 `知识库Agent构建.md`。 + +## [2026-05-31-00-11-41] 重新梳理工作区并重建 Agent 文档 + +- 记录本次问题开始时间。 +- 重新盘点当前工作区：`核心资料汇总`、`核心资料汇总_MD`、`核心成果汇总`、`文档润色流和知识库构建流`。 +- 核对 `核心资料汇总_MD` 当前包含 19 个 Markdown、76 个 JSON、38 个 PDF 和 1718 张图片。 +- 核对 `核心成果汇总` 当前包含专家共识、伦理、专利、软著、论文、查新、获奖、荣誉、成果转化和设备图片。 +- 发现根目录 `文档润色Agent.md` 与 `知识库Agent构建.md` 在本次执行前处于删除状态；按当前工作区重新生成两份文档。 +- 发现新增未跟踪目录 `大赛-待撰写文档及规则` 与 `大赛-提供文件清单`；用户确认这是后续本地待处理材料，不需要 Gitea 同步，已加入 `.gitignore` 并在两份 Agent 文档中标注。 diff --git a/知识库Agent构建.md b/知识库Agent构建.md index 07ff869..e0b7bcc 100644 --- a/知识库Agent构建.md +++ b/知识库Agent构建.md @@ -1,128 +1,149 @@ -# 知识库 Agent 构建方案：面向 `核心资料汇总_MD` 的文本 + 图片多模态版本 +# 知识库 Agent 构建方案：图文手术导航项目工作区版 -问题开始时间：2026-05-30-16-16-29 +问题开始时间：2026-05-31-00-11-41 -## 0. 本次下载与阅读范围 +## 0. 本次重建结论 -本次已在 `文档润色流和知识库构建流` 中保存： +本文件是从当前工作区重新梳理后重建的知识库 Agent 方案。它的目标不是再解释一个抽象 RAG，而是把当前目录里的 PDF、Markdown、图片、JSON、成果证明和外部插件材料组织成可持续维护的“文本 + 图片 + 证据”项目知识库。 -- Karpathy LLM Wiki 原文：`文档润色流和知识库构建流/llm-wiki.md` -- 原文 URL： -- Claude Scholar Git 下载：`文档润色流和知识库构建流/claude-scholar-upstream` -- 重点参考：`OBSIDIAN_SETUP.zh-CN.md`、`commands/kb-*.md`、`skills/obsidian-*.md`、`skills/zotero-obsidian-bridge/SKILL.md` +当前最重要的判断： -当前本项目材料状态： +- `核心资料汇总_MD` 是本项目第一知识源：19 份 Markdown、1718 张图片、76 个结构化 JSON。 +- `核心成果汇总` 是事实证明层：伦理、专利、软著、论文、查新、获奖、荣誉、转化公示、设备图片。 +- `大赛-待撰写文档及规则` 与 `大赛-提供文件清单` 是后续本地待处理任务层：包含智慧医保大赛评分细则、申报书模板和数据目录公告；这两个目录不纳入 Gitea 同步。 +- `文档润色流和知识库构建流/llm-wiki.md` 提供持久 Wiki 方法：raw sources 只读，LLM 维护 wiki，schema 规定入库/查询/健康检查。 +- `claude-scholar-upstream` 提供可借鉴的 KB 命令和 Obsidian 工作流：`/kb-init`、`/kb-ingest`、`/kb-promote`、`/kb-index`、`/kb-lint`、`/kb-map`、`/kb-sync`。 -- `核心资料汇总_MD` 中已有 Markdown：19 个 -- `核心资料汇总_MD` 中已有图片：1718 个 -- Mineru 输出还包含 `*_content_list.json`、`*_content_list_v2.json`、`*_middle.json`、`*_model.json`、`*_origin.pdf`、`*_layout.pdf` +## 1. 工作区资产盘点 -这些文件足够构建一个“文本 + 图片 + 元数据”的多模态知识库。 +### 1.1 主目录 -## 1. LLM Wiki 核心思想 +| 路径 | 规模 | 内容 | 知识库角色 | +|---|---:|---|---| +| `核心资料汇总` | 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` | 已绑定远端 | 版本历史 | 备份与审计 | -Karpathy 的 `llm-wiki.md` 反对只把材料丢进传统 RAG 后每次提问重新检索。它建议让 LLM 在原始材料和用户之间维护一个持久 Markdown Wiki。 +### 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 -传统 RAG: -Raw documents -> query-time chunk retrieval -> answer - -LLM Wiki: -Raw sources -> LLM-maintained persistent wiki -> query / synthesis / writing +Raw Sources + -> LLM-maintained Wiki + -> Schema / Rules ``` -关键原则： +### 2.1 Raw Sources -- 原始材料不可改，是 source of truth。 -- Wiki 是 LLM 维护的结构化知识层。 -- 每次新增 source，不只是建索引，而是更新实体页、主题页、综合页、矛盾记录、交叉链接和日志。 -- 高价值问答也可以沉淀成新 Wiki 页面，让知识随着使用持续积累。 -- Obsidian 可作为浏览和图谱界面，LLM 负责编辑和维护。 - -对本项目的目标： - -```text -核心资料汇总_MD - -> Source Notes - -> Evidence Records - -> Project Knowledge Pages - -> Writing Assets / Claim Ledger / Figures Index - -> 面向申报、成果总结、答辩、知识问答的持久知识库 -``` - -## 2. 三层架构 - -### 2.1 Raw Sources：原始资料层 - -原则：只读、完整保留、可追溯。 - -建议直接保留现有目录： +只读，不直接修改： ```text 核心资料汇总/ - *.pdf - 核心资料汇总_MD/ - {材料名}/ - {材料名}.md - {材料名}_origin.pdf - {材料名}_layout.pdf - {材料名}_content_list.json - {材料名}_content_list_v2.json - {材料名}_middle.json - {材料名}_model.json - images... +核心成果汇总/ +大赛-待撰写文档及规则/ # local-only, excluded from Gitea sync +大赛-提供文件清单/ # local-only, excluded from Gitea sync +文档润色流和知识库构建流/llm-wiki.md +文档润色流和知识库构建流/claude-scholar-upstream/ ``` -读取策略： +### 2.2 Wiki -- `.md`：主文本来源。 -- `images/` 或同目录图片：图、表、流程图、系统界面、架构图、截图。 -- `*_content_list_v2.json`：段落、图片、表格等结构化块索引，适合自动抽取图文位置。 -- `*_origin.pdf`：原始可核对来源。 -- `*_layout.pdf`：用于排版或页面定位复核。 - -### 2.2 Wiki：LLM 维护层 - -建议新建独立知识库目录，不直接混在 raw source 中： +建议新建： ```text 项目知识库/ index.md log.md 00-项目总览.md - 01-问题与任务板.md + 01-任务面板.md Sources/ - Docs/ - Proposals/ - Theses/ + CoreMaterials/ + Achievements/ + Papers/ + Patents/ + Ethics/ + Awards/ BusinessPlans/ - Slides/ + Competition/ Images/ Knowledge/ 项目脉络.md 技术体系.md - 手术图文报告生成.md - 手术导航与配准.md + 图文手术报告生成.md 腔镜视觉智能分析.md + 手术导航与配准.md + 磁定位与扶镜系统.md SurClaw系统.md - 自主协同机器人.md - 临床价值与应用场景.md + 医保质控与费控.md + 智能感知与自主协同机器人.md + 临床价值与合规基础.md 成果转化与知识产权.md Claim-Evidence-Ledger.md Figures/ figure-index.md image-notes/ Writing/ - 项目申报书素材库.md + 申报书素材库.md 成果总结素材库.md - 答辩PPT素材库.md - 商业计划书素材库.md + 答辩素材库.md + BP素材库.md + 智慧医保大赛申报书素材库.md + 专家问答素材库.md Maps/ project-map.canvas evidence-map.canvas + figure-map.canvas Daily/ Archive/ _system/ @@ -130,7 +151,7 @@ Raw sources -> LLM-maintained persistent wiki -> query / synthesis / writing lint-report.md ``` -如果使用 Claude Scholar 的 Obsidian KB 结构，可采用： +如使用 Obsidian，可映射到 Claude Scholar 默认结构： ```text Research/{project-slug}/ @@ -138,82 +159,44 @@ Research/{project-slug}/ 01-Plan.md 02-Index.md Sources/ - Papers/ - Web/ - Docs/ - Data/ - Interviews/ - Notes/ Knowledge/ Experiments/ - Results/ - Reports/ + Results/Reports/ Writing/ Daily/ Maps/ Archive/ _system/ - registry.md - schema.md - lint-report.md ``` -### 2.3 Schema：Agent 规则层 +### 2.3 Schema -需要一个项目规则文件，建议放在： +建议由 `项目知识库/_system/schema.md` 规定： -```text -项目知识库/_system/schema.md -``` +- 原始资料只读。 +- 所有新资料先进入 `Sources/*`。 +- 所有可写入正文的事实必须有 Evidence Record。 +- 图片必须有 Image Note 或至少进入 `figure-index.md`。 +- `Knowledge/*` 只存稳定综合，不存一次性摘抄。 +- `Writing/*` 可以面向申报书、BP、答辩，但必须回链证据。 +- `index.md` 是内容导航，`log.md` 是时间线。 +- 弱证据、商业表达、计划目标、正式证明要分层标注。 -最小规则： +## 3. 数据模型 -- Raw sources 只读，不修改 `核心资料汇总` 和 `核心资料汇总_MD`。 -- 每个原始材料先生成 `Sources/*` 下的 Source Note。 -- 每个可复用结论必须写成 Evidence Record。 -- 只有通过证据门槛的结论才能进入 `Knowledge/*`。 -- 面向写作的内容进入 `Writing/*`，但必须回链 Evidence Record。 -- 图片必须建立 Image Note，记录路径、来源材料、页码/图号、视觉描述、可支持论断、复用建议。 -- `index.md` 维护内容索引，`log.md` 维护时间线。 -- 不删除历史，过时内容进入 `Archive/` 或在页内标注 superseded。 +### 3.1 Source Note -## 3. 多模态入库流程 - -### 3.1 文本资料入库 - -单份文档处理流程： - -```text -读取 {材料名}.md - -> 识别材料类型 - -> 建 Source Note - -> 抽取关键事实、指标、系统模块、项目目标 - -> 生成 Evidence Records - -> 更新 Knowledge 页 - -> 更新 Writing 素材库 - -> 更新 index.md 与 log.md -``` - -材料类型建议： - -| 类型 | 例子 | 主要抽取内容 | -|---|---|---| -| 博士论文 | `※2026_3_博士毕业-论文终稿...` | 方法、实验、系统设计、创新点、结果、图表 | -| 答辩 PPT | `※2026_2_博士毕业-毕业答辩PPT...` | 概念图、汇报逻辑、成果亮点、答辩表述 | -| 项目申请书 | `2026_申请表...`、`2026_申报书...` | 目标、研究内容、技术路线、预算/团队/转化 | -| 支撑材料 | `2026_项目支撑材料...` | 证据附件、应用基础、前期成果 | -| BP | `BP-2024...`、`BP-2025...` | 产品定位、市场、商业模式、竞争优势 | -| 奖项/申报 | `2016_省奖推荐书`、`研究生创新成果奖` | 成果描述、社会价值、专家认可 | - -Source Note 模板： +每份材料一条源笔记： ```markdown # Source: {材料名} -source_type: +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 @@ -221,22 +204,22 @@ status: draft | reviewed | promoted ## 材料结构 -## 可复用事实 +## 关键事实 -## 可复用表述 +## 可复用表达 -## 图表与图片 +## 图片与图表 ## Evidence Records -## 可进入 Knowledge 的主题 +## 可提升到 Knowledge 的主题 -## 写作复用建议 - -## 限制与风险 +## 风险与待复核 ``` -Evidence Record 模板： +### 3.2 Evidence Record + +用于约束事实和写作： ```markdown ## ER-{YYYYMMDD}-{source_slug}-{序号} @@ -246,43 +229,27 @@ Source type: Location: 章节 / 页码 / 图片路径 / JSON block id Claim supported: Evidence: -Limitations: Related topics: +Limitations: Claim strength: speculative | stated | observed | supported | strong Allowed wording: Forbidden stronger wording: Links: ``` -### 3.2 图片资料入库 +强度解释： -Karpathy 的建议是把图片本地化，因为外链会失效，而且 LLM 需要单独查看关键图片。当前 `核心资料汇总_MD` 已经有 1718 张图片，适合单独建立 `Figures/` 层。 +| 强度 | 含义 | 可写法 | +|---|---|---| +| `speculative` | 假设、目标、计划 | “拟”“有望”“预期” | +| `stated` | 材料声称 | “材料显示”“项目提出” | +| `observed` | 有图、表、截图、实验描述 | “初步显示”“观察到” | +| `supported` | 多材料一致支持 | “已形成基础”“已实现原型” | +| `strong` | 正式证明 | “已获批”“已授权”“已发表”“已公示” | -图片处理流程： +### 3.3 Image Note -```text -扫描 Markdown 图片引用与 content_list JSON - -> 建 figure-index.md - -> 对关键图片建立 Image Note - -> OCR/人工描述图片文本 - -> 记录图中节点、箭头、坐标轴、界面元素、表格字段 - -> 关联 Evidence Record - -> 标注可复用写作位置 -``` - -图片分类： - -| 图片类型 | 处理重点 | -|---|---| -| 系统架构图 | 模块名称、数据流、输入输出、算法组件 | -| 技术路线图 | 任务分解、流程顺序、关键里程碑 | -| 手术图像/腔镜图像 | 病灶、器械、组织、场景、标注含义 | -| 实验结果图 | 坐标轴、分组、指标、趋势、统计显著性 | -| 表格截图 | 表头、指标、对比对象、结论 | -| 产品/BP 图 | 产品定位、用户流程、商业模式、市场数据 | -| 证书/公示/证明材料 | 机构、时间、编号、证明对象、可支撑论断 | - -Image Note 模板： +1718 张图片不能全部一次性精读，应先建立索引，再筛关键图： ```markdown # Image: {短标题} @@ -291,8 +258,9 @@ image_path: source_document: source_md: page_or_block: +image_type: architecture | workflow | experiment | interface | certificate | product | table | clinical | other date_ingested: -image_type: +priority: P0 | P1 | P2 ## Visual Description @@ -300,272 +268,406 @@ image_type: ## What This Image Supports -## Evidence Records +## Related Evidence Records ## Reuse Plan -- 可用于：立项依据 | 技术路线 | 研究基础 | 成果总结 | BP | 答辩 +- 可用于： - 是否需要重绘： -- 重绘建议： +- 建议图注： ## Links ``` -图片调用口令： +### 3.4 Knowledge Page -```text -请读取这份 Markdown 的图片引用和 content_list_v2.json， -筛选出系统架构图、技术路线图、实验结果图和证据证明类图片， -为每张关键图片建立 Image Note，并说明它能支撑哪些项目论断。 -``` - -```text -请查看这张图片，提取图中模块、箭头方向、文字标签、坐标轴和可复用结论， -并判断它适合放入申报书的哪个章节。 -``` - -## 4. Index 与 Log 设计 - -`index.md` 是内容索引，服务于导航和查询。 - -建议字段： +综合页必须有证据入口： ```markdown -# Index +# {主题} -## Sources -| Note | Type | Summary | Status | Key Topics | +## 当前结论 -## Knowledge -| Page | Summary | Evidence Count | Last Updated | +## 证据表 +| Claim | Strength | Evidence Record | Source | -## Figures -| Image Note | Type | Source | Reuse | +## 主题脉络 -## Writing Assets -| Page | Purpose | Linked Evidence | +## 相关图片 + +## 可用于写作的表述 + +## 风险与待补证据 + +## Links ``` -`log.md` 是时间线，服务于追踪和增量维护。条目使用稳定前缀，便于用 `rg` 或 shell 查询： +## 4. 入库优先级 -```markdown -## [2026-05-30-16-16-29] ingest | 初始化核心资料汇总_MD -- Processed: -- Created: -- Updated: -- Risks: -``` +### Phase 1：建立 Source Inventory -## 5. Query / Ingest / Lint 三类操作 +目标：不做深度总结，先完整登记。 -### 5.1 Ingest：新增材料 +输出： + +- `项目知识库/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 -目标：把原始材料变成 Source Note + Evidence Record + Knowledge 更新。 -输入：单个 md/pdf/image/json 或一个文件夹。 -输出：Sources/*、Knowledge/*、Figures/*、index.md、log.md。 +请入库 `{path}`： +1. 不修改原始文件； +2. 建 Source Note； +3. 抽 Evidence Records； +4. 识别关键图片并建立 Image Notes； +5. 更新相关 Knowledge 页面； +6. 更新 index.md 和 log.md； +7. 输出新增、更新、待复核清单。 ``` -建议口令： +### 5.2 Query -```text -请入库 `核心资料汇总_MD/2026_申请表-...`： -1. 建 Source Note； -2. 抽取 Evidence Records； -3. 更新“自主协同机器人”“临床价值与应用场景”“成果转化与知识产权”页面； -4. 建立关键图片 Image Notes； -5. 更新 index.md 和 log.md。 -``` +目标：优先查 Wiki，再回查 raw source。 -### 5.2 Query：面向写作和问答 - -```text -目标：先查 Wiki，再查 Raw Sources，输出可追溯回答。 -``` - -回答格式建议： +回答格式： ```markdown ## 结论 ## 证据 -| Claim | Evidence Record | Source | +| 论断 | 证据强度 | Evidence Record | 来源路径 | -## 可写入正文的表述 +## 可直接写入正文的表述 -## 风险或待补证据 +## 风险和待补证据 -## 建议更新的 Wiki 页面 +## 建议更新的知识库页面 ``` -示例口令： +口令： ```text -请基于知识库回答：SurClaw 手术图文病历报告自动生成系统有哪些核心创新？ -要求每个创新点至少回链 1 条 Evidence Record 和 1 个原始材料路径。 +请基于知识库回答：本项目围绕“手术图文报告生成”和“手术导航”已经形成哪些可证明成果？ +每条结论必须给出 Evidence Record 和原始路径。 ``` -### 5.3 Lint：知识库健康检查 +### 5.3 Lint -周期性检查： +目标：防止知识库变成松散摘抄。 -- `index.md` 是否覆盖所有 Source Note。 -- Source Note 是否都有 Evidence Record。 -- Knowledge 页是否有孤立结论。 -- Writing 页是否引用了 Evidence Record。 -- 图片是否存在断链。 -- 是否有矛盾说法，例如同一系统名称、专利数量、临床应用范围前后不一致。 -- 是否有“强结论但弱证据”的写法。 +检查项： -示例口令： +- Source Note 是否覆盖所有原始材料。 +- Evidence Record 是否有来源路径。 +- Knowledge 页是否存在无证据强论断。 +- Writing 页是否引用 Evidence Record。 +- 图片链接是否失效。 +- 同一系统名称是否不一致。 +- BP 表达是否误升格为科研事实。 +- 旧结论是否被新材料更新。 + +口令： ```text -请对项目知识库做一次 lint： -检查断链、孤立页、未引用证据的论断、重复主题页、过强表述和图片缺失。 -输出 P0/P1/P2 问题清单，并给出建议修复路径。 +请对 `项目知识库` 做一次 lint： +按 P0/P1/P2 输出断链、孤立页、未证实强论断、重复主题页、图片缺失、证据强度不匹配问题。 ``` -## 6. 与 Claude Scholar 命令的对应关系 +## 6. 与 Claude Scholar 的映射 -| 本方案操作 | Claude Scholar 命令/Skill | 用法 | +| 本方案 | Claude Scholar 组件 | 说明 | |---|---|---| -| 初始化知识库 | `/kb-init` / `obsidian-project-kb-core` | 创建 `Research/{project-slug}/` 或项目本地 KB | -| 导入材料 | `/kb-ingest` / `obsidian-source-ingestion` | 把 `核心资料汇总_MD` 路由到 `Sources/Docs` | -| 生成知识页 | `/kb-promote` | 将稳定 Evidence 提升到 `Knowledge/` | -| 生成文献综述 | `/kb-literature-review` | 后续外部论文进入 `Sources/Papers` 后使用 | +| 初始化项目知识库 | `/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` | 生成 `project-map.canvas`、`evidence-map.canvas` | -| 健康检查 | `/kb-lint` | 检查 registry、断链、canvas、索引覆盖 | -| 同步维护 | `/kb-sync` | 批量入库或移动文件后执行 | -| 每日记录 | `/kb-log` | 记录当天处理了哪些材料 | +| 生成图谱 | `/kb-map`、`obsidian-kb-artifacts` | 生成 literature/project/evidence/figure canvas | +| 健康检查 | `/kb-lint` | 检查断链、registry、canvas、索引 | +| 同步维护 | `/kb-sync` | 批量更改后刷新 | +| 日志 | `/kb-log` | 写 Daily 和运行时记忆 | -## 7. 面向本项目的主题页建议 +## 7. 本项目专用主题图谱 -第一批应建主题页： - -| 页面 | 内容 | -|---|---| -| `项目脉络.md` | 从微创手术导航到图文报告生成、智能感知、机器人协同的演进 | -| `核心成果时间线.md` | 项目、论文、专利、成果转化、公示、奖项、BP 时间线 | -| `技术体系.md` | 视觉分析、事件识别、图文生成、导航配准、机器人协同等模块 | -| `手术图文报告生成.md` | SurClaw、术中事件理解、自动报告、医保质控/费控 | -| `手术导航与配准.md` | 磁定位、多模态融合、组织自动配准、术中导航 | -| `腔镜视觉智能分析.md` | CV 模型、场景识别、器械/组织/动作分析 | -| `自主协同机器人.md` | 肝胆胰微创手术智能感知与机器人系统 | -| `临床价值与应用场景.md` | 医保质控、临床记录、教学培训、手术导航、机器人辅助 | -| `成果转化与知识产权.md` | 专利许可、公示、公司化、BP、产品价值 | -| `Claim-Evidence-Ledger.md` | 所有可写入申报书/答辩/成果总结的核心论断 | -| `Figure-Reuse-Index.md` | 可复用图片、图表、系统界面、技术路线图索引 | - -## 8. 推荐执行顺序 - -### Phase 1：初始化 +建议把主题关系建成如下图谱： ```text -1. 建 `项目知识库/` 基础目录。 +临床微创手术记录问题 + -> 图文外科手术记录专家共识 + -> 腔镜视觉智能分析 + -> 图文手术报告生成 / 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. 扫描 `核心资料汇总_MD`，建立 source inventory。 -4. 按材料类型分组。 +3. 为 19 份 `核心资料汇总_MD` 建 Source Note。 +4. 为 `核心成果汇总` 建成果证据索引。 +5. 为大赛评分细则、申报书模板和数据目录公告建 Source Note。 ``` -### Phase 2：批量 Source Notes +### Week 2：建证据台账 ```text -1. 每份 Markdown 生成一个 Source Note。 -2. 先只写摘要、材料结构、关键事实、图片清单。 -3. 不急于生成综合结论。 +1. 抽取 100-200 条高价值 Evidence Records。 +2. 建 `Claim-Evidence-Ledger.md`。 +3. 生成 10 个核心 Knowledge 页。 ``` -### Phase 3：Evidence Records +### Week 3：建图片层 ```text -1. 从 Source Notes 抽取项目核心论断。 -2. 每条论断标注 source、location、claim strength。 -3. 建 `Claim-Evidence-Ledger.md`。 +1. 生成全量 figure-index。 +2. 筛 50-100 张 P0/P1 图片。 +3. 为关键图片建 Image Notes。 ``` -### Phase 4：Knowledge Pages +### Week 4：写作资产 ```text -1. 将重复出现且证据充分的主题提升到 `Knowledge/`。 -2. 建立 wikilink。 -3. 标记矛盾、重复和待补证据。 +1. 建申报书素材库。 +2. 建成果总结素材库。 +3. 建智慧医保大赛申报书素材库。 +4. 建答辩问答素材库。 +5. 做一次 lint。 ``` -### Phase 5：Figures +## 10. 最小可执行下一步 + +如果现在开始真正构建知识库，建议第一条命令/任务是： ```text -1. 从 1718 张图片中筛选关键图。 -2. 建 `figure-index.md`。 -3. 为系统架构图、技术路线图、结果图和证明材料建 Image Notes。 +请创建 `项目知识库/` 的最小骨架，并只做 inventory： +1. 扫描 `核心资料汇总_MD` 的 19 个子目录； +2. 扫描 `核心成果汇总` 的所有证明材料； +3. 扫描 `大赛-待撰写文档及规则` 和 `大赛-提供文件清单`； +4. 生成 `项目知识库/index.md`、`项目知识库/log.md`、`项目知识库/_system/schema.md`； +5. 暂不做深度总结，只建立路径、类型、优先级和待处理状态。 ``` -### Phase 6：Writing Assets +这样可以先把知识库的地基打稳，再进入 Evidence Record 和 Image Note。 -```text -1. 为申报书、成果总结、答辩、BP 建素材库。 -2. 每段素材回链 Evidence Record。 -3. 对弱证据素材标注“只能作为目标/假设/预期”。 -``` +## 11. 风险控制 -### Phase 7：Lint 与备份 - -```text -1. 检查断链、孤立页、弱证据强表述。 -2. 更新 index.md、log.md。 -3. Git 提交并推送 Gitea。 -``` - -## 9. 多模态知识库调用方法 - -### 9.1 查文本 - -```bash -rg "SurClaw|手术图文|导航|机器人|医保质控|成果转化" 核心资料汇总_MD 项目知识库 -``` - -Agent 口令： - -```text -请先读 `项目知识库/index.md` 和 `Claim-Evidence-Ledger.md`， -再回答“项目核心创新是什么”，每个结论必须给出来源路径。 -``` - -### 9.2 查图片 - -```bash -find 核心资料汇总_MD -type f \( -iname '*.png' -o -iname '*.jpg' -o -iname '*.jpeg' \) -``` - -Agent 口令： - -```text -请根据 `Figure-Reuse-Index.md` 找出适合放入“技术路线”和“研究基础”的图片， -逐张查看并说明：图意、支持论断、是否需要重绘、建议图注。 -``` - -### 9.3 生成写作素材 - -```text -请基于 `项目知识库/Knowledge/手术图文报告生成.md` 和 `Claim-Evidence-Ledger.md`， -生成 800 字“项目基础与创新性”草稿。 -要求每段后用 HTML 注释写出 Evidence Record ID。 -``` - -### 9.4 增量更新 - -```text -我新增了几份 PDF/MD，请执行增量入库： -1. 只处理新增材料； -2. 不改 raw source； -3. 更新 Source Note、Evidence Ledger、index 和 log； -4. 报告新增/更新/待人工复核数量。 -``` - -## 10. 风险控制 - -- 不把 `核心资料汇总_MD` 当作可任意重写的知识库层，它是 Mineru 产物和原始来源的近似转写，应保持只读。 -- 商业计划书中的市场规模、收益、产品领先性等表述应标注为“商业表达/待核验”，不能直接提升为强事实。 -- 博士论文和项目申报书中的实验结果可作为项目内部证据，但面向公开写作时仍要核查伦理、数据来源、发表状态和可公开范围。 -- 图片可视信息必须有人工或 Agent 描述，不能只依赖文件名。 -- 高价值综合页要保留反证、限制和“不确定”部分，避免知识库越来越像宣传稿。 -- 每次批量入库后必须更新 `log.md`，并通过 Git 保留版本历史。 +- 不修改 raw source。 +- 不把 Mineru 转写视为绝对准确，关键事实要回查 PDF。 +- 不把 BP 中的市场宣传语直接当成科研事实。 +- 不把计划目标写成已完成成果。 +- 不把图片文件名当作图片内容，需要查看或 OCR。 +- 不编造专利、软著、伦理、论文和公示状态。 +- 不让 `Knowledge/*` 堆满摘抄，必须综合和回链。 +- 不让 `Writing/*` 脱离 Evidence Record。