怎么升级
先退出所有正在运行的 u1s1，然后执行下面任意一条：
u1s1 update
npm i -g u1s1-cli
便携版也可以重新运行官网的安装脚本。装完用 u1s1 --version 确认输出 v1.13.1 或更高，再启动一次 u1s1，迁移就在这次启动时完成。
升级时自动改了什么
下面每一项只在第一次启动时做一次，之后你自己改过的设置不会被改回来。唯一的例外：defaultTools 里如果有 +name / -name 这种增减写法，每次启动都会换算成效果相同的完整列表。
| 文件 | 改动 | 原因 |
|---|---|---|
~/.u1s1/mcp.json |
内容并入 ~/.u1s1/agent/mcp.json；原文件保留给桌面版用，另存一份 mcp.json.migrated 作为已迁移标记 | Pi 自带的 MCP 只读 agent 目录下的配置 |
~/.u1s1/agent/settings.json |
defaultTools 写成完整工具列表，并加入 codemode | 默认开启 codemode；写完整列表，桌面版内置的旧引擎也能读懂 |
~/.u1s1/agent/settings.json |
extensions 加入 -builtin:llama.cpp | 本地模型扩展走不了 u1s1 网关，默认关掉 |
~/.u1s1/agent/settings.json |
没设过 tuiMode 时写入 regular | Pi 1.0 默认改成全屏，u1s1 保持原来的界面 |
登录状态、模型和思考档位设置不受这次迁移影响。
MCP 配置是怎么迁移的
第一次启动 u1s1，或第一次运行任意 u1s1 mcp 命令时，会把旧文件里的每个服务搬到新文件：
- 条目原样搬过去，包括命令、参数、地址、env 和 headers 里的 Key。新文件和旧文件一样只有你自己能读写。
- 新文件里已经有同名服务时，以新文件为准。
- 每个搬过去的服务会补上 "exposure": "direct"，让工具和以前一样直接提供给模型，一步就能调用。你已经写过 exposure 的服务不会被改。
- 迁移只做一次。之后用 u1s1 mcp add / list / test / remove 管理服务，读写的都是新文件；旧文件只留给桌面版读，改它不影响 CLI。
工具名变了
MCP 工具名从 mcp_服务_工具 变成 mcp__服务__工具（分隔符从一个下划线变成两个）。例如 tavily 服务的 search 工具：
| 1.12 及更早 | 1.13 起 |
|---|---|
mcp_tavily_search |
mcp__tavily__search |
平时让模型自己挑工具的话，不需要做任何事。如果你在 AGENTS.md、技能或常用提示词里点名写过旧工具名，请改成新名字。
新增的 /mcp 面板
在对话里输入 /mcp，可以看每个服务的连接状态、工具列表，重连、停用或启用服务；需要 OAuth 登录的 HTTP 服务也在这里打开浏览器授权。手改 mcp.json 之后，在对话里输入 /reload 生效。
少数情况需要你处理
- "type": "sse" 的服务不再支持，Pi 会跳过它并报错。很多服务同时提供 streamable HTTP，地址通常是把结尾的 /sse 换成 /mcp，改完后去掉 type 或写成 "http"。
- 项目目录下的 .pi/mcp.json 现在也会被读取（仅在你信任该项目之后），同名服务以项目里的为准。
- u1s1 mcp add 遇到返回 401/403 的服务时，会提示加 --force 先保存，再到对话里用 /mcp 登录。
不想要这些默认值怎么改
都在 ~/.u1s1/agent/settings.json 里改，改完重启 u1s1。u1s1 只在第一次写一次，之后不会再改回来。
关闭 codemode
codemode 让模型写一小段 JavaScript，在沙箱里批量、并行地调用工具（比如一次读几个文件再汇总），能少几轮来回。不想用的话，把 defaultTools 里的 "codemode" 删掉，例如：
"defaultTools": ["read", "bash", "edit", "write"]
重新打开 llama.cpp
如果你确实要连自己的 llama.cpp 服务，把 extensions 里的 "-builtin:llama.cpp" 删掉即可，/llama 命令和本地模型渠道就会回来。
试试全屏界面
在对话里输入 /settings 切换界面模式，或者直接把 tuiMode 改成 "fullscreen"。
已知问题
要退回 1.12
先确认已经用 1.13.1 或更高版本启动过一次（它会把配置换成旧版也能读懂的写法），然后直接装回旧版：
npm i -g u1s1-cli@1.12.0
升级后新加的 MCP 服务只在 ~/.u1s1/agent/mcp.json 里，旧版看不到，需要的话手动抄到 ~/.u1s1/mcp.json。Windows 上 ~ 指的是用户目录，例如 C:\Users\你的用户名。