@tencent-ai/agent-sdk 0.3.114 → 0.3.116

package/cli/dist/web-ui/docs/en/cli/acp.md

@@ -43,13 +43,39 @@ You can then create a CodeBuddy Code Thread in the Zed sidebar and start using i
   ```json
   {
     "env": {
-      "CODEBUDDY_API_KEY": "your-api-key"
+      "CODEBUDDY_API_KEY": "your-api-key",
+      "CODEBUDDY_INTERNET_ENVIRONMENT": "internal"
     }
   }
   ```
 
+  > **Note**: When using `CODEBUDDY_API_KEY`, you must correctly configure `CODEBUDDY_INTERNET_ENVIRONMENT` based on your version:
+  > - International version: Do not set (default)
+  > - China version: `internal`
+  > - iOA version: `ioa`
+  >
+  > See [Identity and Access Management documentation](iam.md#getting-a-personal-api-key) for details.
+
 ## ACP Protocol Features
 
+### Authentication Information Extension
+
+CodeBuddy Code returns user information in the `_meta` field of the `authenticate` response:
+
+```json
+{
+  "_meta": {
+    "codebuddy.ai/userinfo": {
+      "userId": "User ID",
+      "userName": "Username",
+      "userNickname": "User Nickname"
+    }
+  }
+}
+```
+
+Clients can use this information to provide a better user experience, such as displaying the currently logged-in user or personalizing the interface.
+
 ### Tool Proxy Mechanism
 
 The ACP protocol supports client-side proxying of certain tool operations, improving performance and security:
@@ -69,6 +95,75 @@ CodeBuddy Code automatically pushes the available slash command list (`available
 
 The command list automatically filters out local commands (such as `/clear`, `/exit`) and client-specific commands (such as `/theme`, `/config`), only pushing commands applicable to ACP mode.
 
+### Agent Teams Protocol Extension
+
+CodeBuddy Code extends the ACP protocol through the `_meta` field of `session_info_update` to support real-time status push for Agent Teams multi-agent collaboration.
+
+#### Team Status Events
+
+The following event types are pushed via `_meta['codebuddy.ai/teamUpdate']`:
+
+**Member Status Change** (`member_status_change`):
+
+```json
+{
+  "sessionUpdate": "session_info_update",
+  "_meta": {
+    "codebuddy.ai/teamUpdate": {
+      "type": "member_status_change",
+      "teamName": "my-team",
+      "isAutoTeam": false,
+      "members": [
+        {
+          "name": "ux-designer",
+          "color": "blue",
+          "description": "UX design analysis",
+          "status": "running",
+          "taskId": "agent-abc123",
+          "sessionId": "session-xyz",
+          "tokenUsage": { "inputTokens": 1000, "outputTokens": 500, "lastContextWindow": 42000 },
+          "toolCallCount": 5
+        }
+      ]
+    }
+  }
+}
+```
+
+**Team Created** (`team_created`) / **Deleted** (`team_deleted`):
+
+```json
+{
+  "sessionUpdate": "session_info_update",
+  "_meta": {
+    "codebuddy.ai/teamUpdate": {
+      "type": "team_created",
+      "teamName": "my-team"
+    }
+  }
+}
+```
+
+#### Member Streaming Messages
+
+Real-time messages from members (text, tool calls) are pushed through standard ACP events, with the `_meta['codebuddy.ai/memberEvent']` tag added to identify the message source:
+
+```json
+{
+  "sessionUpdate": "agent_message_chunk",
+  "content": { "type": "text", "text": "Analyzing architecture proposal..." },
+  "_meta": {
+    "codebuddy.ai/memberEvent": "tech-architect"
+  }
+}
+```
+
+Upon receiving events with the `memberEvent` tag, clients should route them to the corresponding member's conversation timeline rather than the main conversation area.
+
+#### Page Refresh Recovery
+
+After a page refresh, once `loadSession`'s `replayHistory` is complete, the current Team status is automatically pushed (`member_status_change` event), so clients do not need to make a separate request. When `AcpTeamBridge` subscribes to a member session, it automatically replays the complete history, so member conversation data is also fully restored via ACP SSE without requiring additional HTTP APIs.
+
 ## Other Editor Support
 
 ACP is an open protocol, so theoretically any editor supporting ACP can integrate with CodeBuddy Code. Configuration is similar to Zed:
@@ -117,8 +212,8 @@ ACP is an open protocol, so theoretically any editor supporting ACP can integrat
 
 ## Related Links
 
-- [CLI Reference](cli-reference.md) - View all command-line parameters
-- [IDE Integration Guide](ide-integrations.md) - More editor integration methods
+- [CLI Reference](./cli-reference.md) - View all command-line parameters
+- [IDE Integration Guide](./ide-integrations.md) - More editor integration methods
 - [ACP Protocol Specification](https://github.com/agentclientprotocol/agent-client-protocol) - Detailed protocol documentation
 
 ---

package/cli/dist/web-ui/docs/en/cli/cli-reference.md

@@ -15,6 +15,14 @@
 | `codebuddy -r "<session-id>" "query"`  | Resume session by ID                            | `codebuddy -r "abc123" "complete this MR"`        |
 | `codebuddy update`                     | Update to the latest version                    | `codebuddy update`                                |
 | `codebuddy mcp`                        | Configure Model Context Protocol (MCP) servers  | See [CodeBuddy Code MCP docs](./mcp.md)           |
+| `codebuddy daemon start`              | Start the Daemon process                        | `codebuddy daemon start --port 8080`              |
+| `codebuddy daemon stop`               | Stop the Daemon                                 | `codebuddy daemon stop`                           |
+| `codebuddy daemon status`             | View Daemon status                              | `codebuddy daemon status`                         |
+| `codebuddy daemon restart`            | Restart the Daemon                              | `codebuddy daemon restart`                        |
+| `codebuddy ps`                        | List all active Worker processes                | `codebuddy ps`                                    |
+| `codebuddy logs <pid\|name>`          | View Worker logs                                | `codebuddy logs feature-x`                        |
+| `codebuddy attach <pid\|name>`        | Attach to a background Worker                   | `codebuddy attach feature-x`                      |
+| `codebuddy kill <pid\|name>`          | Terminate a Worker process                      | `codebuddy kill feature-x`                        |
 
 ## CLI Parameters
 
@@ -53,6 +61,9 @@ Command-line parameters to customize CodeBuddy Code behavior:
 | `--worktree [name]`              | Run in an isolated git worktree (see [Worktree documentation](./worktree.md))                                                    | `codebuddy --worktree` or `codebuddy --worktree my-feature`                                        |
 | `--tmux`                         | Run in a tmux session (used together with `--worktree`)                                                                          | `codebuddy --worktree --tmux`                                                                      |
 | `--plugin-dir <dirs...>`         | Load plugins from local directories (for development/testing), multiple paths supported. See [Plugin documentation](plugins.md)  | `codebuddy --plugin-dir ./my-plugin ../other-plugin`                                               |
+| `--bg`                           | Run session in the background (detached mode), logs output to `~/.codebuddy/logs/`. See [Daemon documentation](daemon.md)       | `codebuddy --bg "implement login page"`                                                            |
+| `--name <name>`                  | Background session name (used with `--bg`, makes it easy to find via `ps`/`logs`/`kill`)                                        | `codebuddy --bg --name feature-x "implement feature"`                                              |
+| `--serve`                        | Start HTTP server (Web UI, REST API, ACP protocol)                                                                               | `codebuddy --serve --port 8080`                                                                    |
 
 > **Important Note**: When using the `-p/--print` parameter for non-interactive execution, operations involving file reading/writing, command execution, network requests, etc. typically require adding the `-y` (or `--dangerously-skip-permissions`) parameter to execute, otherwise the operations will be blocked.
 

package/cli/dist/web-ui/docs/en/cli/daemon.md

@@ -0,0 +1,232 @@
+# Daemon Mode and Background Sessions
+
+Daemon mode runs CodeBuddy Code as a **background resident service**, independent of any terminal window. Once started, it provides a full HTTP API and Web UI, ready to accept requests at any time.
+
+**Core value**: Transform the CLI from "use and go" to "always on standby".
+
+## Concepts
+
+| Concept | Description |
+|---------|-------------|
+| **Worker** | A running CLI process, registered via a PID file in `~/.codebuddy/sessions/` |
+| **Daemon** | A background resident HTTP service process (`--serve` mode), managed via `daemon start` |
+| **Background Session (bg)** | A non-interactive task started with `--bg`, with output automatically logged to a file |
+
+## Daemon Management
+
+### Starting the Daemon
+
+```bash
+# Start the daemon (runs in background, auto-assigns port)
+codebuddy daemon start
+
+# Specify a port
+codebuddy daemon start --port 8080
+
+# Specify bind address (allow remote access)
+codebuddy daemon start --host 0.0.0.0
+```
+
+Once started, the daemon runs as a detached process and the parent process exits immediately. Local addresses have password-free access by default; non-local addresses automatically enable password authentication.
+
+> **Idempotent startup**: Running `daemon start` multiple times does not create multiple daemons. If a daemon is already running, it returns the existing daemon's information.
+
+### Checking Status
+
+```bash
+codebuddy daemon status
+# {"status":"running","pid":12345,"endpoint":"http://127.0.0.1:51862","startedAt":1775498920401}
+```
+
+### Stopping / Restarting
+
+```bash
+codebuddy daemon stop
+codebuddy daemon restart
+```
+
+## Background Sessions
+
+### Starting Background Tasks
+
+```bash
+# Execute a task in the background
+codebuddy --bg "implement login page"
+
+# Specify a name (easier to find)
+codebuddy --bg --name feature-login "implement login page"
+```
+
+Background sessions run in `--print -y` mode (no TUI + skip permission confirmations), with stdout/stderr redirected to `~/.codebuddy/logs/{name}.log`.
+
+### Process Management Commands
+
+```bash
+# List all active Workers
+codebuddy ps
+
+# View background session logs
+codebuddy logs feature-login
+
+# Follow logs continuously (similar to tail -f)
+codebuddy logs feature-login -f
+
+# Attach to a background session
+codebuddy attach feature-login
+
+# Kill a background session
+codebuddy kill feature-login
+```
+
+## HTTP API
+
+All Worker and Daemon management capabilities are exposed via REST APIs. The Web UI Workers page is built on top of these APIs.
+
+See the Workers & Daemon section in the [HTTP API documentation](http-api.md) for details.
+
+### Examples
+
+```bash
+# List all Workers
+curl http://127.0.0.1:8080/api/v1/workers
+
+# Start a Daemon
+curl -X POST http://127.0.0.1:8080/api/v1/daemon/start \
+  -H "Content-Type: application/json" \
+  -d '{"port": 9090}'
+
+# View Worker logs (telemetry logs)
+curl "http://127.0.0.1:8080/api/v1/workers/12345/logs?type=telemetry&tail=100"
+
+# Kill a Worker
+curl -X DELETE http://127.0.0.1:8080/api/v1/workers/12345
+```
+
+## Web UI
+
+After starting in `--serve` mode, the Web UI provides three management pages:
+
+- **Workers** — Worker process management and Daemon control
+- **Logs** — Standalone log viewer with Worker selection, log type switching, and keyword search
+- **Metrics** — System resource monitoring and per-Worker process-level metrics
+
+## Log System
+
+The log API supports 4 types, with automatic priority-based selection:
+
+| Type | Path | Content | Trigger |
+|------|------|---------|---------|
+| `telemetry` | `~/.codebuddy/logs/{date}/{workspace}.log` | Info/Warn/Error from all modules | Always (default priority) |
+| `process` | `~/.codebuddy/logs/{name}.log` | Process stdout/stderr | bg/daemon only |
+| `debug` | `~/.codebuddy/debug/{sessionId}.txt` | Detailed debug information | Requires `--debug` |
+| `transcript` | `~/.codebuddy/projects/{id}/{sessionId}.jsonl` | Conversation history | Always |
+
+## PID File Registry
+
+Each CLI process registers a PID file in `~/.codebuddy/sessions/` on startup:
+
+```
+~/.codebuddy/sessions/
+├── 12345.json          # Local process (PID as filename)
+├── 67890.json          # Another local process
+└── manual-abc123.json  # Manually added remote Worker
+```
+
+PID file contents:
+
+```json
+{
+  "pid": 12345,
+  "sessionId": "interactive-12345",
+  "cwd": "/home/user/project",
+  "startedAt": 1775498920401,
+  "kind": "interactive",
+  "url": "http://127.0.0.1:8080",
+  "mode": "local",
+  "version": "2.78.1",
+  "hostname": "my-machine"
+}
+```
+
+Process liveness is detected via `kill -0`. Manually added remote Workers are detected via heartbeat timeout (2 minutes).
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `CODEBUDDY_SESSION_KIND` | Worker type (interactive / bg / daemon) |
+| `CODEBUDDY_SESSION_NAME` | Background session display name |
+| `CODEBUDDY_SESSION_LOG` | Background session log path |
+| `CODEBUDDY_GATEWAY_AUTH` | Authentication mode (none / password) |
+
+## Use Cases
+
+### Persistent Development Server
+
+Start a daemon once during daily development, then interact with the AI anytime through the browser or API without opening a terminal each time.
+
+```bash
+codebuddy daemon start --port 8080
+# Open http://127.0.0.1:8080 in your browser
+# The service keeps running after closing the terminal
+```
+
+### CI/CD Automation Backend
+
+Start a daemon in a CI pipeline as an Agent service, and have other steps call it via HTTP API for code reviews, test generation, and other tasks.
+
+```bash
+# CI startup
+codebuddy daemon start --port 9090
+
+# Other CI steps call the API
+curl -X POST http://127.0.0.1:9090/api/v1/runs \
+  -H "Content-Type: application/json" \
+  -d '{"prompt": "Review the code changes in this PR"}'
+```
+
+### Shared Agent for Teams
+
+Start a daemon on a development machine bound to a LAN address, allowing team members to share the same Agent environment through the Web UI.
+
+```bash
+codebuddy daemon start --host 0.0.0.0 --port 8080
+# Colleagues access http://192.168.1.100:8080
+```
+
+### Batch Background Tasks
+
+Use `--bg` to start multiple background sessions for different tasks simultaneously, and manage them with `ps`/`logs`/`kill`.
+
+```bash
+codebuddy --bg --name "refactor-auth" "refactor the auth module"
+codebuddy --bg --name "add-tests" "add unit tests for the utils directory"
+codebuddy --bg --name "fix-types" "fix all TypeScript type errors"
+
+# Check progress
+codebuddy ps
+codebuddy logs refactor-auth
+```
+
+### WeChat/WeCom Bot Backend
+
+Run the daemon as a persistent backend service for a chatbot, receiving messages through long-lived connections.
+
+```bash
+codebuddy daemon start
+# Connect to WeChat/WeCom channels via the remote control feature
+```
+
+### IDE Extension Backend
+
+IDE plugins connect to the daemon via the ACP protocol, providing AI-assisted programming without restarting the CLI process each time the IDE is opened.
+
+## Difference from --serve
+
+| Feature | `--serve` | `daemon start` |
+|---------|-----------|-----------------|
+| Lifecycle | Tied to terminal, exits when terminal closes | Background resident, independent of terminal |
+| Startup | Runs in foreground | Forks a detached child process |
+| Management | Stop with Ctrl+C | `daemon stop/status/restart` |
+| Multiple starts | Creates a new process each time | Idempotent, maintains only one daemon |
+| Typical use | Temporary development/debugging | Long-running service |

package/cli/dist/web-ui/docs/en/cli/env-vars.md

@@ -54,11 +54,14 @@ CodeBuddy Code supports environment variables to control its behavior. These var
 |---------|------|
 | `CODEBUDDY_DISABLE_HOT_RELOAD` | Set to `1` to disable the hot reload system |
 | `CODEBUDDY_SKIP_BUILTIN_MARKETPLACE` | Set to `1` to skip loading the built-in plugin marketplace |
+| `CODEBUDDY_AUTO_UPDATE_THIRD_PARTY_MARKETPLACES` | Set to `true` or `1` to enable automatic updates for third-party plugin marketplaces (default: disabled) |
+| `CODEBUDDY_PLUGIN_DIRS` | Colon-separated list of local plugin directory paths (equivalent to `--plugin-dir`). The `bin/` directory of each plugin is automatically injected into `PATH` |
 | `CODEBUDDY_IMAGE_GEN_ENABLED` | Set to `false` or `0` to disable image generation |
 | `CODEBUDDY_IMAGE_EDIT_ENABLED` | Set to `false` or `0` to disable image editing |
 | `CODEBUDDY_DEFER_TOOL_LOADING` | Set to `false` or `0` to disable MCP tool deferred loading |
 | `CODEBUDDY_SHOW_ALL_DEFERRED_TOOLS` | Set to `true` or `1` to show full descriptions for all deferred tools |
 | `CODEBUDDY_DISABLE_CRON` | Set to `1` to disable scheduled tasks |
+| `CODEBUDDY_REHYDRATE_IMAGE_BLOB_REFS` | Set to `true` to rehydrate image blob references to full base64 data in `-p` mode streaming output. Useful for downstream integrations that need direct access to image data |
 
 ## Context and Memory
 

package/cli/dist/web-ui/docs/en/cli/gitlab-ci-cd.md

@@ -346,7 +346,7 @@ codebuddy-prod:
 
 ## Reference Resources
 
-- [CodeBuddy Code Official Documentation](../README.md)
+- [CodeBuddy Code Official Documentation](./README.md)
 - [CLI Reference](cli-reference.md)
 - [Settings Configuration](settings.md)
 - [Common Workflows](common-workflows.md)

package/cli/dist/web-ui/docs/en/cli/http-api.md

@@ -85,7 +85,7 @@ All `/api/v1/*` endpoints use a unified envelope format:
 |--------|----------|-------------|
 | GET | `/api/v1/health` | Health check |
 | GET | `/api/v1/info` | Environment info (version, OS, CWD, etc.) |
-| GET | `/api/v1/metrics` | System resource metrics (aligned with E2B envd) |
+| GET | `/api/v1/metrics` | System resource metrics + instance process metrics |
 | GET | `/api/v1/envs` | Environment variables (aligned with E2B envd) |
 
 ### Authentication
@@ -117,9 +117,11 @@ Supported platforms: `generic`, `wecom` (WeCom), `wechat-kf` (WeChat Customer Se
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/v1/sessions` | Get session list |
+| GET | `/api/v1/sessions` | Get session list (supports cwd query parameter) |
 | DELETE | `/api/v1/sessions/:id` | Delete session |
 | POST | `/api/v1/sessions/:id/rename` | Rename session |
+| GET | `/api/v1/sessions/across-projects` | ⚠️ Deprecated, use `GET /api/v1/sessions?cwd=*` instead |
+| GET | `/api/v1/sessions/workspaces` | ⚠️ Deprecated |
 
 ### PTY (Terminal)
 
@@ -134,13 +136,33 @@ Supported platforms: `generic`, `wecom` (WeCom), `wechat-kf` (WeChat Customer Se
 | POST | `/api/v1/pty/:id/resize` | Resize PTY (aligned with E2B Process.Update) |
 | WebSocket | `/api/v1/pty/:id/ws` | PTY bidirectional data transport (legacy compatible) |
 
-### Instances
+### Workers & Daemon
+
+A Worker is a running CLI process (interactive / bg / daemon), managed through a PID file registry.
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/v1/instances` | Get instance list |
-| POST | `/api/v1/instances` | Add remote instance |
-| DELETE | `/api/v1/instances/:id` | Delete instance |
+| GET | `/api/v1/workers` | Get all active Worker list |
+| POST | `/api/v1/workers` | Manually add remote Worker |
+| GET | `/api/v1/workers/:id` | Get Worker details (by PID or name) |
+| GET | `/api/v1/workers/:id/logs` | Get Worker logs (supports multiple types) |
+| DELETE | `/api/v1/workers/:id` | Terminate Worker process |
+| GET | `/api/v1/daemon/status` | Query Daemon status |
+| POST | `/api/v1/daemon/start` | Start Daemon |
+| POST | `/api/v1/daemon/stop` | Stop Daemon |
+| POST | `/api/v1/daemon/restart` | Restart Daemon |
+
+**Workers query parameters**:
+- `?kind=bg` — Filter by type (interactive / bg / daemon / daemon-worker)
+- `?local=true` — Return local Workers only (used for remote proxy calls)
+
+**Log type parameters** (`GET /api/v1/workers/:id/logs`):
+- `?type=telemetry` — Telemetry logs (`~/.codebuddy/logs/{date}/`)
+- `?type=process` — Process stdout/stderr (bg/daemon logs)
+- `?type=debug` — Debug logs (`~/.codebuddy/debug/`, requires `--debug`)
+- `?type=transcript` — Conversation history summary
+- `?tail=200` — Return only the last N lines
+- When type is omitted, the best source is automatically selected (telemetry > process > debug > transcript)
 
 ### Channels (Remote Control)
 
@@ -219,6 +241,31 @@ Aligned with E2B process.proto, mapping gRPC methods to REST endpoints:
 | GET | `/api/v1/file-changes/checkpoints` | List checkpoints available for rollback |
 | POST | `/api/v1/file-changes/revert` | Revert file changes or rollback to a checkpoint |
 
+### Plugin Management
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/plugins` | List installed plugins |
+| POST | `/api/v1/plugins` | Install plugin |
+| POST | `/api/v1/plugins/validate` | Validate plugin/marketplace manifest file |
+| POST | `/api/v1/plugins/enable` | Enable plugin |
+| POST | `/api/v1/plugins/disable` | Disable plugin |
+| POST | `/api/v1/plugins/uninstall` | Uninstall plugin |
+| GET | `/api/v1/plugins/marketplaces` | List configured plugin marketplaces |
+| POST | `/api/v1/plugins/marketplaces` | Add plugin marketplace |
+| POST | `/api/v1/plugins/marketplaces/browse` | Browse available plugins in marketplace |
+| DELETE | `/api/v1/plugins/marketplaces/:name` | Delete plugin marketplace |
+
+### Settings Management
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/settings` | List all settings |
+| GET | `/api/v1/settings/:key` | Get a single setting value |
+| PUT | `/api/v1/settings/:key` | Set a setting value |
+| POST | `/api/v1/settings/:key/items` | Append values to an array-type setting |
+| POST | `/api/v1/settings/:key/remove` | Remove values from an array-type setting |
+
 ### Task Templates
 
 | Method | Endpoint | Description |
@@ -333,22 +380,40 @@ curl -X POST http://127.0.0.1:8080/api/v1/process/signal/send \
   -H "Content-Type: application/json" \
   -d '{"process": {"tag": "my-script"}, "signal": 15}'
 
-# System metrics
+# System metrics + instance process metrics
 curl http://127.0.0.1:8080/api/v1/metrics
+# Response: { data: { ts, cpuCount, cpuUsedPct, memTotalMib, memUsedMib, diskUsed, diskTotal, instances: [{ id, cwd, pid, rssMib, heapUsedMib, heapTotalMib, uptimeSeconds, ... }] } }
 ```
 
 ### Session Management
 
 ```bash
-# Get session list
+# Get session list for the current workspace
 curl http://127.0.0.1:8080/api/v1/sessions
 
+# Get session list across all workspaces
+curl http://127.0.0.1:8080/api/v1/sessions?cwd=*
+
+# Get session list for a specific working directory
+curl http://127.0.0.1:8080/api/v1/sessions?cwd=/path/to/workspace
+
+# Get session list for a specific project (filter by compressed working directory name)
+curl http://127.0.0.1:8080/api/v1/sessions?cwd=*&projectId=workspace-hash
+
 # Rename session
 curl -X POST http://127.0.0.1:8080/api/v1/sessions/SESSION_ID/rename \
   -H "Content-Type: application/json" \
   -d '{"name": "Performance Optimization Discussion"}'
 ```
 
+**cwd query parameter reference**:
+
+| cwd Value | Description |
+|-----------|-------------|
+| Not provided | Returns sessions for the current workspace |
+| `*` | Returns sessions across all workspaces |
+| `/path/to/workspace` | Returns sessions for the specified working directory |
+
 ### File Change Management
 
 ```bash
@@ -378,6 +443,77 @@ curl -X POST http://127.0.0.1:8080/api/v1/file-changes/revert \
   -d '{}'
 ```
 
+### Plugin Management
+
+```bash
+# List installed plugins
+curl http://127.0.0.1:8080/api/v1/plugins
+
+# Install plugin ("name@marketplace" format)
+curl -X POST http://127.0.0.1:8080/api/v1/plugins \
+  -H "Content-Type: application/json" \
+  -d '{"plugin": "my-plugin@my-marketplace"}'
+
+# Enable plugin
+curl -X POST http://127.0.0.1:8080/api/v1/plugins/enable \
+  -H "Content-Type: application/json" \
+  -d '{"plugin": "my-plugin@my-marketplace"}'
+
+# Disable plugin
+curl -X POST http://127.0.0.1:8080/api/v1/plugins/disable \
+  -H "Content-Type: application/json" \
+  -d '{"plugin": "my-plugin@my-marketplace"}'
+
+# Uninstall plugin
+curl -X POST http://127.0.0.1:8080/api/v1/plugins/uninstall \
+  -H "Content-Type: application/json" \
+  -d '{"plugin": "my-plugin@my-marketplace"}'
+
+# List plugin marketplaces
+curl http://127.0.0.1:8080/api/v1/plugins/marketplaces
+
+# Add plugin marketplace
+curl -X POST http://127.0.0.1:8080/api/v1/plugins/marketplaces \
+  -H "Content-Type: application/json" \
+  -d '{"source": "https://example.com/marketplace", "name": "my-marketplace"}'
+
+# Browse plugins in marketplace
+curl -X POST http://127.0.0.1:8080/api/v1/plugins/marketplaces/browse \
+  -H "Content-Type: application/json" \
+  -d '{"marketplace": "my-marketplace"}'
+
+# Delete plugin marketplace
+curl -X DELETE http://127.0.0.1:8080/api/v1/plugins/marketplaces/my-marketplace
+```
+
+### Settings Management
+
+```bash
+# List all settings
+curl http://127.0.0.1:8080/api/v1/settings
+
+# List settings by scope
+curl "http://127.0.0.1:8080/api/v1/settings?scope=user"
+
+# Get a single setting
+curl http://127.0.0.1:8080/api/v1/settings/model
+
+# Set a setting value
+curl -X PUT http://127.0.0.1:8080/api/v1/settings/theme \
+  -H "Content-Type: application/json" \
+  -d '{"value": "dark"}'
+
+# Append values to an array-type setting
+curl -X POST http://127.0.0.1:8080/api/v1/settings/permissions/items \
+  -H "Content-Type: application/json" \
+  -d '{"values": ["Allow: Read(**)"]}'
+
+# Remove values from an array-type setting
+curl -X POST http://127.0.0.1:8080/api/v1/settings/permissions/remove \
+  -H "Content-Type: application/json" \
+  -d '{"values": ["Allow: Read(**)"]}'
+```
+
 ## Error Codes
 
 | Error Code | HTTP Status | Description |

package/cli/dist/web-ui/docs/en/cli/quickstart.md

@@ -241,7 +241,7 @@ Having issues? We're here to support you:
 
 - 🐛 [Submit a Bug](https://cnb.cool/codebuddy/codebuddy-code/-/issues)
 - 📧 Technical Support: codebuddy@tencent.com
-- 📚 [Complete Documentation](../README.md)
+- 📚 [Complete Documentation](./README.md)
 - 🌐 [Official Website](https://copilot.tencent.com/cli)
 
 ---

package/cli/dist/web-ui/docs/en/cli/release-notes/README.md

@@ -9,7 +9,7 @@ Release Notes document user-visible changes in each version, including:
 - Improvements
 - Bug Fixes
 
-Difference from [CHANGELOG.md](../../CHANGELOG.md):
+Difference from CHANGELOG.md:
 - **Release Notes**: User-facing, emphasizing feature value and user experience
 - **CHANGELOG**: Developer-facing, recording technical details and code changes
 
@@ -17,6 +17,11 @@ Difference from [CHANGELOG.md](../../CHANGELOG.md):
 
 <!-- New versions are automatically added here -->
 
+- [v2.79.0](./v2.79.0.md) - 2026-04-07
+- [v2.78.1](./v2.78.1.md) - 2026-04-05
+- [v2.78.0](./v2.78.0.md) - 2026-04-05
+- [v2.77.1](./v2.77.1.md) - 2026-04-04
+- [v2.77.0](./v2.77.0.md) - 2026-04-03
 - [v2.76.0](./v2.76.0.md) - 2026-04-03
 - [v2.75.0](./v2.75.0.md) - 2026-04-03
 - [v2.74.0](./v2.74.0.md) - 2026-04-03