前言¶

DeepSeek Harness（DSH）通过 @deepseek-ai/dsh-skill-filesystem 发现以 SKILL.md 为载体的 skill 包，但默认没有专门的管理界面。装多了 skill 之后，要查名称、调用方式、来源仓库和磁盘路径，往往只能自己翻 ~/.dsh/skills 里的符号链接布局。安装、卸载、从镜像仓库拉更新、检查死链和 frontmatter，也缺少一套统一入口。

社区插件 dsh-skill-console（GitHub：mi-lu-uncle/dsh-skill-console，维护者 mi-lu-uncle，分类：客户端）在客户端侧提供只读的 Settings → Skills 面板，在宿主侧提供 /skills 等四条斜杠命令，读写都围绕 ~/.dsh/skills 的 symlink 布局（git pull 再 reconcile），变更后由 DSH 的 watcher 热加载。

这是什么¶

dsh-skill-console 是 DSH 社区插件：一个 Skills 设置面板 加上 命令行 skill 管理器。当前 npm 包版本为 1.0.1（MIT 许可证），与 DSH 0.2.0-rc.2、0.2.1-rc.2 在插件元数据中标记为 compatible。

核心功能¶

客户端：Skills 面板¶

• 入口：主侧边栏 Skills 图标（与 Plugins 相邻），以及 Settings → Skills。
• 以搜索为中心：居中搜索栏 + 全宽卡片列表；筛选 按钮打开侧栏，可按来源、调用方式、排序过滤。
• 点击卡片打开详情抽屉：描述、invocation、来源、路径；可复制 /name 命令；可 uninstall。
• 顶栏支持：从 git URL 或本地路径 安装 skill（预览 → 选择 → link）、更新 默认镜像 mattpocock-skills、运行 健康检查。

宿主：四条斜杠命令¶

/skills 每行格式为 - /name [invocation · 来源:repo] — description。其中 invocation 可能为 模型+用户、仅模型、仅用户、未开放；来源 为 symlink 指向的 repo mirror 名，或非仓库 skill 的发现根标签（如 内置、DSH用户、项目 等）。

实现分工（便于对照源码）¶

安装与启用¶

推荐从 GitHub 仓库安装（desktop profile）：

dsh plugin --profile desktop add https://github.com/mi-lu-uncle/dsh-skill-console.git

也可从本地路径或 tarball 安装：

dsh plugin --profile desktop add /absolute/path/to/dsh-skill-console
dsh plugin --profile desktop add ./dsh-skill-console-1.0.0.tgz

说明：以 link: 方式安装的插件不会被 HMR 监视；若修改 lib/index.js 或 lib/client.js，需重启应用后生效。

典型用法¶

先在会话里列出或筛选 skill：

/skills                    # 列出本会话全部 skill
/skills docx               # 按名称、描述、whenToUse 等关键词过滤

维护安装与镜像：

/skills-uninstall pr       # 卸载名为 pr 的 skill
/skills-update             # 更新默认 mirror mattpocock-skills
/skills-update my-repo     # 更新指定 repo mirror
/skills-doctor             # 结构与健康检查

面板上的安装、更新、卸载、健康检查与上述命令等价，可按习惯二选一或混用。

配置¶

默认管理目录为 ~/.dsh/skills（skill）与 ~/.dsh/repos（repo mirror）。若路径不同，可在 profile patch（cordis.patch.yml）里覆盖 skill-console 行：

- id: skill-console
  config:
    skillsDir: /Users/you/.dsh/skills            # default
    reposDir: /Users/you/.dsh/repos              # default

适用场景与注意¶

适合谁： 经常在 DSH desktop 里增删、更新 community skill，或需要一眼看清「叫什么、怎么调、从哪来、落在哪」的开发者。

权限与安全： 插件以当前 DSH 进程权限运行；/skills-uninstall、/skills-update 等会读写本地 skill 目录并对 mirror 执行 git pull。安装前应阅读仓库源码与 MIT 许可证，确认来源可信。

生态说明： DSH 采用「一切皆插件」思路；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。本插件主分发渠道为该 GitHub 仓库；npm 发布为可选，scoped 包名发布时需 npm publish --access public。

本地验证（维护者提供的离线测试）：

node test/smoke.mjs
node test/manager.test.mjs

小结¶

dsh-skill-console 把 DSH 原本「无 UI 的 skill 发现机制」补成可浏览、可搜索的面板，并把列表、卸载、镜像更新和 doctor 收到四条命令里，与 ~/.dsh/skills 的 symlink 模型一致。目录页：https://www.skillhub.cn/plugins/mi-lu-uncle/dsh-skill-console；源码与 README：https://github.com/mi-lu-uncle/dsh-skill-console。