ai_co_discuss 0.1.0 → 0.1.2

package/.agents/skills/discuss-host/references/launch.md

@@ -6,7 +6,7 @@
 
 1. 使用已安装的 `codiscuss`；未安装时用本仓库 `node runner/codiscuss.mjs`。`codiscuss launch settings` 只读本机软件默认配置，不启动服务或 AI。缺少配置时按仓库 `docs/runner.md` 的“两种讨论入口与启动配置”补齐；用户已提供的软件、目录和上限直接沿用，只询问无法确定的缺项。
 2. 从当前软件的实际会话信息取得会话 ID，不自造编号。启动文件中 `entry` 使用 `conversation`，`current_session_id` 使用该实际 ID；主持人的 `participants` 覆盖配置必须对应当前实际 CLI / App 客户端，不能仅根据模型名称选适配器。当前会话继续主持，不另建主持聊天。
-3. 站点始终明确指定。每场讨论选择主持人、专家、目标、用户原文、背景和上限；软件路径来自本机默认配置，本次可用 `participants` 覆盖。`cwd` / `discussion_project` 可省略，单个参与者可覆盖。已有会话仍在原目录，设置 cwd 不会迁移它。用户要一起查看某个项目时，把该项目目录设为 `cwd`；项目文件默认要求只读，仅当用户明确要求 AI 修改项目时才设 `"project_access": "write"`，也可在 `participants.NAME.project_access` 单独指定。只读不通过更换项目目录实现；agy 新会话由 runner 设置原生项目权限，已有会话（包括当前主持）仍由提示词约束。答案草稿只使用任务给出的 `draft_directory`，不写到项目或存放凭据的运行目录。
+3. 站点始终明确指定。每场讨论选择主持人、专家、目标、用户原文、背景和上限；软件路径来自本机默认配置，本次可用 `participants` 覆盖。`cwd` / `discussion_project` 可省略，单个参与者可覆盖。已有会话仍在原目录，设置 cwd 不会迁移它。用户要一起查看某个项目时，把该项目目录设为 `cwd`；项目文件默认要求只读，仅当用户明确要求 AI 修改项目时才设 `"project_access": "write"`，也可在 `participants.NAME.project_access` 单独指定。只读不通过更换项目目录实现；agy 只在讨论服务新建的会话中运行并由原生项目权限限制，不能绑定已有会话或从当前 agy 对话主持全自动讨论。答案草稿只使用任务给出的 `draft_directory`，不写到项目或存放凭据的运行目录。
 
 新讨论的 UTF-8 启动文件示例（替换示例内容；软件已在本机配置）：
 

package/README.md

@@ -17,10 +17,10 @@
 
 ### 安装包用户
 
-需要 **Node.js 24+、npm、Python 3.10+**，所选 AI CLI 须预先安装并登录；安装器不会代装这些运行环境或 AI 软件。当前尚无公开安装包下载或 npm registry 发布，`.tgz` 由维护者提供；尚未取得包时，使用下方的[源码运行方式](#源码运行方式)。在安装包所在目录运行，文件名以实际版本为准：
+需要 **Node.js 24+、npm、Python 3.10+**，所选 AI CLI 须预先安装并登录；安装器不会代装这些运行环境或 AI 软件。安装包已发布到 npm registry，在任意目录运行：
 
 ```sh
-npx --yes --package ./ai_co_discuss-0.1.0.tgz codiscuss install
+npx --yes --package ai_co_discuss codiscuss install
 ```
 
 按安装提示选择已检测到的软件并核对配置。安装器会安装持久的 `codiscuss` 命令、复制三份完整讨论 Skill、保存本机软件配置，启动网站与讨论服务并打开浏览器。安装包已带运行代码和构建好的网页，无需另行克隆仓库或构建前端；安装本身不创建讨论。
@@ -83,7 +83,7 @@ codiscuss local connect https://你的站点
 
 #### 项目与日常使用
 
-两个入口都可按场指定项目目录、项目文件只读 / 可写及参与者覆盖配置；不需要项目资料时可省略。CLI 保持指定工作目录，回答草稿与运行数据分开。项目默认要求只读，但限制强度取决于软件：Codex 使用原生沙箱，agy 新会话使用原生项目权限并禁用 MCP；Claude 的已有用户授权仍生效，agy 已有外部会话保留上下文并使用提示词约束。权限冲突处理与实测边界见 [单次执行权限](docs/runner.md#单次执行权限)。
+两个入口都可按场指定项目目录、项目文件只读 / 可写及参与者覆盖配置；不需要项目资料时可省略。CLI 保持指定工作目录，回答草稿与运行数据分开。项目默认要求只读，但限制强度取决于软件：Codex 使用原生沙箱，agy 只在讨论服务新建的会话中运行并由其独立项目权限限制、禁用 MCP（不绑定已有 agy 会话）；Claude 的已有用户授权仍生效。权限冲突处理与实测边界见 [单次执行权限](docs/runner.md#单次执行权限)。
 
 | 日常操作 | 命令 |
 | --- | --- |

package/docs/architecture.md

@@ -28,7 +28,7 @@ Python 与 Cloudflare 是两种部署实现，运行时选其一，不是请求
 | `backend/worker.mjs` | Pages Request、D1 `DB` binding | 与 Python 相同的业务响应；静态请求交由 Pages assets |
 | `runner/codiscuss.mjs` | 统一 `codiscuss` 命令与原样参数 | 无子命令时启动本机服务，`service` 管理进程；网站命令转交 Python 客户端，保留 stdin、相对路径与退出码 |
 | `runner/discussion_launch.mjs` | 本机默认软件配置、单场启动配置、对话 / 网页入口 | 校验后建房、保存私有配置、启用运行并登记接入服务；对话入口将首个主持任务交回当前会话；暂停后可凭原控制凭据和版本修正本场软件路径，不改变会话绑定或自动重启 |
-| `runner/discussion_setup.mjs` / `discussion_skills.mjs` | npm 包、已有 Python / CLI、选定软件 | 持久安装统一命令，合并本机软件配置，复制完整技能并保留本地修改；不创建讨论 |
+| `runner/discussion_setup.mjs` / `discussion_skills.mjs` / `discussion_tui.mjs` | npm 包、已有 Python / CLI、选定软件 | 持久安装统一命令，合并本机软件配置，复制完整技能并保留本地修改；`discussion_tui.mjs` 只负责安装过程的终端呈现；不创建讨论 |
 | `runner/discussion_local.mjs` | 用户服务目录、Python 和端口配置 | 后台网站及包外 SQLite，复用讨论服务、检查就绪、仅停止拥有的进程 |
 | `runner/discuss.py` | 命令、站点、房间、声明身份、UTF-8 文件 | 网站客户端实现；单次 HTTP 请求、稳定 JSON / 文本、退出码，帮助和预览可离线，可直接用 Python 执行 |
 | `web/app.js` | 页面事件和 API 返回状态 | 共享讨论控制器、读写操作、主题与界面同步 |

package/docs/runner.md

@@ -4,13 +4,13 @@
 
 ## npm 安装与本机配置
 
-需要 Node.js 24+、npm 与 Python 3.10+。包内带已构建网页、Python 后端、接入程序及三份完整技能；运行时不安装前端依赖。当前尚未发布 npm registry，使用本项目生成的 `.tgz` 文件：
+需要 Node.js 24+、npm 与 Python 3.10+。包内带已构建网页、Python 后端、接入程序及三份完整技能；运行时不安装前端依赖。从 npm registry 安装：
 
 ```sh
-npx --yes --package ./ai_co_discuss-0.1.0.tgz codiscuss install
+npx --yes --package ai_co_discuss codiscuss install
 ```
 
-`install` 在安装包或写配置前检查 Node、Python、端口参数及显式选择的软件路径，再将当前包安装到 npm 的全局 prefix，由持久安装运行 `setup`；不依赖 npx 缓存长期存在。已有源码时可直接在仓库执行 `node runner/codiscuss.mjs install`。普通 `npm install --global 包路径.tgz` 只安装命令，随后运行 `codiscuss setup`；没有 postinstall 配置或启动副作用。开发者仍可使用下文的 `npm link`。
+`install` 在安装包或写配置前检查 Node、Python、端口参数及显式选择的软件路径，再将当前包安装到 npm 的全局 prefix，由持久安装运行 `setup`；不依赖 npx 缓存长期存在。已有源码时可直接在仓库执行 `node runner/codiscuss.mjs install`。维护者生成的 `.tgz` 可将包名换成文件路径。普通 `npm install --global ai_co_discuss` 只安装命令，随后运行 `codiscuss setup`；没有 postinstall 配置或启动副作用。开发者仍可使用下文的 `npm link`。
 
 `setup` 检测 Python 和固定四类 CLI：Claude（`claude`）、Codex（`codex`）、Gemini 使用的 Antigravity（`agy`）、Grok 使用的 Cursor（`agent` / `cursor-agent`）。按显式路径或 PATH 查找并执行有超时的 `--version`；Windows 读取实际 `.exe`（PATH 上只有 npm 包装脚本时，到 `node_modules/@openai` 包内查找 Codex 原生程序，跳过 npm 升级残留的 `.` 开头目录），Cursor 也支持官方 `.cmd` 启动入口。仅检查 CLI 能否启动，不扫描 App、账号登录或模型状态；已有 App 配置不会被当成检测成功。
 
@@ -24,17 +24,17 @@ codiscuss local status
 codiscuss local stop
 ```
 
-交互回车及 `--yes` 默认选择检测到且已有自动适配器的 CLI；`--clients codex,claude,antigravity,cursor` 明确选择，`none` 只配置网站，Cursor 需要显式选择。`--no-start` 只配置，`--no-open` 启动网站但不打开浏览器；无交互输入时须提供 `--yes` 或 `--clients`。软件路径可用 `--codex PATH`、`--claude PATH`、`--antigravity PATH`、`--cursor PATH` 指定。`install --prefix DIR` 可使用可写的 npm 安装前缀；Windows 命令目录是 prefix 本身，macOS/Linux 是其 `bin` 子目录。
+交互终端显示多选列表（方向键移动、空格勾选、回车确认，Ctrl+C 取消），默认勾选检测到且已有自动适配器的 CLI，未检测到的软件不可勾选；`--yes` 同样默认选择这些 CLI；`--clients codex,claude,antigravity,cursor` 明确选择，`none` 只配置网站，Cursor 需要显式选择。`--no-start` 只配置，`--no-open` 启动网站但不打开浏览器；无交互输入时须提供 `--yes` 或 `--clients`。软件路径可用 `--codex PATH`、`--claude PATH`、`--antigravity PATH`、`--cursor PATH` 指定。`install --prefix DIR` 可使用可写的 npm 安装前缀；Windows 命令目录是 prefix 本身，macOS/Linux 是其 `bin` 子目录。
 
 配置结束时忽略 npx 临时入口，核对当前 PATH 中的持久 `codiscuss` 是否指向本次安装，并实际执行 `--help`。命令缺失、旧入口优先或无法运行均报告待处理及处理方式；自定义 prefix 未在 PATH 时，输出需要加入的实际目录。安装器不修改系统 PATH；修正后重新打开终端运行 `codiscuss setup`。
 
-`install/setup` 保留 stdout JSON，并在 stderr 输出中文摘要，包括实际软件配置、Skill 文件就绪数、命令和网站地址。退出码与 JSON `status` 对应：`0` 为 `ready`（网站与讨论服务已就绪）或 `configured`（显式 `--no-start`）；`2` 为 `needs_attention`（配置差异未确认、技能冲突或命令不可用）；`1` 为失败。网站启动失败时返回 `start_failed` 与已保存的配置结果，修复后重跑 `setup` 即可。环境预检失败发生在写入前，仅输出错误。配置待处理不撤销已完成部分，也不妨碍启动可用的网站；`configured` 布尔值为 false，不能按成功处理。`ai_verified: false` 表示安装器没有执行真实模型，不证明账号、技能发现或多轮讨论已验收。
+`install/setup` 在 stderr 输出中文摘要，包括实际软件配置、Skill 文件就绪数、命令和网站地址；交互终端显示分步进度、多选列表与对齐的结果汇总（遵循 `NO_COLOR`），输出被重定向时保持逐行纯文本。结果 JSON 在 stdout 被重定向或加 `--json` 时写入 stdout，交互终端默认不打印。退出码与 JSON `status` 对应：`0` 为 `ready`（网站与讨论服务已就绪）或 `configured`（显式 `--no-start`）；`2` 为 `needs_attention`（配置差异未确认、技能冲突或命令不可用）；`1` 为失败。网站启动失败时返回 `start_failed` 与已保存的配置结果，修复后重跑 `setup` 即可。环境预检失败发生在写入前，仅输出错误。配置待处理不撤销已完成部分，也不妨碍启动可用的网站；`configured` 布尔值为 false，不能按成功处理。`ai_verified: false` 表示安装器没有执行真实模型，不证明账号、技能发现或多轮讨论已验收。
 
-安装器按 [技能配置](skills.md#自动安装完整技能) 复制完整技能。`--skills-home DIR` 可覆盖技能用户根目录；默认当前用户 home。重复安装只更新由安装器管理且未被编辑的版本；冲突保留本地文件，输出实际路径并标记待处理。核对后可移走需替换的旧副本再重跑 `setup`。安装器不调整登录状态；权限只在选中 Gemini 时经确认写入讨论命令与草稿目录规则，见 [单次执行权限](#单次执行权限)。
+安装器按 [技能配置](skills.md#自动安装完整技能) 复制完整技能。`--skills-home DIR` 可覆盖技能用户根目录；默认当前用户 home。重复安装只更新由安装器管理且未被编辑的版本；冲突保留本地文件，输出实际路径并标记待处理。核对后可移走需替换的旧副本再重跑 `setup`。安装器不调整登录状态，也不向 agy 全局设置写入权限规则；只清理早期版本写入的规则，见 [单次执行权限](#单次执行权限)。
 
 安装实现保持固定软件表和本地文件复制。路径查找参考 [npm/node-which](https://github.com/npm/node-which/blob/main/lib/index.js) 的 PATH 顺序与执行权限检查，只覆盖所需命令和后缀；技能复制参考 [OpenAI 单文件安装脚本](https://github.com/openai/skills/blob/main/skills/.system/skill-installer/scripts/install-skill-from-github.py) 的整目录复制与同名保护思路，保留本项目的内容哈希更新判断。不引入这些项目作为依赖，也不增加在线技能下载、插件注册或后台更新。
 
-默认 `setup` 最后执行 `local open`：后台启动 Python 回环网站（`--local-launch --no-demo`）与讨论服务，再打开浏览器；首次为空库。网站地址默认为 `http://127.0.0.1:8765`。`local start` 具有相同启动行为但不打开浏览器，重复启动复用原进程；真正绑定成功并通过健康检查后才返回就绪。端口占用会失败，不接管或停止占用者。改端口或升级程序前先 `local stop`，再重新启动。
+默认 `setup` 最后执行 `local open`：后台启动 Python 回环网站（`--local-launch --no-demo`）与讨论服务，再打开浏览器；首次为空库。网站地址默认为 `http://127.0.0.1:8765`。`local start` 具有相同启动行为但不打开浏览器，重复启动复用原进程；真正绑定成功并通过健康检查后才返回就绪。端口占用会失败，不接管或停止占用者。网站管理进程脱离启动它的终端在后台运行，关闭终端不会停止网站或讨论服务；本机网站不设登录自启，重启电脑后运行 `local open` 重新启动。安装摘要会同时提示这些状态与停止命令。改端口或升级程序前先 `local stop`，再重新启动。
 
 网站数据库为服务目录下 `local/discuss.sqlite3`，配置、登记表和讨论执行数据也位于包外；服务目录位置及 `DISCUSS_SERVICE_HOME` 见下文。源码运行的 `data/discuss.sqlite3` 不自动迁移。网站仍在而讨论服务已停止时，显式 `local open/start` 会要求网站管理进程恢复服务；不会自动恢复已暂停的房间。`local status` 的 `running` 要求网站和讨论服务同时运行，`website_running` 单独表示网站状态。`local stop` 关闭它创建的网站，并停止它启动或恢复且仍由相同 PID 持有的讨论服务；预先运行或后来独立启动的服务会保留。停止服务会暂停其托管中的活动讨论，数据库保留。日志在 `local/website.log`、`local/supervisor.log` 与原 `service.log`。
 
@@ -202,7 +202,7 @@ Windows 的 `executable` 填原生 `.exe`，不填 npm 的 `.cmd` / `.ps1` 包
 | --- | --- | --- |
 | `codex_cli` | `codex exec --json`，从 `thread.started` 读取实际 ID；后续 `exec resume ID`，不使用 `--last` | 首次与续接均显式 `--cd` 到用户指定项目；省略 cwd 时使用本场独立草稿目录。允许非 Git 目录；项目与草稿的写入权限由本次 permission profile 区分。项目名仅作元数据，不关联 App 项目分组 |
 | `claude` | 现有 `claude -p --output-format json`；后续 `--resume ID` | 沿用上表中的 Claude 规则 |
-| `antigravity_cli` | `agy -p --output-format stream-json`，从 `init.conversation_id` 读取实际 ID；后续 `--conversation ID`，不使用 `--continue` | 保持指定 cwd；省略 cwd 时使用本场独立草稿目录。新会话创建独立的原生讨论项目，沿用所选项目的资源目录并设置权限，续接复用该项目；外部已有会话保留原项目和上下文 |
+| `antigravity_cli` | `agy -p --output-format stream-json`，从 `init.conversation_id` 读取实际 ID；后续 `--conversation ID`，不使用 `--continue` | 保持指定 cwd；省略 cwd 时使用本场独立草稿目录。只在讨论服务新建的会话中执行：每位参与者一个独立原生讨论项目，续接复用该项目；不绑定外部已有会话 |
 
 两种新适配器都不需要 `source_thread_id` 或 `ipc_directory`。实际 ID 在输出流到达时写入本机绑定和本次执行凭据，随后 AI 按任务文件自行 `execution enter` 并通过讨论 CLI 保存业务结果；程序不把终端回答直接代发。已有 App 绑定不能通过改适配器直接复用，须先暂停并使用独立 `data_directory` 明确重新接入。此路径不承诺 CLI 会话同步到桌面 App。
 
@@ -210,21 +210,26 @@ Windows 的 `executable` 填原生 `.exe`，不填 npm 的 `.cmd` / `.ps1` 包
 
 每次执行只开放本场讨论所需的最小权限，不使用全部放行或绕过审批参数。任务文件的 `cli` 为 `codiscuss`，`subcommands` 列出唯一放行的网站子命令：`room`、`message`、`turn`、`state`、`floor`、`execution`、`health`、`schema`；`service`、`launch`、`run`、`api`、`setup`、`install`、`local` 不放行。提示词要求命令以 `codiscuss` 开头，不用 `python discuss.py`、`cd` 或管道。规则不含路径，重装或更换 Python 无需更新；子进程 PATH 中的 `codiscuss` 须指向本次安装，setup 的持久命令检查会核对。
 
-项目文件权限 `project_access` 为 `read`（默认）或 `write`：启动文件顶层设本场值，`participants.NAME.project_access` 覆盖单个 AI，空字符串表示沿用本场值。它只随本次启动保存，不能存入本机默认配置；网页新建讨论在“启动”区直接提供项目目录与项目文件选项，单个 AI 的覆盖在“调整启动配置”中。三种 CLI 都在用户指定的 cwd 启动；省略 cwd 时才使用独立草稿目录。agy 新建会话使用原生项目权限；已有外部会话继续使用提示词约束，保留原项目与历史。App 适配器的写权限由 App 自身决定，任务文件始终写明本场要求。
+项目文件权限 `project_access` 为 `read`（默认）或 `write`：启动文件顶层设本场值，`participants.NAME.project_access` 覆盖单个 AI，空字符串表示沿用本场值。它只随本次启动保存，不能存入本机默认配置；网页新建讨论在“启动”区直接提供项目目录与项目文件选项，单个 AI 的覆盖在“调整启动配置”中。三种 CLI 都在用户指定的 cwd 启动；省略 cwd 时才使用独立草稿目录。agy 的权限全部由其独立讨论项目执行，见下文。App 适配器的写权限由 App 自身决定，任务文件始终写明本场要求。
 
 | 适配器 | 本次追加 | 只读 / 可写差异 |
 | --- | --- | --- |
 | `claude` | `--add-dir` 运行、草稿与技能目录；每个子命令各一条 `Bash(codiscuss room *)` 与 `PowerShell(codiscuss room *)`，仅对独立草稿增加 `Edit(//<草稿目录>/**)`，再追加用户的 `allowed_tools` | 可写时再加 `Edit(//<项目目录>/**)`；不再对运行目录新增 Edit 放行，已有用户规则仍生效；Windows 路径按 `//c/...` 匹配 |
 | `codex_cli` | 每次创建唯一名称的 permission profile，通过 `-c default_permissions=...` 与 `permissions.<名称>=...` 传入，`approval_policy="never"`；运行目录只读，独立草稿目录可写 | 无项目或项目只读时继承 `:read-only`，项目可写时继承 `:workspace`；维持原有广泛读取范围和本次联网能力，未启用域名过滤 |
-| `antigravity_cli` | 新会话使用独立 `--project UUID` 与 `--mode accept-edits`；项目规则允许讨论命令和草稿写入，禁止运行目录、技能目录、`~/.gemini` 写入及 MCP 工具调用；每次启动检查全局命令权限 | `read` 为项目目录添加 `write_file(目录)` deny，`write` 改为 allow；运行数据禁写不随项目授权放开。旧外部绑定只传原会话 ID，沿用提示词约束，可写时才额外传 `accept-edits` |
+| `antigravity_cli` | 始终使用独立 `--project UUID` 与 `--mode accept-edits`；项目规则允许讨论命令和草稿写入，禁止运行目录、技能目录、`~/.gemini` 写入及 MCP 工具调用；每次交付前检查全局设置 | `read` 为项目目录添加 `write_file(目录)` deny，`write` 改为 allow；运行数据禁写不随项目授权放开 |
 
-agy 的规则按目录前缀递归匹配，不使用 `/**`；Deny > Ask > Allow，因此草稿不得放在只读项目、运行目录、技能或 `.gemini` 中，路径冲突会在交付前报告。原生工具权限不是操作系统沙箱：runner 同时要求 CLI 的 `toolPermission` 为默认 `request-review`，检查 CLI 和共享全局 allow，存在本工具讨论规则以外的 `command(...)` / `unsandboxed_command(...)` 放行时拒绝交付；未授权 shell 在非交互模式下被拒绝。MCP 工具调用统一 deny，避免经 MCP 写入项目。[原生权限文档](https://antigravity.google/docs/permissions?tab=cli)、[CLI 设置](https://antigravity.google/docs/settings?tab=cli)。
+agy 只用一套方法控制权限：
 
-独立讨论项目保存在 `~/.gemini/config/projects/<UUID>.json`，运行目录的 `agy-project-<参与者摘要>.json` 保存项目与实际会话绑定。所选原项目及用户全局配置不被改写；新项目只沿用资源目录，不继承原项目的命令放行。会话继续使用时保留这两份记录，不将生成的讨论会话手动迁入其他项目。agy 续接已有会话会恢复其原项目，传入另一 `--project` 不能替换它；因此历史绑定和从当前 agy 对话发起的主持保留提示词约束，交付回执以 `permission_enforcement: prompt` 标识，新管理会话为 `native`。缺失已登记的原生项目或会话绑定不匹配时拒绝交付。[项目权限继承](https://antigravity.google/docs/projects?tab=cli)。
+1. **只在本工具新建的会话中执行**：每位参与者对应一个独立原生讨论项目，权限只写在该项目里。外部已有会话（包括从当前 agy 对话发起主持、在启动配置中填写 `session_id`）会恢复其原项目，无法套用讨论项目权限，因此启动时即拒绝，交付时也再次拒绝。
+2. **项目内规则**：allow 为受限的讨论命令规则与草稿目录写入（`write` 时加项目目录写入）；deny 为项目目录写入（`read` 时）、运行目录、技能目录、`~/.gemini` 写入与 `mcp(*)`。规则按目录前缀递归匹配，不使用 `/**`；Deny > Ask > Allow，因此草稿不得位于受保护目录中，冲突在交付前报告。
+3. **交付前检查全局设置**：CLI 的 `toolPermission` 须未设置或为 `request-review`；CLI 与共享全局 allow 中不得有任何 `command(...)`、`unsandboxed(...)`、`unsandboxed_command(...)` 或 `*` 放行，否则拒绝交付，因为全局放行会让 shell 绕过项目的文件规则。未授权 shell 在非交互模式下被拒绝。
+4. **不改用户全局设置**：本工具不向 agy 全局设置写入任何规则；`setup` 只移除早期版本记录在 `agy-permission.json` 中的全局规则（先备份到服务目录 `agy-settings.backup.json`），其他设置与用户规则不变。
 
-Codex 要求 CLI 0.163.0 或更新版本，使用 permission profiles 和本地 `app-server config/read`。配置检查先核对初始化回执中的版本；不支持或无法识别的版本拒绝交付。每次交付前只启动本地配置检查进程，不创建会话、不调用模型；发现已加载的旧 `sandbox_mode` / `sandbox_workspace_write` 或新配置未被采用就拒绝交付，避免旧设置覆盖本次限制。报错后需更新不支持的 CLI 或移除冲突的旧配置；接入程序不自动改写用户全局设置。首次与续接使用同一组权限参数，配置检查进程也随暂停或停止清理。[Codex 权限配置](https://learn.chatgpt.com/docs/permissions)
+原生工具权限不是操作系统沙箱；工具被拒绝时 agy 仍可能退出码为 0，验收以实际文件和网站结果为准。[原生权限文档](https://antigravity.google/docs/permissions?tab=cli)、[CLI 设置](https://antigravity.google/docs/settings?tab=cli)。
+
+独立讨论项目保存在 `~/.gemini/config/projects/<UUID>.json`，运行目录的 `agy-project-<参与者摘要>.json` 保存项目与实际会话绑定。所选原项目及用户全局配置不被改写；新项目只沿用资源目录，不继承原项目的命令放行。项目名为 `CoDiscuss · 讨论标题 · 参与者`，便于在 Antigravity 项目列表中区分。会话继续使用时保留这两份记录，不将生成的讨论会话手动迁入其他项目；讨论收束或存档后仍保留，以便之后在同一会话中继续讨论。只有网站确认房间已被删除（`房间不存在`）时，接入程序才删除该房间建立的讨论项目与记录，不触碰用户自己的项目。缺失已登记的原生项目或会话绑定不匹配时拒绝交付。[项目权限继承](https://antigravity.google/docs/projects?tab=cli)。
 
-agy 没有单次命令放行参数，新管理会话由上述项目规则放行。兼容旧会话和手动接入的 `setup` 仍可向 `~/.gemini/antigravity-cli/settings.json` 的 `permissions.allow` 写入规则：选中 Gemini 时询问一次（回车同意，`--yes` 视为同意），追加两条规则：只匹配 `codiscuss` 或 `codiscuss.cmd`、可选一个 `--site` 网址及上述子命令的 `command(regex:...)`，参数不得含分号、`&`、`|`、`<`、`>`、美元符号、反引号与圆括号，避免附加命令或 PowerShell 括号表达式；以及 `write_file(<服务目录>/drafts)`（Windows 保留盘符、使用正斜杠）。写入前备份原文件到服务目录 `agy-settings.backup.json`，`agy-permission.json` 记录已写规则；升级后重跑 setup 会替换本工具记录的旧命令规则，并将宽泛 `launches` 写规则替换为 `drafts`，不改其他设置与用户规则。旧会话通过单独 runner 运行时须按任务中的实际草稿目录配置 agy。文件无法解析时不写入并报告待处理；非交互且未加 `--yes` 只报告。
+Codex 要求 CLI 0.163.0 或更新版本，使用 permission profiles 和本地 `app-server config/read`。配置检查先核对初始化回执中的版本；不支持或无法识别的版本拒绝交付。每次交付前只启动本地配置检查进程，不创建会话、不调用模型；发现已加载的旧 `sandbox_mode` / `sandbox_workspace_write` 或新配置未被采用就拒绝交付，避免旧设置覆盖本次限制。报错后需更新不支持的 CLI 或移除冲突的旧配置；接入程序不自动改写用户全局设置。首次与续接使用同一组权限参数，配置检查进程也随暂停或停止清理。[Codex 权限配置](https://learn.chatgpt.com/docs/permissions)
 
 2026-10-18 本机实测（本轮权限调整前）：Claude 主持、Codex 与 Gemini 专家完成一场最小讨论。Windows 的 Codex / agy 经 PowerShell 调用时优先执行 npm 生成的 `codiscuss.ps1`；Codex elevated 沙箱内即使当前用户为 RemoteSigned 也拒绝 `.ps1`，Codex 自行改用 `cmd.exe` 调用 `codiscuss.cmd` 后成功。`agy` 非交互模式下被拒绝的工具也可能伴随退出码 0，最终仍以网站业务保存为准。`agy` 显式使用 `--print-timeout 0`，由房间的单次执行时限和整场截止控制停止，避免额外的 CLI 默认时限提前截断。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai_co_discuss",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "bin": {
     "codiscuss": "runner/codiscuss.mjs"
   },
@@ -8,7 +8,7 @@
     "dev": "npm run build && wrangler pages dev --ip 127.0.0.1 --port 8787",
     "db:local": "wrangler d1 execute DB --local --file backend/schema.sql",
     "db:remote": "wrangler d1 execute DB --remote --file backend/schema.sql",
-    "check": "node --check backend/worker.mjs && node --check web/app.js && node --check runner/discussion_runner.mjs && node --check runner/discussion_adapters.mjs && node --check runner/discussion_sidecar.mjs && node --check runner/codex_app_client.mjs && node --check runner/discussion_service.mjs && node --check runner/codiscuss.mjs && node --check runner/discussion_launch.mjs && node --check runner/discussion_setup.mjs && node --check runner/discussion_skills.mjs && node --check runner/discussion_local.mjs",
+    "check": "node --check backend/worker.mjs && node --check web/app.js && node --check runner/discussion_runner.mjs && node --check runner/discussion_adapters.mjs && node --check runner/discussion_sidecar.mjs && node --check runner/codex_app_client.mjs && node --check runner/discussion_service.mjs && node --check runner/codiscuss.mjs && node --check runner/discussion_launch.mjs && node --check runner/discussion_setup.mjs && node --check runner/discussion_skills.mjs && node --check runner/discussion_tui.mjs && node --check runner/discussion_local.mjs",
     "runner": "node runner/discussion_runner.mjs",
     "service": "node runner/discussion_service.mjs",
     "build:ui": "vite build --config frontend/vite.config.mjs --mode markdown && vite build --config frontend/vite.config.mjs --mode backup && vite build --config frontend/vite.config.mjs",
@@ -37,7 +37,15 @@
     "vue": "3.5.44"
   },
   "description": "让不同 AI 在各自软件中协作的共享讨论空间",
-  "keywords": ["ai", "multi-agent", "discussion", "cli", "codex", "claude", "gemini"],
+  "keywords": [
+    "ai",
+    "multi-agent",
+    "discussion",
+    "cli",
+    "codex",
+    "claude",
+    "gemini"
+  ],
   "homepage": "https://github.com/huyan1458/ai_co_discuss#readme",
   "repository": {
     "type": "git",

package/runner/discussion_adapters.mjs

@@ -1,7 +1,7 @@
 /** Actual software entrypoints; never call model service APIs. */
 import { spawn, spawnSync } from 'node:child_process';
 import { createHash, randomUUID } from 'node:crypto';
-import { existsSync, readFileSync, readdirSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
 import { isAbsolute, join, relative, resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { createInterface } from 'node:readline';
@@ -144,14 +144,14 @@ export function agy_rule() {
 /** Read optional native settings; malformed settings must not silently disable a permission check. */
 function read_json(path) { return existsSync(path) ? JSON.parse(readFileSync(path, 'utf8')) : {}; }
 
-/** Native headless review blocks unapproved shell commands; inherited command grants could bypass it. */
+/** Native headless review blocks unapproved shell commands; any global command grant could bypass the project rules. */
 function check_agy_shell(user_home) {
   const cli = read_json(join(user_home, '.gemini', 'antigravity-cli', 'settings.json'));
   const shared = read_json(join(user_home, '.gemini', 'config', 'config.json'));
   const grants = [...(cli.permissions?.allow || []), ...(shared.userSettings?.globalPermissionGrants?.allow || [])];
   if ((cli.toolPermission && cli.toolPermission !== 'request-review')
-    || grants.some(rule => rule !== agy_rule() && (/^(?:unsandboxed_)?command\(/.test(rule) || rule === '*'))) {
-    throw new Error('agy 全局命令放行或 toolPermission 会绕过本场文件限制；请保留 request-review，重跑 setup 更新旧管理规则并移除额外命令放行，未交付讨论任务');
+    || grants.some(rule => rule === '*' || /^(?:command|unsandboxed|unsandboxed_command)\(/.test(rule))) {
+    throw new Error('agy 全局设置放行了命令或改了 toolPermission，会绕过讨论项目的权限；请移除全局 command / unsandboxed 放行并保留 request-review（本工具旧版写入的规则可运行 codiscuss setup 清理），未交付讨论任务');
   }
 }
 
@@ -183,12 +183,14 @@ function agy_project_grants(config, task, resources, user_home) {
   deny: [...new Set(protected_paths.map(write_rule)), 'mcp(*)'] };
 }
 
-/** Keep a private native project per participant; existing external conversations retain their original project. */
+/** Run agy only inside a private native project this tool created; external conversations keep their own project, so they are refused. */
 export function prepare_agy_project(config, binding, task, user_home = homedir()) {
   const key = createHash('sha256').update(task.participant).digest('hex');
   const record_path = join(task.directory, `agy-project-${key}.json`);
   const record = read_json(record_path);
-  if (binding.session_id && !record.project_id) return null;
+  if (binding.session_id && !record.project_id) {
+    throw new Error('agy 只在本工具新建的讨论会话中自动执行；该会话不是本工具创建的，无法套用讨论项目权限，未交付讨论任务');
+  }
   if (record.session_id && record.session_id !== binding.session_id) throw new Error('agy 项目记录与会话绑定不符，未交付讨论任务');
   check_agy_shell(user_home);
   const root = join(user_home, '.gemini', 'config');
@@ -200,13 +202,30 @@ export function prepare_agy_project(config, binding, task, user_home = homedir()
   const current = read_json(path);
   if (record.project_id && current.id !== project_id) throw new Error('agy 讨论项目已丢失或不匹配，未交付讨论任务');
   mkdirSync(join(root, 'projects'), { recursive: true });
-  atomic_json(path, { ...current, id: project_id, name: `CoDiscuss · ${task.participant}`,
+  const name = ['CoDiscuss', task.room_title, task.participant].filter(Boolean).join(' · ');
+  atomic_json(path, { ...current, id: project_id, name,
     projectResources: { resources }, settings: {}, permissionGrants: { permissionGrants: grants, v2Migrated: true } });
   const saved = { project_id, session_id: record.session_id || '' };
   atomic_json(record_path, saved);
   return { project_id, bind: session_id => atomic_json(record_path, { ...saved, session_id }) };
 }
 
+/**
+ * Delete the agy projects this room created after the room itself is deleted; the user's own projects are never touched.
+ * @returns {number} How many project records were cleared.
+ */
+export function remove_agy_projects(directory, user_home = homedir()) {
+  if (!existsSync(directory)) return 0;
+  const records = readdirSync(directory).filter(name => /^agy-project-[a-f0-9]{64}\.json$/.test(name));
+  for (const file of records) {
+    const { project_id } = read_json(join(directory, file));
+    const path = join(user_home, '.gemini', 'config', 'projects', `${project_id}.json`);
+    if (/^[a-f0-9-]{36}$/.test(project_id || '') && read_json(path).id === project_id) rmSync(path);
+    rmSync(join(directory, file));
+  }
+  return records.length;
+}
+
 /**
  * Allow only listed codiscuss website subcommands and draft writes for this run; user rules are added after.
  * Claude Code on Windows may run commands through its PowerShell tool instead of Bash, so both are listed.
@@ -328,11 +347,10 @@ function cli_invocation(config, binding, task, user_home) {
   const project = prepare_agy_project(config, binding, task, user_home);
   const args = ['--output-format', 'stream-json', '--print-timeout', '0', '--add-dir', task.directory,
     '--add-dir', task.draft_directory, '--add-dir', task.skills_directory];
-  if (project || (project_directory(config) && config.project_access === 'write')) args.push('--mode', 'accept-edits');
-  if (project) args.push('--project', project.project_id);
+  args.push('--mode', 'accept-edits', '--project', project.project_id);
   if (binding.session_id) args.push('--conversation', binding.session_id);
   args.push('-p', task.prompt);
-  return { args, project, permission_enforcement: project ? 'native' : 'prompt' };
+  return { args, project };
 }
 
 /** Persist an emitted identity before the agent reads its execution credential file. */
@@ -428,8 +446,7 @@ async function cli_delivery(config, binding, task, spawn_process, user_home) {
   });
   child.stdin.on('error', error => { if (error.code !== 'EPIPE') task.on_failure(error.message); });
   child.stdin.end(invocation.input);
-  return { session_id: state.session_id, status: 'accepted',
-    ...(invocation.permission_enforcement ? { permission_enforcement: invocation.permission_enforcement } : {}) };
+  return { session_id: state.session_id, status: 'accepted' };
 }
 
 /** Queue one immutable request for the official App-managed Sidecar. */

package/runner/discussion_launch.mjs

@@ -111,6 +111,8 @@ function launch_config(home, input, room, directory, options) {
     const cwd = profile.cwd || input.cwd;
     if (cwd && (!existsSync(cwd) || !statSync(cwd).isDirectory())) throw new Error(`${name}：工作目录不存在或不是文件夹，请核对本次目录配置`);
     if (input.entry === 'conversation' && name === room.host) profile.session_id = input.current_session_id;
+    // agy runs only in sessions this tool creates, so its native discussion project always applies.
+    if (profile.adapter === 'antigravity_cli' && profile.session_id) throw new Error(`${name}：agy 不能绑定已有会话或从当前 agy 对话主持全自动讨论；请从网页或其他软件发起，agy 会由讨论服务新建会话`);
     participants[name] = profile;
   }
   return validate_config({ site: input.site, room: room.id || 'preview', token: options.token, participants,

package/runner/discussion_runner.mjs

@@ -6,7 +6,7 @@ import { DatabaseSync } from 'node:sqlite';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { parseArgs } from 'node:util';
 import { setTimeout as sleep } from 'node:timers/promises';
-import { atomic_json, deliver_task, setup_sidecar, sidecar_receipt, TASK_SUBCOMMANDS } from './discussion_adapters.mjs';
+import { atomic_json, deliver_task, remove_agy_projects, setup_sidecar, sidecar_receipt, TASK_SUBCOMMANDS } from './discussion_adapters.mjs';
 
 const POLL_MS = 2000;
 const DELIVERY_RETRY_DELAYS_MS = [2000, 4000];
@@ -189,7 +189,7 @@ export class DiscussionRunner {
     try {
       const task = task_files(this.config, event, row.token, binding);
       invoked = true;
-      const result = await this.deliver(adapter, binding, { ...task,
+      const result = await this.deliver(adapter, binding, { ...task, room_title: this.room_title,
         on_binding: session => this.store.bind(event.participant, session),
         on_process: child => { this.children.add(child); child.once('close', () => this.children.delete(child)); },
         on_output: (path, chunk) => appendFileSync(path, chunk, { mode: 0o600 }),
@@ -256,12 +256,19 @@ export class DiscussionRunner {
   /** Process one bounded iteration without waking models for empty checks. */
   async tick() {
     this.store.context(this.config);
-    let room = await api(this.config, '');
+    let room;
+    try { room = await api(this.config, ''); }
+    catch (error) {
+      // Only a permanently deleted room drops its private agy projects; concluded or archived rooms keep them for later continuation.
+      if (/^HTTP 404: 房间不存在/.test(error.message)) remove_agy_projects(this.config.directory);
+      throw error;
+    }
     if (room.limits?.reached && (!room.limits.closing || room.limits.reason === 'time_limit') && room.runtime.status === 'running') {
       const generation = room.runtime.generation;
       room = await api(this.config, '/limits', { actor: '用户' });
       if (room.runtime.generation !== generation) this.stop_children();
     }
+    this.room_title = room.title;
     const run = room.runtime;
     if (run.run_id) this.store.scope(this.config, run.run_id);
     if (run.mode !== 'automatic' || run.status !== 'running' || run.expired) {

package/runner/discussion_setup.mjs

@@ -1,19 +1,20 @@
 /** npm bootstrap and per-user setup; never logs in or starts an AI conversation. */
-import { spawnSync } from 'node:child_process';
-import { accessSync, constants, copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from 'node:fs';
+import { spawn, spawnSync } from 'node:child_process';
+import { accessSync, constants, copyFileSync, existsSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from 'node:fs';
 import { homedir, tmpdir } from 'node:os';
 import { basename, delimiter, dirname, isAbsolute, join, resolve } from 'node:path';
-import { createInterface } from 'node:readline/promises';
 import { fileURLToPath } from 'node:url';
 import { parseArgs } from 'node:util';
 
-import { agy_rule, atomic_json } from './discussion_adapters.mjs';
+import { atomic_json } from './discussion_adapters.mjs';
 import { launch_settings, save_launch_settings } from './discussion_launch.mjs';
 import { service_home } from './discussion_service.mjs';
 import { install_skills } from './discussion_skills.mjs';
-export { agy_rule } from './discussion_adapters.mjs';
+import { ask, checkbox_prompt, intro, outro, pad, short_path, spinner, step, styled, text_width, tone } from './discussion_tui.mjs';
+export { checkbox_prompt } from './discussion_tui.mjs';
 
 const ROOT = fileURLToPath(new URL('../', import.meta.url));
+const PACKAGE = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'));
 const PROBE_TIMEOUT = 10000;
 const MIN_NODE_MAJOR = 24;
 const DEFAULT_PORT = 8765;
@@ -30,7 +31,7 @@ const CLIENTS = {
 const OPTIONS = { yes: { type: 'boolean' }, clients: { type: 'string' }, python: { type: 'string' },
   codex: { type: 'string' }, claude: { type: 'string' }, antigravity: { type: 'string' }, cursor: { type: 'string' },
   port: { type: 'string' }, prefix: { type: 'string' }, 'skills-home': { type: 'string' },
-  'no-start': { type: 'boolean' }, 'no-open': { type: 'boolean' }, help: { type: 'boolean', short: 'h' } };
+  'no-start': { type: 'boolean' }, 'no-open': { type: 'boolean' }, json: { type: 'boolean' }, help: { type: 'boolean', short: 'h' } };
 const HELP = `用法：codiscuss install [选项] / codiscuss setup [选项]
 install 将当前 npm 包安装为持久命令，再运行 setup；setup 配置已有安装。
   --yes                     使用已检测且支持自动接入的软件，冲突保留并报告
@@ -44,7 +45,7 @@ install 将当前 npm 包安装为持久命令，再运行 setup；setup 配置
 Gemini 使用 agy；Grok 使用 Cursor CLI（agent / cursor-agent）。仅检测 CLI。
 Cursor 当前只安装技能，可手动参与；全自动接入尚未提供。已有软件设置保留。
 显式软件路径可更新已支持的 CLI 配置。安装不会开始讨论。
-结果输出 JSON，中文摘要写入 stderr；退出码 0=完成，2=配置待处理，1=失败。
+中文摘要写入 stderr；输出被重定向或加 --json 时结果 JSON 写入 stdout；退出码 0=完成，2=配置待处理，1=失败。
 `;
 
 /** Read local settings stored outside the npm installation. */
@@ -64,6 +65,13 @@ function setup_environment(options) {
   return { home, previous, python, port };
 }
 
+/** Summarise the checked runtime in one short line for the styled installer. */
+function environment_line(python, port) {
+  const probe = spawnSync(python, ['-c', 'import sys; print(".".join(map(str, sys.version_info[:3])))'],
+    { encoding: 'utf8', windowsHide: true, timeout: PROBE_TIMEOUT });
+  return `Node ${process.version.slice(1)} · Python ${probe.stdout?.trim() || short_path(python)} · 端口 ${port}`;
+}
+
 /** Find executable PATH entries, explicitly allowing Cursor's Windows .cmd launcher. */
 function path_program(name, search_path = process.env.PATH || '', allow_cmd = false) {
   const suffixes = process.platform === 'win32' ? (allow_cmd ? ['.exe', '.cmd'] : ['.exe']) : [''];
@@ -140,15 +148,13 @@ export function detect_clients(options = {}, search_path = process.env.PATH || '
 /** Select detected clients interactively or through explicit noninteractive options. */
 async function selected_clients(options, detected) {
   let choice = options.clients;
-  const available = detected.filter(item => item.executable);
-  const defaults = available.filter(item => item.adapter);
-  for (const item of detected) process.stderr.write(`${item.name}：${item.executable || '未检测到 CLI'}\n`);
   if (choice === undefined && !options.yes) {
     if (!process.stdin.isTTY) throw new Error('非交互终端请使用 --yes 或 --clients；只配置网站可用 --clients none。');
-    const prompt = createInterface({ input: process.stdin, output: process.stderr });
-    try { choice = await prompt.question(`选择软件（逗号分隔，回车选择 ${defaults.map(item => item.key).join(',') || 'none'}）：`); }
-    finally { prompt.close(); }
-  }
+    const items = detected.map(item => ({ label: item.name, hint: item.executable ? short_path(item.executable) : '未检测到 CLI',
+      checked: Boolean(item.executable && item.adapter), disabled: !item.executable }));
+    const checked = await checkbox_prompt('选择要接入的软件', items);
+    choice = detected.filter((_, index) => checked[index]).map(item => item.key).join(',') || 'none';
+  } else if (!styled) for (const item of detected) process.stderr.write(`${item.name}：${item.executable || '未检测到 CLI'}\n`);
   return requested_clients(choice, detected);
 }
 
@@ -181,12 +187,9 @@ async function choose_profile(client, current, options) {
   const differs = current && (current.adapter !== client.adapter || !same_executable(current.executable, client.executable));
   let update = Boolean(options[client.key]), acknowledged = false;
   if (differs && !update && !options.yes && process.stdin.isTTY) {
-    const prompt = createInterface({ input: process.stdin, output: process.stderr });
-    try {
-      const choice = await prompt.question(`${client.name} 已有配置：${current.adapter || '未设置类型'} / ${current.executable || '未设置路径'}\n检测到 CLI：${client.executable}\n保留已有配置或更新为此 CLI？[保留/更新，默认保留]：`);
-      update = ['更新', 'update', 'u'].includes(choice.trim().toLowerCase());
-      acknowledged = !choice.trim() || ['保留', 'keep', 'k'].includes(choice.trim().toLowerCase());
-    } finally { prompt.close(); }
+    const choice = await ask(`${client.name} 已有配置：${current.adapter || '未设置类型'} / ${current.executable || '未设置路径'}\n检测到 CLI：${client.executable}\n保留已有配置或更新为此 CLI？`, '[保留/更新，默认保留]');
+    update = ['更新', 'update', 'u'].includes(choice.trim().toLowerCase());
+    acknowledged = !choice.trim() || ['保留', 'keep', 'k'].includes(choice.trim().toLowerCase());
   }
   if (differs && !update) return { client: client.name, status: acknowledged ? 'retained' : 'pending',
     effective: { adapter: current.adapter, executable: current.executable }, detected,
@@ -194,65 +197,44 @@ async function choose_profile(client, current, options) {
   return { client: client.name, status: 'configured', effective: detected };
 }
 
-/** Allow answer files only; service runtime data never belongs to the managed write rule. */
-export function agy_rules(home) {
-  // Verified with agy 1.4.2 on Windows: the rule matches forward slashes with the drive letter kept.
-  const drafts = join(resolve(home), 'drafts').replaceAll('\\', '/');
-  return [agy_rule(), `write_file(${drafts})`];
-}
-
-/** Ask once before adding the rules; --yes counts as consent, other noninteractive runs only report. */
-async function agy_consent(path, rules, options) {
-  if (options.yes) return true;
-  if (!process.stdin.isTTY) return false;
-  const prompt = createInterface({ input: process.stdin, output: process.stderr });
-  try {
-    const answer = await prompt.question(`允许 Gemini（agy）在全自动讨论中执行讨论命令并写讨论草稿？将向 ${path} 的 permissions.allow 追加 ${rules.length} 条只匹配讨论命令与草稿目录的规则 [Y/n]：`);
-    return !['n', 'no', '否'].includes(answer.trim().toLowerCase());
-  } finally { prompt.close(); }
-}
-
-/** Keep the installer-managed allow rules current, never touching other settings or user rules. */
-export async function allow_agy_command(home, user_home, options) {
-  const path = join(user_home, ...AGY_SETTINGS);
+/**
+ * Remove global agy rules that earlier versions added; agy permissions now live only in each discussion project.
+ * Only rules recorded by the installer are removed, after a backup; other settings and user rules stay untouched.
+ */
+export function remove_legacy_agy_rules(home, user_home) {
   const record = join(home, AGY_RULE_RECORD);
-  const rules = agy_rules(home);
+  if (!existsSync(record)) return null;
+  const path = join(user_home, ...AGY_SETTINGS);
+  const saved = JSON.parse(readFileSync(record, 'utf8'));
+  const legacy = saved.rules || (saved.rule ? [saved.rule] : []);
   let settings = {};
   try { if (existsSync(path)) settings = JSON.parse(readFileSync(path, 'utf8')); }
-  catch { return { status: 'invalid', path, rules }; }
+  catch { return { client: 'Gemini', status: 'invalid', path }; }
   const allow = settings.permissions?.allow ?? [];
-  if (!Array.isArray(allow)) return { status: 'invalid', path, rules };
-  const saved = existsSync(record) ? JSON.parse(readFileSync(record, 'utf8')) : {};
-  const previous = saved.rules || (saved.rule ? [saved.rule] : []);
-  const stale = previous.some(rule => !rules.includes(rule) && allow.includes(rule));
-  mkdirSync(home, { recursive: true });
-  if (rules.every(rule => allow.includes(rule)) && !stale) {
-    if (previous.join('\n') !== rules.join('\n')) atomic_json(record, { rules });
-    return { status: 'unchanged', path, rules };
+  if (!Array.isArray(allow)) return { client: 'Gemini', status: 'invalid', path };
+  const next = allow.filter(rule => !legacy.includes(rule));
+  if (next.length !== allow.length) {
+    copyFileSync(path, join(home, AGY_SETTINGS_BACKUP));
+    atomic_json(path, { ...settings, permissions: { ...settings.permissions, allow: next } });
   }
-  if (!await agy_consent(path, rules, options)) return { status: options.yes || process.stdin.isTTY ? 'declined' : 'pending', path, rules };
-  mkdirSync(dirname(path), { recursive: true });
-  if (existsSync(path)) copyFileSync(path, join(home, AGY_SETTINGS_BACKUP));
-  const next = [...allow.filter(item => !previous.includes(item) && !rules.includes(item)), ...rules];
-  atomic_json(path, { ...settings, permissions: { ...settings.permissions, allow: next } });
-  atomic_json(record, { rules });
-  return { status: 'allowed', path, rules };
+  rmSync(record);
+  return { client: 'Gemini', status: next.length !== allow.length ? 'removed' : 'unchanged', path };
 }
 
 /** Save the selected effective profiles and copy complete skills without overwriting edits. */
 async function configure_clients(home, selected, options, existing) {
   const participants = { ...existing };
-  const skills = [], profiles = [], permissions = [];
+  const skills = [], profiles = [];
   const user_home = resolve(options['skills-home'] || homedir());
   for (const client of selected) {
     const profile = await choose_profile(client, participants[client.name], options);
     profiles.push(profile);
     if (profile.status === 'configured') participants[client.name] = { ...participants[client.name], ...profile.effective };
     skills.push({ client: client.name, results: install_skills(join(user_home, ...client.skills)) });
-    if (client.key === 'antigravity') permissions.push({ client: client.name, ...await allow_agy_command(home, user_home, options) });
   }
   save_launch_settings(home, { participants });
-  return { skills, profiles, permissions };
+  const legacy = remove_legacy_agy_rules(home, user_home);
+  return { skills, profiles, permissions: legacy ? [legacy] : [] };
 }
 
 /** Exclude npm exec's temporary command wrappers when checking persistent availability. */
@@ -291,8 +273,7 @@ function setup_issues(result) {
     if (skill.status === 'conflict') issues.push(`${group.client} 技能冲突，已保留 ${skill.path}；请核对并移走需替换的旧副本，再运行 setup。`);
   }
   for (const permission of result.permissions) {
-    if (permission.status === 'invalid') issues.push(`${permission.client} 设置文件无法解析，未写入讨论命令规则：${permission.path}；修复后重新运行 setup。`);
-    if (['declined', 'pending'].includes(permission.status)) issues.push(`${permission.client} 未放行讨论命令，全自动讨论会被拦截；运行 codiscuss setup --clients antigravity --yes 授权。`);
+    if (permission.status === 'invalid') issues.push(`${permission.client} 设置文件无法解析，未能移除旧版全局放行规则：${permission.path}；修复后重新运行 setup，否则全自动讨论会拒绝交付给 agy。`);
   }
   if (result.command.status !== 'ready') issues.push(result.command.action);
   return issues;
@@ -300,10 +281,19 @@ function setup_issues(result) {
 
 /** Configure Python, selected clients and skills, returning partial results on startup failure. */
 async function setup(options) {
+  intro('配置 AI CoDiscuss', PACKAGE.version, PACKAGE.description);
   const { home, previous, python, port } = setup_environment(options);
-  const selected = await selected_clients(options, detect_clients(options));
+  if (styled && !process.env.CODISCUSS_TUI_NESTED) step('运行环境就绪', [environment_line(python, port)]);
+  const scan = spinner('检测已安装的 AI 软件');
+  const detected = detect_clients(options);
+  const width = Math.max(...detected.map(item => text_width(item.name)));
+  const listed = options.clients !== undefined || options.yes
+    ? detected.map(item => `${pad(item.name, width)}  ${tone.dim(item.executable ? short_path(item.executable) : '未检测到 CLI')}`) : [];
+  scan.done(`检测到 ${detected.filter(item => item.executable).length} 个可接入的 CLI`, listed);
+  const selected = await selected_clients(options, detected);
   const configured = await configure_clients(home, selected, options, launch_settings(home).participants);
   atomic_json(join(home, 'local-settings.json'), { ...previous, python, port });
+  step('已写入软件配置与技能', configured.skills.map(group => `${pad(group.client, width)}  ${tone.dim(short_path(dirname(group.results[0].path)))}`));
   const result = { home, python, clients: selected.map(item => item.name), ...configured,
     command: check_command(), ai_verified: false };
   result.issues = setup_issues(result);
@@ -311,10 +301,13 @@ async function setup(options) {
   result.status = result.configured ? 'configured' : 'needs_attention';
   if (!options['no-start']) {
     const { local_main } = await import('./discussion_local.mjs');
+    const launch = spinner('启动本机网站与讨论服务');
     try {
       result.local = await local_main([options['no-open'] ? 'start' : 'open'], () => {});
+      launch.done('网站与讨论服务已在后台运行');
       if (result.configured) result.status = 'ready';
     } catch (error) {
+      launch.fail(error.message);
       result.status = 'start_failed';
       result.issues.push(`本机启动失败：${error.message}；配置已保存，修复后重新运行 setup。`);
     }
@@ -323,7 +316,8 @@ async function setup(options) {
 }
 
 /** Print a concise human receipt while keeping stdout machine-readable. */
-function report_setup(result) {
+function report_setup(result, options = {}) {
+  if (styled) return report_styled(result, options);
   const labels = { ready: '安装配置完成，网站与讨论服务已就绪', configured: '配置完成，本次未启动网站',
     needs_attention: '配置待处理', start_failed: '本机启动失败' };
   const lines = [labels[result.status]];
@@ -331,16 +325,42 @@ function report_setup(result) {
     ? `${profile.client}：仅安装技能，可手动参与，尚不支持全自动接入。`
     : `${profile.client}：${profile.status === 'configured' ? 'CLI 已配置' : '沿用已有配置'}（${profile.effective.adapter} / ${profile.effective.executable || '未设置路径'}）`);
   for (const permission of result.permissions) {
-    if (['allowed', 'unchanged'].includes(permission.status)) lines.push(`${permission.client}：已放行讨论命令（${permission.path}）`);
+    if (permission.status === 'removed') lines.push(`${permission.client}：已移除旧版全局放行规则（${permission.path}）`);
   }
   for (const group of result.skills) lines.push(`${group.client} Skill：${group.results.filter(skill => skill.status !== 'conflict').length}/${group.results.length} 份文件就绪，目录 ${dirname(group.results[0].path)}`);
   if (result.command.path) lines.push(`持久命令：${result.command.path}（${result.command.status}）`);
-  if (result.local?.running) lines.push(`本机网站：${result.local.url}`);
+  if (result.local?.running) {
+    lines.push(`本机网站：${result.local.url}${options['no-open'] ? '' : '（已在浏览器打开）'}`,
+      '网站与讨论服务在后台运行，关闭此终端不影响；查看状态 codiscuss local status，停止 codiscuss local stop；电脑重启后运行 codiscuss local open 重新启动。');
+  }
   lines.push(...result.issues, '真实 AI 执行尚未验证；可从网页创建讨论，或在新会话调用 Skill。');
   if (result.skills.length) lines.push('若新会话未发现技能，请让 AI 读取上述目录内的 discuss-host/SKILL.md 和 discuss-participant/SKILL.md。');
   process.stderr.write(`${lines.join('\n')}\n`);
 }
 
+/** Close the styled installer with aligned results, open issues and the commands to manage the site. */
+function report_styled(result, options) {
+  const titles = { ready: ['安装完成', tone.green('◆')], configured: ['配置完成，本次未启动网站', tone.green('◆')],
+    needs_attention: ['配置完成，仍有待处理项', tone.yellow('▲')], start_failed: ['本机启动失败', tone.red('■')] };
+  const [title, mark] = titles[result.status];
+  const rows = [];
+  if (result.local?.running) rows.push(['网站', tone.cyan(result.local.url), options['no-open'] ? '' : '已在浏览器打开']);
+  for (const profile of result.profiles) rows.push(profile.status === 'manual' ? [profile.client, '仅安装技能，可手动参与', '尚不支持全自动接入']
+    : [profile.client, `${profile.status === 'configured' ? 'CLI 已配置' : '沿用已有配置'} · ${profile.effective.adapter}`, short_path(profile.effective.executable) || '未设置路径']);
+  for (const permission of result.permissions) {
+    if (permission.status === 'removed') rows.push([permission.client, '已移除旧版全局放行规则', short_path(permission.path)]);
+  }
+  if (result.skills.length) rows.push(['技能', result.skills.map(group => `${group.client} ${group.results.filter(skill => skill.status !== 'conflict').length}/${group.results.length}`).join(' · '), 'discuss-host · discuss-participant · discuss-report']);
+  if (result.command.path) rows.push(['命令', `codiscuss ${tone.dim(`(${result.command.status})`)}`, short_path(result.command.path)]);
+  const notes = result.issues.map(issue => tone.yellow(`▲ ${issue}`));
+  if (result.local?.running) notes.push(tone.dim('网站与讨论服务在后台运行，关闭此终端不影响'),
+    `${tone.cyan('codiscuss local status')}  ${tone.dim('查看状态')}`, `${tone.cyan('codiscuss local stop')}    ${tone.dim('停止')}`,
+    `${tone.cyan('codiscuss local open')}    ${tone.dim('重启电脑后重新启动')}`);
+  const closing = result.local?.running ? `在网页新建讨论，或在 AI 会话里调用 ${tone.cyan('discuss-host')} ${tone.dim('· 真实 AI 执行尚未验证')}`
+    : `运行 ${tone.cyan('codiscuss local open')} 启动网站`;
+  outro(title, rows, notes, closing, mark);
+}
+
 /** Locate npm's JavaScript entrypoint so paths with spaces never need shell quoting. */
 function npm_entry() {
   const candidates = [process.env.npm_execpath, join(dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js'),
@@ -352,31 +372,44 @@ function npm_entry() {
   return entry;
 }
 
-/** Execute npm without lifecycle scripts; surface actionable npm errors. */
+/** Execute npm without lifecycle scripts asynchronously, so a progress spinner can animate. */
 function npm_run(entry, args) {
-  const result = spawnSync(process.execPath, [entry, ...args], { encoding: 'utf8', windowsHide: true });
-  if (result.status !== 0) throw new Error(result.stderr || result.error?.message || 'npm 执行失败');
-  return result.stdout.trim();
+  return new Promise((done, fail) => {
+    const child = spawn(process.execPath, [entry, ...args], { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
+    let stdout = '', stderr = '';
+    child.stdout.on('data', data => { stdout += data; });
+    child.stderr.on('data', data => { stderr += data; });
+    child.on('error', fail);
+    child.on('close', code => (code === 0 ? done(stdout.trim()) : fail(new Error(stderr || 'npm 执行失败'))));
+  });
 }
 
 /** Install a real package copy, never a symlink into a disposable npx cache. */
-function install(args, options) {
-  setup_environment(options);
+async function install(args, options) {
+  intro('安装 AI CoDiscuss', PACKAGE.version, PACKAGE.description);
+  const { python, port } = setup_environment(options);
   requested_clients(options.clients, detect_clients(options));
+  if (styled) step('运行环境就绪', [environment_line(python, port)]);
   const entry = npm_entry();
   const temporary = mkdtempSync(join(tmpdir(), 'codiscuss-install-'));
   const prefix = options.prefix ? ['--prefix', resolve(options.prefix)] : [];
+  const progress = spinner('安装 codiscuss 命令');
   try {
-    const packed = JSON.parse(npm_run(entry, ['pack', ROOT, '--ignore-scripts', '--json', '--pack-destination', temporary]));
-    npm_run(entry, ['install', '--global', ...prefix, '--omit=dev', '--ignore-scripts', '--no-audit', '--no-fund', join(temporary, packed[0].filename)]);
-    const installed = join(npm_run(entry, ['root', '--global', ...prefix]), 'ai_co_discuss', 'runner', 'codiscuss.mjs');
-    const install_prefix = npm_run(entry, ['prefix', '--global', ...prefix]);
-    process.stderr.write(`命令目录：${process.platform === 'win32' ? install_prefix : join(install_prefix, 'bin')}\n`);
+    const packed = JSON.parse(await npm_run(entry, ['pack', ROOT, '--ignore-scripts', '--json', '--pack-destination', temporary]));
+    await npm_run(entry, ['install', '--global', ...prefix, '--omit=dev', '--ignore-scripts', '--no-audit', '--no-fund', join(temporary, packed[0].filename)]);
+    // npm masks UUID-like path segments as *** in its output, so an explicit prefix is resolved locally.
+    const install_prefix = options.prefix ? resolve(options.prefix) : await npm_run(entry, ['prefix', '--global']);
+    const global_root = process.platform === 'win32' ? join(install_prefix, 'node_modules') : join(install_prefix, 'lib', 'node_modules');
+    const installed = join(global_root, 'ai_co_discuss', 'runner', 'codiscuss.mjs');
+    const directory = process.platform === 'win32' ? install_prefix : join(install_prefix, 'bin');
+    progress.done('已安装 codiscuss 命令', [tone.dim(short_path(directory))]);
+    if (!styled) process.stderr.write(`命令目录：${directory}\n`);
     const result = spawnSync(process.execPath, [installed, 'setup', ...args], { stdio: 'inherit', windowsHide: true,
-      env: { ...process.env, PATH: persistent_search_path() } });
+      env: { ...process.env, PATH: persistent_search_path(), CODISCUSS_TUI_NESTED: '1' } });
     process.exitCode = result.status ?? 1;
     if (result.error) throw result.error;
-  } finally { rmSync(temporary, { recursive: true, force: true }); }
+  } catch (error) { progress.fail(error.message); throw error; }
+  finally { rmSync(temporary, { recursive: true, force: true }); }
 }
 
 /** Dispatch bootstrap or setup, leaving website and launch commands untouched. */
@@ -385,8 +418,8 @@ export async function setup_main(command, args) {
   if (values.help) return process.stdout.write(HELP);
   if (command === 'install') return install(args, values);
   const result = await setup(values);
-  report_setup(result);
-  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  report_setup(result, values);
+  if (values.json || !process.stdout.isTTY) process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   process.exitCode = result.status === 'start_failed' ? 1 : result.status === 'needs_attention' ? ATTENTION_EXIT_CODE : 0;
   return result;
 }

package/runner/discussion_tui.mjs

@@ -0,0 +1,171 @@
+/** Installer presentation: a styled gutter on an interactive terminal, the original plain lines otherwise. */
+import { homedir } from 'node:os';
+import { sep } from 'node:path';
+import { emitKeypressEvents } from 'node:readline';
+import { createInterface } from 'node:readline/promises';
+
+const PATH_WIDTH = 56;
+const SPIN_FRAMES = ['◒', '◐', '◓', '◑'];
+const SPIN_MS = 80;
+const LOGO = [
+  ['█▀▀', '█▀█', '█▀▄', '█', '█▀▀', '█▀▀', '█ █', '█▀▀', '█▀▀'],
+  ['█  ', '█ █', '█ █', '█', '▀▀█', '█  ', '█ █', '▀▀█', '▀▀█'],
+  ['▀▀▀', '▀▀▀', '▀▀ ', '▀', '▀▀▀', '▀▀▀', '▀▀▀', '▀▀▀', '▀▀▀'],
+];
+const PREFIX_LETTERS = 2;
+const GRADIENT = [[91, 140, 255], [167, 139, 250], [240, 171, 252]];
+
+export const styled = Boolean(process.stderr.isTTY) && !process.env.NO_COLOR;
+const paint = (code, text) => (styled ? `\x1b[${code}m${text}\x1b[0m` : text);
+export const tone = {
+  dim: text => paint('2', text), bold: text => paint('1', text), cyan: text => paint('36', text),
+  green: text => paint('32', text), yellow: text => paint('33', text), red: text => paint('31', text),
+  gray: text => paint('90', text),
+};
+const bar = () => tone.gray('│');
+const write = text => process.stderr.write(text);
+
+/** Display width that counts CJK and fullwidth characters as two terminal columns. */
+export function text_width(text) {
+  let width = 0;
+  for (const char of text.replace(/\x1b\[[0-9;]*m/g, '')) {
+    const code = char.codePointAt(0);
+    width += (code >= 0x1100 && code <= 0x115f) || (code >= 0x2e80 && code <= 0xa4cf)
+      || (code >= 0xac00 && code <= 0xd7a3) || (code >= 0xf900 && code <= 0xfaff)
+      || (code >= 0xfe30 && code <= 0xfe4f) || (code >= 0xff00 && code <= 0xff60) || (code >= 0xffe0 && code <= 0xffe6) ? 2 : 1;
+  }
+  return width;
+}
+
+/** Shorten a path for display: home becomes ~ and long middles collapse to …, keeping both ends readable. */
+export function short_path(path, max = PATH_WIDTH) {
+  const home = homedir();
+  const value = path && path.toLowerCase().startsWith(home.toLowerCase()) ? `~${path.slice(home.length)}` : path || '';
+  if (value.length <= max) return value;
+  const parts = value.split(/([\\/])/);
+  const separator = parts[1] || sep;
+  const names = parts.filter((_, index) => index % 2 === 0);
+  return [...names.slice(0, 2), '…', ...names.slice(-2)].join(separator);
+}
+
+/** Pad a label to a display width so mixed Chinese and Latin columns line up. */
+export const pad = (text, width) => text + ' '.repeat(Math.max(0, width - text_width(text)));
+
+/** Colour one wordmark row along a left-to-right gradient; the "co" prefix stays neutral. */
+function logo_row(letters) {
+  const prefix = letters.slice(0, PREFIX_LETTERS).join(' ');
+  const rest = `${letters.slice(PREFIX_LETTERS).join(' ')}`;
+  const chars = [...rest];
+  const shade = index => {
+    const position = (index / Math.max(1, chars.length - 1)) * (GRADIENT.length - 1);
+    const [from, to] = [GRADIENT[Math.floor(position)], GRADIENT[Math.ceil(position)]];
+    const mix = position - Math.floor(position);
+    return from.map((value, channel) => Math.round(value + (to[channel] - value) * mix)).join(';');
+  };
+  return `${paint('38;2;122;127;138', prefix)} ${chars.map((char, index) => (char === ' ' ? char : paint(`38;2;${shade(index)}`, char))).join('')}`;
+}
+
+/** Print the wordmark and open the gutter; a nested setup run skips it. */
+export function intro(title, version, tagline) {
+  if (!styled || process.env.CODISCUSS_TUI_NESTED) return;
+  write(`\n${LOGO.map(row => `   ${logo_row(row)}`).join('\n')}\n`);
+  write(`   ${tone.dim(`${tagline} · v${version}`)}\n\n${tone.gray('┌')}  ${tone.bold(title)}\n${bar()}\n`);
+}
+
+/** Print a finished step with optional detail lines; plain mode leaves output to the caller. */
+export function step(title, lines = [], mark = tone.green('◇')) {
+  if (!styled) return;
+  write(`${mark}  ${title}\n${lines.map(line => `${bar()}  ${line}\n`).join('')}${bar()}\n`);
+}
+
+/** Animate a step while asynchronous work runs; synchronous work simply shows the first frame. */
+export function spinner(title) {
+  if (!styled) return { done: () => {}, fail: () => {} };
+  let frame = 0;
+  const render = () => write(`\r\x1b[2K${tone.cyan(SPIN_FRAMES[frame++ % SPIN_FRAMES.length])}  ${title}${tone.dim('…')}`);
+  render();
+  const timer = setInterval(render, SPIN_MS);
+  const clear = () => { clearInterval(timer); write('\r\x1b[2K'); };
+  return {
+    done: (next = title, lines = []) => { clear(); step(next, lines); },
+    fail: message => { clear(); step(tone.red(title), [tone.red(message)], tone.red('■')); },
+  };
+}
+
+/** Ask one free-text question inside the gutter, falling back to a plain prompt. */
+export async function ask(question, hint = '') {
+  const prompt = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    if (!styled) return await prompt.question(`${question}${hint}：`);
+    write(`${tone.cyan('◆')}  ${question.split('\n').join(`\n${bar()}  `)}\n`);
+    const answer = await prompt.question(`${bar()}  ${tone.dim(hint)} ${tone.cyan('›')} `);
+    write(`${bar()}\n`);
+    return answer;
+  } finally { prompt.close(); }
+}
+
+/** Draw one checkbox row; disabled rows are dimmed and cannot be focused. */
+function checkbox_row(item, focused, checked) {
+  const pointer = focused ? tone.cyan('›') : ' ';
+  if (item.disabled) return `${bar()} ${pointer} ${tone.gray(`○ ${item.label}`)}  ${tone.gray(item.hint)}`;
+  const box = checked ? tone.green('◼') : tone.dim('◻');
+  return `${bar()} ${pointer} ${box} ${focused ? tone.bold(item.label) : item.label}  ${tone.dim(item.hint)}`;
+}
+
+/**
+ * Render a terminal checkbox list: arrows move, space toggles, enter confirms, Ctrl+C cancels.
+ * @param {{label: string, hint: string, checked: boolean, disabled: boolean}[]} items
+ * @returns {Promise<boolean[]>} The checked state of every item.
+ */
+export function checkbox_prompt(message, items, input = process.stdin, output = process.stderr) {
+  const checked = items.map(item => item.checked && !item.disabled);
+  const width = Math.max(...items.map(item => text_width(item.label)));
+  const rows = items.map(item => ({ ...item, label: pad(item.label, width) }));
+  let cursor = Math.max(0, items.findIndex(item => !item.disabled)), drawn = 0;
+  const move = offset => {
+    for (let next = cursor + offset; next >= 0 && next < items.length; next += offset) {
+      if (!items[next].disabled) { cursor = next; return; }
+    }
+  };
+  const draw = (lines) => {
+    if (drawn) output.write(`\x1b[${drawn}A`);
+    output.write(`${lines.map(line => `\x1b[2K${line}`).join('\n')}\n`);
+    if (lines.length < drawn) output.write(`\x1b[J`);
+    drawn = lines.length;
+  };
+  const active = () => [`${tone.cyan('◆')}  ${message}`, ...rows.map((item, index) => checkbox_row(item, index === cursor, checked[index])),
+    `${tone.gray('└')}  ${tone.dim('↑↓ 移动 · 空格 勾选 · 回车 确认')}`];
+  return new Promise((done, fail) => {
+    const finish = error => {
+      input.off('keypress', on_key);
+      input.setRawMode(false);
+      input.pause();
+      const chosen = items.filter((_, index) => checked[index]).map(item => item.label).join('、') || '不接入软件，只配置网站';
+      draw(error ? [`${tone.red('■')}  ${message}`, `${bar()}  ${tone.dim('已取消')}`] : [`${tone.green('◇')}  ${message}`, `${bar()}  ${tone.dim(chosen)}`, bar()]);
+      output.write('\x1b[?25h');
+      if (error) fail(error); else done(checked);
+    };
+    const on_key = (_text, key = {}) => {
+      if (key.ctrl && key.name === 'c') return finish(new Error('已取消安装选择'));
+      if (key.name === 'up' || key.name === 'k') move(-1);
+      else if (key.name === 'down' || key.name === 'j') move(1);
+      else if (key.name === 'space' && !items[cursor]?.disabled) checked[cursor] = !checked[cursor];
+      else if (key.name === 'return' || key.name === 'enter') return finish();
+      draw(active());
+    };
+    emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+    input.on('keypress', on_key);
+    output.write('\x1b[?25l');
+    draw(active());
+  });
+}
+
+/** Close the gutter with a titled block of aligned rows, notes and a final line. */
+export function outro(title, rows, notes, closing, mark = tone.green('◆')) {
+  const width = Math.max(0, ...rows.map(([label]) => text_width(label)));
+  const body = [...rows.map(([label, value, detail]) => [`${tone.dim(pad(label, width))}  ${value}`,
+    ...(detail ? [`${' '.repeat(width)}  ${tone.dim(detail)}`] : [])]).flat(), ...(notes.length ? ['', ...notes] : [])];
+  write(`${mark}  ${tone.bold(title)}\n${bar()}\n${body.map(line => `${bar()}  ${line}\n`).join('')}${bar()}\n${tone.gray('└')}  ${closing}\n\n`);
+}