comate-cli 0.12.6b2__tar.gz → 0.12.7b1__tar.gz

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/CHANGELOG.md

@@ -4,7 +4,10 @@
 
 ### Added
 
+- `--disallowed-tools <names>` 启动参数：本次会话不把这些 tool 发给模型，子 agent 也拿不到（进入 SDK 的 `AgentConfig.disallowed_tools`）。名字逗号分隔，参数可重复，结果按出现顺序合并去重；只认精确名字，MCP tool 写 `mcp__<server>__<tool>`。TUI、`resume`、`--rpc-stdio`、`--rpc-ws`、`--rpc-relay` 都生效（RPC 下对整个进程生效）；`-p` 下与它自带的 `SendMessage` 取并集。以下情况都在启动前报错退出：值为空、含 `*`、写了 `Agent` 或 `Skill`（这两个去掉后会话无法创建）、内置名拼错或大小写不对（`mcp__` 开头的名字不检查，MCP 在启动后才连接）。`comate mcp serve` 不支持。
+- 运行中的 Bash 显示 Live Output Tail：模型调用的 Bash 运行时，底部 running-tool 面板每秒读取一次最近输出，在签名行与 Running 状态行之间显示最多 3 个非空行（第一行带 `⎿`），`\r` 覆写的进度条只显示最后一段；`!` 命令活动区从 5 行改为 3 行。两处共用同一套行处理：丢空行、长行按显示宽度截断加 `…` 不折行（中文 / emoji 占 2 列）。命令结束、ctrl+b 转后台或中断后尾部立即消失，不进滚动区；折叠的 Bash 与子 agent 的 Bash 不受影响。
 - Interpreter Migration（macOS/Linux）：CLI 不在 Python 3.12 上、并且没有待更新的新版本时，第一次启动在界面之前显示一行提示，之后的启动显示全屏提示，只有「立即迁移」和「跳过」。「立即迁移」把**当前版本**（`<包名>==<当前版本>`，带发行版的安装参数）用 `--python 3.12` 重装，成功后提示重启，本次启动停止；失败只显示一行原因（uv 输出的最后一行），继续在当前 Python 上进入界面。「跳过」不记住，下次启动再问。已经在 3.12、editable 安装、PATH 里没有 uv、Windows 都不提示；有待更新的新版本时只显示更新提示（接受更新会顺带迁移到 3.12）。文案四种语言齐全。
+- 白牌 Python 下载镜像：发行版 profile 的 `UpdateSource` 新增可选字段 `python_install_mirror`。设置后，CLI 运行的 uv 安装命令（macOS/Linux 的 Self-Update 与 Interpreter Migration、Windows 旁装）在子进程环境里设 `UV_PYTHON_INSTALL_MIRROR` 为这个值，不看 locale，并且盖过简中用户的 npmmirror；用户自己设置的 `UV_PYTHON_INSTALL_MIRROR` 仍然优先。Windows 降级给出手动命令时，命令上方多出 PowerShell 与 CMD 两种设置镜像的写法，命令本身不变；文案四种语言齐全。公网 comate 不设置这个字段，行为不变（ADR 0056）。
 - Event loop 冻结看门狗：界面动画 / 计时停住超过 2 秒时，独立线程把主线程当时的调用栈连同最近的首轮阶段名、busy / staging / 动画状态写进 `~/.comate/logs/agent.log`（WARNING），同一次冻结在 2 秒、5 秒、15 秒各记一次；默认开启，设 `COMATE_TUI_LOOP_WATCHDOG=0` 关闭。原有的「TUI event loop lag detected」日志现在带阶段名，且空闲态（无请求、无动画）的停顿超过 2 秒也记一条 INFO，不再静默（阈值 `AGENT_SDK_TUI_EVENT_LOOP_IDLE_LAG_THRESHOLD_S`）。此前冻结日志只能说明停了多久，说不出停在哪，多次 3–37 秒冻结因此无法归因。
 - 思考时长：隐藏 thinking 时，一段思考正常结束后，loading 行括号里的呼吸黄 badge 换成静态暗灰的时长短语，显示 3 秒后消失。短语与 badge 逐档对应：`thought for 8s with high effort`（max / xhigh / high 同句式）、`ultra thought for 8s`、`thought for 8s`（medium / 无生效档）、`thought briefly for 8s`（low）；60 秒及以上显示 `1m 5s`。不足 1 秒、中断、stream 重试、思考中途打开 thinking 显示、turn 结束时都不显示。固定英文，不随界面语言变化；不写 scrollback。
 - MCP 工具搜索（SDK）：MCP 工具很多时，工具 schema 改为按需加载——模型先只看到工具名清单，需要时调用内置 `ToolSearch` 加载，下一步才能调用该工具。默认 `auto`（延迟候选 schema ≥ 生效窗口 10% 且数量 ≥ 30 时启用），可用环境变量 `COMATE_AGENT_SDK_TOOL_SEARCH`（`auto` / `auto:P` / `auto:P:C` / `on` / `off`）调整。首次启用时终端提示一次；`/context` 拆分显示 MCP 工具与已加载 / 延迟候选数；单个 MCP 工具定义超过窗口 5% 时启动后警告。comate-cli 与 comate-rpc 的 `comate-agent-sdk` 下限抬到 0.12.20（SDK 同步升版，新事件 `ToolSearchEnabledEvent`）。
@@ -72,6 +75,7 @@
 
 ### Changed
 
+- 状态栏的 Job Indicator 只统计正在运行的后台 job：后台 subagent 跑完一轮进入待命（idle）后，不再显示 `x agent`；1 个运行中、2 个待命时显示 `1 agent`。待命的 agent 仍可在 `/ps` 里查看和停止，退出确认仍会提示它们（ADR 0050 补充）。
 - Self-Update 固定到 Python 3.12：`comate update`、启动时的「立即更新」、Windows 旁装，以及 Windows 自动路径不可用时显示的手动修复命令，都让新版本装在 Python 3.12 上（uv 命令带 `--python 3.12`；机器上没有 3.12 时 uv 会自动下载）。原因：uv 在读包之前就选好解释器，并且忽略 `requires-python` 的上限，所以以前用户会跑在 3.11 / 3.13 / 3.14 等不同版本上，而且不带 `--python` 的重装会把已经在 3.12 上的环境换成别的版本。白牌发行版在 `install_args` 里自己指定了 `--python` 时，以白牌的为准。`requires-python` 不变，3.11–3.13 继续支持。决策见 ADR 0055。
 - 简中用户更新时，uv 需要下载的 Python 改走国内镜像（npmmirror 的 python-build-standalone），不再依赖 GitHub；进程内重装和 Windows 旁装都生效。你自己设置了 `UV_PYTHON_INSTALL_MIRROR` 时以你的为准；其他语言环境不变。
 - resume 选择器的预览键由 Ctrl+V 改为 Ctrl+A：VS Code、Windows Terminal 等终端把 Ctrl+V 截成粘贴，按下后剪贴板文本会落进搜索框，进不了预览。搜索模式下也可以按 Ctrl+A 预览，Esc 或再按 Ctrl+A 关闭后回到搜索框，搜索词保持不变；代价是搜索框内 Ctrl+A 不再移到行首。
@@ -96,8 +100,43 @@
   以及设计稿 docs/superpowers/specs/2026-05-18-auto-compact-awareness-design.md
   已写的写法对齐，少占两列宽。
 
+### Removed
+
+- Interpreter Migration（macOS/Linux）：启动时不再提示把当前版本迁移到 Python 3.12。不在 3.12 上的用户继续在当前 Python 上运行，下一次 Self-Update 时装到 3.12（Self-Update 仍然带 `--python 3.12`，ADR 0055）。以前写进设置的 `migration_hinted_python` 不再读取，留在文件里不影响任何行为。
+
 ### Fixed
 
+- 输入框里 `@` 一个图片文件后不再变成 `[Pasted image #N: 文件名]`：路径落在 `@` 引用里时（补全、手打、
+  粘贴都算）保持 `@path` 文本，和其他 `@文件` 一样只给模型路径提示，模型需要时自己用 Read 看图。
+  前面没有 `@` 的粘贴 / 拖入图片路径仍然变成图片 chip；`@a.png /tmp/b.png` 这样的混合粘贴整段保持文本。
+- `@path` 路径提示（SDK）按 Read 工具的分类输出：图片显示 `image (.png, 120 KB)`，PDF 显示
+  `pdf (.pdf, 2.1 MB)`，二进制文件显示 `binary (.zip, 3.2 MB)`，不再给这些文件数「行数」
+  （此前 png 会显示成 `file (.png, 464 lines)`）。二进制判断和 Read 用同一份规则（后缀黑名单 + 前 8 KB
+  内容扫描，带文本 BOM 的不算），规则从 Read 工具内部移到 `system_tools/text_codec.py`，Read 行为不变。
+- 模型回复的正文末尾带多个换行时（常见于调用工具之前），scrollback 中正文和下一行之间不再出现长空白：
+  显示层丢掉正文段末尾的空行，正文中间连续的多个空行只显示 1 个；代码块内的空行原样保留。
+  只改显示，transcript 与发给模型的上下文中的原文不变。
+- git 不在 PATH 时，SDK 采集 GIT_ENV 发出的 WARNING「未找到 git 可执行文件，无法采集 GIT_ENV」不再刷进
+  TUI scrollhistory：终端用户看到也无法在会话里行动（装 git / 修 PATH 都在会话外）。文件日志
+  （`~/.comate/logs/agent.log`）与其它宿主不受影响；同一来源的「执行 git 命令失败」ERROR 是未预期异常，
+  仍然显示。
+- 装了带 `.mcp.json` 的插件后，TUI 会话丢失全部用户 MCP server：启动注入插件时，插件 server 被写进
+  `AgentConfig.mcp_servers`，legacy 解析模式下这等于「只用这些 server」，user / project / local 三层
+  `.mcp.json` 全部失效；随后的重新加载关闭了已连上的 server，移除了它们的工具，`/mcp` 里显示
+  `Not initialized`。`-p` 与 `comate mcp list` 不加载插件，不受影响。现在 CLI 使用 merge 解析模式，
+  插件 server 写进 plugin 层，叠加在磁盘三层之下（同名时磁盘优先）；`/reload-plugins` 只移除插件 server。
+  没有插件时解析结果不变（ADR 0057）。
+- 插件 `.mcp.json` 用 Claude Code 生态的 `{"mcpServers": {...}}` 包装格式时（例如 Anthropic 的 `data`
+  插件），解析出一个假 server `<插件名>:mcpServers`（`stdio server 缺少 command`），里面的 server 一个也连不上。
+  现在顶层 `mcpServers` 是对象时读它里面的内容，平铺格式不变，两种都加 `<插件名>:` 前缀。`/mcp` 列表现在
+  也显示插件 server：状态、工具，详情页显示来源插件和插件的 `.mcp.json` 路径。插件 server 可以在 `/mcp`
+  里 Disable：在 `~/.agent/.mcp.json` 写一条同名 `{"enabled": false}`，重启后仍然禁用，插件本身和其他
+  server 不受影响；Enable 删除这一条（插件已卸载后留下的这一条也能在 `/mcp` 里 Enable 清掉）。插件 server 的单个工具开关仍为只读。新文案三语齐全。
+- 插件 `plugin.json` 里写的 `mcpServers` 以前被悄悄忽略，现在生效：可以是内联对象，也可以是相对插件根目录的
+  JSON 文件路径（字符串或字符串数组，文件格式同 `.mcp.json`），和插件的 `.mcp.json` 合并，都加 `<插件名>:`
+  前缀；同名时 `.mcp.json` 优先并在日志里打 WARNING。路径超出插件根目录、文件读不了、值类型不对时打 WARNING
+  跳过这一项，插件其他内容照常加载；插件 MCP 配置文件顶层不是 JSON 对象时也改为跳过，不再让整个插件加载失败。
+  `/mcp` 详情页对这些 server 仍显示插件 `.mcp.json` 路径（待修）。
 - 切换窗口后运行中的任务被中断、输入框多出 `[O[I`：终端开着焦点上报（DECSET 1004，
   例如 Windows PowerShell 经 ssh 连到远程服务器）时，窗口失焦 / 得焦会发 `ESC[O` / `ESC[I`。
   prompt_toolkit 不认识这两条序列，把它们拆成 Esc 加两个普通字符，Esc 就中断了本轮。

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/CONTEXT.md

@@ -13,7 +13,7 @@ _Avoid_: menu output（菜单输出）, history block（历史块）, 全屏 pic
 _Avoid_: footer（Menu Panel 自己有页脚）, bottom toolbar（prompt_toolkit 的术语，本项目不使用）, 补全状态行（与 Status Bar 共用同一个位置，但是另一个东西）
 
 **Job Indicator（后台任务指示）**:
-Status Bar 左列里按类别显示的后台 job 数量，例如 `2 agents`、`1 shell`、`1 workflow`、`1 MCP call`。类别：agents（agent job）、shells（bash 与 monitor job）、workflows（workflow job）、mcp（MCP 后台调用）。只统计仍在运行或待命的 job；数量为 0 的类别不显示。选中一个 Job Indicator 并确认，会打开该类别的菜单。它取代了输入框上方常驻的 jobs 面板。
+Status Bar 左列里按类别显示的后台 job 数量，例如 `2 agents`、`1 shell`、`1 workflow`、`1 MCP call`。类别：agents（agent job）、shells（bash 与 monitor job）、workflows（workflow job）、mcp（MCP 后台调用）。只统计仍在运行的 job，待命（idle）的 job 不计（它们仍在 Jobs Menu 里）；数量为 0 的类别不显示。选中一个 Job Indicator 并确认，会打开该类别的菜单。它取代了输入框上方常驻的 jobs 面板。
 _Avoid_: pill（口头说法）, jobs 面板（已删除的旧区域）, 后台任务栏
 
 **Jobs Menu（后台任务菜单）**:
@@ -224,10 +224,6 @@ _Avoid_: symlink swap, shim update, rename dance
 The rule that a completed Self-Update takes effect only for processes started afterwards. Running sessions keep their version until they exit.
 _Avoid_: hot upgrade, live upgrade
 
-**Interpreter Migration**:
-Reinstalling the *same* installed CLI version onto the target Python runtime (3.12, ADR 0055), offered at launch on macOS/Linux when the CLI runs on another interpreter and no newer version is pending. It is not a Self-Update (the version does not change), but it obeys Restart-to-Apply and reuses the in-process reinstall path. It always needs the user's confirmation in the launch prompt, because rebuilding the tool environment can break other running sessions.
-_Avoid_: runtime upgrade, Python update, re-pin
-
 ## Tool Result Display Language
 
 **Tool Result Preview**:
@@ -334,6 +330,10 @@ _Avoid_: todo panel, tasklist (spoken shorthand only)
 A state in which the run is alive but does not advance any task: context compaction in progress, or an LLM retry backoff countdown. Only the countdown counts as Stall Status; the retried request itself does not.
 _Avoid_: blocking status ("blocking" in this repo means blocking the event loop), waiting state
 
+**Live Output Tail**:
+The last 3 non-empty lines of a running foreground shell command's output, shown under that command in the bottom interaction band and refreshed once per second. It applies to the user's `!` commands and to the main agent's Bash calls that show a `Running…` line; folded Bash calls and subagent Bash calls have none. It is transient: it never enters scrollback, the transcript, or the model's context, and it disappears when the command ends or moves to the background.
+_Avoid_: staging (that is the stream staging window), live log, output streaming
+
 ## Event Loop Health Language
 
 **Event Loop Lag**:
@@ -389,7 +389,7 @@ _Avoid_: lag log, profiler output (the profiler records phase durations, not a s
 - **Self-Update** and **Plugin Auto Update** are separate concepts with separate vocabularies: a **Version Check** orders versions, plugin **Update Detection** only compares for equality. Neither triggers the other.
 - A **Side-Install** followed by an **Entrypoint Flip** is one Self-Update strategy; an in-process reinstall of the current installation is another. Which one applies is a property of the platform, not of the user's choice.
 - **Restart-to-Apply** holds for every Self-Update strategy and mirrors the plugin **Update Effectiveness Boundary**: on-disk state changes, the running process does not.
-- **Interpreter Migration** and **Self-Update** both rebuild the installation on the target Python, but only a Self-Update changes the version. A pending Self-Update takes priority: accepting it completes the migration as a side effect, so the launch never offers both before the TUI starts. (The background Version Check can still add an update hint inside the TUI after a migration hint or prompt; the next launch then offers only the update.) Windows has no Interpreter Migration (a Side-Install of the same version is treated as already staged); Windows users reach the target Python through their next Self-Update.
+- **Self-Update** is the only way an installation reaches the target Python (3.12, ADR 0055). A CLI that runs on another interpreter stays there until its next Self-Update.
 
 - A **Session Title** is a fact of the session, not of the **Session Report**: it exists whether or not a report backend is configured, and the report only mirrors it. **Durable Title Completion** is therefore judged from the session's own metadata.
 - A **Session Title** is generated from the session's earliest **Committed Title Input**, never from the latest one. A resumed session without a title is titled from its original first input, so the title does not change to whatever was typed after resume.
@@ -416,6 +416,8 @@ _Avoid_: lag log, profiler output (the profiler records phase durations, not a s
 
 ## Flagged ambiguities
 
+- "staging" 只指 stream staging window（模型正文提交到 scrollback 之前的暂存区）。运行中工具下面的 `Running…` 区域不叫 staging；那里显示的 shell 输出尾部叫 **Live Output Tail**。
+
 - 代码里的 `_menu_panel_active()` 实际含义是“使用共享 `MenuPanel` 外壳”，不含 `/statusline`、marketplace 安装、`/goal edit`，因此与本术语表的 **Menu Panel**（slash 命令打开的暂态操作界面）并不等价。判断 **Status Bar** 是否隐藏另用独立集合，不复用它。
 
 - OpenWorker still shows `HIGH` as **Max** (ADR-0017/0019); the agreed family-wide name is **Elite** (ADR-0023). Until OpenWorker is updated, the same Provider-Pool Level has two display names across products.

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comate-cli
-Version: 0.12.6b2
+Version: 0.12.7b1
 Summary: Comate terminal CLI built on comate-agent-sdk
 Project-URL: Homepage, https://github.com/AndyLee1024/agent-sdk
 Project-URL: Repository, https://github.com/AndyLee1024/agent-sdk
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <3.14,>=3.11
 Requires-Dist: charset-normalizer==3.4.7
-Requires-Dist: comate-agent-sdk<0.13,>=0.12.23
+Requires-Dist: comate-agent-sdk<0.13,>=0.12.24
 Requires-Dist: comate-rpc<0.2,>=0.1.4
 Requires-Dist: concurrent-log-handler>=0.9.25
 Requires-Dist: curl-cffi==0.13.0
@@ -23,6 +23,7 @@ Requires-Dist: httpx<0.29.0,>=0.28.1
 Requires-Dist: packaging>=21.0
 Requires-Dist: pillow==12.2.0
 Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: pygments>=2.19
 Requires-Dist: requests==2.32.5
 Requires-Dist: rich>=14.0
 Requires-Dist: setproctitle>=1.3.7
@@ -45,6 +46,33 @@ uv tool install comate-cli
 comate
 ```
 
+### 简体中文用户
+
+Python 解释器从 npmmirror 下载，包从清华 PyPI 镜像下载，运行时固定为 Python 3.12（ADR 0055）。
+
+macOS / Linux（bash、zsh）：
+
+```bash
+UV_PYTHON_INSTALL_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone \
+  uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+Windows PowerShell（两行在同一个窗口里运行）：
+
+```powershell
+$env:UV_PYTHON_INSTALL_MIRROR="https://registry.npmmirror.com/-/binary/python-build-standalone"
+uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+Windows CMD（两行在同一个窗口里运行）：
+
+```bat
+set "UV_PYTHON_INSTALL_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone"
+uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+清华镜像同步 PyPI 有延迟。新版本刚发布时，如果清华上还没有，去掉 `--default-index ...` 直接从官方 PyPI 安装即可，Python 仍走 npmmirror。
+
 ## 内置 Marketplace 扩展
 
 发行版可通过 `DistributionProfile.builtin_marketplaces` 提供

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/README.md

@@ -15,6 +15,33 @@ uv tool install comate-cli
 comate
 ```
 
+### 简体中文用户
+
+Python 解释器从 npmmirror 下载，包从清华 PyPI 镜像下载，运行时固定为 Python 3.12（ADR 0055）。
+
+macOS / Linux（bash、zsh）：
+
+```bash
+UV_PYTHON_INSTALL_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone \
+  uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+Windows PowerShell（两行在同一个窗口里运行）：
+
+```powershell
+$env:UV_PYTHON_INSTALL_MIRROR="https://registry.npmmirror.com/-/binary/python-build-standalone"
+uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+Windows CMD（两行在同一个窗口里运行）：
+
+```bat
+set "UV_PYTHON_INSTALL_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone"
+uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+清华镜像同步 PyPI 有延迟。新版本刚发布时，如果清华上还没有，去掉 `--default-index ...` 直接从官方 PyPI 安装即可，Python 仍走 npmmirror。
+
 ## 内置 Marketplace 扩展
 
 发行版可通过 `DistributionProfile.builtin_marketplaces` 提供

comate_cli-0.12.7b1/bash_settle_diag.log

@@ -0,0 +1,41 @@
+2026-11-02 12:52:02,880 platform=Linux-7.0.0-30-generic-x86_64-with-glibc2.43 python=3.13.18 psutil=7.2.2
+2026-11-02 12:52:02,880 bash=/bin/bash cwd=/tmp/claude-1000/-home-andy-works-agent-sdk/81e18132-c517-4c2e-a0a5-45ee51dd802e/scratchpad output_dir=/tmp/claude-1000/-home-andy-works-agent-sdk/81e18132-c517-4c2e-a0a5-45ee51dd802e/scratchpad/.agent/artifacts/bash runs=1
+2026-11-02 12:52:02,881 process count=393
+2026-11-02 12:52:02,881 step 列：loop = 在 event loop 线程同步执行（生产现状）；thread = 在 daemon 线程执行（候选修法）
+2026-11-02 12:52:02,911 run=1 loop    script mkstemp+write+close         duration_ms=      0.1 loop_max_gap_ms=    10.3 result=.tmp_bash_script_s89rx0gd.sh
+2026-11-02 12:52:02,943 run=1 loop    output mkstemp                     duration_ms=      0.1 loop_max_gap_ms=    10.3 result=.tmp_bash_pt593nyv.txt
+2026-11-02 12:52:02,973 run=1 loop    cwd mkstemp                        duration_ms=      0.1 loop_max_gap_ms=    10.2 result=.tmp_bash_cwd_zr16nfyp.txt
+2026-11-02 12:52:02,996 run=1 thread  command run (spawn+exit, thread)   duration_ms=     21.9 loop_max_gap_ms=    11.6 result=exit=0 pump_alive=False
+2026-11-02 12:52:03,027 run=1 loop    exited root: psutil.Process(pid)   duration_ms=      0.3 loop_max_gap_ms=    10.3 NoSuchProcess: process PID not found (pid=96922)
+2026-11-02 12:52:03,059 run=1 loop    exited root: children(recursive=True) duration_ms=      0.0 loop_max_gap_ms=    10.4 result=skipped: root process already gone
+2026-11-02 12:52:03,090 run=1 loop    exited root: kill()                duration_ms=      0.0 loop_max_gap_ms=    10.4 result=skipped: root process already gone
+2026-11-02 12:52:03,141 run=1 loop    exited root: _ppid_map()           duration_ms=     19.3 loop_max_gap_ms=    19.3 result=dict[393]
+2026-11-02 12:52:03,195 run=1 thread  exited root: psutil.Process(pid)   duration_ms=      0.3 loop_max_gap_ms=    10.3 NoSuchProcess: process PID not found (pid=96927)
+2026-11-02 12:52:03,227 run=1 thread  exited root: children(recursive=True) duration_ms=      0.4 loop_max_gap_ms=    10.6 result=skipped: root process already gone
+2026-11-02 12:52:03,259 run=1 thread  exited root: kill()                duration_ms=      0.8 loop_max_gap_ms=    10.6 result=skipped: root process already gone
+2026-11-02 12:52:03,310 run=1 thread  exited root: _ppid_map()           duration_ms=     19.9 loop_max_gap_ms=    10.5 result=dict[393]
+2026-11-02 12:52:03,645 run=1 loop    live root: psutil.Process(pid)     duration_ms=      0.3 loop_max_gap_ms=    10.4 result=96936
+2026-11-02 12:52:03,684 run=1 loop    live root: children(recursive=True) duration_ms=      7.5 loop_max_gap_ms=    10.4 result=list[0]
+2026-11-02 12:52:03,715 run=1 loop    live root: kill()                  duration_ms=      0.1 loop_max_gap_ms=    10.3 result=1
+2026-11-02 12:52:03,756 run=1 loop    live root: _ppid_map()             duration_ms=      9.1 loop_max_gap_ms=    10.5 result=dict[394]
+2026-11-02 12:52:03,788 run=1 loop    unlink x3                          duration_ms=      0.1 loop_max_gap_ms=    10.3 result=3
+2026-11-02 12:52:03,788 ---- summary (max over 1 runs) ----
+2026-11-02 12:52:03,789 loop    exited root: _ppid_map()                     median_ms=     19.3 max_ms=     19.3 loop_max_gap_ms=    19.3
+2026-11-02 12:52:03,789 thread  command run (spawn+exit, thread)             median_ms=     21.9 max_ms=     21.9 loop_max_gap_ms=    11.6
+2026-11-02 12:52:03,789 thread  exited root: children(recursive=True)        median_ms=      0.4 max_ms=      0.4 loop_max_gap_ms=    10.6
+2026-11-02 12:52:03,789 thread  exited root: kill()                          median_ms=      0.8 max_ms=      0.8 loop_max_gap_ms=    10.6
+2026-11-02 12:52:03,789 thread  exited root: _ppid_map()                     median_ms=     19.9 max_ms=     19.9 loop_max_gap_ms=    10.5
+2026-11-02 12:52:03,789 loop    live root: _ppid_map()                       median_ms=      9.1 max_ms=      9.1 loop_max_gap_ms=    10.5
+2026-11-02 12:52:03,790 loop    exited root: children(recursive=True)        median_ms=      0.0 max_ms=      0.0 loop_max_gap_ms=    10.4
+2026-11-02 12:52:03,790 loop    exited root: kill()                          median_ms=      0.0 max_ms=      0.0 loop_max_gap_ms=    10.4
+2026-11-02 12:52:03,790 loop    live root: psutil.Process(pid)               median_ms=      0.3 max_ms=      0.3 loop_max_gap_ms=    10.4
+2026-11-02 12:52:03,790 loop    live root: children(recursive=True)          median_ms=      7.5 max_ms=      7.5 loop_max_gap_ms=    10.4
+2026-11-02 12:52:03,790 loop    script mkstemp+write+close                   median_ms=      0.1 max_ms=      0.1 loop_max_gap_ms=    10.3
+2026-11-02 12:52:03,790 loop    output mkstemp                               median_ms=      0.1 max_ms=      0.1 loop_max_gap_ms=    10.3
+2026-11-02 12:52:03,790 loop    exited root: psutil.Process(pid)             median_ms=      0.3 max_ms=      0.3 loop_max_gap_ms=    10.3
+2026-11-02 12:52:03,790 thread  exited root: psutil.Process(pid)             median_ms=      0.3 max_ms=      0.3 loop_max_gap_ms=    10.3
+2026-11-02 12:52:03,791 loop    live root: kill()                            median_ms=      0.1 max_ms=      0.1 loop_max_gap_ms=    10.3
+2026-11-02 12:52:03,791 loop    unlink x3                                    median_ms=      0.1 max_ms=      0.1 loop_max_gap_ms=    10.3
+2026-11-02 12:52:03,791 loop    cwd mkstemp                                  median_ms=      0.1 max_ms=      0.1 loop_max_gap_ms=    10.2
+2026-11-02 12:52:03,794 log: /home/andy/works/agent-sdk/packages/comate_cli/bash_settle_diag.log
+2026-11-02 12:52:03,794 json: /home/andy/works/agent-sdk/packages/comate_cli/bash_settle_diag.json

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/comate_cli/distribution.py

@@ -38,6 +38,8 @@ class UpdateSource:
     fetch_latest: LatestVersionFetcher
     install_args: tuple[str, ...] = ()
     release_notes_url: str | None = None
+    # Python 下载镜像（UV_PYTHON_INSTALL_MIRROR），盖过简中 locale 的 npmmirror（ADR 0056）。
+    python_install_mirror: str | None = None
 
     def __post_init__(self) -> None:
         if not callable(self.fetch_latest):

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/comate_cli/main.py

@@ -94,9 +94,10 @@ _SYSTEM_PROMPT_OPTIONS: dict[str, str] = {
 }
 
 # (rpc_stdio, resume_session_id, resume_select, print_prompt, output_format, prompt_flags, rpc_relay,
-#  add_dirs, rpc_ws_port, yolo)；rpc_ws_port 为 None 表示不是 --rpc-ws，0 表示由系统挑空闲端口；
+#  disallowed_tools, add_dirs, rpc_ws_port, yolo)；rpc_ws_port 为 None 表示不是 --rpc-ws，0 表示由系统挑空闲端口；
 # rpc_relay 为 None 表示不是 --rpc-relay，否则是（中转地址, Agent 令牌, 是否允许远程切到 bypassPermissions）；
-# prompt_flags 是 system prompt 四个参数的原始值，没给时各字段为 None。
+# prompt_flags 是 system prompt 四个参数的原始值，没给时各字段为 None；
+# disallowed_tools 是 --disallowed-tools 的名字，按出现顺序去重，没给时为空。
 ParsedArgs = tuple[
     bool,
     str | None,
@@ -106,6 +107,7 @@ ParsedArgs = tuple[
     SystemPromptFlags,
     tuple[str, str, bool] | None,
     tuple[str, ...],
+    tuple[str, ...],
     int | None,
     bool,
 ]
@@ -339,6 +341,10 @@ def _usage_text(command_name: str = "comate") -> str:
         "  --add-dir <path>   Grant tool read/write access to an extra directory\n"
         "                     (repeatable). Applies to subagents too."
         "\n"
+        "  --disallowed-tools <names>\n"
+        "                     Remove tools from this session (comma-separated, repeatable).\n"
+        "                     Applies to subagents too. Exact names only, no wildcards;\n"
+        "                     MCP tools are written mcp__<server>__<tool>\n"
         "  --system-prompt <text>\n"
         "                     Replace the opening of the system prompt (who the agent is and\n"
         "                     how it works); guardrail sections always stay\n"
@@ -396,6 +402,35 @@ def _parse_rpc_relay(relay_url: str | None, token_arg: str | None) -> tuple[str,
     return relay_url, token
 
 
+# 不能用 --disallowed-tools 去掉的 tool：SDK 在会话创建时才因它们抛 ValueError
+# （Agent 一定触发，Skill 只要还有模型可调用的 skill 就触发），RPC 模式下要到
+# session.open 才暴露，所以在解析期就拦住。
+_UNREMOVABLE_TOOLS = ("Agent", "Skill")
+
+
+def _split_disallowed_tools(value: str) -> list[str]:
+    """--disallowed-tools 的一个值 → 名字列表：逗号分隔，去首尾空白，丢空项。
+
+    只认精确名字：SDK 对通配符静默不生效，放过去用户会以为已经去掉了。
+    内置名是否存在留给 app._build_agent 检查（那时 SDK 已导入，解析期不多导入）。
+    """
+    names = [name for name in (part.strip() for part in value.split(",")) if name]
+    if not names:
+        from comate_cli.terminal_agent.i18n import i18n, message
+
+        raise _ArgumentError(i18n(message.disallowed_tools_requires_value))
+    for name in names:
+        if "*" in name:
+            from comate_cli.terminal_agent.i18n import i18n, message
+
+            raise _ArgumentError(i18n(message.disallowed_tools_wildcard, name=name))
+        if name in _UNREMOVABLE_TOOLS:
+            from comate_cli.terminal_agent.i18n import i18n, message
+
+            raise _ArgumentError(i18n(message.disallowed_tools_unsupported, name=name))
+    return names
+
+
 def _parse_args(argv: list[str]) -> ParsedArgs:
     rpc_stdio = False
     rpc_ws = False
@@ -411,6 +446,7 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
     output_format_explicit = False
     positionals: list[str] = []
     add_dirs: list[str] = []
+    disallowed_tools: list[str] = []
     prompt_flags: dict[str, PromptFlag] = {}
     yolo = False
 
@@ -493,6 +529,17 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
             add_dirs.append(value)
             index += 1
             continue
+        if arg == "--disallowed-tools" or arg.startswith("--disallowed-tools="):
+            if arg == "--disallowed-tools":
+                index += 1
+                value = argv[index] if index < len(argv) else ""
+            else:
+                value = arg.partition("=")[2]
+            for name in _split_disallowed_tools(value):
+                if name not in disallowed_tools:
+                    disallowed_tools.append(name)
+            index += 1
+            continue
         name, has_value, value = arg.partition("=")
         if name in _SYSTEM_PROMPT_OPTIONS:
             if not has_value:
@@ -567,12 +614,13 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
 
             raise _ArgumentError(i18n(message.rpc_mode_print_conflict, flag=rpc_flag))
         print_prompt = " ".join(positionals) if positionals else ""
-        return rpc_stdio, None, False, print_prompt, output_format, system_prompt_flags, None, tuple(add_dirs), None, yolo
+        return rpc_stdio, None, False, print_prompt, output_format, system_prompt_flags, None, tuple(disallowed_tools), tuple(add_dirs), None, yolo
 
     # Non -p mode: original logic
     if not positionals:
         return (
-            rpc_stdio, None, False, None, output_format, system_prompt_flags, rpc_relay, tuple(add_dirs), rpc_ws_port, yolo
+            rpc_stdio, None, False, None, output_format, system_prompt_flags, rpc_relay, tuple(disallowed_tools),
+            tuple(add_dirs), rpc_ws_port, yolo
         )
 
     command = positionals[0]
@@ -585,10 +633,10 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
         raise _ArgumentError(i18n(message.rpc_mode_resume_unsupported, flag=rpc_flag))
 
     if len(positionals) == 1:
-        return rpc_stdio, None, True, None, output_format, system_prompt_flags, None, tuple(add_dirs), None, yolo
+        return rpc_stdio, None, True, None, output_format, system_prompt_flags, None, tuple(disallowed_tools), tuple(add_dirs), None, yolo
 
     if len(positionals) == 2:
-        return rpc_stdio, positionals[1], False, None, output_format, system_prompt_flags, None, tuple(add_dirs), None, yolo
+        return rpc_stdio, positionals[1], False, None, output_format, system_prompt_flags, None, tuple(disallowed_tools), tuple(add_dirs), None, yolo
 
     raise _ArgumentError("resume accepts at most one <session_id>")
 
@@ -776,6 +824,23 @@ def _build_wellformed_input():
     return inp
 
 
+def _use_utf8_stdout_when_redirected() -> None:
+    """stdout 不是 TTY 时改用 UTF-8 输出（票 tui-plugin-mcp-override/05、07）。
+
+    Windows 上重定向的 stdout 取 locale 编码 cp936/GBK，`mcp list` 的 `✓`/`✗`、
+    `-p` 模式结果里的 emoji 编不出来会崩。调用方：`mcp` 子命令分支、`-p` 分支。
+    agent 的 Bash 工具按 UTF-8 解码子进程输出，所以改 UTF-8 而不只是 errors="replace"。
+    TTY 不动：Windows 控制台本来就走 Unicode 控制台 API（PEP 528）。
+    """
+    stdout = sys.stdout
+    if stdout is None or not hasattr(stdout, "reconfigure"):
+        return
+    isatty = getattr(stdout, "isatty", None)
+    if callable(isatty) and isatty():
+        return
+    stdout.reconfigure(encoding="utf-8", errors="replace")
+
+
 def main(argv: list[str] | None = None, *, profile=None) -> None:
     from comate_cli.distribution import DEFAULT_PROFILE
     from comate_cli.terminal_title import (
@@ -834,6 +899,7 @@ def main(argv: list[str] | None = None, *, profile=None) -> None:
     if run_argv and run_argv[0] == "mcp":
         from comate_cli.mcp_cli import McpCliError, run_mcp_command
 
+        _use_utf8_stdout_when_redirected()
         try:
             run_mcp_command(run_argv[1:], command_name=command_name)
             return
@@ -866,6 +932,7 @@ def main(argv: list[str] | None = None, *, profile=None) -> None:
             print_output_format,
             system_prompt_flags,
             rpc_relay,
+            disallowed_tools,
             add_dirs_raw,
             rpc_ws_port,
             yolo,
@@ -881,6 +948,8 @@ def main(argv: list[str] | None = None, *, profile=None) -> None:
     # Assemble print mode message
     print_message: str | None = None
     if print_prompt is not None:
+        # 票 tui-plugin-mcp-override/07：结果在最后一步才写 stdout，GBK 编不出 emoji 会丢掉整个结果。
+        _use_utf8_stdout_when_redirected()
         stdin_text = _read_stdin_if_ready(sys.stdin)
         parts = [p for p in (stdin_text.strip(), print_prompt.strip()) if p]
         if not parts:
@@ -920,6 +989,7 @@ def main(argv: list[str] | None = None, *, profile=None) -> None:
                         print_message=print_message,
                         print_output_format=print_output_format,
                         add_dirs=add_dirs,
+                        disallowed_tools=disallowed_tools,
                         yolo=yolo,
                         system_prompt_flags=system_prompt_flags,
                         process_start_perf=_PROCESS_START_PERF,

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/comate_cli/terminal_agent/app.py

@@ -106,41 +106,6 @@ async def _handle_update_on_launch(
     return False
 
 
-async def _handle_migration_on_launch(
-    *,
-    target: UpdateTarget,
-    python_version: tuple[int, int] | None = None,
-) -> bool:
-    """Interpreter Migration 的启动前提示（macOS/Linux，纯本地判断）。
-
-    python_version 默认取当前解释器，测试注入。返回 True 表示迁移成功、启动应停止
-    （Restart-to-Apply）。迁移一定要用户在全屏提示里确认：重建 tool 环境可能破坏
-    其他正在运行的会话，所以不做后台静默迁移。
-    """
-    from comate_cli.terminal_agent import update_check
-
-    try:
-        info = update_check.get_pending_migration_info(
-            target=target, python_version=python_version
-        )
-        if info is None:
-            return False
-        if update_check.decide_migration_prompt(info) == update_check.UpdatePromptDecision.SHOW_HINT:
-            console.print(
-                update_check.format_migration_hint(info, target),
-                style="dim",
-                markup=False,
-            )
-            update_check.mark_migration_hinted(info)
-            return False
-        choice = await update_check.show_migration_prompt(info, target)
-        if choice == update_check.MigrationPromptChoice.MIGRATE_NOW:
-            return await update_check.run_migration_command(console, info, target)
-    except Exception:
-        logger.debug("startup interpreter migration prompt failed", exc_info=True)
-    return False
-
-
 async def _handle_background_update_on_launch(
     info: UpdateInfo,
     *,
@@ -773,6 +738,29 @@ def _resolve_prompt_flag(prompt_flag: "PromptFlag | None") -> str | None:
     return content
 
 
+def _exit_on_unknown_disallowed_tools(names: tuple[str, ...] | None) -> None:
+    """--disallowed-tools 的内置名必须精确（区分大小写）匹配 SDK 系统 tool，否则报错退出。
+
+    去掉 tool 是一道限制，拼错就等于没去掉（SDK 对不认识的名字静默不生效），所以 fail fast。
+    按全部系统 tool 比对，不管当前模式下是否可见。mcp__ 开头的不查：MCP 启动后才连接，
+    server 不再提供的名字也是合法状态（ADR 0032）。报错方式同 _resolve_prompt_flag：
+    stderr 按界面语言写一行 + 退出码 2，不出 traceback。
+    """
+    if not names:
+        return
+    # 只在给了名字时导入；Agent 构造本来也会导入它，这里只是提前。
+    from comate_agent_sdk.system_tools.tools import SYSTEM_TOOLS
+
+    known = {tool.name for tool in SYSTEM_TOOLS}
+    unknown = [name for name in names if not name.startswith("mcp__") and name not in known]
+    if not unknown:
+        return
+    from comate_cli.terminal_agent.i18n import i18n, message
+
+    sys.stderr.write(f"{i18n(message.disallowed_tools_unknown, names=', '.join(unknown))}\n")
+    raise SystemExit(2)
+
+
 def _build_agent(
     *,
     project_root: Path | None = None,
@@ -802,6 +790,7 @@ def _build_agent(
     if profiler is not None:
         profiler.mark("agent.config.load.done")
     disallowed_tools = _merge_disallowed_tools(extra_disallowed_tools)
+    _exit_on_unknown_disallowed_tools(disallowed_tools)
 
     if add_dirs:
         logger.info(
@@ -840,6 +829,9 @@ def _build_agent(
         tool_approval_callback=approval_bridge,
         prewarm=prewarm,  # type: ignore[arg-type]
         attribution=attribution,
+        # ADR 0057：插件 MCP server 走 plugin 层叠加在磁盘三层之下。legacy 下任何非空
+        # mcp_servers 都会让磁盘三层整体失效；mcp_servers 保持 None 时 merge 与 legacy 磁盘结果相同。
+        mcp_resolution_mode="merge",
     )
     if profiler is not None:
         profiler.mark("agent.construct.start")
@@ -1297,6 +1289,7 @@ async def run(
     print_message: str | None = None,
     print_output_format: str = "text",
     add_dirs: tuple[Path, ...] = (),
+    disallowed_tools: tuple[str, ...] = (),
     yolo: bool = False,
     system_prompt_flags: "SystemPromptFlags | None" = None,
     process_start_perf: float | None = None,
@@ -1412,9 +1405,6 @@ async def run(
             )
             if should_stop:
                 return
-        # 有待更新版本时它自己不提示（优先级规则在 get_pending_migration_info 里）。
-        if await _handle_migration_on_launch(target=update_target):
-            return
 
     _run_startup_hooks(profile)
     profiler.mark("agent.build.start")
@@ -1449,8 +1439,10 @@ async def run(
         agent = _build_agent(
             project_root=project_root,
             profiler=profiler,
-            extra_disallowed_tools=(
-                PRINT_MODE_DISALLOWED_TOOLS if print_message is not None else None
+            # --disallowed-tools 与 -p 自带的限制取并集，用户参数不能把后者冲掉。
+            extra_disallowed_tools=_merge_disallowed_tools(
+                disallowed_tools,
+                PRINT_MODE_DISALLOWED_TOOLS if print_message is not None else None,
             ),
             add_dirs=add_dirs,
             system_role=profile.system_role,

{comate_cli-0.12.6b2 → comate_cli-0.12.7b1}/comate_cli/terminal_agent/backend/session_report.py

@@ -386,16 +386,33 @@ async def upload_spool_file(
         payload_bytes = await asyncio.to_thread(  # to_thread: bounded-local, one capped report JSON file
             path.read_bytes
         )
+    except FileNotFoundError:
+        # 并发上传方 ack 删除后，drain 可能仍持有这条路径；正常竞争，不是损坏。
+        logger.debug("session report spool already removed by another uploader: %s", path)
+        return True
+    except OSError:
+        # Windows 杀毒/索引/同步盘会短暂锁文件；内容未损坏，留给下次启动的 drain 重试、prune 兜底。
+        logger.warning(
+            "session report spool read failed, will retry on next startup: %s", path
+        )
+        return False
+    try:
         payload = json.loads(payload_bytes)
         if not isinstance(payload, dict):
-            raise ValueError("session report payload must be an object")
+            raise ValueError("payload is not an object")
         session_id = validate_session_id(str(payload.get("session_id", "")))
-    except Exception:
-        logger.warning("discarding invalid session report spool: %s", path)
-        await asyncio.to_thread(  # to_thread: bounded-local, one invalid spool unlink
-            path.unlink,
-            missing_ok=True,
-        )
+    except Exception as exc:
+        logger.warning("discarding invalid session report spool: %s (%s)", path, exc)
+        try:
+            await asyncio.to_thread(  # to_thread: bounded-local, one invalid spool unlink
+                path.unlink,
+                missing_ok=True,
+            )
+        except OSError:
+            # unlink 也可能被文件锁挡住；内容已判无效，留给 prune 兜底删除，不向调用方抛出。
+            logger.warning(
+                "session report spool discard unlink failed, left for prune: %s", path
+            )
         return True
     disposition = await client.put_session_report(
         session_id=session_id,