关于 chatlab-import-cn
chatlab-import-cn 是已弃用的兼容技能,通过 clb 命令行将本地聊天导出文件导入 ChatLab。它要求先用 dry-run 预览写入计划,并保留 ChatLab v0.31.1 至 v0.37.1 发布的旧工作流。
主要功能
- 01导入本地聊天导出文件
- 02通过 dry-run 预览变更
- 03创建会话或更新现有会话
- 04识别重复消息与新消息
- 05遵守隐私和会话保护规则
适用场景
- 01导入本地聊天导出文件
- 02向现有会话添加消息
- 03写入前检查导入变更
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ chatlab/ chatlab --skill chatlab-import-cn安装后在 Claude Code 中输入/chatlab-import-cn确认已加载。
详细介绍
ChatLab 导入(旧版兼容)
此弃用入口保留了 ChatLab v0.31.1 至 v0.37.1 随附的安装命令。它包含下方完整的导入工作流,且无需安装 chatlab-import。对于新安装,请使用 npx skills add ChatLab/ChatLab --skill chatlab-import -g;完成导入无需迁移。
通过 clb CLI 导入本地聊天导出文件。务必预览确切的写入操作。将用户明确提出的导入请求视为授权:预览成功后继续;无需再次确认。
使用用户要求的回复语言;否则使用对话语言,并在适用时保留用户使用的中文变体。命令、字段名、ID 和证据标记保持不变。
分析已导入的记录时,如有 chatlab-analyze,请使用它。对于不受支持的来源,如有 chatlab-convert,请使用它;受支持的导入无需这两个技能。
工作流
- 检查 CLI 并确定一个确切的文件路径:
clb --help
如果缺少 CLI,请告知用户使用 npm install -g chatlab-cli 安装。未经批准,不要安装软件。沿用用户指定的文件和目标。仅在路径仍不明确时询问,并在每条命令中引用该路径。
- 预览导入,但不写入:
clb import "/absolute/path/to/chat-export.json" --dry-run --json
如果用户选择了现有会话,请在预览和导入命令中都加入 --session-id <session-id>。
-
仅概述计划:创建或更新模式、目标会话 ID、扫描的消息数、新消息数、重复消息数,以及匹配方法或创建原因。绝不引用消息正文。
-
要求
ok: true,然后从data读取计划并作出决定:
- 如果用户只要求预览或检查,则停止,不要写入。
- 如果
importMode为incremental且newMessageCount为0,则报告会话已是最新状态并停止。 - 如果
importMode为incremental且存在新消息,则自动继续,无需再次确认。 - 如果
importMode为created,则自动继续。当createReason为ambiguous时,通过创建新会话来保留现有会话,并在最终结果中说明这一选择。 - 如果结果无法确定安全操作,则停止并说明缺少什么。
- 当决策允许写入时,运行相同的命令,但不带
--dry-run;文件、目标和格式保持不变:
clb import "/absolute/path/to/chat-export.json" --json
从最终 JSON 信封中报告结果会话 ID、导入模式、新消息数和重复消息数。
安全措施
- 绝不跳过预览、直接编辑 ChatLab 数据库,或删除、合并会话。
- 绝不泄露完整聊天导出内容或消息正文。
- 绝不编造文件路径、解析器格式或会话 ID。
- 仅当
error.hint中的修正方式明确无误时才遵循。 - 对于
FILE_NOT_FOUND或INVALID_SESSION_ID,根据现有上下文确定正确值,或请求用户提供正确值。对于UNRECOGNIZED_FORMAT,检查clb formats。对于IMPORT_IN_PROGRESS,在当前导入完成后重试一次;若仍受阻,则报告情况,不要无限轮询。