前言¶
在 DSH 里做研究整理、方案对比或长期知识维护时，常见做法是依赖对话上下文：来源链接散落在多轮回复里，论点与证据的对应关系难以复查，中断后再开新会话往往要从头解释任务。若希望把问题、步骤、实际读过的来源、论点、核查与报告收拢到同一工作案，并在工作区内可恢复、可导出，就需要一套与 Agent 工具链绑定的持久工作流。dsh-knowledge-work 是社区维护者 win10ogod 发布的 DSH 工作流类插件，面向 DSH 0.2.0-rc.2 与 0.2.1-alpha.1，提供「知识工作」Agent 预设与证据导向的持久流程。
这是什么¶
插件仓库：win10ogod/dsh-knowledge-work，目录页：SkillHub 插件页。简介为：Persistent knowledge-work Agent workflows, evidence capture, review and reports for DSH（持久化的知识工作 Agent 流程，含证据捕获、核查与报告）。
安装后包含两个原生插件条目：knowledge-work 负责存储与工作台，preset-knowledge-work 注册 Agent 预设。新对话选择「知识工作」Agent 即可按预设交付任务；左侧「知识工作」页面可查看工作案、进度、原文、比较结果并下载 Markdown 报告，该页以检视为主，暂停、恢复或继续工作仍在对话中向 Agent 提出。
预设保留 DSH 当前的模型与权限，以及原生文件、Shell、技能、搜索、规划与委派等能力，并可与已安装的 agent-browser、Office 技能及 evidence-first-knowledge-work 等搭配使用。
工作流程概览¶
README 将一次知识工作案概括为六步，便于对照工具与交付物：
- 建立目标、范围、工作模式及交付条件。
- 将工作拆成具有依赖关系的步骤。
- 用现有工具读取来源，再保存该次真实工具结果或用户提供的文字。
- 整理论点、引用、推论前提、未知及相反证据；方案比较在相同条件下逐格连到论点。
- 核查步骤完成情况、交付条件覆盖、引用原文及来源更新。
- 产生完整报告；若有缺口，交付明确标示限制的部分成果并暂停。
行为上还有几条与「持久」相关的约定：每次更动保留修订纪录；相同内容的重复更新不增加版本，也不使已完成的核查失效。来源文字不可原地覆写；新增来源取代旧来源时，受影响的引用需要重新核查。模型不会因为只说「稍后继续」就结束仍在进行的工作案——预设在同一回合接续；用户停止、模型请求失败、明确暂停或完成交付时停止续跑。既有工作案需要 resume 才会在新回合重新接手。恢复上下文使用结构化进度与证据索引，原文与完整工作资料由工具按需读取，不重播过去的助手行为轨迹。
核心工具¶
工具仅访问当前工作区的工作案；新会话可通过 knowledge_task list 找回该工作区的既有工作。动态工作状态只加入本插件的 Agent 预设。
| 工具 | 用途 |
|---|---|
knowledge_task |
建立、列出、读取、恢复、暂停、取消工作案 |
knowledge_plan |
定义步骤与依赖关系；修订计划使用版本检查 |
knowledge_step |
记录一步的状态、实际结果及证据关联 |
knowledge_capture |
撷取本会话真实工具结果或真人提供的文字 |
knowledge_claim |
保存陈述、推论、未知、原文引用及分歧 |
knowledge_compare |
用同一组条件比较各方案，保留未知信息 |
knowledge_read |
读取工作案、原文、报告、修订摘要与工具收据 |
knowledge_review |
核查目前版本的交付条件与证据链接 |
knowledge_deliver |
产生完整或部分 Markdown 报告 |
证据范围与核查边界¶
knowledge_capture 保存 DSH 已提交的工具文字或真人消息，不能直接填入臆造的来源正文，也不接受工作案自身输出作为独立证据。原始工具结果和 JSON 解码后的文字可供引用；引用必须实际存在于保存内容中。工具在回传前已截短的数据不会自动补齐，应再次读取需要的片段。图片、音频等需先由可用工具转成可核查的文字。
上述检查能验证来源收据、原文片段与流程完整性，不能自动证明来源正确或论证成立。Agent 仍需阅读、比较适用范围、解释推论并处理相反证据。来源的发布日期与适用范围由 Agent 标注；工具/消息时间与撷取时间分别保存。部分成果不会标记为完整完成。
安装与配置¶
官方说明使用 GitHub Release 的 .tgz 包（资料示例版本文件名为 dsh-knowledge-work-0.1.1.tgz，与 package.json 中 0.1.1 一致）。将 YOUR_PROFILE 换成你的 DSH profile 名：
dsh plugin --profile YOUR_PROFILE add ./dsh-knowledge-work-0.1.1.tgz
插件配置示例：
- id: knowledge-work
config:
autoContinue: true
dataDir: ''
autoContinue: false 可关闭工作案的同回合自动续跑，工具与数据仍保留；每次续跑都是模型请求，会产生相应用量。数据默认保存在 $DSH_HOME/storages/knowledge-work/work.sqlite，可用 dataDir 指定另一目录。停用插件会保留数据。报告下载与工作台使用 DSH 原生连线认证。
运行环境：package.json 要求 Node >=22.13.0，许可证 MIT。peer 依赖包括 @deepseek-ai/dsh-llm 的 0.2.0-rc.2 || 0.2.1-alpha.1 等，安装前请对照本机 DSH 版本。
典型用法¶
安装并在新对话选择「知识工作」Agent 后，可直接用 README 中的任务类型作为起点：
- 研究一个问题，保存支持与反对结论的来源。
- 依相同条件比较方案，区分事实、推论与尚未确认之处。
- 恢复先前工作，重新读取来源并更新受影响的论点。
左侧页面用于查看与下载报告；流程控制（暂停、恢复、继续）在对话中完成。
适用场景与注意¶
适合需要在单一工作区内长期维护研究案、方案对比表和可导出 Markdown 报告的场景，且希望证据来自真实工具输出或用户原文而非模型编造摘要。
插件以当前 DSH 进程的模型、权限与工具能力运行；安装前应阅读 GitHub 仓库 源码与 MIT 许可证，并从 Release 获取与文档一致的 .tgz。SkillHub 目录页为社区插件索引，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」的扩展方式，本插件属于其中的工作流类条目。
结尾¶
dsh-knowledge-work 把知识工作的目标、步骤、证据捕获、论点整理、核查与报告交付串成可持久、可恢复的工作案，并通过专用工具约束证据来源与引用可核对性。若你的 DSH 版本在 README 声明范围内，可从 Release 安装包启用「知识工作」预设，在工作区列表与左侧面板中跟踪进度并导出报告。
- 目录页：https://www.skillhub.cn/plugins/win10ogod/dsh-knowledge-work
- GitHub：https://github.com/win10ogod/dsh-knowledge-work
