前言¶
在 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 走，而不是散落在站外工具裏。
