前言¶

在 DSH 里跑通一套部署、排查或发布流程，往往要反复口述步骤；换一个新会话，又得从头对齐上下文。把步骤记在笔记或仓库 README 里能缓解一部分问题，但模型不会自动把这些文档当成「可按指令执行的技能」来发现与加载。下面介绍 dsh-plugin-workflow-library：在某次会话里把流程跑通后，用自然语言触发固化，插件在配置的目录里生成结构化工作流；后续会话中，这些工作流作为技能出现在目录中，按需加载执行。

这是什么¶

dsh-plugin-workflow-library 是 DeepSeek Harness 的工作流类插件，由维护者 zh-Littlebird（Hu Zhang）发布，当前 npm 包版本为 0.1.0，许可证 MIT。

定位可以概括为：把可重复的 DSH 流程沉淀成可复用资产。对模型说一句「把这个流程固化一下」，插件会在你配置的根目录下新建工作流文件夹；下个会话里说「按上次那套来」，模型从技能目录加载说明后照做。插件归属 DSH 社区生态（SkillHub 目录与 GitHub 仓库），与 DeepSeek / 幻方无官方从属关系。

核心功能¶

保存工作流（workflow_save）¶

模型在会话中调用 workflow_save 后，会在库根目录下生成类似结构：

<root>/
  INDEX.md
  deploy-model/
    SKILL.md          # 何时使用 / 输入 / 步骤 / 验收 / 常见坑
    workflow.json     # 步骤、参数、来源会话、版本
    assets/           # 可选：脚本与模板

workflow.json 是权威记录，SKILL.md 由它渲染，创建时不会出现两份内容不一致。SKILL.md 的 frontmatter（name / description / whenToUse / metadata）与 @deepseek-ai/dsh-skill-filesystem 兼容：若将来想脱离本插件，可把 customSkillDirs 指向该目录。

技能发现与索引¶

默认开启 registerSkills，工作流注册为技能供模型发现。默认开启 autoIndex，每次保存后重建 INDEX.md，便于浏览已有工作流。

设置界面¶

装好后可在 设置 → 工作流库 中确认根目录（默认 ~/.dsh/workflows）及相关选项。

安全边界¶

保存前会扫描常见密钥形态（如 sk-…、ghp_…、私钥、Bearer、URL 内嵌口令），命中即拒绝，要求改成 <REDACTED>。assets 只接受相对路径，拒绝 ..、绝对路径与盘符；单文件 64KB，总量 256KB。根目录不能是磁盘根或系统目录，写入前做可写探测。工作流只写入配置的库目录，不会改动工作区里的其它文件。

安装与启用¶

官方 README 给出的安装方式为：

dsh plugin --profile desktop add dsh-plugin-workflow-library

也可通过 plugin_manager 的 install_bundle，target 传包名或已获取的插件目录。

运行环境要求（来自 package.json）：Node >=22.19.0，DSH >=0.2.1-rc.2 <0.3.0。

安装前建议查看 GitHub 源码 与 MIT 许可证。插件以当前 DSH 进程权限运行，请确认其读写范围符合你的安全预期。

典型用法¶

1、装好后打开 设置 → 工作流库，确认根目录（默认 ~/.dsh/workflows）。

2、在任意会话里把一件事跑通，然后说「把这个流程固化成工作流」。

3、模型调用 workflow_save，在库目录生成 SKILL.md、workflow.json 及可选的 assets/。

4、下个会话直接说「按上次部署模型那套来」，模型从技能目录加载 SKILL.md 后按步骤执行。

配置项¶

适用场景与注意¶

适合经常在 DSH 中重复同类操作（部署、检查清单、固定排查路径）的开发者：一次跑通、一次固化，新会话用自然语言引用即可。

不适合把含未脱敏密钥的会话直接固化——插件会拦截常见秘密形态，但仍应以 <REDACTED> 自觉处理敏感信息。同名工作流默认追加后缀目录（onConflict: suffix），需要覆盖升版本时可改为 replace。

结尾¶

dsh-plugin-workflow-library 把「口述一遍流程」变成「库里的 SKILL + workflow.json」，并与 DSH 技能发现机制对齐。目录与文档：

• SkillHub：zh-Littlebird/dsh-plugin-workflow-library
• GitHub：github.com/zh-Littlebird/dsh-plugin-workflow-library