kimi-code/docs/zh/guides/migration.md
wenhua020201-arch 70ca7a9f8b
docs(zh): improve CLI section — env-vars, mcp, interaction, datasource, and more (#372)
* docs(zh+en): improve and translate CLI section — guides, config, customization, reference

zh improvements:
- interaction: add image/video paste, expand approval flow, Plan/YOLO/Auto modes
- slash-commands: add /btw, /reload, /reload-tui
- kimi-command: add kimi login, kimi acp subcommands
- environment-variables: restructure with KIMI_CODE_HOME, KIMI_DISABLE_TELEMETRY, KIMI_MODEL_* sections
- mcp: fix anchor link text
- datasource: rewrite as official plugin page (new)
- use-in-ides: ACP IDE integration for Zed/JetBrains (new)
- kimi-acp: ACP capability matrix and method coverage (new)

en: full zh→en translation of all 22 CLI pages, zh/en aligned

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* chore: remove misplaced local-path file from upstream PR branch

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: moonshot <moonshot@moonshotdeMacBook-Pro.local>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-03 22:56:26 +08:00

1.9 KiB
Raw Permalink Blame History

从 kimi-cli 迁移

::: info Kimi Code CLI 已完成重大版本升级,底层从 Python/uv 迁移至 Node.js带来更简单的安装方式、更快的启动速度和全新的终端界面。旧版将逐渐停止维护建议尽快升级至新版。 :::

如果你正在从旧版迁移按照以下步骤操作——一条命令就能把配置、MCP server 与会话历史一并迁移至新版。

新版优势

  • 不再依赖 Python / uv:基于 Node.js 重写,无需配置 Python 环境,安装更简单
  • 原生二进制,开箱即用:启动更快,运行更轻量
  • 终端界面全面重设计:交互体验更流畅
  • 数据可完整迁移配置、MCP、会话历史一键带走无缝延续

如何迁移

迁移有两种方式。

装好 kimi-code 之后第一次运行 kimi 时,它会自动检测 ~/.kimi/ 下是否存在 kimi-cli 的数据。一旦检测到,就会弹出迁移提示,你可以选择立即迁移、稍后再说,或不再提示。

你也可以随时手动运行

kimi migrate

你可以选择是否同时迁移聊天会话。如果暂时不需要历史记录,选 Config only;否则选 Config + N sessions 一并迁移。结束后会显示结果摘要。

迁移会发生什么

会被迁移的内容:配置(config.toml、MCP 服务配置、输入历史,以及你选择迁移的聊天会话。

不会被迁移的内容OAuth 登录凭证和 MCP 服务的授权都不会被复制,迁移后需要在 kimi-code 里重新执行 /login 和重新授权 MCP 服务。kimi-cli 的插件也不在迁移范围内。

::: tip 提示 迁移不会改动或删除 ~/.kimi/ 下的任何旧数据。kimi-cli 仍可照常使用,两者互不影响。迁移也可以重复运行,已经迁移过的会话不会被重复导入。 :::

迁移完成后,从 kimi-cli 导入的会话会带上 [imported] 标记,方便你与新建的会话区分。