@armadra/agent 0.5.0 → 0.6.0

package/docs/tui.md

@@ -111,25 +111,26 @@ Accept edits     claude-opus-5-5 medium | Ctx 3.0% | proj ⎇ main 5ae9e54 (+12,
 
 ## 按键
 
-| 按键                 | 作用                                                                  |
-| -------------------- | --------------------------------------------------------------------- |
-| Enter                | 发送；运行中 = steer（插到当前轮）                                    |
-| Alt+Enter            | 运行中排到本轮之后（followUp）；空闲时等同 Enter                      |
-| Shift+Enter / Ctrl+J | 换行                                                                  |
-| Esc                  | 中断：排队的消息回填到输入框，然后停止当前运行；补全打开时先关补全    |
-| Esc Esc（空闲）      | 输入框为空：打开回滚列表（同 `/rewind`）；有字：清空并存进输入历史    |
-| Alt+↑                | 取回最后一条排队消息                                                  |
-| Shift+Tab            | 循环权限模式 Manual → Accept edits → Plan → Auto → Bypass permissions |
-| Ctrl+O               | 展开 / 折叠工具输出与思考块                                           |
-| Ctrl+L / Ctrl+T      | 选择模型 / 思考级别                                                   |
-| Ctrl+G               | 底部信息行 两行（full）↔ 一行（compact），只影响本会话                |
-| Ctrl+V               | 粘贴剪贴板里的图片：存进数据目录，光标处插入 `@<路径>`（同 `/paste`） |
-| Ctrl+C               | 清空输入；输入为空时 1.5 秒内再按一次退出（退出码 130）               |
-| Ctrl+D               | 输入为空时退出                                                        |
-| Tab                  | 补全                                                                  |
-| ↑ / ↓                | 单行时浏览历史（`<数据目录>/history`，500 条）                        |
-
-按键可在 `~/.config/ama/keybindings.json` 覆盖，键是动作 id（`app.interrupt`、`app.rewind`、`app.message.followUp`、`app.statusLine.toggle`、`app.paste.image`、`tui.editor.newLine` ……），值是按键或按键数组，空数组表示禁用。`app.rewind` 是空闲时双击的那个键（缺省 Esc，两次间隔 ≤ 800 ms）。
+| 按键                 | 作用                                                                                                                                                             |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Enter                | 发送；运行中 = steer（插到当前轮）                                                                                                                               |
+| Alt+Enter            | 运行中排到本轮之后（followUp）；空闲时等同 Enter                                                                                                                 |
+| Shift+Enter / Ctrl+J | 换行                                                                                                                                                             |
+| Esc                  | 中断：排队的消息回填到输入框，然后停止当前运行；补全打开时先关补全                                                                                               |
+| Esc Esc（空闲）      | 输入框为空：打开回滚列表（同 `/rewind`）；有字：清空并存进输入历史                                                                                               |
+| Alt+↑                | 取回最后一条排队消息                                                                                                                                             |
+| Shift+Tab / Tab      | 循环权限模式 Manual → Accept edits → Plan → Auto → Bypass permissions（Tab 只在输入为空、补全未打开时，否则仍是补全；进入 Bypass 前确认，见下文「进入 Bypass」） |
+| Ctrl+O               | 展开 / 折叠工具输出与思考块                                                                                                                                      |
+| Ctrl+L / Ctrl+T      | 选择模型 / 思考级别                                                                                                                                              |
+| Ctrl+G               | 底部信息行 两行（full）↔ 一行（compact），只影响本会话                                                                                                           |
+| Ctrl+V               | 粘贴剪贴板里的图片：存进数据目录，光标处插入 `@<路径>`（同 `/paste`）                                                                                            |
+| Ctrl+C               | 清空输入；输入为空时 1.5 秒内再按一次退出（退出码 130）                                                                                                          |
+| Ctrl+D               | 输入为空时退出                                                                                                                                                   |
+| Tab                  | 补全                                                                                                                                                             |
+| ↑ / ↓                | 单行时浏览历史（`<数据目录>/history`，500 条）                                                                                                                   |
+| Ctrl+B / ↓（空输入） | 进入 Agent 栏（有子 Agent 任务时；有字时 Ctrl+B 仍是光标左移，tmux 里用 ↓），见「子 Agent」（第六波 W6-A 起）                                                    |
+
+按键可在 `~/.config/ama/keybindings.json` 覆盖，键是动作 id（`app.interrupt`、`app.rewind`、`app.message.followUp`、`app.statusLine.toggle`、`app.paste.image`、`app.agents.focus`、`tui.editor.newLine` ……），值是按键或按键数组，空数组表示禁用。`app.rewind` 是空闲时双击的那个键（缺省 Esc，两次间隔 ≤ 800 ms）。
 
 ## 回滚
 
@@ -186,9 +187,48 @@ Accept edits     claude-opus-5-5 medium | Ctx 3.0% | proj ⎇ main 5ae9e54 (+12,
 - `/statusline [full|compact]`：切换底部信息行（无参数时在两者间切换，同 `Ctrl+G`），只影响本会话；line 模式没有底部信息行。
 - `/session`、`/cache`：会话用量与缓存统计面板（见上文「缓存与上下文」）；`/permissions` 同样是面板，allow 绿、deny 红，判定顺序折行对齐。`/session` 有子 Agent 任务时多一行「子 Agent」（任务数与各状态），用过外部 Agent 时多一段「外部 Agent」（每个 Agent 的运行次数与用量，美元 / token / 请求数按各自单位，不换算）。
 - `/plan`：当前计划面板（见下文「Plan 审批」）；`/plan <目标>` 进入 Plan 模式并发出目标；`/plan approve [模式|fresh]`、`/plan reject` 不开对话框直接批准 / 放弃。
-- `/tasks`：子 Agent 任务列表；`/agents`：可用的子 Agent 类型（见下文「子 Agent」）。
+- `/tasks`：聚焦 Agent 栏，`/tasks <id>` 打开子 Agent 视图；`/agents`：可用的子 Agent 类型（见下文「子 Agent」）。
 - `/paste`：同 `Ctrl+V`。
 
+## 进入 Bypass
+
+切到 Bypass permissions（`full-auto`）之前底部弹一个确认框，样式同审批对话框（边框黄）：
+
+```
+╭─ 进入 Bypass permissions？ ──────────────────────────────────────────────────╮
+│ 所有工具调用都不再询问：写文件、执行命令、联网直接放行                       │
+│ 只有危险命令仍会询问，deny 规则照常生效；只建议在一次性沙箱、容器里用        │
+│                                                                              │
+│   1. 进入 Bypass                                                       y     │
+│ › 2. 取消                                                              n Esc │
+│                                                                              │
+│ ↑↓ 选择 · Enter 确认 · 1-2 直接选 · Esc 取消                                 │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+- 触发：Tab / Shift+Tab 循环到 Bypass、`/permission` 选择器选 Bypass、`/permission full-auto`。缺省选中「取消」：↑↓ 移动、Enter 确认、`1` / `2` 或 `y` / `n` 直选，Esc / Ctrl+C 取消（Ctrl+C 在这里不算退出的第一下）。
+- 取消：循环时**跳过 Bypass 回到循环起点 Manual**（底部提示「未进入 Bypass · 权限模式：Manual」），这样不进 Bypass 也能一路 Tab 绕回去，且落点总比 Auto 更严；选择器与命令取消时保持原模式（消息区「已取消，权限模式仍为 …」）。
+- 本次运行确认过一次后，再切到 Bypass 不再问；启动时已是 Bypass（`--permission-mode full-auto`、配置、profile）视为已确认，不弹。
+- 宽 < 56 列时去掉空行、按键提示缩短；ASCII 模式边框 `+ - |`、选中符 `>`、箭头 `^v`。帧黄金 `test/fixtures/tui/bypass-confirm-*.txt`。
+- line 模式（`--no-tui`）：`/permission full-auto` 先打印上面两行说明，再问 `确认进入 Bypass？[y/N]`（单键，Enter = N）；管道输入没有这一步。
+
+## 选择与确认的按键
+
+所有让人做选择的地方都支持 ↑↓ 移动 + Enter 确认，原有快捷键保留：
+
+| 位置                                    | 按键                                                     |
+| --------------------------------------- | -------------------------------------------------------- |
+| 审批对话框（含外部 Agent 首次运行确认） | ↑↓ Enter · 1–3 · y / a / n · Esc 拒绝 · v 完整输入       |
+| 计划审批框（主选项、执行模式）          | ↑↓ Enter · 1–4 / 1–3 · e 编辑计划 · Esc 留在 Plan / 返回 |
+| 回滚确认面板、冲突覆盖二次确认          | ↑↓ Enter · 数字直接执行 · Esc 取消 / 返回                |
+| 进入 Bypass 确认                        | ↑↓ Enter · 1–2 · y / n · Esc 取消                        |
+| 权限模式、思考级别选择器                | ↑↓ Enter · 数字直接选 · Esc 取消                         |
+| 模型、会话、树、任务选择器              | ↑↓ Enter · 输入过滤 · Esc 取消（可过滤的列表不用数字键） |
+| 启动时信任目录                          | ↑↓ Enter · 1–4 直接选 · Esc / Ctrl+C = 本次不信任        |
+| CLI 子命令计费 / 写入确认（TTY）        | ↑↓ Enter · 1–2 · y / n · Esc / Ctrl+C 取消（缺省取消）   |
+
+CLI 子命令（`ama providers add` / `refresh` 的写入与 `--probe` 计费确认、`ama models cache-probe`）在 TTY 下用同一套方向键选择，结束后收成一行「? 继续？ 继续」并恢复终端；stdin 不是 TTY（管道、CI）时仍是文本 `继续？[y/N]`（这些命令非交互时本就要求 `--yes`），`--yes` 跳过确认。
+
 ## 补全
 
 - 首行行首输入 `/`：命令、提示模板（`/<名字>`）、Skill（`/skill:<名字>`）。
@@ -266,10 +306,49 @@ Plan 模式（Shift+Tab、`/permission plan`、`/plan <目标>`、`--permission-
 ```
 
 - 状态行是类型（外部 Agent 写 `claude（claude）` 这类 runner）、状态与耗时、轮数、最近 3 个工具、用量；前台任务结束后换成结果摘要。后台任务（`background: true`）的工具调用立即返回，下面多一行跟随状态（运行中每秒刷新）；完成后模型收到的 `<task-notification>` 在消息区只显示一行「↳ 子 Agent 通知 t2 explore 完成 · 7 轮 · /tasks 查看输出」，失败或被停止时另有一行黄色提示。
-- `/tasks`：任务选择器（新的在上；一行是任务 id、类型、状态、耗时、轮数、用量、费用、后台、描述），Enter 查看输出（运行中是已有输出；截断时给全文文件）；运行中的任务可以选择停止。line 模式 `/tasks` 列表、`/tasks <id>` 输出、`/tasks stop <id>` 停止。
+- `/tasks`：聚焦 Agent 栏（见下）；`/tasks <id>` 直接打开该任务的子 Agent 视图；`/tasks stop <id>` 停止。`ui.agentBar: "off"`（嵌入宿主缺省）时 `/tasks` 仍是任务选择器（新的在上，Enter 查看输出、运行中可停止）。line 模式 `/tasks` 列表、`/tasks <id>` 输出、`/tasks stop <id>` 停止。
 - `/agents`：可用类型——名字、runner、来源（内置 / 用户 / 项目 / profile / 宿主），外部 Agent 带「已安装 版本」或「未安装」，再加一行说明。
 - 外部 Agent 自己报告的提示（预算用尽、超时、模式降级等）在消息区显示为一行 `[claude · t3] …`。
 
+### Agent 栏
+
+状态行上方（提示行之下）列出子 Agent 任务，每个任务一行，最多 3 行，多出的给一行「另 N 个」：
+
+```
+⏺ t1 explore · 运行中 1m05s · 3 轮 · grep  找出 src/tui 的测试缺口
+⏺ t2 codex · 等待审批 40s  review the diff
+⏺ t3 explore · 排队  排队中的任务
+另 1 个
+```
+
+- 状态：排队（并发池满）/ 运行中（用时、轮数、最近一个工具）/ 等待审批（审批框里正有它的请求）/ 完成 / 失败 / 已停止（以及轮数耗尽、已中断）；`⏺` 运行中强调色、完成绿、失败红、其余黄 / 暗；ASCII 下是 `*`。
+- 什么时候显示：有排队、运行中或等审批的任务；本会话里结束、还没在视图里看过的任务保留到看过为止，最多 10 分钟。resume 进来时已经结束的任务不显示（`/tasks` 里能看到）。
+- 进入：输入框为空时 `Ctrl+B`（有任务即可），或 `↓`（栏可见时）——tmux 的缺省前缀会吃掉 `Ctrl+B`，这时用 `↓`；输入框有字时 `Ctrl+B` 仍是光标左移、`↓` 仍是下移 / 历史。键位动作 `app.agents.focus`，可在 `keybindings.json` 改。
+- 栏里：`↑` `↓` 选（列出本会话全部任务，窗口跟着滚；在第一项再按 `↑` 回到输入框），Enter 打开子 Agent 视图，Esc / `Ctrl+B` 回到输入框；直接打字则回到输入框并把字填进去。末行是按键提示。
+- 嵌入宿主（有 profile）缺省 `ui.agentBar: "off"`：不显示栏，`Ctrl+B` / `↓` 照常交给编辑器。
+
+### 子 Agent 视图
+
+栏里 Enter 或 `/tasks <id>` 打开。它是主屏上的底部覆盖层，高度是终端行数 − 1（不切备用屏），关掉之后消息区与回滚历史原样：
+
+```
+t2 explore · 运行中 1m05s · 3 轮 · ↑12k ↓3.4k · Esc 返回 · /tasks stop t2 停止
+› 找出 src/tui 的测试缺口
+
+⏺ grep "describe(" src/tui
+  ⎿ 14 处匹配 · 6 个文件
+…
+────────────────────────────────────────
+› 发给 t2
+────────────────────────────────────────
+```
+
+- 正文实时跟随：ama 子 Agent 显示子会话的全部消息与工具调用（与消息区同样的渲染）；子会话句柄已被释放（保留上限 16 个）或会话是 resume 进来的，就只读加载子会话文件，任务再次运行时接上实时事件。外部 Agent（claude / codex / ACP）显示本进程内存里的实时输出（文本、思考、工具起止、回合、提示；最多 2000 条 / 1 MB，不落盘）；ama 重启后只剩一行说明「用原 CLI resume <会话 id> 查看全文」。
+- 输入框为空时：`↑` / PgUp 上翻（暂停跟随，底部提示「已暂停跟随 · End 继续」），`↓` / PgDn 下翻，End（暂停时也可按 `f`）回到跟随；`←` `→` 切到上一个 / 下一个任务；Esc 返回主界面。输入框有字时 Esc 先清空。
+- Enter 把输入发给这个子 Agent（会话里记为 `origin: "direct"` 的 user 消息，见 [session-format.md](session-format.md)）：ama 子 Agent 运行中 → 排到它本轮结束时送达；外部 Agent 运行中或任务还在排队 → 等本次运行结束后续聊；已结束 → 后台续聊（同 `task_ctl send`，完成后主会话照常收到 `<task-notification>`）。底部一行提示发送结果。父会话的模型不知道你直接和子 Agent 说过话，结果经结束通知自然带回。
+- 视图里不中断任何东西：Esc 只是返回。停止子任务用 `/tasks stop <id>`——在视图输入框里也能用（视图里只认这一条命令）。
+- 正在看的任务等审批时标题显示「等待审批」，审批框照常弹在视图上面（带 `[task:<类型>]` 来源）。
+
 审批框的来源标注：
 
 | 来源                                       | 标题前缀                                  | 正文                                          |
@@ -280,6 +359,54 @@ Plan 模式（Shift+Tab、`/permission plan`、`/plan <目标>`、`--permission-
 
 三种都只有「允许 / 本会话允许同类 / 拒绝」三项（外部 Agent 的「本会话允许」由它自己记住）。Manual 模式下 `task(agent="claude")` 本来要问两次（task 调用一次、首次运行一次）：task 调用的审批框里已写明「以你在 claude CLI 的登录运行（含本会话首次运行确认）」，允许之后紧接着的首次运行确认自动通过，消息区一行「已允许 task（随上一次确认）」；中间夹了别的审批、拒绝、超过 60 秒，或不是这次调用建立的任务，首次运行确认照常弹出。
 
+## 轨迹
+
+`/trace` 打开当前会话的轨迹：按回合 → 请求 → 工具 → 子调用 / 子 Agent 分层，每行显示耗时、token 与缓存命中，
+看清一次回答慢在哪里（首 token、解码、工具、审批、重试、压缩）。`/trace t2` 直接看任务 t2：ama 子 Agent 显示它
+自己的子轨迹，外部 Agent（claude / codex …）只有回合骨架（种类、状态、时间与计数，没有命令行与路径）。
+
+覆盖层在主屏底部、高 `行数 − 1`，退出后消息区不变：
+
+```text
+轨迹 · 1 回合 · 2 请求 · 3 次工具 · 12s · ↑8.1k ↓240 · 缓存 70% · ttft p50 0.8s / p90 0.9s · 120 tok/s
+ ▾ #1 跑测试并找出 TODO                                    12s ▕██░░░░░░░▒██▏ ↑8.1k ↓240     70%
+   ▾ 请求 claude-sonnet-4-5 · ttft 0.8s · 167 tok/s       1.7s ▕██░░░░░░░░  ▏ ↑3.9k ↓150     46%
+       bash pnpm test                                     8.0s ▕ ░░░░░░░░░  ▏
+       grep TODO                                          0.3s ▕ ░░         ▏
+       ⛔ write notes.md                                  2.2s ▕ ░░░░       ▏
+›    请求 claude-sonnet-4-5 · ttft 0.9s · 82 tok/s        2.0s ▕         ▒██▏ ↑4.2k ↓90      93%
+↑↓ 移动 · → 展开 · ← 折叠 · Enter 详情 · f 跟随 · Esc 关闭
+```
+
+- **条形**是所在回合的相对时间轴：`▒` 首 token 等待（TTFT）、`█` 解码、`░` 工具；进行中的节点只画起点 `│`，不编造时长。
+  ASCII（`ui.ascii` / `AMA_ASCII=1`）或无色（`NO_COLOR`）时降级为 `[==..--]`（`.` TTFT、`=` 解码、`-` 工具、`|` 起点）。
+- **列**：↑ 是提示 token（含缓存读写），↓ 是输出 token，百分比是缓存命中（缓存读 / 提示 token）。宽 < 60 列只留标签与耗时，40 列可用。
+- **记号**：`✗` 失败、`⛔` 被拒、`↻` 被重试掉的请求、`!` 中断或未完成、`·` 进行中；耗时前的 `≈`（ASCII `~`）表示**推算**——
+  0.6 之前的会话没有计时记录，按条目时间估出，首 token 与吞吐不显示，汇总的 ttft 分位只用精确值。
+- **按键**：`↑↓` / `PgUp` `PgDn` / `Home` `End` 移动；`→` 展开（子 Agent 展开时读它的子会话）或进到第一个子行，`←` 折叠或回到父行；
+  `Enter` 详情卡片（类型、状态、开始时刻、耗时、模型与尝试次数、回退来源、TTFT、吞吐、token 与缓存、费用、审批等待；回合的提示、
+  请求的回复文字、工具参数（截到 500 字符）与结果（截到 2000 字符）），卡片里 `↑↓` 滚动、`Esc` / `Enter` 返回；`f` 跟随开关；
+  `Esc` 先关详情再关视图。
+- **长会话**：先显示最后 50 个回合，顶部一行「更早的 N 个回合」上按 `Enter`（或在第一行继续按 `↑`）再往前加载 50 个；只渲染可见行。
+- **运行中**：轨迹随会话事件刷新（最多每秒 2 次）；有进行中的节点时自动跟随最新一行，手动上移即暂停（标题右侧显示「已暂停跟随」），
+  `End` 或 `f` 恢复。
+- 保温与权限分类等辅助请求收在末尾「辅助请求 N 次」一组，缺省折叠。
+- line 模式（`--ui line`、管道）里 `/trace [任务 id]` 打印同一棵树的文本（全部展开、不画条形）。
+
+计时来自会话文件里的 `custom{customType:"ama.trace"}` 条目（[session-format.md](session-format.md)），只有 id、时间与计数；
+提示、参数、结果的预览从会话条目按需读取，不进轨迹本身。
+
+## Memory
+
+需开启记忆（`ama memory enable` 或 `--memory`，见 [memory.md](memory.md)）。`/memory` 在消息区画一张卡片：每个作用域一段
+（`用户 /memories/user/ · N 条 · 索引 X / 4.0 KiB`），条目一行「名字 — 说明 更新于 日期」，超过 90 天未更新的标灰；
+索引超出上限时多一行黄字说明有几条没进系统提示；项目未受信任、本会话禁止写入时卡片底部各提示一行。
+
+`/memory show <名字>` 把正文画成卡片；`/memory edit [名字|作用域]` 挂起界面打开 `$VISUAL` / `$EDITOR`（编辑临时副本，
+保存退出后存回并重建索引，凭据与上限检查同模型写入）；`/memory rm <名字>` 弹确认框（缺省选中「取消」，`y` 删除、`n` / Esc 取消）；
+`/memory on|off` 切本会话写开关；`/memory reload` 重渲染系统提示的 `memory` 节（提示会断一次缓存）。行式界面同一套命令输出文本，
+`edit` 改用 `ama memory edit`，`rm` 需加 `--yes`。会话未开启记忆时只提示如何开启。
+
 ## 剪贴板图片
 
 `Ctrl+V` 或 `/paste` 读系统剪贴板里的图片（macOS `osascript` / `pngpaste`，Linux `wl-paste` / `xclip`，Windows PowerShell），存为 `<数据目录>/clipboard/<时间>.png`，在输入框光标处插入 `@<路径>`，发送时按 `@图片` 附件处理（超过当前模型的单图上限时按 `images.resize` 缩放）。没有可用命令或剪贴板里没有图片时底部提示一行，输入框不变。文字仍用终端自己的粘贴（Cmd+V / Ctrl+Shift+V）。`ama sessions prune` 清理 7 天前的剪贴板文件。
@@ -313,6 +440,47 @@ Plan 模式（Shift+Tab、`/permission plan`、`/plan <目标>`、`--permission-
 - **字符错位**：`⏺`（U+23FA）、`⎿`、`▎` 在个别字体（尤其 emoji 回退字体）下画成两格，宽度计算按 wcwidth（一格），会出现列错位或残影——换等宽字体或设 `AMA_ASCII=1`。
 - **颜色**：`NO_COLOR` 或 `TERM=dumb` 无色；16 色终端按内置表取近，选中行不用底色而用强调色粗体；浅色终端设 `ui.theme: "light"`。
 
+### `/config` 设置面板与 `ama config`
+
+`/config` 打开设置面板（底部覆盖层）：按分组列出约 60 个标量设置，每行「标签 · 生效值 · 生效档 · 来源」。
+
+```text
+▎ 设置  写入：用户级 ~/.config/ama/config.json  [Tab 切换]
+▎ / 搜索
+▎ 界面
+▎ › 主题                      light             重启             来源 user
+▎   Markdown 渲染             true              即时
+▎ 权限
+▎   权限模式                  plan              即时             [锁定] project
+▎ ────────────────────────────────────────────────────────────
+▎ 配色主题：dark、light，或 auto（…）
+▎ ↑↓ 选择 · Enter/空格 修改 · / 搜索 · Tab 用户级/项目级 · Backspace 恢复缺省 · Esc 关闭
+```
+
+- **按键**：↑↓ 移动；Enter / 空格：布尔取反、≤ 4 项的枚举循环、更长的枚举（思考强度、权限模式等）与模型开选择器、数字和文本开行内输入（非法值红字留在框里，Esc 放弃）；`/` 搜索键名、标签、枚举值与说明，Esc 先清搜索再关闭；Backspace / Delete 按两次 = 删掉写入层里的这一项（回到下层的值）。
+- **写入层**：缺省写用户级 `~/.config/ama/config.json`；Tab 切到项目级 `.ama/config.json`，只许收紧（与合并规则同一判定），只认用户级的项变灰、Enter 给出原因。改动**立即写盘**（写前重读文件、只改这一项、校验、留 `.bak`），没有「保存」按钮；没有文件锁，与 `ama config edit` 同时改时后写者覆盖这一项。手排的格式会被规整成 2 空格缩进。
+- **来源与锁定**：来源是 default / user / profile / project / cli / env；被更上层覆盖的项（profile、项目级、命令行参数、`AMA_CACHE_WARMING` 等环境变量）标 `[锁定]`，说明行写出原因，不让改。嵌入宿主（有 profile）时标题提示「写入用户级配置」。
+- **生效档**：「即时」项当场作用于本会话与界面（主题以外的 `ui` 显示项、`defaultModel`、`thinkingLevel`、`permission.mode`、`compaction.enabled`、`retry.enabled`、`cache.warming`）；「新会话」项在 `/new` / `/resume` 后生效；「重启」项（工具预设、codemode、沙箱、`ui.theme`、`ui.ascii`、`ui.language` 等）下次启动生效。面板 = 持久化，`/model` `/thinking` `/permission` `/statusline` 仍只改本会话。
+- **缓存**：标「动缓存」的项会改变缓存前缀；对话已有回复时第一次改这类项，面板底部提示一次「下一次请求按未命中计费」。
+- 面板里把 `permission.mode` 设为 `full-auto` 会先弹 Bypass 确认，并说明以后每次启动都生效。
+- 关闭时消息区出一条汇总：「主题：dark → light（用户级）」，需重启 / 新会话生效的项另列一行；没改动不出。
+- 列表、对象类的键不在面板里，最后一组「在别处修改」给出入口（`ama providers`、`/permissions`、`ama config edit`、`--json-value` 等）。
+
+`/config key=value`（或 `/config key value`）不开面板，直接写用户级一项，回显与命令行相同；line 模式同样可用，无参数时列出全部设置。
+
+命令行（与面板共用编辑核心）：
+
+```text
+ama config get <key> [--json]                              生效值、来源、生效档
+ama config set <key> <value> [--project] [--json-value] [--yes]
+ama config unset <key> [--project]
+ama config list [前缀] [--json] [--all]                    缺省只列面板里的设置
+```
+
+值按类型解析：`true/false/on/off/1/0`、数字（可写 `30_000`）、枚举不分大小写、`none` / `unset` = 删除；列表与对象用 `--json-value`（如 `ama config set tools.disabled '["bash"]' --json-value`）。未知键、非法值、项目级放宽被拒都退出码 3，文件不动；`get` / `list` 不会创建配置目录。`ama config set permission.mode full-auto` 在终端里先确认，非终端需要 `--yes`。
+
+可选 `ui.replyLanguage`（如 `Chinese`）：会话开始在系统提示 `rules` 节末尾追加一句英文规则 `Reply to the user in Chinese.`，不设时请求零字节变化；只认用户级 / profile。
+
 ## 组件库（`@armadra/agent/tui`）
 
 交互模式用的终端组件单独导出，零依赖，宿主或其它 Node 程序可以直接用来画主屏界面。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@armadra/agent",
-  "version": "0.5.0",
-  "description": "可独立使用、可嵌入 Armadra 的编码 / 协调 Agent",
+  "version": "0.6.0",
+  "description": "A coding and coordination agent that runs standalone or embedded in Armadra",
   "type": "module",
   "keywords": [
     "coding-agent",
@@ -73,7 +73,11 @@
     "docs/tui-design.md",
     "docs/session-format.md",
     "docs/sessions.md",
+    "docs/memory.md",
+    "docs/en/*.md",
+    "README.zh-CN.md",
     "CHANGELOG.md",
+    "CHANGELOG.zh-CN.md",
     "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": [
@@ -99,10 +103,11 @@
     "fmt": "prettier --write .",
     "fmt:check": "prettier --check .",
     "check:deps": "node scripts/check-no-deps.mjs",
+    "check:i18n": "node scripts/check-i18n.mjs",
     "release:check": "node scripts/release-check.mjs",
     "bench:presets": "node scripts/bench-presets.mjs",
     "bench:cache": "node scripts/cache-experiment.mjs",
-    "ci": "pnpm typecheck && pnpm fmt:check && pnpm check:deps && pnpm release:check && pnpm test && pnpm build && node dist/bundle/ama.cjs --version"
+    "ci": "pnpm typecheck && pnpm fmt:check && pnpm check:deps && pnpm check:i18n && pnpm release:check && pnpm test && pnpm build && node dist/bundle/ama.cjs --version"
   },
   "dependencies": {},
   "devDependencies": {