1. 导入完成却没换模型先看清 Key 到底被谁持有用 dsh-chat-import 把 Claude Code、Codex、ChatGPT 的历史记录导进 DeepSeek Harness十个迁移里至少六七个会卡在同一个地方导入命令跑完了会话列表里也确实多出几十条历史但一继续对话请求还是打在原来那条通道上。于是有人回头去翻刚落盘的会话文件想找一个叫apiKey或者token的字段翻不到就怀疑导入把东西弄丢了。这个排查方向从第一步就是反的。正确的起点是先拿 Key再想清楚它该被放在哪一层TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentdsh-chat-import-key-holder 。那里既能看到可用模型也能创建属于你自己的 Key本文后面所有配置里的YOUR_API_KEY都从那里来。要理解为什么导入和换 Key是两件事得先借用 DSH 运行时的分层模型。DSH 跑在 Cordis 之上一切能力都是插件模型能力本身就是一个挂在上下文上的服务槽位。服务提供方插件负责持有凭据、维护连接、把请求发出去而会话、消息、工具调用记录属于数据层是持久化后端里的内容。dsh-chat-import 这个插件的职责边界非常清晰它是一个数据搬运工把外部工具的对话轨迹翻译成 DSH 认识的会话结构写进会话存储。它不注册 llm 服务也不该知道你的 Key 长什么样。所以无论导入多少条历史会话文件里都不会、也不应该出现任何凭据。这个分工带来一个对迁移工程师非常友好的结论换供应商不需要动已导入的历史。你不需要删掉刚导进来的会话重来一遍也不需要给每条会话单独打补丁。会话里保存的是当时用了哪个模型这类引用信息真正决定请求打到哪里的是运行时那个 llm 提供方的配置。把提供方的 Base URL 和 Key 换掉所有消费方——新会话、旧会话、子 Agent、后台任务——一起跟着换。这就是为什么本文的路径是导入先做完Key 后换两者互不干扰。2. 准备工作拿 Key、记住 Base URL、定好环境变量迁移工程最忌讳凭据散落各处。开工之前先把三样东西定下来。第一是 Key 本身。到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentdsh-chat-import-prepare 的控制台创建命名建议带上用途和日期比如dsh-local-2026方便日后按环境回收。不要用同一个 Key 打穿所有环境导入验证阶段和正式跑任务阶段分开建出问题能快速定位是哪一层。第二是 Base URL。这一个是固定的直接用https://taotoken.net/api注意它不加任何 UTM 参数。UTM 是给网页链接做来源标记用的一旦混进了 API Base URL请求路径就变了客户端会直接报 404。这个坑每年都有人踩值得单独记住。第三是环境变量约定。建议统一用TAOTOKEN_API_KEY这个名字然后通过环境变量注入到配置文件里而不是把 Key 明文写进 YAML 或 JSON。DSH 的配置加载支持在 config 字段里写运行时求值表达式这意味着你可以让配置文件保持看起来没有秘密的状态仓库可以安全提交CI 可以安全打印。# Linux / macOS写进 shell profile 或 .env 后再启动 DSH export TAOTOKEN_API_KEYYOUR_API_KEY # Windows PowerShell $env:TAOTOKEN_API_KEY YOUR_API_KEY # 验证变量确实生效注意不要 echo 出值本身 test -n $TAOTOKEN_API_KEY echo env ok || echo env missing最后一条命令值得养成为习惯。迁移过程里配置写对了但环境变量没加载是出现频率最高的伪故障先花两秒排除掉能省下后面半小时的怀疑人生。3. dsh-chat-import 导入命令与会话文件落点先把插件装进来。DSH 的插件安装走统一的命令入口不同小版本的子命令可能有细微差异动手前用--help对一遍即可# 安装导入插件 dsh plugin add dsh-chat-import # 确认插件已经挂上并查看它能识别的来源 dsh plugin list | grep chat-import dsh chat import --help真正的导入动作取决于你要迁的是哪一家的记录。dsh-chat-import 支持把 Claude Code、Codex、ChatGPT 的聊天记录转成 DSH 会话调用形态大致是这样# 从 Claude Code 的本地记录目录导入输出到默认 profile dsh chat import \ --source claude-code \ --path $HOME/.claude/projects \ --profile default # 从 Codex 的会话记录导入 dsh chat import \ --source codex \ --path $HOME/.codex/sessions \ --profile default参数名以你本地dsh chat import --help的输出为准这里给出的是结构重点是三件事告诉它来源类型、告诉它历史文件在哪、告诉它导进哪个 profile。第二条路径$HOME/.codex/sessions在不同版本里可能是~/.codex/history一类的名字导入前先ls一下确认目录存在别对着一个空目录跑半天然后以为插件坏了。导入完成之后去看落点。DSH 的 profile 目录在$DSH_HOME/profiles/名字下会话数据则交给持久化后端处理。如果你用的是 JSONL 后端会话文件是每行一条记录的追加式结构形态大概是{type:session,id:sess_7f3a,title:重构支付回调,createdAt:2026-08-11T09:12:03Z,model:legacy-model-id} {type:message,role:user,content:把重试逻辑抽成一个函数,ts:2026-08-11T09:12:10Z} {type:message,role:assistant,content:可以先看下当前实现……,ts:2026-08-11T09:12:14Z} {type:tool_call,name:read,args:{path:src/pay/callback.ts},ts:2026-08-11T09:12:15Z}这份文件里出现了model这个字段但它只是一个标识符不是凭据也不含任何 URL。这一点必须记牢会话文件里没有 Key所以换 Key 时不要动它。反过来如果你在某份教程里看到让你批量sed替换会话文件里的 token那基本可以判断那篇教程把数据层和凭据层搞混了照做只会把历史记录改坏。导入阶段唯一值得动手清理的是标题和归类。历史记录导进来常常标题雷同几十条都叫新会话检索成本很高。可以在导入后按时间窗口和来源工具快速过一遍把明显的批量记录归到单独的 profile 里避免污染你日常用的那个。这一步跟 Key 无关但会明显影响你后面验证时的体验。4. 用 patch 层把导入后的会话指向 TaoToken现在进入核心动作。DSH 的配置是可叠加的声明式结构核心组合包把几十个插件一次性插进空根你自己的 profile 里有一层cordis.patch.yml作为用户覆盖层启动时还能再叠一层--patch。后写的覆盖先写的按id做键控对账。这意味着换 llm 提供方不需要改任何源码也不需要去动核心组合包你只需要在自己这一层按 id 覆盖一行。按 id 覆盖这个词是有分量的。Cordis 的配置条目如果带id一次修改会被识别成增量更新这一条如果不带id每次读取都会分配新 id任何编辑都会被当成先删后加整条链路上的依赖方都要重新走一遍装卸流程。所以在你动手之前先确认要覆盖的那条 llm 提供方条目是有id的。动手前先用自省工具把现状摸清楚。DSH 带了一个自指的 Cordis 工具集其中cordis_inspect可以对当前进程做只读巡检把哪些服务在运行、每个 fiber 处于什么状态、每个ctx.key的完整契约都打出来。在会话里让 Agent 调一次重点看 llm 槽位是谁在提供、条目 id 叫什么、config 里有哪些字段。这一步相当于迁移前的资产盘点跳过它直接改配置很容易出现字段名写错了但没报错的尴尬。拿到契约之后在 profile 的cordis.patch.yml里加覆盖条目。下面给出结构示意字段名请与你本地cordis_inspect的输出对齐# $DSH_HOME/profiles/default/cordis.patch.yml # 覆盖核心组合包里已有的 llm 提供方条目id 必须与被覆盖条目一致 - id: llm-provider-main config: baseURL: https://taotoken.net/api apiKey: !!js process.env.TAOTOKEN_API_KEY # 下面这段按你实际可用的模型改模型 ID 以控制台列表为准 models: - id: your-preferred-model label: TaoToken primary三点说明。apiKey用的是运行时求值表达式不是明文。这样配置文件本身可以进版本库Key 只存在于运行环境里轮换 Key 时只需要更新环境变量再触发一次重载。baseURL就是第 2 节定下的那个值不带任何查询参数。这条覆盖只换了提供方没有换消费方。导入进来的会话、正在跑的子 Agent、后台任务它们的代码里都只声明了对 llm 服务的依赖不 import 任何具体实现。提供方一换依赖方自动跟着变。这正是 DSH 把能力做成服务槽位、把依赖做成声明式注入的价值所在迁移成本从改遍所有调用点压缩到改一行配置。如果你希望先小范围试水再全量切可以在 profile 里另起一个隔离域让新导入的那批会话解析到 TaoToken 提供方日常会话暂时还走原来的通道。配置里给条目加isolate字段就能做到这一点等验证稳定了再去掉隔离、全量生效。灰度切换在生产迁移里是标准动作DSH 的配置模型原生支持不需要你自己造一套开关。改完保存不需要重启进程。旧配置对应的 fiber 会被卸载它注册的服务、建立的连接、挂上的监听器按 LIFO 顺序回滚新 fiber 挂载后所有声明了该依赖的插件自动重新激活。整个过程你应该能在日志里看到卸载与加载的成对记录看不到就说明覆盖没生效回去检查 id 是否匹配。完整的服务槽位和依赖解析说明可以在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentdsh-chat-import-patch 找到配套文档。5. 工具侧三件套Claude Code、Codex、CC Switch 的可复制配置DSH 本身的 Key 换完之后很多人的工作流里还挂着另外几个 CLI 工具它们各有一套自己的配置文件。这三份配置经常被互相抄错尤其容易把 Anthropic 那套环境变量硬套到 Codex 上然后对着 401 排查半天。分开写清楚。5.1 Claude Codesettings.jsonClaude Code 读~/.claude/settings.json走的是 Anthropic 风格的环境变量命名{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: your-preferred-model, ANTHROPIC_SMALL_FAST_MODEL: your-fast-model } }ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL分别对应主对话和轻量任务留空也行但显式写出来能避免它在默认模型上做出你不预期的选择。文件权限收一下chmod 600 ~/.claude/settings.json别让同机器上的其他账号读到。5.2 Codexconfig.tomlCodex 用的是 TOML配置结构完全不同。这里不要出现ANTHROPIC_前缀的任何变量它是另一套协议# ~/.codex/config.toml model your-preferred-model model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEYCodex 通过env_key指定的环境变量名去读 Key所以第 2 节那个TAOTOKEN_API_KEY在这里直接复用不需要重复粘贴明文。这也是为什么建议统一变量名一个 Key、一个变量、多个工具共享轮换时只改一个地方。wire_api之类的字段视你本地版本而定不确定就别写让它用默认值。5.3 CC Switch供应商档案CC Switch 用来在多个供应商配置之间快速切换它管的是同一批文件的多套档案。所谓三件套指的就是 Claude Code 的settings.json、Codex 的config.toml加上 CC Switch 里对应的一条供应商档案——三者指向同一个 Base URL 和同一个 Key 变量切换时保持一致。{ name: taotoken, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, note: DSH / Claude Code / Codex 共用切换前确认 env 已导出 }字段名以你本地 CC Switch 版本为准。使用上有一条纪律值得强调切换档案之前先确认环境变量已经在当前 shell 里导出。CC Switch 切的是配置文件管不了你的终端环境很多切换后不生效的情况其实是新开的终端没有继承TAOTOKEN_API_KEY。三份配置的配置参考页在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentdsh-chat-import-tools 需要核对字段时以那里的最新说明为准。6. 排障清单导入会话换 Key 后最常见的六种现象把导入和换 Key 串起来跑出问题的位置无非那么几处。按现象对照排查比漫无目的地看日志快得多。现象一导入成功但新会话仍走旧通道。覆盖条目的id没对上。Cordis 按 id 做增量对账id 不匹配就变成新增一条原来的提供方还在谁先注册谁生效。回cordis_inspect把 id 抄准。现象二插件显示已加载却毫无反应。大概率 fiber 卡在 PENDING也就是它声明要注入的服务还没就绪。常见原因是提供方条目配置校验没过——比如baseURL写成了带 UTM 的长链接。检查启动日志里的 schema 校验错误配置非法时 Cordis 会直接拒绝加载并给出精确字段不会让它半启动。现象三401 或鉴权失败。顺序排查三件事环境变量有没有导出、env_key或变量名有没有写错、Key 有没有被截断复制时带上首尾空格是高频事故。用一条命令确认变量非空即可不要把它打印到日志里。现象四请求打到错误的路径。九成是 Base URL 后面多了东西。https://taotoken.net/api就是完整值不要自己拼/v1也不要把网页链接直接粘过来。现象五导入的会话能打开但一提问就报模型不存在。会话里记录的旧模型标识在 TaoToken 这边没有对应项。这是数据层的残留不是凭据问题。改提供方的模型映射或者在会话里显式切一次模型不要回去改会话文件。现象六工具调用记录在但助手没有任何回复。请求出去了但没等到结果。先确认网络可达再确认模型 ID 写对。可达性可以用一条不暴露密钥的命令粗筛# 只关心能不能拿到 HTTP 响应不关心状态码具体是多少 curl -sS -o /dev/null -w %{http_code}\n https://taotoken.net/api返回任何一个 HTTP 状态码都说明域名和链路是通的问题在鉴权或路径如果卡住或者报 DNS 失败那是网络层的事跟配置无关。排查思路和资料入口汇总在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentdsh-chat-import-troubleshoot 。7. 验证与回滚为什么改配置不用重启迁移做完要有验收动作别凭感觉说好像好了。验证分三层。第一层是进程内自省再跑一次cordis_inspect确认 llm 槽位的提供方已经换成 TaoToken 那条fiber 状态从 PENDING 变成 ACTIVE之前卡住的依赖方也都重新激活了。第二层是行为验证新建一个会话问一句看它是否正常返回再打开一条导入进来的历史会话继续追问确认老会话也能走通。第三层是工具验证在 Claude Code 和 Codex 里各发一次最小请求确认三件套指向一致。回滚同样简单这是这套配置模型最舒服的地方。把你加的那条覆盖删掉或者把它的disabled置为真保存即可。旧提供方会重新挂载所有依赖方再次自动重连同样不需要重启进程。更稳妥的做法是保留原提供方条目不动只调整优先级——出问题时把覆盖层摘掉就回到原状历史会话一条都不会丢因为第 3 节已经确认过会话文件里本来就没有凭据。这套改配置即热替换、失败即回滚的行为不是临时实现的特例而是框架层面把副作用做成可逆操作的结果。插件注册的任何东西——连接、监听器、服务条目——都带着自己的逆操作卸载时按相反顺序自动回滚。对迁移工程师来说这意味着试错成本被压到极低改错了就改回来不用重装、不用清数据、不用祈祷。8. 下一步把导入和换 Key 这条链路跑通之后接下来值得做的几件事把 profile 按用途拆开日常会话、批量导入的历史、实验性任务各占一层互不干扰把TAOTOKEN_API_KEY的轮换写进日常流程配置里只留变量名再给常用工具统一一份配置模板新机器上手时复制粘贴即可。入口按这个顺序走一遍就够了模型对话先确认你要用的模型在列表里https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchat需要长期跑任务的话看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-plan创建属于你的 Key替换掉本文所有YOUR_API_KEYhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keys配置 Claude Code 时对照官方文档核对字段https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-doc回到最初那个判断导入是数据层的活换 Key 是配置层的活两层分开处理迁移就不会乱。dsh-chat-import 负责把历史搬进来TaoToken 负责把请求接出去中间那根线——Base URL 加一个环境变量——你自己握住就行。