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

架构拆解书 LaplaceYoung/dsh-book-deepseek-harness

DeepSeek Harness
LaplaceYoung81 天前有提交已提供中文文档扫描:含敏感能力

《深入理解 DeepSeek Harness:一切皆插件的 Agent 架构》——源码级架构拆解科普书:37…

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

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

自动兼容检查未通过:仓库根目录及浅层子目录均无 dsh 插件清单,无法用 dsh 插件安装命令安装。以下命令仍可尝试,但可能失败。
无法用 dsh 插件命令安装(仓库内无 dsh 插件清单)
git clone https://github.com/LaplaceYoung/dsh-book-deepseek-harness.git
按该仓库 README 的原生方式安装;若作者另行发布了 DSH 插件包,请以其文档为准

状态速览

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

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

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

仓库根目录及浅层子目录均无 dsh 插件清单,无法用 dsh 插件安装命令安装

展开查看检查明细 ↓

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

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

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

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/2 11:42:38

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

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件
查看扫描证据(共 16 处,展示前 16 条)
  • 读取本地文件
    build/build-pdf.mjs:20
    const summary = readFileSync(join(ROOT, 'SUMMARY.md'), 'utf8')
  • 读取本地文件
    build/build-pdf.mjs:29
    for (const f of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
  • 读取本地文件
    build/build-pdf.mjs:57
    const md = readFileSync(join(ROOT, rel), 'utf8')
  • 读取本地文件
    build/build-pdf.mjs:68
    const md = readFileSync(join(ROOT, rel), 'utf8')
  • 写入本地文件
    build/build-pdf.mjs:180
    writeFileSync(htmlOut, html, 'utf8')
  • 读取本地文件
    build/diag-mermaid.mjs:9
    const summary = readFileSync(join(ROOT, 'SUMMARY.md'), 'utf8')
  • 读取本地文件
    build/diag-mermaid.mjs:14
    const md = readFileSync(join(BOOK, rel), 'utf8')
  • 写入本地文件
    build/diag-mermaid.mjs:36
    writeFileSync('/tmp/diag.html', html)
  • 写入本地文件
    build/render-mermaid.mjs:18
    mkdirSync(OUT_DIR, { recursive: true })
  • 写入本地文件
    build/render-mermaid.mjs:19
    mkdirSync(OUT_MD_DIR, { recursive: true })
  • 读取本地文件
    build/render-mermaid.mjs:22
    const summary = readFileSync(join(ROOT, 'SUMMARY.md'), 'utf8')
  • 读取本地文件
    build/render-mermaid.mjs:32
    const md = readFileSync(join(BOOK_DIR, rel), 'utf8')
  • 写入本地文件
    build/render-mermaid.mjs:79
    writeFileSync(htmlPath, html, 'utf8')
  • 读取本地文件
    build/render-mermaid.mjs:119
    const md = readFileSync(join(BOOK_DIR, rel), 'utf8')
  • 写入本地文件
    build/render-mermaid.mjs:125
    mkdirSync(dirname(outPath), { recursive: true })
  • 写入本地文件
    build/render-mermaid.mjs:126
    writeFileSync(outPath, out, 'utf8')
扫描于 2026/11/2(1 天前) · 范围 全包扫描 · 来源 GitHub 仓库

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

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

功能亮点

  • 源码级架构拆解
  • 37个章节文件
展开完整介绍(79 字)↓

《深入理解 DeepSeek Harness:一切皆插件的 Agent 架构》——源码级架构拆解科普书:37 个章节文件、PDF、Mermaid 图与写作规范

README

由 DeepSeek 最新模型翻译生成
《深入理解 DeepSeek Harness:一切皆插件的 Agent 架构》 一本科普向的源码级架构拆解书:把 DeepSeek Harness(dsh)这台「一切皆插件」的机器,用咖啡馆聊天的方式讲清楚。目标读者是对 AI 编程工具有好奇心的开发者、产品经理、技术爱好者——不要求写过 agent 代码,不要求懂 TypeScript。 Topics: deepseek-harness · dsh-book · deepseek · agent-architecture 这本书讲什么 dsh 与其他 AI 编程工具最大的不同:一切皆插件(Cordis)、事件溯源 Session Log、可重构性(模型可见 ⟺ 已记录)、自我指涉工具、Code Mode。全书沿着这五条主线逐层拆解系统,并每章与 Claude Code 做对比,让熟悉主流工具的读者快速建立参照。 目录 全书 37 个文件:前言 + 33 章 + 3 附录,约 15.6 万中文字符,33 张图。
展开完整文档(README 剩余 1 节)
《深入理解 DeepSeek Harness:一切皆插件的 Agent 架构》

一本科普向的源码级架构拆解书:把 DeepSeek Harness(dsh)这台「一切皆插件」的机器,用咖啡馆聊天的方式讲清楚。目标读者是对 AI 编程工具有好奇心的开发者、产品经理、技术爱好者——不要求写过 agent 代码,不要求懂 TypeScript。

Topics: deepseek-harness · dsh-book · deepseek · agent-architecture

这本书讲什么

dsh 与其他 AI 编程工具最大的不同:一切皆插件(Cordis)、事件溯源 Session Log、可重构性(模型可见 ⟺ 已记录)、自我指涉工具、Code Mode。全书沿着这五条主线逐层拆解系统,并每章与 Claude Code 做对比,让熟悉主流工具的读者快速建立参照。

目录

全书 37 个文件:前言 + 33 章 + 3 附录,约 15.6 万中文字符,33 张图。

| 部分 | 内容 |
| 一 全景与基础 | 为什么「让 AI 干活」这么难、一条消息的旅程、仓库地图 |
| 二 插件基石:Cordis | 一切皆插件、事件、作用域与生命周期、配置与 profile |
| 三 核心引擎 | 事件溯源会话、agent 主循环、LLM 适配层、系统提示词 |
| 四 能力系统 | 能力缝隙、文件系统、命令执行与终端、工具管线、技能/搜索 |
| 五 安全与治理 | 沙箱、审批、设置与密钥 |
| 六 状态与持久化 | 持久化、查询/续聊/分身、上下文压缩 |
| 七 多 Agent 编排 | 子智能体、工作流、目标与接力循环 |
| 八 接口与前端 | 多前端、Python SDK、Code Mode |
| 九 工程实践 | 测试与自检、agent notes 文化、亲手写插件 |
| 十 思想与展望 | 设计哲学、与其他工具对比 |
| 附录 | 术语表、零件清单、笔记索引 |

完整目录见 SUMMARY.md。

仓库内容

dsh-boook-deepseek-harness/
├── book/ # 全部 37 个章节源文件(Markdown) ├── 《深入理解 DeepSeek Harness》.pdf # 成书 PDF(Chrome 排版输出) ├── outline.md # 完整大纲(10 部分 · 33 章 · 3 附录) ├── SUMMARY.md # 目录索引 ├── WRITING-STYLE-v4.md # 写作规范(科普版) ├── assets/mermaid/ # 书内插图(PNG) └── scripts/ # 骨架生成与引用校验脚本

事实基准

书中一切 dsh 机制描述来自官方仓库 deepseek-ai/deepseek-harness(写作基准提交 71c89e3e)。dsh 在写作期间处于封闭内测,书中涉及现状的表述均为时点表述;外部工具(Claude Code、Codex 等)只描述公开可见功能。

构建 PDF

node build/build-pdf.mjs
管线:Markdown → HTML(Mermaid 渲染)→ Chrome 打印 PDF 产出:《深入理解 DeepSeek Harness》.pdf

许可

书籍内容与代码 BSD-3-Clause;书中引用的外部工具信息仅作事实性引用。
预览分享卡片长什么样 ↓LaplaceYoung/dsh-book-deepseek-harness
分享 · DeepSeek Harness Hub
LaplaceYoung/dsh-book-deepseek-harness

《深入理解 DeepSeek Harness:一切皆插件的 Agent 架构》——源码级架构拆解科普书:37…

回到顶部