企业官网建设流程全解析

1. 为什么要把 Agent 拆成插件来拼

做 Agent 工程，迟早会遇到一个绕不开的问题：模型可以换，工具可以加，但 Agent 的“工作方式”通常改不了。你能选择它用哪个模型，却不能完全决定它什么时候调用模型、如何调用工具、失败后怎么恢复，以及什么时候判断任务完成。Cursor、Claude Code 这类产品用起来很顺手，它们更像一个完整产品，普通用户不需要关心底层细节；但对想自己研究 Agent 架构、调整执行流程的工程师来说，真正的核心逻辑仍然藏在产品内部。

DeepSeek Harness（简称 DSH）选择了另一条路。它的核心主张是：一切皆插件。模型、工具、Agent Loop、UI、存储、沙箱，每一层都能拔下来换。这句话听起来像是“支持插件”，但 DSH 想表达的其实更彻底：不仅外围功能是插件，连通常被当作核心的 Agent Loop，也可以作为插件被替换。DSH 是一个 AI Agent 运行时，不是聊天 App，MIT 开源，当前是 v0.1 开发者预览，本机包版本为 0.1.0-rc.6，入口命令是dsh，用dsh web启动浏览器 UI，内核基于 Cordis 插件元框架。

“支持插件”本身并不稀奇。Claude Code 支持 MCP，VSCode 也支持插件，它们都可以在原有系统上扩展功能。DSH 里的“皆”指的是另一件事：它自己也是用插件拼出来的，没有一个不能替换的特权核心。接入模型是插件，执行命令是插件，读写文件是插件，网页界面是插件，Agent 主循环也是插件。官方提供的插件，和第三方开发者写的插件，遵循的是同一套装配方式，只是官方的那批插件会在默认配置中被加载。

可以把它理解成两种设备：Claude Code 更像一台装配好的 iPhone，很好用，但 CPU、系统和主要零件都不是用户可以随便替换的；DSH 更像一台自己装的电脑，模型、工具、存储、执行环境都有插槽，想换哪一块就换哪一块。当然，自己装机的代价是门槛更高，你需要理解插件、依赖和配置，而不是装好就直接用。

这篇内容面向的是想用统一 Key/API 通道管理多模型调用的开发者。我会先讲清楚 DSH 的三个核心概念，再给出插件目录结构、Agent Loop 配置片段，最后把 endpoint 改到 TaoToken 做一次本地验证。如果你正在做多模型 Agent，又不想每个 provider 都维护一套 Key 和计费，这套思路可以直接搬。

2. DSH 的三个核心概念：seam、插件与 Agent Loop

2.1 能力缝 seam：接口和实现分开

先分清接口和实现：接口约定“我能提供什么能力”，实现负责“我具体怎么完成这件事”。所谓 seam，就是在这两者之间划出一条边界，让调用方只依赖接口，而不依赖某个具体实现。想想墙上的插座，插座是接口，发电厂是实现，发电厂烧煤、烧核，还是用风电，充电器都不用改。

DSH 把很多能力都做成了这种接口：ctx.fs文件系统、ctx.shell命令执行、ctx.web联网访问、ctx.storage数据存储、ctx.jobs后台任务。比如 Agent Loop 只需要调用ctx.fs读取文件，它不用知道文件最终是从本地磁盘读取，还是从一个受限沙箱读取。要换执行环境时，替换对应的实现插件即可，上层代码不用跟着改。这就是接口和实现分离带来的直接好处：调用方稳定，底层实现可以替换。

2.2 插件：会自己报到的代码

插件不是一种特殊的文件格式，它更像是一种代码组织方式。普通模块通常是这样使用的：调用方知道模块叫什么，也知道什么时候调用它。插件的方向相反，插件加载后，会拿到框架提供的上下文，然后主动向框架声明自己提供什么、依赖什么，以及在什么生命周期阶段执行，框架负责把它装配起来。业内把这种关系称为“好莱坞原则”：Don't call us, we'll call you。

一个插件至少需要说清楚三件事：我是谁（提供哪个服务、工具或模型）、我需要什么（依赖哪些已有服务）、我什么时候运行（挂在哪些生命周期或事件上）。DSH 里可以把这些注册位置理解成几本花名册：模型注册表、工具注册表、UI 注册表等。dsh-tool-bash会登记“我提供 bash 工具”，dsh-llm-deepseek会登记“我提供 DeepSeek 模型连接”。Agent Loop 不需要把这些插件的名字写死，它只需要读取当前已经注册的工具和模型。

2.3 Agent Loop：一台反复工作的发动机

Agent Loop 就是驱动 Agent 持续工作的主循环。DSH 的dsh-agent-loop文档把它的核心概括得很简单：call the model, run the tools, repeat。每次“模型决定下一步、调用工具、拿到结果”，就是一次 step；多个 step 组成一次 turn；整段持续的对话属于一个 session。

更有意思的是，Loop 自己也不是一个不可触碰的核心。沙箱、权限、上下文压缩、失败重试、子代理等功能，都可以通过其他插件接入。子代理、工作流、目标管理，甚至也可以以工具的形式提供给模型。Loop 只负责把“模型 → 工具 → 结果 → 模型”这条链路继续跑下去，其他能力从外面接进来。

理解了这三个概念，你就能明白为什么 DSH 值得单独拿出来讲：它把 Agent 运行时应该如何拆分，展示得比较清楚。模型会换，工具会换，执行环境也会换，能够把这些变化隔离开，本身就是一种长期有效的工程能力。而多模型调用恰恰是这种隔离最直接的收益点——下面我们就从统一 Key 接入开始。

3. TaoToken 前置：统一 Key 与插件目录结构

3.1 为什么要在 DSH 里接 TaoToken

DSH 是 provider 中立的，模型连接本身就是一个插件。这意味着你可以把dsh-llm-*这类 provider 插件指向任意兼容 OpenAI 协议的 endpoint。TaoToken 提供的就是这样一个统一入口：一个 Base URL、一个 Key，就能调用多个模型，不用为每个 provider 单独维护 Key、额度和计费。

对 DSH 这种“模型是插件”的架构来说，这一点特别契合。你不需要为每个模型写一个 provider 插件，只要让 provider 插件指向 TaoToken 的 endpoint，模型 ID 在请求里切换即可。Agent Loop 读取的是“当前已注册的模型”，至于这个模型背后是哪家，Loop 不关心。

TaoToken 官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数，配置里填的就是这个。你需要先去控制台创建一个 API Key，控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，Key 管理页面在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

3.2 DSH 插件目录结构

DSH 的插件树不是写死在一个入口文件里的，而是通过 profile、bundle 和 patch 层逐步组合出来的。一个典型的插件目录结构大致是这样：

my-dsh-profile/ ├── package.json # 声明 dsh.bundle.patch 和 dsh.client.inject ├── cordis.patch.yml # profile 补丁，声明加载哪些插件 ├── src/ │ ├── index.ts # 宿主端插件入口 │ └── client.ts # 浏览器端插件入口（可选） └── plugins/ ├── dsh-llm-taotoken/ # 自定义 provider 插件 │ ├── package.json │ └── src/index.ts └── dsh-tool-bash/ # 工具插件 ├── package.json └── src/index.ts

profile 根配置本身可以是一个空列表，插件树通过后续的 bundle 和 patch 层组合。第三方插件的package.json里通过dsh.bundle.patch声明自己的 profile 补丁，通过dsh.client.inject声明浏览器端需要的依赖。宿主端代码直接使用 Cordis 的服务和上下文，例如：

import { Service } from "@deepseek-ai/cordis" ctx.inject(["settings"], (sctx) => { // 使用框架注入的 settings 服务 })

它不是在 DSH 的某个固定入口里被硬编码调用，而是通过自己的声明进入 profile，再由框架完成装配。这就是“第三方插件和官方插件使用同一个插槽”的具体证据。

3.3 可复制的 provider 配置片段

下面是把模型 endpoint 指向 TaoToken 的配置片段。先看cordis.patch.yml，它声明加载哪些插件：

# cordis.patch.yml - insert: - dsh-llm-taotoken - dsh-tool-bash - dsh-agent-loop

再看 provider 插件里的模型配置，用 JSON 形式给出，路径与 DSH 的 settings 服务一致：

{ "llm": { "providers": { "taotoken": { "baseURL": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": [ "deepseek-chat", "deepseek-reasoner" ] } }, "defaultProvider": "taotoken", "defaultModel": "deepseek-chat" } }

如果你用的是 Codex 风格的auth.json，三件套要写全：Base URL、Key、Model ID。对应关系是 Base URL 填https://taotoken.net/api，Key 填你在控制台创建的密钥，Model ID 填deepseek-chat或deepseek-reasoner。这三者缺一不可，只填 Base URL 不填 Model ID 是最常见的错误。

3.4 Agent Loop 配置片段

Agent Loop 的配置决定了它怎么调模型、怎么跑工具、失败后怎么恢复。一个可用的配置片段如下：

{ "agentLoop": { "maxSteps": 20, "maxTurns": 5, "retry": { "enabled": true, "maxRetries": 3, "backoffMs": 1000 }, "contextCompression": { "enabled": true, "threshold": 0.8 }, "tools": [ "bash", "fs", "web" ] } }

maxSteps控制单次 turn 里最多跑多少步，maxTurns控制整段 session 里最多几个 turn。retry是失败重试，contextCompression是上下文压缩，tools声明当前 Loop 能用哪些工具。这些能力本身也是插件，Loop 只负责把链路跑下去。

4. 验证请求：一次本地成功调用

配置写完之后，必须做一次本地验证，确认 endpoint 真的通了。最直接的方式是先用 curl 打一次 TaoToken 的接口，确认 Key 和 Base URL 没问题：

curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -d '{ "model": "deepseek-chat", "messages": [ {"role": "user", "content": "用一句话说明什么是 Agent Loop"} ] }'

如果返回里能看到choices数组和message.content，说明 Key 和 endpoint 都是通的。这一步能排除掉大部分配置问题，因为如果 Key 错了会返回 401，如果 Base URL 错了会返回 404 或连接失败。

curl 通了之后，再启动 DSH 本体：

dsh web

启动后浏览器会打开 UI，你会看到对话界面、文件树和变更面板。在对话里输入一个需要调用工具的任务，比如“读取当前目录下的 package.json 并告诉我项目名”。观察 Loop 的行为：它应该先调用fs工具读取文件，拿到结果后再调模型生成回答。如果这一步能跑通，说明 provider 插件、工具插件和 Agent Loop 三者已经正确装配。

我实测下来，最容易出问题的地方不是 Loop 本身，而是 provider 插件的注册时机。如果dsh-llm-taotoken没有在cordis.patch.yml里正确声明，Loop 启动时会找不到可用模型，报错信息通常是“no model provider registered”。这时候回头检查 patch 文件，确认插件名和目录名一致即可。

验证成功后，你可以在同一个 DSH 实例里切换模型，只要改defaultModel就行。比如从deepseek-chat切到deepseek-reasoner，Loop 不需要任何改动，因为它只认“当前注册的模型”，不认具体是哪家。这就是统一 Key 接入带来的直接好处：模型切换的成本从“改代码”降到了“改一行配置”。

如果你还想验证更多模型，可以直接在模型对话页面里试：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 。长期做编码和 Agent 任务的话，Coding Plan 更划算：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

配置和验证过程中，有几类报错特别常见。下面按真实报错逐条对照，给出排查方向。

401 Unauthorized。这是最常见的一类，几乎都是 Key 的问题。先确认apiKey字段填的是 TaoToken 控制台创建的密钥，不是其他平台的 Key。再确认请求头里的Authorization格式是Bearer sk-xxx，中间有一个空格。如果 curl 能通但 DSH 里报 401，检查 provider 插件读取 Key 的路径是否正确，有时候是 settings 服务没注入成功，插件读到了空字符串。

local proxy failed。这个报错通常出现在网络层，说明请求根本没发出去。先确认 Base URL 填的是https://taotoken.net/api，没有多余的空格或换行。再确认本机没有配置会拦截请求的环境变量，比如HTTP_PROXY、HTTPS_PROXY。如果这些变量指向了一个不可用的地址，请求会在本地就失败。清掉这些变量再试。

reading choices 报错。这类报错说明请求发出去了，也拿到了响应，但响应结构不符合预期。常见原因是 Model ID 填错了，比如填了一个 TaoToken 不支持的模型名，返回体里没有choices字段。对照接入文档确认模型名，deepseek-chat和deepseek-reasoner是确定可用的。另一个原因是 Base URL 少了/v1路径，有些客户端会自动补，有些不会，建议直接用https://taotoken.net/api让客户端自己拼。

OAuth 相关报错。如果你用的是 Claude Code 或 Codex 这类带 OAuth 流程的客户端，报错可能出现在认证阶段。这类客户端通常有自己的登录态，和 API Key 是两套机制。如果你要走 TaoToken 的 Key 通道，需要在配置里显式指定 API Key 模式，而不是 OAuth 模式。Claude Code 的接入方式可以参考文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 ClaudeCodeAnthropic 的配置说明。

排查的时候有一个通用顺序：先用 curl 确认 Key 和 endpoint，再确认客户端配置，最后看插件装配。大部分问题在前两步就能定位，真正出在插件装配上的很少。如果 curl 通了、客户端配置也对，但 DSH 里还是报错，那就去看cordis.patch.yml里插件有没有正确加载，以及 provider 插件的注册时机是不是在 Loop 启动之前。

6. 把统一 Key 接进你的 Agent 工作流

走到这里，你已经有了一个可以跑的 DSH 实例，模型 endpoint 指向 TaoToken，Agent Loop 正常装配，工具插件按需加载。接下来可以做的事情有几件。

第一件是把模型切换做成配置项。既然 provider 是插件、模型是注册表里的条目，你完全可以在 profile 里准备多套模型配置，按任务类型切换。比如日常对话用deepseek-chat，复杂推理用deepseek-reasoner，切换只改defaultModel一行。

第二件是把工具插件按需组合。DSH 的工具也是插件，bash、fs、web都是独立注册的。你可以根据任务场景决定加载哪些工具，比如做代码任务时加载bash和fs，做资料收集时加载web。Loop 读取的是当前注册的工具列表，不需要改 Loop 本身。

第三件是把这套配置迁移到其他客户端。TaoToken 的 Base URL 和 Key 是通用的，你在 DSH 里验证通过的配置，同样可以用在 Claude Code、Codex、Cline 等客户端里。区别只是配置文件的位置和字段名，Base URL、Key、Model ID 这三件套是不变的。

如果你打算长期跑编码和 Agent 任务，建议直接上 Coding Plan，额度更划算：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。需要管理多个 Key 或者查看用量，去控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。Key 的创建和轮换在 API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

最后说一个我踩过的坑：DSH 还是 v0.1 开发者预览，插件生态还在早期，第三方插件的质量和兼容性参差不齐。装插件之前先看它的package.json里dsh.bundle.patch指向哪个文件，确认它声明的是 profile 补丁而不是硬编码入口。这一点决定了它能不能和官方插件用同一套装配方式。如果它绕过了 patch 机制直接改入口，那它就不是真正的 DSH 插件，升级时大概率会出问题。

模型会换，工具会换，执行环境也会换。把这些变化隔离开，让上层只依赖接口，是这套架构最值得带走的东西。统一 Key 接入只是第一步，真正的价值在于你可以在不改 Agent 逻辑的前提下，把底层换掉。