create-adapter 是 Sidecar 项目（来源 marcus/sidecar）中用于创建对话适配器的开发文档，目标是从不同 AI 工具（Claude Code、Cursor、Warp、Codex 等）导入聊天历史。
用途：指导开发者实现 adapter.Adapter 接口，将各来源的会话与消息映射到 Sidecar 的会话流 UI。
主要能力与要求：
- 接口方法：ID、Name、Icon、Detect、Capabilities、Sessions、Messages、Usage、Watch。
- 会话必填字段：ID、Name、AdapterID/Name/Icon、CreatedAt、UpdatedAt、MessageCount、FileSize。
- 性能标准：元数据与消息缓存（键含 path+size+modTime，SQLite/WAL 需含 WAL 大小与 mtime）、追加格式增量解析、大文件两遍元数据解析、避免重复路径解析、缓存返回防御性副本、DB 只读且 FD 安全。
- 监听：优先目录级监听，全局适配器实现 WatchScope，事件携带 SessionID，去抖与非阻塞发送，利用 FROZEN 分层（24 小时未变会话零轮询），确保清理无泄漏。
- 可选接口：TargetedRefresher、ProjectDiscoverer、SessionPathResolver、ProjectDiscoveryWatcher。
- 会话分类：SessionCategoryInteractive/Cron/System，可设 CronJobName、SourceChannel、SourceLabel，并清理消息前缀。
- 测试：覆盖相对/绝对路径、排序、缓存命中、文件增长/收缩、工具链接、监听清理、FD 稳定性、时间分区滚动、多项目隔离等；命令为 go test ./internal/adapter/<adapter> -run . 与 go test ./internal/adapter/<adapter> -bench . -benchmem。
限制：文档为开发规范，未提供安装命令、收费或平台信息；具体实现细节需参考各参考适配器源码。