OpenClaw Zero Token Web 流式工厂重构:单一注册点、上游同步与浏览器授权模式实战
OpenClaw Zero Token Web 流式工厂重构:单一注册点、上游同步与浏览器授权模式实战
导读
本文围绕 openclaw-zero-token 仓库中 重构实施计划 展开,讲解 Zero Token fork 如何把 Web 模型(ChatGPT Web、Claude Web、DeepSeek Web、Gemini Web 等)的流式创建逻辑收敛为单一注册表 web-stream-factories,从而在保持端到端行为不变的前提下大幅降低与上游 OpenClaw 的 merge / rebase 冲突成本。读完本文,你将掌握:注册表的实现与测试方法、attempt.ts / compact.ts 的分支收敛技巧、上游同步改动面清单与推荐步骤,以及基于 Chrome CDP 的三种浏览器授权模式(A/B/C)及其硬约束。
一、重构目标与核心架构
1.1 为什么需要这次重构
Zero Token 的核心能力是不依赖各平台官方 API Key,而是通过各站 Web 版(如 Claude、ChatGPT、DeepSeek、Gemini、Qwen、Kimi、豆包、GLM、Grok、MiMo 等)的浏览器登录态(Cookie、Header、页面内请求)完成对话。但 fork 必须长期跟随上游 [openclaw/openclaw] 演进,过去 Web 分支直接以内联 else if 形式散落在 attempt.ts / compact.ts 中,每次上游合并在这些热点文件上都会产生大量冲突。
计划的 Goal 明确为:在保持 Web 模型端到端行为不变的前提下,降低与上游 OpenClaw 的合并成本、完善浏览器授权文档,并为后续插件化迁移提供单一注册点。
1.2 目标架构
计划给出的架构决策是:
- 将 Web
model.api→create*WebStreamFn的映射收敛到src/zero-token/streams/web-stream-factories.ts(其中src/agents/web-stream-factories.ts仅为 re-export 桥接层); attempt.ts/compact.ts经该注册表解析,不再内联各站点协议;- 通过
docs/zero-token/upstream-sync.md固化 Zero Token 相对上游的改动面清单; - 通过
docs/zero-token/web-models-browser-modes.md固化 CDP / Profile 约束与可选路径(含 bb-browser 参考); - 不在计划内引入 CLI-Anything 或完整 bb-browser 依赖。
技术栈为 TypeScript (ESM) + Vitest + Playwright(既有),Web 实现集中位于 src/zero-token/。
1.3 涉及文件结构
计划涉及文件及职责如下表(当前仓库均已落地):
| 路径 | 职责 |
|---|---|
src/zero-token/streams/web-stream-factories.ts |
注册表源实现:集中导出 getWebStreamFactory(api) 与各 Web 流式工厂 |
src/zero-token/streams/web-stream-factories.test.ts |
校验注册表完整性与工厂可调用 |
src/agents/web-stream-factories.ts |
桥接层,re-export 注册表符号,稳定 attempt / compact 的 import 路径 |
src/agents/pi-embedded-runner/run/attempt.ts |
用注册表替换多段 else if 分支 |
src/agents/pi-embedded-runner/compact.ts |
同上,保持与 attempt 行为一致 |
docs/zero-token/upstream-sync.md |
Zero Token 改动面清单与同步步骤 |
docs/zero-token/web-models-browser-modes.md |
浏览器模式 A/B/C 与约束说明 |
docs/zero-token/zero-token-requirements.md |
追加变更记录行指向本计划 |
计划共拆分为 6 个 Task,任务状态(2026-03-28)为 Task 1–6 已全部落地,验证记录见文末。
二、Task 2:Web 流式工厂注册表(核心)
2.1 计划中的初版实现
计划在 Task 2 中新建 src/agents/web-stream-factories.ts,把 11 个 Web api 字符串与工厂函数一一对应:
import type { StreamFn } from "@mariozechner/pi-agent-core";
import { createChatGPTWebStreamFn } from "./chatgpt-web-stream.js";
import { createClaudeWebStreamFn } from "./claude-web-stream.js";
import { createDeepseekWebStreamFn } from "./deepseek-web-stream.js";
import { createDoubaoWebStreamFn } from "./doubao-web-stream.js";
import { createGeminiWebStreamFn } from "./gemini-web-stream.js";
import { createGlmIntlWebStreamFn } from "./glm-intl-web-stream.js";
import { createGlmWebStreamFn } from "./glm-web-stream.js";
import { createGrokWebStreamFn } from "./grok-web-stream.js";
import { createKimiWebStreamFn } from "./kimi-web-stream.js";
import { createQwenWebStreamFn } from "./qwen-web-stream.js";
import { createXiaomiMimoWebStreamFn } from "./xiaomimo-web-stream.js";
/** model.api 值 → 与 attempt.ts / compact.ts 原分支一致的工厂函数 */
const WEB_STREAM_FACTORIES = {
"deepseek-web": createDeepseekWebStreamFn,
"claude-web": createClaudeWebStreamFn,
"doubao-web": createDoubaoWebStreamFn,
"chatgpt-web": createChatGPTWebStreamFn,
"qwen-web": createQwenWebStreamFn,
"kimi-web": createKimiWebStreamFn,
"gemini-web": createGeminiWebStreamFn,
"grok-web": createGrokWebStreamFn,
"glm-web": createGlmWebStreamFn,
"glm-intl-web": createGlmIntlWebStreamFn,
"xiaomimo-web": createXiaomiMimoWebStreamFn,
} as const satisfies Record<string, (cookie: string) => StreamFn>;
export type WebStreamApiId = keyof typeof WEB_STREAM_FACTORIES;
export function getWebStreamFactory(api: string): ((cookie: string) => StreamFn) | undefined {
return WEB_STREAM_FACTORIES[api as WebStreamApiId];
}
export function listWebStreamApiIds(): WebStreamApiId[] {
return Object.keys(WEB_STREAM_FACTORIES) as WebStreamApiId[];
}
要点解读:
as const satisfies Record<string, (cookie: string) => StreamFn>:既锁死键集合(WebStreamApiId精确推导),又强制每个工厂签名统一为「传入 cookie 字符串,返回StreamFn」;getWebStreamFactory是唯一查询入口,未知api返回undefined,调用方据此走回退路径;listWebStreamApiIds用于测试与工具遍历,保证注册表自描述。
2.2 实际落地的注册表(当前源码)
当前仓库中注册表已从计划中的 src/agents/ 迁移到 src/zero-token/streams/web-stream-factories.ts,且相比计划初版有两处演进(可从 docs/zero-token/zero-token-requirements.md 变更记录确认):
- Provider 数量从 11 扩展到 13:新增
qwen-cn-web(Qwen 阿里国际)与perplexity-web; - 每个工厂结果被工具调用中间件包装:
wrapWithToolCalling(factory(cookie), api)统一接入src/zero-token/tool-calling/web-stream-middleware.js,让 Web 流式输出也具备工具调用能力(对应 web-tool-calling 文档)。
当前完整注册表(源码 L18-L32):
const WEB_STREAM_FACTORIES = {
"deepseek-web": createDeepseekWebStreamFn,
"claude-web": createClaudeWebStreamFn,
"doubao-web": createDoubaoWebStreamFn,
"chatgpt-web": createChatGPTWebStreamFn,
"qwen-web": createQwenWebStreamFn,
"qwen-cn-web": createQwenCNWebStreamFn,
"kimi-web": createKimiWebStreamFn,
"gemini-web": createGeminiWebStreamFn,
"grok-web": createGrokWebStreamFn,
"glm-web": createGlmWebStreamFn,
"glm-intl-web": createGlmIntlWebStreamFn,
"perplexity-web": createPerplexityWebStreamFn,
"xiaomimo-web": createXiaomiMimoWebStreamFn,
} as const satisfies Record<string, (cookie: string) => StreamFn>;
而 src/agents/web-stream-factories.ts 变为纯桥接层,只为 attempt.ts / compact.ts 提供稳定 import 路径,隔离 zero-token 目录结构调整带来的涟漪:
/**
* Bridge module: re-exports web stream factories from zero-token/streams.
* Architecture:
* - src/zero-token/streams/web-stream-factories.ts — source of truth
* - src/agents/web-stream-factories.ts — this bridge (re-export)
* - attempt.ts / compact.ts — import from this bridge
*/
export {
getWebStreamFactory,
listWebStreamApiIds,
type WebStreamApiId,
} from "../zero-token/streams/web-stream-factories.js";
2.3 注册表单测
计划在 Task 2 中同步新建单测(当前为 web-stream-factories.test.ts),三个用例分别验证:
import { describe, expect, it } from "vitest";
import { getWebStreamFactory, listWebStreamApiIds } from "./web-stream-factories.js";
describe("web-stream-factories", () => {
it("lists stable web stream api ids", () => {
const ids = listWebStreamApiIds().slice().toSorted();
expect(ids).toEqual(
[
"chatgpt-web", "claude-web", "deepseek-web", "doubao-web",
"gemini-web", "glm-intl-web", "glm-web", "grok-web",
"kimi-web", "perplexity-web", "qwen-cn-web", "qwen-web",
"xiaomimo-web",
].toSorted(),
);
});
it("returns a factory function for each listed api", () => {
for (const id of listWebStreamApiIds()) {
const f = getWebStreamFactory(id);
expect(f, id).toBeTypeOf("function");
// Do not invoke f(cookie): some factories validate cookie/session at construction time.
}
});
it("returns undefined for non-web api", () => {
expect(getWebStreamFactory("openai")).toBeUndefined();
});
});
测试的三个断言分别守护了三条不变量:注册表键集稳定(防止误删或拼写漂移)、每个 api 都能解析出可调用的工厂(但不实际调用,因为部分工厂在构造期就会校验 cookie/会话)、非 Web api(如 openai)必须返回 undefined 以走回退。运行命令:
pnpm exec vitest run src/zero-token/streams/web-stream-factories.test.ts
预期全部 PASS(验证记录确认)。
三、Task 3 / 4:attempt.ts 与 compact.ts 的分支收敛
3.1 attempt.ts:11 段 else if 压缩为单层 else
计划 Task 3 的目标是删除 createChatGPTWebStreamFn … createXiaomiMimoWebStreamFn 共 11 个单独 import,改为:
import { getWebStreamFactory } from "../../web-stream-factories.js";
然后将从 } else if (params.model.api === "deepseek-web") { 起到 } else if (params.model.api === "xiaomimo-web") { ... } 止的整段分支,替换为嵌套在单个 else 内的结构(openai-responses 与最终 else 仍必须在该外层 else 内,并多一层闭合 }):
} else {
const webFactory = getWebStreamFactory(params.model.api);
if (webFactory) {
const cookie = (await params.authStorage.getApiKey(params.model.api)) || "";
if (cookie) {
activeSession.agent.streamFn = webFactory(cookie);
ensureCustomApiRegistered(params.model.api, activeSession.agent.streamFn);
} else {
log.warn(`[web-stream] no API key for ${params.model.api}`);
activeSession.agent.streamFn = streamSimple;
}
} else if (params.model.api === "openai-responses" && params.provider === "openai") {
const wsApiKey = await params.authStorage.getApiKey(params.provider);
if (wsApiKey) {
activeSession.agent.streamFn = createOpenAIWebSocketStreamFn(wsApiKey, params.sessionId, {
signal: runAbortController.signal,
});
} else {
log.warn(`[ws-stream] no API key for provider=${params.provider}; using HTTP transport`);
activeSession.agent.streamFn = streamSimple;
}
} else {
activeSession.agent.streamFn = streamSimple;
}
}
注意两个细节约束:
- Ollama 的
if (params.model.api === "ollama")块保留在整段之前,行为不变; - 计划自检强调:
getWebStreamFactory中的 11 个api字符串必须与attempt.ts原分支完全一致,否则会出现「查不到工厂 → 静默退化为streamSimple」的隐性回归。
该分支的兜底逻辑很有价值:无 cookie 时降级为 streamSimple 并打 [web-stream] 前缀告警,而不是抛异常,保证端到端链路不中断。
3.2 compact.ts:同一注册表保持行为一致
计划 Task 4 对 compact.ts 做等价替换,删除 11 个 create*WebStreamFn import,新增:
import { getWebStreamFactory } from "../web-stream-factories.js";
将 if (resolvedApiKey) 内的整段分叉:
if (model.api === "deepseek-web") {
streamFn = createDeepseekWebStreamFn(resolvedApiKey);
} else if (model.api === "claude-web") {
...
} else if (model.api === "xiaomimo-web") {
streamFn = createXiaomiMimoWebStreamFn(resolvedApiKey);
}
替换为查表:
const webFactory = getWebStreamFactory(model.api);
if (webFactory) {
streamFn = webFactory(resolvedApiKey);
}
3.3 当前源码的进一步收拢:provider-stream.ts
从当前仓库源码看,Web 流式的装配已经比计划更进一步:attempt.ts 与 compact.ts 不再直接 import 注册表,而是统一走 src/agents/provider-stream.ts 的 registerProviderStreamForModel。以 compact.ts 为例(L723-L731):
const providerStreamFn = registerProviderStreamForModel({
model,
cfg: params.config,
agentDir,
workspaceDir: effectiveWorkspace,
});
if (providerStreamFn) {
session.agent.streamFn = providerStreamFn;
}
而 provider-stream.ts 内部对 Web 模型的回退正是查注册表(L38-L72):先走 resolveProviderStreamFn(插件路径),未命中且 getWebStreamFactory 能解析时,从 auth-profiles 加载凭证(支持 token / api_key / oauth 三种 profile 类型),再 webFactory(credential) 生成流并注册。这可以看作计划中「单一注册点」目标的自然延伸:Web 分支只出现 getWebStreamFactory 一个入口,站点协议完全隔离在 src/zero-token/streams/ 下。
四、Task 1:上游同步说明文档(改动面清单)
4.1 为什么需要同步清单
Zero Token 相对上游存在大量有意差异,git merge / git rebase 时必须人工过一遍。Task 1 新建了 docs/zero-token/upstream-sync.md,按域列出「合并时优先检查」的路径。
4.2 改动面清单(当前版本)
Zero Token 实现树(主体):
src/zero-token/providers/— 各站 Web 客户端、login*Web、浏览器自动化;src/zero-token/streams/—*-web-stream.ts、web-stream-factories.ts(model.api→StreamFn);src/zero-token/bridge/web-providers.ts— Web 的 baseUrl、默认模型、build*WebProvider/discover*WebModels;src/zero-token/extensions/askonce/— 捆绑 AskOnce 插件;start-chrome-debug.sh、onboard.sh、server.sh(若存在);docs/zero-token/下全部文档。
Agent 与 Web 流式(薄集成):
src/agents/web-stream-factories.ts— 对zero-token/streams/web-stream-factories的 re-export;src/agents/pi-embedded-runner/run/attempt.ts— Web 分支应仅调用注册表,勿再内联站点协议;src/agents/pi-embedded-runner/compact.ts— 同上;src/agents/models-config.providers.ts—resolveImplicitProviders合并各*-webprovider。
CLI / 引导 / 认证入口:
src/commands/onboard-web-auth.ts、src/commands/auth-choice.apply.*-web.ts— 登录向导;src/commands/onboard-auth.config-core.ts— Web 默认模型 / allowlist 等常量。
配置与插件发现 / 打包:
src/config/types.models.ts—ModelApi含各*-web;src/plugins/bundled-dir.ts、src/plugins/discovery.ts— 同时扫描extensions/与src/zero-token/extensions/;pnpm-workspace.yaml、package.json(files含src/zero-token/extensions/)、Dockerfile(运行时 COPY);scripts/sync-plugin-versions.ts、scripts/release-check.ts— 遍历extensions/与src/zero-token/extensions/。
4.3 根目录 README 的保护策略(关键细节)
上游同步最大的坑是根 README 被上游同名文件覆盖。当前仓库的解法是在 .gitattributes 中为 README.md、README.zh-CN.md 设置 merge=ours:
- 对
git merge upstream/main,若双方都改过这两个文件,Git 自动保留本 fork 版本,无需手工checkout --ours; - 若有意合并上游对 README 的某段通用修正,需在上游发布后手动拷贝对应段落进本 fork README,不要依赖 merge 自动带入;
git rebase upstream/main时 README 冲突仍需保留本 fork 文案(merge=ours主要保障常规 merge 场景);- 切勿对根 README 使用会丢弃本方版本的合并策略(如误用全盘
-X theirs)。
4.4 推荐同步步骤
# 1. 将 openclaw/openclaw 配为 upstream 并拉取
git fetch upstream
# 2. merge(或 rebase,按团队习惯)
git merge upstream/main
# 3. 按改动面清单解决冲突:
# 优先保留上游对通用子系统的修复,再重新应用 Zero Token 的 Web 相关 hunk
# 4. 安装依赖并构建
pnpm install && pnpm build
# 5. 轻量测试(或全量,视机器资源)
OPENCLAW_TEST_PROFILE=low pnpm test
非目标:不要求与上游文件级一致;只要求行为回归(Web 模型对话、onboard 授权)可验证。
五、Task 5:浏览器授权与 CDP 模式(模式 A/B/C)
5.1 背景约束
Zero Token 通过 Playwright CDP 连接 Chrome 来抓取各站登录态。文档 web-models-browser-modes.md 固化了两条硬约束:
- 同一 Chrome
user-data-dir不能同时跑两个浏览器实例; - 未以调试方式启动的 Chrome 无法被 CDP 附加——「无端口、无扩展桥」就无法读取另一进程的登录态。
5.2 模式 A:独立调试 Profile(当前默认)
- 做法:运行
start-chrome-debug.sh,使用专用user-data-dir(Linux 下~/.config/chrome-openclaw-debug),开启--remote-debugging-port=9222; - 配置:
browser.attachOnly: true,browser.cdpUrl(或 profile 中的cdpUrl)指向http://127.0.0.1:9222; - 优点:不与日常 Chrome 抢同一用户目录,行为稳定、文档与脚本一致;
- 缺点:需在该浏览器实例中完成各站登录,与「日常已登录的 Chrome」不是同一套会话。
start-chrome-debug.sh(仓库根目录)实际会:自动探测 macOS / Linux(含 Deepin)/ Windows (Git Bash / WSL) 的 Chrome 路径;若检测到已有 remote-debugging-port=9222 进程则先关闭(pkill -f "chrome.*remote-debugging-port=9222")再启动,保证单实例;启动后轮询 http://127.0.0.1:9222/json/version 确认可用,并自动打开 Claude、ChatGPT、Doubao、Qwen、Kimi、Gemini、Grok、GLM、DeepSeek 等登录页。
5.3 模式 B:用户自备「单实例」调试 Chrome
- 做法:用户自行用固定
user-data-dir+--remote-debugging-port启动唯一 Chrome 进程(例如桌面快捷方式),OpenClaw 仅 attach 到该端口; - 约束:同一
user-data-dir不能同时跑两个 Chrome;若已打开普通 Chrome 占用该目录,再启动调试实例会失败或异常,需关闭其一或改用与日常不同的专用目录; - 何时算「复用登录态」:仅当用户始终用这一调试实例上网、完成登录,或该目录本就是用户接受的「专用 Zero Token 环境」时,才等价于长期复用会话。
5.4 模式 C:扩展 / 守护进程桥(参考)
- 参考方向为 bb-browser(扩展 + 本机服务)与 insidebar-ai(侧栏复用站点会话的产品思路);
- 现状:本仓库主路径仍为 CDP + Playwright;是否引入 bb-browser 类集成以 PoC 结论为准;
- 说明:该模式不依赖「无调试端口的普通 Chrome 被 CDP 附加」——需单独实现或集成桥接层。
5.5 配置关系小结
| 模式 | 典型 user-data-dir |
CDP 端口 | 与日常 Chrome 并行 |
|---|---|---|---|
| A | 脚本指定的独立目录 | 9222 | 可以(不同目录) |
| B | 用户自选(须单实例) | 用户指定 | 同目录则不可以 |
| C | 依具体方案 | 依方案 | 依方案 |
注意:授权命令仍通过 onboard-web-auth / auth-choice 等将凭证写入本地 profile;CDP 只解决「浏览器由谁启动、连哪台 Chrome」。
~/.openclaw/openclaw.json 中对应的浏览器配置示例(来自 web-models-support.md):
{
"browser": {
"enabled": true,
"attachOnly": true,
"defaultProfile": "chrome",
"profiles": {
"chrome": {
"cdpPort": 9222,
"attachOnly": true
}
}
}
}
六、Task 6(后续 / 可选):bb-browser PoC 记录
计划 Task 6 在本地验证 bb-browser site <adapter> --openclaw 是否满足某一站点需求,并将结论写入需求文档变更记录,不修改 package.json 依赖(除非 PoC 通过后另开 PR)。
已完成验证(npx bb-browser --help),结论要点:
| 维度 | 结论 |
|---|---|
| CLI 可用性 | npx bb-browser --help 可正常展示命令(site、open、eval、fetch 等),适合作为独立工具或 MCP 由 Agent 调用 |
| 与 Zero Token Web 模型的关系 | bb-browser 以站点 adapter(搜索/热榜/结构化拉数)为主;不能替代 web-stream-factories 中 13 个 Web 聊天 Provider 的流式对话与工具协议实现 |
--openclaw |
文档说明可走 OpenClaw 内置浏览器;与 fork 的 CDP 授权 + *-web-stream 是并行能力,非替换关系 |
| 推荐用法 | 需要站外数据时,通过工具/MCP 暴露 bb-browser;主对话模型仍走既有 Web Provider |
| 依赖 | 本仓库不默认添加 bb-browser 依赖;由用户在环境中 npm i -g bb-browser 或 npx 按需使用 |
七、Spec 对照自检与计划自检
计划以 docs/zero-token/zero-token-requirements.md 为依据文档,收尾时做了两张自检表:
| 需求章节 | 对应任务 |
|---|---|
| §1 目标能力 / 端到端 | Task 2–4 保持行为等价 |
| §2 减少 core 入侵 | Task 2–4 收敛热点;Task 1 文档化其余改动面 |
| §3 浏览器授权 | Task 5(及可选 Task 6) |
| §4 Web 模型目录 | 实现已收拢至 src/zero-token/;models-config 大段仍可在后续继续变薄 |
计划自检两条硬性结论:无 TBD /「类似 Task N」占位;getWebStreamFactory 与 attempt.ts 原 11 个 api 字符串一致。
八、验证记录(2026-03-28)
计划文末附带的验证记录是行为等价最直接的证据:
| 命令 | 结果 |
|---|---|
pnpm exec vitest run src/zero-token/streams/web-stream-factories.test.ts |
PASS |
pnpm exec vitest run src/plugins/hooks.model-override-wiring.test.ts |
PASS |
pnpm exec vitest run src/agents/pi-embedded-runner/run/attempt.test.ts src/agents/pi-embedded-runner/compact.hooks.test.ts |
PASS(已移除对已删除导出之测试;已修复 compact.hooks 的 message-channel mock;compactEmbeddedPiSession 在 ownsCompaction 引擎路径补全 before/after_compaction 哨兵钩子) |
pnpm build |
PASS(依赖完整安装后) |
npx -y bb-browser --help |
CLI 可用(Task 6 文档结论依据) |
从 docs/zero-token/zero-token-requirements.md 的变更记录还可看到收尾阶段的后续演进:目录收拢至 src/zero-token/providers/ 与 src/zero-token/streams/、src/agents/web-stream-factories.ts 退化为 re-export、移除冗余的 extensions/web-models 与 src/plugin-sdk/web-models.ts、models-config 抽桥到 src/zero-token/bridge/web-providers.ts、AskOnce 插件目录迁至 src/zero-token/extensions/askonce/ 等。
九、扩展实践:如何新增一个 Web Provider
若要在当前仓库新增 Web 渠道,可参照 web-models-support.md 的「开发指南」按四步走:
- 在
src/zero-token/providers/增加客户端与*-web-auth.ts; - 在
src/zero-token/streams/增加*-web-stream.ts,并在web-stream-factories.ts注册model.api(新增后同步更新listWebStreamApiIds单测期望值); - 在
src/agents/models-config.providers.ts增加buildXxxWebProvider与resolveImplicitProviders条目(及MODEL_APIS若需新api); - 在
src/commands/onboard-web-auth.ts(及按需auth-choice.apply.*)注册登录函数。
聊天中切换 Web 模型建议写全 provider + 模型 ID,例如:
/model claude-web/claude-sonnet-4-6
这保证与 src/zero-token/bridge/web-providers.ts 中的默认模型 ID 精确匹配;仅写 /model claude-web 在部分环境下可能解析不准。
总结
web-stream-factories 注册表重构是 Zero Token fork 的「减冲突」关键工程:它将散落在 attempt.ts / compact.ts 中的 11 段 Web 分支收敛为一张表 + 一个查询函数,配合桥接 re-export、上游同步改动面清单、README merge=ours 保护与浏览器模式 A/B/C 文档,让后续每次 merge / rebase 的冲突面大幅收缩。所有实现集中在 src/zero-token/,核心代码仅保留薄桥接,既保持 Web 模型端到端行为不变,也为将来把 Web Provider 插件化迁移铺平了道路。