BoltctlAgent 0.2.7

# BoltctlAgent 0.2.7 0.2.7 是 BoltctlAgent 当前产品形态下的全新桌面发行版。本版本以 Pi Agent 运行时为核心，整合工作区对话、内容创作、Skills、MCP、后台计划任务和对等多 Agent 协作，并提供 Windows、macOS 与 Linux 桌面运行能力。 ## 新功能 ### Agent 与对话 - 全面采用 `@earendil-works/pi-agent-core` 与 `@earendil-works/pi-coding-agent`，支持 Anthropic、OpenAI、Google 等 Provider 协议以及自定义模型端点。 - 在同一条回复中分开展示正文、思考过程、工具调用、工具结果、Token 用量和上下文占用；长任务可随时中断，并可在切换会话后继续独立运行。 - 提供工作区文件读取、写入、编辑和 Bash 工具，支持项目下多会话管理、历史消息持久化、分页加载、消息回滚、删除、复制和重新生成。 - 支持图片、PDF 与普通文件附件，可直接粘贴图片；当当前模型不支持输入媒体时，会给出明确提示或使用可用模型回退策略。 - 新增全局补充系统提示词设置。该内容以追加方式应用，不会覆盖 Agent 运行时的基础安全与工具说明。 - Agent 可通过 AskQuestions 弹窗顺序提出文本、单选或多选问题，收到答案后在原有运行轮次中继续执行。 - 运行时错误统一分类为 Provider、上下文、Skill、工具和流中断错误，并对持久化错误信息进行脱敏处理。 ### 内容中心与 AI 创作 - 新增本地优先的笔记、普通表格和待办内容工具；Agent 可使用稳定内容 ID 创建、读取、更新和归档内容。 - 笔记支持 Markdown 编辑、实时预览、大纲、摘要、参考图、AI 写作预设、修改前后差异对比以及 AI 生图。 - 普通表格支持批量导入、排序、标签管理和行级编辑；待办支持优先级、状态和时间字段，并统一由内容表格管理。 - 内容可按共享分组组织，笔记和表格支持批量导入；分组页签与侧边栏折叠状态会在重启后保留。 - 素材库支持上传、分组、AI 图片生成、对话式背景图生成和多张参考图输入。 - 普通表格可绑定 Google Sheets，并提供同步队列、冲突检测和状态反馈；同时提供飞书授权与应用配置流程。 ### Skills 与 MCP - 支持创建、编辑、安装和运行 Pi Skills。Skills 统一从跨 Agent 共享目录 `~/.agents/skills` 加载，并按需读取正文和引用资源。 - 支持全局 `.mcp.json`、Skill 目录 `.mcp.json` 和项目 `.agent/.mcp.json`，可连接 Streamable HTTP 与本地 stdio MCP 服务。 - MCP 工具发现使用配置指纹缓存、有界并发和生命周期清理，降低重复连接和失效进程残留。 - 桌面 App 运行期间会在本机回环地址提供 MCP 服务，使 Codex 等客户端可以访问内容与计划任务工具；App 退出后服务随即关闭。 ### 自动化与多 Agent 协作 - 新增后台计划任务，可在界面中选择模型、工作区、执行时间和协作模板；桌面窗口关闭到托盘后，调度器仍可继续运行。 - 提供计划任务健康状态、运行记录和异常提醒，并修复默认模型预加载与桌面后台生命周期问题。 - 新增对等多 Agent 协作。每个成员拥有独立会话，可通过共享任务、消息、成果和评审工具协同完成工作。 - 协作支持成员级模型与能力配置、依赖工作流、并行执行、超时、中断、恢复和统一运行记录；同一轮仅允许指定成员写入工作区，减少并发写入冲突。 - 计划任务可绑定不可变的协作模板版本，确保后台执行使用创建任务时确认过的成员和流程配置。 ### 桌面体验与服务集成 - 提供 Windows、macOS 和 Linux 桌面构建；生产版后端为随应用分发的原生单文件，终端用户无需安装 Bun 或 Node.js。 - 新增签名应用更新、持久更新提醒、托盘安装入口、单实例保护、开机启动和关闭到托盘设置。 - 支持 HTTP/HTTPS 代理、系统代理检测、子进程代理继承以及出口 IP 和国家/地区信息展示。 - 集成 Boltctl 账户登录、模型密钥、分组、用量、余额、公告、充值、订阅和 License 激活，并将个人中心统一收纳到设置窗口。 - 设置中可按需下载安装 `boltctl`、`gog` 和 `lark-cli`。相关环境配置、Google 授权和飞书授权入口会在对应工具可用后出现。 - 内置 cc-connect，可在会话界面启动、停止和配置微信接入，完成扫码绑定、模型同步、工作目录选择和异常自恢复。 - Canvas、计划任务、多 Agent 协作和 Skills 导航可在“设置 → 高级功能 → 导航管理”中独立启用；这些高级入口默认隐藏。 - 完善中英文界面、多语言错误与状态提示、帮助文档、快捷键、标题栏、侧边栏和全局伸展布局。 - 新增 Boltctl 官方站点、账户 License 管理和社区入口，桌面端首页与可信站点之间支持登录态衔接。 ## 修复 - 修复 Agent 中断、查询释放和多会话并发时的重入竞态，避免旧会话运行影响当前会话。 - 修复纯控制事件或重复 `done` 事件创建空白 Assistant 消息的问题，并增强刷新后的消息恢复一致性。 - 修复长回复、工具结果和代码块超出消息区域的问题；流式输出期间现在可以稳定向上浏览历史消息。 - 修复 AskQuestions 与其他交互弹窗并发时互相覆盖的问题，弹窗会按队列依次显示。 - 修复上下文用量、压缩状态、外部触发会话状态和顶部运行徽章显示不准确的问题。 - 修复计划任务在窗口进入后台后停止、默认模型未就绪以及异常状态缺少提醒的问题。 - 修复本地 MCP 端口策略、桌面生命周期、持久化 CRUD 和 stdio 进程清理问题。 - 修复代理检测结果未传递给 Agent 子进程的问题，并改进网络诊断和设置错误提示。 - 修复 macOS 启动卡住、旧版 WebKit 启动失败、原生窗口控制按钮丢失和文件面板无法显示点目录的问题。 - 修复 Linux 打包与桌面 API 路由问题，并统一开发版与生产版的本地服务端口。 - 修复内容分组页签、折叠侧边栏、笔记与 Skill 编辑入口在页面切换或重载后状态错误的问题。 - 修复 Markdown 实时预览、帮助弹窗遮挡、参考图结果对比和素材库交互中的多处问题。 - 修复待办时间、登录状态、表格渲染、内容工具幂等写入和测试误用用户数据库的问题。 - 修复命令行工具安装状态与功能入口不同步的问题；工具安装完成后，关联设置会立即可用。 - 修复 SSH AskPass 对 Bun 的额外依赖，提升干净系统上的授权兼容性。 ## 不兼容变更 - 0.2.7 聚焦桌面端，不包含在线版、移动端或云中继服务。外部消息接入由桌面端 cc-connect 和会话事件同步承担。 - 桌面发行版不预装外部 Agent CLI 或 Skills。除随包提供的 cc-connect 外，可选命令行工具需要在设置中按需安装，或由系统 `PATH` 提供。 - 项目与会话使用新的工作区模型。来自尚未包含 `projects` 表的早期数据库没有可靠的原地迁移契约，首次启动 0.2.7 时会重建旧的 `sessions` 和 `messages` 表。 ## 数据迁移 - 正式版数据目录为 `~/.boltctl/agent`。0.2.7 首次启动时会以幂等方式补齐内容中心、计划任务、协作、索引和新增字段；已有新架构项目、会话、消息与设置会继续保留。 - 如果从不含 `projects` 表的早期版本直接升级，旧会话和消息不会自动迁移。升级前请完全退出应用并备份 `~/.boltctl/agent`；需要保留的历史内容应先在旧版本中另行导出。 - 旧权限模式字段和设置会在启动时自动清理，无需人工操作。 - Skills 的当前共享目录为 `~/.agents/skills`。仍保存在旧应用私有目录中的自定义 Skill 不会自动导入，请在升级前备份并按新目录结构迁移。 - 开发版数据已隔离到 `~/.boltctl/agent-dev`，不会自动读取或覆盖正式版数据；开发版和正式版仍共享 `~/.agents/skills` 及 Boltctl CLI 配置。 - 建议在确认 0.2.7 正常启动、项目与内容完整之前保留升级前备份，不要用新版本数据库覆盖唯一备份。 ## 已知问题 - 从不支持当前签名更新链的旧构建升级到 0.2.7 时，需要手动下载安装包；安装 0.2.7 后，后续版本才可使用应用内自动更新。 - Linux 安装包仅在发布流程显式包含 Linux 时提供；AppImage 支持应用内更新，deb/rpm 仍需手动安装新版本。 - AI 模型、账户、更新、远程帮助、Skill 市场、Google Sheets、飞书、微信接入和 AI 生图等联网能力依赖对应服务、授权和网络环境；离线时这些功能不可用。 - Canvas、计划任务、多 Agent 协作和 Skills 导航默认隐藏，需要在导航管理中手动开启；Google、飞书和环境配置入口还要求对应命令行工具已安装。 - 本地 MCP 服务只在桌面 App 运行期间可用，并仅监听回环地址；完全退出应用后，已连接客户端需要在下次启动时重新连接。 ## 系统要求 - Windows 10 或更高版本；窗口最小可用尺寸为 800 × 600。 - macOS 10.15 或更高版本。 - Linux 发行版需提供 WebKitGTK 4.1 与 GTK 3；具体包名随发行版而异。 - 安装版无需预装 Bun、Node.js 或 Python。运行可选集成时，应用会按需下载工具，或使用管理员预先配置的工具路径。 - 登录、云端模型、应用更新与在线集成功能需要可访问对应服务的网络连接。