min-agent 2.0.0 → 3.2.2609221209

package/README.md

@@ -39,11 +39,14 @@ min-agent             # start chatting (built-in OpenRouter model, preset)
 min-agent models      # list models (always openrouter/free)
 ```
 
+`min` is available as a shorter alias with identical functionality (`min "..."`, `min serve`, ...).
+
 ## Usage
 
 ```bash
 min-agent "your message"        # start a session and send a message
 min-agent exec "your message"   # one-shot question, then exit
+min-agent push                  # shortcut: git commit and push your changes
 min-agent --resume <id>         # resume a previous session
 min-agent history               # list saved sessions
 min-agent -i photo.png "..."    # attach an image
@@ -105,7 +108,7 @@ min-agent setup        # add your own provider (interactive)
 
 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`.
+Settings live in `~/.min-agent/config.json` (global). Per-project settings go to `~/.min-agent/sessions/<project-key>/config.json` (auto-created; nothing is written inside the project directory).
 
 ## Extending It
 
@@ -143,11 +146,14 @@ min-agent             # 开始对话（内置 OpenRouter 模型，已预设）
 min-agent models      # 查看模型（始终为 openrouter/free）
 ```
 
+`min` 是等价的短命令，功能完全相同（`min "..."`、`min serve` 等）。
+
 ## 基本用法
 
 ```bash
 min-agent "你的消息"            # 进入交互会话并立即发送消息
 min-agent exec "你的消息"       # 单次提问后自动退出
+min-agent push                  # 快捷指令：git 提交并推送代码
 min-agent --resume <id>        # 恢复之前的会话
 min-agent history              # 查看已保存的会话
 min-agent -i photo.png "..."   # 为一条消息附带图片
@@ -211,7 +217,7 @@ min-agent setup      # 添加自己的服务商（交互式）
 
 预设本身不可编辑，也不能切换或删除，但你随时可以**添加**自己的服务商——添加后它会自动接管。`min-agent provider <name>` 切换当前服务商（增、删、改走 `min-agent setup`）。设置 `MIN_AGENT_NO_BUILTIN_PROVIDER=1` 可彻底关闭预设。
 
-配置保存在 `~/.min-agent/config.json`（全局生效）。项目级配置用 `min-agent init` 创建 `.min-agent/config.json`，仅对该项目生效。
+配置保存在 `~/.min-agent/config.json`（全局生效）。项目级配置保存在 `~/.min-agent/sessions/<project-key>/config.json`（自动创建，不会在项目目录里生成任何文件），仅对该项目生效。
 
 ## 扩展能力
 
@@ -223,6 +229,36 @@ min-agent setup      # 添加自己的服务商（交互式）
 
 `min-agent serve` 可启动本地 HTTP API 服务，供其他应用调用。完整说明见 [docs/API.md](docs/API.md)
 
+## 网页版
+
+```bash
+min-agent web
+```
+
+启动 HTTP API 并附带网页版对话助手（默认 <http://127.0.0.1:8787>），浏览器打开即用，无需 CORS 或令牌配置。网页版支持：
+
+- 流式对话、思考过程与工具调用展示、图片粘贴/上传
+- 会话管理：历史列表、重命名、删除、撤销最后一轮、压缩历史
+- 设置页（完整覆盖 CLI 配置，无需命令行即可修改）：
+  - 服务商：添加/编辑/删除/切换，含 API Key、类型与上下文窗口
+  - 模型：默认模型（全局/项目作用域）、本次会话模型、Ollama 上下文档位
+  - Skills：启用/禁用（全局/项目）、查看详情、新建、重新扫描、孤儿引用清理
+  - MCP：添加/编辑/删除、启用/禁用、连接状态与工具列表
+  - 记忆：开关、条目增删与搜索、全局/项目作用域
+  - 规则：全局与项目规则文件在线编辑，保存即刻生效
+  - 行为与隔离：思考强度、确认模式、沙箱级别/联网/目录白名单
+- 危险操作确认与代理提问的交互回复（开启输入框的「确认」模式）
+- 明暗主题、移动端适配
+
+`--host` / `--port` 与 `serve` 相同。产物缺失时先在仓库内执行 `bun run build:web`（npm 发布包已内置），或用 `MIN_AGENT_WEB_DIST` 指定产物目录。
+
+后台运行与停止：
+
+```bash
+min-agent web -d      # 后台运行（日志: ~/.min-agent/serve.log）
+min-agent web --stop  # 停止后台服务
+```
+
 ## License
 
 MIT