DeepSeek Harness 实战:做一个面向 Three.js 与 Python 的 Agent CLI
一个 Three.js 页面,切换几次场景以后越来越卡。前端需要检查动画循环、事件监听和 GPU 资源释放,后端又有一个等待上游响应的 Python 接口,迟迟没有结束。把这两段代码交给模型,往往能得到一些建议。真正进入项目时,还需要模型自己找到文件、读懂调用关系、修改实现,再运行项目已有的检查。
运行时与工具调度的实现原理见DeepSeek Harness 原理篇。
一个 Three.js 页面,切换几次场景以后越来越卡。前端需要检查动画循环、事件监听和 GPU 资源释放,后端又有一个等待上游响应的 Python 接口,迟迟没有结束。把这两段代码交给模型,往往能得到一些建议。真正进入项目时,还需要模型自己找到文件、读懂调用关系、修改实现,再运行项目已有的检查。
运行时与工具调度的实现原理见DeepSeek Harness 原理篇。
假设我们要做一个文章生成工具,用户输入这样的需求:
输入一个技术主题,先生成提纲,再根据提纲写正文。提纲和正文的提示要求都可以修改,同一套流程下次还能换一个主题运行。
一次模型调用也能直接返回整篇文章。但如果用户想单独检查提纲、调整正文的输入,或者看清失败发生在哪一步,就需要把过程显式表达出来。工作流编辑器的价值,正是让这些步骤成为可以理解、修改和重复执行的对象。
本文围绕“主题 → 提纲 → 正文 → 最终结果”展开:先说明工作流怎样描述,再解释 LangChain 与 LangGraph 各自承担的工作,最后讨论画布编辑、异步交互和运行反馈。
前端实现可以参考我放在 GitHub 的 **LangChainWeb**,使用 React、React Flow 和 Zustand。文中的前端实现说明对应公开仓库;执行器、校验和持久化部分讨论通用设计,不代表该前端仓库单独提供了完整服务。
给编程智能体接上一个模型接口,很快就能看到它回答问题。真正值得追问的部分发生在回答之后。模型要求修改文件时,谁决定这次修改可以执行?用户按下 Ctrl+C 时,正在写入的工具会怎样结束?下一次恢复对话,程序又凭什么判断某个工具已经运行过?
安装、规则配置与项目接入见DeepSeek Harness 实战篇。
让编程助手解释一段代码,和让它把一个问题修好,是两种很不一样的体验。前者把答案写在对话框里就够了;后者要碰到真实文件、真实命令,还得面对用户随时插进来的修改。
假设你给它这样一句话:“切换几次 3D 模型,页面就越来越卡。帮我找原因,修完跑一下项目现有的检查。”终端里开始搜索、读文件、改代码,看起来顺理成章。但这些动作靠什么衔接?读到一半文件变了怎么办?测试命令报错以后,是继续修,还是直接结束?
这几个问题,比找一段神奇的系统提示词更吸引我。它们决定一个助手能不能在真实项目里持续工作,也正好是这次源码阅读的主线。
2026 年 3 月 31 日,Claude Code 的一次 npm 发布意外暴露了内部源码。@anthropic-ai/claude-code 的 2.1.88 版本带上了不应公开的 source map,相关源码随后被保存和整理到多个仓库中。这次事件让开发者得以直接阅读一个实际编程代理的客户端实现。事件报道
本文使用的泄露源码整理仓库:hujinbin/claude-code。 想边读边对照,可以从这里打开目录;文中的源码引用另外固定到了具体提交,方便以后回看。
分析基线是提交 480314ded0d2f60bd854ff3e2661116d0f3a1b5e,整理提交日期为 2026 年 4 月 13 日。本文以静态阅读为主:副本缺少完整构建配置和部分模块,下面的修复场景用于解释代码,不是一份实际运行报告;讨论范围也限定在这份实现。
沿着代码走下去,会看到一套围绕模型组织起来的运行时:它维护消息,调度工具,检查权限,管理上下文,也负责把任务收住。这类系统在 Agent 工程里常被称为 Harness。这个词听起来抽象,放进上面的修复任务里就好理解了:模型决定下一步试什么,运行时把这个决定落到实际操作上,再把发生的事情告诉模型。
Source map 用来关联构建后的代码与原始源码,方便调试。根据生成方式,它可能包含原始源码内容,也可能暴露指向源码的路径或位置。因此,拿到相应调试产物,有时就能看到远比压缩后 JavaScript 更完整的实现,而无需重新推导源程序。Source map 说明
这次泄露属于发布链路中的调试产物暴露。Anthropic 将事件归因于人为造成的发布打包失误。公司回应
这件事给开发者的提醒很具体:编译结果、调试产物和最终发布包,需要分别看待。调试文件对排查线上问题很有用,但“内部调试需要它”和“用户安装包应该带上它”是两回事。
至于“Bun 默认生成 .map,忘写 .npmignore 就会泄露”的说法,细节还要分开看。Bun 当前文档列出的 sourcemap 默认值是 none;实际生成方式和打包范围取决于项目自己的配置。这份副本没有原始发布配置,因此下面重点研究泄露出来的实现。Bun 构建文档
本文把它作为泄露源码来读,并不把它称作官方主动开源。阅读对象是编程代理的客户端工程,范围也不延伸到模型权重或全部云端服务。
准备做一个 AI 应用时,经常会遇到这个问题:已经能用模型 SDK 发请求了,还需要 LangChain 吗?如果接下来有多个步骤,是不是就应该直接上 LangGraph?
只用“简单任务选 LangChain,复杂任务选 LangGraph”来判断,信息还不够。一个步骤很多但顺序固定的任务,可能用普通函数就能维护;一个看似简单的“查到合适资料再回答”,却可能需要模型反复选择工具。两种复杂性并不一样。
更有用的判断依据是:谁决定下一步,哪些数据需要保留,任务中断后要怎样继续。 本文沿着这三个问题比较两者,并结合 GitHub 上的 LangChainWeb,说明可视化编辑与运行编排之间的关系。
一段任务只有“接收输入 → 调用函数 → 返回结果”时,用普通异步函数就很好理解。需求一旦变成“按类型走不同处理器”“等两个步骤完成再汇总”“检查不通过就修改”,需要关心的就不只是某个函数,而是整个执行过程。
例如,一个客服工具要先判断咨询类型,再分别准备退款、开票或普通问题的回复。后来又增加了查询订单、检查回复、交给人工确认等步骤。此时我们需要回答:当前有哪些数据?下一步为什么执行?失败后会重复哪些操作?
LangGraph 用状态、节点和边描述这类任务。本文从一个不依赖模型的工单分流案例开始,沿着一次运行解释它的工作方式,再讨论并发、循环和恢复。这里侧重原理与实现步骤,不展开具体项目的服务端代码。
给页面加一个“AI 生成”按钮,第一步通常不难:把用户输入发给模型,再把回答展示出来。真正麻烦的是后面的需求——换一种写作风格、延续上一轮对话、让结果填进表单、在失败时指出具体原因。
例如,我们希望用户输入“JavaScript Promise 的错误传播”,应用就生成一份面向前端开发者的文章提纲。接下来,用户还可以说“减少概念介绍,多加几个排错案例”。这时需要组织的已经不只是一段提示词,而是输入、上下文、模型响应和业务数据之间的关系。
本文用这个例子讲清楚 LangChain 的几个基础概念,以及它们在 JavaScript 应用中怎样配合。配套的可视化编辑项目放在 GitHub:LangChainWeb。读完本篇,可以继续看实战篇,把一次调用扩展成可以编辑和运行的工作流。
做一个图片上传功能,最开始通常很简单:选文件,预览,调接口。需求慢慢加上来,事情就变了。图片太大,要先压一压;格式不统一,希望转成 WebP;用户还想拖动质量滑杆,看清楚压完的效果再上传。
这些工作当然可以交给服务端。但如果图片就在用户电脑里,处理完只需要一个文件,也可以把这一段留在浏览器里完成。页面负责交互,浏览器负责读图,编码库负责生成新的图片。
WebAssembly 就可以出现在这里。对前端开发者来说,日常接触它的入口往往是一个 npm 包:安装、导入、异步调用,然后把返回的数据接回页面。我们关心的是这段能力怎么进入现有项目,以及用户点下按钮后,页面能不能一直好好响应。
这篇文章用 JavaScript + Vite + Web Worker 做一个本地图片转 WebP 的小工具。Wasm 编码器使用现成的 @jsquash/webp,整个案例只写前端代码。

截图使用的是内置生成的 PNG 示例,显示的体积和耗时只对应这一次处理。
手把手教你为 AI 系统开发自定义技能,让 AI 助手更懂你的业务
当你使用 ChatGPT 或 Claude 时,有没有想过:**”如果 AI 能直接查询我的数据库该多好”、“要是它能自动发邮件就完美了”**?
这就是 AI Skill 的价值所在。
AI Skill(AI 技能)是为 AI 系统开发的可调用能力模块,让 AI 能够:
本文将教你:
┌─────────────────────────────────────────┐
│ AI 系统(LLM) │
│ ChatGPT / Claude / 自建模型 │
└──────────────┬──────────────────────────┘
↓
┌──────────────────────────────────────────┐
│ Skill 调度层(Router) │
│ - 意图识别 │
│ - 参数提取 │
│ - 权限验证 │
└──────────────┬───────────────────────────┘
↓
┌──────────────────────────────────────────┐
│ Skill 执行层 │
├──────────────────────────────────────────┤
│ Skill 1: 数据查询 │
│ Skill 2: 邮件发送 │
│ Skill 3: 文档生成 │
│ Skill 4: API 调用 │
│ ... │
└──────────────┬───────────────────────────┘
↓
┌──────────────────────────────────────────┐
│ 外部系统 / 数据源 │
│ 数据库 | API | 文件系统 | 第三方服务 │
└──────────────────────────────────────────┘在 AI 重塑工作的时代,掌握这些技能让你从”被替代”变成”不可替代”
当 ChatGPT 发布时,很多人担心”AI 会取代我的工作吗?”
一年半后,答案变得清晰:AI 不会取代你,但会用 AI 的人会取代你。
据 LinkedIn 2026 年报告显示:
本文将系统性地介绍 AI 时代的必备技能,并提供清晰的学习路径。
AI 技能金字塔
▲ AI 架构师
/|\
/ | \ 构建 AI 系统
/ | \
────────────────
/ AI 工程师 \
/ \
/ 模型微调 / Agent开发 \
/________________________\
/ Prompt Engineering \
/ 工具集成 / API 使用 \
/______________________________\
/ AI 素养基础 \
/ 理解原理 / 工具使用 / 场景判断 \
/____________________________________\