bitterSmilezzz/dsh-plugins

DeepSeek Harness 插件

EN · 简体中文

DeepSeek Harness（DSH）插件的伞仓库：
所有新增插件的共同遵循仓库，承载插件契约并承担新插件的校验与测试。插件本体为独立仓库，
各自安装；本仓库维护契约、校验脚本与经验档案。

- 契约（强制）：见 AGENTS.md（CLAUDE.md 是其软链）——Pi 契约约束、
DSH 官方规则契约、新插件校验与测试契约、DSH-Store 准入契约、dsh-std 协议契约。
- 经验档案：见 doc/experience/（按主题分类的踩坑/修复/治理记录）。
- 校验脚本：scripts/validate-plugin.mjs —— 按契约对插件仓库逐条静态检查。

校验

新插件登记发布前，须在本仓库通过校验（契约见 AGENTS.md「新插件校验与测试契约」）：

node scripts/validate-plugin.mjs ../dsh-xxx     # 校验某个插件仓库（默认输出报告）
node scripts/validate-plugin.mjs ../dsh-xxx --json   # JSON 输出（CI 用）

GitHub Actions（.github/workflows/validate-plugins.yml）每 8 小时 + push 清单时自动校验
scripts/manifest.json 中的全部插件，失败自动开 Issue。新增插件：在 scripts/manifest.json
加一行即自动纳入。

账号下仓库登记

在用 · 受 manifest.json 门禁（数据截至 2026-09-16，dsh 0.1.6-alpha.1）：

| 插件 | 版本 | 回归测试 | 门禁 |
| --- | --- | --- | --- |
| @bittersmilezzz/dsh-notify | 0.1.14（tag v0.1.14：设置卡片残留自绘开关对齐官方 Switch；依赖线 ^0.1.6-alpha.1） | 58 | 20/20 |
| @bittersmilezzz/dsh-model-selector | 0.1.21（tag v0.1.21：官方原语不采纳判据 + 座位契约钉子 + 官方座位遮蔽的依赖侧守卫测试；无运行时行为变更） | 75 | 20/20 |
| @bittersmilezzz/dsh-asr-voice | 0.3.2（tag v0.3.2：依赖对齐 DSH 0.1.6-alpha.1，本轮零改动） | 248 | 20/20 |

已退役 · 本地不再使用（副本一律在 doc/archives/；无 git 历史的用 tar 含 .git，有历史的用 bundle）：

| 仓库 | 退役原因 | 归档 |
| --- | --- | --- |
| dsh-ui-tweaks | 拆分前的合并包，已被上面 4 个插件取代；本地与远端均已删除 | dsh-ui-tweaks-2026-08-30.bundle（48 commits + tag，实测可 clone 恢复） |
| dsh-computer-use（自有版 @bittersmilezzz/dsh-computer-use） | 2026-09-15 退役：官方 @deepseek-ai/dsh-computer-use + dsh-experimental-computer-use-cua-driver-native 已发布并实测可用（headless 下真实调用 cua_driver_native__check_permissions 通过，驱动 55 个工具）；自研版与官方同名 ctx.computerUse 服务互斥，web profile 已切换到官方方案；远端已归档（archived）、本地已删除 | dsh-computer-use-2026-09-15.bundle（完整历史 + tag，git bundle verify 通过，3.5M） |
| dsh-computer-use | 非 git 仓库（无历史、不可固定源分发）；8 个宿主工具超 Pi 契约 已于 2026-09-10 复活为自有 git 仓库（脱离上游 fork，包名 @bittersmilezzz/dsh-computer-use，0.4.1 于 2026-09-14 发布，见上表） | dsh-computer-use-2026-08-31.tar.gz（旧非 git 版归档，仅历史留档） |
| dsh-skin-runtime | 非 git 仓库；效果引擎与 Aqua 重复 2048 行 | dsh-skin-runtime-2026-08-30.tar.gz |
| dsh-skills | 纯技能包（非 bundle 插件，不可上架）；内容已迁至 OpenViking 技能空间 | dsh-skills-2026-08-30.tar.gz |
| dsh-wallpaper-engine | 仅 Windows；注入的 3 个官方包在 alpha.2 已消失，且 host 半区无源码不可重建 | dsh-wallpaper-engine-2026-08-30.tar.gz |
| DSH-Transparent-UI-Plugin（Aqua） | 与官方 dsh-client-ui-theme 正面重叠；包名违反 @deepseek-ai/ 命名空间契约；tsdown.config.ts 指向不存在的路径故不可重建 | DSH-Transparent-UI-Plugin-2026-08-30.tar.gz |

2026-08-31 收口：上述退役仓的 GitHub 远端已按指示全部删除（DSH-Transparent-UI-Plugin、
dsh-wallpaper-engine、dsh-skills，加上此前双删的 dsh-ui-tweaks），账号现只剩伞仓库 +
6 个在用插件。dsh-computer-use / dsh-skin-runtime 本就是非 git 目录、从未有远端。
退役仓的本地副本已于 2026-08-31 清空（~/dsh-quarantine-20260830/ 701M 已删），
doc/archives/ 现在是唯一副本。归档为双形态：.tar.gz（工作树，排除可再生产物）
+ .bundle（单文件全历史）。删除前的核验口径：tar 用「解包 + diff -r」比对到 0 行差异，
bundle 必须在临时 git 仓内 git bundle verify（在非 git 目录跑会假报 need a repository），
并对最大的一份做真实 clone-back 计数比对。

⚑ 删除远端前的强制核验（本轮实测教训）：dsh-wallpaper-engine 本地是 --depth 5
浅克隆，只有 9 个 commit，而远端有 85 个 commit + 4 个分支（main/mac/
scene-support/fix/npm-name-waifux-darkmode）——直接删远端就会永久丢掉 76 个 commit。
更要命的是浅克隆上 git bundle --all 会产出父提交缺失、无法 clone 的残缺 bundle
（Failed to traverse parents of commit …），文件照样生成、看着像成功。所以删之前必须：
① git rev-parse --is-shallow-repository 为真 → 先 --unshallow 或重新全量 clone；
② 把 refs/remotes/origin/ 转成本地分支（clone 不会把源仓的 remote-tracking ref 再导出，
否则 bundle 回 clone 只剩 main）；
③ 用 bundle 实际 clone 回来比对 commit 数与分支数，而不是只看 bundle verify 或文件大小。

脚本

| 脚本 | 用途 |
| --- | --- |
| validate-plugin.mjs | 按契约静态校验插件仓库（核心，20 项） |
| validate-all.mjs | 校验 manifest.json 全部插件（clone 发布态：契约 20 项 + 产物完整性） |
| check-artifact-imports.mjs | 固定源产物自洽：lib/*/.js 的相对 import 必须能在仓库里解析到（堵 git add -u 漏收新产物导致的装到空壳/起不来） |
| apply-settings.mjs | 安全合并设置模板到 ~/.dsh/settings.yaml |
| install-external.mjs | 外部组件安装引导（读 external/manifest.json） |
| measure-load.mjs / measure-memory.mjs / web-regression.mjs | 浏览器加载/内存/回归测量 |

本地开发

插件仓库 clone 到伞目录，profile 用 link 指向本地，改完硬刷新即生效，稳定后 push
（详见各插件仓库 README）。

English Index

A DSH plugin umbrella repo: holds the plugin contracts (see
AGENTS.md) and validates your own plugins against them
(scripts/validate-plugin.mjs, automated by GitHub Actions). Plugins live in
standalone repos and install independently; experience notes are categorized
under doc/experience/.

License

MIT — 各子项目各有自己的 LICENSE（见各自独立仓库）。