min-agent 0.6.8 → 0.7.0

package/README.md

@@ -35,7 +35,7 @@
 
 ```bash
 npm install -g min-agent
-min-agent             # start chatting (built-in OpenRouter model, preset & locked)
+min-agent             # start chatting (built-in OpenRouter model, preset)
 min-agent models      # list models (always openrouter/free)
 ```
 
@@ -95,13 +95,15 @@ In chat: `/memory on|off` toggles, `/memory` lists notes, `/memory some text` sa
 
 ## Configuration
 
-No setup needed — the built-in OpenRouter provider (`openrouter/free`) is preset and locked:
+No setup needed — the built-in OpenRouter provider (`openrouter/free`) is preset:
 
 ```bash
-min-agent models    # always lists exactly: openrouter/free
+min-agent models       # lists openrouter/free while the preset is active
+min-agent provider     # show the active provider and any you've added
+min-agent setup        # add your own provider (interactive)
 ```
 
-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.
+The preset itself can't be edited or switched away from, but you can always **add** your own provider — once you add one it takes over automatically. `min-agent provider <name>` switches the active provider (add/edit/remove go through `min-agent setup`). Set `MIN_AGENT_NO_BUILTIN_PROVIDER=1` to disable the preset entirely.
 
 Settings live in `~/.min-agent/config.json` (global). For per-project settings, run `min-agent init` to create `.min-agent/config.json`.
 
@@ -137,7 +139,7 @@ MIT
 
 ```bash
 npm install -g min-agent
-min-agent             # 开始对话（内置 OpenRouter 模型，已预设并锁定）
+min-agent             # 开始对话（内置 OpenRouter 模型，已预设）
 min-agent models      # 查看模型（始终为 openrouter/free）
 ```
 
@@ -197,13 +199,15 @@ min-agent memory add "prefer bun"
 
 ## 配置
 
-无需配置即可使用——内置 OpenRouter 服务商（`openrouter/free`）已预设并锁定：
+无需配置即可使用——内置 OpenRouter 服务商（`openrouter/free`）已预设：
 
 ```bash
-min-agent models    # 始终只列出: openrouter/free
+min-agent models     # 预设生效期间始终只列出: openrouter/free
+min-agent provider   # 查看当前服务商，以及你已添加的服务商
+min-agent setup      # 添加自己的服务商（交互式）
 ```
 
-预设服务商不可修改：在其生效期间 `min-agent setup` 会拒绝添加、修改、切换或删除服务商，模型固定为 `openrouter/free`（不拉取模型列表）。设置 `MIN_AGENT_NO_BUILTIN_PROVIDER=1` 关闭预设后，才能配置自己的服务商。
+预设本身不可编辑，也不能切换或删除，但你随时可以**添加**自己的服务商——添加后它会自动接管。`min-agent provider <name>` 切换当前服务商（增、删、改走 `min-agent setup`）。设置 `MIN_AGENT_NO_BUILTIN_PROVIDER=1` 可彻底关闭预设。
 
 配置保存在 `~/.min-agent/config.json`（全局生效）。项目级配置用 `min-agent init` 创建 `.min-agent/config.json`，仅对该项目生效。