min-agent 0.6.2 → 0.6.4

package/README.md

@@ -35,8 +35,8 @@
 
 ```bash
 npm install -g min-agent
-min-agent             # start chatting (a built-in model is ready)
-min-agent setup       # optional: add or switch your own provider
+min-agent             # start chatting (built-in OpenRouter model, preset & locked)
+min-agent models      # list models (always openrouter/free)
 ```
 
 ## Usage
@@ -70,7 +70,9 @@ Shortcuts: **Ctrl+C** clears input (press twice to exit) · **Ctrl+V** pastes an
 
 ## Staying in Control
 
-File edits are auto-approved by default; risky actions always ask.
+File edits are auto-approved by default; risky actions always ask. When several actions in one step need approval, they're combined into a single prompt instead of a stack of separate ones.
+
+`min-agent exec` (one-shot) runs more freely by default: edits and ordinary commands don't ask — only genuinely destructive commands (deleting files/dirs, dropping/truncating databases, disk-wiping, `git reset --hard`, etc.) still prompt. Pass `--permission` or `--yes` to override.
 
 ```bash
 min-agent permission                 # show current setting
@@ -93,14 +95,14 @@ In chat: `/memory on|off` toggles, `/memory` lists notes, `/memory some text` sa
 
 ## Configuration
 
-No setup needed — a built-in OpenRouter model (`openrouter/free`) is used until you add your own:
+No setup needed — the built-in OpenRouter provider (`openrouter/free`) is preset and locked:
 
 ```bash
-min-agent setup --type ollama
-min-agent setup --type openai-compatible --url https://api.example.com/v1 --api-key "$KEY" --name groq --default-model llama-3.1-70b
-min-agent setup --switch ollama
+min-agent models    # always lists exactly: openrouter/free
 ```
 
+The preset provider cannot be modified and `min-agent setup` refuses to add, edit, switch, or remove providers while it is active; the model is fixed to `openrouter/free` (no model list is fetched). Set `MIN_AGENT_NO_BUILTIN_PROVIDER=1` to disable the preset before configuring your own provider.
+
 Settings live in `~/.min-agent/config.json` (global). For per-project settings, run `min-agent init` to create `.min-agent/config.json`.
 
 ## Extending It
@@ -135,8 +137,8 @@ MIT
 
 ```bash
 npm install -g min-agent
-min-agent             # 开始对话（已内置可用模型）
-min-agent setup       # 可选：添加或切换你自己的服务商
+min-agent             # 开始对话（内置 OpenRouter 模型，已预设并锁定）
+min-agent models      # 查看模型（始终为 openrouter/free）
 ```
 
 ## 基本用法
@@ -170,7 +172,9 @@ min-agent --provider anthropic "..."   # 为一条消息指定服务商
 
 ## 掌控风险
 
-文件修改默认自动批准，危险操作仍会询问：
+文件修改默认自动批准，危险操作仍会询问；同一步里有多个操作需要授权时，会合并成一个弹窗逐条列出，而不是弹出一堆。
+
+`min-agent exec`（单次执行）默认更放手：文件修改和普通命令都不询问，只有真正具破坏性的命令（删除文件/目录、drop/truncate 数据库、抹盘、`git reset --hard` 等）才会询问。加 `--permission` 或 `--yes` 可覆盖此默认。
 
 ```bash
 min-agent permission                 # 查看当前设置
@@ -193,14 +197,14 @@ min-agent memory add "prefer bun"
 
 ## 配置
 
-无需配置即可使用——在添加自己的服务商前，内置的 OpenRouter 模型（`openrouter/free`）会一直可用：
+无需配置即可使用——内置 OpenRouter 服务商（`openrouter/free`）已预设并锁定：
 
 ```bash
-min-agent setup --type ollama
-min-agent setup --type openai-compatible --url https://api.example.com/v1 --api-key "$KEY" --name groq --default-model llama-3.1-70b
-min-agent setup --switch ollama
+min-agent models    # 始终只列出: openrouter/free
 ```
 
+预设服务商不可修改：在其生效期间 `min-agent setup` 会拒绝添加、修改、切换或删除服务商，模型固定为 `openrouter/free`（不拉取模型列表）。设置 `MIN_AGENT_NO_BUILTIN_PROVIDER=1` 关闭预设后，才能配置自己的服务商。
+
 配置保存在 `~/.min-agent/config.json`（全局生效）。项目级配置用 `min-agent init` 创建 `.min-agent/config.json`，仅对该项目生效。
 
 ## 扩展能力