dsh-runbook-ops

中文社区版 DeepSeek Harness runbook 插件。它把团队的开发、测试、发布和运维流程写成结构化 YAML，并以 Harness 工具的形式提供给模型使用。

这个插件的重点不是替代 Harness 的执行系统，而是把团队 SOP 变成可校验、可复用、可审计的执行指导。

功能

• runbook_list：列出当前项目中的 runbook。
• runbook_read：读取并校验指定 runbook。
• runbook_start：生成按步骤执行的模型指导文本。
• 默认只读取当前会话工作区内的 .dsh/runbooks。
• 不直接执行 shell 命令，命令执行继续交给 Harness 现有工具、审批和日志系统。

安装

发布后可通过 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 启动方式对 .ts loader 支持不一致。发布后的社区用户应使用自己的插件安装路径或 npm 包。

Runbook 示例

默认目录：

.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。