前言¶
在 DeepSeek Harness（DSH）里做第三方库或参考代码的「吸收」分析时，常见做法是手写 prompt、靠对话记忆沉淀结论。这样很难复核：报告是否按章节写全、是否带 file:line 证据、大文件是否被刻意避开，往往只能事后人工抽查。
社区里已有类似思路，例如 r32 的 ref → batch 流水线（tasks.jsonl 驱动，产出 batch/out/*.md 吸收报告），以及 hindsight-coding-agents 的知识页与检索。dsh-lib-analyzer 把前者里的「大文件纪律 / 证据优先 / 提取方式」交给工具校验，并把知识页建立在已落盘的报告之上，而不是从对话里回忆——可审计、无后台模型调用、可完全离线重建。
下面介绍该插件的定位、工具链、目录约定与使用注意。
这是什么¶
snow-the/dsh-lib-analyzer（npm 包名 @snow-the/dsh-lib-analyzer，当前版本 0.1.0）由维护者 snow-The 发布，在 SkillHub 上归类为工作流插件。一句话定位：针对 DSH 的库吸收分析——扫描只读参考语料（ref/），按 batch/tasks.jsonl 驱动吸收报告批处理（产出 batch/out/*.md），校验报告纪律（file:line 证据、✓◐✗ 对比标记、固定章节与「提取方式」），并在 .dsh-lib-analyzer/pages/ 维护可按关键词检索的按库知识库。
许可证为 MIT。GitHub 仓库当前星标为 0（以目录页与仓库公开信息为准）。
核心功能¶
插件通过四类工具与一条 Skill 串起完整工作流；工具职责以 README 为准。
| 工具 | 作用 |
|---|---|
libscan |
扫描 ref/<library>：目录树、语言构成、大于 1MB 的大文件列表（大文件纪律）、文档清单；只读。 |
libtasks |
驱动 batch/tasks.jsonl（每行含 id、target、focus、deliverable、output 等）：列出任务及由文件系统推导的状态，或用 --next 输出下一条待办任务的完整内容。 |
libreport |
校验已完成报告（必需章节：概览、关键机制、可吸收设计、落地章节建议、风险与教训、提取方式；✓◐✗ 标记；file:line 证据），通过后把知识页写入 .dsh-lib-analyzer/pages/ 并更新索引。 |
libsearch |
在知识页与已产出报告上做关键词检索（本地、hindsight 式检索，不联网）。 |
Skill library-analysis 描述端到端流程：领取任务 → 阅读项目上下文（adc/src/book/SYNTHESIS）→ 扫描 → 有纪律的只读调研 → 带 provenance 的报告 → libreport 入库 → 下一任务。
设计约束（README「Design rules」）：
- 仅使用 Node 内置能力——不起子进程、不访问网络、不调用模型。
- 所有写入限定在
.dsh-lib-analyzer/内。 - 任务状态由文件系统推导（例如输出文件是否存在），不依赖内存状态。
- 知识库可从报告完整重建。
目录布局¶
在工程根目录下按下列结构组织参考语料与批处理产物：
<project>/
├── ref/ # 只读参考语料
├── batch/
│ ├── tasks.jsonl
│ └── out/*.md # 吸收报告
└── .dsh-lib-analyzer/
├── index.json
└── pages/<lib>.md # 按库知识页
先做 ref/ 与 batch/tasks.jsonl 的准备，再按任务产出 batch/out/*.md，最后用 libreport 把合格报告沉淀为 .dsh-lib-analyzer/pages/ 中的页面；需要回顾时用 libsearch 检索。
安装与兼容版本¶
已抓取资料中的 README 与 package.json 未给出独立的 dsh plugin add … 安装命令行原文。安装与启用方式请以 SkillHub 目录页与 GitHub 仓库当前说明为准：
- 目录页：https://www.skillhub.cn/plugins/snow-The/dsh-lib-analyzer
- 仓库：https://github.com/snow-The/dsh-lib-analyzer
版本与 DSH 兼容性（来自 package.json）：
peerDependencies：@deepseek-ai/dsh>=0.2.0-rc.1engines.dsh：>=0.2.1-rc.2 <0.3.0-0- 插件声明兼容的 DSH 发行版：
0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2；verifiedAgainst为 0.2.1-rc.2
DSH 生态强调「一切皆插件」；SkillHub 是社区目录站点，与 DeepSeek / 幻方无官方从属关系，本文不将其描述为官方应用商店。
典型用法（工作流）¶
README 未提供逐条 shell 示例，典型路径可按工具与 Skill 说明复现：
- 在
ref/<library>放入待分析的参考库（只读语料）。 - 用
libscan了解树结构、语言比例、超过 1MB 的文件与文档清单，避免违反大文件纪律。 - 在
batch/tasks.jsonl中维护任务行；用libtasks查看状态或取--next待办，在 Harness 中完成调研并写出batch/out/下对应 Markdown 报告。 - 报告需满足
libreport的章节、✓◐✗ 与file:line证据要求；校验通过后知识页进入.dsh-lib-analyzer/pages/。 - 后续用
libsearch在知识页与历史报告中检索，而不是依赖会话记忆。
启用 library-analysis Skill 时，上述步骤与「读 adc/src/book/SYNTHESIS 上下文 → 扫描 → 只读研究 → 报告 → 入库 → 下一任务」一致，适合作为 DSH 内的标准吸收分析剧本。
适用场景与注意¶
适合谁： 需要批量、可复核地分析多个参考库（开源库、内部参考实现等），并希望把结论沉淀为带证据链的 Markdown 报告与本地知识库的 DSH 用户。
注意：
- 插件工具侧不联网、不调模型；实际阅读与撰写报告仍依赖你在 Harness 中的 agent 能力，插件负责扫描、任务驱动、校验与索引。
- 插件以当前 dsh 进程权限运行，安装前请自行审阅源码与 MIT 许可证，并确认
ref/中语料的可分发与合规性。 - 任务完成与否以磁盘上输出文件为准，移动或删除
batch/out/*.md会改变libtasks所见的任务状态。
结尾¶
dsh-lib-analyzer 把「参考库 → 批处理吸收报告 → 可校验知识页」做成可重复的工作流：纪律由 libreport 等工具约束，知识库由报告重建，检索留在本地。若你正在 DSH 里做库级吸收而非一次性对话总结，可从目录页与仓库 README 对照安装，并按 ref/、batch/、.dsh-lib-analyzer/ 布局落地。
- SkillHub：https://www.skillhub.cn/plugins/snow-The/dsh-lib-analyzer
- GitHub：https://github.com/snow-The/dsh-lib-analyzer
