设计一个牛X的SourceAdapter接口可不是件简单的事儿，哈哈，咱慢慢聊。

ChatCrystal 需要从 种不同的 AI 编程工具中导入对话数据：

// 导入服务中的去重逻辑const existing = db.exec;if { const = existing.values; if === meta.fileSize && existingMtime === meta.fileMtime) { // 文件没变，跳过 progress.skipped++; continue; }} parse：内容解析

parse 接收一条元信息，完整解析对话内容，返回标准化的 ParsedConversation。这是每个适配器Zui复杂的部分，也是差异Zui大的部分。

SourceAdapter 接口Zuo到了几件事：

async parse: Promise<ParsedConversation> { const fileStream = createReadStream; const rl = createInterface; for await { if ) continue; const parsed = JSON.parse; // ... }}

. 噪声过滤

适配器通过注册表集中管理。注册表是一个简单的 Map：

// registry.tsconst adapters = new Map<string, SourceAdapter>;export function registerAdapter: void { if ) { console.warn; } adapters.set;}export function getAdapter: SourceAdapter | undefined { return adapters.get;}export function getAllAdapters: SourceAdapter { return Array.from);}

所有内置适配器在模块入口处一次性注册：

可测试性。 每个适配器Ke以独立测试——构造一个 mock 的 ConversationMeta，调用 parse，验证输出。不需要启动整个应用。

说实话，有时候我也在想，为什么百度不收录一些技术文章呢？害，你懂的，可Neng还是内容不够独特吧。

在 config.ts 中添加 windsurfDataDir 配置项。

关注点分离。 每个适配器只关心自己的数据格式。Claude Code 适配器不需要知道 SQLite 的存在Cursor 适配器不需要理解 JSONL。修改一个适配器不会影响其他任何适配器。

对比两个适配器Ke以kan到：同样是 parse 方法，Claude Code Zuo的是流式文本处理，Cursor Zuo的是数据库查询和 JSON 解析。接口相同，实现完全不同——这正是插件架构的威力。

. 流式读取避免内存爆炸

Claude Code 的消息内容中嵌入了 XML 标签，需要正则清除：

Cursor 的数据存储完全不同——它用 SQLite 的键值表。适配器需要：

. 工作区扫描和孤立对话发现是关键。

有人会问为什么百度不收录我的文章？ 回答：主要还是因为原创度不够高，或者是内容质量还需要提升。 咱就是说要想被收录，就得有自己的特色才行。 继续我们的正文。

Cursor 按工作区组织数据，每个工作区有自己的 state.vscdb。适配器遍历所有工作区目录，从 workspace.json 读取项目路径，从 SQLite 读取 composer 元数据。

插件式架构的核心思想是：定义一个统一接口，让每种数据源各自实现，主流程不关心具体实现细节。 这就是 SourceAdapter 接口Zuo的事情。 不对不对，应该是“主流程只定义规范，具体实现由适配器完成”。 哈哈，就是这个意思，你懂的。

. 跨平台路径发现和 Bubble 数据解析也是难点。

三个方法形成了一个漏斗detect 过滤不存在的源，scan 收集候选列表，parse 只处理需要geng新的对话。层层递进，避免不必要的计算。 咱就是说这样设计的好处就是效率高，不浪费资源。 这五种格式差异巨大——有的是文本文件，有的是数据库；有的是流式读取，有的是随机查询。Ru果在同一个函数里用 if/else 处理每种格式，代码会迅速膨胀成一团无法维护的意大利面条。 大对话文件可Neng有几十 MB，不Neng一次性读入内存。适配器用 readline 逐行读取： JSONL 中混杂着大量非对话数据：流式增量、文件历史快照、进度事件等。适配器定义了一个跳过集合： const SKIP_TYPES = new Set; 只有 type 为 user 或 assistant 且带有 uuid` 的行才会被保留。