@keyou007/agent-bot 0.1.10 → 0.1.12

package/.env.example

@@ -1,4 +1,4 @@
-# agent-bot init fills these through Feishu one-click registration.
+# agentbot init fills these through Feishu one-click registration.
 # Leave them blank for console-only mode. When binding an existing app manually,
 # FEISHU_USER_OPEN_ID is the private-chat fallback for startup notifications.
 FEISHU_APP_ID=

package/CHANGELOG.md

@@ -6,6 +6,31 @@ The project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.12] - 2026-08-03
+
+- Add a ready-to-use TraeX App Server example to the checked-in and generated default configuration.
+- Rename the configured App Server adapter kind from `codex` to `app-server` while normalizing existing `codex` values during loading, and show the active Agent's display name in progress-card connection and waiting states.
+- Retry `thread/list` with `updated_at` and remember that capability when a compatible App Server such as TraeX rejects Codex's `recency_at` sort extension.
+- Add `agentbot task newgroup <task>` and `agentbot task forkgroup <task>` to create inherited task groups or fork a task's latest completed turn through the running Server, with optional titles, target-Agent and project overrides for NewGroup, and structured JSON output.
+- Register `agentbot` as the primary CLI executable, retain `agent-bot` as a deprecated forwarding entry with a localized warning, and update current documentation and CLI guidance to use the new command.
+- Refresh Windows Machine and User environment variables before initial Supervisor launch, replacement Supervisor launch, and every Worker launch so restarts pick up updated `PATH` and other values while preserving Profile isolation.
+- Extend App Server session lifecycle requests to 60 seconds so slower compatible Agents such as TraeX can complete `thread/start` without producing a late unknown response.
+
+## [0.1.11] - 2026-08-02
+
+- Retry Feishu messages, replies, and card updates rejected by email-address content auditing with audit-safe text; keep message reactions pending until terminal presentation succeeds while allowing session and queue state to settle after presentation failures.
+- Use a shorter image-only prompt that asks the active Agent to inspect the attached image.
+- Reduce the packaged project logo size without changing the documented asset path.
+- Keep `/new` and `/newgroup` project options aligned: both support `--dir <cwd>` with `~`-based home-directory paths and `--nodir` for a forced Projectless Codex task, while `/newgroup` continues to inherit execution settings from the source task.
+- Send `excludeTurns: true` by default for every Codex fork, reducing response size without removing branch history, and retry once without the experimental field when an older App Server explicitly rejects it.
+- Remove obsolete `/mode`, `/modes`, `/ask`, `/agents`, and `/use` commands, consolidating Agent selection under `/agent`.
+- Omit the `[Projectless]` segment from `/newgroup` and `/forkgroup` group names while preserving Projectless task behavior.
+- Add a unified execution-settings card with Provider, Model, Thinking, and Permission tabs plus an Agent tab when multiple agents are configured; route multi-option Agent and Provider selection through the same card, report their current value directly when no alternative exists, persist and inherit Provider across task lifecycle operations, and leave new tasks on the Codex-configured default Provider.
+- Make Feishu `/restart` schedule a safe restart by default, with `/restart --force` as the only immediate-restart form.
+- Preserve Windows separators before dot-prefixed directories in Feishu file-change summaries instead of letting Markdown consume the separator as an escape.
+- Isolate every configured Agent by standard name with its own process and runtime connection, aggregate Codex tasks across those isolated runtimes, and scope persisted remote task identities by Agent.
+- Add the Agent Bot logo to both READMEs and include the high-resolution PNG in the npm package.
+
 ## [0.1.10] - 2026-08-01
 
 - Open a filtered Feishu Developer Console permission page for manual `im:message.group_msg` setup instead of incorrectly including the unsupported scope in one-click configuration; allow `Y` to skip its wait and report the resulting mention-only group behavior.

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="assets/agent-bot-logo.png" alt="Agent Bot logo" width="180">
+</p>
+
 # Agent Bot
 
 Use local Codex and ACP agents directly from Feishu.
@@ -33,21 +37,21 @@ codex login status
 
 ```powershell
 npm install --global @keyou007/agent-bot
-agent-bot --version
-agent-bot --help
+agentbot --version
+agentbot --help
 ```
 
-This installs the `agent-bot` command globally. Command-line help, status, progress, prompts, and errors follow the system language for Chinese and English locales; all other locales fall back to English. JSON output remains language-neutral and stable. See the [technical reference](docs/technical-reference.md#development-and-source-installation) to install from source.
+This installs `agentbot` as the primary command. The legacy `agent-bot` command remains available temporarily, prints a deprecation warning, and will be removed in a future release. Command-line help, status, progress, prompts, and errors follow the system language for Chinese and English locales; all other locales fall back to English. JSON output remains language-neutral and stable. See the [technical reference](docs/technical-reference.md#development-and-source-installation) to install from source.
 
 ### Initialize
 
 ```powershell
-agent-bot init
+agentbot init
 ```
 
 Follow the displayed link or scan the QR code to create and authorize the Feishu bot. Initialization prepares `~/.agent-bot`, saves the bot credentials and the authorizing user, checks the required permissions, and starts Agent Bot automatically.
 
-Only a complete app ID and secret saved locally count as a successful bot creation. If initialization is interrupted before both credentials are saved, rerunning `agent-bot init` creates a new bot. If credentials were saved, initialization resumes by auditing that bot's remote permissions and subscriptions.
+Only a complete app ID and secret saved locally count as a successful bot creation. If initialization is interrupted before both credentials are saved, rerunning `agentbot init` creates a new bot. If credentials were saved, initialization resumes by auditing that bot's remote permissions and subscriptions.
 
 The `im:message.group_msg` permission cannot be added through Feishu's one-click configuration. When it is missing, Agent Bot prints a QR code and a direct Developer Console link already filtered to that permission. Add it manually, publish the app version, and complete tenant approval if required. While Agent Bot waits for it to become active, enter `Y` to skip this permission and continue initialization; the final result warns that ordinary group messages which do not mention the bot will be unavailable.
 
@@ -62,12 +66,12 @@ When optional permissions or subscriptions are missing, Agent Bot first shows th
 | `--profile <directory>`| Use an isolated profile directory   |
 | `--config <path>`      | Use a specific configuration file   |
 
-You can rerun `agent-bot init` later to check or complete the bot configuration. If the server is already running, initialization leaves it running.
+You can rerun `agentbot init` later to check or complete the bot configuration. If the server is already running, initialization leaves it running.
 
 To fully reconfigure a Profile, stop its server and select the Profile explicitly:
 
 ```powershell
-agent-bot --profile ~/.agent-bot init --reset
+agentbot --profile ~/.agent-bot init --reset
 ```
 
 Reset moves the active `config.yaml`, `.env`, `data/`, and `logs/` into a new timestamped directory under `.reset-backups`, then initializes clean replacements. Existing backup directories are retained. The old remote Feishu app is not deleted.
@@ -75,10 +79,10 @@ Reset moves the active `config.yaml`, `.env`, `data/`, and `logs/` into a new ti
 ### Start And Stop
 
 ```powershell
-agent-bot server status
+agentbot server status
 ```
 
-`agent-bot init` starts the server automatically. If you stop it later, run `agent-bot server start` to start it again. For local-only use, initialize with `--skip-feishu` and run `agent-bot console` instead.
+`agentbot init` starts the server automatically. If you stop it later, run `agentbot server start` to start it again. For local-only use, initialize with `--skip-feishu` and run `agentbot console` instead.
 
 The `Agent Bot 已启动` startup card shows the version of Agent Bot currently running.
 
@@ -87,7 +91,7 @@ Open Feishu, find the bot, and send a message. Agent Bot automatically creates a
 Stop the service with:
 
 ```powershell
-agent-bot server stop
+agentbot server stop
 ```
 
 ### Update Or Uninstall
@@ -95,15 +99,15 @@ agent-bot server stop
 Stop the running service before replacing or removing the global package:
 
 ```powershell
-agent-bot server stop
+agentbot server stop
 npm install --global @keyou007/agent-bot@latest
-agent-bot server start
+agentbot server start
 ```
 
 To uninstall:
 
 ```powershell
-agent-bot server stop
+agentbot server stop
 npm uninstall --global @keyou007/agent-bot
 ```
 
@@ -114,20 +118,22 @@ Uninstalling the npm package does not delete your data under `~/.agent-bot`.
 ### Service
 
 ```powershell
-agent-bot server status
-agent-bot server start
-agent-bot server stop
-agent-bot server restart
+agentbot server status
+agentbot server start
+agentbot server stop
+agentbot server restart
 ```
 
 `server restart` waits for current work to finish by default. Its status card includes a `Cancel` button while the restart is still waiting. Use `--immediate` only when interruption is acceptable.
 
+On Windows, every Supervisor and Worker launch reloads the latest Machine and User environment variables. Restart the service after changing `PATH` or another system environment variable; the active Profile selection remains isolated.
+
 `server status` shows the Lark App ID used by the running server. Add `--json` to read it from `feishuAppId`.
 
 ### Console
 
 ```powershell
-agent-bot console
+agentbot console
 ```
 
 The Console UI works without Feishu credentials. It will not share task state with a running server unless `--force` is supplied.
@@ -135,14 +141,18 @@ The Console UI works without Feishu credentials. It will not share task state wi
 ### Tasks
 
 ```powershell
-agent-bot task list
-agent-bot task status <task>
-agent-bot task prompt <task> "<prompt>"
-agent-bot task title <task> "<title>"
-agent-bot task stop <task>
+agentbot task list
+agentbot task status <task>
+agentbot task prompt <task> "<prompt>"
+agentbot task newgroup <task> [title] [--agent <name>] [--dir <path> | --nodir]
+agentbot task forkgroup <task> [title]
+agentbot task title <task> "<title>"
+agentbot task stop <task>
 ```
 
-`<task>` can be a number from `task list`, a task ID, or an unambiguous task-ID prefix. Run `agent-bot --help` for all CLI options.
+`<task>` can be a number from `task list`, a task ID, or an unambiguous task-ID prefix. Run `agentbot --help` for all CLI options.
+
+`task newgroup` creates a Feishu group and a new task. By default it inherits the source task's Agent and execution settings. `--agent <standard-name>` selects another configured Agent; the source project shape is still inherited, while the selected Agent uses its own runtime defaults for Provider, model, reasoning effort, and permission mode. `--dir` overrides the project directory and supports `~`; `--nodir` forces a Projectless App Server task. `task forkgroup` forks the source task's latest available completed turn without interrupting an active turn. Both commands require the Server to be running, invite the Profile's saved authorizing user, leave the source chat on its current task, and support `--json`.
 
 ## Feishu Commands
 
@@ -151,7 +161,7 @@ Plain text continues the current task. Messages beginning with `/` are commands.
 | Command                                  | Purpose                                     |
 | ---------------------------------------- | ------------------------------------------- |
 | `/new [title] [--dir <path> \| --nodir]` | Create a task                               |
-| `/sessions [keyword]`                    | Browse available Codex tasks                |
+| `/sessions [keyword]`                    | Browse available App Server tasks           |
 | `/switch [task]`                         | Switch tasks or return to the previous task |
 | `/fork [task]`                           | Create and open a task branch               |
 | `/status [task]`                         | View task progress and results              |
@@ -160,32 +170,34 @@ Plain text continues the current task. Messages beginning with `/` are commands.
 | `/queue <prompt>`                        | Queue a separate follow-up Prompt           |
 | `/nosteer <prompt>`                      | Same as `/queue`                            |
 | `/goal [objective]`                      | View or manage a persistent Goal            |
-| `/model [name]`                          | View or change the model                    |
-| `/thinking [level]`                      | View or change reasoning effort             |
-| `/permissions auto\|confirm`             | Change tool approval behavior               |
-| `/newgroup [title]`                      | Create a private group for a new task       |
+| `/provider`                              | Open execution settings on the Provider tab |
+| `/model`                                 | Open execution settings on the Model tab    |
+| `/thinking`                              | Open execution settings on the Thinking tab |
+| `/permissions`                           | Open execution settings on the Permission tab |
+| `/newgroup [title] [--dir <cwd> \| --nodir]` | Create a private group for a new task       |
 | `/forkgroup [title]`                     | Fork the current position into a private group |
-| `/agent [name]`                          | View or change the default agent            |
-| `/use <agent> [cwd]`                     | Select an agent and create a task           |
+| `/agent [name]`                          | Open Agent settings or select the default Agent |
 | `! <command>`                            | Run a local command in the task directory   |
-| `/restart`                               | Gracefully restart Agent Bot                |
+| `/restart [--force]`                     | Restart safely, or immediately with `--force` |
 | `/help`                                  | Show in-chat help                           |
 
 Slash commands accept any unique prefix, and compound commands accept registered initialisms: `/sess` runs `/sessions`, `/fg` runs `/forkgroup`, `/ng` runs `/newgroup`, and `/ns` runs `/nosteer`. Exact command names take priority. An ambiguous prefix such as `/s` or `/f` is rejected and reports every matching command.
 
+`/agent`, `/provider`, `/model`, `/thinking`, and `/permissions` use the same execution-settings card when there is something to select. When more than one Agent is configured, the card adds an Agent tab for selecting the default Agent used by future tasks; `/agent` opens that tab, including when the chat has no current task. With only one configured Agent, `/agent` reports the current Agent directly instead. Existing tasks keep their original Agent, and tasks using different Agents run independently. `/agent <name>` remains available for direct selection. `/provider` likewise reports the current Provider directly when no alternative Provider is configured. The other four commands activate their matching tabs and do not accept arguments. A task created without inherited settings uses the default Provider from your Codex configuration.
+
 Private chats, group timelines, and threads keep separate current tasks. You can send an image by itself or together with text. While a task is running, plain text adds instructions to the current work; use `/queue` (or `/nosteer`) to always create a later turn.
 
 The `/sessions` card provides `NewGroup` and `ForkGroup` actions for each task, so you can create a project-matched group or fork a selected task directly into a new group.
 
 Inside a thread, `/forkgroup` forks from the thread's original turn until the thread task completes its own turn. After that, it forks from the thread task's latest completed turn. A currently running turn is never used as a fork point.
 
-After `/forkgroup` creates the new group, its welcome message shows the forked task's current model, reasoning effort, and permission type.
+After `/forkgroup` creates the new group, its welcome message shows the forked task's current Provider, model, reasoning effort, and permission type.
 
-`/newgroup` immediately creates a new task in the new group. It inherits the current task's project directory, model, reasoning effort, and permission mode without affecting the source task. If there is no current task, Agent Bot uses the selected agent and its runtime defaults. An explicit title becomes both the group suffix and the task title.
+`/new` and `/newgroup` accept the same project options. Pass `--dir <cwd>` to override the inherited project directory, or `--nodir` to force a Projectless App Server task; the two options are mutually exclusive. `~`, `~/...`, and `~\...` resolve from the current user's home directory for both commands. `/newgroup` immediately creates and binds the task in the new group while continuing to inherit the current task's Provider, model, reasoning effort, and permission mode without affecting the source task. If there is no current task, Agent Bot uses the selected agent and its runtime defaults. An explicit title becomes both the group suffix and the task title.
 
-When `/newgroup` omits the title, the task title is `新任务` and the default group name is `[agent] [project dir] 新任务 (mm-dd)`. When `/forkgroup` omits the title, its task and group name use the same persistent `source title（分支 N）` sequence as `/fork`, without a date suffix. Feishu group names created by `/newgroup` and `/forkgroup` are capped at 60 displayed characters. When a generated name is too long, Agent Bot truncates only the title portion in the group name; the task title itself stays unchanged.
+When `/newgroup` omits the title, both the task title and the group-title portion use `新任务 (mm-dd)`, producing the default group name `[agent] [project dir] 新任务 (mm-dd)`. Projectless groups omit the project segment entirely, using `[agent] title`. When `/forkgroup` omits the title, its task and group name use the same persistent `source title（分支 N）` sequence as `/fork`, without a date suffix. Feishu group names created by `/newgroup` and `/forkgroup` are capped at 60 displayed characters. When a generated name is too long, Agent Bot truncates only the title portion in the group name; the task title itself stays unchanged.
 
-Renaming a bound group to `[agent] [project dir] title` synchronizes only `title` to the current task. The Agent and project-directory prefixes remain group metadata and are never included in the Codex task title. The older `[agent] title` format remains supported.
+Renaming a bound group to `[agent] [project dir] title` synchronizes only `title` to the current task. The Agent and project-directory prefixes remain group metadata and are never included in the task title. The older `[agent] title` format remains supported.
 
 ## Configuration And Data
 
@@ -207,21 +219,21 @@ By default, Agent Bot responds to ordinary messages in groups containing the bot
 Commands without `--profile` use the main profile at `~/.agent-bot`. To run another bot with isolated credentials, configuration, data, logs, and local control endpoint, pass its directory explicitly on every command:
 
 ```powershell
-agent-bot --profile ~/.agent-bot-rescue init
-agent-bot --profile ~/.agent-bot-rescue server start
-agent-bot --profile ~/.agent-bot-rescue server status
+agentbot --profile ~/.agent-bot-rescue init
+agentbot --profile ~/.agent-bot-rescue server start
+agentbot --profile ~/.agent-bot-rescue server status
 ```
 
 Alternative profiles are directory-based and are not registered by name. Each one uses `config.yaml`, `.env`, `data/`, and `logs/` inside the selected directory. `--profile` cannot be combined with `--config`.
 
 ## Troubleshooting
 
-- **The bot does not respond:** run `agent-bot server status` and check `~/.agent-bot/logs/agent-bot.log`.
+- **The bot does not respond:** run `agentbot server status` and check `~/.agent-bot/logs/agent-bot.log`.
 - **The Worker restarted after a Node crash:** check `~/.agent-bot/data/last-crash.json`, `~/.agent-bot/logs/worker.stderr.log`, and `~/.agent-bot/data/crash-reports/`.
-- **Feishu permissions are incomplete:** rerun `agent-bot init` and follow the displayed authorization steps.
+- **Feishu permissions are incomplete:** rerun `agentbot init` and follow the displayed authorization steps.
 - **Codex cannot start:** run `codex login status` as the same operating-system user that runs Agent Bot.
-- **You only need local testing:** run `agent-bot init --skip-feishu`, then `agent-bot console`.
-- **A safe restart keeps waiting:** inspect active tasks with `agent-bot task list --status running`.
+- **You only need local testing:** run `agentbot init --skip-feishu`, then `agentbot console`.
+- **A safe restart keeps waiting:** inspect active tasks with `agentbot task list --status running`.
 
 ## More Documentation
 

package/README.zh.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="assets/agent-bot-logo.png" alt="Agent Bot Logo" width="180">
+</p>
+
 # Agent Bot
 
 通过飞书使用本机上的 Codex 和 ACP Agent。
@@ -33,21 +37,21 @@ codex login status
 
 ```powershell
 npm install --global @keyou007/agent-bot
-agent-bot --version
-agent-bot --help
+agentbot --version
+agentbot --help
 ```
 
-该命令会全局安装 `agent-bot`。命令行帮助、状态、进度、交互提示和错误会根据系统语言显示中文或英文；其他未支持语言统一回退英文。JSON 输出不做本地化并保持字段稳定。从源码安装的方法见[技术参考](docs/technical-reference.zh.md#开发与源码安装)。
+该命令会把 `agentbot` 安装为主命令。旧的 `agent-bot` 命令暂时保留，运行时会显示弃用警告，并将在后续版本中移除。命令行帮助、状态、进度、交互提示和错误会根据系统语言显示中文或英文；其他未支持语言统一回退英文。JSON 输出不做本地化并保持字段稳定。从源码安装的方法见[技术参考](docs/technical-reference.zh.md#开发与源码安装)。
 
 ### 初始化
 
 ```powershell
-agent-bot init
+agentbot init
 ```
 
 打开命令显示的链接或扫描二维码，完成飞书机器人创建和授权。初始化会准备 `~/.agent-bot`、保存机器人凭据和授权用户、检查所需权限，并自动启动 Agent Bot。
 
-只有 App ID 和 App Secret 都已保存到本地才视为机器人创建成功。如果初始化在完整凭据保存前中断，再次运行 `agent-bot init` 会创建新机器人；如果凭据已经保存，则会继续检查该机器人的远端权限和订阅。
+只有 App ID 和 App Secret 都已保存到本地才视为机器人创建成功。如果初始化在完整凭据保存前中断，再次运行 `agentbot init` 会创建新机器人；如果凭据已经保存，则会继续检查该机器人的远端权限和订阅。
 
 `im:message.group_msg` 无法通过飞书一键配置新增。缺少该权限时，Agent Bot 会显示二维码，以及已筛选该权限的开发者后台直达链接。请手动新增权限、发布应用版本，并在需要时完成租户管理员审批。Agent Bot 等待权限生效时，可输入 `Y` 跳过该权限并继续初始化；最终结果会提示机器人无法响应未 @ 它的普通群消息。
 
@@ -62,12 +66,12 @@ agent-bot init
 | `--profile <目录>`     | 使用指定目录中的独立 Profile |
 | `--config <路径>`      | 使用指定配置文件          |
 
-之后可以重新运行 `agent-bot init` 检查或补齐机器人配置。如果 Server 已在运行，初始化会保留当前服务。
+之后可以重新运行 `agentbot init` 检查或补齐机器人配置。如果 Server 已在运行，初始化会保留当前服务。
 
 如需完整重新配置一个 Profile，请先停止它的 Server，并显式指定 Profile：
 
 ```powershell
-agent-bot --profile ~/.agent-bot init --reset
+agentbot --profile ~/.agent-bot init --reset
 ```
 
 重置会把当前 `config.yaml`、`.env`、`data/` 和 `logs/` 移入 `.reset-backups` 下新的时间戳目录，再创建干净的新文件和目录。已有备份会永久保留，不会被后续重置覆盖或清理。远端旧飞书应用不会被删除。
@@ -75,10 +79,10 @@ agent-bot --profile ~/.agent-bot init --reset
 ### 启动与停止
 
 ```powershell
-agent-bot server status
+agentbot server status
 ```
 
-`agent-bot init` 会自动启动 Server。之后如果手动停止了服务，可执行 `agent-bot server start` 再次启动。仅在本地使用时，请通过 `--skip-feishu` 初始化并运行 `agent-bot console`。
+`agentbot init` 会自动启动 Server。之后如果手动停止了服务，可执行 `agentbot server start` 再次启动。仅在本地使用时，请通过 `--skip-feishu` 初始化并运行 `agentbot console`。
 
 `Agent Bot 已启动` 启动卡片会显示当前正在运行的 Agent Bot 版本。
 
@@ -87,7 +91,7 @@ agent-bot server status
 停止服务：
 
 ```powershell
-agent-bot server stop
+agentbot server stop
 ```
 
 ### 更新或卸载
@@ -95,15 +99,15 @@ agent-bot server stop
 替换或移除全局包前，先停止正在运行的服务：
 
 ```powershell
-agent-bot server stop
+agentbot server stop
 npm install --global @keyou007/agent-bot@latest
-agent-bot server start
+agentbot server start
 ```
 
 卸载：
 
 ```powershell
-agent-bot server stop
+agentbot server stop
 npm uninstall --global @keyou007/agent-bot
 ```
 
@@ -114,20 +118,22 @@ npm uninstall --global @keyou007/agent-bot
 ### 服务管理
 
 ```powershell
-agent-bot server status
-agent-bot server start
-agent-bot server stop
-agent-bot server restart
+agentbot server status
+agentbot server start
+agentbot server stop
+agentbot server restart
 ```
 
 `server restart` 默认等待当前工作完成后再重启；等待期间可通过状态卡片下方的 `Cancel` 按钮取消。只有可接受中断时才使用 `--immediate`。
 
+Windows 下每次启动 Supervisor 或 Worker 都会重新读取最新的系统和用户环境变量。修改 `PATH` 或其他系统环境变量后重启服务即可生效，当前 Profile 选择仍保持隔离。
+
 `server status` 会显示当前运行服务使用的 Lark App ID；添加 `--json` 后可从 `feishuAppId` 字段读取。
 
 ### Console
 
 ```powershell
-agent-bot console
+agentbot console
 ```
 
 Console UI 不需要飞书凭据。除非传入 `--force`，否则不会与正在运行的 Server 共享任务状态。
@@ -135,14 +141,18 @@ Console UI 不需要飞书凭据。除非传入 `--force`，否则不会与正
 ### 任务管理
 
 ```powershell
-agent-bot task list
-agent-bot task status <任务>
-agent-bot task prompt <任务> "<prompt>"
-agent-bot task title <任务> "<标题>"
-agent-bot task stop <任务>
+agentbot task list
+agentbot task status <任务>
+agentbot task prompt <任务> "<prompt>"
+agentbot task newgroup <任务> [标题] [--agent <标准名>] [--dir <路径> | --nodir]
+agentbot task forkgroup <任务> [标题]
+agentbot task title <任务> "<标题>"
+agentbot task stop <任务>
 ```
 
-`<任务>` 可以是 `task list` 中的序号、任务 ID 或唯一的任务 ID 前缀。运行 `agent-bot --help` 可查看完整 CLI 参数。
+`<任务>` 可以是 `task list` 中的序号、任务 ID 或唯一的任务 ID 前缀。运行 `agentbot --help` 可查看完整 CLI 参数。
+
+`task newgroup` 会创建飞书群和新任务。默认继承源任务的 Agent 和运行设置；`--agent <标准名>` 可选择另一个已配置的 Agent，此时仍继承源任务的项目形态，但 Provider、模型、思考强度和权限模式使用目标 Agent 自己的 Runtime 默认值。`--dir` 可覆盖项目目录并支持 `~`，`--nodir` 会强制创建 Projectless App Server 任务。`task forkgroup` 从源任务最新可用的已完成 turn 创建分支，不会中断正在执行的 turn。两个命令都要求 Server 正在运行，邀请 Profile 中保存的授权用户，不会切换源会话的当前任务，并支持 `--json`。
 
 ## 飞书命令
 
@@ -151,7 +161,7 @@ agent-bot task stop <任务>
 | 命令                                    | 作用                       |
 | --------------------------------------- | -------------------------- |
 | `/new [标题] [--dir <路径> \| --nodir]` | 创建任务                   |
-| `/sessions [关键词]`                    | 浏览可用的 Codex 任务      |
+| `/sessions [关键词]`                    | 浏览可用的 App Server 任务 |
 | `/switch [任务]`                        | 切换任务，或返回上一个任务 |
 | `/fork [任务]`                          | 创建并打开任务分支         |
 | `/status [任务]`                        | 查看任务进度和结果         |
@@ -160,32 +170,34 @@ agent-bot task stop <任务>
 | `/queue <prompt>`                       | 排队一个独立的后续 Prompt  |
 | `/nosteer <prompt>`                     | 与 `/queue` 相同           |
 | `/goal [目标]`                          | 查看或管理持久 Goal        |
-| `/model [名称]`                         | 查看或切换模型             |
-| `/thinking [级别]`                      | 查看或切换思考强度         |
-| `/permissions auto\|confirm`            | 修改工具授权方式           |
-| `/newgroup [标题]`                      | 为新任务创建私有群         |
+| `/provider`                            | 打开运行设置的 Provider tab   |
+| `/model`                               | 打开运行设置的 Model tab      |
+| `/thinking`                            | 打开运行设置的 Thinking tab   |
+| `/permissions`                         | 打开运行设置的 Permission tab |
+| `/newgroup [标题] [--dir <cwd> \| --nodir]` | 为新任务创建私有群         |
 | `/forkgroup [标题]`                     | 将当前位置分支到私有群     |
-| `/agent [名称]`                         | 查看或切换默认 Agent       |
-| `/use <agent> [cwd]`                    | 选择 Agent 并创建任务      |
+| `/agent [名称]`                         | 打开 Agent 设置或切换默认 Agent |
 | `! <命令>`                              | 在任务目录执行本地命令     |
-| `/restart`                              | 优雅重启 Agent Bot         |
+| `/restart [--force]`                    | 默认安全重启；`--force` 立即重启 |
 | `/help`                                 | 显示聊天内帮助             |
 
 斜杠命令支持任意唯一前缀，复合命令还支持首字母缩写：`/sess` 等同于 `/sessions`，`/fg` 等同于 `/forkgroup`，`/ng` 等同于 `/newgroup`，`/ns` 等同于 `/nosteer`。完整命令名优先；`/s`、`/f` 等匹配多个命令的前缀会被拒绝，并列出全部候选命令。
 
+`/agent`、`/provider`、`/model`、`/thinking` 和 `/permissions` 在存在可选项时使用同一张运行设置卡片。配置了多个 Agent 时，卡片会增加 Agent tab，用于选择后续新任务使用的默认 Agent；即使当前聊天还没有任务，`/agent` 也能打开该 tab。只配置一个 Agent 时，`/agent` 直接显示当前 Agent，不打开卡片。现有任务仍保持原来的 Agent，使用不同 Agent 的任务可以相互独立地运行。`/agent <名称>` 继续支持直接选择。没有可切换的 Provider 时，`/provider` 同样只显示当前 Provider。其余四个命令激活各自对应的 tab，且不接受参数。没有可继承设置的新任务使用 Codex 配置中的默认 Provider。
+
 私聊、群正文和话题分别维护当前任务。可以单独发送图片，也可以同时发送文字和图片。任务运行中发送普通文字会追加指令；需要确保形成后续 turn 时使用 `/queue`（或 `/nosteer`）。
 
 `/sessions` 卡片为每个任务提供 `NewGroup` 和 `ForkGroup` 操作，可直接按所选任务创建同项目的新群，或把所选任务 Fork 到新群。
 
 在话题中使用 `/forkgroup` 时，如果话题任务还没有完成过自己的 turn，则从话题原始 turn fork；完成过后则从话题任务最近完成的 turn fork。正在执行的 turn 不会作为 fork 点。
 
-`/forkgroup` 创建新群后，群内欢迎消息会显示分支任务当前使用的模型、思考强度和权限类型。
+`/forkgroup` 创建新群后，群内欢迎消息会显示分支任务当前使用的 Provider、模型、思考强度和权限类型。
 
-`/newgroup` 会立即在新群中创建并绑定一个新任务。新任务继承当前任务的项目目录、模型、思考强度和权限模式，不影响来源任务；来源聊天没有当前任务时，则使用选定 Agent 及其运行时默认设置。显式标题会同时作为群名后缀和任务标题。
+`/new` 和 `/newgroup` 支持相同的项目参数：使用 `--dir <cwd>` 覆盖继承的项目目录，或使用 `--nodir` 强制创建 Projectless App Server 任务，二者不能同时使用。两条命令中的 `~`、`~/...` 和 `~\...` 均表示当前用户目录。`/newgroup` 会立即在新群中创建并绑定任务，同时继续继承当前任务的 Provider、模型、思考强度和权限模式，不影响来源任务。来源聊天没有当前任务时，则使用选定 Agent 及其运行时默认设置。显式标题会同时作为群名后缀和任务标题。
 
-`/newgroup` 省略标题时，任务标题为 `新任务`，默认群名为 `[agent] [project dir] 新任务 (mm-dd)`。`/forkgroup` 省略标题时，任务标题和群名都与 `/fork` 一样使用持久递增的 `源标题（分支 N）`，不追加日期。`/newgroup` 和 `/forkgroup` 创建的飞书群名最多显示 60 个字符。生成后的群名过长时，Agent Bot 只截断群名中的标题部分，任务标题本身保持不变。
+`/newgroup` 省略标题时，任务标题和群名中的标题部分统一使用 `新任务 (mm-dd)`，默认群名为 `[agent] [project dir] 新任务 (mm-dd)`。Projectless 群会完全省略项目段，群名格式为 `[agent] title`。`/forkgroup` 省略标题时，任务标题和群名都与 `/fork` 一样使用持久递增的 `源标题（分支 N）`，不追加日期。`/newgroup` 和 `/forkgroup` 创建的飞书群名最多显示 60 个字符。生成后的群名过长时，Agent Bot 只截断群名中的标题部分，任务标题本身保持不变。
 
-把已绑定任务的群改名为 `[agent] [project dir] title` 时，只会把 `title` 同步到当前任务；Agent 和工程目录前缀仅作为群元数据，不会写入 Codex 任务标题。旧的 `[agent] title` 格式仍然兼容。
+把已绑定任务的群改名为 `[agent] [project dir] title` 时，只会把 `title` 同步到当前任务；Agent 和工程目录前缀仅作为群元数据，不会写入任务标题。旧的 `[agent] title` 格式仍然兼容。
 
 ## 配置与数据
 
@@ -207,21 +219,21 @@ Agent Bot 将用户相关文件保存在仓库之外：
 不指定 `--profile` 时使用位于 `~/.agent-bot` 的主 Profile。运行其他相互隔离的机器人时，需要在每次命令中显式指定其目录：
 
 ```powershell
-agent-bot --profile ~/.agent-bot-rescue init
-agent-bot --profile ~/.agent-bot-rescue server start
-agent-bot --profile ~/.agent-bot-rescue server status
+agentbot --profile ~/.agent-bot-rescue init
+agentbot --profile ~/.agent-bot-rescue server start
+agentbot --profile ~/.agent-bot-rescue server status
 ```
 
 其他 Profile 不按名称注册，而是直接使用目录。每个 Profile 都在所选目录内保存自己的 `config.yaml`、`.env`、`data/` 和 `logs/`，飞书凭据与本地控制端点也相互隔离。`--profile` 不能和 `--config` 同时使用。
 
 ## 常见问题
 
-- **机器人没有响应：** 运行 `agent-bot server status`，并查看 `~/.agent-bot/logs/agent-bot.log`
+- **机器人没有响应：** 运行 `agentbot server status`，并查看 `~/.agent-bot/logs/agent-bot.log`
 - **Node 崩溃后 Worker 被自动重启：** 查看 `~/.agent-bot/data/last-crash.json`、`~/.agent-bot/logs/worker.stderr.log` 和 `~/.agent-bot/data/crash-reports/`
-- **飞书权限不完整：** 重新运行 `agent-bot init`，完成显示的授权步骤
+- **飞书权限不完整：** 重新运行 `agentbot init`，完成显示的授权步骤
 - **Codex 无法启动：** 使用运行 Agent Bot 的同一操作系统用户执行 `codex login status`
-- **只需要本地测试：** 运行 `agent-bot init --skip-feishu`，然后执行 `agent-bot console`
-- **安全重启一直等待：** 使用 `agent-bot task list --status running` 检查活动任务
+- **只需要本地测试：** 运行 `agentbot init --skip-feishu`，然后执行 `agentbot console`
+- **安全重启一直等待：** 使用 `agentbot task list --status running` 检查活动任务
 
 ## 更多文档
 

package/config.example.yaml

@@ -10,7 +10,7 @@ console:
 
 agents:
   codex:
-    kind: "codex"
+    kind: "app-server"
     title: "Codex"
     command: "codex"
     args:
@@ -21,6 +21,16 @@ agents:
       - "stdio://"
     env: {}
 
+  traex:
+    kind: "app-server"
+    title: "TraeX"
+    command: "traex"
+    args:
+      - "app-server"
+      - "--listen"
+      - "stdio://"
+    env: {}
+
   coco:
     title: "Coco"
     command: "coco"