@sinm/kai 1.9.3 → 1.10.0

package/README.md

@@ -23,7 +23,8 @@ KAi 的答案是 Agent 团队。你可以让一个「乔布斯」负责产品判
 
 ### 👥 多 Agent 协作
 
-- **群聊与线程** — Group 是团队，Thread 是讨论现场；一个 Group 可拥有多个隔离线程。
+- **Session 化对话** — 单聊和群聊都以 Session 为主概念；一个群组可拥有多个隔离 Session。
+- **单聊多 Session** — 同一个 Agent 可并行开启多个讨论，适合把不同任务、分支思路和长期陪跑拆开。
 - **Handoff 交接** — Agent 可以主动交接任务，并附带原因和上下文摘要。
 - **@mention** — 在消息中 @ 指定 Agent，触发协作或路由。
 - **Broadcast 广播** — 一次问题并行询问多个 Agent，聚合不同专业判断。
@@ -50,13 +51,16 @@ Agent 开箱即用的能力：
 
 - 流式输出，实时渲染 Markdown / 代码高亮 / 推理过程。
 - 支持图片、文件附件和多模态消息。
-- 工具调用、任务结果、广播结果以结构化卡片展示。
+- 工具调用、任务结果、广播结果以结构化卡片展示，并展示状态与耗时。
+- 群聊与单聊都支持顶部 Session Tabs：新建、切换、重命名、归档。
+- 快捷回复支持独立 `⚡` 入口；`/` 命令保留给真正的命令。
 - 明暗主题自适应。
 - 中英文国际化（i18n）。
 
 ### 🔌 连接与自动化
 
 - **模型通道** — 支持主模型、备用模型、自动 fallback 和健康状态记录。
+- **模型能力学习** — 根据真实报错学习上下文窗口 / 最大输出限制，自动修正后重试。
 - **MCP 服务** — 在设置中添加 MCP 服务，并一键应用到指定 Agent。
 - **Bot 接入** — 支持外部频道接入，让 Agent 不只活在桌面窗口里。
 - **远程访问** — 可通过远程入口访问本地 KAi。
@@ -71,6 +75,7 @@ Vercel AI SDK + SQLite3 + Zustand + CSS Modules
 electron-vite + Vitest + Playwright
 ```
 
+- **运行形态**：Electron 桌面应用 + CLI + 本地 telemetry dashboard
 - **Core**：Agent / Message / Tool / Skill 等领域逻辑与端口接口。
 - **Adapters**：LLM、MCP、DB、文件存储、工具、调度器、外部频道等具体实现。
 - **Electron Main**：应用启动、IPC、自动更新、崩溃日志、远程访问。
@@ -99,6 +104,13 @@ yarn install
 yarn dev
 ```
 
+### CLI
+
+```bash
+yarn build:cli
+npx @sinm/kai@latest start --port 9529
+```
+
 ### 构建与打包
 
 ```bash
@@ -111,9 +123,18 @@ yarn build:cli    # 构建 CLI
 
 ```bash
 yarn test                         # Vitest
-yarn tsc -p tsconfig.web.json --noEmit
-yarn tsc -p tsconfig.node.json --noEmit
-KAI_DATA_PATH=$HOME/.kai_test yarn test:e2e
+npx tsc --noEmit -p tsconfig.web.json
+npx tsc --noEmit -p tsconfig.node.json
+yarn test:e2e                     # 内部会先执行 yarn build
+```
+
+发布前建议按这个顺序跑完整门禁：
+
+```bash
+npx tsc --noEmit -p tsconfig.web.json
+npx tsc --noEmit -p tsconfig.node.json
+yarn test
+yarn test:e2e
 ```
 
 ## 架构
@@ -136,16 +157,16 @@ src/
 
 ```text
 SoloExecutor             # 单 Agent 对话
-SwarmExecutor            # 多 Agent 群聊编排：handoff / task / broadcast / supervisor
+SwarmExecutor            # 多 Agent 协作编排：handoff / task / broadcast / supervisor
   ├── TaskOrchestrator   # 子任务与广播任务编排
-  ├── SwarmContext       # 群聊运行态：handoff chain、task map 等
+  ├── SwarmContext       # 协作运行态：handoff chain、task map 等
   └── AgentExecutor      # 当前生产执行器：流式模型调用、工具循环、fallback、压缩
 
 AgentLoop                # 正在演进的新执行循环抽象：retry / stopWhen / tool loop / usage collect
   └── AgentKernel        # 单次模型调用内核：streamText、工具调用投影、tool-call repair
 ```
 
-### 消息与线程
+### 消息与 Session
 
 ```text
 User Input
@@ -160,8 +181,9 @@ User Input
   → React UI
 ```
 
-- 单聊以 Agent 为目标。
-- 群聊以 Thread 为讨论现场，`speaker` 是线程级状态。
+- 单聊与群聊都以 `Session` 作为主要运行单元。
+- 单聊的 Session 归属于某个 Agent；群组的 Session 归属于某个 Group。
+- `speaker` 是群组 Session 级状态，而不是全局群组状态。
 - 消息仍由 SQLite 持久化；长上下文由文件 `context.json` 保存。
 
 ### 消息压缩管线
@@ -181,11 +203,14 @@ ToolResultSpill
 ~/.kai/
 ├── kai.db                         # SQLite：消息等结构化数据
 ├── config/                        # 应用配置，加密存储 API Key
+├── direct-sessions/
+│   └── {sessionId}/
+│       └── context.json           # 单聊 Session 上下文
 ├── agents/
 │   └── {agentId}/
 │       ├── meta.json              # Agent 身份
 │       ├── config.json            # 模型、fallback、skills、MCP、禁用工具等能力配置
-│       ├── context.json           # 单聊上下文
+│       ├── context.json           # legacy 单聊上下文兼容文件
 │       └── workspace/
 │           ├── IDENTITY.md
 │           ├── SOUL.md
@@ -202,12 +227,12 @@ ToolResultSpill
 │       ├── GROUP_SETTINGS.md      # 人可写，AI 只读
 │       ├── GROUP_MEMORY.md        # 群长期记忆
 │       ├── memory/                # 群每日记忆
-│       └── threads/
-│           └── {threadId}/
+│       └── sessions/
+│           └── {sessionId}/
 │               ├── meta.json
 │               ├── config.json
-│               └── context.json   # 线程上下文
-├── conversations/                 # 追加式消息日志（jsonl）
+│               └── context.json   # 群组 Session 上下文
+├── conversations/                 # 追加式消息日志（jsonl，兼容运行链路）
 └── attachments/                   # 对话附件
 ```
 
@@ -246,6 +271,12 @@ KAi 采用 Electron 三进程安全架构：
 - **数据库工具**：只允许只读查询。
 - **API Key**：使用本地 salt + machineId 派生密钥，并通过 AES-256-GCM 加密存储。
 
+## 项目文档
+
+- [功能清单](docs/features.md) — 从用户视角查看当前已实现能力
+- [文档索引](docs/README.md) — architecture / design / workflow 等入口
+- [Release Notes](RELEASE_NOTES.md) — 已发布版本记录
+
 ## 进一步阅读
 
 - [架构文档](docs/architecture/architecture.md)