前言¶
在 DeepSeek Harness（DSH）里做交付协作时，计划、负责人、阶段状态和口头交接往往不在仓库里：人和智能体很难对齐「谁负责什么、什么叫完成、卡在哪一步」。常见做法是另开 SaaS 看板，或用 Markdown 清单——前者难进 PR 审查，后者缺少结构化交接与周报。
dsh-delivery-board（仓库 jerryxff26-alt/delivery-board）把阶段流水线、交接记录和面向客户的周报写进仓库内的 delivery.json（默认文件名）。看板、Timeline、审计日志和周报都是同一份状态的投影，不依赖外部账号。维护者为 jerryxff26-alt，在 DSH 社区目录中归类为工作流；GitHub 上约 4 stars。当前包版本 0.3.0，许可证 MIT。
这是什么¶
一句话：Plan、owners、status 与 handoff 历史集中在一个与代码同目录的 JSON 里——无 SaaS、无账号，可在每次 PR 里 diff。
项目刻意不做 Jira / Linear / Notion 级别的组织级 PM；只保留当前仓库需要的交付上下文，离线可用、可版本化。
核心功能¶
以下能力均来自项目 README 与 package 说明，看板只是视图，可信数据源是 delivery.json。
阶段流水线与卡片
每张卡片可有 owner、描述、可选 start/due、验收标准（AC）与可勾选的 Definition of Done（DoD）。初始化后可增删改阶段名（有卡片时删除阶段需先迁移）。
交接审计
卡片跨阶段移动时自动记录「谁把什么交给谁」。
周报
生成 Markdown 客户周报：流水线快照、本周已交付（到达终态或归档）、交接、未关闭风险、本周已化解风险；可选 next_week 以 Next bets 呈现（空则省略）。
软 WIP 限制
各阶段可设 wipLimit；超限时看板与移动操作会警告，但不阻止移动。
本地可编辑看板
在 DSH 中可通过 /delivery 相关工作流打开；CLI 用 open 在 127.0.0.1 提供拖拽看板，写回同一 delivery.json。支持归档/恢复、风险与 blocker、DoD 勾选；浏览器语言为 zh-CN 时会适配界面 chrome。
Timeline
日历轴 Gantt：卡片从创建经各阶段交接到 shipped/archived/今天；设 start 与 due 时显示计划条。支持明暗主题。
整板归档
archive-board 将当前状态快照到 delivery-archive/<YYYY-MM-DD>-<slug>.json，再重置空板；只读 reopen 用 open --file … 或 html --file …。
离线 HTML
单文件只读快照，无 DSH 的同事也可打开。
与典型方案对比（项目自述）
| 需求 | 本项目 | 常见 SaaS 看板 | 仅 Markdown 清单 |
|---|---|---|---|
| 状态在 git 仓库 | 是（delivery.json） |
多在远端 | 是，但无结构化交接/WIP |
| 交接审计 + 客户周报 | 内置 | 常需自定义字段/导出 | 手工 |
| 本地可编辑 UI + Timeline | loopback 看板 | 完整 Web 应用 | 无 |
| 与 AI 编码智能体协作 | DSH skill + 工具；任意 agent 可用 CLI | 常经 API/MCP | 主要靠 prompt |
设计原则摘要：交付状态是一等公民；视图是投影；日常通过 CLI 或 DSH 操作，不把 JSON 当主编辑界面。
安装与启用¶
插件以当前 dsh 进程权限运行；安装前请自行查看仓库源码与 MIT 许可证。README 注明在 DSH 0.2.1-rc.2 上测试（亦兼容 0.2.0-rc.2）；package.json 要求 Node >=20，dsh >=0.2.0-rc.2 <0.3.0，无额外 runtime 依赖。
作为 DSH 插件（官方 README 命令）：
dsh plugin --profile web add github:jerryxff26-alt/delivery-board
桌面端可从插件管理器安装同一 GitHub 规格；README 写明 CLI 上述路径为已验证路径，桌面插件管理器流程未单独验证。
npm 正式发布后，独立 CLI 将可用 npx dsh-delivery-board …；在 package 上 npm 之前，独立使用 GitHub 路径：
npx github:jerryxff26-alt/delivery-board help
典型用法¶
独立 CLI 快速开始（无需 DSH）¶
下面步骤在 README「30-second quickstart」中给出，用于初始化、建卡、打开看板与周报：
npx github:jerryxff26-alt/delivery-board init ACME lite
npx github:jerryxff26-alt/delivery-board card '{"title":"API integration","stage":"doing","owner":"Ada","description":"Wire partner API"}'
npx github:jerryxff26-alt/delivery-board open # loopback board + Timeline; Ctrl+C to stop
npx github:jerryxff26-alt/delivery-board weekly
状态文件默认为当前目录下的 delivery.json，可用 --cwd / --file 覆盖。
更多 CLI 示例¶
npx github:jerryxff26-alt/delivery-board init Demo lite
npx github:jerryxff26-alt/delivery-board board
npx github:jerryxff26-alt/delivery-board open
npx github:jerryxff26-alt/delivery-board weekly 2026-10-20
npx github:jerryxff26-alt/delivery-board html
npx github:jerryxff26-alt/delivery-board dod add c1 "PR reviewed"
npx github:jerryxff26-alt/delivery-board dod check c1 0
npx github:jerryxff26-alt/delivery-board archive-board
npx github:jerryxff26-alt/delivery-board open --file delivery-archive/2026-11-02-demo.json
作为 DSH 插件¶
安装后提供 skill 支撑的 /delivery 工作流：推进阶段、填写 AC、记录 blocker、生成周报，或用自然语言操作；也可让工具打开可编辑看板（README 示例：/delivery Open the editable board）。
适用场景与注意¶
适合谁
希望在单仓库内把交付上下文与代码一起版本化、在 PR 里审查状态变更的团队；需要交接审计与客户向周报、又不想绑定 SaaS 的场景。PM、工程、QA 与 AI agent 共用同一份 Source of Truth。
不适合当作
组织级项目管理系统替代品；范围是有意收窄的。
安全与生态
DSH 社区目录（如 SkillHub 插件页）是独立站点，与 DeepSeek / 幻方无官方从属关系；插件遵循 DSH「一切皆插件」的扩展方式，并非官方应用商店内置应用。
经过上面的步骤，你可以在仓库旁维护可 diff 的 delivery.json，用看板与 Timeline 编辑，用周报对外同步——状态随 Git 走，而不是散落在站外工具里。
