DeepSeek Harness 实战:做一个面向 Three.js 与 Python 的 Agent CLI

一个 Three.js 页面,切换几次场景以后越来越卡。前端需要检查动画循环、事件监听和 GPU 资源释放,后端又有一个等待上游响应的 Python 接口,迟迟没有结束。把这两段代码交给模型,往往能得到一些建议。真正进入项目时,还需要模型自己找到文件、读懂调用关系、修改实现,再运行项目已有的检查。

运行时与工具调度的实现原理见DeepSeek Harness 原理篇。

LangChain 与 LangGraph 项目实战:从对话生成到可编辑工作流

假设我们要做一个文章生成工具,用户输入这样的需求:

输入一个技术主题,先生成提纲,再根据提纲写正文。提纲和正文的提示要求都可以修改,同一套流程下次还能换一个主题运行。

一次模型调用也能直接返回整篇文章。但如果用户想单独检查提纲、调整正文的输入,或者看清失败发生在哪一步,就需要把过程显式表达出来。工作流编辑器的价值,正是让这些步骤成为可以理解、修改和重复执行的对象。

本文围绕“主题 → 提纲 → 正文 → 最终结果”展开:先说明工作流怎样描述,再解释 LangChain 与 LangGraph 各自承担的工作,最后讨论画布编辑、异步交互和运行反馈。

前端实现可以参考我放在 GitHub 的 **LangChainWeb**,使用 React、React Flow 和 Zustand。文中的前端实现说明对应公开仓库;执行器、校验和持久化部分讨论通用设计,不代表该前端仓库单独提供了完整服务。

DeepSeek Harness 原理解析:一次任务如何从模型走到工具执行

给编程智能体接上一个模型接口,很快就能看到它回答问题。真正值得追问的部分发生在回答之后。模型要求修改文件时,谁决定这次修改可以执行?用户按下 Ctrl+C 时,正在写入的工具会怎样结束?下一次恢复对话,程序又凭什么判断某个工具已经运行过?

安装、规则配置与项目接入见DeepSeek Harness 实战篇。

Claude Code 泄露源码解读,从 Agent 循环到工具权限与上下文管理

让编程助手解释一段代码,和让它把一个问题修好,是两种很不一样的体验。前者把答案写在对话框里就够了;后者要碰到真实文件、真实命令,还得面对用户随时插进来的修改。

假设你给它这样一句话:“切换几次 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 泄露说起

Source map 用来关联构建后的代码与原始源码,方便调试。根据生成方式,它可能包含原始源码内容,也可能暴露指向源码的路径或位置。因此,拿到相应调试产物,有时就能看到远比压缩后 JavaScript 更完整的实现,而无需重新推导源程序。Source map 说明

这次泄露属于发布链路中的调试产物暴露。Anthropic 将事件归因于人为造成的发布打包失误。公司回应

这件事给开发者的提醒很具体:编译结果、调试产物和最终发布包,需要分别看待。调试文件对排查线上问题很有用,但“内部调试需要它”和“用户安装包应该带上它”是两回事。

至于“Bun 默认生成 .map,忘写 .npmignore 就会泄露”的说法,细节还要分开看。Bun 当前文档列出的 sourcemap 默认值是 none;实际生成方式和打包范围取决于项目自己的配置。这份副本没有原始发布配置,因此下面重点研究泄露出来的实现。Bun 构建文档

本文把它作为泄露源码来读,并不把它称作官方主动开源。阅读对象是编程代理的客户端工程,范围也不延伸到模型权重或全部云端服务。

LangChain 和 LangGraph 的区别,结合可视化工作流理解选型

准备做一个 AI 应用时,经常会遇到这个问题:已经能用模型 SDK 发请求了,还需要 LangChain 吗?如果接下来有多个步骤,是不是就应该直接上 LangGraph?

只用“简单任务选 LangChain,复杂任务选 LangGraph”来判断,信息还不够。一个步骤很多但顺序固定的任务,可能用普通函数就能维护;一个看似简单的“查到合适资料再回答”,却可能需要模型反复选择工具。两种复杂性并不一样。

更有用的判断依据是:谁决定下一步,哪些数据需要保留,任务中断后要怎样继续。 本文沿着这三个问题比较两者,并结合 GitHub 上的 LangChainWeb,说明可视化编辑与运行编排之间的关系。

LangGraph 入门:用状态、节点和连线构建工作流

一段任务只有“接收输入 → 调用函数 → 返回结果”时,用普通异步函数就很好理解。需求一旦变成“按类型走不同处理器”“等两个步骤完成再汇总”“检查不通过就修改”,需要关心的就不只是某个函数,而是整个执行过程。

例如,一个客服工具要先判断咨询类型,再分别准备退款、开票或普通问题的回复。后来又增加了查询订单、检查回复、交给人工确认等步骤。此时我们需要回答:当前有哪些数据?下一步为什么执行?失败后会重复哪些操作?

LangGraph 用状态、节点和边描述这类任务。本文从一个不依赖模型的工单分流案例开始,沿着一次运行解释它的工作方式,再讨论并发、循环和恢复。这里侧重原理与实现步骤,不展开具体项目的服务端代码。

LangChain 入门:用 JavaScript 组织模型调用与提示模板

给页面加一个“AI 生成”按钮,第一步通常不难:把用户输入发给模型,再把回答展示出来。真正麻烦的是后面的需求——换一种写作风格、延续上一轮对话、让结果填进表单、在失败时指出具体原因。

例如,我们希望用户输入“JavaScript Promise 的错误传播”,应用就生成一份面向前端开发者的文章提纲。接下来,用户还可以说“减少概念介绍,多加几个排错案例”。这时需要组织的已经不只是一段提示词,而是输入、上下文、模型响应和业务数据之间的关系。

本文用这个例子讲清楚 LangChain 的几个基础概念,以及它们在 JavaScript 应用中怎样配合。配套的可视化编辑项目放在 GitHub:LangChainWeb。读完本篇,可以继续看实战篇,把一次调用扩展成可以编辑和运行的工作流。

前端怎么用 WebAssembly?从一个浏览器图片压缩工具说起

做一个图片上传功能,最开始通常很简单:选文件,预览,调接口。需求慢慢加上来,事情就变了。图片太大,要先压一压;格式不统一,希望转成 WebP;用户还想拖动质量滑杆,看清楚压完的效果再上传。

这些工作当然可以交给服务端。但如果图片就在用户电脑里,处理完只需要一个文件,也可以把这一段留在浏览器里完成。页面负责交互,浏览器负责读图,编码库负责生成新的图片。

WebAssembly 就可以出现在这里。对前端开发者来说,日常接触它的入口往往是一个 npm 包:安装、导入、异步调用,然后把返回的数据接回页面。我们关心的是这段能力怎么进入现有项目,以及用户点下按钮后,页面能不能一直好好响应。

这篇文章用 JavaScript + Vite + Web Worker 做一个本地图片转 WebP 的小工具。Wasm 编码器使用现成的 @jsquash/webp,整个案例只写前端代码。

浏览器图片转 WebP 案例:原图与结果预览、质量调节、体积和耗时信息

截图使用的是内置生成的 PNG 示例,显示的体积和耗时只对应这一次处理。

从零开发 AI Skill:打造你的第一个 AI 能力扩展

手把手教你为 AI 系统开发自定义技能,让 AI 助手更懂你的业务

引言:AI Skill 是什么?

当你使用 ChatGPT 或 Claude 时,有没有想过:**”如果 AI 能直接查询我的数据库该多好”、“要是它能自动发邮件就完美了”**?

这就是 AI Skill 的价值所在。

AI Skill(AI 技能)是为 AI 系统开发的可调用能力模块,让 AI 能够:

  • 📊 访问你的数据源(数据库、API、文件系统)
  • 🔧 执行具体操作(发邮件、创建工单、调用服务)
  • 🎯 理解特定领域(你的业务逻辑、专业知识)

本文将教你:

  1. AI Skill 的技术原理
  2. 从零开发一个完整的 Skill
  3. 接入主流 AI 平台(OpenAI、Claude、MCP)
  4. 生产环境最佳实践

一、AI Skill 技术架构

1.1 核心组件

┌─────────────────────────────────────────┐
│           AI 系统(LLM)                  │
│   ChatGPT / Claude / 自建模型            │
└──────────────┬──────────────────────────┘
               ↓
┌──────────────────────────────────────────┐
│         Skill 调度层(Router)            │
│  - 意图识别                               │
│  - 参数提取                               │
│  - 权限验证                               │
└──────────────┬───────────────────────────┘
               ↓
┌──────────────────────────────────────────┐
│           Skill 执行层                    │
├──────────────────────────────────────────┤
│  Skill 1: 数据查询                        │
│  Skill 2: 邮件发送                        │
│  Skill 3: 文档生成                        │
│  Skill 4: API 调用                        │
│  ...                                      │
└──────────────┬───────────────────────────┘
               ↓
┌──────────────────────────────────────────┐
│        外部系统 / 数据源                  │
│  数据库 | API | 文件系统 | 第三方服务    │
└──────────────────────────────────────────┘

AI 时代必备技能指南:从 Prompt 新手到 AI 专家的进阶路

在 AI 重塑工作的时代,掌握这些技能让你从”被替代”变成”不可替代”

引言:AI 技能的新时代

当 ChatGPT 发布时,很多人担心”AI 会取代我的工作吗?”

一年半后,答案变得清晰:AI 不会取代你,但会用 AI 的人会取代你。

据 LinkedIn 2026 年报告显示:

  • 📈 AI 相关技能需求增长 450%
  • 💰 掌握 AI 技能的开发者薪资溢价 30-50%
  • 🚀 90% 的科技公司将 AI 技能列为核心要求

本文将系统性地介绍 AI 时代的必备技能,并提供清晰的学习路径。

一、AI 技能图谱

                    AI 技能金字塔

                      ▲ AI 架构师
                     /|\
                    / | \  构建 AI 系统
                   /  |  \
              ────────────────
             /    AI 工程师   \
            /                  \
           /  模型微调 / Agent开发 \
          /________________________\
         /    Prompt Engineering    \
        /     工具集成 / API 使用      \
       /______________________________\
      /         AI 素养基础              \
     /  理解原理 / 工具使用 / 场景判断    \
    /____________________________________\

:D 一言句子获取中...