@sinm/kai 1.8.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CassClaw Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# KAi
+
+> 开启思考。不是帮你做事，是帮你想得更深、更远。
+
+KAi 是一款**多 AI Agent 协作桌面应用**。你可以创建多个拥有独立人格、记忆和技能的 Agent，让它们在你的桌面上像一个真正的团队一样协作——讨论、交接、互审、分工。
+
+## 为什么
+
+用 ChatGPT 聊天，你得到的是一个无所不能但什么都记不住的通用助手。
+
+KAi 不一样。你可以让一个"乔布斯"负责产品思考，一个"Anders Hejlsberg"把控架构，一个"TJ Holowaychuk"写代码，一个"Robert C. Martin"写审查。它们各有各的记忆、工具权限和个性。它们会 @mention 彼此，会交接任务，会监督结果。
+
+**一个人，一支团队。**
+
+## 特性
+
+### 🧠 Agent 系统
+
+- **独立身份** — 每个 Agent 有自己的名字、头像、个性描述，甚至可以自定义 SOUL（行为准则）
+- **持久记忆** — Agent 自主维护 MEMORY.md（长期记忆）和每日笔记，跨会话记住上下文
+- **工作空间** — 每个 Agent 拥有独立的文件工作空间（`~/.kai/agents/{id}/workspace/`）
+- **Skill 技能系统** — 可扩展的技能包，Agent 按需加载，提升专业领域表现
+
+### 👥 多 Agent 协作
+
+- **群聊模式** — 多个 Agent 在同一个对话中协作，支持 sequential / parallel / broadcast 策略
+- **Handoff 交接** — Agent 之间可以主动交接任务，附带原因和上下文摘要
+- **@mention** — 在回复中 `@AgentName` 触发自动交接
+- **Supervisor 监督** — 指定一个 Agent 作为监督者，评估执行结果是否达成目标
+- **子任务分派** — Agent 可以创建前台/后台子任务，委托给其他 Agent 执行
+
+### 🛠 内置工具
+
+Agent 开箱即用的能力：
+
+| 工具 | 功能 |
+|------|------|
+| **Shell** | 执行终端命令 |
+| **Read/Write/Edit File** | 读写和精确编辑本地文件 |
+| **Web Search** | 网络搜索 |
+| **Web Fetch** | 抓取和解析网页内容 |
+| **Database** | 查询应用数据库（只读） |
+| **Scheduler** | 创建和管理定时任务 |
+| **Skill** | 加载和执行技能包 |
+| **MCP** | 通过 Model Context Protocol 连接外部工具服务器 |
+
+### 💬 聊天体验
+
+- 流式输出，实时渲染 Markdown / 代码高亮 / 推理过程
+- 支持图片附件
+- 明暗主题自适应
+- 中英文国际化（i18n）
+
+## 技术栈
+
+```
+Electron 40 + React 19 + TypeScript 5
+Vercel AI SDK + SQLite3 + Zustand + CSS Modules
+electron-vite + Vitest
+```
+
+- **主进程**：Agent 执行引擎、IPC、数据库、文件系统、MCP 客户端
+- **渲染进程**：React UI，沙箱化运行（`contextIsolation: true`）
+- **预加载层**：`contextBridge` 安全桥接
+
+## 快速开始
+
+### 环境要求
+
+- Node.js >= 22
+- Yarn
+
+### 安装
+
+```bash
+git clone https://github.com/your-org/kai.git
+cd kai
+yarn install
+```
+
+### 开发
+
+```bash
+yarn dev          # 启动开发服务器（支持 HMR）
+```
+
+### 构建
+
+```bash
+yarn build        # 构建生产版本
+yarn package      # 打包为平台安装包（输出到 release/）
+```
+
+### 测试
+
+```bash
+yarn test              # 运行测试
+yarn test:ui           # 测试 UI
+yarn test:coverage     # 覆盖率报告
+```
+
+## 架构
+
+### Agent 执行层
+
+```
+SoloExecutor          ← 单 Agent 对话
+SwarmExecutor         ← 多 Agent 群聊（管理 handoff 循环）
+  ├── AgentExecutor   ← 单次 LLM 调用（流式 + 工具执行循环）
+  ├── SupervisorLoop  ← 监督评估循环
+  ├── TaskOrchestrator ← 子任务创建和管理
+  └── SwarmContext    ← 共享状态（handoff chain、task map）
+```
+
+### 消息压缩管线
+
+长对话自动压缩，4 级策略管道：
+
+```
+ToolResultSpill（合并冗长工具结果）
+  → ReasoningRemoval（移除推理过程）
+    → Summarization（摘要旧消息）
+      → Pruning（裁剪最旧消息）
+```
+
+### 数据存储
+
+```
+~/.kai/
+├── kai.db                    # SQLite 主数据库
+├── config/                   # 应用配置（加密存储 API Key）
+├── agents/
+│   └── {agentId}/
+│       └── workspace/        # Agent 工作空间
+│           ├── IDENTITY.md   # 身份定义
+│           ├── SOUL.md       # 行为准则
+│           ├── MEMORY.md     # 长期记忆
+│           ├── USER.md       # 用户信息
+│           ├── AGENTS.md     # 工作指南
+│           ├── TOOLS.md      # 环境配置
+│           └── memory/       # 每日笔记
+├── attachments/              # 对话附件
+└── sessions/                 # 会话消息存储
+```
+
+## 支持的 LLM
+
+KAi 通过 Vercel AI SDK 连接大语言模型，支持：
+
+- OpenAI Compatible（OpenAI、DeepSeek、Moonshot、MiniMax 等）
+- Anthropic Claude
+- Google Gemini
+- 任何兼容 OpenAI API 的模型
+
+在设置的 LLM 通道中配置 API Key 即可使用。
+
+## MCP（Model Context Protocol）
+
+KAi 内置 MCP 客户端支持。在设置中配置 MCP 服务器，即可让 Agent 使用外部工具：
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "my-server": {
+        "command": "npx",
+        "args": ["-y", "@my/mcp-server"]
+      }
+    }
+  }
+}
+```
+
+## 项目结构
+
+```
+src/
+├── main/                  # Electron 主进程
+│   ├── agent/             # Agent 执行引擎
+│   │   ├── SoloExecutor   # 单 Agent 执行器
+│   │   ├── SwarmExecutor  # 群聊执行器
+│   │   ├── AgentExecutor  # LLM 调用执行器
+│   │   ├── SupervisorLoop # 监督循环
+│   │   ├── TaskOrchestrator # 任务编排
+│   │   ├── SwarmContext   # 共享上下文
+│   │   ├── HandoffResolver # Handoff 解析
+│   │   └── factory/       # Prompt/Tools 构建
+│   ├── compression/       # 消息压缩管线
+│   ├── config/            # 配置管理（加密）
+│   ├── db/                # SQLite 数据层
+│   ├── handlers/          # IPC 处理器
+│   ├── mcp/               # MCP 客户端
+│   ├── scheduler/         # 定时任务系统
+│   ├── skill/             # Skill 技能系统
+│   ├── storage/           # 会话/附件存储
+│   ├── tools/             # 内置工具
+│   └── workspace/         # Agent 工作空间管理
+├── renderer/              # React 渲染进程
+│   └── src/
+│       ├── components/    # UI 组件
+│       ├── stores/        # Zustand 状态管理
+│       ├── locales/       # i18n 翻译文件
+│       └── styles/        # 设计令牌 + CSS Modules
+├── preload/               # 安全桥接层
+└── shared/                # 主进程/渲染进程共享类型
+```
+
+## 安全模型
+
+KAi 采用 Electron 三进程安全架构：
+
+- **渲染进程**：完全沙箱化，无 Node.js 访问
+- **预加载层**：`contextIsolation: true` + `nodeIntegration: false`
+- **主进程**：所有文件系统、网络操作通过 IPC 暴露给渲染进程
+- **API Key**：AES-256 加密存储，使用机器唯一标识派生密钥
+
+## License
+
+MIT

package/bin/kai-cli.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+/**
+ * kai-cli 入口脚本
+ * 
+ * 先检查 renderer 产物是否存在，然后启动 CLI 服务。
+ */
+
+const { existsSync } = require('fs')
+const { resolve, dirname } = require('path')
+
+// 检查 renderer 产物
+const rendererDir = resolve(__dirname, '../dist-electron/renderer')
+if (!existsSync(resolve(rendererDir, 'index.html'))) {
+  console.error('Error: Renderer build not found.')
+  console.error('Please run "yarn build" or "yarn build:cli" first.')
+  process.exit(1)
+}
+
+// 动态 require CJS 入口
+require(resolve(__dirname, '../dist-cli/kai-cli.js'))