本地运行 FastAPI 后端 + Electron 前端，灵犀在你本机运行：读文件、搜 Shibei 知识库、查连接器、连 MCP，Build 模式下可写文件/跑 Shell/委派子 Agent 或 CLI——高风险操作先问你。
功能概览
| 能力 | 说明 |
|---|
| Agent 模式 | Build 执行 · Ask 只读问答 · Plan 只读规划 |
| 工具集 | FS · glob_files · 记忆/Shibei · 联网 · MCP · 连接器 · 浏览器 · ask_user |
| Shibei 知识库 | 直连 Shibei 索引；读个人文档无需先同步 |
| 连接器 | 飞书/读书等 → SQLite；Agent 可 list_connectors / sync_source |
| Sub-agent | explore/worker/verify/plan；暂停/恢复；进度树 |
| CLI Agent | spawn_cli_agent 外接 codex/kimi 等（Build，需确认） |
| Harness P0 | TurnRunner · SessionStore · SSE schema v2 |
| Grounding | 文件/记忆回答需工具佐证；Verified / Unverified |
| 多线程 | /api/chat/threads 持久化 + 侧边栏切换；标题自动跟随最新提问 |
| 分支地图 | 对话节点化、fork/rollback/restore、紧凑节点视图 |
| Chat Markdown | markdown-it + DOMPurify |
Agent 模式
| 模式 | 适合 | 典型工具 |
|---|
| Ask | 查资料、问记忆、调研 | 只读 FS、Shibei、web、browser、连接器状态 |
| Plan | 出方案、拆任务 | Ask + todo、skills |
| Build | 改代码、跑命令、同步、委派 | 全工具 + spawn_subagent / spawn_cli_agent |
读记忆 vs 同步
读笔记 / 「读取记忆」 → shibei_search（主路径）
写偏好 / 稳定事实 → memory 工具（USER.md / MEMORY.md）
连接器专项 / 刷新数据 → sync_source 或 设置里「同步」（备选）
技术架构
| 层 | 技术 |
|---|
| 后端 | Python 3.11+ · FastAPI · SQLite |
| 前端 | Electron · 原生 HTML/CSS/JS |
| Agent | 自研 Loop · OpenAI 兼容 API · MCP SDK |
数据全部本地存储，注重隐私与可控性。
