dsh-project-handoff
DSH 主机插件：统计自动上下文压缩次数，并在每轮注入一条简短的项目交接通知。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lyh704791411-a11y/dsh-project-handoff#abe5fb3b4aea36d07a1491febed9b3483b949d54Project Handoff 以 dsh-project-handoff 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个给 DeepSeek Harness（DSH）用的 Host 插件：统计自动压缩次数，并且只在新发生一次自动压缩之后，往下一轮里放一句很短的提醒，提示模型该整理交接材料了。
纯 Host 实现，没有界面，没有客户端代码。
从 GitHub 安装（推荐）：
dsh plugin --profile desktop add github:lyh704791411-a11y/dsh-project-handoff
从本地目录安装（开发用）：在 DSH 里用 plugin_manager 的 install_bundle，target 填本仓库的绝对路径。
装完重启一次客户端，插件才会加载进运行中的进程。
dsh plugin --profile desktop remove dsh-project-handoff
或在 DSH 里用 plugin_manager 的 remove_bundle。卸载不会删除状态文件；要清理就手动删状态目录。
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| stateDir | 字符串 | 用户目录下的 .dsh/state/project-handoff | 状态文件目录，支持开头的波浪号 |
| steer | 布尔 | false | 设为 true 才启用「没带提醒就补一次」 |
在 profile 的 patch 层覆盖时要注意：Loader 对 config 是整体替换，不做深合并。所以两个键都要写全：
- id: project-handoff
name: dsh-project-handoff
config:
stateDir: ~/.dsh/state/project-handoff
steer: false
本包没有 Config schema（为了保持零依赖），类型写错不会在加载时报错，只会静默失效。
一次压缩要同时满足下面全部条件，计数才会加一：
几个容易踩的点：
默认放在用户目录下的 .dsh/state/project-handoff，文件名是「会话编号 + 短哈希」。示例：
{
"count": 2,
"lastCompactionAt": "2026-10-20T02:10:33.412Z",
"lastInjectedTurn": 7,
"lastInjectedCount": 2,
"lastInjectedNotice": "project-handoff：本会话已自动压缩 2 次。",
"lastVerify": { "turn": 7, "match": true, "steered": false }
}
状态文件不会自动清理，会话多了会慢慢变多，需要时手动删目录即可。
# JavaScript：48 项
node --test
# Python：73 项（其中 1 项需要 PATH 里有 PowerShell 7，没有会记为跳过）
cd python
python -m unittest discover -s tests -p "test_*.py"
测试全部使用系统临时目录，不读写真实用户目录。
仓库结构：
.
├─ index.js # apply(ctx, config)
├─ cordis.patch.yml # 注册 id=project-handoff
├─ lib/
│ ├─ util.js # 配置解析、logger
│ ├─ state.js # 按会话存状态，原子写、损坏回退
│ ├─ count.js # 计数规则
│ ├─ inject.js # 每轮注入
│ └─ verify.js # 首段核验 + 可选 steer
├─ python/
│ ├─ handoff_state.py # 上游状态机（vendored，MIT）
│ ├─ dsh_adapter.py # DSH 事实 -> 状态机
│ └─ tests/
├─ test/ # JS 测试
└─ .github/workflows/ci.yml
本插件只是计数和提醒。真正的交接流程（斜杠命令入口、保存、恢复、授权规则）来自配套技能 project-handoff，它不随本仓库分发，需要单独安装到 DSH 的技能目录。
没装技能时插件照样工作，只是没有人消费这条提醒。
MIT，见 LICENSE 文件。JS 部分是原创；python 目录下的状态机派生自 Table-skills（同样 MIT），修改范围写在 NOTICE 文件里。