xy-dsh

自己用的 DeepSeek Harness 插件集合。

插件	做什么	状态
xy-dsh-lamp	macOS 系统级置顶灯板。每个 Agent 一盏灯，多个项目并行时一个会话一行；全绿后收成一行 完成 04/04。整块可拖、可收起成一排小灯、五种背景、中英可切。	日常在用
xy-dsh-context	会话级 Context Lens。在输入区上方显示 Turns / Steps / Cache hit / Output。	原型，没长期用

灯板从开工到收成一行是这样走的：

它浮在别的窗口之上，这张是真实桌面截图：

上面这些都来自真实的 xy-dsh-lamp/overlay.html，没有一张是手画的。docs/make-intro.py 把灯板按状态序列逐步驱动、以 10fps 连续录成 GIF（含「等你」态的闪烁、收起态与中英切换），docs/make-assets.py 负责那几张静态 PNG 插图。两个脚本都用真实浏览器引擎在受控背景前渲染，所以不会带上桌面上的任何东西。想重新出图就跑对应脚本。

安装

dsh plugin add 会把参数原样透传给 profile 目录里的 pnpm add，所以可以直接从 GitHub 装。pnpm 用 #path: 片段指定仓库里的子目录：

# 灯板（macOS 置顶窗）
dsh plugin --profile desktop add "github:Xinyuan-Gao/xy-dsh#path:xy-dsh-lamp"

# Context Lens
dsh plugin --profile web add "github:Xinyuan-Gao/xy-dsh#path:xy-dsh-context"

装完重启 DSH Desktop，或重启 dsh web。要更新就重新执行一遍同样的命令。

想改代码的话，改成在本地 clone 后用 link: 装一份可编辑的：

git clone https://github.com/Xinyuan-Gao/xy-dsh.git
cd xy-dsh
dsh plugin --profile desktop add link:"$PWD/xy-dsh-lamp"

xy-dsh-lamp 的灯板是一个独立编译出来的 macOS HUD：第一次加载时宿主会用 swiftc 把 hud.swift 编到 ~/.dsh/xy-dsh-lamp-hud.app，所以机器上要有 Xcode Command Line Tools。没有 swiftc 时灯板不会出现，插件的系统通知部分照常工作；非 macOS 平台也不会拉 HUD。

兼容性

两个插件都在各自的 package.json 里逐版本声明与 @deepseek-ai/dsh 的兼容性（dsh.compatibility.dshReleases），并配了可复现的证据脚本：每个官方 release 在一次性 DSH_HOME 里跑 install → compose → uninstall。

当前声明与验证结果见 COMPATIBILITY.md。

测试

./test/run.sh

四套：宿主逻辑（Node，任何平台）、HUD 进程生命周期（macOS）、页面渲染与交互、收起态（后两套要 playwright）。 每套都在自己的临时 HOME 里跑，不会碰你真实的 ~/.dsh。细节和「为什么留这些断言」见 test/README.md。

这里每一条断言都对应一个真出过的问题，而且都是读代码看不出来的：等你灯不闪、killOldHud 静默失效、编译失败拖垮灯板、收起态宽度不跟着灯数走。写新测试时请让夹具来自真实的事件载荷——这个仓库有两次测试是绿的而功能是坏的，都是因为夹具写的是自己的假设。

License

MIT