DeepSeek Harness Agent 的原理与实现：从零到一实现一个 AI Agent —— 一切皆插件的中文教程（VitePress 站点 + 8 个 Demo + mini-harness 教学项目）
50.8/100
综合分
73
GitHub 星标
—
npm 周下载
—/5
用户评分
数据截至 2026/9/27 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。
自动兼容检查未通过：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。以下命令仍可尝试，但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add yanhua1010/dsh-harness-tutorial该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）
状态速览
判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态信任档位：已验证
是什么
dsh 原生插件 · tool
安全吗
本站尚未对该插件做风险分级
暂未覆盖，不等同于无风险
还在维护吗
更新放缓：最近一次提交在 81 天前
档位由哪些信号合成
本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装
展开查看检查明细 ↓
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-harness-tutorial（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=20.19.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。
验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/1 07:01:16
安全扫描自动 · 静态分析源码v2.7.0🔵 扫描：含敏感能力尚无人工评估展开查看扫描说明与证据 ↓
安全扫描自动 · 静态分析源码
v2.7.0静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。
读写/删除本地文件
查看扫描证据（共 9 处，展示前 9 条）
- 读取本地文件demos/05-headless-mock/read-session.mjs:12
cwdDir = readdirSync(join(home, 'sessions')).at(-1) - 读取本地文件demos/05-headless-mock/read-session.mjs:13
sessionDir = readdirSync(join(home, 'sessions', cwdDir)).at(-1) - 读取本地文件demos/05-headless-mock/read-session.mjs:20
const buf = readFileSync(file) - 读取本地文件demos/06-tool-echo/read-session.mjs:12
cwdDir = readdirSync(join(home, 'sessions')).at(-1) - 读取本地文件demos/06-tool-echo/read-session.mjs:13
sessionDir = readdirSync(join(home, 'sessions', cwdDir)).at(-1) - 读取本地文件demos/06-tool-echo/read-session.mjs:20
const buf = readFileSync(file) - 读取本地文件demos/07-hooks/read-session.mjs:12
cwdDir = readdirSync(join(home, 'sessions')).at(-1) - 读取本地文件demos/07-hooks/read-session.mjs:13
sessionDir = readdirSync(join(home, 'sessions', cwdDir)).at(-1) - 读取本地文件demos/07-hooks/read-session.mjs:20
const buf = readFileSync(file)
扫描于 2026/11/2（1 天前） · 范围 全包扫描 · 来源 GitHub 仓库
静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。
给这个插件打分还没有人投票↓
用户评分
还没有人投票，来当第一个
功能亮点
- 讲解Agent原理
- 从零实现AIAgent
- 含8个Demo
README
由 DeepSeek 最新模型翻译生成DeepSeek Harness Agent 的原理与实现：从零到一实现一个 AI Agent
一个完整可运行的 VitePress 中文教学站点，把 DeepSeek Harness（「一切皆插件」的 Agent 框架）拆解成一套适合计算机本科毕业生的渐进式教程：先懂原理，再用 8 个真实可运行的 Demo 掌握机制，最后亲手实现一个教学版目标项目（React 前端 + Node.js TypeScript 后端）。
仓库结构
dsh-harness-tutorial/
├── docs/ # VitePress 教程站点（中文） │ ├── guide/ # 原理篇（8 章） │ ├── source/ # 源码拆解篇（6 章） │ ├── demos/ # 实战 Demo 篇（8 个 Demo 教程页） │ ├── project/ # 教学版项目篇（8 章） │ └── appendix/ # 术语表 / 常见错误 / 参考资料 ├── demos/ # 渐进式 Demo 代码（基于真实 dsh 包，已验证） │ ├── 01-first-plugin/ …
展开完整文档（README 剩余 1 节）
DeepSeek Harness Agent 的原理与实现：从零到一实现一个 AI Agent 一个完整可运行的 VitePress 中文教学站点，把 DeepSeek Harness（「一切皆插件」的 Agent 框架）拆解成一套适合计算机本科毕业生的渐进式教程：先懂原理，再用 8 个真实可运行的 Demo 掌握机制，最后亲手实现一个教学版目标项目（React 前端 + Node.js TypeScript 后端）。 仓库结构 dsh-harness-tutorial/ ├── docs/ # VitePress 教程站点（中文） │ ├── guide/ # 原理篇（8 章） │ ├── source/ # 源码拆解篇（6 章） │ ├── demos/ # 实战 Demo 篇（8 个 Demo 教程页） │ ├── project/ # 教学版项目篇（8 章） │ └── appendix/ # 术语表 / 常见错误 / 参考资料 ├── demos/ # 渐进式 Demo 代码（基于真实 dsh 包，已验证） │ ├── 01-first-plugin/ … 08-profile/ └── final-project/ # 教学版目标项目 mini-harness ├── packages/mini-harness/ # 核心库（约 900 行 TS，零运行时依赖） ├── apps/server/ # Node 后端（Express + SSE） └── apps/web/ # React 前端（聊天 + 实时事件面板） 快速开始 ① 教程站点 npm install npm run docs:dev # http://localhost:5173/dsh-harness-tutorial/ ② 渐进式 Demo（在 demos/ 下） cd demos && npm install npm run demo:1 # Demo 1–4 Demo 5–8 见 demos/README.md（dsh headless overlay，无需 API Key） ③ 教学版项目（在 final-project/ 下） cd final-project && npm install npm run demo # 核心库冒烟测试 npm run dev:server # 终端 A：后端 http://127.0.0.1:4317 npm run dev:web # 终端 B：前端 http://localhost:5174 在线阅读 站点已通过 GitHub Actions 部署到 GitHub Pages： https://yanhua1010.github.io/dsh-harness-tutorial/ 版本锁定 - DeepSeek Harness（开发者预览）：0.1.0-rc.6 - Cordis：4.0.1 - Node.js：≥ 20.19（推荐 22+） 所有 Demo 均在该版本上实际运行验证。项目处于快速迭代期，架构思想稳定，API 细节请以官方文档最新版为准。 许可证 教程内容与代码均为教学用途，遵循 MIT 协议精神。DeepSeek Harness 本身以 MIT 开源。
预览分享卡片长什么样 ↓
分享 · DeepSeek Harness Hub
yanhua1010/dsh-harness-tutorial
DeepSeek Harness Agent 的原理与实现：从零到一实现一个 AI Agent —— 一切皆插件的中文教程（VitePress 站点 + 8 个 Demo + mini-harness 教学项目）
相关插件 · 工具 / 效率
破甲管控台kingcharleslzy-ai/dsh-purge
dsh-purge Community · DeepSeek Harness 社区维护版：宿主兼容、状态诊断、提示词管理、更新与本机备份回滚。基于小杨 / YuJunZhiXue 的 dsh-purge。
★ 4,173已汉化DeepSeek 客户端
74.4
网文长卷lingfengQAQ/webnovel-writer
基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200…
★ 7,636已汉化DSH
72.2
多智能体协作HKUDS/AutoSwarm
AutoSwarm: Unify Your Agents. Unify Your Context (Codex · Claude Code · DeepSeek Harness · Muse · Grok · WorkBuddy· nanobot · and more)
★ 2,197已汉化DSH
71.7
Vox 拼贴视频生成Alisa0808/vox-director
🎬 Vox Director拼贴动效导演
★ 2,129已汉化DSH
71.4
Agent 演化引擎Q00/ouroboros
智能体 OS：智能体自己变聪明，我们只守住底线：面试准入、分阶段评估、带预算的进化循环。MCP 服务器，14 种运行时：Claude Code、Codex CLI、Gemini CLI、OpenCode、Copilot、Kiro 等。
★ 6,308已汉化DSH
71.3
智能体运行框架路由HarnessRouter/harnessrouter
智能体运行框架的统一接口。
★ 3,897已汉化DSH
71.2