CSY656/dsh-skill-remote

dsh-skill-remote

用于 DeepSeek Harness 的远程技能源：直接从你的 agent 中发现并安装来自 skills.sh 和公共 GitHub 仓库的技能。

- 一个远程技能提供程序（ctx.skills）：从 skills.sh / github.com URL 发现的候选项会与本地技能一起出现在会话技能目录中；技能正文按需加载。
- 一个供模型使用的 install_skill 工具：将技能包原子性地下载到 $DSH_HOME/skills//，随后由内置的文件系统提供程序接管——无需重启。

零配置：在未配置远程源且未进行安装的情况下，该插件不会执行任何网络 I/O。

安装

需要 DeepSeek Harness 的 next 系列（dsh ≥ 0.1.0-rc.6，其附带 dsh-skill 0.1.0-rc.6）。从 GitHub 安装（源码；pnpm 通过 prepare 构建）：

dsh plugin --profile default add github:you/dsh-skill-remote

pnpm ≥ 10 会要求你允许构建——将打印出的包键添加到该 profile 的 pnpm-workspace.yaml 中：

allowBuilds:
dsh-skill-remote: true

然后重新运行 add。（请将该许可视为允许此包在你的机器上运行构建；如果你愿意，可以固定到某个提交：github:you/dsh-skill-remote#。）

从 npm 安装（预构建，无需构建许可）：

dsh plugin --profile default add dsh-skill-remote

用法

对 agent 说：

安装 https://github.com/anthropics/skills/tree/main/skills/docx 处的技能

模型会调用 install_skill，该技能随即通过 skill 工具可用。你也可以预先注册只读远程源：

profile cordis.patch.yml
- update:
- id: skill-remote
config:
remotes:
- https://github.com/anthropics/skills/tree/main/skills/docx

支持的 URL 形式：https://www.skills.sh///、https://github.com///tree//、https://raw.githubusercontent.com/////。

安全限制（硬编码）

| 限制 | 值 |
|---|---|
| 单个文件 | 1 MiB |
| 整个包 | 8 MiB |
| 文件数量 | 64 |
| 递归深度 | 4 |
| 请求超时 | 30 s |
| 路径逃逸（条目名称中的 ..、/、\） | 拒绝 |
| 符号链接 / 子模块 | 跳过 |

安装是原子性的：技能包会下载到同级的暂存目录中，只有在通过校验（存在 SKILL.md）后才会被重命名到目标位置；任何失败都会删除暂存目录。仅限公共仓库——不会读取、存储或发送任何令牌。

配置

interface Config {
providerName?: string   // default 'remote'
remotes?: string[]      // URLs pre-registered at startup
installRoot?: string    // default $DSH_HOME/skills
}

已知限制

- 仅限公共仓库——不支持 OAuth/私有仓库；适用未认证 GitHub API 速率限制（每 IP 每小时 60 次请求）。
- 仅发现直接子项 — 与内置文件系统提供程序一样，远程源不会被递归扫描。
- 无版本固定 — 每次加载都会获取当前 ref 的顶端提交；安装是唯一的持久化方式。

为生态系统做贡献

- 该仓库带有 dsh-plugin 主题标签 — 浏览其他插件并添加你的插件。
- 发现了 bug 或想要某个功能？提交 issue 或 PR；使用 pnpm install && pnpm test 运行测试。
- 此处移植的行为来自 CsyCode 第 11 章的远程技能安装器。

许可证

MIT