我在 Cursor、Claude Code 里的历史，能搬到 TabTin 吗？
Cursor、Claude Code、Codex、WorkBuddy 的历史对话怎么搬过来，哪些搬不了。
能。TabTin 可以把你这台电脑上 Claude Code、Cursor、Codex、WorkBuddy 四个工具的历史对话读出来、复制一份进 TabTin，让你在这边接着往下聊——换任意模型、多端同步、顺手接上表格和自动化。
先把最容易误会的一句话说在前面：搬的是「对话」，不是「配置」。你的规则文件、Skill、MCP 配置、模型密钥，都不在导入范围里。下面一条条讲清楚。
先说清楚：能搬什么，不能搬什么
能搬（每条对话完整搬过来）：
- 你说的话、AI 回的话
- AI 的思考过程（thinking / 推理摘要）
- 调了哪些工具、传了什么参数、返回了什么（截断保留，见下文）
- 会话标题、创建/更新时间、所属的项目目录
- 子 Agent 分支（Claude Code 的 subagent、WorkBuddy 的 Agent 派发、Cursor 的 task 会话等）
- 用了哪个模型、token 用量、git 分支（部分工具有）
不能搬（一个都没做）：
| 你可能以为能搬的 | 实情 |
|---|---|
规则文件（CLAUDE.md、.cursor/rules、AGENTS.md） | 不读、不导。TabTin 的规则要自己重新配 |
| Skill / 自定义命令 | 不读、不导 |
| MCP 服务器配置 | 不读、不导 |
| 模型 API Key、订阅登录态 | 明确列为禁读，见下面「哪些文件绝对不碰」 |
| Checkpoint / 文件快照 / 代码改动记录 | 不导（原工具里的历史一点没动，还在那儿） |
| 未来的增量同步 | 没有。导入是一次性动作，不是持续同步 |
一句话：导入 = 把聊天记录搬过来做上下文，不是把整套工作环境克隆过来。
支持哪四个工具，各自能搬多全
| 工具 | 能导进来的 | 已知搬不全的地方 |
|---|---|---|
| Claude Code（含 Claude 桌面端的 Code 标签，是同一份数据） | 完整对话、思考、工具调用与结果、子 Agent、git 分支、token 用量 | 从别的会话 fork 出来的分支只导「新增的那段」，重复的父会话内容不重复搬；只在索引里有、正文已被清理的会话不导 |
| Codex | 完整对话、推理摘要、工具调用与输出、apply_patch 结果、联网搜索、模型名、token 用量 | 加密存储的推理内容解不开，只有「有摘要」的思考能搬；子代理是独立会话，列表里单独标「子会话」 |
| Cursor | 完整对话、思考、工具调用与结果、贴过的图片（转成占位文字） | 只有留下转写文件的会话才会出现在列表里——Cursor 里看得到的对话，未必全都能导；少数 AI 回复 Cursor 自己存的就是 [REDACTED]，能从别处补就补，补不上会写「（此段回复正文未被 Cursor 转写保存）」；子 Agent 折叠在主会话里，不会平铺一大堆 |
| WorkBuddy | 完整对话、思考、工具调用与结果、子 Agent、图片（转成占位文字） | 已删除的会话不导；WorkBuddy 没有「归档」这个概念，所以列表里不会出现归档标记 |
它只读这台电脑上这几个工具的本地对话记录，云端的历史读不到——所以你在别的电脑上聊的，得在那台机器上再导一次。
登录凭据一概不碰。 各工具存 token、cookie、密钥的那些文件在导入器里是写死的禁读清单，任何情况下都读不到。向导里那句「登录凭据类文件（token、cookie、密钥文件）一律不读取」就是指这个。
全程只读。 导入器对这四个工具的目录零写入——不改、不删、不移动。你在 Cursor 里的历史，导完之后一模一样还在。
从哪儿点进去
只有一个图形入口：
- 打开 TabTin 桌面客户端，确认顶栏切到了你想导进去的组织（档案按组织分开存，导完不能换）
- 看左侧任务栏，从上到下是 新任务 / 技能库 / 自动化 / 导入数据
- 点 导入数据
如果 TabTin 检测到你装了这几个工具、并且真有历史，导入数据右边会有个小蓝点。这个点很克制：每次登录最多亮两次，你点过一次入口它当次就灭，只要你成功导过一次，它永远不再亮。所以没看到蓝点不代表检测失败，直接点进去看就行。
没有弹窗、没有引导横幅、设置里也没有第二个入口——就这一个。
三步走
页面顶上是步骤条：选择来源 → 选择对话 → 导入。
第一步：选择来源
进来先看到一张说明图：左边是「本机其他平台」，中间箭头写着「只读复制」，右边是 TabTin，底下一句 「仅读取并复制，不会改动原平台数据」。
下面是四张平台卡片，每张显示这个工具在你机器上的家底：「N 个工作目录 · M 条对话 · 最近活跃 X」。这一步只数索引、不读正文，所以很快。
- 装了但没有可导内容的，会灰掉并写「已检测到安装痕迹，但暂无可导入的历史对话」
- 四个都没有会显示「没有检测到可导入的历史会话。」
勾上你要搬的平台（可以多选），点 下一步。
第二步：选择对话
这一步是重点，粒度细到单条对话。
时间范围在左上角：7 天 / 30 天 / 90 天 / 全部，默认 30 天。觉得少了就往大调。
中间是三级树：平台 → 工作目录 → 单条对话。每一行都能勾，父级是三态勾选框（全选 / 半选 / 未选）。
每个工作目录后面会标它将来落在哪：
- 将新建工作空间 —— TabTin 里还没有这个目录
- 合流到「某某」 —— TabTin 里已经有对应的工作空间（标了「（子目录）」的意思是外部目录是它的下级目录）
对话行上可能带 子会话、已归档 的后缀。归档的对话默认会一起扫出来，没有单独的开关，不想要就手动取消勾选。
右上角能搜「工作目录 / 对话标题」。右侧工具条上有三个快捷键位：全选 / 全不选 / 只导一个试试（自动帮你选中这个平台最近活跃的一个工作目录，跳过归档的）。
底部有个「安全」小卡，里面一个勾选框 「对疑似密钥 / 凭据默认打码」，默认是勾上的，建议别关。打码覆盖 7 类常见格式：sk- 开头的 key、sk-ant-、Bearer xxx、JWT、GitHub token（ghp_ 等）、AWS AKIA...、以及 api_key= / password: 这类赋值写法。打码保留前 4 位和后 2 位，方便你回看时还能认出是哪个 key。
底部还会实时告诉你 「所选对话将归入 N 个工作空间（X 个新建，Y 个合流）」，以及一句很重要的话：「本次导入不授予 Agent 目录执行权限，开始干活时再单独确认信任。」——导入不等于把目录交出去。
选好点 开始导入（N 条对话）。
第三步：导入
进度条会显示「正在处理：某某目录」和 已完成 / 总数。这一步在后台跑，你可以离开这个页面继续用 TabTin，右下角会留一个进度小面板。中途可以 取消导入。
完成后是结果页：
如果有失败或被跳过的，下面会有 「查看 N 条失败明细」 折叠，逐条写清楚是哪个平台、哪条会话、什么原因。
结果页右下角有 移除本次导入——一键把这批档案清掉（连带本次新建的工作空间一起删），二次确认文案是「将永久删除本次导入的对话及其消息，不可恢复。」
导进来之后，东西落在哪
这是最容易困惑的一段，讲细一点。
两个落点：
- 工作空间（会同步到你的 TabTin 账号） —— 每个外部项目目录对应一个 TabTin 工作空间，名字直接取目录名。找不到原目录的零散对话，统一归到「默认工作空间」。
- 对话本体（只在这台电脑上） —— 存成本机档案，放在 TabTin 自己的数据目录里，按组织分开存，不上传。
所以：对话内容不上云。 只有「工作空间」这个壳（目录路径 + 名字）进了你的账号；聊天记录本身留在本机。换台电脑不会自动出现，同事也看不到——哪怕你导进的是团队组织。
在界面上长什么样：
导进来的对话不进普通会话列表，而是挂在对应工作空间下面，用琥珀色的档案图标单列一类。点开它不是「打开旧会话」，而是以一条特殊新对话展开：把这段历史整段注入进去当上下文，顶上有一条横幅写着来源和原会话标题，下面一行提示 「上面是外来历史，当作上下文即可——从这里开始，都可以交给小 Tin 继续做」。
从这条对话往下发的消息，才是真正走 TabTin 正常链路的新消息。注入进去的那段历史仍然只在本机。
同一份档案再点一次，会回到同一条对话，不会每次都新开。
想删掉某一条：在侧栏那一行上悬停，点垃圾桶，确认框会写「仅清除本机导入内容，不会影响原工具里的历史。」
哪些内容会「缩水」
导入不是像素级复刻，有几处刻意做了降级，事先知道就不会奇怪：
- 图片 拷进本机档案后可在对话里直接预览；源图找不到时仍显示占位文字
[图片: 文件名] - 工具参数和工具返回 只保留 4000 字以内的预览；超了会标「已截断」
- 二进制的工具输出（PDF 流、原始字节那类）直接写成「（二进制工具输出，未导入）」
- 单条正文 超过 10 万字会截断
- 疑似密钥 打码（默认开）
- 空对话、只有标题没正文的对话 直接不导，避免侧栏堆一排「无标题 / 0 消息」
- 外来历史用户气泡 按 Markdown 只读渲染（表格、代码块、链接可读）；普通新发消息仍是纯文本
理由很直白：能可靠地把「对话」搬过来接着聊，比把每个工具调用的原始 dump 都塞进来更有用，后者还是各种脏数据的重灾区。
三个用法建议
刚从 Cursor / Claude Code 迁过来，第一件事做什么
别一上来全量导。
- 先确认顶栏组织选对了（个人账号还是团队组织）——档案按组织分开存，导完不能改
- 第二步里点 只导一个试试，先搬一个项目
- 导完在侧栏找到那个工作空间，点开档案，看看对话渲染得对不对、上下文接得顺不顺
- 觉得没问题，再回到 导入数据 把时间范围放到 90 天或全部，导其余的
团队一起迁移怎么组织
导入是每个人在自己电脑上各干各的——档案不上云，你导的同事看不到，所以没有「管理员统一导一次」这种做法。团队要统一的其实是两件事：
- 约定导到哪个组织。让大家在点「导入数据」前先把顶栏切到同一个团队组织，否则有人导进个人账号、有人导进团队，后面对不上。
- 提前打招呼：先导入，再手动建工作空间。 如果有人已经在 TabTin 里把某个项目目录加成了工作空间，那个目录下的对话在导入时会被跳过（原因见下一节）。让大家把「导入」放在「配工作空间」前面，能省掉一轮返工。
至于规则、Skill、MCP，这些导不过来，得在 TabTin 这边重新配一次——建议由一个人配好组织级的，别每人各配一套。
导入前后怎么核对没丢东西
- 导入前记数：第一步的平台卡片上写着「N 个工作目录 · M 条对话」，先记下来
- 勾选后记数：第二步的按钮上写着「开始导入（K 条对话）」，K 就是你这次的分母
- 导入后对账：结果页写「已写入本机档案 X 条」。X 比 K 少是正常的，差额都在「查看 N 条失败明细」里，逐条有原因
- 常见差额来源：空对话被跳过、只有标题没正文的被跳过、这条以前导过、目标工作空间已存在
- 最后逐个工作空间点开看一遍，确认对话都挂在你预期的项目下面
一个坑要提前知道：右下角悬浮面板里的「N 条失败」只统计真正的失败，被「跳过」的那些不算在里面。所以重复导入一批已经导过的对话，面板上可能显示成「成功 0 条、失败 0 条」，看着像什么都没发生——真正的原因要去结果页展开明细看。
常见问题
它会不会改动、甚至弄坏我在 Cursor / Claude Code 里的历史？
不会。导入器对这四个工具的目录是纯只读的，一个字节都不写。你导完之后回 Cursor，历史一条不少。删掉 TabTin 里的导入档案，也只删 TabTin 这边的副本。
我的规则文件、Skill、MCP 配置能一起搬过来吗？
不能，一个都没做。当前只导对话历史。CLAUDE.md、.cursor/rules、Skill 定义、MCP 服务器配置都不在读取范围里，需要你在 TabTin 这边重新配一次。
导入的对话会上传到云端吗？同事能看到吗？
对话内容不上传，只存在你这台电脑的 TabTin 用户数据目录里。同事看不到，哪怕你导进的是团队组织。只有「工作空间」这层壳（目录路径和名字）会同步到你的账号。
顺带一提：这也意味着换电脑看不到，需要在新电脑上重新导一次。
预览里明明写着「合流到某某工作空间」，导完却提示已存在被跳过？
这是当前版本一个已知的不一致。第二步的预览会把「TabTin 里已有同名目录的工作空间」标成「合流到 X」，但真正执行时，如果那个工作空间是同一台设备 + 同一个目录，这批对话会被跳过，明细里写的是 Workspace 已存在（地址+设备命中）：某某。请先删除该 Workspace 再导入。
解决办法二选一：把 TabTin 里那个工作空间删掉再导；或者接受这部分不导（原对话在原工具里照样在）。最省事的做法还是：先导入，再在 TabTin 里配工作空间。
同一批对话再导一次，会重复吗？会覆盖吗？
都不会。导入是一次性语义：同一条源会话已经有档案了，第二次直接拒绝，记成「跳过」，明细里写的是 会话已导入过（一次性）。删除对应 Workspace 或本机档案后可重来。
想重来，得先把对应的本机档案（侧栏那行的垃圾桶）或工作空间删掉。
导错了、导到错的组织了，怎么撤销？
- 刚导完还在结果页：点 移除本次导入，会把这批档案连同本次新建的工作空间一起删掉
- 已经关掉页面了：在侧栏找到具体那条档案，悬停点垃圾桶，一条条删
- 删整个工作空间：删工作空间时，挂在它下面的导入档案会一起清掉
删除只影响 TabTin 这边的副本，原工具里的历史不受任何影响。
检测不到我装的工具，或者数字是 0
按可能性从高到低排查：
- 对话真的不在这台机器上——导入只看本机文件，云端的历史读不到
- 改过默认目录——Claude Code 认
CLAUDE_CONFIG_DIR，Codex 认CODEX_HOME，其余三个路径是写死的，改过位置就找不到 - Cursor 正在运行、数据库被占用——卡片上会带一句「state.vscdb 存在但 composerHeaders 计数为 0（库被占用/超时或版本不兼容）」，把 Cursor 关掉再点一次「导入数据」
- 工具版本太老——比如 Codex 早期版本没有
state_5.sqlite，会提示「可能是极早期版本」；Cursor 老版本没有新索引表时会走兜底路径，能读到的会少一些 - 确实没有历史——WorkBuddy 装了但没聊过，会显示「已安装 WorkBuddy，但本机尚无可导入的历史对话」
Cursor 里明明有很多对话，列表里却少了一截
Cursor 的对话只有留下转写文件的才会出现在导入列表里。没有转写的会话导进来只会是个空壳（有标题、0 条消息），所以被直接过滤掉了。这不是 bug，是有意为之——避免侧栏堆一排点不开的空对话。
图片和工具输出为什么变成一行字了？
工具参数/返回仍是有意降级：只留 4000 字预览，二进制输出写成「（二进制工具输出，未导入）」。
图片：新导入会把截图拷进本机档案，对话里可以直接预览。若源文件已经找不到，才会显示 [图片: 文件名] 占位。更早导入、尚未重导的旧档案仍可能只有占位文字——删掉该条档案再导入一次即可。
表格在 Cursor 里好好的，导入后竖成一列？
外来历史的用户气泡现在会按 Markdown 渲染（含表格）。若源内容本身就是「一格一行」的纯文本（例如从 Excel 粘贴时丢掉了表结构），导入不会凭空还原成表——那是源里就没有结构，不是渲染坏了。
归档的对话会一起导吗？想只导没归档的怎么办？
会一起扫出来，界面上没有单独的开关。列表里归档的对话带「已归档」后缀，手动取消勾选就行。或者用「只导一个试试」，它会自动跳过归档的。
导入很慢 / 好像卡住了
Cursor 的数据库可能有十几个 G，大库上扫描和解析确实慢。导入是后台跑的——直接离开这个页面继续用 TabTin 就行，右下角有进度面板，跑完会更新。真要停就点「取消导入」，已经写进去的部分会保留，不想要可以用「移除本次导入」清掉。
还是搞不定？
把卡住的那一步、或者结果页的「失败明细」截个图，发到 contact@larchiveai.com，我们帮你看。写清楚你是从哪个工具导的、大概多少条对话，会更快定位。