前言¶
在 DSH 裏跟進多項目、多截止日的事項時，常見做法是本地 Excel 或外部表格：數據散在個人文件裏，和對話、側欄面板脫節，到期提醒也要自己算。DeepSeek Harness 支持通過客戶端插件把能力嵌進側欄；project-monitor（倉庫 archcra/dsh-plugin-project-monitor，維護者 archcra）把「錄入、列表、分級預警、每日摘要」收進 DSH 側欄「事項進展」面板，權威數據落在 $DSH_HOME/project-monitor/，Excel 僅作可隨時再生的導出投影，全新安裝不需要任何本地 Excel。
這是什麼¶
project-monitor 是 DSH 客戶端類插件：用戶在面板裏錄入與推進事項，插件負責紅橙黃綠分級預警與每日摘要。數據由插件自管（JSON 原子寫 + 變更流水 + 按日備份），不依賴你事先準備表格文件。
數據流概覽：
用戶
└─ DSH 側欄「事項進展」面板 ──HTTP──> 插件宿主半側 ──> 權威存儲（JSON，原子寫）
│ $DSH_HOME/project-monitor/
├─ 導出投影 ──> dashboard.xlsx（Tasks + Dashboard）
└─ 每日摘要 ──> daily-summaries/<日期>.md
社區目錄頁：https://www.skillhub.cn/plugins/archcra/dsh-plugin-project-monitor
源碼與說明：https://github.com/archcra/dsh-plugin-project-monitor（國內鏡像：https://gitcode.com/Holibut/dsh-plugin-project-monitor）
數據存在哪¶
| 路徑 | 作用 |
|---|---|
$DSH_HOME/project-monitor/tasks.json |
權威數據（原子寫：臨時文件 + rename） |
$DSH_HOME/project-monitor/events.ndjson |
變更流水，只追加，用於審計與排障 |
$DSH_HOME/project-monitor/backups/<日期>.json |
每天首次寫入前自動備份，保留 14 份 |
$DSH_HOME/project-monitor/dashboard.xlsx |
導出投影：Tasks（全量）+ Dashboard（看板） |
$DSH_HOME/project-monitor/daily-summaries/<日期>.md |
每天早晨的摘要 |
導出物可以隨時刪掉，export 會重新生成；刪它不會丟任何數據。
核心功能¶
面板錄入¶
| 方式 | 用法 |
|---|---|
| 快捷行 | 項目 / 事項 / 類別 / 負責人 / 截止日 / 優先級 / 進度 —— 只有前兩項必填，字段亂序也能歸位 |
| 批量粘貼 | 每行一條（可直接從表格複製），先預覽再確認，壞行標紅不阻斷好行 |
| 表單 | 需要填全字段時展開；項目名/負責人帶歷史值自動補全 |
日期支持自然寫法：2026-10-20、10/20、10月20日、明天、3天后、下週五、下個月、月底；進度支持 30% / 0.3 / 30。識別不了就報錯，不會猜也不會靜默丟棄。
列表支持勾選完成、+7天 順延、改進度、編輯、刪除（軟刪除，可撤銷），以及搜索、項目/負責人/狀態篩選、六級分級篩選與排序。
到期分級（面板 / Excel / 摘要一致）¶
D = 截止日 − 基準日期；已完成 不參與預警；沒有截止日期歸入「未設截止」。
| 級別 | 條件 |
|---|---|
| 已逾期 | D < 0 |
| 紅色 | 0 ≤ D ≤ 3 |
| 橙色 | 4 ≤ D ≤ 7 |
| 黃色 | 8 ≤ D ≤ 30 |
| 綠色 | D > 30 |
每日摘要¶
可配合 DSH 官方實驗包 Schedule（@deepseek-ai/dsh-experimental-schedule-bundle）在固定時間把 prompt 投進會話，由 Agent 刷新看板並彙報摘要，同時落盤到 daily-summaries/<日期>.md。也可使用倉庫內的 CLI 或 macOS launchd 備選方案，僅刷新 Excel 與摘要文件、不產生對話消息。
HTTP API 與 CLI¶
宿主側提供 /project-monitor/api/* 路由（列表視圖、元數據、今日摘要、解析錄入、任務的增刪改與批量操作、導出等）。命令行入口：
node plugin/lib/cli.mjs # 打印摘要並刷新導出件
node plugin/lib/cli.mjs list --level overdue # 看清單
node plugin/lib/cli.mjs add "甲項目 / 寫總結 / 10/20 / 高"
node plugin/lib/cli.mjs export # 只重新生成 Excel + 摘要
node plugin/lib/cli.mjs check # 體檢（退出碼 3 表示有提醒項）
安裝與啓用¶
全新安裝零配置：裝好即用空存儲，直接在面板錄入。若附近存在舊 project-tracker.xlsx，會自動遷移一次；也可主動點「導出 Excel」生成投影。
從 Git 倉庫安裝（常見）¶
GUI：側欄 插件 → 添加插件 → 粘貼倉庫地址 → 安裝 → 立即啓用。
Web 版 CLI：
dsh plugin --profile web add https://github.com/archcra/dsh-plugin-project-monitor
桌面版需先完全退出桌面端，再使用 DSH 自帶的 dsh CLI（路徑以 macOS 爲例）：
/Applications/DeepSeek\ Harness.app/Contents/Resources/runtime/cli/bin/dsh plugin --profile desktop add <倉庫地址或包名>
國內可用：https://gitcode.com/Holibut/dsh-plugin-project-monitor。
已知問題（宿主 0.2.0-rc.2 實測）：遠程安裝可能只裝包不插行，裝完未激活。可在 profile 的 cordis.patch.yml 追加：
- id: project-monitor
name: project-monitor
config: {}
可選配置（cordis.patch.yml 的 config）¶
| 鍵 | 默認 | 說明 |
|---|---|---|
dataDir |
$DSH_HOME/project-monitor |
數據目錄 |
exportWorkbook |
<dataDir>/dashboard.xlsx |
Excel 導出路徑 |
summaryDir |
<導出目錄>/daily-summaries |
摘要目錄 |
writeFiles |
true |
關掉即不寫任何導出文件（只讀模式） |
插件要求 Node.js >= 20；package.json 版本爲 1.0.0，許可證 MIT。
典型用法¶
- 安裝並啓用後，打開側欄「事項進展」，用快捷行或批量粘貼錄入事項。
- 用分級顏色掃一眼臨近與逾期項；需要順延時點
+7天，完成則勾選。 - 需要給同事或歸檔時，在面板觸發導出，得到
dashboard.xlsx；摘要可在/project-monitor/api/summary或daily-summaries/下查看。 - 若需每天固定提醒，啓用 Schedule 後創建類似任務（時區按需調整）：
schedule_create
title: 事項進展摘要
prompt: 刷新 project-monitor 看板並彙報今日摘要
daily: { time: "08:00:00", time_zone: "Asia/Shanghai" }
適用場景與注意¶
適合在 DSH 內長期跟進多項目待辦、希望截止日可視化且數據留在本機目錄的開發者或小團隊。字段模型覆蓋項目、事項、類別（申報/結題/經費/彙報/其他）、負責人、狀態、優先級與進度等，偏研發與事務類事項管理。
使用前請注意：
- 插件以當前 DSH 進程權限讀寫
$DSH_HOME/project-monitor/，安裝前應自行審閱源碼與 MIT 許可證。 - 宿主對插件 bundle 使用
cache-control: immutable，改client.js後若界面未更新，可硬刷新或重啓桌面端；面板標題旁的build指紋可與/project-monitor/api/meta對照。 - Schedule 依賴宿主進程在運行；精確一次投遞不保證，僅要文件時可走 CLI / cron。
- DSH 社區插件目錄（SkillHub）與 DeepSeek / 幻方無官方從屬關係，安裝來源以你信任的 Git 地址爲準。
結尾¶
project-monitor 把事項權威數據放在 $DSH_HOME/project-monitor/，側欄完成錄入與紅橙黃綠預警，Excel 與 Markdown 摘要作爲可選投影，減少「表格與對話兩套系統」的切換成本。
- 目錄頁：https://www.skillhub.cn/plugins/archcra/dsh-plugin-project-monitor
- GitHub：https://github.com/archcra/dsh-plugin-project-monitor
