前言¶
在 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
