834063245-creator/HoloGram

兰台（Lantai）— 桌面 Agent 工作台
主界面不是聊天窗，而是一张会生长的纸：人来文、AI 正文、思考夹注、工具脚注、代码抄录。

这是什么

兰台是 Windows 桌面 Agent 工作台（Tauri 2 壳 + TypeScript / React 19 前端）：一套完整的多 Agent 运行时。

仓库里住着两个产品面：工作台（src-ui/ + src-tauri/）与引擎（engine/ 及 hologram-* crate）。

快速开始

1. 装（Windows）：Releases 下载安装包 （.exe）→ 启动。从源码：仓库根 build.cmd（会先跑前端构建）。

卸载：设置 → 应用 → 兰台 → 卸载，确认页有「删除应用程序数据」勾选框（缺省不勾）。 勾上则一并清除用户级数据：~/.lantai（设置 / 全局记忆 / 技能 / 插件与其数据 / 老会话备份）、 改名老位 ~/.hologram，以及 %APPDATA%/%LOCALAPPDATA% 下的兰台目录（窗口状态、WebView2 缓存、加密的 API Key）。不勾 = 一个字节都不删，重装后原样继续（应用内自动更新走的也是这条 卸载路径，永不删数据）。工作区目录里的 {项目}/.lantai（会话正文、附图、画布布局）属于你的 项目文件，卸载器不会动它；脚本化完全卸载（GUI 勾选框的等价物）： uninstall.exe /S /PURGE-DATA（不带 /PURGE-DATA 的静默卸载不删任何数据）。 早先的旧 .msi 安装（2026-09-26 起不再提供 .msi）没有这条通路：先跑一次安装目录里的 lantai.exe --purge-user-data 再卸载即可——装新版的 .exe 时安装器也会自动接管旧 MSI 安装。

2. 进工作区：首次启动落在案卷首页——新建工作区（默认建在 ~/Documents/兰台/<名字>），或指定一个 已有目录：一个工作区就是一张纸。

3. 落笔：

• 输入框写下你要它做的事，回车即成第一卷（输入 / 出案卷命令）。
• **侧边栏「案卷」**管本工作区的卷：＋另起一卷 · F2 改名 · C 合卷（收起，数据保留）· 删除。
• 左缘书脊列出摊开的卷：点击定位、拖动落位、hover 合卷。书脊与侧边栏互斥两态（侧栏展开时书脊退场）。
• 权限卡在危险动作前弹出；Ask（默认）/ Auto（仅编辑类）/ Yolo 三档随时可切（详见护栏）。

想用图谱引擎：设置 → MCP →「随包图谱引擎」→ 勾选「启用随包图谱引擎」→ 下次打开工作区生效 （每工作区按各自的根起一个引擎进程，离开工作区即停）。

界面范式：一张会生长的纸

聊天界面把工作压成一条等权消息流：只能往下滚，多任务只能多开窗，想回到昨天那件事得靠搜索。 纸壳 · 注疏案卷换掉的是容器本身——会话是一个空间，不是一条流。

• 一个工作区 = 一张纸：多卷（会话）摊在同一片纸上，可对照、可追溯——平行的几件事靠「多卷 同屏」表达，而不是切窗口（运行中的卷还能同时跑，只是不能合卷）。左缘书脊一卷一脊、当前卷「抽出 一半」；合卷 = 离席但存盘，随时重新摊开。
• 位置即记忆：任意一块能钉成纸条留在纸边，也能拖到流区 / 纸条区落位；摊开集、纸条、落位全 落盘（.lantai/canvas*.json）——重启回到昨天摆好的案头，版面不用重建。
• 距离即粒度：平移无边界、缩放 0.35–2.4 档；拉远时正文退成行影、整卷成为一眼可辨的纹路（鸟瞰）， 拉近才是字（精读），右缘小地图给全部摊开卷的鸟瞰。
• 注疏层级取代等权气泡：不同来源有不同文体——来文（你的问话，手迹位）· 正文（AI 的答，居中 主角）· 夹注（思考）· 脚注（工具调用）· 抄录（diff）· 程文（程序执行）· 拟策（审批卡）· 贴黄（通知）· 错因（回合错误）——扫一眼就知道谁在说话、哪句是结论；在来文里写【关键词】，纸面 即渲染成朱砂圈点（人的批改）。块类型是开放面：内置 + Agent 资产 kind + 插件贡献。
• 回合有呼吸：流式输出按读包 / 写包 / 验证包 / 提交成族，不是等距瀑布；零摊开卷时是案头—— 退匣直书 + 最近几卷的签条架，落笔即另起一卷。

纸底 + 矿物墨色（朱砂＝人 / 石青＝机 / 石墨＝夹注 / 墨＝正文），自托管字体两枚（正文 MiSans 可变字体 + 机读位 Noto Sans Mono CJK SC 等宽，均随包不依赖系统安装）；版式契约见 docs/design/lantai-design-spec.md，视觉决定账本见 docs/plans/paper-shell/taste-ledger.md。

内置 Agent 工作台

工具面

模型只见一批高内聚域工具，每个域以 action 作首参——fs(read|write|edit|…)、 shell(run|output|wait|kill)、git(status|diff|commit|…)……；会话级另有 Skill、plan、通信族、 code_execution 执行原语（程序体在 Web Worker 沙箱里跑，可嵌套调用全部可见工具）。旧细粒度工具名已 淘汰，误调会被拦成「[已淘汰] → 域动作」。事实源 = 生成物 docs/agents/model-tool-contract.md；跨文档标量（字段数 / 域数 / 契约版本等）见 docs/facts.generated.md，本文不复述。

运行时

工具行 / prompt 段 / capability 三层装配面的表序是字节契约，由 npm run verify:convergence 双轨钉死；会话变异只走 _appendMessage / _replaceSession / _retractSessionRange 三个入口（SessionLog 支撑差分对拍、回放与审计）。规则见 CLAUDE.md · CONVENTIONS.md · INVARIANTS.md。

多 Agent

子 Agent 池（fork 继承上下文 / fresh 干净启动）+ 有界 inbox + 按会话隔离的 TaskBoard / DiscoveryBoard + git worktree 隔离执行（git worktree add --detach，cherry-pick 串行合并、孤儿收养、 TTL 清理）。

Plan / Goal

Plan 模式只读探索 + 写计划文件，交你审批后离开，写约束由 planGateCheck 在执行层拦截； Goal 模式把目标状态持久化在 .lantai/goals/{id}/，跨会话恢复。

记忆与 Provider

事件溯源会话记忆 · 项目记忆（.lantai/memory/*.md）· 技能 （.lantai/skills/<name>/SKILL.md，装完即用不必重启）；多厂商 Provider（Anthropic / OpenAI 兼容 / DeepSeek 等，清单可运行时拉取）+ loopback 反向代理（绕开 WebView 跨域）+ 系统级加密凭据（Windows DPAPI / macOS Keychain / Linux Secret Service）。

护栏

权限引擎合流系统 / 项目 / 会话规则，裁决 Allow / Deny / Ask / Passthrough（后者 = 该工具 自检无意见，中央闸按规则面放行、不弹窗），Yolo 不旁路 Deny；危险命令表拦 rm -rf /、curl | sh、 eval / source、sudo、git push --force main 等并对 PowerShell 特判；三层沙箱（OS 层 Windows Job Object / macOS sandbox-exec / Linux bubblewrap——发布主力是 Windows，另两者依赖系统自带沙箱程序；shell 默认走捆绑 MSYS2 bash · 路径层越界升 Ask · I/O 层读写上限、超时、重试、原子写）；经权限闸的调用落 .lantai/audit.jsonl（pty / lsp 等无闸能力口不在其中，code_execution 嵌套调用落 session-log）。

插件系统

出厂态没有任何一行硬编码特权：全部贡献行（含第一方）都可被 roster patch / preset 禁用、覆盖、锚定； 另有 manifest.mcpServers（挂外部 MCP server，零插件代码）与 manifest.activation（惰性激活：登记 ≠ 激活，按引用计数起停）。贡献通道与可换后端清单以生成物 docs/agents/service-catalog.md 为准。

在 GitHub 阅读完整 README →