亮点
- 任务聊天线程 — Replaced the classic comment timeline with a full chat-style thread powered by assistant-ui. Agent run transcripts, chain-of-thought, and user messages now render inline as a continuous conversation with polished avatars, action bars, and relative timestamps. (#3079)
- 执行策略 — Issues can now carry a review/approval execution policy with multi-stage signoff workflows. Reviewers and approvers are selected per-stage, and Agorid routes the issue through each stage automatically. (#3222)
- Blocker dependencies — First-class issue blocker relations with automatic wake-on-dependency-resolved. Set
blockedByIssueIdson any issue and Agorid wakes the assignee when all blockers reach完成. (#2797) - Issue 间导航 — Faster navigation between issues with scroll reset, prefetch, and detail-view optimizations. (#3542)
- Scoped 唤醒自动 checkout — The agent harness now automatically checks out the scoped issue on comment-driven wakes, reducing latency for agent heartbeats. (#3538)
- 收件箱父子嵌套 — Parent issues group their children in the inbox Mine view with a toggle button,
j/kkeyboard traversal across nested items, and collapsible groups. (#2218, @HenkDz)
改进
- BETA 独立 MCP server — New
@paperclipai/mcp-serverpackage exposing the Agorid API as an MCP tool server, including approval creation. (#2435) - Board approvals — Generic issue-linked board approvals with card styling and visibility improvements in the issue detail sidebar. (#3220)
- 选择器新增 Claude 模型 — Issues can now be grouped by workspace in the inbox with collapsible mobile groups and shared column controls across inbox and issues lists. (#3356)
- 插件系统改进 — Third-party adapters can now be installed as npm packages or loaded from local directories. Plugins declare a config schema and an optional UI transcript parser; built-in adapters can be overridden by external ones. Includes Hermes local session management and provider/model display in run details. (#2649, #2650, #2651, #2654, #2655, #2659, @plind-dm)
- 收件箱行内子代 live 状态 — Trigram-indexed full-text search across titles, identifiers, descriptions, and comments with debounced input. Comment matches now surface in search results. (#2999)
- 任务状态图标与颜色 — Sub-issues moved from a separate tab to inline display on the issue detail, with parent-inherited workspace defaults and assignee propagation. (#3355)
- 文档 revision diff 查看器 — Side-by-side diff viewer for issue document revisions with improved modal layout. (#2792)
- Codex 与模型更新 — Press
?to open a keyboard shortcut reference dialog; newg i(go to inbox),g c(comment composer), and inbox archive undo shortcuts. (#2772) - Bedrock 模型选择 — Claude local adapter now supports AWS Bedrock authentication and model selection. (#3033, @kimnamu)
- Codex 快速模式 — Added fast mode support for the Codex local adapter. (#3383)
- 备份改进 — Gzip-compressed backups with tiered daily/weekly/monthly retention and UI controls in Instance Settings. (#3015, @aronprins)
- GitHub webhook 签名模式 — Added
github_hmacandnonewebhook signing modes with timing-safe HMAC comparison. (#1961, @antonio-mello-ai) - 项目环境变量 — —项目可定义环境变量,并由工作区运行继承。
- Routine 改进 — Draft routine defaults, run-time overrides, routine title variables, and relaxed project/agent requirements for routines. (#3220)
- Issue 编辑器与文档打磨 — Start/stop controls, runtime state reconciliation, runtime service JSON textarea improvements, and workspace branch/folder display in the issue properties sidebar. (#3354)
- Attachment improvements — Arbitrary file attachments (not just images), drag-and-drop non-image files onto markdown editor, and square-cropped image gallery grid. (#2749)
- 聊天图片画廊 — —点击聊天消息中的图片打开完整画廊查看器。
- 去重 pipeline 自动化健康警告 — pipeline 自动化健康警告去重,同一 issue 不会多次上报。(#9090、@cryppadotta)
- 侧栏顺序持久化 — —侧栏项目与公司排序偏好按用户持久化。
- 技能自动启用 — —提及的技能在 heartbeat 运行中自动启用。
- Comment wake 批处理 — 多条 comment wake 批成单一 inline payload,使 agent heartbeat 更高效。
- 服务端 adapter pause/resume — Builtin adapter types can now be paused/resumed from the server with
overridePaused. (#2542, @plind-dm) - 技能斜杠命令自动补全 — —编辑器中技能名自动补全。
- Worktree reseed 命令 — New CLI command to reseed worktrees from latest repo state. (#3353)
修复
- 议题详情稳定性 — Fixed visible refreshes during agent updates, comment post resets, ref update loops, split regressions, main-pane focus on navigation, and other detail-view rerender issues. (#3355)
- 收件箱角标 — Badge now correctly counts only unread Mine issues. (#2512, @AllenHyang)
- 收件箱键盘导航 — Fixed
j/ktraversal across groups and nesting column alignment. (#2218, @HenkDz) - Vite HTML 转换 — —修复 dev 模式重复 Vite HTML 转换。
- Auth 会话查询 — —非 API 请求跳过不必要的 auth 会话查询。
- Stale execution lock — Fixed stale execution lock lifecycle with proper
executionAgentNameKeyclearing. (#2643, @chrisschwer) - 智能体 env 绑定 — Fixed cleared agent env bindings not persisting on save. (#3232, @officialasishkumar)
- Capabilities 字段 — Fixed blank screen when clearing the Capabilities field. (#2442, @sparkeros)
- 删除技能 — Company skills can now be deleted with an agent usage check. (#2441, @DanielSousa)
- 键盘快捷键 cheatsheet — Fixed
--append-system-prompt-filebeing sent on resumed Claude sessions, preserved instructions on resume fallback, and tightened fresh-session-only instruction file handling. (#2949, #2936, #2937, @Lempkey) - 输入卡顿 — Fixed typing lag in long comment threads. (#3163)
- 评论编辑器同步 — —加固任务评论编辑器同步。
- 文档修订 freshness — The latest issue document revision now stays current in the UI. (#3342)
- 无限渲染循环 — —修复收件箱移动工具栏无限渲染循环。
- Shimmer 动画 — Fixed shimmer text using an invalid
hsl()wrapper onoklchcolors, reduced loop jitter, and added a pause between repeats. - 提及选择 — —恢复触控提及选择并修复带空格提及查询。
- 收件箱归档 — —修复淡出后归档项闪回。
- 目标描述 — Made the goal description area scrollable in the create dialog. (#2148, @shoaib050326)
- Worktree provisioning — Fixed symlink relinking, fallback seeding, dependency hydration, and validated linked worktrees before reuse. (#3354)
- Node keepAliveTimeout — —反向代理后增大超时,避免 502。
- 嘈杂请求日志 — —减少服务端请求日志噪音。
- Codex tool-use 转录 — —修复 Codex tool-use 转录完成解析。
- Codex resume 错误 — —将 missing-rollout Codex resume 错误识别为过期会话。
- Pi 配额耗尽 — Treat Pi quota exhaustion as a failed run. (#2305)
- 任务标识冲突 — —防止并发创建任务时的标识冲突。
- OpenClaw CEO 路径 — Fixed
$AGENT_HOMEreferences in CEO onboarding instructions to use relative paths. (#3299, @aronprins) - Windows 适配器包装 — Use
cmd.exefor.cmdand.batwrappers on Windows. (#2662, @wbelt) - Markdown 自动格式化 — Fixed autoformat of pasted markdown in the inline editor. (#2733, @davison)
- Paused agent 变暗 — Correctly dim paused agents in list and org chart views while skipping dimming on the Paused filter tab. (#2397, @HearthCore)
- 导入角色回退 — Import now reads agent role from frontmatter before defaulting to
智能体. (#2594, @plind-dm) - 备份清理 — Clean up orphaned
.sqlfiles on compression failure and fix stale startup logs. - Chat 布局对齐 — 修复 avatar 定位、activity 行对齐、comment 对齐与 feedback 面板关闭。
安全
- 授权加固 (GHSA-68qg-g8mg-6pr7) — Scoped import, approval, activity, and heartbeat API routes to enforce proper authorization checks. All deployments should upgrade. (#3315)
- JWT 密钥处理 — Removed the hardcoded JWT secret fallback and fixed agent auth to fall back to
BETTER_AUTH_SECRETwhenPAPERCLIP_AGENT_JWT_SECRETis absent. (#3124, #2866, @cleanunicorn, @ergonaworks) - 日志中 redact Bearer token — —服务端日志现脱敏 Bearer 令牌,避免凭证泄露。 (#2659)
- 依赖安全升级 — Updated
multerto 2.1.1 (HIGH CVEs) androllupto 4.59.0 (path-traversal CVE). (#2819, #2909, @marysomething99-prog)
升级指南
Eight new database migrations (0049–0056) will run automatically on startup. These add:
- Issue blocker relations table (
0049) - Project environment variables (
0050) - Trigram search indexes on issues and comments (
0051— requirespg_trgmextension) - Execution policy decision tracking (
0052) - Non-issue inbox dismissals (
0053) - Relaxed routine constraints (
0054) - Heartbeat run process group tracking (
0055) - User sidebar preferences (
0056)
迁移均为增量——不修改或删除既有数据。
pg_trgm extension: Migration 0051 creates the pg_trgm PostgreSQL extension for full-text search. If your database user does not have CREATE EXTENSION privileges, ask your DBA to run CREATE EXTENSION IF NOT EXISTS pg_trgm; before upgrading.
If you use external adapter plugins, note that built-in adapters can now be overridden by external ones. The overriddenBuiltin flag in the adapter API indicates when this is happening.
This release also includes the fix for GHSA-68qg-g8mg-6pr7. Upgrade all deployments as soon as practical.
贡献者
感谢每一位为本版本贡献的人!
@AllenHyang, @antonio-mello-ai, @aronprins, @chrisschwer, @cleanunicorn, @cryppadotta, @DanielSousa, @davison, @ergonaworks, @HearthCore, @HenkDz, @KhairulA, @kimnamu, @Lempkey, @marysomething99-prog, @mvanhorn, @officialasishkumar, @plind-dm, @shoaib050326, @sparkeros, @wbelt