面向本地工作流的桌面 AI 工作台。按项目组织任务,连接本地或云端模型,通过对话处理文件、运行命令、搜索资料,并用技能与插件扩展能力。
前往 GitHub Releases,查看与你的系统和架构匹配的安装包。发布平台以实际产物为准;没有对应安装包时,可从源码启动。当前采用手动下载安装与更新,详见安装与分发说明。
需要 Node.js 24+、npm 10+ 和 Git。
git clone https://github.com/ErickPang/KairoPilot.git
cd KairoPilot
npm ci
npm run dev- 在设置中添加模型服务,填写所需的 API Key 或本地服务地址,并选择默认模型。本地模型可搭配 Ollama。
- 新建独立会话,或创建项目并选择工作目录。
- 选择执行策略,输入任务并发送;需要授权时,在输入区查看操作并决定是否允许。
- 在对话中查看结果,在文件与成果面板检查交付物。输入
/可选择已安装的技能。
- 项目与任务:分别保存对话、模型、工作目录、草稿、附件和成果,支持排队续办。
- 本地与云端模型:支持 Ollama、OpenAI、DeepSeek 等服务及自定义 OpenAI 兼容接口。
- 文件与工具:在授权范围内读写文件、执行 Shell 命令、搜索和读取网页;聊天内展示执行活动。
- 技能与插件:用
/选择技能,按需加载技能说明与插件工具,支持安装审核和版本管理。 - 规则与记忆:通过
AGENTS.md管理工作规则,按项目管理记忆;支持任务模板、计划确认与只读子任务委派。 - 审批与用量:提供操作确认、目录与命令限制、审计记录及按任务、模型和时间查看的 Token 统计。
默认数据目录为 ~/.kairopilot。模型与搜索服务的 API Key 使用系统安全存储能力加密保存;任务中发给模型或联网工具的内容取决于所选服务、操作与授权。
工具执行受目录、命令和网络规则约束;会话内批准不能覆盖明确禁止的操作。Shell 限制属于应用层控制,不提供操作系统级沙箱。关闭窗口会隐藏到托盘并保留运行;真正退出应用会中断运行与待审批操作,再次启动进入空白新对话,历史可手动查看。
项目基于 Electron、React 和 TypeScript,使用 SQLite 与 JSON 保存本地数据。
| 命令 | 用途 |
|---|---|
npm run dev |
启动开发环境 |
npm run verify |
运行 ESLint、类型检查、单元测试与产品冒烟检查 |
npm run smoke:native |
使用隔离数据和本地模型夹具进行 Electron 原生验收 |
npm run build |
构建应用与安装包,不自动发布 |
完整环境说明、独立检查命令、项目结构和分支约定见开发与贡献。
| 文档 | 内容 |
|---|---|
| 使用指南 | 工作台操作、技能、审批、规则记忆与数据格式 |
| 开发与贡献 | 本地开发、验证、构建与协作约定 |
| 架构说明 | 进程通信、任务组织与存储结构 |
| 发布说明 | 封板验证、安装更新、兼容性与隐私说明 |
反馈问题或建议请提交 Issue。