min-agent 3.19.2610251655 → 3.21.2610252017

package/README.md

@@ -48,7 +48,10 @@ min-agent models      # list the models your provider offers
 min-agent "your message"        # start a session and send a message (agent mode)
 min-agent ask "your question"   # start in ask mode — web Q&A & search only
 min-agent exec "your message"   # one-shot question, then exit (--quiet/--json for scripts)
-min-agent push                  # shortcut: stage all changes, commit and push the current branch
+min-agent push                  # lightweight shortcut: stage, commit and push (no MCP/skills/rules/memory, no session saved)
+min-agent commit                # lightweight shortcut: stage and commit, no push
+min-agent git                  # interactive: provider → model → thinking for commit/push (independent of agent config)
+min-agent light                # interactive: switch → provider → model → thinking; `light off` pauses it
 min-agent --resume <id>         # resume a previous session
 min-agent --continue            # resume the most recent session
 min-agent sessions              # list saved sessions (--all shows every entry, --json for scripts)
@@ -75,6 +78,7 @@ Type `/` to open the command menu; **↑/↓** selects. On an empty input, **↑
 | `/plan` | Plan mode — look, don't touch |
 | `/think` · `/ctx` | Thinking intensity · local-model context window |
 | `/memory` | Toggle memory or save a note |
+| `/light` | Pick the lighter model: switch, provider, model, then thinking |
 | `/undo` · `/diff` | Undo last turn · show changes so far |
 | `/queue` | List, drop or clear messages waiting behind the running turn |
 | `/attach` · `/mcp` · `/skills` | Attach an image · MCP servers · skills |
@@ -83,7 +87,7 @@ Type `/` to open the command menu; **↑/↓** selects. On an empty input, **↑
 
 The input box stays live while the agent works: press Enter and the message joins a queue that runs in order once the current turn ends (the status bar and spinner show the backlog). Use `/queue` to inspect it, `/queue rm <n>` to pull one out, `/queue clear` to drop them all; Esc cancels the running turn and drops the queue. Slash commands never enter that queue. A reply that degenerates into repeating the same block of text is cut off automatically, with a notice, and the repetition is not saved to the history. If a change already passed its check but the agent keeps building scratch harnesses or re-verifying it, it is nudged once to wrap up and then stopped, rather than spinning for hours.
 
-Commands that only read state or write config — `/permission`, `/sandbox`, `/memory`, `/plan`, `/ask`, `/agent`, `/reload`, `/rename`, and the picker commands given an argument (`/model <id>`, `/think low`, `/ctx 8k`, …) — run immediately even mid-turn, so a permission change applies to the very next tool call instead of waiting behind the whole turn. Commands that would mutate the conversation or open an overlay (`/undo`, `/new`, `/compact`, `/model`, `/models`, …) are refused mid-turn with a notice; they never queue as a user message.
+Commands that only read state or write config — `/permission`, `/sandbox`, `/memory`, `/plan`, `/ask`, `/agent`, `/reload`, `/rename`, and the picker commands given an argument (`/model <id>`, `/think low`, `/light off`, `/ctx 8k`, …) — run immediately even mid-turn, so a permission change applies to the very next tool call instead of waiting behind the whole turn. Commands that would mutate the conversation or open an overlay (`/undo`, `/new`, `/compact`, `/model`, `/light`, `/models`, …) are refused mid-turn with a notice; they never queue as a user message.
 
 Shortcuts: **Ctrl+C** clears input (press twice to exit) · **Shift+Enter** / **Ctrl+J** inserts a newline · **Ctrl+V** pastes an image · **Ctrl+B** copies selected text · **Ctrl+O** expands the tool or thinking row in view · click a tool or thinking block to expand it.
 
@@ -136,6 +140,8 @@ Settings live in `~/.min-agent/config.json` (global). Per-project settings go to
 
 `min-agent settings` prints every active setting in one screen — value, where it comes from (default / global / project / env / this run) and which file to edit.
 
+An optional lighter model (`light.model`, provider optional) shortens long conversations, names the session, tidies long search results, and files notes when memory is on. Leave it empty to keep using the current model. In a terminal, `min-agent light` walks through the switch, provider, model, then thinking intensity; without a terminal it prints the current setting. `min-agent light off` turns it off and keeps the saved model; `min-agent light on` turns it back on. Leave thinking unset to keep it off. In chat, `/light` opens the same picker; `/light on` and `/light off` still change the switch directly.
+
 Conversation history is saved per working directory by default, in `~/.min-agent/sessions/<project-key>/sessions/` — still inside the global config dir, never in the project. To share one history across projects, run `min-agent scope global` (or `/scope global`); `min-agent scope` shows the current setting.
 
 ## Extending It
@@ -183,7 +189,10 @@ min-agent models      # 查看当前服务商可用的模型
 min-agent "你的消息"            # 进入交互会话并立即发送消息（agent 模式）
 min-agent ask "你的问题"        # 以 ask 模式进入——仅联网问答与搜索
 min-agent exec "你的消息"       # 单次提问后自动退出（--quiet / --json 适合脚本）
-min-agent push                  # 快捷指令：暂存全部改动并提交推送当前分支
+min-agent push                  # 轻量快捷指令：暂存提交并推送当前分支（跳过 MCP/技能/规则/记忆，不保存会话）
+min-agent commit                # 轻量快捷指令：暂存并提交，不推送
+min-agent git                  # 交互式选择 commit/push 的 服务商 → 模型 → 思考强度（不受 agent 配置影响）
+min-agent light                # 交互式选择轻量模型：开关 → 服务商 → 模型 → 思考强度
 min-agent --resume <id>        # 恢复之前的会话
 min-agent --continue           # 继续最近一次会话
 min-agent sessions             # 查看已保存的会话（--all 显示全部，--json 机器可读输出）
@@ -210,6 +219,7 @@ min-agent --provider anthropic "..."   # 为一条消息指定服务商
 | `/plan` | 计划模式——只看不改 |
 | `/think` · `/ctx` | 思考强度 · 本地模型上下文窗口 |
 | `/memory` | 开关记忆，或保存一条 |
+| `/light` | 逐步选择轻量模型：开关、服务商、模型、思考强度 |
 | `/undo` · `/diff` | 撤销上一轮 · 查看已产生的改动 |
 | `/queue` | 查看、移出或清空排在当前任务后面的消息 |
 | `/attach` · `/mcp` · `/skills` | 附加图片 · MCP 服务 · 技能 |
@@ -218,7 +228,7 @@ min-agent --provider anthropic "..."   # 为一条消息指定服务商
 
 任务执行时输入框依然可用：按 Enter 会把消息排进队列，当前任务结束后按顺序执行（运行提示行显示排队数量）。`/queue` 查看队列，`/queue rm <序号>` 移出一条，`/queue clear` 全部清空；Esc 取消当前任务，并丢弃排队消息。斜杠命令不会进入消息队列。模型输出陷入重复循环（同一段文字连续重复）时会自动截断本轮并提示，重复内容不会写入历史。改动已通过检查后若仍在反复搭临时脚本/重复验证，会先提醒一次收尾，仍未停止则结束本轮，避免长时间空转。
 
-只读取状态或只写配置的命令——`/permission`、`/sandbox`、`/memory`、`/plan`、`/ask`、`/agent`、`/reload`、`/rename`，以及带参数的选择类命令（`/model <id>`、`/think low`、`/ctx 8k` 等）——在任务执行中也会立即执行：改完确认模式马上对下一次工具调用生效，不必等整轮结束。会改动对话内容或打开浮层的命令（`/undo`、`/new`、`/compact`、`/model`、`/models` 等）在任务执行中会被拒绝并提示等本轮结束，不会作为用户消息排队。
+只读取状态或只写配置的命令——`/permission`、`/sandbox`、`/memory`、`/plan`、`/ask`、`/agent`、`/reload`、`/rename`，以及带参数的选择类命令（`/model <id>`、`/think low`、`/light off`、`/ctx 8k` 等）——在任务执行中也会立即执行：改完确认模式马上对下一次工具调用生效，不必等整轮结束。会改动对话内容或打开浮层的命令（`/undo`、`/new`、`/compact`、`/model`、`/light`、`/models` 等）在任务执行中会被拒绝并提示等本轮结束，不会作为用户消息排队。
 
 快捷键：**Ctrl+C** 清空输入（连按两次退出）· **Shift+Enter** / **Ctrl+J** 换行 · **Ctrl+V** 粘贴图片 · **Ctrl+B** 复制选中的文本 · **Ctrl+O** 展开视图中间的工具/思考行 · 点击工具或思考块可展开收起。
 
@@ -273,6 +283,8 @@ min-agent models     # 查看当前服务商可用的模型
 
 `min-agent settings` 一屏列出所有生效设置——当前值、来源（默认 / 全局 / 项目 / 环境变量 / 本次运行）以及该改哪个文件。
 
+可以另外指定一个轻量模型（`light.model`，服务商可以不填）。它用来压缩较长的对话、给会话起标题、整理过长的搜索结果，以及在开启记忆后整理要记住的内容。留空则这些事情仍使用当前模型。在终端里运行 `min-agent light` 会先选择开关，再选择服务商、模型和思考强度；没有终端时只显示当前设置。`min-agent light off` 关掉开关并保留已选模型，`min-agent light on` 再打开。思考强度留空则关闭。对话里输入 `/light` 会打开同样的逐步选择；`/light on` 和 `/light off` 仍可以直接开关。
+
 对话历史默认按工作目录保存：`~/.min-agent/sessions/<project-key>/sessions/`，同样在全局配置目录下，不会写进项目目录。想让所有项目共用一个历史，执行 `min-agent scope global`（或对话中 `/scope global`）；`min-agent scope` 查看当前设置。
 
 ## 扩展能力