前言¶

在 DeepSeek Harness（DSH）里做长期学习或知识积累，常见做法是自己在工作区堆文档、靠会话里口头约定流程。文档多了缺少统一入口，写入又容易和正式知识混在一起，事后很难审核和回滚。yiyunet 维护的 dsh-learn-skills（npm 包名 @yiyunet/dsh-learn-skills，当前 README 对应 v2 架构）是一个跑在 会话输入区 的学习插件：把「收集 → 提炼 → 关联 → 升级 → 沉淀 → 复用」做成有交互引导、预设管理、审核入库与体系体检的运行时能力，而不是一叠只读方法论文档。下面介绍它是什么、怎么装、怎么用，以及使用时要注意的边界。

这是什么¶

插件在输入区提供 [📖] AI学习 ▾ 入口，与斜杠命令 /learn、以及工作区里由 Agent 引导的自然语言，共用同一套流程实现（不存在两套规则）。它不是给 Agent 新增模型工具的提供者，交互复用宿主已有的 ask-a-question 与命令注册表；也不是自动改写知识库的工具——所有写入都要人先看变更清单再确认。

维护者：yiyunet。分类：工作流。源码与说明：GitHub - yiyunet/dsh-learn-skills；社区目录页：skillhub.cn/plugins/yiyunet/dsh-learn-skills。

四个入口与写入边界¶

README 把四件事的职责写得很死，便于判断「这一步会不会动正式知识」：

与 v1 的关系：v1 偏「一键跑完整流水线」；v2 把中间写入收紧为「产出候选 → 人工裁决 → 再写入」。v2 不提供 v1 技能包的迁移路径，功能不依赖旧版 skills/learn-*。

安装与启用¶

前置条件¶

1. 已安装源码版 deepseek-harness。
2. 已绑定工作区（知识落点；未绑定时菜单会引导，写入无处可放）。

从 npm 安装（推荐）¶

发布包自带 lib/，消费者无需本地构建。装完后需重启 Host（profile 的 dsh.profile.bundles 在启动时读取）：

dsh plugin --profile web add @yiyunet/dsh-learn-skills

检查是否装载成功¶

• 输入区工具行出现 [📖] AI学习 ▾（在「工作区内修改」控件右侧）；
• 斜杠菜单出现 /learn；
• 执行 /learn help 应列出四个入口。

改源码或本地调试时，README 说明可用 dsh plugin --profile web add link:<本仓库绝对路径>，但克隆后需 npm install 与构建（lib/ 不入版本库）。本文不展开构建步骤；需要时见仓库 README「方式 B」。

典型用法¶

按钮¶

点 AI学习 ▾ → 按固定顺序选：初始预设 / 收集提炼 / 关联升级 / 沉淀复用。

• 同一工作区同时只允许一个流程，重复点击会被拒绝，避免并发写入；
• 有「取消」；取消后不再启动后续写入步骤；
• 尚未初始化时，后三项会先识别已有知识库，识别不到才引导先做「初始预设」。

斜杠命令¶

/learn help                 列出四入口
/learn init                 七轮问答（创建预设要在界面上点确认）
/learn distill              从当前会话产出候选
/learn upgrade [批次号]      出变更清单 / 写入
/learn audit                只读体检
/learn rollback <批次号>      回滚某个变更批次

需要确认的步骤（创建预设、写入变更）在命令侧可用 --confirm，默认仍建议在界面上确认，以便先看变更清单。

初始预设之后¶

七题结束后展示画像摘要、预设定位、知识框架草案与拟创建路径，点「确认创建」才会落盘。插件会生成可安装的 preset bundle（位于 <工作区>/.dsh/preset-bundles/<id>/），并给出安装指引；不会代你安装 bundle（安装会在 Host 进程执行新代码，需经官方 plugin_manager 审批或 CLI，插件避免越权）。README 提示：安装 bundle 后新建会话并选择对应预设；新预设不会在当前会话即时热更新。

安装 bundle 的示例（路径替换为生成目录）：

dsh plugin --profile web add link:<刚生成的那个 bundle 目录>

工作区里会出现什么¶

初始化是增量的：目录不存在才建；文件内容相同则跳过，不同则标为 conflict 且不写。主要结构包括：

AGENTS.md              工作区原则与知识入口
index/                 外部原始材料
inbox/                 待审核候选、提炼批次
knowledge/             正式知识（framework.md、nodes/）
data/                  待分析数据
task/                  学习任务与待办
reports/               体检报告与变化记录
.dsh/
  learn-skills/        插件状态：批次账、体检基线、变更日志、断点
  preset-bundles/      本插件生成的预设 bundle

插件状态写在 <工作区>/.dsh/learn-skills/，不写宿主全局配置。回滚依据为 changes/<批次>.json；/learn rollback <批次号> 会删除新建节点、还原被更新节点，但写入之后你又改过的文件不会动。

配置要点¶

cordis.patch.yml 中字段有中文注释。与写入安全相关的默认值：

allowWrite: true           # 总闸；关掉后四项变纯只读（初始预设只出预览）
allowBehaviorRules: false  # 行为规则（预设提示词 / AGENTS.md / 技能）默认不放行

一条知识被认可不会自动变成长期 Agent 指令；影响行为的变更须在配置中显式打开 allowBehaviorRules，并在「关联升级」确认里放行。

适用场景与注意¶

适合谁：已在 DSH 里绑定工作区、希望把学习过程拆成「候选 → 人工审核 → 正式入库 → 只读体检」的开发者或长期自学者；需要与工作区 Agent 预设、知识节点、AGENTS.md 协同，但又想避免会话里随手改坏正式库的人。

务必知晓：

1. 插件以当前 DSH 进程权限运行，安装前请自行查看 源码 与 MIT 许可证（见 package.json）。
2. package.json 声明的 DSH 兼容范围包含 0.2.1-alpha.1、0.2.1-alpha.5、0.2.1-rc.1 等；预设自 DSH 0.1.7-alpha.1 起改为声明式 bundle，只写盘不算预设存在，须安装 bundle 才进名册。
3. 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，DSH 生态理念是「一切皆插件」，本文仅介绍该社区插件本身。

结尾¶

dsh-learn-skills 把学习方法论收拢成输入区四入口与 /learn 命令，用 inbox 与 knowledge 的分层、批次回滚和 18 项只读体检，降低「聊着聊着就改坏知识库」的风险。若你要在 Harness 里长期沉淀可审核、可复用的知识体系，可从 npm 安装 @yiyunet/dsh-learn-skills、绑定工作区后走一遍「初始预设 → 收集提炼 → 关联升级 → 沉淀复用」。

• 目录页：https://www.skillhub.cn/plugins/yiyunet/dsh-learn-skills
• GitHub：https://github.com/yiyunet/dsh-learn-skills