DeepSeek Harness(DSH)个人扩展集合。遵循极简原则:一个功能一个目录。
plugins/<名字>/—— 自研插件(独立 npm 包,dsh plugin --profile web add link:<目录>安装),受本仓版本控制。devDependencies里指向 harness 检出的link:必须写相对路径:link:../../deepseek-harness/...(生产检出)或link:../../deepseek-harness-dev/...(开发 worktree),相对插件目录解析。本仓在 Linux 与 Windows 两台机器上共用,写绝对路径(/home/sx/projects/MyAI/...↔C:/Users/Admin/Project/MyAI/...)会让package.json与pnpm-lock.yaml里的specifier互相覆盖——谁先提交,另一台机器的依赖就指向不存在的目录。2026-10-14 已把当时 4 个带绝对路径的插件(dsh-laya-router、dsh-llm-retry-schedule、dsh-sidebar-taskbar、dsh-task-manager)统一改成相对路径。自检:插件目录里pnpm install --lockfile-only --frozen-lockfile通过,且改动文件的git diff里不出现任何平台路径。
skills/<上游仓库名>/—— 技能分组仓:一个上游仓库一组,各自是独立 git 仓、登记为本仓的 submodule。有上游的是xgx1下的公开 fork,无上游的是自建仓。分组理由与 fork 策略见../docs/adr/0006。- 组内目录与上游一一对应(2026-09-13 起):fork 的树 = 上游最新树 + 我们的本地改动移植到对应文件。上游把技能放在
skills/<名>/、.agents/skills/<名>/、skills/engineering/<名>/、plugins/<插件>/skills/<名>/……本仓不再把技能拍平到组根;我们的分组 README 以README.dsh-local.md存在(避免覆盖上游 README)。
- 组内目录与上游一一对应(2026-09-13 起):fork 的树 = 上游最新树 + 我们的本地改动移植到对应文件。上游把技能放在
vendor/<名字>/—— 第三方上游克隆(生产link:目标),同样是 submodule,远端指各自上游。
三处都不再被 .gitignore 忽略:skills/ 与 vendor/ 由 .gitmodules 记录,本仓只保存指向各自提交的指针(见 ../docs/adr/0005)。改子模块里的内容要在各自目录里提交、推送,再回本仓更新指针。
./install-skill.sh # 扫描三个技能源,软链到 ~/.dsh/skills/
./install-skill.sh --dry-run # 只看会做什么
./install-skill.sh --list # 只列出受管技能及来源
./install-skill.sh --force # 允许覆盖已存在的真实目录(先备份到 ~/.dsh/skill-backups/)技能源有三处:
- 本仓
skills/<分组>/**/SKILL.md(递归发现、不限深度:技能目录 = 含SKILL.md的目录。上游层级不一——skills/<名>/、skills/<分类>/<名>/、.agents/skills/<名>/、plugins/<插件>/skills/<名>/——硬编码层数会静默漏技能。排除tests//fixtures//examples//sample*噪音并把跳过的打印出来;同名副本取路径最浅的那份(故skills/、.agents/skills/优先于.openclaw/skills/之类的分发副本)。技能名优先取 frontmatter 的name:,没有才用目录名) ~/projects/update-app/skills/(update-all技能随它的 CLI 走)~/projects/<项目>/.dsh/skills/(项目专用技能放各项目自己的仓里,不进主库)
改动无需复制:~/.dsh/skills/<名字> 是指向源目录的软链,改完即生效、提交即版本化。
这个设计是为了消灭旧「托管副本」模式下的漂移——曾经运行时那份还在教一个已被删除的仓库。
自检:
./install-skill.sh --dry-run输出里的「新建 N」应为 0,否则说明有技能没被纳入受管源。
| 分组 | 来源 | 技能数 |
|---|---|---|
dotnet-skills |
dotnet/skills | 104 |
mattpocock-skills |
mattpocock/skills | 37 |
self-ue / self-dsh / self-ops |
本机自建(无上游) | 32 / 32 / 7 |
quodsoler-unreal-engine-skills |
quodsoler/unreal-engine-skills | 27 |
sipherxyz-universal-ue-skills |
sipherxyz/universal-ue-skills | 15 |
obra-superpowers |
obra/superpowers | 14 |
unrealxu-ue5-skills |
UnrealXu/UnrealEngine5-Skills | 11 |
rider-skills / dietrichgebert-ponytail |
JetBrains / DietrichGebert 的 fork | 各 6 |
epicgames-ue-skills |
EpicGames 官方 | 3 |
归属规则:上游没有的技能不进 fork,放自建仓(self-ue = UE 项目实践,self-dsh = 通用开发流程 + .NET/MCP 工具 + DSH,self-ops = 本机运维 CLI)。这样每个 fork 都干净——文件数 = 上游 + 1(那 1 个是 README.dsh-local.md),git diff upstream/<分支> 里只剩「本机改写了哪些文件的内容」。
(技能名以下载进 ~/.dsh/skills/ 的为准;数字会随安装器发现结果变化,权威值是 ./install-skill.sh --list。)
关于上游与本地版本:分组仓的目录结构与文件数与上游一致,本地改动(改名、中文化、平台分节、本机适配)叠在对应文件上——判断某处是你改的还是上游的,git diff upstream/<分支> 即可。唯一例外是 README.dsh-local.md(我们的分组说明)。改名类改动只在 frontmatter 的 name: 上(如上游 ue-cpp-foundations 目录里放的是我们的 unreal-cpp-foundations),所以技能名不随上游目录名变。判断一个技能是否自研,看 agents/openai.yaml 与残存的 license:/compatibility: 键,不要看 author: Sx 或中文 frontmatter(那是本地化层批量盖的章)。
dsh-sidebar-taskbar—— 侧边栏会话任务栏:工作区上方显示运行结束(绿)/运行中(红)/等待回复(琥珀)会话,点击跳转;折叠自动隐藏。数据复用官方sessions.list+uiSession.sessionStatus,零官方源码修改。dsh-task-manager—— 任务管理器:侧边栏标题下方「任务管理 / Task Commander」按钮,点击把中间主区域(AI 输入输出面板)整区切换为任务面板(官方conversation.view视图环,非右侧浮层),面板左上角「创建新的任务」按钮;header 视图标签一键切回对话。纯 profile-bundle 覆盖层,零官方源码修改。dsh-perf-mode—— 关掉 Web GUI 的全部动画、过渡与毛玻璃:一份全局样式表,animation/transition/scroll-behavior归零,--dsw-menu-backdrop-filter置none并强制backdrop-filter: none。纯 profile-bundle 覆盖层,零官方源码修改。
dsh-extension-dev—— DSH 扩展开发元技能:先搜索复用 → 调cordis-plugin-development技能 → 极简(一功能一插件)→ 传 GitHub。- 形态分类与证据优先思路参考 w2112515/dsh-plugin-development
- 基本原理参考官方 extension-cookbook
这里只写用途与来源;分组清单以
ls skills/与各组 README 为准,不在此逐技能罗列(清单会漂,ls不会)。