<div align="center">

# ChatCode CLI Chat Import

**ChatCode CLI 会话导入插件，一键导入外部 Agents 的聊天历史并在 ChatCode CLI 中继续对话。**

> **所有会话，尽续于此。**

[![English](https://img.shields.io/badge/lang-English-blue.svg)](README.md) [![简体中文](https://img.shields.io/badge/lang-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-red.svg)](README.zh-CN.md)

[![version](https://img.shields.io/npm/v/@chatcode/cco-chat-import?style=flat&label=version&color=4D6BFE)](https://www.npmjs.com/package/@chatcode/cco-chat-import)
[![downloads](https://img.shields.io/npm/dm/@chatcode/cco-chat-import?style=flat&label=downloads&color=4D6BFE)](https://www.npmjs.com/package/@chatcode/cco-chat-import)
[![GitHub stars](https://img.shields.io/github/stars/Nwflower/dsh-chat-import?style=flat&label=%E2%98%85&color=08C)](https://github.com/Nwflower/dsh-chat-import)
[![license](https://img.shields.io/badge/license-MIT-2EA44F?style=flat)](LICENSE)

</div>


## 简介

`ChatCode CLI Chat Import` 从其他 Agents 导入含完整上下文的聊天历史，成为可无缝继续的 ChatCode CLI 会话。

现已覆盖 19 种 Agents 的导入：Claude Code、Codex、ChatGPT、Cursor、Gemini、Reasonix、opencode、MiMo Code、ZCode、Grok Build、OpenClaw、Pi Coding Agent、Hermes、Kimi CLI / Kimi Code、Qoder CLI、WorkBuddy、千问办公（Qwen Work CN）与旧版 DSH 会话日志；

下述工具的反向导入：Claude Code、Codex、Kimi Code。


## 安装

```bash
chatcode-cli plugin --profile web add @chatcode/cco-chat-import          # npm 包
chatcode-cli plugin --profile web add -w link:/path/to/dsh-chat-import   # 本地源码（符号链接）
```

## 使用

### 启动自动导入

首次安装后启动 ChatCode CLI 时，插件会自动扫描并导入既有 ChatCode CLI 历史会话。界面左下角会依次显示扫描状态、导入中的「已完成 / 共多少会话」，以及完成后的总数、成功数、失败数和跳过数；完成通知会在 5 秒后关闭。`imports.json` 已存在时，后续启动不会再次扫描。

1. **导入** — 在GUI界面右下角的导入会话面板选择你想导入的会话并一键导入。或让你的Agent调用上下文工具进行导入：

```
import_chat({ format: "claude", path: "~/.claude/projects" })
import_chat({ format: "chatgpt", path: "~/Downloads/chatgpt-export/conversations.json" })
import_chat({ format: "local-jsonl", path: "D:\downloads\session.jsonl" })
```

Reasonix 目录导入只会折叠同时满足“严格语义前缀”和明确 `parent_id` 谱系证明的恢复祖先。无法证明或真实分叉的文件继续独立保留；`lineageMode: "physical"` 可恢复每个 JSONL 一条会话。

Claude Code 导入会排除完整、已知的 CLI 标签包裹注入记录（例如命令上下文和系统提醒），不将其视为用户提问。

2. **续聊** — 刷新会话列表，打开导入的会话，从源记录停下的地方继续对话。

3. **同步（可选）** — 面板「同步」页提供双向增量同步，默认关闭。子代理对话默认双向过滤。

完整工具 / 命令用法（参数、示例、边界行为）见 **[docs/USAGE.zh-CN.md](docs/USAGE.zh-CN.md)**。

## 配套工具：配置迁移

只想迁移**配置**（技能、hooks、全局设置等）而不需要会话历史？[dsh-movein](https://github.com/sjh9714/dsh-movein) 负责配置迁移，与本插件分工互补--本插件只管会话历史，两边可按需单独使用。其[首次迁移指南](https://github.com/sjh9714/dsh-movein/blob/main/docs/first-migration.zh.md)提供「先预演、后应用、逐步验证」的分步流程。

> 两个工具的组合流程尚未联合验证，互链不构成互相背书；请分别检查来源、目标、重复导入与撤回边界。

本插件的 `import_agents` 是轻量的资产搬移（把 pi/opencode/Claude/Codex 的 agent、prompt、skill 落盘为 ChatCode CLI skills）；需要 hooks、权限规则、settings 等完整配置迁移时，请使用 dsh-movein。

## 功能一览

| 能力 | 入口 | 说明 |
| --- | --- | --- |
| 批量导入 | `import_chat`（19 种格式）· `scan_discover` · 侧边栏面板 | 18+ 来源一键导入，每段对话成为独立会话 |
| 导入历史与撤回 | 侧边栏面板「历史」页 | 展示 `imports.json` 记录；一键删除本插件创建的会话（需确认） |
| 全保真续聊 | 导入即 ChatCode CLI 会话 | 工具调用/结果、思考、标题、模型、时间戳原样保留 |
| 反向导出 | `export_chat`（`format: claude` / `codex` / `kimi`） | ChatCode CLI 会话序列化回 Claude / Codex / Kimi |
| 双向同步 | 面板「同步」页 | 外部 ↔ ChatCode CLI 双向增量同步，默认关闭 |

## 文档

| 文档 | 说明 |
| --- | --- |
| [使用详解](docs/USAGE.zh-CN.md) | 每个工具 / 命令的完整参数、示例与边界行为 |
| [互转协议](docs/INTERCHANGE.md) | Interchange v1 协议与 bundle 格式 |
| [更新日志](CHANGELOG.md) | 版本历史（英文） |
| [路线图](ROADMAP.md) | 已实现 / 规划 |
| [贡献指南](CONTRIBUTING.md) | 开发环境、提交规范、安全与隐私 |

## Star History

[![Star History Chart](https://api.star-history.com/chart?repos=Nwflower/dsh-chat-import&type=date&legend=top-left&sealed_token=sAq09Z4DmwD843pzhg7azZtfXs8zW_Xij3fvCo3Ns1BGAgNeP_Zl1xU9YiUacS74_EzDXKHFpW3Bfj13ClcEMRzAhh4mVrl4a20ijURAGU_Oz6RROQYDYw)](https://www.star-history.com/?type=date&repos=Nwflower%2Fdsh-chat-import)