@tencent-ai/codebuddy-code 2.116.0 → 2.117.0

package/dist/web-ui/docs/cn/cli/release-notes/v2.115.0.md

@@ -0,0 +1,37 @@
+# 🚀 CodeBuddy Code v2.115.0 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.115.0 |
+| Agent SDK JS | v0.3.199 |
+| Agent SDK Python | v0.3.198 |
+
+## ✨ 新功能
+
+### 自定义模型使用统计
+
+新增自定义模型调用数据上报能力，帮助用户了解自带模型的使用情况与占比。仅在使用自定义模型时上报，涵盖模型信息、token 用量、耗时、IDE 与产品形态、企业标识等维度，为模型选型和成本分析提供数据支撑。
+
+## 🔧 改进优化
+
+- **ACP 文件引用优化**：支持客户端声明 `fileReferencesPathOnly` 能力，Agent 侧据此跳过 @path 文件内容的自动展开，模型按需通过 Read 工具读取，显著降低 token 开销
+- **`@file` 引用超长内容处理**：当引用文件或目录过大时，CLI 会限制内联内容大小并提供继续读取提示，减少超长上下文导致的失败
+- **工具输出截断统一**：统一使用基于视觉行数的截断逻辑，移除冗余的字符数截断，提升终端渲染一致性
+- **工具结果截断**：工具结果预览新增字符数截断机制，当单行内容过长时也能正确截断显示，避免输出过长影响阅读
+
+## 🐛 问题修复
+
+- **流式输出取消态收口**：修复压缩期间用户取消后结果事件被误判为重试而被抑制的问题，避免非交互输出和渲染流程一直等待结束信号
+- **ACP 任务取消卡住**：修复 WorkBuddy 助理任务取消后可能长时间停留在等待响应、后续消息无法继续流式返回的问题
+- **WorkBuddy 消息归组**：修复同一轮回复中模型多次生成导致流式正文、深度思考和工具调用被拆成多条消息的问题，确保回复按用户轮次稳定归组
+- **终端标题同步**：修复会话重命名或切换后，终端标签栏标题未及时更新的问题
+- **运行中图片消息消费**：修复 agent 运行时发送的图片消息在工具调用之间未被消费的问题（此前含图片的消息会被静默丢弃）；同时修复 Tab 入队的图片消息在被拉回输入框编辑后重新发送时图片丢失的问题
+- **`codebuddy update` 安装方式识别**：修复在无法识别安装方式时谎称"已是最新"的问题，现在会向发布渠道查询真实最新版本并给出手动升级命令；同时改进安装方式识别，当命令行探测失败时按安装路径兜底推断
+- **代理环境下登录直连超时**：修复在设置了代理环境变量的机器上（如腾讯 IDE 远程终端），登录 / token 刷新等请求仍然直连目标域名导致 `ETIMEDOUT` 超时的问题
+- **移除 ACP 调试日志**：移除 ACP `initialize` 处理逻辑中残留的排查日志，该日志直接写 stdout 会打断交互式终端的渲染界面
+- **积分统计聚合**：按 rootRequestId 聚合展示积分消耗
+- **子助理模型继承**：修复子助理、技能和命令在配置不可用模型时未正确继承主对话当前模型的问题，避免请求落到错误模型或后端不识别的模型
+- **终端换行**：修复 Web UI 终端中 Shift+Enter 组合键偶发多余回车的问题
+- **面板路由**：工具审批和用户问答面板注册到自管理路由，修复导航异常

package/dist/web-ui/docs/cn/cli/release-notes/v2.116.0.md

@@ -0,0 +1,39 @@
+# 🚀 CodeBuddy Code v2.116.0 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.116.0 |
+| Agent SDK JS | v0.3.200 |
+| Agent SDK Python | v0.3.199 |
+
+## ✨ 新功能
+
+### Web IDE 终端搜索
+
+终端面板支持 Cmd/Ctrl+F 唤起搜索栏，可实时高亮匹配结果，支持区分大小写、全词匹配、正则匹配，并可上下导航跳转，快速定位终端历史输出。
+
+### Web IDE 终端渲染增强
+
+终端启用 GPU 加速渲染（失败时自动静默降级），支持内联图片显示、OSC 52 剪贴板协议，并正确处理 CJK 字符宽度，显示效果更完整、更流畅。
+
+### 终端标题动态指示
+
+终端窗口标题在任务运行时显示动态加载指示，空闲时恢复静态标记，一眼即可判断终端是否有任务在跑。
+
+## 🔧 改进优化
+
+- **文件树回到工作目录**：当浏览目录偏离工作目录时，文件树提供「回到工作目录」快捷入口；加载失败时自动回退到工作目录，减少迷路
+- **标签栏自动滚动**：编辑器标签页和终端标签栏在激活项变化时自动滚动使其可见，无需手动拖动
+- **源代码管理实时更新**：SCM 状态监听提升到应用级，始终在后台监听变更，确保 Git 状态实时刷新
+- **计时性能优化**：后台任务耗时、目标计时、加载秒数等高频计时逻辑改为按需启动并隔离重渲染，减少空闲状态下的无效刷新
+- **模型请求重试可见性**：连接级失败（如 ECONNRESET）的自动重试现在会在 trace 中可见，便于排查网络抖动导致的问题
+
+## 🐛 问题修复
+
+- **ACP slash 命令补全为空**：修复接入 Zed 等严格 ACP 客户端时，新建会话后 slash 命令补全为空的问题，现在命令列表能正常出现
+- **Windows 中文输入法输入乱序**：修复用中文输入法按空格提交词组后紧跟输入标点时，标点有概率跑到词组前面的问题（如「中文。」变成「。中文」），保证快速连续输入按序落入输入框
+- **Windows Git Bash 探测失效**：当配置的 Git Bash 路径失效且上游已托管 shell 时，不再中断对话，而是自动降级到可用的 Git Bash / PowerShell，避免会话持续报错
+- **预热进程项目级 MCP 加载不出来**：修复预热进程切换到工作区后，项目级 `.mcp.json` 因落盘时机较晚而无法被加载、其中的 MCP 工具始终不可用的问题
+- **长跑会话内存溢出（OOM）**：修复主会话反复调用子助理时进程内存无界增长、最终因内存耗尽崩溃的问题；子助理完成后会及时释放其占用的内存引用（仍保留会话恢复能力）

package/dist/web-ui/docs/cn/cli/skills.md

@@ -138,7 +138,7 @@ description: 项目状态分析
 ### 支持的特性
 
 - **`$ARGUMENTS` 参数替换**：在 Shell 命令执行前，`$ARGUMENTS` 会被替换为用户传入的参数
-- **`@file` 文件引用**：Shell 命令执行后，`@file` 引用会被处理并注入文件内容
+- **`@file` 文件引用**：Shell 命令执行后，`@file` 引用会按大小和 token 上限处理；小文件直接注入，较长内容会截断并附继续读取提示，超大文件保留原始引用
 - **错误隔离**：单个命令执行失败不会影响其他命令，失败的命令会被替换为空字符串
 
 > 💡 **处理管道**：`$ARGUMENTS` 替换 → `!`command`` 执行 → `@file` 引用处理，与斜杠命令的处理顺序一致。

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

@@ -19,6 +19,8 @@
 | `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 daemon install`            | Register as a system service (auto-start on login) | `codebuddy daemon install --port 8080`       |
+| `codebuddy daemon uninstall`          | Remove system service registration              | `codebuddy daemon uninstall`                     |
 | `codebuddy auto-mode defaults`        | Print the built-in classification rules for `auto` mode | `codebuddy auto-mode defaults`             |
 | `codebuddy auto-mode config`          | Print the currently active `auto` mode configuration | `codebuddy auto-mode config`                |
 | `codebuddy auto-mode critique`        | Use a lite model to critique your custom `auto` rules | `codebuddy auto-mode critique`              |

package/dist/web-ui/docs/en/cli/common-workflows.md

@@ -394,7 +394,7 @@ Use @ to quickly include files or directories without waiting for CodeBuddy to r
    > Explain the logic in @src/utils/auth.js
    ```
 
-   This includes the full content of the file in the conversation.
+   By default, the file content is included in the conversation; if the file is too large, the original `@file` is retained for subsequent reading with Read or Grep; if the content is too long, only the first section may be included with a prompt to continue reading.
 
 2. **Reference a directory**
    ```
@@ -414,7 +414,7 @@ Use @ to quickly include files or directories without waiting for CodeBuddy to r
 
 - File paths can be relative or absolute
 - @ file references add the CODEBUDDY.md from the file's directory and parent directory to the context
-- Directory references show file listings, not content
+- Directory references show file listings, not content; excessively large directories will collapse remaining unshown entries
 - You can reference multiple files in a single message (e.g., "@file1.js and @file2.js")
 
 ---

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

@@ -169,6 +169,76 @@ Process liveness is detected via `kill -0`. Manually added remote Workers are de
 | `CODEBUDDY_SESSION_LOG` | Background session log path |
 | `CODEBUDDY_GATEWAY_AUTH` | Authentication mode (none / password) |
 
+## System Service Registration
+
+Register the daemon as an OS-level service for **automatic startup on login** and **automatic crash recovery**.
+
+### Install / Uninstall
+
+```bash
+# Register as a system service and start the daemon immediately
+codebuddy daemon install
+
+# Specify port and permission mode
+codebuddy daemon install --port 8080 --permission-mode bypassPermissions
+
+# Remove system service registration
+codebuddy daemon uninstall
+```
+
+After installation, `codebuddy daemon status` will show the system service status:
+
+```json
+{
+  "status": "running",
+  "pid": 42567,
+  "endpoint": "http://127.0.0.1:9527",
+  "systemService": {
+    "installed": true,
+    "backend": "launchd",
+    "configPath": "/Users/xxx/Library/LaunchAgents/com.codebuddy.daemon.plist"
+  }
+}
+```
+
+### Platform Support
+
+| Platform | Backend | Service Type | Config Path |
+|----------|---------|--------------|-------------|
+| macOS | launchd | Launch Agent (user-level) | `~/Library/LaunchAgents/com.codebuddy.daemon.plist` |
+| Linux | systemd | User Unit | `~/.config/systemd/user/codebuddy-daemon.service` |
+| Windows | Task Scheduler | Scheduled Task (user-level) | `schtasks /tn "CodeBuddy Daemon"` |
+
+All platforms use **user-level services**, requiring no administrator privileges.
+
+### Auto-Update
+
+The system service + auto-update form a complete zero-intervention operations chain:
+
+1. **System login** → System service automatically starts the daemon
+2. **Hourly** → Background checks for new versions and silently installs them
+3. **When idle** → Forks a new daemon process → Old process exits normally (does not trigger crash restart)
+4. **On crash** → System service automatically recovers (`KeepAlive` / `Restart=on-failure`)
+
+> **Design details**: The system service is configured to restart only on abnormal exit. Auto-update's graceful restart exits with code 0, which does not trigger the system service's restart mechanism—the new process has already been forked by the update process itself.
+
+### Management Command Reference
+
+```bash
+# macOS native management
+launchctl list | grep codebuddy
+launchctl stop com.codebuddy.daemon
+launchctl start com.codebuddy.daemon
+
+# Linux native management
+systemctl --user status codebuddy-daemon
+systemctl --user stop codebuddy-daemon
+systemctl --user start codebuddy-daemon
+
+# Windows native management
+schtasks /query /tn "CodeBuddy Daemon"
+```
+
 ## Use Cases
 
 ### Persistent Development Server

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

@@ -17,6 +17,8 @@ Difference from CHANGELOG.md:
 
 <!-- New versions are automatically added here -->
 
+- [v2.116.0](./v2.116.0.md) - 2026-07-03
+- [v2.115.0](./v2.115.0.md) - 2026-07-02
 - [v2.114.3](./v2.114.3.md) - 2026-07-02
 - [v2.114.2](./v2.114.2.md) - 2026-07-01
 - [v2.114.1](./v2.114.1.md) - 2026-06-30

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

@@ -0,0 +1,37 @@
+# 🚀 CodeBuddy Code v2.115.0 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|-----------|---------|
+| CodeBuddy Code CLI | v2.115.0 |
+| Agent SDK JS | v0.3.199 |
+| Agent SDK Python | v0.3.198 |
+
+## ✨ New Features
+
+### Custom Model Usage Statistics
+
+Added custom model invocation data reporting capability to help users understand the usage and proportion of their custom models. Reporting only occurs when using custom models, covering dimensions such as model information, token usage, duration, IDE and product form, and enterprise identifier, providing data support for model selection and cost analysis.
+
+## 🔧 Improvements
+
+- **ACP File Reference Optimization**: Supports the client declaring the `fileReferencesPathOnly` capability, allowing the Agent to skip auto-expanding @path file contents. The model reads them on demand via the Read tool, significantly reducing token overhead
+- **`@file` Oversized Content Handling**: When a referenced file or directory is too large, the CLI limits the inline content size and provides a prompt to continue reading, reducing failures caused by overly long contexts
+- **Unified Tool Output Truncation**: Unified the truncation logic to use visual line count, removing redundant character count truncation, improving terminal rendering consistency
+- **Tool Result Truncation**: Added a character count truncation mechanism to tool result previews, ensuring correct truncation even when a single line is too long, preventing excessively long output from affecting readability
+
+## 🐛 Bug Fixes
+
+- **Streaming Output Cancellation Handling**: Fixed an issue where the result event was misidentified as a retry and suppressed after the user cancelled during compression, preventing non-interactive output and rendering flows from waiting indefinitely for an end signal
+- **ACP Task Cancellation Stuck**: Fixed an issue where a WorkBuddy assistant task could remain stuck waiting for a response after cancellation, preventing subsequent messages from streaming back
+- **WorkBuddy Message Grouping**: Fixed an issue where multiple model generations within the same response round caused streaming body text, deep thinking, and tool calls to be split into multiple messages, ensuring replies are stably grouped by user turn
+- **Terminal Title Sync**: Fixed an issue where the terminal tab title was not updated promptly after renaming or switching sessions
+- **In-Flight Image Message Consumption**: Fixed an issue where image messages sent during agent execution were not consumed between tool calls (previously, messages containing images were silently dropped); also fixed an issue where Tab-queued image messages lost their images when pulled back to the input box for editing and re-sent
+- **`codebuddy update` Installation Method Detection**: Fixed an issue where it falsely claimed "already up to date" when the installation method could not be identified. It now queries the release channel for the actual latest version and provides a manual upgrade command; also improved installation method detection by falling back to inferring from the installation path when command-line probing fails
+- **Login Direct Connection Timeout in Proxy Environment**: Fixed an issue where login/token refresh requests still connected directly to the target domain on machines with proxy environment variables set (e.g., Tencent IDE remote terminal), causing `ETIMEDOUT` timeouts
+- **Removed ACP Debug Logs**: Removed residual debugging logs from the ACP `initialize` handling logic, which wrote directly to stdout and disrupted the interactive terminal rendering UI
+- **Points Statistics Aggregation**: Points consumption is now aggregated and displayed by rootRequestId
+- **Sub-agent Model Inheritance**: Fixed an issue where sub-agents, skills, and commands did not correctly inherit the main conversation's current model when configured with an unavailable model, preventing requests from falling onto incorrect or backend-unrecognized models
+- **Terminal Line Break**: Fixed an issue where the Shift+Enter key combination occasionally produced an extra carriage return in the Web UI terminal
+- **Panel Routing**: Tool approval and user Q&A panels are now registered to the self-managed router, fixing navigation anomalies

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

@@ -0,0 +1,39 @@
+# 🚀 CodeBuddy Code v2.116.0 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|-----------|---------|
+| CodeBuddy Code CLI | v2.116.0 |
+| Agent SDK JS | v0.3.200 |
+| Agent SDK Python | v0.3.199 |
+
+## ✨ New Features
+
+### Web IDE Terminal Search
+
+The terminal panel supports Cmd/Ctrl+F to invoke the search bar, with real-time highlighting of matching results. It supports case-sensitive, whole word, and regex matching, with up/down navigation to quickly locate terminal history output.
+
+### Web IDE Terminal Rendering Enhancement
+
+The terminal now uses GPU-accelerated rendering (with automatic silent fallback on failure), supports inline image display, OSC 52 clipboard protocol, and correctly handles CJK character widths, resulting in a more complete and smoother display.
+
+### Terminal Title Dynamic Indicator
+
+The terminal window title shows a dynamic loading indicator while a task is running, and restores to a static indicator when idle, allowing you to tell at a glance whether the terminal has a running task.
+
+## 🔧 Improvements
+
+- **File Tree Return to Working Directory**: When the browsed directory drifts away from the working directory, the file tree provides a "Return to Working Directory" shortcut; on load failure, it automatically falls back to the working directory, reducing disorientation
+- **Tab Bar Auto-scroll**: Editor tabs and terminal tab bars automatically scroll to keep the active item visible when it changes, without manual dragging
+- **Source Control Real-time Update**: SCM status monitoring is elevated to the application level, always listening for changes in the background, ensuring Git status is refreshed in real time
+- **Timing Performance Optimization**: High-frequency timing logic such as background task duration, target timing, and loading seconds is now started on demand with isolated re-rendering, reducing unnecessary refreshes during idle states
+- **Model Request Retry Visibility**: Automatic retries for connection-level failures (e.g., ECONNRESET) are now visible in the trace, making it easier to troubleshoot issues caused by network jitter
+
+## 🐛 Bug Fixes
+
+- **ACP Slash Command Completion Empty**: Fixed an issue where slash command completion was empty after creating a new session when connecting to strict ACP clients such as Zed. The command list now appears correctly
+- **Windows Chinese IME Input Ordering**: Fixed an issue where, after committing a phrase with the space bar using a Chinese input method and immediately typing punctuation, the punctuation had a chance to appear before the phrase (e.g., "中文。" became "。中文"), ensuring that rapid continuous input is placed in the input box in the correct order
+- **Windows Git Bash Detection Failure**: When the configured Git Bash path becomes invalid and the upstream has already taken over the shell, the conversation is no longer interrupted; instead, it automatically falls back to an available Git Bash / PowerShell, avoiding persistent session errors
+- **Pre-warmed Process Project-level MCP Loading Failure**: Fixed an issue where, after the pre-warmed process switched to a workspace, the project-level `.mcp.json` could not be loaded due to late disk write timing, leaving the MCP tools within it perpetually unavailable
+- **Long-running Session Out of Memory (OOM)**: Fixed an issue where the main session's process memory grew unboundedly when repeatedly invoking sub-agents, eventually crashing due to memory exhaustion; after sub-agents complete, their memory references are released in a timely manner (session recovery capability is retained)

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

@@ -138,7 +138,7 @@ Please analyze the current project status based on the above information.
 ### Supported Features
 
 - **`$ARGUMENTS` parameter substitution**: Before Shell command execution, `$ARGUMENTS` is replaced with the arguments passed by the user
-- **`@file` file references**: After Shell command execution, `@file` references are processed and file content is injected
+- **`@file` file references**: After Shell command execution, `@file` references are processed based on size and token limits; small files are injected directly, longer content is truncated with a continuation read prompt, and oversized files retain their original reference
 - **Error isolation**: A single command failure does not affect other commands; failed commands are replaced with empty strings
 
 > 💡 **Processing pipeline**: `$ARGUMENTS` substitution → `` !`command` `` execution → `@file` reference processing, consistent with the processing order of Slash Commands.