前言¶
在 DeepSeek Harness（DSH）里做智能体时，SKILL.md 往往不只在 ~/.dsh/skills 里：WorkBuddy、Claude Code、Codex、豆包工作版各自有一套目录，GitHub 上还有大量仓库只放一个技能文件。要回答「我手里到底有哪些技能」「这份 SKILL.md 写了什么」「怎么装一份新的」，过去多半只能开文件管理器逐个翻。
维护者 fenshal 的客户端插件 dsh-skillbox（包名 @local/dsh-skillbox，当前版本 0.2.0，MIT）把汇总、预览、导入与 GitHub 发现做成左侧栏里的整页三栏界面。下面按安装顺序说明它做什么、怎么用，以及配置与边界。
这是什么¶
DSH Skill Library 是 DSH 的 bundle 插件：依赖客户端提供 @deepseek-ai/dsh-client-ui-layout 与 @deepseek-ai/dsh-client-ui-sidebar（README 写明 DSH 0.1.x 起自带）。入口在左侧栏「插件 / 自动化任务」同一组，点「技能库」图标进入整页布局——左分类、中卡片网格、右详情。
插件在主机侧扫描多个来源目录（只读），在 Web 侧渲染 UI，并支持会话里按轮次选择「专家」人设。导入技能时是复制到 ~/.dsh/skills，不改动原始目录。
核心功能¶
资料中的能力可以概括为下表；每一项都对应 README 里写明的行为。
| 能力 | 说明 |
|---|---|
| 汇总 | 扫描 DSH、WorkBuddy、Claude Code、Codex、豆包等技能目录，合并为可搜索的卡片列表 |
| 预览 | 右侧展示文件树、SKILL.md 摘要，支持「查看全文」弹层 |
| 导入 / 移除 | 一键复制为 DSH 常驻技能；移除只删除本插件导入的那份 |
| 专家 | 读取 WorkBuddy 专家包、豆包「工作伙伴」导出包，可导入为带人设的技能 |
| 发现 | 在 GitHub 上按 SKILL.md 搜索，预览后安装到 ~/.dsh/skills |
| 会话专家胶囊 | 输入框下方选专家，按轮次生效；助手回复上方显示头像与名字 |
技能页签：左侧按来源分组（全部、已安装、各平台），顶部搜索实时过滤；卡片含标题、平台徽章、简介、路径，星标表示已安装。可切换排序（默认 / 名称 / 大小 / 最近使用）与中文/原文显示。
专家页签：不导入也可在输入框下方胶囊里选用，人设注入当前会话；导入则复制到 ~/.dsh/skills/expert-<名字>。选择按轮次记录（例如第 3 轮选中，第 4 轮起才显示头像）。
发现页签：分类含 Claude / Codex / DSH / 通用 Agent；支持「技能」模式（GitHub 代码搜索 filename:SKILL.md）与「仓库」模式。确认预览后可「安装到技能库」。
安装与启用¶
插件以本地 bundle 方式安装，README 未提供 dsh plugin add github:... 一类命令。任选其一：
方式一：本地目录（README 标注为推荐，适合开发或自用）
克隆仓库后，在 DSH 内把该目录装成 bundle（路径换成你的实际位置）：
git clone https://github.com/fenshal/dsh-skillbox.git
plugin_manager install_bundle <克隆目录的绝对路径>
方式二：压缩包
从 Releases 下载 dsh-skillbox-0.2.0.zip，解压后同样执行：
plugin_manager install_bundle <解压目录的绝对路径>
装完后在左侧栏点「技能库」即可。若你自行修改了 client.js 等客户端代码，README 要求改完后重挂 bundle（先 enabled:false 再 enabled:true），否则页面仍是旧代码。
典型用法¶
- 打开技能页签，用来源分组或搜索框定位一份本地
SKILL.md，在右侧看摘要或全文，再执行导入。 - 在专家页签浏览 WorkBuddy / 豆包导出里的专家；需要长期常驻时再导入，临时对话可直接用输入框下方胶囊。
- 在发现页签选分类与「技能 / 仓库」模式，预览 GitHub 上的
SKILL.md，确认后安装到~/.dsh/skills。
无 GitHub Token 时发现页仍可用，但受匿名 API 限流（代码搜索 10 次/分、仓库搜索 30 次/分），且拿不到 star / fork 统计；页面会提示配置 Token。
配置要点¶
| 配置项 | 位置 | 说明 |
|---|---|---|
| GitHub Token | 发现页提示条，或 ~/.dsh/skillbox-github.json 的 {"token":"..."} |
可选；优先级高于 GH_TOKEN / GITHUB_TOKEN |
| 导出包目录 | DSH_SKILLBOX_IMPORTS（; 分隔）、~/.dsh/skillbox-imports.json 的 {"dirs":[...]}、或默认 ~/.dsh/imports |
合并去重，用于扫描豆包「工作伙伴」导出包 |
| 数据与日志 | ~/.dsh/skillbox-*.json、~/.dsh/skillbox-inject.log |
专家选择、翻译缓存、Token、注入排查等 |
Token 还可从已登录的 gh CLI（gh auth token）回落；最终可匿名。简介翻译走 MyMemory 公共接口，仅发送简介文本。发现页只调用 GitHub 官方 API；Token 明文存本机，不上传第三方。
适用场景与注意¶
适合谁：经常在多平台之间搬运 SKILL.md、需要从 GitHub 试装社区技能、或希望在一个界面里预览再导入 DSH 的开发者。
权限与信任：插件随当前 DSH 进程权限读取本机目录与调用 GitHub API；安装前应浏览 源码仓库 与 MIT 许可证，确认 Token 与导出目录配置符合你的环境策略。
已知限制（README 原文）：专家导入只搬运人设与技能文本，不带工具集和连接器；依赖豆包/美图云服务的专家导入后云端调用无法复现。豆包工作版专家头像/介绍本地不可用。机翻对产品名不友好，标题保留原名。GitHub 无下载量，发现页只能用 star / fork 近似热度。
扫描来源时只读不写；仅解析明文 SKILL.md / plugin.json / manifest.json，加密或二进制存储会跳过。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/fenshal/dsh-skillbox
- 源码与说明：https://github.com/fenshal/dsh-skillbox
在「技能分散、安装靠手工翻目录」的场景里，dsh-skillbox 把浏览、预览、导入和 GitHub 发现收到同一面板；按 README 用 plugin_manager install_bundle 挂上 bundle 后即可从侧栏进入使用。
