# 桌面 Agent 迁移

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：Web 与局域网。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/desktop_agent_migration/

## 它是什么

如果你习惯在电脑上用 Claude Code、Codex 等桌面 agent，它们积累的记忆和自定义指令(如 CLAUDE.md、AGENTS.md)可以由 agent 自己迁移进 Cube Agent：agent 通过 Web 服务器的接口读取接入说明，再直接写入全局记忆、助手记忆和系统提示词。不需要复制粘贴，也不需要在网页聊天里让它代为输入，Markdown 格式原样保留。

## 怎么使用

1. 打开 **设置 → 连接与高级 → Web 服务器** 并启动服务。电脑与手机不在同一设备时，关闭「仅本机访问」，并设置访问密码、开启「访问需要密码」。
2. 点访问地址下方的 **复制桌面 Agent 迁移指令**。
3. 把指令粘贴给电脑上的 agent。它会先读取 `/api/agent/guide` 了解规则，需要密码时会向你索取。
4. agent 列出准备写入的内容后，确认无误再让它执行。完成后可在记忆管理页和系统提示词页查看结果。

## 会写到哪里

- **记忆**：适合长期有效的个人信息和偏好，按「一条一个事实」写入。默认写入全局记忆，也可以指定某个助手；助手需开启记忆(使用全局记忆时还要开启「使用全局记忆」)才会生效。
- **系统提示词**：适合行为规则、回答风格等指令，可写入全局系统提示词或某个助手的提示词，标题、列表和代码块保持原样。

## 规则与限制

- 记忆只追加并自动去重，重复执行不会产生重复条目；删除的记忆进入回收站，可以恢复。
- 接口不提供整体替换或批量删除。需要合并精简时，请在 App 内用「智能整理」，可先预览再保存。
- 批量写入记忆与 App 内批量导入一样是 Pro 功能；读取记忆、单条修改或删除，以及系统提示词的读写不限。
- 写入系统提示词会覆盖原内容，迁移指令已要求 agent 写入前先向你确认。
- 隐私助手需先在 App 内解锁，否则无法读取或修改它的记忆与提示词。

## 最佳实践

- 让 agent 把个人事实写进记忆、把工作规则写进系统提示词，不要把长篇规则拆成记忆。
- 不在电脑上用 agent 时，也可以在系统提示词页和记忆导入页点 **从文件导入**，直接读取 .md / .txt 文件。
- 迁移完成后可以修改访问密码，旧令牌会立即失效。