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

comate_cli-0.12.7/.python-version

@@ -0,0 +1 @@
+3.12

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

@@ -4,6 +4,11 @@
 
 ### 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`）。
 - 规则双目录（SDK）：条件规则（带 `paths:` 的规则文件）现在也从项目 `.claude/rules/` 与用户 `~/.claude/rules/` 读取，Claude Code 里配好的路径规则搬到 comate 下直接生效——Read 命中路径注入 reminder，Edit / Write 预检同样拦截注入；user 层受 user setting source 门控，项目层受 project 门控。同一层级内 `.agent/rules` 与 `.claude/rules` 的同名文件（按相对路径）只加载 `.agent` 那份，被遮蔽路径记 info 日志；用户层与项目层之间不去重，两份都加载。`paths` 支持逗号分隔字符串（`paths: "src/**, lib/**"` 拆成多个模式，剥掉首尾空白与引号），YAML 列表形式不变；rules 目录下指向目录的符号链接跟进（做环检测，同一真实目录只进一次）；`.agents/rules/` 不读。目录、去重、逗号、符号链接四项改动作用在统一扫描入口上，常驻规则同样受益。
@@ -70,6 +75,11 @@
 
 ### Changed
 
+- Self-Update 不再把用户换到 Python 3.12：`comate update`、启动时的「立即更新」、Windows 旁装，以及 Windows 手动修复命令，uv 命令里的 `--python` 改为当前解释器的 `主版本.次版本`（例如在 3.13 上运行就带 `--python 3.13`），更新后留在原来的 Python 上。命令仍然带 `--python`，否则 `--force` 重装会漂到 uv 默认找到的解释器上。不在 `requires-python` 范围内的解释器（例如 3.14）也照样保持。白牌发行版在 `install_args` 里自己指定了 `--python` 时仍以白牌为准，可以用它固定版本（例如 `"--python", "3.13.12"`）。决策见 ADR 0064。
+- 状态栏的 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 不再移到行首。
 - 0.12.4 测试版里的随包 `/pr`（别名 `/mr`）改名为 `/open-pr`（别名 `/open-mr`），功能不变。原因：`pr` 是常见的第三方 skill 名，旧名会挡住用户自己装的同名 skill。`/pr`、`/mr` 不再有效，也没有改名提示。
 - 用户装的 skill 现在可以覆盖同名的随包命令（`/commit`、`/learn`、`/implement-plan`、`/open-pr` 等）：`/<名字>` 调用 skill，不提示，和 project/user 自定义命令覆盖随包命令一样。skill 只占了随包命令的某个别名时，随包命令只失去这个别名。skill 被禁用或随插件卸载后，随包命令自动回来。`user-invocable: false` 的 skill 不占名字。核心命令（`/help`、`/model` 等）与用户自己写的同名自定义命令仍然优先于 skill；这种冲突改为每个名字每个进程只提示一次（以前每次启动、切换会话、加载插件都会输出一条英文 WARNING），提示按界面语言显示，并说明模型仍可以通过 Skill 工具调用这个 skill。见 ADR-0038。
 - 思考被折叠时，loading 行括号里的呼吸黄短语不再随机挑，改为按这次请求真实生效的思考档位挑词：ultracode → `ultra thinking`、max / xhigh / high → `thinking some more with <档位> effort`（如 `thinking some more with high effort`）、medium → `thinking`、low → `light thinking`；auto 且模型无默认档、模型不支持调档、off 时显示 `thinking`，不再出现低档却显示 `ultra thinking` 的情况。档位取端点降档后的实际值（与 statusline 一致），每次请求开始思考时读一次，一轮中途开 ultracode 后下一次请求即生效。颜色、位置、出现时机不变；短语在中文 / 日文界面下也保持英文。
@@ -91,8 +101,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.6b1 → comate_cli-0.12.7}/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（后台任务菜单）**:
@@ -194,6 +194,10 @@ _Avoid_: marketplace url (too narrow), repo (only one of the forms)
 A registered plugin source, named by its own manifest rather than by whatever the user typed. One Marketplace Source resolves to at most one Marketplace, however it is spelled.
 _Avoid_: plugin store, registry (the registry is the collection of Marketplaces)
 
+**Effective Installation**:
+An installed-plugin record that applies to the current project: either a user-scope record, or a local-scope record whose project path is the current project. A local-scope record for another project is not an Effective Installation here, even though it exists in the registry.
+_Avoid_: installed (ambiguous: the registry may hold records that do not apply here), known plugin
+
 ## CLI Self-Update Language
 
 **Self-Update**:
@@ -326,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**:
@@ -375,10 +383,13 @@ _Avoid_: lag log, profiler output (the profiler records phase durations, not a s
 
 - A **Marketplace** takes its name from its manifest, never from the **Marketplace Source** the user typed; duplicate detection therefore compares resolved sources, not names or spellings.
 - Adding a **Marketplace** is never silent: the user confirms the **Marketplace Source** once before any clone or download starts, whether the source was typed into the panel or prefilled from a slash command argument.
+- Every plugin panel that reports "installed" (a checkmark, a count, a list of installed plugins) means **Effective Installation** for the current project, and uses the same rule the plugin loader uses to decide what to load. Registry membership alone never counts as installed.
+- Manual plugin update and **Plugin Auto Update** act on a plugin key, not on an **Effective Installation**: every record under that key (the user-scope record and every project's local-scope record) moves to the same version together. Display is per project; update is per plugin. There is no per-project version.
 
 - **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.
+- **Self-Update** keeps the installation on the interpreter it runs on: every uv install command requests the running `major.minor` (ADR 0064), unless the distribution profile's `install_args` already pins `--python`. There is no target Python; a CLI moves to another interpreter only when a whitelabel pin asks for it.
 
 - 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.
@@ -405,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.6b1 → comate_cli-0.12.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comate-cli
-Version: 0.12.6b1
+Version: 0.12.7
 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.22
+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.6b1 → comate_cli-0.12.7}/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.7/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.6b1 → comate_cli-0.12.7}/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.6b1 → comate_cli-0.12.7}/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,