agent-loft 0.2.90 → 0.2.93

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -93,6 +93,9 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
93
93
  - **记忆**:像 ChatGPT 的记忆,设置 → 记忆(默认关),按用很多年设计。「关于我」加上一条条记住的事;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),事情变了用 `update_memory`,记错了用 `forget`。**分三层**:长期(身份、家人、长期偏好,一直放进系统提示,不会被后来的挤掉,也可以自己置顶)、活跃(近期的事,按最近动过的时间放进系统提示,放不下的 agent 能用 `search_memory` 搜到)、归档(过时了、到期了、满了被挤出来的,不进系统提示,不删,能搜到能恢复)。**谁能动**:你加的、你在聊天里明确要求记的、你置顶的都受保护,自动整理不能改、不能删、满了也不会被挤,agent 要改得是你在当前对话里明确要求。明显的密钥(API key、`密码是……`)agent 和整理都记不进去。**不怕改错**:删除进回收站保留 30 天;每次改动都有记录(谁、什么时候、改之前是什么),在设置里能查能撤销,改之前的旧内容也搜得到;清空和彻底删除才是真删。**自动整理**:把上次整理之后新说的话连同日期交给模型(不留会话记录的一次性调用),补充、更新、归档过时的记忆。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。很长的对话切成几份整理,一句不漏;整理失败的对话不会丢,留着下次再试,连着全失败就退避(最长 6 小时),同一段一直失败的先搁置,点「现在整理」时再试。**摘要**:整理时顺带给每段对话写摘要(不多一次调用),月份过去后合成一份月度摘要(一个月一次调用),agent 回答「那段时间做了什么」「那件事的经过」时用 `memory_timeline` 看,还能按项目目录筛。只有整理范围内的对话才有摘要。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,能按日期筛,只有你自己的、没被删掉的对话),要看前后文用 `read_past_chat`。搜索走 SQLite FTS5 全文索引(中文按字索引,两个字的词也能搜),几十万句也在一秒内;设置页会显示近 30 天 agent 搜了多少次、多少次没搜到。聊天记录索引不开记忆也会记(侧栏的「搜索」也用它),升级后会把已有对话收录进来一次;没开记忆时记进来的不拿去整理。删对话时它的聊天记录索引和摘要一起删,提炼出来的记忆条目留着(记着来源)。**导出和备份**:记忆能导出成 JSON、导入到别的账号或服务器,聊天记录能导出成 JSONL;整个数据库每天自动备份到 `backups/db/`(校验后压缩,留最近 7 天、4 周、12 个月,`AGENT_LOFT_BACKUP_DIR` 可以换到别的盘)。每个用户一份,Claude 和 Codex、Web 和飞书共用;改了记忆(设置里改的、后台整理的、别的对话里记的),正在跑的会话空闲下来就换上新的。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
94
94
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选专家和目录;可以设成不携带上下文,每次运行都换新会话,之前的结果还留在对话里,只是 agent 看不到),在专用对话右上角的「更多」里可以直接编辑任务、立即运行,或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。结果可以发到专用对话,也可以发到正在聊的对话(新建和编辑时都能选,也能来回切换):发到正在聊的对话时,专家和目录跟随对话,权限就是对话自己的;选「不携带上下文」时任务在独立的临时会话里运行,跑完换回聊天的会话,结果照样显示在这条对话里,下一条消息会带给 agent。
95
95
  - **技能(skills)**:设置 → 技能。技能就是 Claude Code / Codex 用的那种 SKILL.md(可以带脚本和资料),由 agent-loft 按人管理,两个 agent 都能用。**来源**:在页面上写、上传技能包(`.zip` / `.skill` / 单个 SKILL.md / 整个文件夹),或者在对话里让 agent「把刚才的做法存成技能」(agent 用 `create_skill` / `update_skill`,先弹授权卡)。**共享**:新建、编辑时选择「仅自己可见」「指定用户」或「所有人可见」,也可在自己技能的「更多 → 共享」里调整;默认仅自己可见。其他用户在「共享技能」中查看正文和附带文件、安装;安装后出现在「我的技能」,可停用、卸载或重新安装。安装的是作者的同一份技能,更新自动跟随;作者撤回共享后,范围外用户不再可用。只有作者能编辑,管理员可下架自己看得到的共享技能。共享不包含作者填写的变量和密钥,每人使用自己的配置。**使用**:内置专家默认使用你启用的全部技能,也可以在「设置 → Agent」中分别指定 Claude Code / Codex 加载哪些技能;自定义专家只用它选中的;agent 遇到对得上的事自己用。**变量**:技能可以声明要用的环境变量(接口地址、密钥),每个人填自己的值,只注入自己的会话;密钥再写上「只允许发往」的地址就成了**受保护的密钥**——不进环境变量,agent 看不到值,只能用 `skill_request` 工具让 agent-loft 代发请求(在地址、请求头、请求体里写 `{{变量名}}`),只发往你确认过的地址、不跟随跳转、响应里出现的值会被抹掉;作者后来改了地址,要你再确认一次才放行。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「设置 → 技能 → 本机技能」里能看到。
96
+ - **工作区面板**:会话顶栏右侧的面板按钮,在对话旁边(手机上全屏)看和改这条会话工作目录里的文件。「文件」页签是一棵按需展开的文件树,图片、PDF、音视频、Markdown、网页、代码直接预览,CSV / TSV 显示成表格;文本文件(1 MB 以内、UTF-8)可以编辑,Ctrl / ⌘ + S 保存,Markdown 和 CSV 能预览没保存的内容。还能新建、重命名、上传(点按钮或拖到面板上)、删除。保存时如果文件在你编辑期间被 agent 或别人改过,不会覆盖,由你选覆盖还是重新加载;没保存的内容存在本机,换会话、刷新页面都不丢。「改动」页签是 Git 仓库的已暂存 / 未暂存 / 未跟踪文件,点开看 diff,宽度够时可以切并排;顶栏的分支标记显示当前分支和改动数,点面板里的分支行能查看和切换本地、远程分支,也能新建分支。文件行上可以暂存、取消暂存、丢弃改动,写好说明提交已暂存的内容(默认不运行 Git 钩子,要用的话勾上);「历史」页签看提交记录和每个提交的 diff。推送、拉取、合并、变基请交给 agent 或终端。一轮结束、切回窗口时自动刷新。
97
+ - 每轮改动:在 Git 仓库里,一轮对话改了文件,回复下面会有一张「改了 3 个文件 +45 −12」的卡片,点文件直接看这一轮的 diff,之后文件再变也不影响;点标题还能「撤销这一轮」,把这一轮动过的文件恢复成开始前的样子,别的文件不动,也能重做(文件之后又被改过会先提醒你)。刷新页面、飞书发起的对话在 Web 上打开也都看得到。靠的是这一轮开始前后各拍一张工作区快照来比较,agent 用工具改的、用命令改的都算在内,Claude Code 和 Codex 一样。工作区是共用的,这一轮期间你自己改的也会算进来;同一仓库里还有别的会话在跑时,卡片上会提示可能混入它们的改动。不是 Git 仓库的目录没有卡片。
98
+ - 管理员能用;成员要管理员在 设置 → 用户 里单独「开通工作区面板」。
96
99
  - **资料库**:像 ChatGPT 的资料库,侧栏的「资料库」。对话里发过的附件、agent 回复里给出的、这一轮新写出来的图片 / 文档 / 音视频(复制一份收进来,之后原文件改了删了不影响)都汇总在这里:按图片 / 文档 / 音视频筛、按文件名搜,点开看大图或下载,「在新对话里用」,单个或批量删除(文件从磁盘上删掉)。从资料库拿到对话里的文件硬链接进那条对话的上传目录,不占双份空间,agent 照常能读。按人隔离,规则同对话:自己的;没主人的对话(飞书群聊等)的归管理员。上传了一直没发出去的一天后清掉;删除会话时立即清理该会话的上传文件和资料库记录,删除原件也会清理复用到其他会话的副本。agent 侧的会话记录仍保留,恢复会话不会恢复已删除的文件。
97
100
  - **远程控制**:侧栏「定时任务」下面的「远程控制」,直接操作这台机器的**桌面**和**终端**,上面一键切换;切回对话时连接留在后台(侧栏入口上亮个小绿点),再进来接着用。这台机器没有图形桌面(服务器、NAS)时只有终端。
98
101
  - 桌面:走 VNC 协议,网页里用 noVNC 显示,鼠标、键盘、剪贴板都能用,进来时不自动连、点「连接桌面」才连,工具栏上选画质:流畅 / 标准(默认)/ 高清由服务端把画面缩小到长边 1280 / 1920 / 2560、只把变了的地方压成 JPEG 发过来(macOS 屏幕共享只给无损的 ZRLE,5K 屏一整屏 30MB,原样转发隔着公网几秒一帧),原画是原样转发、只适合局域网;远程那边接了几块屏时可以只看其中一块(按系统里的显示器名称选,服务端只截那块再缩,比几块屏拼在一起缩小清楚得多;macOS 的各块屏位置要从屏幕共享发来的画面里学,第一次连上要几秒,原画下不能选);可以缩放到窗口或按原始大小看、全屏(手机上也能,iPhone 上是铺满页面)、「只看不控制」、发送 Ctrl+Alt+Del 之类的组合键。手机上有两种手势(右上角切换,「?」看说明):**触控板模式**(默认)屏幕上有个指针,单指滑动移动、轻点单击、双指轻点右键、长按后拖动是按住左键拖、双指滑动滚动;**触摸模式**点哪就点哪。两种模式都能双指捏合在本地放大画面(放大后小按钮也点得准,右下角「还原」),画面下面一排 Esc / Tab / Ctrl / Alt / Win / 方向键,Ctrl、Alt、Win 点一下会粘住,带给下一个按键或点击;键盘按钮弹出软键盘打字,中文输入法也能用。Linux 上 agent-loft 在有人连时用 x11vnc 共享当前的桌面(Xorg 会话;只听 127.0.0.1、随机端口、每次随机密码,需要 `sudo apt install x11vnc`),没人连着 30 分钟后停掉;macOS 上在 设置 → 远程控制 里改用「已有的 VNC 服务」,接系统自带的屏幕共享:填 VNC 密码,或者屏幕共享没开 VNC 密码时填 Mac 的用户名和登录密码(苹果认证,由服务端登录)。
@@ -190,6 +193,8 @@ agent-loft service install
190
193
  - 登录态通过 HttpOnly cookie 保存,服务端只存它的哈希。同一 IP 连续输错 5 次锁 15 分钟。所有写请求和 WebSocket 都校验 Origin。页面开启了严格的 CSP。
191
194
  - 暴露到公网时,只通过 HTTPS 反向代理(比如 Lucky)或 Cloudflare Tunnel 访问,并把不在本机的反代 IP 加进 `web.trustedProxies`(只有从这些地址来的连接才采信 `X-Forwarded-*`)。不要直接把 8800 端口映射出去。局域网访问可以在 设置 → 系统 → 网络访问 里关掉。
192
195
  - 远程控制不经过授权卡:拿到终端就是拿到运行 agent-loft 的那个系统用户的 shell,拿到桌面就是坐在登录桌面的那个人面前。所以默认只给管理员,成员要管理员单独开通(开通时会再提醒一次);收回权限、停用或删除用户、在设置里关掉终端 / 桌面时,他开着的 shell 立刻结束、桌面立刻断开。终端和桌面的 WebSocket 和其他接口一样校验登录态和 Origin。shell 拿不到本服务自己的凭据(和 agent 子进程一样剔除环境变量)。共享桌面用的 x11vnc 只听本机、密码每次随机生成、经文件传过去(不出现在命令行里);用「已有的 VNC 服务」时,配置里的 VNC 密码会交给开通了远程控制的人的页面;填了 Mac 用户名走苹果认证时由服务端登录,登录密码不会发到页面(但和 VNC 密码一样明文存在 config.json 里)。
196
+ - 工作区面板只能操作会话工作目录之内的东西:路径写法跳不出工作目录,符号链接解析后跳不出工作区根目录,敏感文件(私钥、`.env`、云凭据、agent-loft 自己的数据)和 `.git` 目录不显示,读写、新建、改名、删除都不行;有改动的敏感文件只标记,不给 diff 内容。diff 只接受当前改动列表里的文件。面板里的文件操作不经过授权卡,删除不能恢复(有二次确认);删除文件夹会连带里面看不到的隐藏文件、敏感文件和 `.git`。别的会话正在用的工作目录不能在这里删除或改名。因为成员能在工作区任意目录开对话,开通面板约等于能读写整个工作区,所以默认只给管理员。仓库里的配置不可信:调用 git 不经过 shell,并关掉 `core.fsmonitor`、`diff.external`、textconv、钩子和仓库自己定义的 filter,不会执行仓库配置里的程序(包括 `include` 进来的配置);git 子进程拿不到本服务自己的环境变量,也不连网,部分克隆缺的内容不会去懒加载,这种仓库里有些历史 diff 可能看不了;工作树(`core.worktree`)不在工作区之内的仓库不算数,也不会向上找到工作区之外的仓库。提交时只有勾选「运行 Git 钩子」才跑钩子;`.git/config` 里配了签名相关设置时这次提交不签名,只用全局配置的才签名。配了自定义 filter 的仓库(git-crypt 之类)不做快照,面板里也不能暂存、丢弃、提交、切分支,请在终端里操作:不跑 filter 的话,暂存就是把明文写进去。敏感文件不能在面板里暂存、丢弃、提交;嵌在仓库里的另一个仓库也不能在面板里暂存或丢弃。agent 正在这个仓库里干活时,不能丢弃、切分支、撤销一轮。
197
+ - 每轮改动的快照是写进这个仓库 `.git` 里的对象,留在 `refs/agent-loft/t/` 这些引用下,不碰你的工作区、暂存区和分支,也不会出现在 `git branch`、`git log --all` 里;默认的 `git push` 和 `git clone` 不带它们,但 `git push --mirror` 会。敏感文件、超过 20 MB 的文件不进快照;改动和未跟踪的文件超过 5000 个时这一轮不做快照。每个仓库只留最近 200 轮、60 天以内的,更早的卡片只能看统计。没开通工作区面板的成员的对话不做快照。
193
198
  - 审批超时一律按拒绝处理。Codex 默认沙箱为 `workspace-write`,不会因为 `~/.codex/config.toml` 里配了 `never` 或 `danger-full-access` 就绕过审批。
194
199
  - agent 子进程拿不到本服务自己的凭据(`FEISHU_*`、`AGENT_LOFT_*` 等环境变量会被剔除)。
195
200
  - 技能存在 `data/skills/`:技能本体在 `files/<技能 id>/`,每个人装了哪些、变量的值在 `users/<用户 id>.json`(0600)。普通变量注入到会话环境里,agent 能读到;受保护的密钥 agent 看不到值,但和多用户一样不是安全边界——能读文件的专家(包括内置的 Claude Code / Codex)能直接读这些文件。别人分享的技能会在你的会话里照着执行,装之前在技能页点开看一眼它要做什么、要哪些变量。
@@ -224,6 +229,9 @@ src/
224
229
  skill-runtime.ts 技能怎么交给 agent:Claude 的插件目录和成员白名单、Codex 的清单、自定义专家只给选中的、机器上原有的技能
225
230
  skills-bridge.ts 技能工具在主进程这头:建 / 改技能(弹授权卡)、skill_request 代发带密钥的请求
226
231
  terminals.ts 网页终端:用 node-pty 起 shell、留最近的输出给重连补发、没人连着到点结束、权限收回时结束
232
+ workspace-files.ts 工作区面板的文件部分:列目录、编辑保存、新建改名删除上传(路径范围和敏感文件的规矩)
233
+ git.ts 工作区面板的 Git 部分:分支、改动列表、diff、分支列表、快照,关掉仓库配置里能跑程序的项
234
+ turn-changes.ts 每轮对话改了什么:一轮前后各拍一张快照比较,记下来,定期清理
227
235
  desktop.ts 远程桌面:找这台机器的 X 桌面、按需起 x11vnc(或用已有的 VNC 服务)、没人连着到点停掉
228
236
  vnc-auth.ts 由服务端登录 VNC(苹果认证、VNC 密码、不用认证),对页面装成不用认证的
229
237
  vnc-transcode.ts 远程桌面转码:服务端当 VNC 客户端收全分辨率画面,缩小、只把变了的格子压成 JPEG 按 Tight 发给页面
@@ -262,4 +270,5 @@ npm install
262
270
  npm run dev # AGENT_LOFT_HOME=./.dev,改代码自动重启
263
271
  npm test
264
272
  npm run typecheck
273
+ npm run build:editor # 升级 CodeMirror、加语言后重新打包 web/vendor-built/codemirror.js(产物提交进仓库)
265
274
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.90",
3
+ "version": "0.2.93",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -41,6 +41,7 @@
41
41
  "dev": "AGENT_LOFT_HOME=./.dev tsx watch src/main.ts",
42
42
  "typecheck": "tsc --noEmit",
43
43
  "test": "node --import tsx --test test/*.test.ts",
44
+ "build:editor": "node scripts/build-editor.mjs",
44
45
  "prepublishOnly": "npm run typecheck"
45
46
  },
46
47
  "dependencies": {
@@ -60,9 +61,30 @@
60
61
  "ws": "^8.18.0"
61
62
  },
62
63
  "devDependencies": {
64
+ "@codemirror/commands": "^6.11.1",
65
+ "@codemirror/lang-cpp": "^6.0.3",
66
+ "@codemirror/lang-css": "^6.3.1",
67
+ "@codemirror/lang-go": "^6.0.1",
68
+ "@codemirror/lang-html": "^6.4.12",
69
+ "@codemirror/lang-java": "^6.0.2",
70
+ "@codemirror/lang-javascript": "^6.2.5",
71
+ "@codemirror/lang-json": "^6.0.2",
72
+ "@codemirror/lang-markdown": "^6.5.2",
73
+ "@codemirror/lang-python": "^6.2.1",
74
+ "@codemirror/lang-rust": "^6.0.2",
75
+ "@codemirror/lang-sql": "^6.10.0",
76
+ "@codemirror/lang-xml": "^6.1.0",
77
+ "@codemirror/lang-yaml": "^6.1.3",
78
+ "@codemirror/language": "^6.13.1",
79
+ "@codemirror/legacy-modes": "^6.5.5",
80
+ "@codemirror/state": "^6.7.6",
81
+ "@codemirror/theme-one-dark": "^6.1.3",
82
+ "@codemirror/view": "^6.43.15",
63
83
  "@types/node": "^24.10.1",
64
84
  "@types/qrcode": "^1.5.6",
65
85
  "@types/ws": "^8.5.12",
86
+ "codemirror": "^6.0.2",
87
+ "esbuild": "^0.28.2",
66
88
  "typescript": "^5.9.3"
67
89
  },
68
90
  "publishConfig": {
@@ -11,12 +11,12 @@ import { approve, listApproved, listPending, revoke } from "../../core/pairing.j
11
11
  import { agentBinding, conversationLabels, getConversation, listConversations, touchConversation, updateConversation } from "../../core/store.js";
12
12
  import { addScheduled, clearScheduled, removeScheduled } from "../../core/scheduled.js";
13
13
  import { resolveUploadFile, saveBuffer, sniff, uploadKeyOf } from "../../core/uploads.js";
14
- import { mentions, replyFileType, resolveReplyFile } from "../../core/reply-files.js";
15
- import { HTML_CSP, HTML_MAX, htmlDocument } from "../../core/visualize.js";
16
- import { cleanServers, ownFrameAncestors, shellInfo } from "../../core/servers.js";
14
+ import { mentions, resolveReplyFile } from "../../core/reply-files.js";
15
+ import { cleanServers, shellInfo } from "../../core/servers.js";
17
16
  import {
18
17
  createUser,
19
18
  getUser,
19
+ canUseFiles,
20
20
  isAdmin,
21
21
  legacyOwnerId,
22
22
  listUsers,
@@ -98,6 +98,8 @@ import { botExpertSelection } from "../../core/feishu-experts.js";
98
98
  import { expertBrief } from "./experts-api.js";
99
99
  import { handleTerminalApi } from "./terminal.js";
100
100
  import { handleDesktopApi, remoteStatus } from "./desktop.js";
101
+ import { serveHtmlFile, serveReplyFile } from "./file-serve.js";
102
+ import { handleWorkspaceApi } from "./workspace-api.js";
101
103
  import {
102
104
  addRelaySubscription,
103
105
  addSubscription,
@@ -246,51 +248,6 @@ async function replyMentions(key: string, requested: string): Promise<boolean> {
246
248
  * 回复里的文件:stat=1 只回名字和大小;其余返回内容,支持 Range(视频拖进度、iOS 放视频都要它)。
247
249
  * 图片、PDF、音视频按类型 inline,别的一律当下载 —— HTML 之类不能在本站域名下被当网页打开
248
250
  */
249
- function serveReplyFile(req: IncomingMessage, res: ServerResponse, file: string, opts: { stat: boolean; download: boolean }): void {
250
- const st = fs.statSync(file);
251
- const name = path.basename(file);
252
- if (opts.stat) {
253
- sendJson(res, 200, { name, path: file, size: st.size, mtime: st.mtimeMs });
254
- return;
255
- }
256
- const type = replyFileType(file);
257
- const inline = !opts.download && !!type;
258
- const headers: Record<string, string | number> = {
259
- ...SECURITY_HEADERS,
260
- "Content-Type": inline ? type! : "application/octet-stream",
261
- "Content-Disposition": `${inline ? "inline" : "attachment"}; filename*=UTF-8''${encodeURIComponent(name)}`,
262
- "Accept-Ranges": "bytes",
263
- "Cache-Control": "private, no-cache",
264
- "Last-Modified": new Date(st.mtimeMs).toUTCString(),
265
- };
266
- if (type === "application/pdf") {
267
- // 预览窗里用 iframe 嵌 PDF:要允许本站嵌入。Chrome 带 sandbox 的文档不显示 PDF,这里不加
268
- // (所有接口的响应事先都带上了 SECURITY_HEADERS,见 server.ts,这里得把那个也去掉)
269
- delete headers["X-Frame-Options"];
270
- res.removeHeader("X-Frame-Options");
271
- headers["Content-Security-Policy"] = `default-src 'none'; frame-ancestors ${ownFrameAncestors(config().servers)}`;
272
- } else {
273
- headers["Content-Security-Policy"] = "default-src 'none'; img-src 'self'; media-src 'self'; style-src 'unsafe-inline'; sandbox";
274
- }
275
- const range = /^bytes=(\d*)-(\d*)$/.exec(String(req.headers.range ?? ""));
276
- if (range && (range[1] || range[2])) {
277
- let start = range[1] ? Number(range[1]) : Math.max(0, st.size - Number(range[2]));
278
- let end = range[1] && range[2] ? Math.min(Number(range[2]), st.size - 1) : st.size - 1;
279
- if (start >= st.size || start > end) {
280
- res.writeHead(416, { ...headers, "Content-Range": `bytes */${st.size}` });
281
- res.end();
282
- return;
283
- }
284
- start = Math.max(0, start);
285
- end = Math.max(start, end);
286
- res.writeHead(206, { ...headers, "Content-Range": `bytes ${start}-${end}/${st.size}`, "Content-Length": end - start + 1 });
287
- fs.createReadStream(file, { start, end }).pipe(res);
288
- return;
289
- }
290
- res.writeHead(200, { ...headers, "Content-Length": st.size });
291
- fs.createReadStream(file).pipe(res);
292
- }
293
-
294
251
  // ---------- 飞书扫码创建应用 ----------
295
252
 
296
253
  type Registration = {
@@ -535,8 +492,8 @@ function adminOnly(p: string): boolean {
535
492
  );
536
493
  }
537
494
 
538
- function publicMe(user: Pick<User, "id" | "name" | "role">) {
539
- return { id: user.id, name: user.name, role: user.role };
495
+ function publicMe(user: Pick<User, "id" | "name" | "role" | "disabled" | "files">) {
496
+ return { id: user.id, name: user.name, role: user.role, ...(canUseFiles(user) ? { files: true } : {}) };
540
497
  }
541
498
 
542
499
  /** users.ts 抛的是给人看的错误,转成 400 */
@@ -1006,6 +963,8 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1006
963
  // 别人的会话:当它不存在
1007
964
  if (!visible(conv)) throw new HttpError(404, "会话不存在");
1008
965
 
966
+ if (sub && (await handleWorkspaceApi(req, res, url, sub, conv, user))) return;
967
+
1009
968
  if (sub === "continue" && method === "POST") {
1010
969
  const body = await readJsonBody<{ agent?: unknown; sessionId?: unknown }>(req);
1011
970
  const binding = agentBinding(conv);
@@ -1143,19 +1102,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1143
1102
  const requested = url.searchParams.get("path") ?? "";
1144
1103
  const file = resolveReplyFile(requested, conv.cwd);
1145
1104
  if (!file || !/\.html?$/i.test(file) || !(await replyMentions(key, requested))) throw new HttpError(404, "文件不存在,或者不能查看");
1146
- if (fs.statSync(file).size > HTML_MAX) throw new HttpError(413, "文件太大,下载下来看吧");
1147
- const doc = Buffer.from(htmlDocument(fs.readFileSync(file, "utf8"), path.basename(file)));
1148
- // 要能嵌进对话里:去掉所有响应默认带的 X-Frame-Options(见 server.ts)
1149
- res.removeHeader("X-Frame-Options");
1150
- res.writeHead(200, {
1151
- "X-Content-Type-Options": "nosniff",
1152
- "Referrer-Policy": "no-referrer",
1153
- "Content-Security-Policy": HTML_CSP.replace("frame-ancestors 'self'", `frame-ancestors ${ownFrameAncestors(config().servers)}`),
1154
- "Content-Type": "text/html; charset=utf-8",
1155
- "Content-Length": doc.length,
1156
- "Cache-Control": "private, no-cache",
1157
- });
1158
- res.end(doc);
1105
+ serveHtmlFile(res, file);
1159
1106
  return;
1160
1107
  }
1161
1108
  if (sub === "upload" && method === "POST") {
@@ -1749,11 +1696,11 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1749
1696
  }
1750
1697
  }
1751
1698
  if (p === "/api/users" && method === "POST") {
1752
- const body = await readJsonBody<{ name?: string; password?: string; role?: Role; remote?: boolean; permissions?: unknown }>(req);
1699
+ const body = await readJsonBody<{ name?: string; password?: string; role?: Role; remote?: boolean; files?: boolean; permissions?: unknown }>(req);
1753
1700
  sendJson(
1754
1701
  res,
1755
1702
  200,
1756
- userOp(() => createUser({ name: String(body.name ?? ""), password: String(body.password ?? ""), role: body.role === "admin" ? "admin" : "member", ...(typeof body.remote === "boolean" ? { remote: body.remote } : {}), ...(body.permissions !== undefined ? { permissions: body.permissions } : {}) })),
1703
+ userOp(() => createUser({ name: String(body.name ?? ""), password: String(body.password ?? ""), role: body.role === "admin" ? "admin" : "member", ...(typeof body.remote === "boolean" ? { remote: body.remote } : {}), ...(typeof body.files === "boolean" ? { files: body.files } : {}), ...(body.permissions !== undefined ? { permissions: body.permissions } : {}) })),
1757
1704
  );
1758
1705
  return;
1759
1706
  }
@@ -1762,7 +1709,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1762
1709
  const id = userMatch[1]!;
1763
1710
  if (!getUser(id)) throw new HttpError(404, "用户不存在");
1764
1711
  if (method === "PATCH") {
1765
- const body = await readJsonBody<{ name?: string; role?: Role; disabled?: boolean; password?: string; remote?: boolean; permissions?: unknown }>(req);
1712
+ const body = await readJsonBody<{ name?: string; role?: Role; disabled?: boolean; password?: string; remote?: boolean; files?: boolean; permissions?: unknown }>(req);
1766
1713
  if (id === user.id && (body.disabled === true || (body.role !== undefined && body.role !== "admin"))) {
1767
1714
  throw new HttpError(400, "不能停用自己,也不能取消自己的管理员");
1768
1715
  }
@@ -1774,6 +1721,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1774
1721
  ...(typeof body.disabled === "boolean" ? { disabled: body.disabled } : {}),
1775
1722
  ...(typeof body.password === "string" ? { password: body.password } : {}),
1776
1723
  ...(typeof body.remote === "boolean" ? { remote: body.remote } : {}),
1724
+ ...(typeof body.files === "boolean" ? { files: body.files } : {}),
1777
1725
  ...(body.permissions !== undefined ? { permissions: body.permissions } : {}),
1778
1726
  }),
1779
1727
  );
@@ -0,0 +1,72 @@
1
+ // 把工作目录里的文件发给浏览器:预览(支持 Range)、下载,以及放进沙箱显示的网页。
2
+ // 谁能看哪个文件由调用方判断(回复里的文件见 api.ts,工作区面板见 workspace-api.ts),这里只管怎么发、响应头怎么带。
3
+ import fs from "node:fs";
4
+ import path from "node:path";
5
+ import type { IncomingMessage, ServerResponse } from "node:http";
6
+ import { config } from "../../core/config.js";
7
+ import { replyFileType } from "../../core/reply-files.js";
8
+ import { ownFrameAncestors } from "../../core/servers.js";
9
+ import { HTML_CSP, HTML_MAX, htmlDocument } from "../../core/visualize.js";
10
+ import { HttpError, SECURITY_HEADERS, sendJson } from "./http.js";
11
+
12
+ export function serveReplyFile(req: IncomingMessage, res: ServerResponse, file: string, opts: { stat: boolean; download: boolean }): void {
13
+ const st = fs.statSync(file);
14
+ const name = path.basename(file);
15
+ if (opts.stat) {
16
+ sendJson(res, 200, { name, path: file, size: st.size, mtime: st.mtimeMs });
17
+ return;
18
+ }
19
+ const type = replyFileType(file);
20
+ const inline = !opts.download && !!type;
21
+ const headers: Record<string, string | number> = {
22
+ ...SECURITY_HEADERS,
23
+ "Content-Type": inline ? type! : "application/octet-stream",
24
+ "Content-Disposition": `${inline ? "inline" : "attachment"}; filename*=UTF-8''${encodeURIComponent(name)}`,
25
+ "Accept-Ranges": "bytes",
26
+ "Cache-Control": "private, no-cache",
27
+ "Last-Modified": new Date(st.mtimeMs).toUTCString(),
28
+ };
29
+ if (type === "application/pdf") {
30
+ // 预览窗里用 iframe 嵌 PDF:要允许本站嵌入。Chrome 带 sandbox 的文档不显示 PDF,这里不加
31
+ // (所有接口的响应事先都带上了 SECURITY_HEADERS,见 server.ts,这里得把那个也去掉)
32
+ delete headers["X-Frame-Options"];
33
+ res.removeHeader("X-Frame-Options");
34
+ headers["Content-Security-Policy"] = `default-src 'none'; frame-ancestors ${ownFrameAncestors(config().servers)}`;
35
+ } else {
36
+ headers["Content-Security-Policy"] = "default-src 'none'; img-src 'self'; media-src 'self'; style-src 'unsafe-inline'; sandbox";
37
+ }
38
+ const range = /^bytes=(\d*)-(\d*)$/.exec(String(req.headers.range ?? ""));
39
+ if (range && (range[1] || range[2])) {
40
+ let start = range[1] ? Number(range[1]) : Math.max(0, st.size - Number(range[2]));
41
+ let end = range[1] && range[2] ? Math.min(Number(range[2]), st.size - 1) : st.size - 1;
42
+ if (start >= st.size || start > end) {
43
+ res.writeHead(416, { ...headers, "Content-Range": `bytes */${st.size}` });
44
+ res.end();
45
+ return;
46
+ }
47
+ start = Math.max(0, start);
48
+ end = Math.max(start, end);
49
+ res.writeHead(206, { ...headers, "Content-Range": `bytes ${start}-${end}/${st.size}`, "Content-Length": end - start + 1 });
50
+ fs.createReadStream(file, { start, end }).pipe(res);
51
+ return;
52
+ }
53
+ res.writeHead(200, { ...headers, "Content-Length": st.size });
54
+ fs.createReadStream(file).pipe(res);
55
+ }
56
+
57
+ /** 网页(Codex visualize 画的图表、agent 写的网页):套好外壳放进沙箱显示 */
58
+ export function serveHtmlFile(res: ServerResponse, file: string): void {
59
+ if (fs.statSync(file).size > HTML_MAX) throw new HttpError(413, "文件太大,下载下来看吧");
60
+ const doc = Buffer.from(htmlDocument(fs.readFileSync(file, "utf8"), path.basename(file)));
61
+ // 要能嵌进对话里:去掉所有响应默认带的 X-Frame-Options(见 server.ts)
62
+ res.removeHeader("X-Frame-Options");
63
+ res.writeHead(200, {
64
+ "X-Content-Type-Options": "nosniff",
65
+ "Referrer-Policy": "no-referrer",
66
+ "Content-Security-Policy": HTML_CSP.replace("frame-ancestors 'self'", `frame-ancestors ${ownFrameAncestors(config().servers)}`),
67
+ "Content-Type": "text/html; charset=utf-8",
68
+ "Content-Length": doc.length,
69
+ "Cache-Control": "private, no-cache",
70
+ });
71
+ res.end(doc);
72
+ }
@@ -0,0 +1,249 @@
1
+ // 工作区面板的接口:/api/conversations/<key>/<workspace-… | git-…>。都不经过授权卡:是用户自己点的操作。
2
+ //
3
+ // 一律按会话定位,不接受前端传的目录:调用方(api.ts)已经核对过能看这条会话,这里再看账号开没开通面板。
4
+ // 路径都是相对路径:workspace-* 相对会话的工作目录,git-* 相对仓库根目录。
5
+ import fs from "node:fs";
6
+ import path from "node:path";
7
+ import type { IncomingMessage, ServerResponse } from "node:http";
8
+ import {
9
+ commitFileDiff,
10
+ commitFiles,
11
+ findRepo,
12
+ gitBranches,
13
+ gitCommit,
14
+ gitCreateBranch,
15
+ gitDiff,
16
+ gitDiscard,
17
+ GitError,
18
+ gitLog,
19
+ gitStage,
20
+ gitStatus,
21
+ gitSwitch,
22
+ gitUnstage,
23
+ } from "../../core/git.js";
24
+ import { hub } from "../../core/hub.js";
25
+ import { revertTurn, turnFileDiff, turnState } from "../../core/turn-changes.js";
26
+ import { listConversations, type Conversation } from "../../core/store.js";
27
+ import { canUseFiles, type User } from "../../core/users.js";
28
+ import {
29
+ createWorkspaceEntry,
30
+ deleteWorkspaceEntry,
31
+ listWorkspaceEntries,
32
+ readWorkspaceText,
33
+ renameWorkspaceEntry,
34
+ resolveWorkspaceFile,
35
+ SAVE_MAX_BYTES,
36
+ saveWorkspaceText,
37
+ UPLOAD_MAX_BYTES,
38
+ uploadWorkspaceFile,
39
+ workspaceDir,
40
+ WorkspaceError,
41
+ } from "../../core/workspace-files.js";
42
+ import { serveHtmlFile, serveReplyFile } from "./file-serve.js";
43
+ import { HttpError, readBody, readJsonBody, sendJson } from "./http.js";
44
+
45
+ /** 路由 → 方法 */
46
+ const ROUTES: Record<string, string> = {
47
+ "workspace-tree": "GET",
48
+ "workspace-file": "GET",
49
+ "workspace-html": "GET",
50
+ "workspace-text": "GET",
51
+ "git-status": "GET",
52
+ "git-diff": "GET",
53
+ "git-branches": "GET",
54
+ "git-turn-diff": "GET",
55
+ "git-turn-state": "GET",
56
+ "git-log": "GET",
57
+ "git-commit-files": "GET",
58
+ "git-commit-diff": "GET",
59
+ "git-stage": "POST",
60
+ "git-unstage": "POST",
61
+ "git-discard": "POST",
62
+ "git-commit": "POST",
63
+ "git-switch": "POST",
64
+ "git-branch-new": "POST",
65
+ "git-turn-revert": "POST",
66
+ "workspace-save": "POST",
67
+ "workspace-new": "POST",
68
+ "workspace-rename": "POST",
69
+ "workspace-delete": "POST",
70
+ "workspace-upload": "POST",
71
+ };
72
+
73
+ /** 所有会话的工作目录(解析符号链接后):改名、删除时不能把它们弄没了 */
74
+ function conversationDirs(): string[] {
75
+ const dirs = new Set<string>();
76
+ for (const c of listConversations()) {
77
+ // 已删除的会话不用管
78
+ if (c.hidden) continue;
79
+ try {
80
+ dirs.add(fs.realpathSync(c.cwd));
81
+ } catch {
82
+ // 目录已经没了
83
+ }
84
+ }
85
+ return [...dirs];
86
+ }
87
+
88
+ function asString(value: unknown): string {
89
+ return typeof value === "string" ? value : "";
90
+ }
91
+
92
+ /** 文件操作的错误带着状态码和冲突类型 */
93
+ function fileOp<T>(res: ServerResponse, status: number, op: () => T): void {
94
+ try {
95
+ sendJson(res, status, op());
96
+ } catch (err) {
97
+ if (!(err instanceof WorkspaceError)) throw err;
98
+ sendJson(res, err.status, { error: err.message, ...err.extra });
99
+ }
100
+ }
101
+
102
+ /** git 自己报的错(仓库坏了、超时):照实告诉页面 */
103
+ async function gitOp<T>(op: () => Promise<T>): Promise<T> {
104
+ try {
105
+ return await op();
106
+ } catch (err) {
107
+ if (err instanceof GitError) throw err;
108
+ throw new HttpError(500, err instanceof Error ? err.message : String(err));
109
+ }
110
+ }
111
+
112
+ /** 这些操作会大面积改工作区:agent 正在这个仓库里干活时不能做,否则它接下来的动作都建立在错的文件上 */
113
+ function assertIdle(root: string): void {
114
+ if (hub.busyInRepo(null, root)) throw new GitError(409, "agent 正在这个仓库里干活,等这一轮结束再操作");
115
+ }
116
+
117
+ /** 用户点的 Git 操作:返回结果,错误带着状态码和页面要用的信息(比如冲突的文件) */
118
+ async function gitAction(res: ServerResponse, op: () => Promise<unknown>): Promise<void> {
119
+ try {
120
+ sendJson(res, 200, (await op()) ?? { ok: true });
121
+ } catch (err) {
122
+ if (err instanceof GitError) sendJson(res, err.status, { error: err.message, ...err.extra });
123
+ else throw err;
124
+ }
125
+ }
126
+
127
+ export async function handleWorkspaceApi(req: IncomingMessage, res: ServerResponse, url: URL, sub: string, conv: Conversation, user: User): Promise<boolean> {
128
+ if (ROUTES[sub] !== req.method) return false;
129
+ if (!canUseFiles(user)) throw new HttpError(403, "你没有使用工作区面板的权限,找管理员在 设置 → 用户 里开通");
130
+ const cwd = workspaceDir(conv.cwd);
131
+ if (!cwd) throw new HttpError(404, "工作目录不存在,或不在工作区之内");
132
+ const requested = url.searchParams.get("path") ?? "";
133
+
134
+ if (sub === "workspace-text") {
135
+ fileOp(res, 200, () => readWorkspaceText(cwd, requested));
136
+ return true;
137
+ }
138
+ if (sub === "workspace-save") {
139
+ // JSON 转义后可能比原文大不少,留点余量;真正的大小在下面按内容算
140
+ const body = await readJsonBody<{ path?: unknown; content?: unknown; baseHash?: unknown; force?: unknown }>(req, SAVE_MAX_BYTES * 2);
141
+ if (typeof body.content !== "string") throw new HttpError(400, "缺少文件内容");
142
+ if (Buffer.byteLength(body.content) > SAVE_MAX_BYTES) throw new HttpError(413, "内容太大,不能保存");
143
+ fileOp(res, 200, () =>
144
+ saveWorkspaceText(cwd, asString(body.path), body.content as string, { baseHash: asString(body.baseHash), force: body.force === true }),
145
+ );
146
+ return true;
147
+ }
148
+ if (sub === "workspace-new") {
149
+ const body = await readJsonBody<{ dir?: unknown; name?: unknown; type?: unknown }>(req);
150
+ fileOp(res, 201, () => createWorkspaceEntry(cwd, asString(body.dir), body.name, body.type));
151
+ return true;
152
+ }
153
+ if (sub === "workspace-rename") {
154
+ const body = await readJsonBody<{ path?: unknown; name?: unknown }>(req);
155
+ fileOp(res, 200, () => renameWorkspaceEntry(cwd, asString(body.path), body.name, conversationDirs()));
156
+ return true;
157
+ }
158
+ if (sub === "workspace-delete") {
159
+ const body = await readJsonBody<{ path?: unknown }>(req);
160
+ fileOp(res, 200, () => {
161
+ deleteWorkspaceEntry(cwd, asString(body.path), conversationDirs());
162
+ return { ok: true };
163
+ });
164
+ return true;
165
+ }
166
+ if (sub === "workspace-upload") {
167
+ const data = await readBody(req, UPLOAD_MAX_BYTES);
168
+ fileOp(res, 201, () =>
169
+ uploadWorkspaceFile(cwd, url.searchParams.get("dir") ?? "", url.searchParams.get("name"), data, url.searchParams.get("overwrite") === "1"),
170
+ );
171
+ return true;
172
+ }
173
+ if (sub === "workspace-tree") {
174
+ const listing = listWorkspaceEntries(cwd, requested);
175
+ if (!listing) throw new HttpError(404, "目录不存在,或者不能查看");
176
+ sendJson(res, 200, listing);
177
+ return true;
178
+ }
179
+ if (sub === "workspace-file" || sub === "workspace-html") {
180
+ const file = resolveWorkspaceFile(cwd, requested);
181
+ if (!file || (sub === "workspace-html" && !/\.html?$/i.test(file))) throw new HttpError(404, "文件不存在,或者不能查看");
182
+ if (sub === "workspace-html") serveHtmlFile(res, file);
183
+ else serveReplyFile(req, res, file, { stat: url.searchParams.get("stat") === "1", download: url.searchParams.get("download") === "1" });
184
+ return true;
185
+ }
186
+
187
+ const repo = await findRepo(cwd);
188
+ if (!repo.repo) {
189
+ if (sub !== "git-status") throw new HttpError(404, "当前目录不是 git 仓库");
190
+ sendJson(res, 200, repo);
191
+ return true;
192
+ }
193
+ if (sub === "git-status") {
194
+ const status = await gitOp(() => gitStatus(repo.root));
195
+ // 工作目录在仓库里的位置:页面拿仓库路径(相对根目录)去开文件(相对工作目录)时要换算
196
+ sendJson(res, 200, { repo: true, ...status, prefix: path.relative(repo.root, fs.realpathSync(cwd)).split(path.sep).join("/") });
197
+ return true;
198
+ }
199
+ if (sub === "git-diff") {
200
+ const diff = await gitOp(() => gitDiff(repo.root, requested, url.searchParams.get("staged") === "1"));
201
+ if (!diff) throw new HttpError(404, "这个文件现在没有这种改动");
202
+ sendJson(res, 200, diff);
203
+ return true;
204
+ }
205
+ if (req.method === "POST") {
206
+ const body = await readJsonBody<{ paths?: unknown; message?: unknown; hooks?: unknown; branch?: unknown; name?: unknown; id?: unknown; direction?: unknown; force?: unknown }>(req);
207
+ const root = repo.root;
208
+ await gitAction(res, async () => {
209
+ if (sub === "git-stage") return gitStage(root, body.paths);
210
+ if (sub === "git-unstage") return gitUnstage(root, body.paths);
211
+ if (sub === "git-commit") return gitCommit(root, body.message, { hooks: body.hooks === true });
212
+ assertIdle(root);
213
+ if (sub === "git-discard") return gitDiscard(root, body.paths);
214
+ if (sub === "git-switch") return gitSwitch(root, body.branch);
215
+ if (sub === "git-branch-new") return gitCreateBranch(root, body.name);
216
+ return revertTurn(root, asString(body.id), body.direction === "redo" ? "redo" : "undo", body.force === true);
217
+ });
218
+ return true;
219
+ }
220
+ if (sub === "git-log") {
221
+ const skip = Math.max(0, Math.floor(Number(url.searchParams.get("skip")) || 0));
222
+ sendJson(res, 200, await gitOp(() => gitLog(repo.root, skip, 50)));
223
+ return true;
224
+ }
225
+ if (sub === "git-commit-files") {
226
+ const files = await gitOp(() => commitFiles(repo.root, url.searchParams.get("hash") ?? ""));
227
+ if (!files) throw new HttpError(404, "找不到这个提交");
228
+ sendJson(res, 200, { files });
229
+ return true;
230
+ }
231
+ if (sub === "git-commit-diff") {
232
+ const diff = await gitOp(() => commitFileDiff(repo.root, url.searchParams.get("hash") ?? "", requested));
233
+ if (!diff) throw new HttpError(404, "这个提交里没有这个文件的改动");
234
+ sendJson(res, 200, diff);
235
+ return true;
236
+ }
237
+ if (sub === "git-turn-state") {
238
+ sendJson(res, 200, await gitOp(() => turnState(repo.root, url.searchParams.get("id") ?? "")));
239
+ return true;
240
+ }
241
+ if (sub === "git-turn-diff") {
242
+ const diff = await gitOp(() => turnFileDiff(repo.root, url.searchParams.get("id") ?? "", requested));
243
+ if (!diff) throw new HttpError(404, "这一轮的快照已经清理了,看不到具体内容");
244
+ sendJson(res, 200, diff);
245
+ return true;
246
+ }
247
+ sendJson(res, 200, await gitOp(() => gitBranches(repo.root)));
248
+ return true;
249
+ }
package/src/core/db.ts CHANGED
@@ -93,6 +93,15 @@ CREATE TABLE IF NOT EXISTS footers (
93
93
  );
94
94
  CREATE INDEX IF NOT EXISTS footers_session ON footers (session_id, id);
95
95
 
96
+ CREATE TABLE IF NOT EXISTS turn_changes (
97
+ id TEXT PRIMARY KEY,
98
+ root TEXT NOT NULL,
99
+ before_tree TEXT NOT NULL,
100
+ after_tree TEXT NOT NULL,
101
+ at INTEGER NOT NULL
102
+ );
103
+ CREATE INDEX IF NOT EXISTS turn_changes_root ON turn_changes (root, at);
104
+
96
105
  CREATE TABLE IF NOT EXISTS usage_sessions (
97
106
  session_id TEXT PRIMARY KEY,
98
107
  input INTEGER NOT NULL, cache_read INTEGER NOT NULL, cache_write INTEGER NOT NULL,
@@ -194,6 +203,16 @@ export function database(): DatabaseSync {
194
203
  opened.exec("PRAGMA journal_mode = WAL");
195
204
  opened.exec("PRAGMA synchronous = NORMAL");
196
205
  opened.exec(SCHEMA);
206
+ // 旧库的 footers 表还没有这一列(列表里每轮改动的摘要,JSON)。老版本读写时不看它,降级也没事
207
+ const footerColumns = opened.prepare("PRAGMA table_info(footers)").all() as { name: string }[];
208
+ if (!footerColumns.some((c) => c.name === "changes")) {
209
+ try {
210
+ opened.exec("ALTER TABLE footers ADD COLUMN changes TEXT");
211
+ } catch (err) {
212
+ // 另一个进程(服务和命令行同时打开)刚加好了
213
+ if (!/duplicate column/i.test(String(err))) throw err;
214
+ }
215
+ }
197
216
  db = opened;
198
217
  importLegacy(opened);
199
218
  return opened;