min-agent 0.5.0 → 0.6.0

package/README.md

@@ -33,8 +33,8 @@
 
 ```bash
 npm install -g min-agent
-min-agent setup      # Configure your AI provider
-min-agent             # Start chatting
+min-agent             # Start chatting (a built-in model is ready)
+min-agent setup       # Optional: add or switch your own AI provider
 ```
 
 ## Basic Usage
@@ -59,13 +59,13 @@ min-agent --provider anthropic "your message"
 
 ## While Chatting
 
-Type `/` to open a command menu. Use **↑ / ↓** to recall previous messages.
+Type `/` to open a command menu; **↑ / ↓** moves the highlight. With an empty input, **↑ / ↓** recalls previous messages.
 
 | Command | Description |
 |---|---|
 | `/new` | Start a new session |
 | `/model` | Switch model |
-| `/provider` | Switch provider |
+| `/provider` | Switch provider (interactive picker) |
 | `/plan` | Toggle plan mode (look, don't touch) |
 | `/think` | Choose thinking intensity |
 | `/memory` | Turn memory on/off, or save a note |
@@ -76,19 +76,20 @@ Type `/` to open a command menu. Use **↑ / ↓** to recall previous messages.
 | `/mcp` | Show connected MCP servers |
 | `/skills` | Manage skills |
 | `/tokens` | Usage and estimated cost |
+| `/ctx` | Choose local-model context window |
 | `/help` | Show all commands |
 | `/exit` | Exit |
 
-Shortcuts: **Ctrl+C** clears the input (press twice to exit) · **Ctrl+V** pastes an image · a multi-line paste becomes a snippet · **Ctrl+B** selects text to copy · mouse drag-select also copies on release · click a tool or thinking block to expand or collapse it.
+Shortcuts: **Ctrl+C** clears the input (press twice to exit) · **Ctrl+V** pastes an image · a multi-line paste becomes a snippet · **Ctrl+B** selects text to copy · mouse drag-select also copies on release · click a tool or thinking block to expand or collapse it · when it asks you to choose, use **↑/↓** and **Enter** (Space checks items in multi-select).
 
 ## Staying in Control
 
-min-agent asks for confirmation before risky actions by default.
+min-agent asks for confirmation before risky actions by default. File edits are auto-approved unless you change this.
 
 ```bash
 min-agent permission                 # Show current setting
-min-agent --permission ask           # Confirm before risky actions (default)
-min-agent --permission accept-edits  # Auto-approve file edits only
+min-agent --permission ask           # Confirm before risky actions
+min-agent --permission accept-edits  # Auto-approve file edits only (default)
 min-agent --permission allow-all     # Auto-approve everything — use with care
 ```
 
@@ -115,7 +116,13 @@ In chat, `/memory on` or `/memory off` toggles it; `/memory` lists notes; `/memo
 
 ## Configuration
 
-Run `min-agent setup` for a guided setup — this is the easiest way to add or switch AI providers.
+Run `min-agent setup` to add or switch AI providers. If you skip it, min-agent uses a built-in OpenRouter model (`openrouter/free`). Your own providers in `~/.min-agent/config.json` always take over.
+
+```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
+```
 
 Settings live in `~/.min-agent/config.json` (global). A project can have its own `.min-agent/config.json` that only applies there.
 
@@ -151,8 +158,8 @@ MIT
 
 ```bash
 npm install -g min-agent
-min-agent setup      # 配置你的 AI 服务商
-min-agent             # 开始对话
+min-agent             # 开始对话（已内置可用模型）
+min-agent setup       # 可选：添加或切换你自己的 AI 服务商
 ```
 
 ## 基本用法
@@ -177,13 +184,13 @@ min-agent --provider anthropic "你的消息"
 
 ## 对话中的操作
 
-输入 `/` 弹出命令菜单。使用 **↑ / ↓** 翻看之前的消息。
+输入 `/` 弹出命令菜单，用 **↑ / ↓** 移动高亮。输入框为空时，**↑ / ↓** 翻看之前的消息。
 
 | 命令 | 说明 |
 |---|---|
 | `/new` | 开始新会话 |
 | `/model` | 切换模型 |
-| `/provider` | 切换服务商 |
+| `/provider` | 交互式切换服务商 |
 | `/plan` | 切换"计划模式"（只看不改） |
 | `/think` | 选择思考强度 |
 | `/memory` | 开关记忆，或保存一条 |
@@ -194,19 +201,20 @@ min-agent --provider anthropic "你的消息"
 | `/mcp` | 查看已连接的 MCP 服务 |
 | `/skills` | 管理技能 |
 | `/tokens` | 查看用量与预估费用 |
+| `/ctx` | 选择本地模型上下文窗口 |
 | `/help` | 查看全部命令 |
 | `/exit` | 退出 |
 
-快捷键：**Ctrl+C** 清空输入框（连按两次退出）· **Ctrl+V** 粘贴图片 · 多行粘贴会收成片段 · **Ctrl+B** 选中文本以复制 · 也支持鼠标拖拽选中并自动复制 · 点击工具或思考块可展开或收起。
+快捷键：**Ctrl+C** 清空输入框（连按两次退出）· **Ctrl+V** 粘贴图片 · 多行粘贴会收成片段 · **Ctrl+B** 选中文本以复制 · 也支持鼠标拖拽选中并自动复制 · 点击工具或思考块可展开或收起 · 需要你做选择时用 **↑/↓** 移动、**Enter** 确认（多选时用空格勾选）。
 
 ## 掌控风险
 
-min-agent 默认会在执行有风险的操作前先询问你。
+min-agent 默认自动批准文件修改，危险命令仍会询问。可按需调整：
 
 ```bash
 min-agent permission                 # 查看当前设置
-min-agent --permission ask           # 有风险操作前先询问（默认）
-min-agent --permission accept-edits  # 仅自动批准文件修改
+min-agent --permission ask           # 有风险操作前先询问
+min-agent --permission accept-edits  # 仅自动批准文件修改（默认）
 min-agent --permission allow-all     # 自动批准所有操作 —— 请谨慎使用
 ```
 
@@ -233,7 +241,13 @@ min-agent memory add "prefer bun"
 
 ## 配置
 
-运行 `min-agent setup` 即可通过引导式流程完成配置，这是添加或切换 AI 服务商最简单的方式。
+未配置服务商时，min-agent 会使用内置的 OpenRouter 模型（`openrouter/free`）。运行 `min-agent setup` 可添加或切换你自己的服务商；写在 `~/.min-agent/config.json` 里的配置优先于内置预设。
+
+```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/config.json`（全局生效）。也可以在某个项目下单独创建 `.min-agent/config.json`，仅对该项目生效。