dsh-plugin-local-utilities

English | 中文

DeepSeek Harness 的本地工具 Cordis 插件。

注意：本仓库目前不是 Codex 插件包，也不是独立的 skill 包。仓库中没有 .codex-plugin/plugin.json、skills/ 目录或本地 SKILL.md。它的作用是作为 DeepSeek Harness 的 Cordis 插件运行，并把外部 Markdown SKILL.md 注册到 Harness 的 skill registry。

功能

• 当根 agent 进入 idle 状态时，在 Windows 上发送完成通知。
• 从 GitHub 或 Markdown URL 导入外部 skill，并通过 Harness 的 ctx.skills registry 暴露给 Harness。

插件是 TypeScript Cordis 插件，不需要修改 DeepSeek Harness 核心代码。

环境要求

• DeepSeek Harness 的开发版 checkout。
• Node.js ^22.19.0 || >=24.0.0。
• pnpm。
• Windows，用于桌面完成通知。
• 加载 GitHub 托管 skill 时，需要能访问 api.github.com。

本地运行

先在本插件仓库安装依赖：

pnpm.cmd install

复制示例配置为本地配置文件：

Copy-Item .\cordis.example.yml .\cordis.local.yml

编辑 cordis.local.yml，把 name 改成本仓库 src/index.ts 的绝对 file:/// URL。

示例：

- insert:
    - id: local-utilities
      name: 'file:///C:/absolute/path/to/dsh-plugin-local-utilities/src/index.ts'
      config:
        externalSkills:
          - name: khazix-writer
            description: Write in a natural human style with less mechanical phrasing.
            url: https://github.com/KKKKhazix/khazix-skills/tree/main/khazix-writer
            whenToUse: Use when the user asks for natural, human-like writing.

然后进入 DeepSeek Harness 仓库，用 --patch 加载你编辑后的本地配置文件：

pnpm.cmd dsh web --patch C:\path\to\dsh-plugin-local-utilities\cordis.local.yml

如果默认端口被占用：

pnpm.cmd dsh web --patch C:\path\to\dsh-plugin-local-utilities\cordis.local.yml --port 3082

启动后，日志中应能看到：

[local-utilities] loaded

调用导入的 skill

插件加载后，externalSkills 中配置的 skill 会注册到 Harness skill registry。

如果 Harness 已启用对应的 skill UI 或 skill tool 消费端，可以在 Web UI 中显式调用：

/khazix-writer

Rewrite this paragraph in a more natural human style:
...

模型也可以在任务匹配 skill 描述时调用内置 skill tool。注意：本插件只负责注册 skill provider，不单独提供 /skill-name 命令或模型工具；这些入口取决于当前 Harness 配置。

配置

interface Config {
  enabled: boolean
  title: string
  message: string
  balloonMs: number
  rootAgentsOnly: boolean
  externalSkills?: ExternalSkillSource[]
}

interface ExternalSkillSource {
  name: string
  description: string
  url: string
  whenToUse?: string
}

字段说明：

• enabled：是否启用 Windows 完成通知，默认 true。
• title：通知标题，默认 DeepSeek Harness。
• message：通知正文，默认 AI run completed.。
• balloonMs：通知显示时间，单位毫秒，默认 5000。
• rootAgentsOnly：是否只对根 agent 发送通知，默认 true。
• externalSkills：要导入的外部 Markdown skill 列表，默认空数组。

externalSkills[].name 应使用 kebab-case，例如 khazix-writer 或 human-writing。Harness skill registry 可能会拒绝非法名称。

支持的 skill URL

支持以下外部 skill URL：

• https://github.com/<owner>/<repo>
• https://github.com/<owner>/<repo>/tree/<ref>/<skill-dir>
• https://github.com/<owner>/<repo>/blob/<ref>/<path>/SKILL.md
• https://raw.githubusercontent.com/<owner>/<repo>/<ref>/<path>/SKILL.md
• 任何直接返回 Markdown 文本的 URL

GitHub 仓库 URL 会通过 GitHub Contents API 加载，避免依赖 raw.githubusercontent.com 的 DNS 可用性。

需要注意：

• https://github.com/<owner>/<repo> 会默认读取 main 分支根目录的 SKILL.md。
• 如果 skill 不在 main 分支根目录，请使用 tree、blob、raw 或直接 Markdown URL。
• tree 和 blob URL 中的 <ref> 按 URL path segment 解析；如果分支名包含 /，建议改用 raw 或直接 Markdown URL。

开发

常用命令：

pnpm.cmd install
pnpm.cmd test
pnpm.cmd run typecheck

如果 pnpm install、pnpm test 或 pnpm run typecheck 被 pnpm 的 minimum-release-age 供应链策略拦截，需要先按团队策略处理依赖：等待策略窗口结束、调整本机 pnpm 策略，或重新生成可信的 lockfile 后再验证。

本地对接相邻的 DeepSeek Harness checkout 时，可以使用未跟踪的 cordis.local.yml，或自己创建一个本地 patch 文件，里面使用绝对 file:/// 插件路径。

限制

• 外部 skill 在 Harness 启动时从 Cordis 配置加载，目前没有 Web UI 动态导入命令。
• GitHub skill 加载需要访问 api.github.com。
• Windows 通知依赖 powershell.exe、System.Windows.Forms 和 System.Drawing，只适用于 Windows。
• 本仓库当前不是可直接安装的 Codex 插件包；如果要作为 Codex 插件发布，需要补充 .codex-plugin/plugin.json 以及对应的 Codex 插件结构。