Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

200 Commits

Folders and files

Repository files navigation

dsh-extensions

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)。
  • 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/)

技能源有三处:

  1. 本仓 skills/<分组>/**/SKILL.md(递归发现、不限深度:技能目录 = 含 SKILL.md 的目录。上游层级不一——skills/<名>/、skills/<分类>/<名>/、.agents/skills/<名>/、plugins/<插件>/skills/<名>/——硬编码层数会静默漏技能。排除 tests//fixtures//examples//sample* 噪音并把跳过的打印出来;同名副本取路径最浅的那份(故 skills/、.agents/skills/ 优先于 .openclaw/skills/ 之类的分发副本)。技能名优先取 frontmatter 的 name:,没有才用目录名)
  2. ~/projects/update-app/skills/(update-all 技能随它的 CLI 走)
  3. ~/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 覆盖层,零官方源码修改。

元技能

这里只写用途与来源;分组清单以 ls skills/ 与各组 README 为准,不在此逐技能罗列(清单会漂,ls 不会)。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages