DSH Knowledge Forge：本地优先的自动 Wiki 与技能记忆插件

前言¶

DeepSeek Harness (DSH) 是一个插件优先的 Agent Harness。在 Agent 会话中，包含大量有价值的工程记忆：尝试了什么、用户如何纠正、哪些证据重要、哪些决策生效，以及任务卡在哪里。原始对话记录过于庞大且充满噪音，不适合直接放入长期上下文；而单次总结又难以审计。

DSH Knowledge Forge 是一个原生 DeepSeek Harness 插件，它在不依赖外部记忆服务的情况下，为 DSH 添加自动本地知识蒸馏能力。它将 Agent 对话轨迹转化为渐进式可重用的知识，将操作证据与可重用知识分离。

核心功能¶

该插件提供以下核心能力：

本地优先捕获：在将内容持久化到项目本地 SQLite 之前，会对包含凭证内容的文本进行脱敏，并限制顶层轮次的长度。
会话感知批处理：满足 5 个待处理顶层轮次或等待 60 分钟的条件后，独立处理一个源 Session。
一次性蒸馏：使用一个非交互式、无工具、输出结构严格的后台 Agent 进行知识提炼。
Wiki → 技能演进：将第一个有价值的任务案例存储为可读的 Wiki 页面；当独立案例重复执行同一稳定工作流时，将其提升为原生 DSH Skill。
渐进式披露：在 Agent 上下文中注入紧凑的 Wiki 索引，仅在需要时加载完整的 Wiki 页面或 Skill。
白盒可观测性：保留可读的 Markdown 工件、批处理收据、重试状态，并提供 DSH Web Dashboard。

工作原理¶

Knowledge Forge 维护一个本地知识循环：

捕获已完成顶层轮次：插件监听 DSH 的顶层轮次生命周期，提取用户可见消息、助手输出、精简后的工具证据及相关路径。推理轨迹和完整工具输出不会被复制。
独立调度 Session：当一个 Session 拥有 5 个待处理轮次，或其最旧的待处理轮次等待了 60 分钟时，该 Session 被视为“到期”。不同 Session 的轮次不会合并。
运行一次性后台策展人：Knowledge Forge 启动一个受限的 DSH 子 Agent：仅一次非交互式响应、无工具、严格 JSON 输出模式、覆盖所有输入事件。所有候选和知识文本被视为不可信数据。
蒸馏与演进：策略是渐进式的。首先丢弃查找类、闲聊及未变化的 Skill 复用。如果现有 Skill 覆盖任务，则复用。对于持久化的任务案例，写入或更新 Wiki（包含目标、反馈、证据、决策、结果等）。只有当新独立案例重复相同稳定工作流时，才将其提升为 Skill，此时 Wiki 主体替换为指向 Skill 的轻量级元数据。

安装与启用¶

前置要求：
- Node.js ^22.19.0 || >=24.0.0
- DeepSeek Harness 0.1.0-rc.6

安装步骤：

克隆仓库并安装依赖：

    git clone https://github.com/bill084153-cell/dsh-knowledge-forge.git
    cd dsh-knowledge-forge
    npm install

构建并打包插件：

    npm run build
    npm pack

这将生成一个 `.tgz` 压缩包。

安装到 DSH Web 配置文件：

    dsh plugin --profile web add ./dsh-knowledge-forge-0.1.0.tgz

启动 DSH 并验证：

    dsh web

安装完成后，可以通过以下命令验证：

    dsh plugin --profile web exec dsh-knowledge-forge doctor --workspace .

医生检查应输出工作区路径、本地数据库路径、队列计数、Wiki 计数、Skill 计数以及状态。

存储与保留¶

插件将数据写入当前项目目录，不依赖外部服务：

<project>/.dsh/
├── knowledge-forge/
│   ├── knowledge-forge.sqlite     # 队列状态、批次、收据、重试、全文索引
│   └── wiki/
│       ├── index.md               # 注入到 Agent 上下文的紧凑召回映射
│       └── pages/
│           └── <wiki-id>.md       # 持久化的任务案例或 Skill 元数据
└── skills/
    └── <skill-id>/
        └── SKILL.md               # 原生 DSH Skill

SQLite 用于维护运行时状态（队列、调度、重试），Markdown 文件（Wiki 页面和 SKILL.md）作为长期可读、可编辑的工件。

适用场景与注意事项¶

适用场景：
- 需要在本地管理 Agent 开发记忆，不希望数据上传至云端记忆服务的场景。
- 希望从对话记录中沉淀结构化 Wiki 和可复用 Skill 的场景。

注意事项：
- 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
- 直接从 GitHub 安装 TypeScript DSH 插件需要构建时间。建议先打包 tarball，这能保持安装过程的明确性，并避免在用户 DSH 配置文件中运行仓库构建脚本。
- DSH 理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek 或幻方无官方从属关系。

结语¶

经过上述步骤，DSH Knowledge Forge 已经接入 Harness。它通过 SQLite 和 Markdown 的组合，实现了本地化的知识沉淀与演进。Agent 可以从对话中提取 Wiki，进而转化为 Skill，从而在未来的会话中复用这些知识，减少重复劳动，提升开发效率。

插件目录：https://www.skillhub.cn/plugins/bill084153-cell/dsh-knowledge-forge
项目仓库：https://github.com/bill084153-cell/dsh-knowledge-forge