下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

更新内容

新功能

• Web：新增聊天消息导航，便于在对话中快速跳转定位。
• activity-recorder：Chrome 历史 MCP 可配置工作目录。
• 插件：启动规范支持解析并应用当前工作目录（cwd）。

修复

• Web：历史消息里助手操作条悬停不再被 content-visibility 绘制裁剪，同时保持原有对齐偏移。
• CI：digest 产物命名改为双短横线分隔，避免 console 与 console-lite 的 digest 名称前缀误匹配、合并时拉错 digest。
• Telegram：typing 指示仅作用于可见文本，避免对隐藏内容误触发。

构建与 CI

• 发布流水线：镜像构建弃用 QEMU，改用原生 arm64 runner；拆分为多路并行构建与合并任务；Docker 层缓存按镜像与架构单独作用域，降低互相挤占。
• 桌面发布流水线：为 Go 模块、pnpm store、Electron 二进制增加缓存，并调整步骤顺序以保证缓存正确命中，预期缩短整体构建时间。

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

更新内容

新功能

• Web 增加对话分支图，用于查看会话分支结构。
• Worker 增加群组讨论的「发言」模式（Discuss speak）。
• Activity 增加活动录制器插件，并新增录制器构建器（builder）流程与配套 Persona。
• 工具侧新增 X（原 Twitter）搜索 Provider；数据库新增工具 Provider OAuth 等迁移（含 00201_tool_provider_oauth 等）。

修复

• Web：稳定对话分支图与聊天滚动「钉住」行为；恢复 Artifact 文档卡片展示；优化 X 搜索时间线；修正 Activity 构建器触发路径（改为直接触发 builder）。
• Telegram：在讨论（discuss）场景下对「正在输入」提示做门控，避免不当触发。
• Desktop：修复最大化窗口状态无法正确恢复的问题。
• 工具：修复 X 搜索 OAuth token 需要刷新/续期的问题。

改进

• Web：COP 时间线工具标记连续调整后，未知工具统一为小实心点呈现，减少与图标混用带来的不一致；并对 notebook/memory 等工具的标记映射做了细化。

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

更新内容

修复

• 修复桌面端应用更新安装与相关界面：更新弹层点击命中异常、设置内更新页导航异常，以及按钮对齐问题。
• 修复在隐藏到托盘场景下 quitAndInstall 被拦截，导致无法正常完成安装并退出的问题。

改进

• 增加可选的开发环境更新界面预览能力，便于调试更新 UI，且默认不会在常规 pnpm dev 中自动启用。

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

更新内容

新功能

• Web：导出主题外观（theme appearance）

修复

• Web：保留终端运行缓存
• Web：加固主题数据导入与背景表面样式，并恢复主题表面显示
• Web：新增 QQ 机器人名称设置；补充名称清理相关测试覆盖
• Web：调整人设选择器测试以与实际行为一致

改进

• Web：稳定文档预览加载相关测试

构建与 CI

• 为发布构建拆分 tsconfig.build.json，生产 TSC 构建排除测试代码，Vitest 类型检查单独进行
• Console：移除 ProvidersPage 未使用的 Badge 导入

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

更新内容

修复

• 修复 CLI 无头（headless）模式下的资源打包问题。
• 记忆能力默认关闭自动回忆（automatic recall）；若依赖该行为需自行调整配置或工作流。

文档

• 补充并澄清桌面端无头安装说明。

构建与 CI

• Release 流水线支持每日构建发布。

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

更新内容

新功能

• 桌面端内置安装 ark CLI。
• Worker 新增 compact 上下文压缩工具。
• Web 增加快捷键提示；支持 Cmd/Ctrl+, 切换设置面板。
• 对话模型归属统一到线程：feat(models) 迁移并运行时解析；前端移除各渠道「默认模型」，改为账户级「默认对话模型」，保存时清理遗留 default_model。
• 群组心跳触发按线程维度对齐（历史数据回填 thread_id，调度读取与 burst 冷却按线程）。
• IM 渠道统一斜杠指令分发：多通道共用 /help、/bind、/status、/models、/persona、/reset、/start 等；补齐 Discord/Feishu/微信/QQBot 等对 /model、/think、/heartbeat、/stop 的支持；全角 ／ 按 / 归一。
• 发送用户消息乐观更新 + client_message_id 幂等创建与投递状态。
• 默认网页搜索改为 Exa；接入 Exa Hosted MCP 与 provider 契约。
• MCP OAuth 授权流程。
• 插件：桌面插件管理、详情设置、贡献体系；支持 CUA 运行时检查。
• LLM：StreamLlmRequest 载荷扩展；默认重试次数提高并引入抖动退避。
• Web COP：运行结束后折叠中间步骤（Worked 区块）；编辑/写入 diff 计数聚合与着色标题；将 exec_command 并入 COP 卡片式子段；强化 Plan Mode 与 Skills 列表/卡片/详情。
• 右侧预览：统一预览、浏览器预览、多文件预览 Tab、状态持久化。
• Persona 目录菜单支持动态定位与滚动。
• 聊天输入斜杠命令。
• Runs 展示缓存 token 用量指标。

修复

• Worker：图片提示载荷边界、无效图片拒绝、附件读取与工具结果加固；pending 图像批次/结果在多轮修正中保持一致；compact 压力与上下文压缩链路稳定性；上下文窗口预检；桌面 compact 文件锁与大 atom 阻塞；读取图像 runtime/schema/投递门禁对齐。
• IM/Telegram：媒体组群聊身份与 heartbeat/status 等命令解析对齐 stage A；burst 投递补齐 ChannelID/ChannelType；/persona 群组需管理员且已绑定；/stop 传递请求用户 ID；/status 无线程时展示默认值；列表与键盘展示规范 credential^model；统一分发后恢复 pg_notify 取消、BYOK 与 /stop 回复文案。
• QQ：群聊补全 /model、/think 分支。
• 心跳：setModel 同步 resolve_model_at_runtime；persona fallback SQL 去掉错误 deleted_at 条件；down migration 清理线程配置中的 heartbeat 字段并重置触发模型。
• 模型迁移：PostgreSQL/SQLite 合并冲突与 backfill；QQBot 线程创建后补齐 inbound chat model；新线程模型解析保留渠道过渡期 fallback。
• Web：Virtuoso 长列表滚动直达末尾，避免中途挂载风暴；滚动 pin/spacer 逻辑简化后的交互与测试对齐；快捷键路由、tooltip 动画、键帽布局修复。
• Web：Impression 重建超时后改为轮询直至完成；模型下拉使用 fitContent 完整展示长标签；provider 摘要卡与 HeadersEditor 对齐；portal/provider/tool model 错误提示；MCP 设置多轮 UI 与 Tab 持久挂载；桌面端防护误触 impression 重建。
• Web：timeline 语义、本地化与 COP 卡片滚动/高度；插件详情与 provider 布局对齐；diff 计数写入 FileOpRef 并在标题/卡片展示；修复图片 artifact 误开侧栏；若干欢迎页、侧边栏动画、预览 dotfiles、桌面会话刷新等问题。
• Personas：印象生成要求事实性约束。
• 插件：运行时权限目标展示；安装进度状态保留；允许运行时安装完整结束。
• LLM：在不支持的工具选择模式下自动降级重试。
• 认证：桌面本地模式下使用本地会话端点刷新 token。
• 其他：.gitignore 忽略 .codegraph；桌面 about 元数据清理；移除误导性 heartbeat 文案。

注：fix(search): keep provider on missing key 已被后续 revert，未记入有效变更。

改进

• Channels：抽取 Telegram 命令公共逻辑；IM 入站架构统一；出站投递与分段/reply 工具链合并复用。
• Web：渠道图标改用各平台官方 App Icon；桌面渠道设置布局简化；聊天列表批量更新、requestAnimationFrame 节流与 memo 降低渲染；右侧栏上下文拆分 memo、稳定回调降低切换成本；设置分区缓存减少重复挂载重渲染；线程列表与实时状态上下文拆分；思考计时状态机合并简化。
• Worker：拆分运行空闲超时；桌面 MCP 工具暴露与缓存作用域收紧；降低桌面运行延迟；调试事件存储减量。
• Web（体验/重构）：统一设置卡片 hover；简化桌面 Skills/MCP 与内存、工具设置页排版；右侧面板代码整理（持久化防抖、目录缓存 LRU 等）；COP 巨型函数拆分与符号/常量收敛重构。
• Search：默认提供方为 Exa（与上文新功能呼应时此处侧重「默认策略」行为层面的提升）。

文档

• 以桌面用户为中心重建文档站（中英分区与大量新页面；框架升级为 Next.js 16、Fumadocs 16、Tailwind 4；修正顶部导航与落地页链接）。
• 移除前后端代理工作流程相关文档。
• Developers：补充 LLM 请求载荷事件说明。
• 更新 LLM 重试默认值文档。
• README、安装说明与配置/schema 文档随发行同步更新（依据变更文件列表中的 docs 路径，不展开未在 commit 摘要中明示的细节）。

构建与 CI

• Release：通过 Cursor CLI 自动生成 changelog；桌面构建去除旧版 release 标签元数据。
• CI：修复类型检查与 lint（含测试 setup、defer Body.Close 等）。
• 数据库迁移：解决合并后的版本冲突标记。

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm、Arkloop-linux-x86_64.AppImage 或 arkloop-bin-*.pkg.tar.zst

说明

v26.5.7

供应商与模型

• 新增 LLM Provider / Model 自定义 Headers 支持，可在供应商高级选项和模型选项中配置请求 Headers。
• 自定义 Headers 会应用到模型列表拉取、模型连接测试以及 Worker 实际 LLM 路由请求。
• 重构供应商与模型设置界面，优化 Provider 详情、模型导入、模型选项和本地 Provider 管理体验。
• 增强本地 Provider bridge、OpenViking 路由配置、Anthropic 兼容协议 quirk 和本地模型测试链路。

桌面端与设置

• 重构桌面设置结构，新增独立 About 页面。
• 抽取工具模型设置控件，并在通用设置和路由设置中复用。
• 优化桌面外观、通用偏好、设计 Token、主题预设、字体、语音、更新、连接器和高级设置界面。
• 增强 headless / local web 模式、桌面本地会话、桌面 runtime 和 CLI 启动桌面 Web 的能力。
• 修复 Discord / 飞书连接验证结果显示问题。

渠道与连接器

• 优化 Telegram、Discord、飞书、QQ、QQ Bot、微信等桌面渠道设置面板。
• 修复 channel run 的 owner 归属解析。
• 增强 Telegram 本地桌面接入、channel inbound burst 处理和多渠道配置测试覆盖。
• 改进 MCP HTTP readiness、safe dialer、URL 安全策略和工具目录发现状态。

聊天与 Agent UI

• 新增 Agent UI contract、事件流适配和 agent client 处理链路。
• 优化 Assistant turn 分段、Cop timeline、图片片段、工具错误展示和消息流处理。
• 改进 SSE / run lifecycle / stream dispatch 相关逻辑。
• 优化滚动锚定、用户消息置顶、隐藏 header padding 和侧边栏 pinned thread 行为。
• 支持自定义背景主题并稳定背景层渲染。

工具与搜索

• 优化浏览器搜索标题和摘要提取。
• 调整基础搜索入口和查询参数校验。
• 增强 web fetch / web search 的 URL policy 测试覆盖。
• 修复 localshell 在 Windows 下的输出编码、管道等待和进程输出处理问题。

记忆、Persona 与运行模式

• 新增 impression-builder persona，并深化 impression memory 相关流程。
• 增加 learning mode 数据迁移与运行支持，移除旧 stem tutor persona。
• 更新 normal / work persona prompt。
• 增强桌面记忆、Notebook、scheduled trigger 和 persona resolution 相关测试覆盖。

打包与发布

• 新增 Homebrew 支持。
• 新增 Arch / AUR packaging 配置和发布 workflow。
• 优化桌面构建 workflow、AUR 更新、Homebrew formula 更新和 release package 更新逻辑。
• 修复 macOS dev script、Vite URL、Darwin ldflags 和 release metadata 相关问题。

质量与测试

• 恢复 CI lint 和 Web 测试。
• 增加 Provider、Channel、Desktop auth、Local provider、OpenViking、localshell、LLM protocol、routing、MCP、scroll 等多处测试覆盖。

What's Changed

• fix(desktop): parse vite dev url by @kilockok in #30
• fix: cannot unpin a conversation on the Work page by @SkyAerope in #33
• fix(localshell): no output when using exec_command on Windows by @SkyAerope in #34
• build(packaging): add arch linux packages by @mizorewww in #38
• fix(ci): restore lint and web tests by @qqqqqf-q in #40
• refactor(web): rename addApiKey to addModel in model picker by @SkyAerope in #41
• feat(web): add custom background theme by @qqqqqf-q in #39
• feat(llm-providers): support custom request headers by @namphamdev in #28

New Contributors

• @mizorewww made their first contribution in #38
• @namphamdev made their first contribution in #28

Full Changelog: v26.5.1...v26.5.7

Release-hosted media assets used by the documentation site.

下载

• Windows：下载 Arkloop-win-x64.exe
• macOS Apple Silicon：下载 Arkloop-mac-arm64.dmg
• macOS Intel：下载 Arkloop-mac-x64.dmg
• Linux x64：下载 Arkloop-linux-amd64.deb、Arkloop-linux-x86_64.rpm 或 Arkloop-linux-x86_64.AppImage

说明

🚀 Highlights

Web Search

• Added a basic web search provider with desktop browser support for more reliable results.

Channel & Heartbeat

• New event-driven inbound burst runner with bus notification for channel processing.
• Improved heartbeat decision phase handling, message processing, and cache management.
• Fixed heartbeat prompt semantics and thread user resolution from channel owner.

LLM

• Dropped unsigned thinking messages while preserving signed ones for cleaner model output.
• Trimmed Anthropic cache_control after messages to avoid API issues.
• Merged response capture into Anthropic API error handling.
• Improved marker message index resolution logic.

Desktop & UI

• Added OpenDyslexic font option for improved accessibility.
• Added Retina Burn theme.
• Inline username editing in settings.
• Reduced idle polling and corrected update entry on desktop.
• Fixed Windows cmd.exe shell command resolution (#27).
• Fixed chat/work state persistence across threads.

Skills & Web Fetch

• Prevented crash on empty external skill load.
• Hardened web_fetch basic fetch reliability.

Other

• Removed legacy ACP bridge from agent.
• Switched domain to arkloop.io.
• Updated developer site, showcase video, and contribution guidelines.

Full Changelog: v26.4.29...v26.5.1

Arkloop v26.4.29

Stable Release — 2025-04-29

Highlights

1. 新渠道支持

• 飞书官方渠道集成 — 完整的飞书 Bot 支持，包括 webhook 验证、消息收发、配置管理
• QQ 官方 Bot 渠道 — 新增 QQ 官方 Bot 集成，支持消息推送和交互

2. GTD 侧边栏重构

• 5 个 Bucket 分类：inbox / waiting / someday / active / archived
• 拖拽支持：项目路径可拖拽到 GTD bucket，bucket 之间可互拖
• 实时运行状态指示器：三点流动动画替代单点脉冲
• 可展开的项目文件夹视图

3. Thread Run State 实时同步

• 新增 SSE 端点 /v1/thread-run-state/events 实时推送运行状态
• Worker 在关键节点发布状态事件（terminal、cancel、create）
• 前端实时展示运行状态，无需刷新

4. Agent 导入功能

• 支持从文件导入现有 Agent
• 新增导入检查清单向导（Onboarding）
• 桌面端支持导入现有 Agents 到工作区

5. Agent Work Directory (AWD)

• Worker 支持 AWD 工作目录
• 自动注入 AWD 文件到运行环境
• 支持工作文件夹选择和同步

6. API Bridge 增强

• 添加授权头支持
• 流式处理优化
• 完整的 CORS 测试覆盖

7. 桌面端改进

• Windows 原生标题栏支持
• 通过 shell 打开外部 HTTP 链接
• Arkloop 应用桥接协议

8. 其他改进

• Telegram: InlineKeyboard 按钮交互（/think, /model）、dismiss 按钮、模型筛选
• UI: Appearance 设置预览重绘、用户消息入场动画优化、时区处理修复
• 性能: 流式渲染隔离、Run 启动延迟优化、聊天滚动稳定性
• 测试: Clawbench benchmark runner、API Bridge 单元测试、Cop Timeline 测试

Breaking Changes

None.

Deprecations

• 计划模式相关 UI 已移除（ChatInput、PersonaModelBar、AdvancedSettings）
• 模块设置功能从 AdvancedSettings 中移除

Contributors

Thanks to all contributors who made this release possible.

Upgrade Notes

1. 数据库无需额外迁移
2. 重新构建前端：pnpm install && pnpm build
3. 重启后端服务即可

Full Changelog: v26.4.28...v26.4.29