前言¶
在 DeepSeek Harness(DSH)里做智能体或日常会话时,skill 往往分散在用户目录、项目 .dsh/skills、内置包和自建的补充路径里。只靠记忆路径或手动翻文件夹,很难快速看清「当前 profile 到底有哪些 skill、从哪来、怎么插入 /名字 调用」。Skill GoGo 是社区维护的客户端面板插件,把浏览、分组、预览、导出、安装到项目、重命名,以及对话输入区的多选插入,收进侧边栏和一个输入区菜单。
这是什么¶
Skill GoGo(包名 dsh-skill-gogo,维护者 fanghedeng)是挂在 DSH 工作区左侧边栏的面板插件(书本图标「Skill GoGo」)。它解决的是:在一个界面里看见全部 skill 来源、按自己的方式分组、并把 /skill-name 写进当前会话或输入框。
插件数据除 skill 本身外,只落盘一个配置文件:$DSH_HOME/skill-gogo.json(默认 ~/.dsh/skill-gogo.json),保存分类、归属与补充目录;界面文案支持 zh / en,配色跟随 DSH 主题 token。
- 目录页:https://www.skillhub.cn/plugins/fanghedeng/dsh-skill-gogo
- 源码与说明:https://github.com/fanghedeng/dsh-skill-gogo
核心功能¶
浏览与来源¶
面板列出当前 profile 可见的全部 skill,并在头部标注来源与数量,包括:
- 用户目录:
$DSH_HOME/skills - 项目级:
<工作区>/.dsh/skills、.agents/skills - 内置(bundled)
- 通过「目录」维护的自定义补充目录(注册进
ctx.skills,rank 250,与/名字调用一致)
支持搜索(/ 聚焦,匹配名称 / 描述 / 何时使用)、来源筛选 chip、行首复选框多选。
分类¶
顶部「+ 新建分类」可自建文件夹式分组;把 skill 拖到分类名上即可归类。分类上右键可重命名、改颜色、上移 / 下移、删除(删除后 skill 回到「未分类」);skill 行右键也可「移动到分类」。折叠状态与分类库会持久保存。
使用与输入区菜单¶
- 面板详情:「使用」把
/skill-name写入当前会话输入框(无法写入时复制到剪贴板);「复制调用文本」仅复制。 - 对话输入区:输入框左侧增加「Skill」菜单,带搜索、按分类分组,可多选,点「插入调用」一次性写入
/a /b(同样优先正式插槽 API,失败则整串复制)。
插入逻辑优先走 DSH 的 inputActions.captureInsertion() → insertText(text, token);拿不到句柄时再操作 [data-composer-input],再不行则复制到剪贴板并提示。
下载与装进项目¶
- 「下载」将 skill 目录打包为
<name>-skill.zip(含skill-gogo.manifest.json);多选后可「批量下载」。 - 「复制到项目」复制到
<工作区>/.dsh/skills/<name>/,不覆盖已存在的同名目录,之后该工作区会话可把其当作项目级 skill。
导出为 store 模式 zip;大目录受 lib/skills.mjs 中 DEFAULT_LIMITS 约束(400 个文件 / 单文件 2 MB / 合计 32 MB)。
本地显示与重命名¶
- 「在本地显示文件」用系统文件管理器打开 skill 目录并选中入口文件(Windows
/select、macOS Finder-R、Linuxxdg-open)。URL / opaque 型 skill 无本地文件,该项置灰。 - 「重命名 skill」会改磁盘:更新
SKILL.md的name:;目录型且目录名等于旧名时会改目录名;平铺<name>.md会改文件名;分类归属随之迁移。内置(app.asar只读)或无本地文件的 skill 会拒绝并说明原因。
只处理本地目录型 skill(resourceBase.kind === 'directory');URL / opaque 型仅展示元信息,不提供下载、本地显示与重命名。
安装与启用¶
桌面端(当前 profile)可在会话里说明安装意图,或使用 plugin_manager 工具。软链安装(改插件目录即生效;只改前端刷新页面,改宿主半区需重启 DSH)示例:
plugin_manager { action: "install_bundle", target: "link:C:\\Users\\MaoYiJie\\Documents\\deepseek-harness\\default-workspace\\skill-gogo" }
若希望复制一份、之后可删除源目录,将 target 设为插件目录的绝对路径(pnpm 会复制)。
桌面端完全退出后,若 dsh 已在 PATH,可用命令行:
dsh plugin --profile desktop add link:C:\Users\MaoYiJie\Documents\deepseek-harness\default-workspace\skill-gogo
卸载:
plugin_manager { action: "remove_bundle", target: "dsh-skill-gogo" }
首次安装客户端 bundle 后需重启一次桌面端:Electron 在启动时收集 index 注入表,运行期新装的客户端 bundle 不会进入已启动的页面;重启后侧边栏才会出现 Skill GoGo。
插件以当前 DSH 进程权限运行;安装前请自行查看源码与许可证(MIT)。依赖 @deepseek-ai/dsh-skill,该服务缺失时面板会显示「skill 服务不可用」。
典型用法¶
- 安装并重启桌面端后,点开左侧「Skill GoGo」,用来源 chip 区分用户 / 项目 / 内置 / 自定义目录。
- 新建分类,拖拽或右键把常用 skill 归组;用搜索或
/快速定位。 - 在详情页点「使用」,或打开输入区左侧「Skill」多选后「插入调用」,把
/foo /bar写入当前输入。 - 需要随仓库分发时,对 skill 使用「复制到项目」或「下载」打包 zip。
- 维护本地 skill 时,用「在本地显示文件」定位
SKILL.md,或用「重命名 skill」同步改 frontmatter 与目录名。
宿主半区还提供 /skill-gogo/api/* 接口(回环 + 同源,写操作额外校验),供面板与自动化场景使用;设 SKILLGOGO_REVEAL_DRY_RUN=1 时 /api/reveal 仅计算目标、不拉起文件管理器。
适用场景与注意¶
适合经常在多工作区、多来源之间切换 skill 的 DSH 用户:需要可视化目录、自建分组、批量导出,或在写 prompt 时从输入区多选插入调用。
需注意:「在本地显示文件」由宿主进程拉起系统文件管理器,仅在插件受信任的 HTTP 接口内触发;重命名与「复制到项目」会真实写盘。社区插件目录 SkillHub 与 DeepSeek / 幻方无官方从属关系,安装与升级以仓库 README 与发布包为准。
结尾¶
Skill GoGo 把 skill 的查看、分类、调用、打包和项目级安装集中到一个客户端面板,并补上输入区多选菜单,减少在目录树和会话之间来回找 /名字 的成本。进一步了解功能与接口细节,见 SkillHub 目录页 与 GitHub 仓库。