🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

插件开发实战课 NanmiCoder/learn-deepseek-harness

DeepSeek Harness
NanmiCoder78 天前有提交已提供中文文档扫描:未发现敏感能力

交互式教程:20 节课,从「模型只会说话」讲到写出能装进真实 DeepSeek Harness 的插件。含可跑…

36.9/100
综合分
14
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/17 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过:缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。以下命令仍可尝试,但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add NanmiCoder/learn-deepseek-harness
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:需留意
是什么
dsh 原生插件 · dev
装得上吗
作者未把包发布到 npm,只能用源码安装
插件本身没问题,是分发方式不同
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 78 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包learn-deepseek-harness(未发布到 npm,仅可源码安装)
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/30 21:10:51

安全扫描自动 · 静态分析源码
v2.7.0
🟢 扫描:未发现敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描未发现敏感能力:最多只发网络请求、读取自身元数据或只读文件,未发现执行命令、文件写入或敏感信息读取。

扫描于 2026/11/3(0 天前) · 范围 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

界面预览

1 张 · 点击查看大图

功能亮点

  • 20节交互式教程
  • 可跑demo
  • 在线版

README

由 DeepSeek 最新模型翻译生成
在线版 ·课程地图 ·本地运行 · demo 说明 这是什么 一个交互式教程工作台,把 DeepSeek Harness(DSH)是怎么搭起来的讲清楚。写给会写代码、但没做过 agent 框架的人:不需要先懂插件系统、依赖注入、事件总线,从「大模型只会说话」讲起。 读完应该能做到三件事: - 说清 DeepSeek Harness 是什么、和 Claude Code 什么关系 - 照着写出一个能跑的插件 - 插件没生效时,知道去哪儿查 课程地图 20 节,分 7 个阶段。🔧 = 需要打开终端动手的课。 | 阶段 | 课程 | 读完能做什么 | | 认识 | 01 模型只会说话,谁去动手 · 02 DSH 是什么,跟 Claude Code 什么关系 · 03 把最小 Harness 跑起来 🔧 | 分得清零件库和产品,跑过一遍真实输出 | | 拆开 | 04 一次对话流过哪几块 · 05 一切皆插件 · 06 内核只做三件事 | 改功能知道开哪个文件 | | 动手 | 07 写一个插件,给模型加一个工具 🔧 · 08 插件没生效,怎么查 🔧 · 09 工具描述怎么写 | 亲手写出能跑的插件,会排查 | | 进阶 | 10 历史越滚越长怎么办 · 11 工具报错、模型抽风、循环停不下来 · 12 危险动作怎么拦 | 知道上下文、失败、审批分别怎么兜 |
展开完整文档(README 剩余 1 节)
在线版 ·课程地图 ·本地运行 · demo 说明

这是什么

一个交互式教程工作台,把 DeepSeek Harness(DSH)是怎么搭起来的讲清楚。写给会写代码、但没做过 agent 框架的人:不需要先懂插件系统、依赖注入、事件总线,从「大模型只会说话」讲起。

读完应该能做到三件事:

- 说清 DeepSeek Harness 是什么、和 Claude Code 什么关系
- 照着写出一个能跑的插件
- 插件没生效时,知道去哪儿查

课程地图

20 节,分 7 个阶段。🔧 = 需要打开终端动手的课。

| 阶段 | 课程 | 读完能做什么 |
| 认识 | 01 模型只会说话,谁去动手 · 02 DSH 是什么,跟 Claude Code 什么关系 · 03 把最小 Harness 跑起来 🔧 | 分得清零件库和产品,跑过一遍真实输出 |
| 拆开 | 04 一次对话流过哪几块 · 05 一切皆插件 · 06 内核只做三件事 | 改功能知道开哪个文件 |
| 动手 | 07 写一个插件,给模型加一个工具 🔧 · 08 插件没生效,怎么查 🔧 · 09 工具描述怎么写 | 亲手写出能跑的插件,会排查 |
| 进阶 | 10 历史越滚越长怎么办 · 11 工具报错、模型抽风、循环停不下来 · 12 危险动作怎么拦 | 知道上下文、失败、审批分别怎么兜 |
| 合起来 | 13 一次运行留下了什么 · 14 子 Agent 为什么要自己开一份日志 | 读得懂会话日志,分得清三个会话 |
| 真货 | 15 真实 DSH 的骨架 · 16 一个命令下去 agent 怎么被装出来 · 17 循环不是中心 | 看清真实骨架,知道 demo 走到哪为止 |
| 实战 | 18 从 demo 插件到真实 DSH 插件 · 19 host 面的三条接缝 · 20 一个包两个入口 🔧 | 写一个能真的装进 DSH 的插件 |

课程顺序以 src/lessons/index.ts 为准。

本地跑起来

npm install
npm run dev

打开 <http://localhost:5173>。左边是课程目录和进度,右边是工作台:每节课按「是什么 → 术语 → 分步演示 → 容易想错的地方 → 完成检查」走,分步演示支持键盘 ← → 翻步、空格播放暂停。

| 命令 | 干什么 |
| npm run dev | 开发服务器 |
| npm run demo | 跑一遍最小 Harness,看真实输出 |
| npm run build | 类型检查 + 打包到 dist/ |
| npm run typecheck | 只做类型检查(网页 + demo) |
| npm run check | 课程数据体检,见下 |

教程里的代码从哪来

全部来自 demo/ 下能跑的代码,两处:

- demo/mini-harness/ —— 一个能跑的最小 Harness,和真实的 DeepSeek Harness 结构同构,规模不同:一样的插件模型、服务与依赖、环绕式拦截、事件日志派生历史。差的是规模,不是形状。
- demo/dsh-plugin-example/ —— 一个能装进真实 DSH 的最小插件,实战层三节的代码从这儿来。

npm run demo

跑一下就能看到完整过程:插件排队等依赖、装配、模型要工具、工具执行、危险动作被拦、拒绝理由回灌给模型、插件被拆时自动清理。教程里「运行记录」面板显示的内容,就是这条命令的真实输出。

怎么加一节课

每节课是一份纯数据,不用写组件:

1. 在 src/lessons/ 下加一个文件,导出一个符合 Lesson 类型的对象
2. 在 src/lessons/index.ts 里 import 进来,按顺序放进 lessons 数组
3. 跑 npm run check

Lesson 的字段定义写在 src/tutorial/types.ts 的注释里。

npm run check 查的是类型检查管不到的东西:动画点亮的节点和连线在图里是不是真的存在、有没有画了却没点亮过的死线、答案下标有没有越界、标题说明有没有长到画不下;另有一项内容边界的硬拦——课程里不允许出现 DSH 内测项目的内部实现符号(路径、私有类型、内部字段名),面向插件开发者的公开扩展接口(包名、manifest 字段、插件形状)可以出现。有错误退出码 1。

结构

demo/mini-harness/ 自己写的最小 Harness,教程里所有代码都来自这里 src/ lessons/ 每节课的数据,一个文件一节 tutorial/ types.ts 课程数据契约 LessonView.tsx 工作台渲染器,所有课共用 LessonControls 播放控制条 useLessonPlayer 分步状态与键盘快捷键 components/ StageDiagram 分步动画,按步点亮节点和连线 RunLog 运行记录,走过的步骤会留在上面 CodePanel 代码与解释 Quiz 完成检查 scripts/ check-lessons.ts 课程数据体检

License

MIT
预览分享卡片长什么样 ↓NanmiCoder/learn-deepseek-harness
分享 · DeepSeek Harness Hub
NanmiCoder/learn-deepseek-harness

交互式教程:20 节课,从「模型只会说话」讲到写出能装进真实 DeepSeek Harness 的插件。含可跑…

回到顶部