@ganglion/xacpx 0.14.0 → 0.15.0

package/README.md

@@ -23,18 +23,12 @@ English · **[中文](./docs/zh/README_zh.md)**
 
 If you need to code or work remotely on a temporary basis, `xacpx` gives you a fast, convenient **remote entry point** so you can get things done from WeChat or Feishu anytime, anywhere.
 
-## Who it's for
-
-`xacpx` suits users who want lightweight, on-demand multi-agent work. You can watch tasks, send commands, and view results from WeChat, Feishu, or Yuanbao, and manage multiple sessions within the same chat.
-
-> For everyday use, remember `/ss` first: it creates or reuses an xacpx logical session. If you want to attach to an existing native session of a local agent such as Codex, use `/ssn`; see [docs/native-sessions.md](./docs/native-sessions.md) for advanced details.
+> For everyday use, remember `/ss` first: it creates or reuses an xacpx logical session. If you want to attach to an existing native session of a local agent such as Codex, use `/ssn`; see [native sessions](./docs/native-sessions.md).
 
 ## 5-minute quick start
 
 ### Prerequisites
 
-Before you start, you need at least:
-
 - Node.js 22+ or Bun
 - A working agent CLI you intend to use, such as Codex / Claude Code / Gemini / OpenCode
 - A phone with WeChat, Feishu, or Yuanbao installed
@@ -49,32 +43,25 @@ npm install -g @ganglion/xacpx --registry=https://registry.npmjs.org
 bun add -g @ganglion/xacpx
 ```
 
-### Log in to WeChat
+### Log in and start
 
 ```bash
-xacpx login
+xacpx login    # shows a QR code; scan it with WeChat
+xacpx start    # start the background service
 ```
 
-The terminal will show a QR code; scan it with WeChat to log in.
-
-If you want to use Feishu or Yuanbao instead of WeChat, see "Switch / add other channels" below first.
-
-### Start the service
-
-```bash
-xacpx start
-```
+To use Feishu or Yuanbao instead of WeChat, see "Other channels" below first.
 
 ### Create your first session in WeChat
 
-Send these two messages in WeChat:
+Send these messages in WeChat:
 
 ```text
 /ss codex -d /absolute/path/to/your/repo
 /help
 ```
 
-Then just send plain text, for example:
+Then just send plain text:
 
 ```text
 hello
@@ -82,14 +69,9 @@ hello
 
 If everything works, plain text goes into the current session and the agent's reply comes back to WeChat.
 
-### Switch / add other channels
-
-WeChat is the built-in default channel. Feishu and Yuanbao are distributed as official plugin packages, and third-party channels follow the same plugin flow. If you can't remember the package names, check the official plugin list first:
+### Other channels
 
-```bash
-xacpx plugin known
-# Install: xacpx plugin add <package>
-```
+WeChat is the built-in default channel. Feishu and Yuanbao are distributed as official plugin packages, and third-party channels follow the same plugin flow. If you can't remember the package names, run `xacpx plugin known` first.
 
 ```bash
 # Feishu
@@ -103,7 +85,7 @@ xacpx channel add yuanbao    # enter appKey/appSecret when prompted
 xacpx restart
 ```
 
-For full credential configuration, parameters, and management commands such as `enable/disable/rm`, see [docs/channel-management.md](./docs/channel-management.md). If you want to write your own channel plugin, see [docs/plugin-development.md](./docs/plugin-development.md).
+Full credentials, parameters, and management commands (`enable/disable/rm`): [channel-management.md](./docs/channel-management.md). To write your own channel plugin: [plugin-development.md](./docs/plugin-development.md).
 
 ## Your everyday workflow
 
@@ -111,34 +93,16 @@ The most common sequence is just four steps:
 
 1. **Start the background service**: `xacpx start`
 2. **Create or switch sessions**: `/ss ...`, `/use ...`
-3. **Send plain text directly**: let the current session keep working
-4. **Check status or cancel the current task when needed**: `/status`, `/cancel`
-
-### 1) Create a session
-
-The most common command:
-
-```text
-/ss codex -d /absolute/path/to/your/repo
-```
-
-It uses `codex`, binds this working directory, and automatically switches to the new session.
-
-### 2) Send plain messages
-
-Any text not starting with `/` is sent to the current session.
-
-```text
-Fix this recent API timeout issue
-```
+3. **Send plain text directly**: any text not starting with `/` goes to the current session
+4. **Check status or cancel when needed**: `/status`, `/cancel`
 
-### 3) View replies
+### Reply modes
 
-`xacpx` supports three common reply modes:
+`xacpx` supports three reply modes (switch per session with `/replymode`):
 
 - `stream`: stream back intermediate text
 - `final`: return only the final result
-- `verbose`: the default; in addition to streaming text, also shows tool-call summaries
+- `verbose`: the default; streaming text plus tool-call summaries
 
 For example, in `verbose` mode you'll see:
 
@@ -149,474 +113,121 @@ For example, in `verbose` mode you'll see:
 ✏️ Edit parse-command.ts
 ```
 
-### 4) Switch sessions
+## Command cheat sheet
 
-```text
-/ss
-/use backend:codex
-```
-
-This lets you switch between sessions for different projects and different agents within the same WeChat chat.
-
-## Common CLI commands
+The essentials to get going. Full references: **CLI → [cli-reference.md](./docs/cli-reference.md)**, **chat commands → [commands.md](./docs/commands.md)**.
 
-These commands run in a terminal on your computer.
+**Terminal (on the host):**
 
 | Command | Description |
 |------|------|
-| `xacpx login` | Log in to WeChat |
-| `xacpx logout` | Clear the WeChat login credentials saved on this machine |
-| `xacpx run` | Run in the foreground, useful for debugging |
-| `xacpx start` | Start the service in the background |
-| `xacpx status` | Show background status, PID, config path, and log path |
-| `xacpx stop` | Stop the background instance |
-| `xacpx restart` | Restart the background instance so channel config changes take effect |
-| `xacpx update [--all\|<name>]` | Check and update xacpx and installed plugins; when plugins are installed, it interactively lets you choose what to update |
-| `xacpx channel list\|show\|add\|rm\|enable\|disable [--account <id>]` | Manage message channels; `--account <id>` targets one bot when several share a channel (multi-bot) |
-| `xacpx plugin list\|add\|update\|remove\|enable\|disable\|doctor\|known` | Manage plugins: list/install/update/remove, toggle, run `doctor`, or list official packages with `known` |
-| `xacpx plugin add @ganglion/xacpx-channel-feishu && xacpx channel add feishu` | Install and add the Feishu channel; prompts for Feishu app credentials |
-| `xacpx plugin add @ganglion/xacpx-channel-yuanbao && xacpx channel add yuanbao` | Install and add the Yuanbao channel; prompts for Yuanbao appKey/appSecret |
+| `xacpx login` / `logout` | Log in / out of WeChat |
+| `xacpx start` / `stop` / `restart` / `status` | Manage the background service |
+| `xacpx update` | Update xacpx and installed plugins |
 | `xacpx doctor` | Run environment diagnostics |
-| `xacpx version` | Show the current version |
-| `xacpx agent list` | List agents registered on this machine |
-| `xacpx agent add <name>` | Add an agent from a built-in template; an existing agent of the same name with a different config is not overwritten |
-| `xacpx agent rm <name>` | Remove an agent |
-| `xacpx workspace list` | List workspaces registered on this machine |
-| `xacpx workspace add [name] [--raw]` | Register the current directory as a workspace; without `name`, uses the current directory name, and names with special characters are normalized automatically |
-| `xacpx workspace rm <name>` | Remove a workspace |
-| `xacpx later list` / `xacpx lt list` | List this machine's pending scheduled tasks in the terminal |
-| `xacpx later cancel <id>` / `xacpx lt cancel <id>` | Cancel a pending scheduled task in the terminal |
-
-The first time you run `xacpx start` or `xacpx run`, if there are no sessions, workspaces, or plugins, the CLI asks whether to register the current directory as a workspace and lets you choose a built-in agent template; after the service starts, it creates the initial acpx session through the normal session-creation flow.
-
-`workspace` can also be abbreviated as `ws`:
-
-```bash
-xacpx ws add
-xacpx ws list
-xacpx ws rm backend
-```
-
-### How to use the `workspace` CLI
-
-`xacpx workspace` maintains the `workspaces` config in `~/.xacpx/config.json` on your local machine. It's good for registering frequently used project directories in the terminal first, then referencing them directly in WeChat with `--ws <name>`.
-
-| Command | Description |
-|------|------|
-| `xacpx workspace list` | List registered workspaces and their paths |
-| `xacpx workspace add` | Register the current directory as a workspace, defaulting the name to the current directory name (normalized automatically) |
-| `xacpx workspace add <name>` | Register the current directory under a specific name (normalized if it contains special characters) |
-| `xacpx workspace add [name] --raw` | Keep the original name (including spaces, etc.); later commands must quote it |
-| `xacpx workspace rm <name>` | Remove a specific workspace |
-
-Common usage:
-
-```bash
-cd /absolute/path/to/backend
-xacpx workspace add backend
-
-cd /absolute/path/to/frontend
-xacpx ws add frontend
-
-xacpx ws list
-xacpx ws rm frontend
-```
+| `xacpx channel add <name>` | Add a message channel (Feishu / Yuanbao / …) |
+| `xacpx ws add` / `xacpx agent add <name>` | Register a workspace / agent |
 
-Once registered, you can use it directly in WeChat:
-
-```text
-/ss codex --ws backend
-/ss new claude --ws frontend
-```
-
-Note: `workspace add` always registers the **directory the terminal is currently in**. Without a name, it uses the current directory name as the workspace name. Names containing spaces, Chinese characters, etc. are normalized automatically to `[a-zA-Z0-9._-]+` (for example, the directory `My Project` is saved as `My-Project`), with `-2`, `-3` appended on collisions. To keep the original name, add `--raw`; afterwards `xacpx workspace rm`, `/ws rm`, and `--ws <name>` all need quoting, for example `xacpx workspace rm "My Project"`.
-
-### How to use the `agent` CLI
-
-`xacpx agent` maintains the `agents` config in `~/.xacpx/config.json` on your local machine; `agents` is an equivalent alias.
+**Chat (in WeChat / Feishu / Yuanbao):**
 
 | Command | Description |
 |------|------|
-| `xacpx agent list` | List registered agents |
-| `xacpx agent templates` | List the built-in templates you can add |
-| `xacpx agent add <name>` | Add an agent from a built-in template, e.g. `kimi`, `opencode` |
-| `xacpx agent rm <name>` | Remove a specific agent |
-
-Common usage:
-
-```bash
-xacpx agent templates
-xacpx agent add kimi
-xacpx agents list
-xacpx agent rm kimi
-```
-
-### How to use `doctor`
-
-```bash
-xacpx doctor
-xacpx doctor --verbose
-xacpx doctor --smoke
-xacpx doctor --smoke --agent codex --workspace backend
-xacpx doctor --fix
-```
-
-Notes:
-
-- `--verbose` expands the details of each check
-- `--smoke` additionally runs a minimal real transport-level prompt check
-- `--agent` / `--workspace` only affect `--smoke`
-- Without `--smoke`, the related checks show as `SKIP`
-- `--fix` applies safe local repairs (runtime dir permissions, stale locks, invalid state records) and re-checks; state-mutating repairs are withheld while the daemon runs — see [docs/doctor-command.md](docs/doctor-command.md)
-
-### How to use `update`
-
-`xacpx update` checks for and installs new versions of xacpx itself and your installed channel plugins.
-
-```bash
-xacpx update            # interactive: pick what to update
-xacpx update --all      # update everything (core + all plugins) non-interactively
-xacpx update <name>     # update a single target (the core, or a specific plugin package)
-```
-
-Notes:
-
-- When plugins are installed, the bare `xacpx update` is interactive and lets you choose which targets to update.
-- In a non-interactive environment, updating the core or plugins needs explicit confirmation: use `xacpx update --all`, or name the target with `xacpx update <name>`.
-- `update` covers the core package and channel plugins; to manage a single plugin's version directly, see `xacpx plugin update <name>` ([docs/plugin-development.md](./docs/plugin-development.md)).
-- After updating, run `xacpx restart` so a running daemon loads the new version.
-- Cross-package rename migration: this project was renamed `weacpx` → `xacpx`. If you still have the legacy `weacpx` package installed, running `weacpx update` will offer to migrate you across to `xacpx` automatically (you confirm the switch). Already on `xacpx`? Just use `xacpx update` as a normal self-update.
-
-## Common chat commands
-
-These commands are sent in a WeChat or Feishu chat. For the full command reference, see [docs/commands.md](./docs/commands.md).
-
-### Agent management
-
-The default config usually already includes `codex` and `claude`. If you want to use another acpx-supported agent, you can add it from a built-in template with `/agent add <name>`.
-
-| Command | Description |
-|------|------|
-| `/agents` | List agents |
-| `/agent add gemini` | Add the `Gemini` agent |
-| `/agent add opencode` | Add the `OpenCode` agent |
-| `/agent rm <name>` | Remove an agent |
-
-The current built-in templates align with acpx's built-in agents:
-
-```text
-codex, claude, pi, openclaw, gemini, cursor, copilot, droid,
-factory-droid, factorydroid, iflow, kilocode, kimi, kiro,
-opencode, qoder, qwen, trae
-```
-
-These templates only write `driver`; the actual launch command is resolved by acpx. For example, `/agent add kimi` saves `{ "driver": "kimi" }`. For full command docs see [docs/commands.md](./docs/commands.md), and for config fields see [docs/config-reference.md](./docs/config-reference.md).
-
-### Workspace management
-
-| Command | Description |
-|------|------|
-| `/workspaces` / `/workspace` / `/ws` | List workspaces |
-| `/ws new <name> -d <path> [--raw]` | Add a workspace; `path` is an absolute path on your computer, and Windows does not distinguish forward/back slashes; names with special characters such as spaces/Chinese are normalized automatically, and --raw keeps the original name |
-| `/workspace rm <name>` | Remove a workspace |
-
-### Sessions
-
-| Command | Description |
-|------|------|
-| `/sessions` / `/session` / `/ss` | List sessions |
-| `/ss <agent> (-d <path> \| --ws <name>)` | Create or reuse your current most-used session |
-| `/ss new <agent> (-d <path> \| --ws <name>)` | Force-create a new session |
-| `/ssn <agent> (-d <path> \| --ws <name>)` | Attach to an existing native session of a local agent; see [native sessions](./docs/native-sessions.md) |
+| `/ss <agent> -d <path>` | Create or reuse a session in a project directory |
+| `/ss new <agent> --ws <name>` | Force-create a new session |
+| `/ssn <agent> -d <path>` | Attach to a local agent's [native session](./docs/native-sessions.md) |
 | `/use <alias>` | Switch the current session |
-| `/status` | Show the current session status |
-| `/mode` / `/mode <id>` | View or set the underlying `acpx` mode |
-| `/model` / `/model <id>` | View or switch the session's LLM model (also `/session new --model`, `/agent add --model`) |
-| `/replymode` | Show the current reply mode |
-| `/replymode stream` | Streaming replies |
-| `/replymode verbose` | Streaming + tool-call summaries |
-| `/replymode final` | Return only the final result |
-| `/replymode reset` | Fall back to the global default reply mode |
-| `/session reset` | Reset the current session context |
-| `/clear` | Shortcut alias for `/session reset` |
-| `/cancel` / `/stop` | Stop the current task |
-
-We suggest remembering these three first:
+| `/status` · `/cancel` | Show status · stop the current task |
+| `/model` · `/mode` | Switch the LLM model · set the acpx mode |
+| `/replymode stream\|verbose\|final` | Change how replies stream |
+| `/lt <time> <message>` | Schedule a one-time future message ([/later](./docs/later-command.md)) |
+| `/dg <agent> <task>` | Delegate a subtask to another agent |
+| `/pm set read` · `/config set <path> <value>` | Permissions · whitelisted config |
 
-```text
-/ss codex -d /absolute/path/to/repo
-/use <alias>
-/cancel
-```
+## Multi-agent orchestration & MCP
 
-To attach to an existing native session of a local agent such as Codex, use `/ssn codex -d /absolute/path/to/repo`; for full semantics see [docs/native-sessions.md](./docs/native-sessions.md).
+The current session acts as the coordinator; delegated subtasks (`/dg`, `/tasks`,
+`/task approve`) run as independent worker sessions and need human confirmation by
+default. External MCP hosts such as Codex or Claude Code can drive xacpx's
+orchestration directly by configuring `xacpx mcp-stdio` as a stdio MCP server
+(`delegate_request` / `delegate_batch` support MCP Tasks).
 
-### Scheduled tasks (/later)
-
-Have the agent automatically receive a message at some point in the future. **By default it runs in a temporary session created just for that task** (inheriting the agent and workspace of the current session at creation time, with a fresh conversation history, destroyed once finished); adding `--bind` sends it to the current session bound at creation time. When the time comes, the message is delivered as a normal prompt and the result is pushed back to the original chat.
-
-| Command | Description |
-|------|------|
-| `/lt <time> <message>` | Create a scheduled task (runs in a temporary session by default; `/later` is a synonym) |
-| `/lt --bind <time> <message>` | Send to the current session instead |
-| `/lt list` | List globally pending tasks |
-| `/lt cancel <id>` | Cancel a pending task |
-
-The most common examples:
-
-```text
-/lt in 2h check whether CI passes        # temporary session (default)
-/lt --bind tomorrow 09:00 review the PR    # bound to the current session
-/lt list
-```
-
-Notes:
-
-- Runs in a temporary session by default; `--bind` binds to the current session. The default mode can be changed via the config `later.defaultMode` (`temp` / `bind`, default `temp`)
-- Only one-time tasks are supported; the time must be more than 10 seconds and within 7 days from now
-- The time format is a fixed whitelist (relative time / today·tomorrow·day-after-tomorrow / weekday + time); natural language is not supported
-- In normal conversation, the agent can also create, list, and cancel scheduled tasks via the current session's internal tools (`scheduled_create` / `scheduled_list` / `scheduled_cancel`); routing and permissions are resolved by the daemon from the current chat session, and the external `mcp-stdio` does not expose these tools
-- You can also manage pending tasks from the terminal with `xacpx later list` / `xacpx later cancel <id>`; the CLI only lists and cancels, it does not create scheduled tasks
-- For full time formats, temporary/bound modes, task status, and limits, see [docs/later-command.md](./docs/later-command.md)
-
-### Config and permissions
-
-| Command | Description |
-|------|------|
-| `/config` | Show the config paths that can be changed via chat commands |
-| `/config set <path> <value>` | Change a whitelisted config item |
-| `/pm` / `/permission` | Show the current permission mode |
-| `/pm set allow` | Switch to `approve-all` |
-| `/pm set read` | Switch to `approve-reads` |
-| `/pm set deny` | Switch to `deny-all` |
-| `/pm auto` | Show the current non-interactive permission policy |
-| `/pm auto deny` | Switch to `deny` |
-| `/pm auto fail` | Switch to `fail` |
-
-The most common examples:
-
-```text
-/config set wechat.replyMode final
-/pm set read
-/pm auto deny
-```
-
-> `/config set language en` (or `zh`) switches the xacpx interface language; it otherwise follows your system locale. See [docs/config-reference.md](./docs/config-reference.md).
-
-### Multi-agent orchestration
-
-The README keeps only the most common user-facing commands.
-
-| Command | Description |
-|------|------|
-| `/dg <agent> <task>` | Quickly delegate a subtask |
-| `/tasks` | List tasks under the current main line |
-| `/task <id>` | Show details of a single task |
-| `/task approve <id>` | Approve a `needs_confirmation` task |
-| `/task cancel <id>` | Cancel a task; cancelling a not-yet-approved task is equivalent to rejecting it |
-
-The most common examples:
-
-```text
-/dg claude review the 3 high-risk points of the current plan
-/tasks
-/task approve task_123
-```
-
-Notes:
-
-- The current session is the coordinator session
-- What gets delegated out are independent subtask sessions
-- Delegation requests initiated by the agent require human confirmation by default
-- If you're using an external MCP host (Codex / Claude Code), use `delegate_batch` to dispatch multiple parallel subtasks at once: pass a `tasks` array, a group is created automatically under the hood, and all results are injected back at once with no need to maintain a groupId manually
-
-If you want to first understand when to delegate and when to dispatch multiple subtasks in parallel, see:
-
-- [docs/xacpx-group-usage-guide.md](./docs/xacpx-group-usage-guide.md)
-
-
-### MCP integration: external coordinator
-
-If you want external MCP hosts such as Codex or Claude Code to use xacpx's multi-agent orchestration directly, you can configure `xacpx mcp-stdio` as a stdio MCP server.
-
-`delegate_request` supports MCP Tasks: a host that supports this capability can make the delegation request return a native task handle immediately, then get status, results, or cancel the task via `tasks/get` / `tasks/result` / `tasks/cancel`; the worker's `[PROGRESS] ...` output shows up in the `statusMessage` of `tasks/get` / `tasks/list`; in the `input_required` state, `tasks/result` returns a next-step hint and ends this result stream rather than blocking for a long time; after the client calls tools such as `task_get` / `task_approve` / `coordinator_answer_question` per the hint, it continues polling `tasks/get` / `tasks/result`. A host that does not support MCP Tasks can still use the compatibility tools `task_get` / `task_list` / `task_watch` / `task_cancel`.
-
-The natural-language creation tool for scheduled tasks is an internal capability of the xacpx current session and does not appear in the external `xacpx mcp-stdio` tool list.
-
-Start the daemon first:
-
-```bash
-xacpx start
-```
-
-We recommend keeping the MCP config simple and not binding a workspace in the launch arguments:
-
-```json
-{
-  "mcpServers": {
-    "xacpx": {
-      "command": "xacpx",
-      "args": ["mcp-stdio"]
-    }
-  }
-}
-```
-
-When an external host calls `delegate_request`, pass `workingDirectory`, and xacpx will make the delegated worker work in that directory:
-
-```json
-{
-  "targetAgent": "claude",
-  "task": "review the risks of this change",
-  "workingDirectory": "/absolute/path/to/your/repo"
-}
-```
-
-On Windows, if the MCP host won't resolve a `command` with arguments for you, put `node.exe` in `command` and the xacpx script and arguments in `args`:
-
-```json
-{
-  "type": "stdio",
-  "command": "C:\\Program Files\\nodejs\\node.exe",
-  "args": [
-    "C:\\path\\to\\xacpx\\dist\\cli.js",
-    "mcp-stdio"
-  ]
-}
-```
-
-For more identity rules, `workingDirectory` semantics, the tool list, flow diagrams, and troubleshooting, see [docs/external-mcp.md](./docs/external-mcp.md).
+- When to delegate vs. open a parallel group: [xacpx-group-usage-guide.md](./docs/xacpx-group-usage-guide.md)
+- External MCP setup, identity rules, tool list, troubleshooting: [external-mcp.md](./docs/external-mcp.md)
 
 ## Common scenarios
 
-### Keep watching a local project from your phone
-
 ```text
+# Keep watching a local project from your phone
 /ss codex -d /absolute/path/to/backend
 take a look at today's API timeout issue
-```
-
-### Switch between two projects in the same chat
 
-```text
+# Switch between two projects in the same chat
 /ss codex -d /absolute/path/to/backend
 /ss new codex -d /absolute/path/to/frontend
 /ss
 /use backend:codex
-/use frontend:codex
-```
-
-### Attach to an existing local Codex native session
 
-```text
+# Attach to an existing local Codex native session
 /ssn codex -d /absolute/path/to/backend
 /ssn 1
 ```
 
-For more filtering, aliases, and troubleshooting, see [docs/native-sessions.md](./docs/native-sessions.md).
-
 ## Self-hosted relay hub (optional)
 
-If you run several xacpx instances and want to drive them all from one browser dashboard, you can self-host the **relay hub**. Each instance dials out to the hub over WebSocket and registers; you log in to a multi-tenant web dashboard and manage every instance's sessions — chat, scheduled tasks, and orchestration — from one place. Streaming agent replies render as markdown, and the layout works on mobile.
-
-The hub ships as an npm package (`@ganglion/xacpx-relay`) with the dashboard **bundled in** — no separate build. It serves everything on a single port (HTTP API + dashboard + the instance WebSocket gateway), and authentication is a single **access token** used for both web login and connector pairing.
+If you run several xacpx instances and want to drive them all from one browser dashboard, you can self-host the **relay hub**. Each instance dials out to the hub over WebSocket and registers; you log in to a multi-tenant web dashboard and manage every instance's sessions — chat, scheduled tasks, and orchestration — from one place. The hub ships as an npm package (`@ganglion/xacpx-relay`) with the dashboard **bundled in**, served on a single port, with a single **access token** for both web login and connector pairing.
 
 ```bash
-# 1. On the hub host: install (dashboard is bundled — nothing else to build)
 npm i -g @ganglion/xacpx-relay
+xacpx-relay add token        # prints the access token once
+xacpx-relay start            # defaults: --host 0.0.0.0 --http-port 8787
 
-# 2. Mint an access token (DB auto-created at ~/.xacpx-relay/relay.db)
-xacpx-relay add token
-#   → prints the token once; use it to log into the dashboard AND to pair connectors
-
-# 3. Start the hub (defaults: --host 0.0.0.0 --http-port 8787, dashboard auto-detected)
-xacpx-relay start
-
-# 4. On each instance host: add the connector channel and point it at the hub
+# On each instance host:
 xacpx plugin add @ganglion/xacpx-channel-relay   # requires xacpx >= 0.11.0
 xacpx channel add relay --url wss://relay.example.com --token <access-token> --name my-box
 xacpx restart
 ```
 
-In production, terminate TLS at a reverse proxy in front of the single port and have instances dial `wss://`. There's no `stop`/`status` subcommand — manage the process with systemd/pm2/Docker (`Ctrl-C`/`SIGTERM` to stop); update with `xacpx-relay update`.
-
-Full walkthrough — pairing instances, TLS/reverse-proxy, systemd, backups, troubleshooting: **[Self-Hosting the Relay Hub](https://gadzan.github.io/xacpx/guide/relay-self-hosting)** (or [docs/relay-deployment.md](./docs/relay-deployment.md) for the terse runbook).
+Full walkthrough — pairing, TLS/reverse-proxy, systemd, backups, troubleshooting: **[Self-Hosting the Relay Hub](https://gadzan.github.io/xacpx/guide/relay-self-hosting)** (or [relay-deployment.md](./docs/relay-deployment.md) for the terse runbook).
 
 ## Config and runtime files
 
-Default file locations:
-
 - Config file: `~/.xacpx/config.json`
 - State file: `~/.xacpx/state.json`
 - Runtime log: `~/.xacpx/runtime/app.log`
 
-More runtime files are placed under `~/.xacpx/runtime/`.
-
-## FAQ
-
-### What if `/ss new` fails?
-
-If session creation fails in WeChat, the most common cause is not a wrong `xacpx` command format, but that the underlying session was not created successfully.
-
-You can try these two steps first:
-
-1. Confirm in the terminal that the current project directory and the agent itself work
-2. If you're familiar with `acpx`, manually create a session first, then attach to it from WeChat
-
-For example, you can create a session locally first:
-
-```bash
-./node_modules/.bin/acpx --verbose --cwd /absolute/workspace/path codex sessions new --name existing-demo
-```
-
-Then attach to it from WeChat:
-
-```text
-/ss attach demo -a codex --ws backend --name existing-demo
-```
-
-### What is the `<id>` in `/mode <id>`?
-
-The valid values for `/mode` depend on the agent you're currently using; `xacpx` does not normalize these values for you.
-
-Currently the more clearly known values are:
-
-- `codex`: `plan`
-- `cursor`: `agent`, `plan`, `ask`
-
-If you're unsure whether a value works, check the corresponding agent's docs first; if you get it wrong, you'll usually get an error such as an invalid argument.
+More runtime files are placed under `~/.xacpx/runtime/`. For the full config field reference, see [config-reference.md](./docs/config-reference.md).
 
 ## Running from source
 
-If you're using the repo source directly:
-
 ```bash
 bun install
 bun run login
 bun run dev
 ```
 
-## More docs
-
-If what you're about to do is one of the following, you can continue from here:
-
-### Installation and configuration
-
-- Want to configure WeChat, Feishu, Yuanbao, or a third-party plugin channel: [docs/channel-management.md](./docs/channel-management.md)
-- Want to write your own channel plugin: [docs/plugin-development.md](./docs/plugin-development.md)
-- Want the full config field reference: [docs/config-reference.md](./docs/config-reference.md)
-- Want to change config from WeChat: [docs/config-command.md](./docs/config-command.md)
+For development, debugging, and contribution details, see [developments.md](./docs/developments.md).
 
-### Everyday use
-
-- Want the full chat-command reference: [docs/commands.md](./docs/commands.md)
-- Want to schedule a one-time future message with scheduled tasks (`/later`): [docs/later-command.md](./docs/later-command.md)
-- Want to understand when to delegate and when to open a group: [docs/xacpx-group-usage-guide.md](./docs/xacpx-group-usage-guide.md)
-
-### Troubleshooting and verification
-
-- Want to run tests or understand the test layout: [docs/testing.md](./docs/testing.md)
-
-### Development and contribution
+## More docs
 
-- Want to develop, debug, or contribute from source: [docs/developments.md](./docs/developments.md)
+**Install & configure**
+- [channel-management.md](./docs/channel-management.md) — configure WeChat / Feishu / Yuanbao / third-party channels
+- [plugin-development.md](./docs/plugin-development.md) — write your own channel plugin
+- [config-reference.md](./docs/config-reference.md) — full config field reference
+- [config-command.md](./docs/config-command.md) — change config from chat
+
+**Everyday use**
+- [cli-reference.md](./docs/cli-reference.md) — full terminal CLI reference
+- [commands.md](./docs/commands.md) — full chat-command reference
+- [later-command.md](./docs/later-command.md) — scheduled tasks (`/later`)
+- [native-sessions.md](./docs/native-sessions.md) — attach to a local agent's native session
+- [xacpx-group-usage-guide.md](./docs/xacpx-group-usage-guide.md) — when to delegate vs. open a group
+- [external-mcp.md](./docs/external-mcp.md) — external MCP coordinator integration
+
+**Troubleshoot & verify**
+- [faq.md](./docs/faq.md) — common questions (`/ss new` fails, `/mode <id>`, …)
+- [doctor-command.md](./docs/doctor-command.md) — `xacpx doctor` diagnostics and `--fix`
+- [testing.md](./docs/testing.md) — test layout and how to run tests
+
+**Develop & contribute**
+- [developments.md](./docs/developments.md) — develop, debug, or contribute from source
+- [code-wiki.md](./docs/code-wiki.md) — architecture map

package/dist/bridge/bridge-main.js

@@ -460,6 +460,7 @@ function createStreamingPromptState(formatToolCalls = false, options) {
     pendingLine: "",
     formatToolCalls,
     emittedToolCallIds: new Set,
+    toolCalls: new Map,
     toolEventMode,
     rawStream,
     onToolEvent,
@@ -507,7 +508,8 @@ function parseStreamingChunks(state, line) {
     const wantsStructured = state.toolEventMode === "structured" || state.toolEventMode === "both";
     const wantsText = (state.toolEventMode === "text" || state.toolEventMode === "both") && state.formatToolCalls;
     if (wantsStructured && state.onToolEvent) {
-      const toolEvent = buildToolUseEvent(update);
+      const merged = update.toolCallId ? mergeToolCallUpdate(state, update.toolCallId, update) : update;
+      const toolEvent = buildToolUseEvent(merged);
       if (toolEvent)
         state.onToolEvent(toolEvent);
     }
@@ -594,6 +596,29 @@ function formatToolCallEvent(update, sessionUpdate) {
   const statusText = status ? ` (${status})` : "";
   return `${emoji} ${title}${statusText}${summaryText}`;
 }
+function isEmptyToolField(v) {
+  if (v === undefined || v === null)
+    return true;
+  if (typeof v === "string")
+    return v.trim().length === 0;
+  if (Array.isArray(v))
+    return v.length === 0;
+  if (typeof v === "object")
+    return Object.keys(v).length === 0;
+  return false;
+}
+function mergeToolCallUpdate(state, toolCallId, update) {
+  const prev = state.toolCalls.get(toolCallId) ?? { toolCallId };
+  const merged = { ...prev };
+  for (const key of ["kind", "title", "rawInput", "content", "rawOutput", "locations", "status"]) {
+    const next = update[key];
+    if (!isEmptyToolField(next))
+      merged[key] = next;
+  }
+  merged.toolCallId = toolCallId;
+  state.toolCalls.set(toolCallId, merged);
+  return merged;
+}
 function buildToolUseEvent(update) {
   if (!update)
     return null;
@@ -1945,6 +1970,7 @@ var init_misc = __esm(() => {
     defaultHomeWorkspaceDescription: "Home directory",
     pluginChannelFeishu: "Feishu channel",
     pluginChannelYuanbao: "Tencent Yuanbao channel",
+    pluginChannelRelay: "Relay hub connector (drive this instance from a self-hosted relay hub)",
     pluginChannelInstallHint: (channelType, packageName) => `Channel ${channelType} requires a plugin: xacpx plugin add ${packageName}`,
     orchestrationSuggestion1: "Run /tasks --stuck to locate stuck tasks",
     orchestrationSuggestion2: "/task <id> shows the full timeline to locate errors",
@@ -3041,6 +3067,7 @@ var init_misc2 = __esm(() => {
     defaultHomeWorkspaceDescription: "用户主目录",
     pluginChannelFeishu: "飞书频道",
     pluginChannelYuanbao: "腾讯元宝频道",
+    pluginChannelRelay: "Relay hub 连接器（从自托管 relay hub 遥控这台实例）",
     pluginChannelInstallHint: (channelType, packageName) => `频道 ${channelType} 需要安装插件：xacpx plugin add ${packageName}`,
     orchestrationSuggestion1: "查看 /tasks --stuck 定位卡住的任务",
     orchestrationSuggestion2: "/task <id> 可看完整时间线定位错误点",

package/dist/cli.js

@@ -1075,6 +1075,7 @@ var init_misc = __esm(() => {
     defaultHomeWorkspaceDescription: "Home directory",
     pluginChannelFeishu: "Feishu channel",
     pluginChannelYuanbao: "Tencent Yuanbao channel",
+    pluginChannelRelay: "Relay hub connector (drive this instance from a self-hosted relay hub)",
     pluginChannelInstallHint: (channelType, packageName) => `Channel ${channelType} requires a plugin: xacpx plugin add ${packageName}`,
     orchestrationSuggestion1: "Run /tasks --stuck to locate stuck tasks",
     orchestrationSuggestion2: "/task <id> shows the full timeline to locate errors",
@@ -2171,6 +2172,7 @@ var init_misc2 = __esm(() => {
     defaultHomeWorkspaceDescription: "用户主目录",
     pluginChannelFeishu: "飞书频道",
     pluginChannelYuanbao: "腾讯元宝频道",
+    pluginChannelRelay: "Relay hub 连接器（从自托管 relay hub 遥控这台实例）",
     pluginChannelInstallHint: (channelType, packageName) => `频道 ${channelType} 需要安装插件：xacpx plugin add ${packageName}`,
     orchestrationSuggestion1: "查看 /tasks --stuck 定位卡住的任务",
     orchestrationSuggestion2: "/task <id> 可看完整时间线定位错误点",
@@ -19512,6 +19514,12 @@ var init_known_plugins = __esm(() => {
       channels: ["yuanbao"],
       descriptionKey: "pluginChannelYuanbao",
       official: true
+    },
+    {
+      packageName: "@ganglion/xacpx-channel-relay",
+      channels: ["relay"],
+      descriptionKey: "pluginChannelRelay",
+      official: true
     }
   ];
 });
@@ -21780,8 +21788,9 @@ async function buildCoordinatorPrompt(input) {
 `));
   }
   if (input.userText) {
-    sections.push([t().coordinatorPrompt.userMessageLabel, input.userText].join(`
-`));
+    const hasOrchestrationContext = sections.length > 0;
+    sections.push(hasOrchestrationContext ? [t().coordinatorPrompt.userMessageLabel, input.userText].join(`
+`) : input.userText);
   }
   const claimHumanReply = shouldBind && input.chatKey && activePackage?.awaitingReplyMessageId ? {
     coordinatorSession: input.coordinatorSession,
@@ -22380,6 +22389,9 @@ async function handleSessionArchive(context, chatKey, alias, archive) {
 async function promptWithSession(context, session3, chatKey, text, reply, replyContextToken, accountId, media, abortSignal, onToolEvent, onThought, perfSpan, metadata, onPlan, onUsage, onCommands) {
   if (session3.archived) {
     await context.sessions.setArchived(session3.alias, false);
+    if (!await context.lifecycle.checkTransportSession(session3)) {
+      await context.lifecycle.ensureTransportSession(session3, reply, perfSpan);
+    }
   }
   const effectiveReplyMode = resolveEffectiveReplyMode(context.config, chatKey, session3.replyMode);
   if (!session3.replyMode)
@@ -25023,17 +25035,6 @@ class CommandRouter {
       try {
         await this.transport.cancel(session3);
       } catch {}
-      if (this.transport.removeSession) {
-        try {
-          await this.transport.removeSession(session3);
-        } catch (error2) {
-          await this.logger.error("session.archive_close_failed", "failed to close acpx session on archive", {
-            alias: internalAlias,
-            transportSession: session3.transportSession,
-            message: error2 instanceof Error ? error2.message : String(error2)
-          });
-        }
-      }
     }
     await this.sessions.setArchived(internalAlias, true);
   }
@@ -31753,6 +31754,7 @@ function createStreamingPromptState(formatToolCalls = false, options) {
     pendingLine: "",
     formatToolCalls,
     emittedToolCallIds: new Set,
+    toolCalls: new Map,
     toolEventMode,
     rawStream,
     onToolEvent,
@@ -31800,7 +31802,8 @@ function parseStreamingChunks(state, line) {
     const wantsStructured = state.toolEventMode === "structured" || state.toolEventMode === "both";
     const wantsText = (state.toolEventMode === "text" || state.toolEventMode === "both") && state.formatToolCalls;
     if (wantsStructured && state.onToolEvent) {
-      const toolEvent = buildToolUseEvent(update);
+      const merged = update.toolCallId ? mergeToolCallUpdate(state, update.toolCallId, update) : update;
+      const toolEvent = buildToolUseEvent(merged);
       if (toolEvent)
         state.onToolEvent(toolEvent);
     }
@@ -31887,6 +31890,29 @@ function formatToolCallEvent(update, sessionUpdate) {
   const statusText = status ? ` (${status})` : "";
   return `${emoji2} ${title}${statusText}${summaryText}`;
 }
+function isEmptyToolField(v) {
+  if (v === undefined || v === null)
+    return true;
+  if (typeof v === "string")
+    return v.trim().length === 0;
+  if (Array.isArray(v))
+    return v.length === 0;
+  if (typeof v === "object")
+    return Object.keys(v).length === 0;
+  return false;
+}
+function mergeToolCallUpdate(state, toolCallId, update) {
+  const prev = state.toolCalls.get(toolCallId) ?? { toolCallId };
+  const merged = { ...prev };
+  for (const key of ["kind", "title", "rawInput", "content", "rawOutput", "locations", "status"]) {
+    const next = update[key];
+    if (!isEmptyToolField(next))
+      merged[key] = next;
+  }
+  merged.toolCallId = toolCallId;
+  state.toolCalls.set(toolCallId, merged);
+  return merged;
+}
 function buildToolUseEvent(update) {
   if (!update)
     return null;
@@ -34120,6 +34146,57 @@ var init_agent_catalog = __esm(() => {
   };
 });
 
+// src/config/config-watcher.ts
+import { watch } from "node:fs";
+import { basename as basename3, dirname as dirname12 } from "node:path";
+function startConfigWatcher(options) {
+  const { configPath, onChange, debounceMs = 250, logger: logger2 } = options;
+  const watchFactory = options.watchFactory ?? watch;
+  const dir = dirname12(configPath);
+  const target = basename3(configPath);
+  let timer;
+  let watcher;
+  const fire = () => {
+    timer = undefined;
+    try {
+      onChange();
+    } catch (error2) {
+      logger2?.error("config.watch.callback_failed", "config watch callback threw", {
+        error: error2 instanceof Error ? error2.message : String(error2)
+      });
+    }
+  };
+  try {
+    watcher = watchFactory(dir, { persistent: false }, (_event, filename) => {
+      if (filename !== null && basename3(filename.toString()) !== target)
+        return;
+      if (timer)
+        clearTimeout(timer);
+      timer = setTimeout(fire, debounceMs);
+    });
+    watcher.on("error", (error2) => {
+      logger2?.error("config.watch.error", "config watcher errored", {
+        error: error2 instanceof Error ? error2.message : String(error2)
+      });
+    });
+  } catch (error2) {
+    logger2?.error("config.watch.start_failed", "could not start config watcher", {
+      error: error2 instanceof Error ? error2.message : String(error2)
+    });
+  }
+  return {
+    close: () => {
+      if (timer) {
+        clearTimeout(timer);
+        timer = undefined;
+      }
+      watcher?.close();
+      watcher = undefined;
+    }
+  };
+}
+var init_config_watcher = () => {};
+
 // src/main.ts
 var exports_main = {};
 __export(exports_main, {
@@ -34131,7 +34208,7 @@ __export(exports_main, {
 });
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { homedir as homedir13 } from "node:os";
-import { dirname as dirname12, join as join22 } from "node:path";
+import { dirname as dirname13, join as join22 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 function startProgressHeartbeat(orchestration3, config4, logger2, channel) {
   const thresholdSeconds = config4.orchestration.progressHeartbeatSeconds;
@@ -34661,15 +34738,37 @@ async function buildApp(paths, deps = {}) {
       create: async (name, cwd, description) => {
         const updated = await configStore.upsertWorkspace(name, cwd, description);
         replaceRuntimeConfig(config4, updated);
+        controlEvents.emit({ type: "workspaces-changed" });
         return { name, cwd, ...description ? { description } : {} };
       },
       remove: async (name) => {
         const updated = await configStore.removeWorkspace(name);
         replaceRuntimeConfig(config4, updated);
+        controlEvents.emit({ type: "workspaces-changed" });
       }
     },
     uploadStore
   });
+  const workspaceSignature = (cfg) => JSON.stringify(Object.keys(cfg.workspaces).sort().map((name) => {
+    const ws = cfg.workspaces[name];
+    return [name, ws.cwd, ws.description ?? ""];
+  }));
+  const configWatcher = startConfigWatcher({
+    configPath: paths.configPath,
+    logger: logger2,
+    onChange: () => {
+      const before = workspaceSignature(config4);
+      reloadRuntimeConfig().then(() => {
+        if (workspaceSignature(config4) !== before) {
+          controlEvents.emit({ type: "workspaces-changed" });
+        }
+      }).catch((error2) => {
+        logger2.error("config.reload_failed", "failed to reload config after file change", {
+          error: error2 instanceof Error ? error2.message : String(error2)
+        });
+      });
+    }
+  });
   const scheduledScheduler = new ScheduledTaskScheduler(scheduledService, {
     dispatchTask: buildScheduledDispatchTask({
       getSession: (alias) => sessions.getSession(alias),
@@ -34738,6 +34837,7 @@ async function buildApp(paths, deps = {}) {
     reapStaleQueueOwners: () => reapWarmQueueOwners("startup"),
     dispose: async () => {
       scheduledScheduler.stop();
+      configWatcher.close();
       clearInterval(uploadCleanupInterval);
       if (progressHeartbeatInterval !== undefined) {
         clearInterval(progressHeartbeatInterval);
@@ -34799,7 +34899,7 @@ async function main() {
   }
 }
 async function prepareChannelMedia(configPath, config4) {
-  const runtimeDir = join22(dirname12(configPath), "runtime");
+  const runtimeDir = join22(dirname13(configPath), "runtime");
   const mediaRootDir = join22(runtimeDir, "media");
   const mediaStore = new RuntimeMediaStore({ rootDir: mediaRootDir });
   await mediaStore.cleanupExpired().catch((error2) => {
@@ -34814,7 +34914,7 @@ function resolveRuntimePaths() {
     throw new Error("Unable to resolve the current user home directory");
   }
   const configPath = coreEnv("CONFIG") ?? join22(coreHomeDir(home), "config.json");
-  const runtimeDir = join22(dirname12(configPath), "runtime");
+  const runtimeDir = join22(dirname13(configPath), "runtime");
   return {
     configPath,
     statePath: coreEnv("STATE") ?? join22(coreHomeDir(home), "state.json"),
@@ -34829,12 +34929,12 @@ function resolveBridgeEntryPath() {
   return fileURLToPath5(new URL("./bridge/bridge-main.ts", import.meta.url));
 }
 function resolveAppLogPath(configPath) {
-  const rootDir = dirname12(configPath);
+  const rootDir = dirname13(configPath);
   const runtimeDir = join22(rootDir, "runtime");
   return join22(runtimeDir, "app.log");
 }
 function resolvePerfLogPath(configPath) {
-  const rootDir = dirname12(configPath);
+  const rootDir = dirname13(configPath);
   const runtimeDir = join22(rootDir, "runtime");
   return join22(runtimeDir, "perf.log");
 }
@@ -34883,6 +34983,7 @@ var init_main = __esm(async () => {
   init_control_service();
   init_upload_store();
   init_agent_catalog();
+  init_config_watcher();
   init_perf_tracer();
   init_bootstrap();
   init_i18n();
@@ -35245,7 +35346,7 @@ var init_daemon_check = __esm(() => {
 
 // src/doctor/checks/logs-check.ts
 import { stat as stat5, readdir as readdir7 } from "node:fs/promises";
-import { basename as basename3, join as join24 } from "node:path";
+import { basename as basename4, join as join24 } from "node:path";
 import { homedir as homedir15 } from "node:os";
 async function checkLogs(options = {}) {
   const home = options.home ?? process.env.HOME ?? homedir15();
@@ -35275,7 +35376,7 @@ async function checkLogs(options = {}) {
       `error: ${formatError6(error2)}`
     ]);
   }
-  const baseNames = [basename3(paths.appLog), basename3(paths.stdoutLog), basename3(paths.stderrLog)];
+  const baseNames = [basename4(paths.appLog), basename4(paths.stdoutLog), basename4(paths.stderrLog)];
   const tracked = new Set(baseNames);
   const matched = entries.filter((entry) => isTrackedLogName(entry, tracked));
   const files = [];
@@ -35606,7 +35707,7 @@ var init_plugin_check = __esm(async () => {
 // src/doctor/checks/runtime-check.ts
 import { constants } from "node:fs";
 import { access as access4, stat as stat6 } from "node:fs/promises";
-import { dirname as dirname13 } from "node:path";
+import { dirname as dirname14 } from "node:path";
 import { homedir as homedir17 } from "node:os";
 async function checkRuntime(options = {}) {
   const home = options.home ?? process.env.HOME ?? homedir17();
@@ -35762,7 +35863,7 @@ async function checkFileCreatable(label, path17, probe, platform) {
         detail: `${label}: ${path17} (unusable: ${formatError9(error2)})`
       };
     }
-    const parentCheck = await checkCreatableAncestorDirectory(dirname13(path17), probe, platform);
+    const parentCheck = await checkCreatableAncestorDirectory(dirname14(path17), probe, platform);
     if (!parentCheck.ok) {
       return {
         ok: false,
@@ -35798,7 +35899,7 @@ async function checkCreatableAncestorDirectory(path17, probe, platform) {
         blockingPath: path17
       };
     }
-    const parent = dirname13(path17);
+    const parent = dirname14(path17);
     if (parent === path17) {
       return {
         ok: false,
@@ -36583,7 +36684,7 @@ var init_doctor2 = __esm(async () => {
 init_core_home();
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { homedir as homedir19 } from "node:os";
-import { dirname as dirname14, join as join26, sep as sep2 } from "node:path";
+import { dirname as dirname15, join as join26, sep as sep2 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 
 // src/runtime/migrate-core-home.ts
@@ -53212,7 +53313,7 @@ function safeDaemonLogPaths() {
     const configPath = resolveConfigPathForCurrentEnv();
     const paths = resolveDaemonPathsForCurrentConfig();
     return {
-      appLog: join26(dirname14(configPath), "runtime", "app.log"),
+      appLog: join26(dirname15(configPath), "runtime", "app.log"),
       stderrLog: paths.stderrLog
     };
   } catch {

package/dist/control/control-event-bus.d.ts

@@ -54,6 +54,8 @@ export type ControlEvent = {
     cancelled?: boolean;
 } | {
     type: "sessions-changed";
+} | {
+    type: "workspaces-changed";
 } | {
     type: "scheduled-changed";
     chatKey: string;

package/dist/i18n/types.d.ts

@@ -809,6 +809,7 @@ export interface MiscMessages {
     defaultHomeWorkspaceDescription: string;
     pluginChannelFeishu: string;
     pluginChannelYuanbao: string;
+    pluginChannelRelay: string;
     pluginChannelInstallHint: (channelType: string, packageName: string) => string;
     orchestrationSuggestion1: string;
     orchestrationSuggestion2: string;

package/dist/plugin-api.js

@@ -1050,6 +1050,7 @@ var init_misc = __esm(() => {
     defaultHomeWorkspaceDescription: "Home directory",
     pluginChannelFeishu: "Feishu channel",
     pluginChannelYuanbao: "Tencent Yuanbao channel",
+    pluginChannelRelay: "Relay hub connector (drive this instance from a self-hosted relay hub)",
     pluginChannelInstallHint: (channelType, packageName) => `Channel ${channelType} requires a plugin: xacpx plugin add ${packageName}`,
     orchestrationSuggestion1: "Run /tasks --stuck to locate stuck tasks",
     orchestrationSuggestion2: "/task <id> shows the full timeline to locate errors",
@@ -2146,6 +2147,7 @@ var init_misc2 = __esm(() => {
     defaultHomeWorkspaceDescription: "用户主目录",
     pluginChannelFeishu: "飞书频道",
     pluginChannelYuanbao: "腾讯元宝频道",
+    pluginChannelRelay: "Relay hub 连接器（从自托管 relay hub 遥控这台实例）",
     pluginChannelInstallHint: (channelType, packageName) => `频道 ${channelType} 需要安装插件：xacpx plugin add ${packageName}`,
     orchestrationSuggestion1: "查看 /tasks --stuck 定位卡住的任务",
     orchestrationSuggestion2: "/task <id> 可看完整时间线定位错误点",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganglion/xacpx",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",