Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
Desktop:Agent 工作入口
本文件适用于 apps/desktop/;根 AGENTS 的跨仓、数据、授权、
插件兼容、协议与交付规则仍然适用。本文只维护模块触发条件,专题正文继续使用同一正本。
代码、共享判据与测试入口见仓库地图。
开发与进程边界
- 启动、调试或验证 Desktop 时,必须先读Desktop 开发。
- 修改 Desktop Renderer、preload、BrowserWindow、WebView、IPC、CSP、导航或 Electron 特权能力前,必须先读Electron 安全与进程边界。
- 新增或修改 Desktop 独立窗口、辅助窗口或弹出型
BrowserWindow前,必须遵守 Electron 安全与进程边界的「独立辅助窗口统一生命周期 基线」:复用既有控制器/基础设施,不得另造平行的预热、就绪握手、隐藏复用与崩溃恢复 状态机。 - 修改 Desktop 数据库 schema、migration、companion script 或运行期数据库访问前,必须 先读数据库与迁移。
界面与渠道
- 改完 Desktop renderer 界面(组件、样式、布局、文案、深浅色、多语言)后自检,先运行
pnpm ui:check --changed --theme all并查看输出的overview.png,无需为此启动完整 Desktop;输出中UNCOVERED的文件未被验证。发 PR 时运行pnpm ui:check:publish,把输出的 带图内容写进「UI 变化」。按改动类型选择验证方式见 Desktop 开发「按改动选择验证方式」。 - 修改个人 IM 渠道(
src/main/im/**)或官方 hook(src/main/hook-control/**)的 找/建任务、命令、排队与插话、输入拼装、事件观察、交互、收尾或停止逻辑前,必须先读 IM 轮次流程(入口账本、状态清单、不变量与迁移批次)。