min-agent 0.5.1 → 0.6.0

package/docs/superpowers/specs/2026-08-23-cli-setup-design.md

@@ -1,282 +0,0 @@
-# CLI setup 向导改版 — 设计文档
-
-**日期:** 2026-08-23
-**状态:** 已批准
-**范围:** `min-agent setup` 作为全局 Provider 向导与管理器；TTY 下未配置的交互会话可直进同一套首次向导。不改 HTTP API、权限/沙箱/思考/记忆命令、`init`。
-
----
-
-## 背景
-
-当前 `runSetup()` 写在 `config.ts` 里，用 `readline` 编号问卷：一次只能做一步，默认「完成」什么都不改；首次强制名叫 `default`；不能删除、不能改名、不收集 `contextWindow`；模型列表整表打印、不可筛选（与 TUI `/model` 脱节）；已有 API Key 会当默认值回显；校验失败 `process.exit(1)`；无非交互 flag；无测试。未配置时 `min-agent` 只打印 `Not configured. Run: min-agent setup` 并退出。
-
-`permission` / `sandbox` / `think` / `memory` 已有独立命令；`init` 只建 `.min-agent/`。setup 不应变成第二套设置中心。
-
-## 设计决策（已与用户确认）
-
-| 决策 | 结论 |
-|------|------|
-| 方案 | B：Provider 向导 + 可循环管理器，不把权限/沙箱/思考/记忆塞进向导 |
-| UI | 一次性 Ink 应用；不抽 `ModelPicker`（它绑在会话 overlay 上） |
-| `config.ts` | 只留读写、`fetchModels`、`isConfigured`、`getActiveProvider`；向导搬走 |
-| Flag 命名 | setup 不用 `--model`（根命令已占用）；写入默认模型用 `--default-model` |
-| `--yes` | 复用根上已有 `-y/--yes`，setup 里表示跳过覆盖/删除确认，不改 permission |
-| 未配置会话 | TTY：直进首次向导（无单独 readline Y/n）；非 TTY：保持硬错误 |
-| 密钥 | 只写 `~/.min-agent/config.json`；本轮不做 `setup --project` |
-| 文案 | 向导/管理器中文；CLI `--help` 描述保持英文 |
-
-## 目标与非目标
-
-**目标:**
-
-- 安装后在 TTY 上两分钟内能配好一个可用 Provider 并进入对话
-- 再次运行 setup 是循环管理器（添加 / 切换 / 修改 / 删除 / 测连），不是一次性问卷
-- 模型列表可筛选，交互质量与 `/model` 同级
-- flag 齐了可不进向导，便于脚本
-- 完整 Key 不出现在终端输出
-- 纯函数与非交互路径可测；Ink 全向导不在 CI 里跑
-
-**非目标:**
-
-- Anthropic 原生协议
-- setup 内配置权限、沙箱、思考、记忆
-- 项目级密钥或 `setup --project`
-- 把 setup 做成全配置 TUI
-- 本轮做 i18n
-- 抽出跨 TUI/setup 的共用 picker 组件
-
----
-
-## 1. 模块边界
-
-```
-src/cli/commands/setup.ts          入口：解析 flag，分流非交互 / Ink
-src/cli/setup/flow.ts              编排：首次向导、管理器循环、未配置衔接
-src/cli/setup/provider-form.ts     纯函数：校验、默认名、重名、写入形状
-src/cli/setup/detect.ts            短超时探测本机 Ollama（GET /api/tags）
-src/cli/setup/ui.tsx               一次性 Ink 向导
-```
-
-`fetchModels` 仍在 `config.ts`。模型缓存改为按 `baseURL` 分桶（文件仍叫 `models-cache.json`，值为 `Record<string, string[]>`，key 为规范化后的 baseURL）。若现有文件是旧的 `string[]` 或无法解析，视为空缓存并在下次成功拉取后按新格式覆盖。**setup 的测连与向导里的「是否拉到列表」走实时请求，成功才更新缓存；失败或空列表不得把过期缓存当成成功。** `min-agent models` 与 TUI `/model` 仍可在实时失败时回退该 provider 自己的缓存。
-
-向导用 `ink.render()`，结束即 `unmount`。从会话进来时：向导结束且 `isConfigured()` 后，再启动现有 TUI（两段串行，不同时占 stdin）。
-
-非 TTY 不启动 Ink。
-
----
-
-## 2. CLI 表面
-
-根命令已有 `--model`（本轮模型）和 `--yes`（本轮全部允许）。Commander 把同名 option 解析到根上，setup **不得**再声明 `--model`。
-
-setup 子命令自己的参数：
-
-| Flag | 含义 |
-|------|------|
-| `--type <type>` | `openai-compatible` / `openai` / `ollama` |
-| `--url <url>` | Base URL |
-| `--api-key <key>` | 密钥（ollama 可省） |
-| `--name <name>` | Provider 名 |
-| `--default-model <id>` | 写入配置的默认模型 |
-| `--context-window <n>` | 可选 token 窗口，须 ≥ 1 的整数 |
-| `--switch <name>` | 只切换 `activeProvider` |
-| `--remove <name>` | 删除 |
-
-`--yes` / `-y`：setup 通过 `program.opts().yes`（与其它子命令读根 option 的方式一致）读取。在 setup 中表示跳过覆盖/删除确认，不调用 `setAutoApprove`。
-
-**非交互判定：** 出现 `--type`、`--switch`、`--remove` 任一则不进向导。`--type` 与 `--switch` / `--remove` 同时出现 → `CliError`（一次只做一件事）。
-
-命令描述（help）：`Configure providers (interactively, or with flags)`。
-
----
-
-## 3. 谁会进向导
-
-| 入口 | 未配置 + TTY | 未配置 + 非 TTY |
-|------|----------------|-----------------|
-| `min-agent` / `chat` / `code` / 直接带一句 | 首次向导，成功后再进 TUI | `Not configured.` 退出 1，hint `Run: min-agent setup` |
-| `min-agent setup` | 向导（已有可用 Provider 则管理器） | 必须带 `--type` / `--switch` / `--remove`，否则退出 1 |
-| `exec` / `serve` / `models` | **不**进向导 | 同左 |
-
-`isConfigured()` 不变：当前 Provider 同时有 `baseURL` 与 `apiKey`。
-
-现有 `cli-invoke.test.ts` 对空 argv 使用 `stdin: "ignore"`，继续走非 TTY 硬错误，语义不变。
-
-从会话直进向导时，第一屏为 S0（开始配置 / 退出）。用户直接跑 `min-agent setup` 时跳过 S0。不在 Ink 之前再用 readline 问 Y/n。
-
-带首条 prompt、`--resume` 或 `-i` 的未配置会话：向导成功后，把原有 session 参数原样交给 `startTuiSession`（prompt 仍作为第一轮立刻发送）。向导退出则不启动 TUI、不发送。
-
----
-
-## 4. 首次向导
-
-Esc / Ctrl+C 任意一步退出且不写盘。
-
-**S0 未配置入口**（仅从会话直进）
-
-- 选项：开始配置 / 退出
-- 退出或 Esc → 退出码 1，hint：`min-agent setup`
-
-**S1 类型**
-
-- OpenAI 兼容接口
-- OpenAI
-- Ollama（本地）
-
-`detect.ts` 在 800ms 内请求 `http://localhost:11434/api/tags`。成功则 Ollama 项旁标注「已检测到」，默认光标落在它上面；否则默认「兼容接口」。探测失败静默，不报错。
-
-**S2 连接信息**
-
-| 类型 | 问什么 | 默认 |
-|------|--------|------|
-| openai-compatible | URL → Key（掩码） | URL：`https://api.openai.com/v1` |
-| openai | 只问 Key | URL 写死 `https://api.openai.com/v1` |
-| ollama | 只问 URL | 探测成功用探测到的地址（补 `/v1`），否则 `http://localhost:11434/v1`；Key 固定 `ollama` |
-
-URL 空、非 ollama 且 Key 空 → 本屏报错，不前进。Ollama URL 走现有 `normalizeOllamaBaseURL`。
-
-**S3 拉模型**
-
-显示「正在获取模型列表…」。实时请求失败或空列表 → S3b，不当成成功。
-
-- **S3a 有列表：** 可筛选选择器（输入过滤、↑↓、Enter、Esc 回 S2）。过滤无匹配时 Enter 把当前输入当模型名。
-- **S3b 无列表：** 「无法获取模型列表，请手动输入」。预填：ollama `llama3`，openai `gpt-4o`，兼容接口空。空提交不允许。仅兼容接口在此之后问窗口：跳过 / 手动输入 ≥ 1 的整数。ollama / openai 不问（运行时探测）。
-
-**S4 名称**
-
-预填 `suggestName(type, url, existingNames)`：
-
-- `openai` → `openai`
-- `ollama` → `ollama`
-- 兼容接口 → URL 主机名去掉 `www.`，`.` 换成 `-`；解析失败则 `provider`
-- 与已有名冲突 → `openai-2`、`openai-3`…
-
-空提交用预填。非法名（空、含 `/` 或 `:`）本屏报错。
-
-**S5 摘要 + 写入**
-
-展示类型、URL、Key 掩码、模型、名称。确认后追加到 `providers`，`activeProvider` 设为该名。`saveConfig` 原子写，保留未知字段。成功后打印实际保存路径。从会话进来则接着启动 TUI。
-
-首次也不再写死名称 `default`。
-
----
-
-## 5. 管理器循环
-
-已有至少一个可用 Provider 时进入。选完一项（除「完成」）后回到列表，直到主动退出。
-
-**H0 列表**
-
-每行：`名称  URL  默认模型`，当前项标 `*`。动作：添加 / 设为当前 / 修改 / 删除 / 测试连接 / 完成。
-
-| 动作 | 行为 |
-|------|------|
-| 添加 | S1–S5；成功后设为当前并回 H0 |
-| 设为当前 | 仅一个则提示无需切换；多个则选一个，立刻 `saveConfig`，回 H0 |
-| 修改 | 先选目标（默认当前），再 S1–S4，名称默认原名。改名冲突则本屏报错。Key 空提交 = 保留原 Key，占位「已保存 (…xxxx)，回车保留」。若改的是当前项且改了名，同步 `activeProvider` |
-| 删除 | 选目标 → 确认屏回显名称。删的是当前项则 `activeProvider` 改为剩余第一项；删光则去掉 `activeProvider`，下次进入变首次向导。无 `--yes` 必须确认 |
-| 测试连接 | 选目标 → 实时拉列表。成功：「可访问，N 个模型」。失败：HTTP 状态 + 一句可执行提示（检查地址、密钥，或确认 Ollama 已启动）。不把缓存当成功 |
-| 完成 / Esc | 退出码 0（直接跑 setup 时） |
-
-管理器内每次成功操作立刻写盘。Esc 只退出向导，不回滚已保存的步骤。
-
----
-
-## 6. 非交互
-
-| 动作 | 必填 | 失败 |
-|------|------|------|
-| `--type ollama` | 无。URL 默认本地。模型：实时拉到则用第一个，否则 `llama3` | 名称冲突且无 `--yes` |
-| `--type openai` | `--api-key`。无 `--default-model` 则实时拉列表取第一，再没有则报错 | Key 空；模型仍空 |
-| `--type openai-compatible` | `--url`、`--api-key`。模型规则同 openai | URL/Key 空；模型仍空 |
-| `--switch` | 名字必须存在 | 找不到 |
-| `--remove` | 名字必须存在。非 TTY 且无 `--yes` 则拒绝 | 找不到；TTY 无 `--yes` 则进入确认（若已判定非交互且非 TTY，直接失败） |
-
-同名已存在：交互问覆盖 / 换名；非交互必须 `--yes` 才覆盖，否则退出 1。
-
-`--url` 对 ollama 仍做 `normalizeOllamaBaseURL`。`--name` 缺省时用 `suggestName`。`--context-window` 若给出则写入该 Provider。
-
-添加失败不写盘。覆盖与删除才改已有条目。
-
----
-
-## 7. 错误与安全
-
-向导/管理器标题：「配置服务商」。字段「名称」不用 Provider 当主文案。
-
-| 场景 | 文案 | 码 |
-|------|------|-----|
-| 非 TTY 未配置（会话） | `Not configured.` / hint `Run: min-agent setup` | 1 |
-| 非 TTY 无 flag 的 setup | `无法在非交互环境完成配置。` / hint 列出可用 flag | 1 |
-| `--type` 与 `--switch`/`--remove` 同时出现 | `一次只能执行一种操作。` | 1 |
-| 缺字段 | `API 密钥不能为空。` / `API 地址不能为空。` / `默认模型不能为空。` | 1 |
-| 名称不合法 | `名称不能为空，且不能包含 / 或 :。` | 1 |
-| 同名且非交互无 `--yes` | `已存在同名服务商 "x"。` / hint `加上 --yes 以覆盖` | 1 |
-| `--switch`/`--remove` 找不到 | `找不到服务商 "x"。` | 1 |
-| 非 TTY 删除无 `--yes` | `删除需要确认。` / hint `加上 --yes` | 1 |
-| `--context-window` 非法 | `上下文窗口必须是大于 0 的整数。` | 1 |
-| 测连失败 | `无法连接到该服务商。` + 状态码 + 下一句可执行提示 | 管理器内不退出进程 |
-| 非交互添加时拉模型失败且无 `--default-model` | 网络/探测异常用码 2；openai 类模型仍空用码 1 | 1 或 2 |
-| 向导 Esc / 选退出 | 不写盘。从会话进来：码 1 + hint `min-agent setup`。直接 `setup`：码 0 | — |
-| 保存成功 | `已保存到 <实际路径>` | 0 |
-
-校验用 `CliError`，不再在 collect 路径里 `process.exit`。完整 Key 不进 stdout/stderr/摘要；只显示 `…` + 末 4 位（短于 4 位则全掩码为 `****`）。测连错误体若含 `Bearer` 或 `sk-` 形态则剥掉。
-
----
-
-## 8. 测试
-
-**纯函数**（`provider-form.ts`、名称建议、掩码；`detect` 用 mock `fetch`）：
-
-- 默认名：openai / ollama / 主机名 / 冲突后缀
-- 非法名、重名覆盖、改名同步 `activeProvider`
-- 删除当前项后的 `activeProvider`；删光后 `isConfigured() === false`
-- ollama 不需要 Key；兼容接口缺 URL/Key 失败
-- 写入 JSON 保留未知字段
-- 掩码：空、短于 4 位、正常 Key
-
-**非交互 CLI**（隔离 `MIN_AGENT_CONFIG_DIR`，stdin ignore）：
-
-- `setup --type ollama` 写入后可配置
-- `setup --type openai --api-key k --default-model gpt-4o`
-- 缺 Key 退出 1
-- 同名无 `--yes` 失败；有 `--yes` 覆盖
-- `--switch` / `--remove --yes`
-- `--type` + `--remove` 互斥
-- 非 TTY 无 flag 的 `setup` 退出 1 且不写盘
-- 完整 Key 不出现在 stdout/stderr
-- 空 argv 未配置仍 `Not configured`（现有用例保持）
-
-**分流：** `flow.ts` 注入 `isTty`，断言非 TTY 不 `render`。列表过滤抽纯函数单测。不在 CI 跑完整 Ink 向导，不打真实 OpenAI/Ollama。
-
-**缓存：** 按 baseURL 分桶；A 的缓存不能被 B 读到。测连失败不把缓存当成功。
-
----
-
-## 9. 文档同步
-
-必须改：
-
-- `README.md` 中英：setup 仍是引导配置服务商；增加非交互三例（ollama、兼容接口、`--switch`）；不写内部模块名
-- `src/cli/program.ts` 帮助：setup 一行带常用 flag；Examples 加一条非交互
-- `skills/self-config/SKILL.md` Providers：CLI `min-agent setup` 及 `--type` / `--url` / `--api-key` / `--name` / `--default-model` / `--switch` / `--remove`；`--yes` 在 setup 中表示跳过确认
-- `skills/self-config/reference.md`：字段不变；补一句交互与非交互添加都走 setup，密钥只写全局
-
-不改：
-
-- `docs/API.md`（HTTP 无 setup 接口）
-- `exec` / `serve` / `models` 的未配置硬错误
-- TUI `/help`（无 setup 斜杠命令）
-- 权限 / 沙箱 / 思考 / 记忆命令
-
-slash 里「运行 min-agent setup」可保留。
-
----
-
-## 10. 实现顺序建议
-
-1. `provider-form.ts` + 缓存分桶 + 测试
-2. 非交互 `setup` flag 与 CLI 测试
-3. Ink 首次向导 + 管理器
-4. 会话未配置 TTY 衔接
-5. README / help / self-config

package/docs/superpowers/specs/2026-08-23-input-paste-attachments-design.md

@@ -1,174 +0,0 @@
-# 输入框粘贴图片与文本片段设计
-
-日期: 2026-08-23
-状态: 已批准（方案 1：输入框内原子标记）
-
-## 问题
-
-交互会话的输入框不能把剪贴板图片挂到当前草稿：贴图只能 `/paste`（立刻发送）或 `/attach <路径>`。多行文本粘贴会整段铺进输入框，末尾换行还可能被当成 Enter 误发送。
-
-## 目标
-
-1. 剪贴板图片用 Ctrl+V 插到光标处，显示为 `[图片 #N]`，写完说明再 Enter 发送
-2. 一次粘贴只要超过一行，收成 `[粘贴 #N · X 行]`，发送时带上全文
-3. 单行粘贴仍直接插入
-4. 标记在输入框里是原子块：左右移、退格、Delete、点击都不拆开
-5. 只有附件、没打字也可以发送
-
-## 不做
-
-- 不改 HTTP `/v1/paste`，不新增配置项，不改 `skills/self-config`
-- 不把 Cmd+V 从终端抢过来（macOS 贴图用 Ctrl+V）
-- 不把附件正文写入 `input-history.json`
-- 不做拖拽文件进终端、不做输入框内 Shift 选区
-- `/paste [t]` 仍是立刻发送剪贴板图片，不改成挂草稿
-
-## 设计决策
-
-| 决策 | 结论 |
-|------|------|
-| 呈现 | 草稿字符串里每个附件一个私有区码点；屏幕上画成标记 |
-| 文本门槛 | 规范化后仍含换行 → 片段；否则当普通字插入 |
-| 贴图快捷键 | Ctrl+V 读系统剪贴板；无图时静默 |
-| `/paste` | 保持立刻发送 |
-| 斜杠命令 | `display` 去空白后以 `/` 开头则走现有命令处理，附件不进入对话 |
-| 历史 | 只存展开后的短标记字面量，不存图片/长文；翻历史不会恢复附件 |
-
----
-
-## 1. 数据模型
-
-`InputBar` 继续用 `{ value, caretIndex }`。`caretIndex` 仍是 `Array.from(value)` 的码点下标。
-
-每个附件占用 **一个** Unicode 私有区码点，从 `U+E000` 起按插入顺序分配，本条草稿内不复用。旁路表：
-
-```ts
-type DraftAttachment =
-  | { kind: "image"; id: number; data: Buffer; mimeType: string }
-  | { kind: "snippet"; id: number; text: string; lineCount: number }
-```
-
-`id` 按类型分开从 1 递增：`[图片 #1]` 与 `[粘贴 #1 · 3 行]` 可以同时存在。
-
-屏幕标记（用户可见，无实现细节）：
-
-- 图片：`[图片 #${id}]`
-- 片段：`[粘贴 #${id} · ${lineCount} 行]`
-
-未在旁路表中的私有区字符按宽 1 的 `�` 绘制，不当附件。
-
-每次编辑后扫描 `value`：旁路表里码点已不在 `value` 中的条目删除（退格、Ctrl+U/K/W、Ctrl+C 清空都走这条）。Ctrl+C 清空或提交成功后：`value` 清空，旁路表清空，两个计数器回到 1。
-
-折行与点击：该码点是一个 cluster，显示宽度为 `min(displayWidth(标记), 输入区宽度)`。过宽时单独占一行，绘制时末尾用 `…` 截断；点击该行任一单元格都落在这一个码点上。硬件光标列用展开后的显示宽度计算，与现有 IME 锚点一致。
-
----
-
-## 2. 文本粘贴
-
-挂载输入框时打开 bracketed paste（`CSI ? 2004 h`），卸载时关闭（`CSI ? 2004 l`），与现有鼠标协议一起写 stdout。
-
-在 InputBar 已有的 raw stdin 监听里拼包：`ESC[200~` 起、`ESC[201~` 止。包收齐前 `useInput` 丢掉这段输入（含 Ink 剥掉 ESC 后的 `[200~` / `[201~` 碎片），避免插两遍，也避免粘贴里的换行走现有「末尾 `\r`/`\n` 当 Enter」逻辑。
-
-粘贴正文处理（纯函数，可单测）：
-
-1. `\r\n` 与 `\r` 全部变成 `\n`
-2. 去掉**末尾一个** `\n`（编辑器复制常带）
-3. 若仍含 `\n`：分配片段码点，插入光标处，`lineCount = text.split("\n").length`
-4. 否则：当普通文本插入（与打字相同）
-
-片段正文上限 **1_000_000** 个 UTF-16 码元。超过则不插入，系统提示 `粘贴内容过大，未附加`。
-
-单行过长仍插入，不收成片段。
-
----
-
-## 3. 图片粘贴
-
-`useInput` 在现有 `Ctrl+B` 之后、吞掉其它 Ctrl 组合之前处理 `key.ctrl && input === "v"`：调用已有 `getClipboardImage()`。
-
-- 有图且 `data.length <=` 现有 `MAX_IMAGE_BYTES`（5MB）：插入图片码点，MIME 用剪贴板返回值
-- 有图但超过 5MB：提示 `图片超过 5MB，未附加`，不插入
-- 无图：静默返回（不提示），避免想贴字时误按 Ctrl+V 刷警告
-
-Mac 上 Cmd+V 仍由终端注入文字。README 与 `/help` 写明贴图用 Ctrl+V。
-
----
-
-## 4. 编辑
-
-因为每个标记是一个码点，现有 `moveCaretHorizontal` / `backspaceAt` / `deleteAt` 已整块移动或删除。`Ctrl+W` / `Ctrl+K` / `Ctrl+U` 按现有「删一段字符串」处理，事后扫描丢掉孤儿附件。
-
-点击：先按展开后的显示列命中 cluster，再映射回 `value` 码点下标；点在标记上时 caret 落在该码点前（与现在点在某字前一致），再按右键一次跳过整块。
-
-Enter：`display` 去空白后非空，**或**旁路表非空，即可发送。发送后清空草稿与表。
-
----
-
-## 5. 提交与展示
-
-`onSubmit` 改为接收一次提交的结构化结果：
-
-```ts
-type SubmittedPrompt = {
-  display: string
-  content: string | Array<{ type: "text"; text: string } | { type: "image"; image: Buffer; mimeType: string }>
-}
-```
-
-`display`：把 `value` 里的附件码点换成标记文案，用于对话区用户气泡和输入历史。
-
-`content` 按 `value` 从左到右展开：
-
-- 连续普通字合成一个 `text` part
-- 片段换成一个 `text` part，正文前后各单独一行分隔：`--- 粘贴 #${id} ---`
-- 图片一个 `image` part（`Buffer` + `mimeType`）
-
-若没有任何图片 part，`content` 收成单个字符串（与现在 `messages.push({ content: text })` 兼容）。有图片则为数组。
-
-`tui-chat`：`addMessage` 用 `display`；`messages.push({ role: "user", content })` 用 `content`。`lastUserMessage` 存 `display`。
-
-`display` 去空白后以 `/` 开头：原样交给现有 `handleSlashCommand`，旁路表丢弃、不写入 `messages`（避免 `/help` 误带一张图）。否则按上面的 `content` 入列。
-
-超限提示不进输入框正文：`InputBar` 增加 `onNotice(text: string)`，`tui-chat` 接到现有系统消息通道（与 `/paste` 失败提示同一处）。
-
-输入历史：`pushInput` 写入 `display`（短标记，无二进制、无片段全文）。从历史上召回的标记是普通字符，旁路表为空。
-
----
-
-## 6. 文件与同步
-
-| 文件 | 改动 |
-|------|------|
-| `src/tui/paste-draft.ts`（新） | 规范化粘贴、单行/多行判定、码点分配、展开 `display`/`content`、孤儿回收；无 React |
-| `src/tui/bracketed-paste.ts`（新） | 从 stdin 块里扫描 bracketed paste 包 |
-| `src/tui/caret-pos.ts` / `text-width.ts` | cluster 宽度可注入「此码点显示宽」；`visualRows` / 点击换算认识附件宽 |
-| `src/tui/InputBar.tsx` | 打开/关闭 bracketed paste、粘贴包、Ctrl+V、旁路表、`onNotice`、按新规则提交 |
-| `src/tui/index.tsx` / `App.tsx` | `onSubmit` 改为 `SubmittedPrompt`；透传 `onNotice` |
-| `src/tui-chat.ts` | 按 `display`/`content` 入列；斜杠判定见上；`onNotice` 走系统消息 |
-| `src/tui/slash-handler.ts` | `/help` 快捷键增加 Ctrl+V 贴图、多行粘贴收成片段 |
-| `README.md` | 中英快捷键各补一句 |
-| `docs/API.md` | 不改（TUI 便利，协议不变） |
-
-`/paste`、`/attach`、CLI `-i` 行为不变。
-
----
-
-## 7. 测试
-
-纯函数（`tests/paste-draft.test.ts`、`tests/bracketed-paste.test.ts`，必要时扩 `tests/caret-pos.test.ts`）：
-
-- 单行；`a\nb`；`a\nb\n` 去掉末尾换行后仍是两行片段；仅 `hello\n` → 单行插入
-- 片段展开顺序：字 + 图 + 片段不错位；无图时 `content` 为字符串
-- 删除码点后旁路表回收；清空后计数从 1 再起
-- 超 1_000_000 码元拒绝；标记过宽时点击仍落在该码点
-- bracketed paste 扫描：跨 chunk、内含 `\n`/`\r`、无结束符时保持缓冲
-
-`InputBar` 不测 Ink 渲染。stdin 夹具覆盖：粘贴多行不提交；粘贴中的 `useInput` 碎片不插入。
-
-## 错误文案
-
-| 情况 | 文案 |
-|------|------|
-| 图片 > 5MB | `图片超过 5MB，未附加` |
-| 片段 > 1_000_000 码元 | `粘贴内容过大，未附加` |
-| Ctrl+V 无图 | （无文案） |

package/docs/superpowers/specs/2026-08-23-thinking-wire-profile-design.md

@@ -1,140 +0,0 @@
-# 思考线协议适配 — 设计文档
-
-**日期:** 2026-08-23
-**状态:** 已批准（启发式 + 400 改参重试并缓存）
-
-## 问题
-
-用户配置是统一的 `off | low | medium | high | max`，但上游 chat 请求的思考字段因模型和网关而异。min-agent 目前一律发送：
-
-```json
-{ "reasoning_effort": "<档位>", "thinking": { "type": "enabled" | "disabled" } }
-```
-
-MiniMax-M3（经 Console Go 等网关）只接受 `thinking.type` 为 `adaptive` 或 `disabled`，收到 `enabled` 会 400。官方 OpenAI 则可能根本不认 `thinking` 对象。
-
-模型目录（`models.lonae.com`）只提供上下文窗口和 effort 列表，**不提供** `thinking.type` 的合法取值。MiniMax-M3 的 `reasoningOptions` 甚至是空数组，目录查找成功也无法避免这次 400。
-
-## 目标
-
-1. 用户侧配置、`/think`、CLI `--think`、HTTP `/v1/thinking` 仍只用五档英文强度，不暴露 `adaptive` / `enabled` / `xhigh`
-2. 发出请求前按 `(providerHost, modelId)` 选择线协议：启发式先发对
-3. 若仍 400 且错误可解析为思考字段约束，静默改 profile、**同一请求只重试一次**，并把学到的 profile 写入本地缓存
-4. 目录继续只负责窗口和档位列表；线协议与目录解耦
-
-## 不做
-
-- 不扩展 Lonae catalog schema
-- 不把 `adaptive` 放进 `/think` 选择器或配置值
-- 不为 MiniMax-M3 把选择器收成「开/关」（非 `off` 一律当开思考；档位无深度时仍发对应 `reasoning_effort`，由上游忽略）
-- 不重试非思考类 400，不二次以上重试
-- 不把 wire profile 写入 `config.json`
-- 不改变 compaction、reasoning 流式折叠、TUI 思考块展示
-
-## 设计决策
-
-| 决策 | 结论 |
-|------|------|
-| 用户配置 | 仍是 `off\|low\|medium\|high\|max`；`thinkingEnabled = thinking !== "off"` |
-| 线协议层 | 独立 wire profile，不塞进 Lonae 缓存条目 |
-| 解析顺序 | 学习缓存 → 启发式 → 默认 `enabled-disabled` + `reasoning_effort` |
-| 注入点 | 现有 `modelFetch` / `withThinkingBody`，可读写 URL 与 JSON body |
-| 400 | 仅当 body 可解析为思考字段约束时改 profile 并重试一次；对用户静默 |
-| 缓存文件 | `~/.min-agent/thinking-wire-cache.json`（`MIN_AGENT_CONFIG_DIR` 下同路径），TTL 7 天 |
-| OpenAI 官方 | `provider.type === "openai"` → 不发 `thinking` 对象 |
-| MiniMax | `modelId` 或 hostname 含 `minimax`（大小写不敏感）→ `adaptive-disabled` |
-
----
-
-## 1. Wire profile
-
-```ts
-type ThinkingTypeMode = "enabled-disabled" | "adaptive-disabled" | "omit"
-type EffortMode = "reasoning_effort" | "omit"
-
-interface ThinkingWireProfile {
-  version: 1
-  thinkingType: ThinkingTypeMode
-  effort: EffortMode
-  timestamp: number
-}
-```
-
-`applyThinkingToChatBody(body, spec, profile)`：
-
-- `effort === "reasoning_effort"`：写 `reasoning_effort`（现有 `toWireEffort` 结果）；`omit` 则删除该键
-- `thinkingType === "omit"`：删除 `thinking`
-- 否则写 `thinking.type`：开思考时 `enabled` 或 `adaptive`，关思考时 `disabled`
-
-`ThinkingRequestBody` 仍表示用户意图（`reasoningEffort` + `thinkingEnabled`），不把 profile 放进 ALS。fetch 时用请求 URL 的 host 和 body 里的 `model` 解析 profile。
-
-缓存键：`${hostname.toLowerCase()}::${modelId.toLowerCase()}`。hostname 从请求 URL 取；取不到则只用 `modelId`。
-
----
-
-## 2. 启发式
-
-在学习缓存未命中时：
-
-1. `modelId` 或 hostname 包含 `minimax` → `{ thinkingType: "adaptive-disabled", effort: "reasoning_effort" }`
-2. 当前 provider `type === "openai"` → `{ thinkingType: "omit", effort: "reasoning_effort" }`
-3. 否则 → `{ thinkingType: "enabled-disabled", effort: "reasoning_effort" }`
-
-启发式结果不写磁盘。只有 400 学到的 profile 才持久化，以便覆盖错误启发式。
-
-`toWireEffort` 规则不变：`off` → `none`；`max` 仍按目录/`openai` 映射 `xhigh`。
-
----
-
-## 3. 400 探测
-
-仅处理 chat completions 的 JSON body 请求。流程：
-
-1. 按当前 profile 注入后 `fetch`
-2. 若 `response.ok` 或状态不是 400：原样返回（仍走现有 `foldReasoningInChatResponse`）
-3. 读 400 body（`text()`）。用纯函数 `parseThinkingWireHint(text)` 得到对 profile 的补丁
-4. 补丁相对当前 profile **有变化** 才更新内存+磁盘，用新 profile 重写 body，**重试一次**
-5. 第二次无论成败都不再为思考字段重试；失败则把第二次响应交给 SDK（若第二次未发出，把第一次 400 用已读文本重建 `Response`）
-
-`parseThinkingWireHint` 识别：
-
-| 错误文本形态 | 补丁 |
-|--------------|------|
-| `thinking.type` 且 `allowed` 列表含 `adaptive` 与 `disabled` | `thinkingType: "adaptive-disabled"` |
-| `thinking.type` 且 `allowed` 含 `enabled` 与 `disabled` | `thinkingType: "enabled-disabled"` |
-| `Unknown parameter` / `unknown parameter` 指向 `thinking` | `thinkingType: "omit"` |
-| 同上指向 `reasoning_effort` | `effort: "omit"` |
-
-列表解析忽略大小写与空白。无法识别或补丁无变化 → 不重试。
-
-并发：两个请求可能同时 400 再各写一次缓存，可接受，不引入锁。内存 Map + 磁盘与 `model-catalog` 相同模式。TTL 7 天；过期条目当未命中，可再次学习。`version !== 1` 的条目忽略。
-
----
-
-## 4. 错误与界面
-
-重试对用户不可见：没有「改参」「adaptive」提示。两次都失败时沿用现有 `AI_APICallError` 展示。
-
-`/think`、状态栏「思考 high」、HTTP `GET/POST /v1/thinking` 的字段与文案不变。
-
----
-
-## 5. 文档与测试
-
-同步：
-
-- `skills/self-config/SKILL.md`：请求按模型/网关映射 `thinking` / `reasoning_effort`，并提及学习缓存文件；不写探测实现细节
-- `skills/self-config/reference.md`：环境变量表旁可注明缓存文件名（若该文件已列目录缓存）
-- `docs/API.md`：用户可见 thinking 枚举不变；不必描述 wire 字段
-- `README.md`：不增加线协议说明
-- `/help`：不改
-
-测试（纯函数 + fetch 包装）：
-
-- `applyThinkingToChatBody` 三种 `thinkingType` × 开/关、`effort` omit
-- 启发式：minimax 模型名、minimax host、openai type、默认
-- `parseThinkingWireHint`：本次 MiniMax 原文、unknown parameter、无法识别
-- fetch：400 可解析 → 第二次请求 body 已改且只发两次；不可解析 → 只发一次
-- 缓存读写、过期、version 不匹配
-
-实现落点：`src/thinking.ts` 扩展拼 body 与 hint 解析；新建 `src/thinking-wire.ts`（profile 解析、启发式、缓存）以免 `thinking.ts` 再膨胀；`src/provider.ts` 的 `modelFetch` 接 400 重试。测试放 `tests/thinking.test.ts` 与 `tests/thinking-wire.test.ts`。