dsh-runbook-ops
用于 DeepSeek Harness 社区工作流的运行手册工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:chenjieya/dsh-runbook-ops#f3e82d2703966c556697cbd174349692ca8299bfRunbook Ops 以 dsh-runbook-ops 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文社区版 DeepSeek Harness runbook 插件。它把团队的开发、测试、发布和运维流程写成结构化 YAML，并以 Harness 工具的形式提供给模型使用。
这个插件的重点不是替代 Harness 的执行系统，而是把团队 SOP 变成可校验、可复用、可审计的执行指导。
runbook_list：列出当前项目中的 runbook。runbook_read：读取并校验指定 runbook。runbook_start：生成按步骤执行的模型指导文本。.dsh/runbooks。发布后可通过 DeepSeek Harness 的插件机制安装：
dsh plugin --profile web add dsh-runbook-ops
本地开发时先构建插件，再在 DeepSeek Harness 仓库中加载 patch：
cd C:/Users/admin/Desktop/code/dsh-runbook-ops
npm run build
cd C:/Users/admin/Desktop/code/deepseek-harness
pnpm dsh web --patch C:/Users/admin/Desktop/code/dsh-runbook-ops/cordis.dev.yml
Headless 验证：
pnpm dsh --profile headless --patch C:/Users/admin/Desktop/code/dsh-runbook-ops/cordis.dev.yml "按 release-preflight runbook 检查当前项目"
--patch参数可以继续使用普通 Windows 路径；但cordis.dev.yml里的插件入口必须写成file:///C:/.../lib/index.js，否则 Node ESM loader 会把C:当成不支持的协议。这里加载构建后的 JS 产物，避免不同 DSH 启动方式对.tsloader 支持不一致。发布后的社区用户应使用自己的插件安装路径或 npm 包。
默认目录：
.dsh/runbooks/*.yml
.dsh/runbooks/*.yaml
示例文件：
id: release-preflight
title: Release preflight
risk: medium
steps:
- id: typecheck
title: Run TypeScript typecheck
kind: command
command: pnpm run typecheck
required: true
acceptance:
- Typecheck passes.
完整格式见 Runbook 格式说明。
- insert:
- id: runbook-ops
name: dsh-runbook-ops
config:
root: .dsh/runbooks
maxBytes: 65536
allowAbsoluteRoot: false
| 字段 | 默认值 | 说明 |
|---|---|---|
root | .dsh/runbooks | 相对当前会话工作区的 runbook 目录 |
maxBytes | 65536 | 单个 runbook 最大读取字节数 |
allowAbsoluteRoot | false | 是否允许绝对路径 root |
npm install
npm run hooks:install
npm run check
npm pack --dry-run
本项目使用 MIT License。