dsh-development

September 1, 2026 · View on GitHub

跨 Agent 通用的 DeepSeek Harness (DSH) 插件 / 工具开发 Skill — 供 Cursor、Claude Code、Codex 等 AI 助手加载，指导 Cordis 插件编写、bundle 安装、配置调试与客户端 UI。

A portable Agent Skill (standard SKILL.md + references/) for DeepSeek Harness (DSH) plugin and tool development — works with any agent that supports the Agent Skills format.

简介

本仓库遵循 Agent Skills 开放格式（根目录 SKILL.md + YAML frontmatter + 可选参考文件），不绑定单一 IDE 或厂商：

主题	内容
插件安装	`dsh plugin add/remove`、profile / bundle、层序、`--patch` 原型
Cordis	概念、Fiber 状态机、Config schema、插件写法
能力扩展	工具规约、Conversation Node、LLM 适配器、扩展钩子
客户端 UI	设置页槽位、webServer 路由、settings 白名单规避
排障	重启语义、duplicate id、升级 fallback、已知坑

采用渐进披露：SKILL.md（~100 行）作任务路由，细节在 references/ 按需加载。

上游文档：deepseek-ai/deepseek-harness（本 skill 索引其 docs/，并附带少量离线中文副本）。

兼容的 Agent

只要支持从技能目录加载 SKILL.md 的 Agent 均可使用，例如：

Agent	典型技能目录
通用（推荐）	`~/.agents/skills/`
Cursor	`~/.cursor/skills/`
Claude Code	`~/.claude/skills/` 或 `~/.agents/skills/`
其他	见各产品文档中的 skills / rules 路径

同一仓库 clone 或 symlink 到对应目录即可，无需改内容。

何时使用

在以下场景让 Agent 加载本 skill：

开发 / 安装 / 调试 DSH 插件或工具
dsh plugin add、cordis.patch.yml、bundle 重复 insert
配置保存不生效、settings 白名单、duplicate loader entry id
DSH 升级后首页 400、客户端 UI、Chat 自定义行

安装

# 推荐：跨 Agent 共享目录
git clone https://github.com/lordqyxz/dsh-development.git ~/.agents/skills/dsh-development

# Cursor
git clone https://github.com/lordqyxz/dsh-development.git ~/.cursor/skills/dsh-development

# Claude Code（若使用 ~/.claude/skills）
git clone https://github.com/lordqyxz/dsh-development.git ~/.claude/skills/dsh-development

# 或软链到已有 checkout
ln -s /path/to/dsh-development ~/.agents/skills/dsh-development

安装后重启 Agent 或新开会话，由 Agent 根据 description 自动匹配加载。

目录结构

dsh-development/
├── SKILL.md              # 入口：frontmatter + 任务路由 + 快速开始
├── references/           # 专题参考（按需阅读）
│   ├── plugins.md        # 安装 / 卸载 / bundle / CLI
│   ├── restart.md        # 热更 vs 重启
│   ├── cordis.md         # Cordis 概念与插件写法
│   ├── architecture.md   # 架构与扩展点映射
│   ├── capabilities.md   # 工具 / Conversation Node / LLM
│   ├── client-ui.md      # 设置页 / 槽位 / 路由
│   ├── docs-index.md     # 官方文档索引
│   ├── environment.md    # 本机 $DSH_HOME 事实
│   └── troubleshooting.md
└── docs-official/        # 离线中文文档片段 + INDEX

官方文档（本地克隆）

git clone --depth 1 https://github.com/deepseek-ai/deepseek-harness.git ~/dev/deepseek-harness

更新 skill：

cd ~/.agents/skills/dsh-development && git pull

License

MIT — see LICENSE.