dsh-project-deck

把你的仓库、目录和半途项目，变成一块看得见进度的甲板。 A project deck for DeepSeek Harness：项目注册表 + 可视化面板 + 定时微信播报 + 自动发现 + 多机扫描。

30 秒 demo

不需要装任何东西（要 Python 3.9+）：

git clone https://github.com/peng456/dsh-project-deck
cd dsh-project-deck
python3 backend/deck demo          # 生成 4 个假项目，起面板
# → http://127.0.0.1:9299

它解决什么

你有 10 个仓库、3 个半成品、一堆会话散在不同工作区。这个插件做四件事：

1. 一个注册表：deck add <id> --root <path>，别名、类型、优先级、下一步。
2. 一块面板：卡片看 git 状态、最近活动、下一步；点项目标题直接跳进它最近的 DSH 会话。
3. 定时播报：每 4 小时推一条微信（文字 + 看板图），有变化的项目优先，没变化的折叠一行；凌晨 0:30–6:30 不打扰。
4. 自动发现 + 多机扫描：扫 DSH 工作区、git 仓库、标记文件自动登记新项目；手机/另一台电脑跑一个只读扫描器，把项目清单推给主机。

安装

# 1. 后端（CLI + 面板 + 定时器）
git clone https://github.com/peng456/dsh-project-deck && cd dsh-project-deck && ./install.sh

# 2. DSH 插件（npm 或 GitHub 二选一）
dsh plugin --profile desktop add dsh-project-deck
# dsh plugin --profile desktop add github:peng456/dsh-project-deck
# 或 Desktop → 插件 → 搜索/安装 dsh-project-deck

重启 DSH 后左下角出现 📋，可以拖到页面任意位置，位置会被记住；点开就是面板。

常用命令

deck add blog --root ~/code/blog --kind content --note "每周一篇实测"
deck list / status / doctor
deck report               # 立刻播报（文字 + 图）
deck scan / scan --add    # 发现新项目
deck nodes add --id phone --name "我的手机" --platform android
deck demo                 # 演示环境

播报长什么样

项目播报 · 11-05 06:49
12 个项目｜活跃 12 · 阻塞 0 · 近 6 小时更新 3

- **个人 Agent**（代码）· 刚刚
  进展：新增 1 个会话（共 5）·「多项目管理机制」
  下一步：给 12 个项目建 STATE 骨架
- **API 服务**（代码）· 12 分钟前
  进展：git 2 次提交（fix: 鉴权）· 3 个文件待提交
  下一步：迁 v2 接口，补 12 个测试
无变化：官网改版、基础设施、…

通知渠道（可选）

播报通过 report.delivery 选择发送器，默认不依赖任何外部服务：

类型	说明
ilink	内置微信连接：面板点「连接微信」→ 扫码 → 在微信里给 bot 发一句话即可推送，不需要额外服务
wxpush	复用本机 wxpush 网关（支持附图）
serverchan	ServerChan SendKey
webhook	任意 URL（企业微信机器人等）
command	自写脚本，stdin 收文本，退出码 0 = 成功

面板顶部有「通知渠道」下拉，选完保存即可；ilink 模式下会直接显示二维码。

```jsonc
"report": {
  "enabled": true,
  "image": false,                          // 附图仅 wxpush 通道支持
  "delivery": {
    "type": "wxpush",                      // wxpush | serverchan | webhook | command
    "url": "http://127.0.0.1:9098",        // wxpush（ilink 模式忽略）
    "key": "",                             // ServerChan SendKey
    "webhook": "",                         // 任意 webhook（企业微信机器人等）
    "command": ""                          // 自写脚本：stdin 收文本，退出码 0 = 成功
  }
}

类型	依赖	说明
wxpush	本机 wxpush 服务	支持文字 + 看板图；token 过期时会入队等恢复
serverchan	ServerChan SendKey	纯 HTTP，无 token 过期问题
webhook	任意 URL	发 {"msgtype":"text","text":{"content":...}}，兼容企业微信机器人
command	你的脚本	最灵活，退出码判定

deck status 会显示当前通道与连通状态；通道不通时播报不会堆积（附图除外，会有限重试）。

配置（~/.project-deck/config.json）

key	默认	说明
report.intervalHours	4	播报周期
report.image	true	附看板图（需要 Chrome 无头截图）
scan.intervalHours	12	自动发现周期
scan.threshold	70	自动登记分数线
schedule.quiet	00:30–06:30	安静时段，不播报不扫描
panel.allowLanRead	true	允许手机通过局域网看面板（只读）

自主推进（可选）

每个项目可设 off / assist / auto：assist 只给选项和推荐，auto 会自己查事实、自己选方案、做可逆的事，把 push/删除/发布这类不可逆动作放进审批队列等你一句话。

deck autonomy my-app auto
deck approvals            # 等你拍板
deck decisions            # 我替你做过的决定

规则写在 docs/AUTONOMY.md。

多机扫描

节点只读上报，不传文件内容：

# Python / Node / Windows PowerShell 三种实现都在 backend/
python3 deck-node push --server http://<host>:9199 --token <token> --id my-phone
node     deck-node.js loop --server ... --token ... --id my-laptop
powershell -File deck-node.ps1 -Server ... -Token ... -Id my-win

安全

• 面板写接口只对本机开放；读接口可开局域网（给手机看），POST /api/node-scan 始终要每节点 token；
• 微信推送走本地 wxpush（iLink）；token 几小时无互动会过期，播报会跳过而不是堆积，你给 bot 发一句话就自动恢复；
• 别提交 nodes.json / config.json（里面有 token）。

许可

MIT