DeepSeek Harness Hub
← 返回列表

DumplingHuman/dsh-plugin-tutorial

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
未验证

DeepSeek Harness 插件开发教程中文:环境搭建、Cordis 基础、Tool 开发、事件系统、LLM…

尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/14 · 已提供中文文档

DeepSeek Harness 插件开发教程(中文):环境搭建、Cordis 基础、Tool 开发、事件系统、LLM 适配器、打包发布

综合分
28
GitHub 分
28
用户评分
★ Stars
2
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add DumplingHuman/dsh-plugin-tutorial
该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/18(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

DeepSeek Harness 插件开发教程

📖 在线文档站:https://DumplingHuman.github.io/dsh-plugin-tutorial/

Docs
GitHub

从零开始学习为 DeepSeek Harness(DSH)开发插件的中文教程:环境搭建、Cordis 基础、第一个 Tool、插件配置、事件系统、LLM 适配器、会话与持久化、后台任务与子代理,以及打包发布。

DSH 是一个基于 Cordis 的插件化 Agent Harness:一切皆插件——模型适配器、工具注册表、会话日志、agent 循环本身都是插件,注册是可逆副作用(effect),换提供方不改模型契约。

📚 目录

| 章节 | 内容 | 状态 |
|---|---|---|
| 00-glossary.md | 术语表 | ✅ |
| 01-setup.md | 环境搭建与启动 | ✅ |
| 02-cordis-basics.md | Cordis 插件基础 | ✅ |
| 03-first-tool.md | 开发你的第一个 Tool | ✅ |
| 04-plugin-config.md | 插件配置 | ✅ |
| 05-events.md | 事件系统:DSH 的扩展点 | ✅ |
| 06-llm-adapter.md | 开发 LLM 适配器 | ✅ |
| 07-session.md | 会话与持久化 | ✅ |
| 08-jobs-subagent.md | 后台任务与子代理 | ✅ |
| 09-publish.md | 打包与发布插件 | ✅ |
| 10-reference.md | 参考资源与能力地图 | ✅ |

🚀 快速开始

1. 检出 DSH 仓库(前置:Node 22.19+ / 24+,pnpm 11.7.0,Git 2.26+)
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run typecheck   # 通过即搭建完成

2. 配置模型(设置 → 模型,或 DEEPSEEK_API_KEY 环境变量)

3. 启动 Web UI
pnpm dsh web

4. 打开 http://127.0.0.1:3080,选择工作区,开始对话

🧩 示例插件

examples/greet-tool/ 是一个完整可运行的示例:带配置的 greet 工具,演示依赖声明(inject)、配置(Config + Schemastery schema)与工具注册(defineTool)三个核心能力。

在 deepseek-harness 仓库根目录
pnpm dsh web --patch /absolute/path/to/examples/greet-tool/cordis.yml

📖 内容基于

本教程基于 DeepSeek Harness 官方文档(/guide、/develop、/reference 模块)与仓库源码整理编写,力求与官方实现保持一致;如与官方文档冲突,以官方为准。

🤝 贡献

欢迎通过 Issue / PR 完善教程。所有章节文件位于 docs/,示例位于 examples/。

📄 License

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群