Keelson

本地优先的 AI 工作台 —— 把散落的 AI-CLI 会话、项目、任务、文档收拢到一处。

_{简体中文 · English}

Keelson 是一个本地优先的跨平台桌面应用，把散落的 AI-CLI 会话、项目、任务、文档收拢到一处。数据默认留在本机——会话正文不进数据库、AI 检索倾向本地 embedding、正文不发第三方。

• 会话中枢 + Spotlight —— 汇聚本地 Claude / Codex 等 CLI 的会话，全文搜索（Tantivy + jieba），全局热键即时唤起，一键恢复终端上下文。
• 项目看板 —— 两层项目模型：有会话的目录自动成轻量项目，可一键「提升」为受管 Board（任务 / 工作流 / 拖拽排序 / 模板），会话与任务双向溯源跳转。
• 文档 / 日历 —— 版本化文档（乐观并发、斜杠命令、KaTeX、文内 AI），支持重复规则与提醒的日历。
• AI Chat + RAG —— 可配置多 provider（Anthropic / OpenAI 兼容 / 本地），按用户 token 走 PocketBase 授权的作用域工具，检索历史会话回答「上次怎么解决的 X」。
• 化学反应沉淀 —— 会话 → 候选抽取 → 确认 → 落成文档 / 任务 / 日历，带溯源回链。
• 阅读 · 记忆账本 · MCP Server —— 收藏外部文章并 AI 摘要（支持登录墙站点粘贴正文）；可审核的记忆账本；对外暴露 MCP 工具供其它 AI 读写工作台数据。
• Web 远程访问 —— 设备配对 + Tailscale，从手机 / 浏览器安全访问本机工作台的终端 / 会话 / 通知；token 认证、失败限流、默认关闭。
• 进程管理 + 交互式终端 —— 内置 PTY 终端管理长驻进程，支持 sudo 密码交互，日志实时查看 / 复制；常用命令收藏与历史。
• 指令库 · 工作报告 · 命令面板 —— 可复用的 {{变量}} 提示词模板、AI 汇总工作报告、⌘K 全局命令面板。
• 双语 + 自动更新 —— 中 / 英 i18n；应用内自动更新（minisign 签名校验），启动即查、每 6 小时静默复查。

_{项目看板 —— 待办 / 进行中 / 已完成，任务优先级与截止日，一键「注入到 CLI」}

总览 —— 会话 / 看板 / 阅读 / 日程聚合一处	文档 —— 斜杠命令 / KaTeX / 文内 AI
阅读 —— 收藏 + AI 摘要，按状态归档	日历 —— 事件 / 重复 / 提醒
记忆账本 —— 可审核的跨会话记忆	指令库 —— {{变量}} 模板，一键插入

上述命令需先把清单发到各自生态，一次性步骤见 packaging/README.md。在此之前用下面的一键脚本或手动下载。

Windows（PowerShell）：

irm https://raw.githubusercontent.com/akapril/keelson/master/install.ps1 | iex

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/akapril/keelson/master/install.sh | sh

脚本会自动从 GitHub Releases 取最新已发布版本，按平台 / 架构下载并安装。

到 Releases 下载对应安装包：

⚠️ macOS 首次打开提示「已损坏 / 无法验证开发者」：应用为 ad-hoc 签名、未做 Apple 公证。二选一解决：

• 右键点应用 →「打开」→ 再点「打开」；或 系统设置 → 隐私与安全性 →「仍要打开」。
• 或终端执行：xattr -dr com.apple.quarantine /Applications/Keelson.app

（一键脚本已自动处理这步。）

💡 自动更新：装好后无需再手动下载——内置应用内自动更新，发现新版一键升级。

装好、打开 Keelson（本地优先、免登录、开箱即用）后：

1. 产生会话：在任意目录用你平时的 CLI 跑 claude / codex —— 会话会自动出现在 会话中枢（全文可搜、一键恢复上下文）。
2. 提升为项目：把你常用的目录一键「提升为项目」，它的 看板 / 文档 / 进程 / AI 就都挂到这个项目工作台下。
3. 让 AI 直接读写工作台：把 claude / codex 接上 Keelson 的 MCP（见下），它就能直接建任务、写文档到你的看板。
4. 随手沉淀：会话里的结论用「化学反应」抽成 文档 / 任务 / 日历，带溯源回链；外部文章丢进 阅读 让 AI 摘要。

数据默认全留本机，不登录、不上传（见「隐私边界」）。

Keelson 内置一个 MCP server，让本地 claude / codex（及任意 MCP 客户端）直接操作你的看板任务与文档，授权由 owner-only 规则强制（只能碰你自己的数据）。

应用内一键接入：打开 设置 → MCP 接入（claude / codex），点「接入 Claude Code」或「接入 Codex」——自动写好客户端配置（~/.claude.json / ~/.codex/config.toml），无需手敲命令。

进阶 / 手动配置、可用工具与验证见 docs/mcp-setup.md。

在手机 / 平板 / 另一台电脑上安全访问本机的 Keelson —— 浏览工作台、看会话与通知，甚至用 Web 终端远程驱动 claude / codex。

• 双层安全：① Tailscale 私有网（只有你同账号登录的设备可达，公网到不了）② 应用配对 token（外部设备需输一次配对码，之后 token 鉴权、失败限流、可随时吊销）。默认关闭，需在设置里显式开启。
• 能远程做什么：Web 终端（跑 CLI）、工作台会话列表、通知 —— 移动优先的响应式界面。
• 接入：本机与远程设备装 Tailscale（同账号）→ 设置里开「Web 网关」并配对 → 经 tailscale serve 的 HTTPS 访问（Secure cookie 要求 HTTPS，见文档）。
• ⚠️ 远程终端可在本机执行任意命令 —— 只在受信设备上配对；设备丢失即在设置里吊销其 token。

完整接入步骤见 docs/web-remote-access.md。

前置： Node 20+、pnpm、Rust stable。Linux 另需 libgtk-3-dev libwebkit2gtk-4.1-dev librsvg2-dev libayatana-appindicator3-dev。

pnpm install
pnpm tauri dev      # 启动应用（首次会自动下载对应平台的 PocketBase sidecar）

常用校验：

pnpm lint           # eslint
pnpm exec tsc --noEmit
pnpm test           # vitest
cargo test --manifest-path src-tauri/Cargo.toml --lib

pnpm tauri build    # 产物在 <target>/release/bundle/

PocketBase sidecar 由 scripts/fetch-pocketbase.mjs 在 prebuild 阶段按当前平台三元组自动获取，并以 Tauri sidecar 命名规则放入 src-tauri/binaries/。

发布：推送 v* 标签触发 release.yml，四平台交叉构建并汇总为一个 Release 草稿；人工 Publish 后，旧版本即可通过应用内更新检测到新版。

会话正文留在磁盘，仅元数据入 PocketBase；AI 检索倾向本地 embedding，正文不发送第三方；破坏性操作不注册为 AI 工具（服务端 access-rules 即授权边界）。Web 远程访问默认关闭，开启后仅 token 认证的已配对设备可入。

• 需要注册 / 登录吗？ 不需要。本地模式免登录、开箱即用；登录仅在你主动配置「远程 PocketBase」多设备时才出现。
• 数据会上传吗？ 不会。数据默认全留本机；只有你显式调用 AI provider 时，才把当次所需内容发给你配置的模型。
• 支持哪些 CLI？ 任何把会话落盘的 AI-CLI，目前主打 claude / codex（自动扫描本地会话）。
• 多机同步？ 规划中（离线优先、单用户 LWW，见 docs/）；当前每台机器数据独立。
• macOS 打不开（“已损坏”）？ 应用未公证，见「安装」章节的 Gatekeeper 绕过（右键打开 / xattr / 一键脚本已自动处理）。

所有业务数据在本机 PocketBase 的 pb_data 目录（设置 → 后端 → 「打开数据目录」可直达）：

备份 = 关闭 Keelson 后整目录拷走即可（data.db 为主库，storage/ 为文档图片）。会话本身不在此——它们是 ~/.claude 等的实时扫描，不由 Keelson 存储。

MIT © akapril