All your AI agent sessions in one place — browse, search, resume. Rust + GPUI.
Rust
feat: index Grok Bot conversations from the desktop app's cache
Corey Chiu8fc9187e6154
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 050dabc..b9cfad9 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,5 +1,10 @@# Changelog+## [Unreleased]++- New: Grok Bot conversations show up in Wake, read from what the Grok Bot desktop app keeps on this computer — the latest messages of your recent conversations; in group chats each message shows which bot sent it. A conversation the app no longer keeps stays listed with its last message, and deleting one in Wake only hides it, since the conversation itself lives in Grok Bot's cloud+- Fix: The Settings title lines up with the window buttons and the icons below it, as the main window's title already did+## [0.9.1] — 2026-10-10- New: Codex gets the Wake plugin too: one command adds it to the Codex CLI and the Codex app, and every new Codex session then starts knowing where your agents left off in the project, with Wake's MCP tools to read earlier sessions. Settings → Connect shows it in place of the Codex hooks setup; if you added that hook to ~/.codex/config.toml, remove it so new sessions don't get the context twicediff --git a/DESIGN.md b/DESIGN.mdindex ba1ee53..72081d2 100644--- a/DESIGN.md+++ b/DESIGN.md@@ -96,21 +96,23 @@ Wake 的目标不是展示技术感,而是让用户在几秒内重新找到并**间距刻度(4px 网格)**:`SPACE_XS/SM/MD/LG/XL/XXL` = 4/8/12/16/20/24,定义在 `ui.rs`。新代码引用常量或显式 `px()`;**对齐敏感处禁用 rem 间距类**——`p_2p5` 实为 8.75px、`p_3` 实为 10.5px(rem=14 折算),均不在网格上,是对齐失真的来源。存量 rem 类已于 2026-08-24 全量迁移完毕,代码中不再允许出现 rem 间距类(`p_0` 例外,零无幽灵值)。**图标与紧随其后文字的间距只有一个值 `ICON_TEXT_GAP` = 6px**(侧栏行与组头、列表元信息行、详情 / 阅读面头部与元信息行、⌘K 结果、Insights 榜单、Open In 菜单、状态行、设置页与清理页的行;用户 2026-09-22 定统一,原先 4 / 6 / 7 / 8 / 12 各处不一);它故意不在 4px 网格上:品牌 PNG 没有留白、8px 显得空,lucide 线条图标自带约 1.5px 留白、6px 几何间距视觉约 7.5px。卡片级的 24px 头像(清理历史的记录卡)不在此列。-**侧栏中轴(x = 26.75)**:traffic lights 定位 (20,11),红灯实测直径 13.5px,中心即 **26.75**。侧栏所有行首元素的**视觉中心**压在这条竖线上,而非左缘对齐:+**侧栏中轴(x = 26.75)**:traffic lights 定位 x = 20(主窗顶距 15、设置窗 11),红灯实测直径 13.5px,中心即 **26.75**。侧栏所有行首元素的**视觉中心**压在这条竖线上,而非左缘对齐;压轴的内边距一律经 `axis_inset(行首元素宽, 容器边距)` 算出(`ui.rs`),容器的内边距与传进去的必须是同一个常量:| 元素 | 常量 | 值 | 推导 ||---|---|---:|---|| 容器内边距 | `SIDEBAR_EDGE` | 10 | 行 hover/选中胶囊的左右留白 || 行首槽位 | `LEAD_BOX` | 18 | 最大前导元素(品牌图)尺寸,槽内**居中** || 行左内边距 | `LEAD_INSET` | 7.75 | 26.75 − 9(槽位半宽) − 10 |-| 组头(Agents / Projects) | `LEAD_INSET + (LEAD_BOX − 15) / 2` | 9.25 | 15px 折叠 chevron 按自己的框居中压轴,不占 18px 槽位(2026-09-22 起;原先靠首字母字形宽度反推 `GROUP_HEAD_INSET` = 12.125,已删) |-| 标题左内边距 | `TITLE_INSET` | 9 | 由 "Wake" 的 W 反推(Heading semibold,W 宽 14.25、左承距 0.5) |+| 组头(Agents / Projects) | `axis_inset(NAV_ICON, SIDEBAR_EDGE)` | 9.25 | 15px 折叠 chevron 按自己的框居中压轴,不占 18px 槽位(2026-09-22 起;原先靠首字母字形宽度反推 `GROUP_HEAD_INSET` = 12.125,已删) |+| 标题 | `sidebar_title(…)` | 现量 | 首字字宽(advance)的一半压轴,字号字重就是标题自己的:主窗 "Wake" / "Memory"、设置窗 "Settings" 共用,换页、换语言都对得上(2026-10-11 起;原先按 "Wake" 的 W 写死 `TITLE_INSET` = 9,Memory 页与设置窗标题都偏) |+| 底部工具条 | `FOOTER_LEAD_INSET` | 12.75 | 26.75 − 14(28px 按钮半宽),工具条贴侧栏左缘、没有容器边距 |+| 设置窗导航项 | `NAV_ITEM_INSET` | 11.25 | 26.75 − 7.5(15px 图标半宽) − 8(`NAV_EDGE`,导航列容器内边距);原先 12,图标中心落在 27.5 || 分组项缩进 | `SUB_INDENT` | 12 | 分组项行首中心落在 38.75,表达从属 |三条硬约束:1. **中心对齐与左缘对齐是同一个自由度,只能满足一个。** 选了中心,18px 品牌图的左缘就落在 17.75,比红灯左缘还靠左 2.25——这是预期结果,不是错位。同理分组项一旦缩进就不再压轴。-2. **`TITLE_INSET` 不是间距,是从字形宽度反推的值**,标题的字号、字重一改立即失效,必须重新实测字形再算(组头原先同理:11px semibold 时需 13.25、Body 常规时 12.125——2026-09-22 组头改为 chevron 领头后不再依赖字形)。+2. **标题内边距不是间距,是按首字字形算出来的**:`sidebar_title` 每帧按标题实际继承的字体现量首字(标题会换页、换语言),别再写回按某个字母反推的常量(原先的 `TITLE_INSET` 与组头的 `GROUP_HEAD_INSET` 都是这么失效的——前者换成 Memory / 设置窗就偏,后者 2026-09-22 改为 chevron 领头)。量的是字宽的一半,SF Pro 首字的实际字形中心再偏右约 0.15,在下一条的光栅化步长以内。3. **2x 屏光栅化步长是 0.5px,别往小数点后继续调。** 当年组头内边距取 12.125 落位 −0.125,改成 12.25 反而跳到 +0.375——两者落进不同物理像素。全部元素落在 ±0.375 以内即为达标。**行高两级**(侧栏纵向层级的来源):主导航 `ROW_HEIGHT` 32px + Body 14,分组展开项 `ROW_HEIGHT_SUB` 26px + Caption 12。圆角均 8px。@@ -133,7 +135,7 @@ macOS 不设置横跨三栏的自定义 header。主窗口透明标题栏高 44p- **每行必须有行首元素**,由 `RowLead` 枚举强制(`Icon` 或 `Brand` 两态,无 `None`):主导航用 Lucide 单线图标,agent 行用品牌 PNG,项目行用 `folder.svg`。槽位定宽 `LEAD_BOX` 管右侧文字起点统一,槽内居中管中轴对齐。- 线条图标比实心品牌图视觉轻,同档里给小一号:分组项 Lucide 14 / 品牌图 18,主导航 Lucide 15。- 行内容 = 行首元素 + 标题 + 计数;计数一律 Label 档 muted。-- 组头 "Agents"/"Projects" 用 Body 档常规字重 + muted 色(与主导航同字号同字重,仅靠颜色区分——加粗会让组头压过它统辖的行)。行首是 13px 的折叠 chevron(收起指右、展开指下),坐在与导航行同一个 18px 行首槽位里、中心压 26.75 轴(用户 2026-09-22 定:箭头放到开头,对准上面菜单的图标与红绿灯的红灯;原先 chevron 跟在文字后);chevron 取 15px(与导航行图标同档,描边粗细一致),**不占 18px 槽位、按自己的框居中压轴**,再接统一的 `ICON_TEXT_GAP`——槽位居中再接同一间距,墨迹到文字会比导航行空出一截(chevron 墨迹只有约 5px 宽,用户同日"间隔太大");按框压轴后墨迹到文字视觉约 10.9px 与导航行相当,文字起点比导航行标签左 1.5px。+- 组头 "Agents"/"Projects" 用 Body 档常规字重 + muted 色(与主导航同字号同字重,仅靠颜色区分——加粗会让组头压过它统辖的行)。行首是 15px 的折叠 chevron(收起指右、展开指下;与导航行图标同档,描边粗细一致),中心压 26.75 轴(用户 2026-09-22 定:箭头放到开头,对准上面菜单的图标与红绿灯的红灯;原先 chevron 跟在文字后),**不占 18px 槽位、按自己的框居中压轴**,再接统一的 `ICON_TEXT_GAP`——槽位居中再接同一间距,墨迹到文字会比导航行空出一截(chevron 墨迹只有约 5px 宽,用户同日"间隔太大");按框压轴后墨迹到文字视觉约 10.9px 与导航行相当,文字起点比导航行标签左 1.5px。- 底部工具条常驻,总高 44px(含顶部 1px hairline),两端分置的**纯图标条**(2026-09-21 三轮定稿:六个一样的 ghost 图标挤一排分不出层级;带边框底色的分段盒子放在侧栏里像一个走错地方的表单控件——参照 Zed 状态栏 / Xcode 导航条,不带盒子):按钮统一 28×28、6px 圆角、14px 图标、2px 间距;**左端**——Sessions(messages-square,双气泡;单气泡的 message-square 留给消息级用途)/ Memory(brain)/ Insights(chart-column)三颗页切换,再接 brush-cleaning "Clean Up Sessions"(它是叠在会话视图上的模式,也靠左),当前页(或打开中的清理)那颗用侧栏行的选中色(`sidebar_accent` 底 + `sidebar_accent_foreground` 图标)做圆角底,与导航行选中态同一套语言;**右端只有齿轮 "Settings"**。左内边距 12.75 = 26.75(侧栏中轴)− 14(按钮半宽):最左那颗图标的中心与红绿灯红灯中心、导航行行首在同一条轴上。未选中的一律透明底、muted 图标,hover 才出色。**Refresh 不在工具条**:它住在每页页头右端(All Sessions 页头在 Sort 左侧,Memory / Insights 页头单独一个;tooltip 就叫 "Refresh"),会话页与 Insights 走整库重扫(Insights 的数据是扫描收尾派生的),Memory 页只同步记忆(读 Settings → Memory locations 的当下配置,不重扫会话;用户 2026-09-22 定各刷各的);进行中转圈并禁用,⌘R 恒为刷会话。Settings 同时进入 Wake 菜单并绑定 `⌘,`(其他平台 `Ctrl+,`),保持单例窗口。- Settings 默认 820×600,采用 180px 窄侧栏 + 内容页结构,固定为 General / Session locations / Memory locations / Remote hosts / Connect / Data / Updates / About 八项(侧栏项原叫 Locations,有了 Memory locations 后改成与页标题一致的 Session locations,用户 2026-09-21 定)(Connect 为 0.5.0 新增,插在 Remote hosts 与 Data 之间——两页都是"把 Wake 接到外部"的集成面,Data 之后是纯本地信息;Memory locations 是记忆可见层二期加的,紧挨 Locations——两页都是"Wake 读哪里");About 与功能设置分离并钉在侧栏底部,Wake 菜单的 About Wake 直达同一页。About 沿用 Kooky/Birth 的信息顺序:产品图标、名称、版本、tagline、GitHub、短分隔线、版权/许可证与作者署名。Updates 是独立功能页,仅在用户点击页面按钮或 macOS Wake 菜单的 Check for Updates 时读取 GitHub 最新正式 Release 元数据,明确呈现检查中/最新版/有新版/失败四种状态;有新版时打开 Release 页供用户下载,不后台检查、不自行覆盖应用包。内部常规文字按钮统一沿用主界面的 24px 高、6px 圆角和主题交互色,普通页面动作使用 muted 填充 + hairline;发现新版后的 View Update 是需要用户继续完成的主操作,使用 32px 高 primary 填充和轻阴影。Appearance 分段选择器也使用同一材质。General 只放真实可用的全局偏好,当前为持久化的 System / Light / Dark 外观选择与 Language(跟随系统或固定某个语言包,0.5.2 起);不提供默认 “Open In” 终端。Data 只展示 Wake 本地存储位置、会话数与磁盘占用并提供文件管理器入口,不重复放刷新或清库动作;常规 Refresh 的唯一入口仍是主侧栏底部。Locations 页按 AgentId 声明序以 agent 分组,品牌名只在组头出现一次;本机有数据的组优先,未检测到的 agent 默认收进可展开区。每条路径以路径为主信息、会话数/不可用状态为 muted 副信息,最右为逐路径开关;停用时只降低文字层级,开关与菜单保持完整对比度。行本身不承担编辑,`…` 菜单集中 Edit / Show in Finder / 自定义 Remove。顶部操作为低强调的 Add location,Restore defaults 收进页级 `…` 菜单且无偏离时禁用。添加/编辑仍复用 agent 下拉 + 可手输路径 + 目录选择表单;关闭 location 后保留配置、停止扫描/监听并从会话与搜索结果排除,重新开启即增量扫回;纯路径管理不做内容校验。**Memory locations 页与 Locations 同版式**(2026-09-21 记忆可见层二期):标题 "Memory locations" + 一句说明 + 右侧 Add location + 页级 `…` 里的 Restore defaults;按 AgentId 声明序分组,一行一个记忆来源——各家默认的(Claude 的 auto-memory 树与 `~/.claude/CLAUDE.md`、Codex 的 memories 目录、逐线程库、`~/.codex/AGENTS.md` 与 `rules/`、Gemini 的 `~/.gemini/GEMINI.md`、ZCode 的记忆树)、项目根模式(`<project>/CLAUDE.md`、`<project>/.cursor/rules` 一类,原样显示占位符)与用户加的自定义目录/文件;路径为主信息、文件数(或 "Not found")为 muted 副信息,最右逐来源开关;`…` 菜单:默认来源只有 Show in Finder(项目模式连这个也没有),自定义来源多 Edit / Remove。添加/编辑与 Session locations 是同一个表单(`open_path_form`),差别是字段叫 "Folder or file"、选择器也收文件。改动不换 roster,只补一轮增量扫描,记忆流随之更新。Remote hosts 页沿用 Locations 的版式:标题 + 说明,右侧低强调的 Sync now / Add host;host 列表为单张 popover 底圆角卡,一行一台(名字为主信息、同步状态为 muted 副信息,失败用 danger),`…` 菜单集中 Sync now / Remove,最右为开关;添加走与 location 同材质的单字段表单弹窗,SSH 前提说明放在字段下方。列表与详情页的远程会话以 `@host` 徽章标识:列表行为 primary 淡底填充胶囊(与 muted 项目胶囊区分),详情页与 model/source 同排用 primary 描边。Connect 页沿用 Data 页的版式,**只放状态与动作,不放文档**(用户 2026-09-08 三轮定稿:平级双卡带代码块、嵌套同卡、缩进从属卡都试过,根源是设置窗里塞了 README 内容,怎么排都像教程):标题 + 一句说明(不点名 MCP、不写 read-only 声明);「MCP server」卡 84px 一行显示 wake-mcp 名称与 mono 字体的 `~/…` 路径,右侧复制钮,不放"Ready"状态行,只在找不到二进制时给一行 danger 文案;「MCP clients」卡三行(Claude Code / Codex / Cursor),17px 品牌图标领行、客户端名为主信息、用法提示为 muted 副信息、右侧是 ghost 的 Show/Hide 切换(chevron 图标 + 文案,muted 前景,用户 2026-09-08 追加)加复制钮;代码块**默认收起**,展开后出现在该行下方、左缘对齐到文字轴(行内边距 16 + 图标 17 + 间距 12),secondary 填充 + 主题圆角的 mono 逐行渲染,Settings 重开即复位。0.6.x 起页面是**四个区块**(用户 2026-09-11 定稿):MCP server / MCP clients / Command line / Skill——MCP server / Command line / Skill 各一张 84px 信息卡、MCP clients 仍是三行客户端列表(wake-mcp、wake-cli 是二进制名与 mono 路径 + 复制路径的钮;wake-cli 那张在它**左侧**多一个终端图标的复制钮,复制「把它放进 PATH」的那行命令——两颗一样的复制图标并排分不清,所以换字形;最右留给两张卡同为复制路径的那颗,纵向才对得齐;deb/tar 已装进 `…/bin` 或 Windows 上没有可粘命令时这个按钮不出现;Skill 是 `npx skills add …` + 复制钮),区块标题为「Agents」时看不出这块特指 MCP,故改名 MCP clients 与上方 MCP server 成对。**说明性 caption 一律不放**——那正是"设置窗里塞 README"的复发形态;Setup guide 链接改挂在区块标题右端,规则是**每个面的第一个区块挂自己的文档**:MCP server → docs/mcp.md,Command line → docs/cli.md(MCP clients 与 Skill 分属这两个面的第二块,不重复挂)。最上面另有两块 **Claude Code plugin** / **Codex plugin**(新会话开场就知道各个 agent 停在哪,并装上 Wake 的 MCP 工具;标题用各家正名,用户 2026-10-09 定——Codex 那块起初是它官方的 hooks 配置,2026-10-10 有了 Codex 插件后改名),各是一个面、各挂自己的 Setup guide(docs/cli.md 的两节);卡是 48px 一行,只有一句用法(正文字号、前景色,与卡片标题行同一种字)+ 右端复制钮,不摆等宽命令、不加品牌图与名字行(区块标题已点名);Windows 上两块都不画。四块之后整页**超过一屏、需要滚动**——2026-09-08 那条"一屏放下"的约束随第三、四个区块作废,滚动容器本来就在(`flex_1().min_h_0().overflow_y_scroll()`),卡片记得 `flex_shrink_0` 否则会被压扁。**复制钮一律只有图标**(用户 2026-10-09 定:卡上已经摆着要复制的东西或一句用法,按钮上再写 Copy path / Copy command 是重复):与文字按钮同材质、同 24px 高的方钮,13px 图标,说明在 tooltip;复制反馈是图标原地变 check(tooltip 变 Copied)1.6s 后复原,**不弹通知**——gpui-component 的 toast 在窗口失活或被悬停时暂停自动关闭,在 Settings 从属窗里经常就挂着不走(用户 2026-09-08 反馈),且主界面的 Copy Session ID / Copy code 本来就不弹;页面只展示不代写别家配置。- 工具条内的**状态行"常态沉默"**:仅刷新中或监听不可用时出现在按钮行上方;文案须可 truncate,窄侧栏放不下长句(故为 "Live updates off" 而非带操作建议的整句)。刷新中行首是与页头 Refresh 按钮 loading 态同一个 Spinner(12px、muted 色),文字下方 8px 处一条 3px 进度条(`Progress`,primary 色、轨道同色 20%;会话扫描按 done/total 定值,总数未知 / 记忆同步 / 远程同步走不定值滑动;2026-09-22 用户要的),出错时行首回到静态 refresh-cw 图标。diff --git a/PRODUCT.md b/PRODUCT.mdindex 0f0556f..ba60323 100644--- a/PRODUCT.md+++ b/PRODUCT.md@@ -28,9 +28,9 @@ Corey 本人(独立开发者,主力工具 Claude Code 与 Codex,中文为主)。## Capabilities and Constraints-已实现:二十二家 adapter、FTS5 trigram 搜索(<3 码点 LIKE 降级)、**搜索跳转定位**(2026-08-18:⌘K 命中直达详情页对应消息并高亮,seq 契约保证)、详情页逐消息渲染(气泡/工具折叠簇/thinking/tree-sitter 高亮;2026-08-17 由整篇 markdown 方案升级)、恢复/收藏/置顶/导出/删除(废纸篓+墓碑)、文件监听增量、Insights 统计页(0.3.0:活跃热力图与 streak、时段/星期/月份分布、Agents·Projects·Models 三榜单按 sessions/tokens/prompts 切换;2026-09-03 加 Last 7 days 周对比行与 Over time 近 53 周按 agent 堆叠的每周 prompts 趋势图;口径=主线用户消息,规格见 DESIGN.md)、Updates 页与 macOS Wake 菜单手动检查 GitHub 最新正式版并打开 Release 页更新(不后台联网、不自动替换应用包)、测试套件(adapter 契约、DB 往返、scanner 回归 + CI 三平台 + pre-commit,合成 fixture)、三端桌面(macOS 主平台;Linux/Windows experimental,终端恢复/废纸篓·回收站/剪贴板按平台原生实现,发版 CI 自动出六产物)、窗口记忆(0.3.6:记住所在屏幕/屏内位置/最大化/全屏,重启与 Dock 重开都回到原处,Settings 开在主窗所在屏)、完整 macOS 菜单栏(0.3.6:标准 Edit/Window 菜单、⌘W、Window → Main Window,主窗关闭后 About/Settings/Updates 仍可用)、导出 Markdown 与保存图片走系统「另存为」并记住上次目录(0.3.6,issue #25)、远程 host(0.4.0,issue #21:Settings → Remote hosts 配 SSH 目标,rsync 白名单镜像会话数据到本地缓存后与本地会话同列同搜,`@host` 徽章标识;阶段 1 只读——不动远端文件、远程会话禁删,resume 以 Copy SSH command 形态提供;分期计划见 CLAUDE.md「远程 host」节)、**MCP 接入**(0.5.0:随应用打包的只读 `wake-mcp` stdio server,四个工具 wake_search / wake_list_sessions / wake_get_session / wake_list_projects,Claude Code / Codex / Cursor 等任何 MCP 客户端可搜历史、按项目列会话、分页读转录;Settings → Connect 展示路径与可复制配置片段,只展示不代写别家配置;零 LLM、零网络、不写库;完整参考 docs/mcp.md)、**命令行与 Skill**(0.6.0:并排打包的只读 `wake-cli`,四个子命令 search / sessions / show / projects 加 setup,给"能跑 shell 但不说 MCP"的 agent 和真人用——它不新写查询逻辑,argv 翻成 JSON 喂同一批工具,输出与 MCP 客户端看到的**逐字节相同**(仅 CLI 末尾补一个换行)并由测试卡住,所以文档只需描述一份格式;`skills/wake/SKILL.md` 是可一行安装的 skill(`npx skills add iAmCorey/Wake`),用触发条件而非名词解释写 description,让 agent 自己想得起来去翻会话历史;完整参考 docs/cli.md;0.6.3 加 `wake-cli index`——装了 Wake 却从没启动过时,agent 自己跑一条就能把索引建起来继续干活,而不是停下来问人。它**只建不存在的索引**,已有的库原样交给 GUI:扫描落在旁边的临时库、扫完才原子占位,所以被中途杀掉可重试、撞上 GUI 首扫就退让;2026-09-22 加 `wake-cli refresh`,issue #43:app 不开时增量刷新已有索引,给靠 MCP / CLI 用 Wake、只在浏览时开 app 的人用 launch agent / systemd timer 定时跑,Wake 开着窗或还有扫描在写就退让——GUI 与两个写命令共用一把索引写锁,锁跟 Workbench 与写线程走、关窗即放,GUI 启动会等正在跑的 refresh 收尾)、Connect 页四区块(0.6.1:MCP server / MCP clients / Command line / Skill,每个面的第一块挂自己的文档链接)、**记忆可见层**(2026-09-17 起,只读:把各家 agent 自己写下的记忆——Claude Code 的按项目 auto-memory、Codex 的 memories 与逐会话摘要、ZCode 的按项目记忆——按项目聚合;GUI 的 Memory 页是侧栏底部的整页目的地,侧栏在这一页换成按记忆计数的 All Memory / Agents / Projects 导航;MCP 加第五个工具 `wake_list_memories`,`wake_get_session` 认 `wake://memory/…` 引用现场读文件,`wake_search` 末尾附记忆命中;CLI 加 `memories`;记忆的项目归属按它挂的会话在读时解析,永远跟着索引走。二期(2026-09-21)把用户写给 agent 的指令文件也收进来:各家 home 里的 CLAUDE.md / AGENTS.md(与 `rules/*.rules`)/ GEMINI.md,以及已索引项目根下的 CLAUDE.md / AGENTS.md / GEMINI.md / `.cursor/rules` / `.cursorrules` / `.kiro/steering` / `.github/copilot-instructions.md`,与记忆同列同搜、不另作区分;Settings 加 Memory locations 页,与 Session locations 同形制:逐来源开关、添加自定义目录或文件、Restore defaults。不编辑、不同步、不删除——写别家数据破铁律,要改一个 Reveal 就到;也不做"把会话自动写成记忆")。后续边界(2026-09-07 定):摘要层(需 LLM、opt-in、明示会把会话正文发给用户配置的端点)只在 MCP 接入有真实使用之后再做;Timeline / Profile 一类视图建立在摘要之上;不做 ChatGPT / Claude.ai 导出导入主线、不做实体本体与知识图谱、不做 Chrome 扩展注入。+已实现:二十三家 adapter、FTS5 trigram 搜索(<3 码点 LIKE 降级)、**搜索跳转定位**(2026-08-18:⌘K 命中直达详情页对应消息并高亮,seq 契约保证)、详情页逐消息渲染(气泡/工具折叠簇/thinking/tree-sitter 高亮;2026-08-17 由整篇 markdown 方案升级)、恢复/收藏/置顶/导出/删除(废纸篓+墓碑)、文件监听增量、Insights 统计页(0.3.0:活跃热力图与 streak、时段/星期/月份分布、Agents·Projects·Models 三榜单按 sessions/tokens/prompts 切换;2026-09-03 加 Last 7 days 周对比行与 Over time 近 53 周按 agent 堆叠的每周 prompts 趋势图;口径=主线用户消息,规格见 DESIGN.md)、Updates 页与 macOS Wake 菜单手动检查 GitHub 最新正式版并打开 Release 页更新(不后台联网、不自动替换应用包)、测试套件(adapter 契约、DB 往返、scanner 回归 + CI 三平台 + pre-commit,合成 fixture)、三端桌面(macOS 主平台;Linux/Windows experimental,终端恢复/废纸篓·回收站/剪贴板按平台原生实现,发版 CI 自动出六产物)、窗口记忆(0.3.6:记住所在屏幕/屏内位置/最大化/全屏,重启与 Dock 重开都回到原处,Settings 开在主窗所在屏)、完整 macOS 菜单栏(0.3.6:标准 Edit/Window 菜单、⌘W、Window → Main Window,主窗关闭后 About/Settings/Updates 仍可用)、导出 Markdown 与保存图片走系统「另存为」并记住上次目录(0.3.6,issue #25)、远程 host(0.4.0,issue #21:Settings → Remote hosts 配 SSH 目标,rsync 白名单镜像会话数据到本地缓存后与本地会话同列同搜,`@host` 徽章标识;阶段 1 只读——不动远端文件、远程会话禁删,resume 以 Copy SSH command 形态提供;分期计划见 CLAUDE.md「远程 host」节)、**MCP 接入**(0.5.0:随应用打包的只读 `wake-mcp` stdio server,四个工具 wake_search / wake_list_sessions / wake_get_session / wake_list_projects,Claude Code / Codex / Cursor 等任何 MCP 客户端可搜历史、按项目列会话、分页读转录;Settings → Connect 展示路径与可复制配置片段,只展示不代写别家配置;零 LLM、零网络、不写库;完整参考 docs/mcp.md)、**命令行与 Skill**(0.6.0:并排打包的只读 `wake-cli`,四个子命令 search / sessions / show / projects 加 setup,给"能跑 shell 但不说 MCP"的 agent 和真人用——它不新写查询逻辑,argv 翻成 JSON 喂同一批工具,输出与 MCP 客户端看到的**逐字节相同**(仅 CLI 末尾补一个换行)并由测试卡住,所以文档只需描述一份格式;`skills/wake/SKILL.md` 是可一行安装的 skill(`npx skills add iAmCorey/Wake`),用触发条件而非名词解释写 description,让 agent 自己想得起来去翻会话历史;完整参考 docs/cli.md;0.6.3 加 `wake-cli index`——装了 Wake 却从没启动过时,agent 自己跑一条就能把索引建起来继续干活,而不是停下来问人。它**只建不存在的索引**,已有的库原样交给 GUI:扫描落在旁边的临时库、扫完才原子占位,所以被中途杀掉可重试、撞上 GUI 首扫就退让;2026-09-22 加 `wake-cli refresh`,issue #43:app 不开时增量刷新已有索引,给靠 MCP / CLI 用 Wake、只在浏览时开 app 的人用 launch agent / systemd timer 定时跑,Wake 开着窗或还有扫描在写就退让——GUI 与两个写命令共用一把索引写锁,锁跟 Workbench 与写线程走、关窗即放,GUI 启动会等正在跑的 refresh 收尾)、Connect 页四区块(0.6.1:MCP server / MCP clients / Command line / Skill,每个面的第一块挂自己的文档链接)、**记忆可见层**(2026-09-17 起,只读:把各家 agent 自己写下的记忆——Claude Code 的按项目 auto-memory、Codex 的 memories 与逐会话摘要、ZCode 的按项目记忆——按项目聚合;GUI 的 Memory 页是侧栏底部的整页目的地,侧栏在这一页换成按记忆计数的 All Memory / Agents / Projects 导航;MCP 加第五个工具 `wake_list_memories`,`wake_get_session` 认 `wake://memory/…` 引用现场读文件,`wake_search` 末尾附记忆命中;CLI 加 `memories`;记忆的项目归属按它挂的会话在读时解析,永远跟着索引走。二期(2026-09-21)把用户写给 agent 的指令文件也收进来:各家 home 里的 CLAUDE.md / AGENTS.md(与 `rules/*.rules`)/ GEMINI.md,以及已索引项目根下的 CLAUDE.md / AGENTS.md / GEMINI.md / `.cursor/rules` / `.cursorrules` / `.kiro/steering` / `.github/copilot-instructions.md`,与记忆同列同搜、不另作区分;Settings 加 Memory locations 页,与 Session locations 同形制:逐来源开关、添加自定义目录或文件、Restore defaults。不编辑、不同步、不删除——写别家数据破铁律,要改一个 Reveal 就到;也不做"把会话自动写成记忆")。后续边界(2026-09-07 定):摘要层(需 LLM、opt-in、明示会把会话正文发给用户配置的端点)只在 MCP 接入有真实使用之后再做;Timeline / Profile 一类视图建立在摘要之上;不做 ChatGPT / Claude.ai 导出导入主线、不做实体本体与知识图谱、不做 Chrome 扩展注入。约束:对 agent 数据目录只读;绝不写 Codex 的 SQLite;不读凭证;GPUI 无 SF Symbols(图标用 lucide SVG 自备)。-已支持二十二家 agent:Claude Code、Codex(0.6.6 起排除可识别的内部线程:guardian auto-review、`/review`、compaction、memory consolidation 与用户会话同树,adapter 文件边界按首行 session_meta 的 source / thread_source 认出即不枚举;老格式或读不出的首行保守放行,`codex exec --thread-source` 打了标签的自动化线程照常收录,issue #30。`spawn_agent` 子代理是其中唯一的例外,issue #42:那是用户自己派出去的活,收录后挂在派它的会话下面、以任务名为标题,fork 进来的父线程历史折成一条不入库的占位,父会话的对话不会被索引两遍)、Qoder CLI(`~/.qoder/projects` JSONL,active-leaf 分支恢复、tool result 回挂、`QODER_CONFIG_DIR`)、Copilot CLI、Cursor(CLI 转录 + 0.6.7 起 IDE Chat/Composer 历史,PR #32:`globalStorage/state.vscdb` 明文 KV 库,composerData 给顺序、bubbleId 行给正文;转录带正文的会话归转录源,库只补转录缺失或只剩 turn_ended 空壳的会话;库里多数老会话没存工作区路径,落 Unknown project)、OpenCode(含 OpenCode 2 next,stable 的 `opencode.db` 与 next 的 `opencode-next.db` 同时扫描;逐会话兼容 `message+part`、真实 `session+session_message` 及早期 `session_v2` schema;preview 会话标 opencode2 徽章)、Kiro、Gemini CLI(2026-08-17 P1 五家落地)+ Pi、Oh My Pi、Grok Build、Kimi Code、Antigravity(2026-08-19 对齐 kooky 内置 roster,起初只有 `antigravity-cli` 会话索引里的元数据卡片——正文是加密 .pb;2026-10-08 起读新版本桌面端与 IDE 写在 `~/.gemini/antigravity/brain`、`~/.gemini/antigravity-ide/brain` 的明文转录,含工具输出、模型与用户贴图,IDE 会话挂 via 徽章,同一会话转录与卡片按 id 只出一份、没有转录的仍列卡片;显示名由 Antigravity CLI 改为 Antigravity。格式取自 PR #52 @iroha3 对真实数据的整理,本机 brain 目录还没有转录,未经真机验证)+ DeepSeek Harness(dsh,2026-08-20,zstd 事件日志透明解压;格式由源码推断,当天用户跑出真实会话完成首验)+ Hermes Agent(2026-09-03,多档案 state.db,无 cwd 故 project 留空)、OpenClaw(2026-09-03,两代存储同扫;本机零会话,格式由源码推断未经真机验证)、CodeBuddy(2026-09-14,issue #27:`~/.codebuddy/projects` 的 Responses 形 JSONL,custom / ai / topic 三级标题,`CODEBUDDY_CONFIG_DIR`;本机零会话,格式由官方 CLI 文档与三家第三方实现交叉推断、未经真机验证)、WorkBuddy(同日,CodeBuddy 的孪生实例:同一解析核心,`~/.workbuddy/projects`、`WORKBUDDY_CONFIG_DIR`;桌面 app 无 CLI,不提供 resume;同构只有 cc-switch 一家佐证)、ZCode(2026-09-21:Z.ai 的 GLM-5.3 官方 harness,桌面 app;运行时是 OpenCode 衍生物——`~/.zcode/cli/db/db.sqlite` 的 session/message/part 与 OpenCode v1 同形、part 解码复用,但 session 表没有 model/tokens 列故另起一家;`v2/tasks-index.sqlite` 只借 deleted / migration_source 两个过滤位;按 `task_type` 白名单只列 interactive / fork / selection_side_chat(subagent_child 等运行时会话不列);`semantics.transcriptVisibility == hidden` 与用户消息 `origin != real_user` 归 Meta、compact_summary 折成一条、字段缺席放行;`ZCODE_STORAGE_DIR`;桌面 app 无 CLI、`zcode://` 没有按会话打开的深链,不提供 resume;本机 3.14.0 真会话首验通过,同日开源(Apache-2.0)后语义全部按源码核对)、Craft Agents(2026-09-24,issue #44:Craft Docs 的开源桌面 app,自己不带引擎——Anthropic 连接跑 Claude Agent SDK、其余连接(ChatGPT / Codex 订阅、Copilot、Google)跑 Pi SDK,另记一份给用户看的 `~/.craft-agent/workspaces/<工作区>/sessions/<id>/session.jsonl`,Wake 读这一份;子任务与分支挂回原会话,分支从父会话复制来的那段折成一条;Claude 连接在 `~/.claude/projects` 留下的引擎副本由通用的"认领"机制藏掉,原件还在才藏;工作区可建在任意位置,但登记表带 server token 不读,别处的工作区走 Session locations;桌面 app 无 CLI,不提供 resume;本机 0.13.5 真会话首验通过,ChatGPT 与 Claude 连接各一条)、Devin(2026-09-24,issue #46:`~/.local/share/devin/cli/sessions.db` 单库两表,message_nodes 森林按 `main_chain_id` 叶子沿 `parent_node_id` 取主链,hidden 会话与零正文不列,逐消息 `generation_model` 与 `metrics` 按主链累计;`XDG_DATA_HOME`;`devin --resume <id>` 按 cwd 分桶 resume;格式按本机真库验证)、Kilo Code(2026-10-07,issue #59:一家两源——2026-04 起的新版 VS Code 扩展、`kilo` CLI 与 JetBrains 插件是 OpenCode 分支,三端共用 `~/.local/share/kilo/kilo.db`,表与 OpenCode 同形、按 OpenCode 的孪生实例读;session_message 里只有实验开关零星双写的 shell 一类记录时读 message + part(OpenCode 同一条规则);旧版扩展(Roo / Cline 系)每个任务一个目录,在各个 VS Code 系编辑器的 `globalStorage/kilocode.kilo-code/tasks` 里,正文是 Anthropic 消息数组,`<task>` / `<feedback>` / `<answer>` 才是人打的字、编辑器快照丢掉,旧任务用新版导入时给的 `ses_migrated_` id,导入过的那份 kilo.db 胜出;新版 `kilo --session` 在原项目目录续,旧任务没有 Open In、也不实时监听(任务目录里有整份 checkpoints 影子仓库);kilo.db 里同库存着凭证,远程只同步 vscode-server 下的旧任务;本机零会话,新版的表结构按源码的建库语句核过,数据形状由源码推断、未经真机验证)。做不了的:Windsurf/Trae 加密,Amp/Factory(Droid)/Warp 云端无本地数据,Reasonix 本机零会话格式未实测。+已支持二十三家 agent:Claude Code、Codex(0.6.6 起排除可识别的内部线程:guardian auto-review、`/review`、compaction、memory consolidation 与用户会话同树,adapter 文件边界按首行 session_meta 的 source / thread_source 认出即不枚举;老格式或读不出的首行保守放行,`codex exec --thread-source` 打了标签的自动化线程照常收录,issue #30。`spawn_agent` 子代理是其中唯一的例外,issue #42:那是用户自己派出去的活,收录后挂在派它的会话下面、以任务名为标题,fork 进来的父线程历史折成一条不入库的占位,父会话的对话不会被索引两遍)、Qoder CLI(`~/.qoder/projects` JSONL,active-leaf 分支恢复、tool result 回挂、`QODER_CONFIG_DIR`)、Copilot CLI、Cursor(CLI 转录 + 0.6.7 起 IDE Chat/Composer 历史,PR #32:`globalStorage/state.vscdb` 明文 KV 库,composerData 给顺序、bubbleId 行给正文;转录带正文的会话归转录源,库只补转录缺失或只剩 turn_ended 空壳的会话;库里多数老会话没存工作区路径,落 Unknown project)、OpenCode(含 OpenCode 2 next,stable 的 `opencode.db` 与 next 的 `opencode-next.db` 同时扫描;逐会话兼容 `message+part`、真实 `session+session_message` 及早期 `session_v2` schema;preview 会话标 opencode2 徽章)、Kiro、Gemini CLI(2026-08-17 P1 五家落地)+ Pi、Oh My Pi、Grok Build、Kimi Code、Antigravity(2026-08-19 对齐 kooky 内置 roster,起初只有 `antigravity-cli` 会话索引里的元数据卡片——正文是加密 .pb;2026-10-08 起读新版本桌面端与 IDE 写在 `~/.gemini/antigravity/brain`、`~/.gemini/antigravity-ide/brain` 的明文转录,含工具输出、模型与用户贴图,IDE 会话挂 via 徽章,同一会话转录与卡片按 id 只出一份、没有转录的仍列卡片;显示名由 Antigravity CLI 改为 Antigravity。格式取自 PR #52 @iroha3 对真实数据的整理,本机 brain 目录还没有转录,未经真机验证)+ DeepSeek Harness(dsh,2026-08-20,zstd 事件日志透明解压;格式由源码推断,当天用户跑出真实会话完成首验)+ Hermes Agent(2026-09-03,多档案 state.db,无 cwd 故 project 留空)、OpenClaw(2026-09-03,两代存储同扫;本机零会话,格式由源码推断未经真机验证)、CodeBuddy(2026-09-14,issue #27:`~/.codebuddy/projects` 的 Responses 形 JSONL,custom / ai / topic 三级标题,`CODEBUDDY_CONFIG_DIR`;本机零会话,格式由官方 CLI 文档与三家第三方实现交叉推断、未经真机验证)、WorkBuddy(同日,CodeBuddy 的孪生实例:同一解析核心,`~/.workbuddy/projects`、`WORKBUDDY_CONFIG_DIR`;桌面 app 无 CLI,不提供 resume;同构只有 cc-switch 一家佐证)、ZCode(2026-09-21:Z.ai 的 GLM-5.3 官方 harness,桌面 app;运行时是 OpenCode 衍生物——`~/.zcode/cli/db/db.sqlite` 的 session/message/part 与 OpenCode v1 同形、part 解码复用,但 session 表没有 model/tokens 列故另起一家;`v2/tasks-index.sqlite` 只借 deleted / migration_source 两个过滤位;按 `task_type` 白名单只列 interactive / fork / selection_side_chat(subagent_child 等运行时会话不列);`semantics.transcriptVisibility == hidden` 与用户消息 `origin != real_user` 归 Meta、compact_summary 折成一条、字段缺席放行;`ZCODE_STORAGE_DIR`;桌面 app 无 CLI、`zcode://` 没有按会话打开的深链,不提供 resume;本机 3.14.0 真会话首验通过,同日开源(Apache-2.0)后语义全部按源码核对)、Craft Agents(2026-09-24,issue #44:Craft Docs 的开源桌面 app,自己不带引擎——Anthropic 连接跑 Claude Agent SDK、其余连接(ChatGPT / Codex 订阅、Copilot、Google)跑 Pi SDK,另记一份给用户看的 `~/.craft-agent/workspaces/<工作区>/sessions/<id>/session.jsonl`,Wake 读这一份;子任务与分支挂回原会话,分支从父会话复制来的那段折成一条;Claude 连接在 `~/.claude/projects` 留下的引擎副本由通用的"认领"机制藏掉,原件还在才藏;工作区可建在任意位置,但登记表带 server token 不读,别处的工作区走 Session locations;桌面 app 无 CLI,不提供 resume;本机 0.13.5 真会话首验通过,ChatGPT 与 Claude 连接各一条)、Devin(2026-09-24,issue #46:`~/.local/share/devin/cli/sessions.db` 单库两表,message_nodes 森林按 `main_chain_id` 叶子沿 `parent_node_id` 取主链,hidden 会话与零正文不列,逐消息 `generation_model` 与 `metrics` 按主链累计;`XDG_DATA_HOME`;`devin --resume <id>` 按 cwd 分桶 resume;格式按本机真库验证)、Kilo Code(2026-10-07,issue #59:一家两源——2026-04 起的新版 VS Code 扩展、`kilo` CLI 与 JetBrains 插件是 OpenCode 分支,三端共用 `~/.local/share/kilo/kilo.db`,表与 OpenCode 同形、按 OpenCode 的孪生实例读;session_message 里只有实验开关零星双写的 shell 一类记录时读 message + part(OpenCode 同一条规则);旧版扩展(Roo / Cline 系)每个任务一个目录,在各个 VS Code 系编辑器的 `globalStorage/kilocode.kilo-code/tasks` 里,正文是 Anthropic 消息数组,`<task>` / `<feedback>` / `<answer>` 才是人打的字、编辑器快照丢掉,旧任务用新版导入时给的 `ses_migrated_` id,导入过的那份 kilo.db 胜出;新版 `kilo --session` 在原项目目录续,旧任务没有 Open In、也不实时监听(任务目录里有整份 checkpoints 影子仓库);kilo.db 里同库存着凭证,远程只同步 vscode-server 下的旧任务;本机零会话,新版的表结构按源码的建库语句核过,数据形状由源码推断、未经真机验证)、Grok Bot(2026-10-11:xAI 的常驻 agent,桌面 app 由 Cursor 出品,bot 跑在云端电脑上,对话也存在那里;本机只有桌面端的滚动缓存 `<userData>/sand-client-persistence`——每个对话只留最近 200 条、最多 24 个对话、7 天没写过的被 app 自己清掉。用户定"跟着缓存走":缓存里有的对话出完整消息(你的话、bot 的话、群聊里标出是哪个 bot、bot 之间互发的消息、提问卡片与你的回答、邮件草稿、审批),被清出缓存的退成侧栏列表里的一张卡片(描述 + 最后一条预览),不会从 Wake 里消失;对话本体在云端,删除只隐藏、不动缓存文件;没有命令行,不提供 resume;不做远程同步;格式按 0.68.1 的 app 源码与本机 14 个真实对话核对)。做不了的:Windsurf/Trae 加密,Amp/Factory(Droid)/Warp 云端无本地数据,Reasonix 本机零会话格式未实测。## Brand Commitmentsdiff --git a/README.md b/README.mdindex 9ba7754..e4c7cb6 100644--- a/README.md+++ b/README.md@@ -59,6 +59,7 @@ Your agent history is scattered across `~/.claude`, `~/.codex` and many other fo| Craft Agents | `~/.craft-agent/workspaces/*/sessions/*/session.jsonl` | ✅ | ✅ || Devin | `~/.local/share/devin/cli/sessions.db` | ✅ | — || Kilo Code | `~/.local/share/kilo/kilo.db` + the legacy extension's `globalStorage/kilocode.kilo-code/tasks` | ✅ | ✅ |+| Grok Bot | the desktop app's cache (`Grok Bot/sand-client-persistence`) | — | — |Agents' own environment variables (`CODEX_HOME`, `XDG_DATA_HOME`, …) are respected, and Settings → Session locations adds folders anywhere else.@@ -68,6 +69,7 @@ Agents' own environment variables (`CODEX_HOME`, `XDG_DATA_HOME`, …) are respe- **Cursor** — chats are read from transcripts, or from Cursor's own database when there is no transcript- **Craft Agents** — on a Claude connection, Wake shows the Craft session and hides the duplicate Claude Code copy- **Kilo Code** — the new extension, CLI and JetBrains plugin share `kilo.db`; tasks from the legacy extension are listed too+- **Grok Bot** — conversations live in Grok Bot's cloud; Wake reads the latest messages the desktop app keeps on this computer, a conversation it no longer keeps stays listed with its last message, and deleting one in Wake only hides itNot supported: Windsurf and Trae (encrypted), Amp, Factory and Warp (cloud only).diff --git a/crates/wake-core/src/adapters/codex.rs b/crates/wake-core/src/adapters/codex.rsindex f0408f2..240e288 100644--- a/crates/wake-core/src/adapters/codex.rs+++ b/crates/wake-core/src/adapters/codex.rs@@ -50,11 +50,6 @@ impl CodexAdapter {}}-/// 路径末段,`/` 与 `\` 都算分隔符(state DB 可能是 Windows 机器写的)-fn rollout_file_name(path: &str) -> &str {- path.rsplit(['/', '\\']).next().unwrap_or(path)-}-/// Codex 把它启动的**每一条**线程都写进同一棵 rollout 树:用户线程之外还有/// guardian auto-review、`/review`、compaction、memory consolidation 与/// `spawn_agent` 子代理。它自家的历史只列交互来源(cli/vscode/atlas/chatgpt),@@ -1074,11 +1069,11 @@ impl AgentAdapter for CodexAdapter {// uuid)全局唯一,按文件名匹配即可,与根/host/平台分隔符都无关let by_name: HashMap<&str, &ThreadRow> = rows.iter()- .map(|r| (rollout_file_name(&r.rollout_path), r))+ .map(|r| (path_tail(&r.rollout_path), r)).collect();let mut out = HashMap::new();for r in refs {- let Some(row) = by_name.get(rollout_file_name(&r.file_path)) else {+ let Some(row) = by_name.get(path_tail(&r.file_path)) else {continue;};// 结构化 source(对象)= 子代理线程。它的 `title` 是 Codex 按首条diff --git a/crates/wake-core/src/adapters/cursor_ide.rs b/crates/wake-core/src/adapters/cursor_ide.rsindex d44d798..8d1ed91 100644--- a/crates/wake-core/src/adapters/cursor_ide.rs+++ b/crates/wake-core/src/adapters/cursor_ide.rs@@ -48,10 +48,10 @@ pub struct CursorIdeAdapter {}/// `globalStorage/state.vscdb` 的默认路径(用户数据目录三平台各异,见-/// `vscode_user_data`)。只做路径推导、不探测存在性——缺根由 list_session_files+/// `electron_user_data`)。只做路径推导、不探测存在性——缺根由 list_session_files/// 降级为空(roster 契约)pub(super) fn default_db_path() -> PathBuf {- super::vscode_user_data("Cursor")+ super::electron_user_data("Cursor").join("User").join("globalStorage").join(DB_NAME)diff --git a/crates/wake-core/src/adapters/grok_bot.rs b/crates/wake-core/src/adapters/grok_bot.rsnew file mode 100644index 0000000..f4414e5--- /dev/null+++ b/crates/wake-core/src/adapters/grok_bot.rs@@ -0,0 +1,1316 @@+use super::parse_utils::*;+use super::sqlite_ro::{split_virtual_path, virtual_path};+use super::AgentAdapter;+use crate::models::*;+use anyhow::{anyhow, Result};+use serde_json::Value;+use std::collections::HashMap;+use std::fs;+use std::io::{BufRead, BufReader, ErrorKind};+use std::path::{Path, PathBuf};+use std::sync::{Arc, Mutex};++/// Grok Bot(xAI 的常驻 agent,桌面 app 由 Cursor 出品,bundle id `com.anysphere.sand`):bot 跑在+/// 云端电脑上,对话也存在那里,桌面端只在本机留一份**滚动缓存**——`<userData>/sand-client-persistence/`+/// (Electron 的 userData:macOS `~/Library/Application Support/Grok Bot`,Linux `~/.config/Grok Bot`,+/// Windows `%APPDATA%\Grok Bot`)。一个键一个文件,文件名是键的 base32(小写、无填充)加 `.blob`;+/// 编码后超过 240 字符的键改存 `<摘要>.kblob`,首行是 JSON 编码的键。写法是先写 `<名>.tmp` 再改名替换,+/// 读到的不会是半截。+/// - `sand.client.slice.account.<账号>.transcript.replicas.<对话 id>`:对话的本地副本+/// `{schemaVersion: 1, value: {entries, persistedAt, precedingTimestampMs?, …}}`。app 每个对话只留+/// 最近 200 条(且不超过 768 KB)、最多留 24 个对话,7 天没写过的被它自己清掉;更早的只在云端+/// - `sand.client.slice.account.<账号>.roster.last-roster`:侧栏的全量列表,每个 bot / 群聊一行+/// (名字、描述、时间、是否从侧栏隐藏、最后一条消息的预览)+///+/// 一个对话一条会话(用户 2026-10-11 定:跟着缓存走)。有副本的按副本出消息,标题(bot 的名字)、+/// 创建时间与隐藏状态以列表为准;副本被清掉的退成一张卡片(描述 + 最后一条预览),不从 Wake 里+/// 消失。两种都如实列出,同一对话的胜负交 scanner 的 `dedup_rank`(副本恒胜,读不出时卡片接住),+/// 与 Antigravity 同法。格式按 0.68.1 的 app 源码与本机 14 份副本核对过+pub struct GrokBotAdapter {+ /// `sand-client-persistence` 目录+ root: PathBuf,+ /// 列表一个账号一份。按文件的 (mtime, size) 记住读出来过的版本与最后一次读成功的内容:同一个+ /// 文件版本只解析一次,解不开时交回上一次读到的(没读成功过是 None)+ rosters: Mutex<RosterCache>,+ /// 读出过键的 `.kblob`(键在首行):文件被删之后还认得出它是哪个账号的哪种切片,删除事件+ /// 要按它对账+ framed: Mutex<HashMap<PathBuf, Slice>>,+}++type FileStamp = (i64, i64);+/// 列表文件 → (读出来过的文件版本, 最后一次读成功的内容)+type RosterCache = HashMap<PathBuf, (FileStamp, Option<Arc<Roster>>)>;++const STORE_DIR: &str = "sand-client-persistence";+const ACCOUNT_SLICE: &str = "sand.client.slice.account.";+const REPLICAS: &str = "transcript.replicas.";+const ROSTER: &str = "roster.last-roster";+/// 键直接编码成文件名+const ENCODED: &str = ".blob";+/// 编码后太长的键:文件名是摘要,首行是键+const FRAMED: &str = ".kblob";+/// app 的上限:编码出的文件名(含 `.blob`)超过它,就改存摘要名的 `.kblob`+const MAX_ENCODED_NAME: usize = 240;+const BASE32: &[u8; 32] = b"abcdefghijklmnopqrstuvwxyz234567";+/// app 只认这一版副本;别的版本照样按形状读,记一笔未知,格式漂移看得出来+const REPLICA_SCHEMA: i64 = 1;+const NOT_CACHED: &str = "Grok Bot no longer caches this conversation on this computer — only its last message is available in Wake.";+const EARLIER_ONLY_IN_APP: &str =+ "── Earlier messages of this conversation are only in Grok Bot ──";++impl GrokBotAdapter {+ pub fn new() -> Self {+ Self::at(super::electron_user_data("Grok Bot").join(STORE_DIR))+ }++ fn at(root: PathBuf) -> Self {+ Self {+ root,+ rosters: Mutex::new(HashMap::new()),+ framed: Mutex::new(HashMap::new()),+ }+ }++ /// 存储目录里与会话有关的文件(副本与列表)。根不在 = 确定没有;在却列不出报错(scanner 冻结这一轮)+ fn store_files(&self) -> Result<Vec<(PathBuf, Slice)>> {+ let entries = match fs::read_dir(&self.root) {+ Ok(entries) => entries,+ Err(e) if e.kind() == ErrorKind::NotFound => return Ok(Vec::new()),+ Err(e) => return Err(e.into()),+ };+ Ok(entries+ .flatten()+ .filter_map(|entry| {+ let path = entry.path();+ let slice = self.slice_at(&path)?;+ Some((path, slice))+ })+ .collect())+ }++ /// 路径上那份文件存的是哪一种切片;别的存储文件、不是存储文件的都是 None。`.kblob` 的键在+ /// 首行,读出来的记下:文件没了(删除事件)、一时读不出,照样认得出+ fn slice_at(&self, path: &Path) -> Option<Slice> {+ let framed = path+ .file_name()+ .and_then(|name| name.to_str())+ .is_some_and(|name| name.ends_with(FRAMED));+ let slice = file_key(path).and_then(|key| slice_of(&key));+ if !framed {+ return slice;+ }+ let mut seen = self.framed.lock().unwrap();+ match slice {+ Some(slice) => {+ seen.insert(path.to_path_buf(), slice.clone());+ Some(slice)+ }+ None => seen.get(path).cloned(),+ }+ }++ /// 一个账号的列表文件:键编码进文件名的直接算出来,只有编码后太长(`.kblob`)才列目录找——每个+ /// 副本的 `file_ref` 都要它,列表一变 watcher 就把同账号的副本全拿来重比+ fn roster_path(&self, account: &str) -> Option<PathBuf> {+ match store_file_name(&roster_key(account)) {+ Some(name) => Some(self.root.join(name)),+ None => self+ .store_files()+ .ok()?+ .into_iter()+ .find_map(|(path, slice)| {+ matches!(&slice, Slice::Roster { account: a } if a == account).then_some(path)+ }),+ }+ }++ /// 某个账号的列表+ fn roster_for(&self, account: &str) -> Option<Arc<Roster>> {+ self.roster(&self.roster_path(account)?)+ }++ /// 一个列表文件。文件不在给 None;在却读不出、解不开都先交回上一次读到的。读不出(权限、锁)+ /// 不记这个版本,下次再读——记了的话错误过去之后 mtime / size 没变,连全量刷新都不会再读+ /// (2026-10-11 Codex review);读出来却解不开(写坏了)才记,同一个版本不再白解析+ fn roster(&self, path: &Path) -> Option<Arc<Roster>> {+ let Some(stamp) = file_stamp(path) else {+ self.rosters.lock().unwrap().remove(path);+ return None;+ };+ if let Some((seen, roster)) = self.rosters.lock().unwrap().get(path) {+ if *seen == stamp {+ return roster.clone();+ }+ }+ // 读文件不持锁+ let raw = fs::read_to_string(path);+ let mut cache = self.rosters.lock().unwrap();+ let last = cache.get(path).and_then(|(_, last)| last.clone());+ let Ok(raw) = raw else {+ return last;+ };+ let roster = parse_value(path, &raw)+ .ok()+ .map(|v| Arc::new(parse_roster(&v)))+ .or(last);+ cache.insert(path.to_path_buf(), (stamp, roster.clone()));+ roster+ }++ fn parse(&self, r: &SessionFileRef) -> Result<(SessionMeta, Vec<TranscriptMessage>, u32)> {+ if let Some((file, id)) = card_parts(&r.file_path) {+ let roster = self+ .roster(file)+ .ok_or_else(|| anyhow!("cannot read the Grok Bot conversation list"))?;+ let row = roster+ .get(id)+ .ok_or_else(|| anyhow!("Grok Bot conversation {id} is not in the list"))?;+ return Ok(card(r, row));+ }+ let path = Path::new(&r.file_path);+ let replica = read_replica(path)?;+ let roster = match self.slice_at(path) {+ Some(Slice::Replica { account, .. }) => self.roster_for(&account),+ _ => None,+ };+ let row = roster+ .as_deref()+ .and_then(|roster| roster.get(&r.native_id));+ let meta = replica_meta(r, row, &replica.messages);+ if meta.message_count > 0 {+ return Ok((meta, replica.messages, replica.unknown));+ }+ // 一条正文都没有(只剩事件、全是不认识的条目):有列表行就按卡片出,挂在副本自己的路径上——+ // 报错退给卡片的话,每轮全量扫描都会把副本重读一遍、把卡片删了重插+ let row = row.ok_or_else(|| {+ anyhow!(+ "Grok Bot transcript has no readable messages: {}",+ r.file_path+ )+ })?;+ let (meta, messages, _) = card(r, row);+ Ok((meta, messages, replica.unknown))+ }+}++/// 键直接编码成的文件名(app 的写法,`<base32>.blob`)。编码出来超过 240 字符的键 app 改存成摘要名的+/// `.kblob`,给 None+pub fn store_file_name(key: &str) -> Option<String> {+ let mut name = String::with_capacity(key.len() * 8 / 5 + 1 + ENCODED.len());+ let (mut acc, mut bits) = (0u32, 0u32);+ for byte in key.bytes() {+ acc = ((acc << 8) | u32::from(byte)) & 0xffff;+ bits += 8;+ while bits >= 5 {+ bits -= 5;+ name.push(BASE32[((acc >> bits) & 31) as usize] as char);+ }+ }+ if bits > 0 {+ name.push(BASE32[((acc << (5 - bits)) & 31) as usize] as char);+ }+ name.push_str(ENCODED);+ (name.len() <= MAX_ENCODED_NAME).then_some(name)+}++/// 文件名里的 base32 → 字节;与 app 一样拒绝非零的填充位+fn base32_decode(s: &str) -> Option<Vec<u8>> {+ let mut out = Vec::with_capacity(s.len() * 5 / 8);+ let (mut acc, mut bits) = (0u32, 0u32);+ for c in s.bytes() {+ let v = BASE32.iter().position(|&a| a == c)? as u32;+ acc = ((acc << 5) | v) & 0x1fff;+ bits += 5;+ if bits >= 8 {+ bits -= 8;+ out.push((acc >> bits) as u8);+ }+ }+ (acc & ((1 << bits) - 1) == 0).then_some(out)+}++/// 文件里存的键。None = 不是存储文件(写到一半的 `.tmp`、迁移标记)或读不出+fn file_key(path: &Path) -> Option<String> {+ let name = path.file_name()?.to_str()?;+ if let Some(stem) = name.strip_suffix(ENCODED) {+ return String::from_utf8(base32_decode(stem)?).ok();+ }+ if name.ends_with(FRAMED) {+ let mut line = String::new();+ BufReader::new(fs::File::open(path).ok()?)+ .read_line(&mut line)+ .ok()?;+ return serde_json::from_str(line.trim_end()).ok();+ }+ None+}++fn is_store_file(name: &str) -> bool {+ name.ends_with(ENCODED) || name.ends_with(FRAMED)+}++/// 文件里存的值(`.kblob` 跳过首行的键)+fn read_value(path: &Path) -> Result<Value> {+ parse_value(path, &fs::read_to_string(path)?)+}++/// 读出来的文件内容 → 存的值+fn parse_value(path: &Path, raw: &str) -> Result<Value> {+ let framed = path+ .file_name()+ .and_then(|name| name.to_str())+ .is_some_and(|name| name.ends_with(FRAMED));+ let body = if framed {+ raw.split_once('\n').map_or("", |(_, value)| value)+ } else {+ raw+ };+ Ok(serde_json::from_str(body)?)+}++fn file_stamp(path: &Path) -> Option<FileStamp> {+ let meta = fs::metadata(path).ok()?;+ meta.is_file().then(|| (mtime_ms(&meta), meta.len() as i64))+}++/// 与会话有关的两种键。账号段原样保留(app 存的是 URI 编码过的账号,同一账号的副本与列表靠它配对)+#[derive(Debug, PartialEq, Clone)]+enum Slice {+ Replica {+ account: String,+ conversation: String,+ },+ Roster {+ account: String,+ },+}++fn slice_of(key: &str) -> Option<Slice> {+ let (account, slice) = key.strip_prefix(ACCOUNT_SLICE)?.split_once('.')?;+ if account.is_empty() {+ return None;+ }+ let account = account.to_string();+ if slice == ROSTER {+ return Some(Slice::Roster { account });+ }+ // 子键按 encodeURIComponent 编码、`.` 写成 %2E,原样的 `.` 不会出现+ let sub = slice.strip_prefix(REPLICAS)?;+ (!sub.is_empty() && !sub.contains('.')).then(|| Slice::Replica {+ account,+ conversation: percent_decode(sub),+ })+}++fn roster_key(account: &str) -> String {+ format!("{ACCOUNT_SLICE}{account}.{ROSTER}")+}++/// 卡片的虚拟路径 `<列表文件>#<对话 id>` → (列表文件, 对话 id)。不碰磁盘,是不是列表交给随后读列表去认+fn card_parts(path: &str) -> Option<(&Path, &str)> {+ if !is_card(path) {+ return None;+ }+ let (file, id) = split_virtual_path(path)?;+ (!id.is_empty() && !id.contains(std::path::is_separator)).then(|| (Path::new(file), id))+}++/// 副本文件以存储后缀结尾,卡片的虚拟路径以 `#<对话 id>` 结尾——判断不碰磁盘(`dedup_rank` 在写事务里调)+fn is_card(path: &str) -> bool {+ !is_store_file(path)+}++// ---------------------------------------------------------------- 列表++type Roster = HashMap<String, Row>;++/// 列表里的一行:一个 bot,或一个群聊+struct Row {+ name: String,+ description: String,+ created_ms: i64,+ activity_ms: i64,+ hidden: bool,+ last_entry: String,+}++impl Row {+ fn parse(v: &Value) -> Self {+ let text = |pointer: &str| optional_string(v.pointer(pointer)).unwrap_or_default();+ let ms = |key: &str| v.get(key).map(to_epoch_ms).unwrap_or(0);+ Self {+ name: text("/name"),+ description: text("/description"),+ created_ms: ms("createdAt"),+ activity_ms: match ms("lastActivityAt") {+ 0 => ms("updatedAt"),+ t => t,+ },+ hidden: true_at(v, "isHiddenFromSidebar"),+ last_entry: text("/lastEntry/text"),+ }+ }++ /// 这一行里会话用得上的全部东西的指纹,并进引用的 size:卡片的 size 就是它,副本的 size 是文件+ /// 大小加上它。副本也盖住卡片才用的描述与预览——副本读不出正文时退成卡片、挂在副本自己的路径上+ /// (2026-10-11 Codex review);只在 app 里改了名、藏了一下、来了新预览,副本没动也判得出脏+ fn fingerprint(&self) -> i64 {+ sidecar_fingerprint(&[+ &self.name,+ &self.description,+ &self.last_entry,+ if self.hidden { "hidden" } else { "" },+ &self.created_ms.to_string(),+ &self.activity_ms.to_string(),+ ])+ }+}++/// 读得出、却没有 rows 的(格式换了)当空列表:副本照列,只是没有卡片、标题退回第一句话+fn parse_roster(v: &Value) -> Roster {+ v.pointer("/value/rows")+ .and_then(Value::as_array)+ .into_iter()+ .flatten()+ .filter_map(|row| {+ let id = row.get("id")?.as_str().filter(|id| !id.is_empty())?;+ Some((id.to_string(), Row::parse(row)))+ })+ .collect()+}++// ---------------------------------------------------------------- 引用与元数据++fn replica_ref(path: &Path, conversation: &str, row: Option<&Row>) -> Option<SessionFileRef> {+ let (mtime_ms, size) = file_stamp(path).filter(|(_, size)| *size > 0)?;+ Some(SessionFileRef {+ agent: AgentId::GrokBot,+ native_id: conversation.to_string(),+ file_path: path.to_string_lossy().into_owned(),+ mtime_ms,+ size: size + row.map_or(0, Row::fingerprint),+ })+}++fn card_ref(roster: &Path, id: &str, row: &Row) -> SessionFileRef {+ SessionFileRef {+ agent: AgentId::GrokBot,+ native_id: id.to_string(),+ file_path: virtual_path(roster, id),+ mtime_ms: row.activity_ms,+ size: row.fingerprint(),+ }+}++fn base_meta(r: &SessionFileRef) -> SessionMeta {+ SessionMeta {+ key: session_key(AgentId::GrokBot, "", &r.native_id),+ host: String::new(),+ id: r.native_id.clone(),+ agent: AgentId::GrokBot,+ title: UNTITLED.to_string(),+ // bot 不在哪个项目目录里干活,落 Unknown project+ project_path: String::new(),+ project_name: project_name_of(""),+ file_path: r.file_path.clone(),+ created_at: 0,+ updated_at: 0,+ message_count: 0,+ size_bytes: r.size,+ git_branch: None,+ model: None,+ tokens_used: None,+ archived: false,+ source: None,+ favorite: false,+ pinned: false,+ }+}++fn row_title(row: &Row) -> Option<String> {+ Some(clean_title_candidate(&row.name)).filter(|title| !title.is_empty())+}++fn replica_meta(+ r: &SessionFileRef,+ row: Option<&Row>,+ messages: &[TranscriptMessage],+) -> SessionMeta {+ let first = messages.iter().filter_map(|m| m.timestamp).min();+ let last = messages.iter().filter_map(|m| m.timestamp).max();+ SessionMeta {+ title: row+ .and_then(row_title)+ .or_else(|| title_from_messages(messages))+ .unwrap_or_else(|| UNTITLED.to_string()),+ // bot 建出来的时刻就是对话开始的时刻;副本被截过头时第一条消息要晚得多+ created_at: row+ .map(|row| row.created_ms)+ .filter(|ms| *ms > 0)+ .or(first)+ .unwrap_or(r.mtime_ms),+ updated_at: last+ .or(row.map(|row| row.activity_ms).filter(|ms| *ms > 0))+ .unwrap_or(r.mtime_ms),+ // 你和 bot 的话;系统提示与事件不算+ message_count: messages+ .iter()+ .filter(|m| m.kind == MessageKind::Text && m.role != Role::System)+ .count() as i64,+ archived: row.is_some_and(|row| row.hidden),+ ..base_meta(r)+ }+}++/// 副本被清掉的对话:列表里的描述与最后一条预览,一条 System 消息承载,详情页与 FTS 都有着落+fn card(r: &SessionFileRef, row: &Row) -> (SessionMeta, Vec<TranscriptMessage>, u32) {+ let mut text = ParsedContent::default();+ text.push_text(&row.description);+ if !row.last_entry.is_empty() {+ text.push_text(&format!("Last message: {}", row.last_entry));+ }+ text.push_text(NOT_CACHED);+ let mut messages = vec![text_msg(Role::System, &text.text, row.activity_ms)];+ assign_seq(&mut messages);+ let created = if row.created_ms > 0 {+ row.created_ms+ } else {+ row.activity_ms+ };+ let meta = SessionMeta {+ title: row_title(row).unwrap_or_else(|| UNTITLED.to_string()),+ created_at: created,+ updated_at: row.activity_ms.max(created),+ archived: row.hidden,+ ..base_meta(r)+ };+ (meta, messages, 0)+}++// ---------------------------------------------------------------- 副本++struct Replica {+ messages: Vec<TranscriptMessage>,+ unknown: u32,+}++fn read_replica(path: &Path) -> Result<Replica> {+ replica(&read_value(path)?)+ .ok_or_else(|| anyhow!("not a Grok Bot transcript: {}", path.display()))+}++/// 条目是聊天界面上的一行,`kind` 分九种(0.68.1 的 `Gg` 表):message(人说的话,或 bot 之间互发的+/// 消息)、send-message(bot 发给你的消息与卡片)、user-attachment、tool-call、notice、event、feedback、+/// voice-call、mcp-app。缓存只存聊天这一层,bot 在云端电脑上跑的命令不在里面+fn replica(v: &Value) -> Option<Replica> {+ let entries = v.pointer("/value/entries")?.as_array()?;+ let mut b = Builder::default();+ if v.get("schemaVersion").and_then(Value::as_i64) != Some(REPLICA_SCHEMA) {+ b.unknown += 1;+ }+ // 只留最近 200 条时,app 记下被截掉那段最后一条的时间+ let preceding = v.pointer("/value/precedingTimestampMs").map(to_epoch_ms);+ let first_seq = entries+ .first()+ .and_then(|e| e.get("seq"))+ .and_then(Value::as_i64);+ if preceding.is_some() || first_seq.is_some_and(|seq| seq > 1) {+ b.messages.push(text_msg(+ Role::System,+ EARLIER_ONLY_IN_APP,+ preceding.unwrap_or(0),+ ));+ }+ for entry in entries {+ b.entry(entry);+ }+ b.flush_attachments();+ let mut messages = b.messages;+ assign_seq(&mut messages);+ Some(Replica {+ messages,+ unknown: b.unknown,+ })+}++#[derive(Default)]+struct Builder {+ messages: Vec<TranscriptMessage>,+ unknown: u32,+ /// 用户附件排在它所属那条消息之前、带同一个 clientNonce:先攒着,并进那条消息;只发了附件的+ /// 单独成一条+ pending: Option<Attachments>,+}++struct Attachments {+ nonce: String,+ ts: i64,+ labels: Vec<String>,+}++impl Builder {+ fn entry(&mut self, e: &Value) {+ let Some(kind) = e.get("kind").and_then(Value::as_str) else {+ self.unknown += 1;+ return;+ };+ let ts = e.get("timestampMs").map(to_epoch_ms).unwrap_or(0);+ if kind == "user-attachment" {+ self.attachment(e, ts);+ return;+ }+ let typed_by_you =+ kind == "message" && str_at(e, "role") == "user" && e.get("fromAgent").is_none();+ let nonce = e.get("clientNonce").and_then(Value::as_str);+ let claimed = self+ .pending+ .take_if(|p| typed_by_you && nonce == Some(p.nonce.as_str()));+ self.flush_attachments();+ match kind {+ "message" => self.message(e, ts, claimed.map(|p| p.labels).unwrap_or_default()),+ "send-message" => self.send_message(e, ts),+ "tool-call" => self.tool_call(e, ts),+ "notice" => self.push(Role::System, str_at(e, "text"), ts),+ "voice-call" => self.push(Role::System, &voice_call(e), ts),+ "mcp-app" => {+ let uri = str_at(e, "resourceUri");+ self.push(Role::Assistant, &format!("[MCP app: {uri}]"), ts);+ }+ // 状态变化(自动化增删、改名、共享)与评价:不是对话,留个记录+ "event" => self.messages.push(meta_msg(&event_text(e), ts)),+ "feedback" => {+ let sentiment = ["sentiment", "state"]+ .iter()+ .find_map(|key| text_at(e, key))+ .unwrap_or("given");+ self.messages+ .push(meta_msg(&format!("Feedback: {sentiment}"), ts));+ }+ _ => self.unknown += 1,+ }+ }++ fn push(&mut self, role: Role, text: &str, ts: i64) {+ // 流式中的空占位(内容还没来)不成消息+ if !text.trim().is_empty() {+ self.messages.push(text_msg(role, text, ts));+ }+ }++ fn attachment(&mut self, e: &Value, ts: i64) {+ let label = attachment_label(e);+ let nonce = e.get("clientNonce").and_then(Value::as_str);+ if let (Some(pending), Some(nonce)) = (&mut self.pending, nonce) {+ if pending.nonce == nonce {+ pending.labels.push(label);+ return;+ }+ }+ self.flush_attachments();+ match nonce {+ // 认不出属于哪条消息的,直接成一条+ None => self.push(Role::User, &label, ts),+ Some(nonce) => {+ self.pending = Some(Attachments {+ nonce: nonce.to_string(),+ ts,+ labels: vec![label],+ })+ }+ }+ }++ /// 没等到所属消息的附件单独成一条用户消息+ fn flush_attachments(&mut self) {+ if let Some(pending) = self.pending.take() {+ self.push(Role::User, &pending.labels.join("\n"), pending.ts);+ }+ }++ /// `message`:你说的话(role user),或者 bot 之间互发的消息——别的 bot 发给它的也记成 role user、+ /// 带 fromAgent;它发给别的 bot 的是 role assistant、带 toAgent。团队里另一个人说的带 fromUser+ fn message(&mut self, e: &Value, ts: i64, attachments: Vec<String>) {+ let content = str_at(e, "content");+ match e.get("role").and_then(Value::as_str) {+ Some("user") if e.get("fromAgent").is_some() => {+ let peer = name_of(e.get("fromAgent")).unwrap_or("another bot");+ let text = labelled(&format!("Message from {peer}"), content);+ self.push(Role::Assistant, &text, ts);+ }+ Some("user") => {+ let mut text = ParsedContent::default();+ text.push_text(&attachments.join("\n"));+ text.push_text(content);+ let text = match name_of(e.get("fromUser")) {+ Some(person) => labelled(person, &text.text),+ None => text.text,+ };+ self.push(Role::User, &text, ts);+ }+ Some("assistant") => {+ let text = match name_of(e.get("toAgent")) {+ Some(peer) => labelled(&format!("Message to {peer}"), content),+ None => content.to_string(),+ };+ self.push(Role::Assistant, &text, ts);+ }+ _ => self.unknown += 1,+ }+ }++ /// `send-message`:bot 发给你的一条消息或一张卡片。群聊里带 author(哪个 bot 发的)+ fn send_message(&mut self, e: &Value, ts: i64) {+ let Some(m) = e.get("message").filter(|m| m.is_object()) else {+ self.unknown += 1;+ return;+ };+ let kind = str_at(m, "type");+ let body = match kind {+ "text" => text_with_images(m),+ "attachment" => attachment_text(m),+ "widget" => widget_text(m, e),+ "email-draft" => email_draft_text(m, e),+ "slack-draft" => slack_draft_text(m),+ "secret-request" => secret_request_text(m, e),+ "connector" => {+ let connector = str_at(m, "connector");+ if str_at(m, "variant") == "connected" {+ format!("Connected {connector}")+ } else {+ format!("Asked to connect {connector}")+ }+ }+ "auto-review-approval" => approval_text(m),+ _ => {+ if !KNOWN_CARDS.contains(&kind) {+ self.unknown += 1;+ }+ card_summary(kind, m)+ }+ };+ let text = match name_of(e.get("author")) {+ Some(author) => labelled(author, &body),+ None => body,+ };+ self.push(Role::Assistant, &text, ts);+ }++ /// bot 调的工具(聊天界面默认不显示;缓存里有就挂到它前面那条 bot 消息上)+ fn tool_call(&mut self, e: &Value, ts: i64) {+ let mut view = tool_call_view(+ str_at(e, "id").to_string(),+ str_at(e, "name"),+ &Value::Null,+ None,+ matches!(str_at(e, "status"), "error" | "failed"),+ );+ view.input_preview = make_preview(&Value::String(str_at(e, "summary").to_string()));+ let ix = merge_into_last_assistant(&mut self.messages, ts, ParsedContent::default(), "");+ self.messages[ix].tool_calls.push(view);+ }+}++/// 认得、但没有专门写法的卡片:按 app 自己预览卡片的取法抽几段文字(`card_summary`)+const KNOWN_CARDS: &[&str] = &[+ "cursor-agent",+ "credential-request",+ "user-form",+ "permission-request",+ "cookie-origin-approval",+ "mobile-tool-permission",+ "local-tool-permission",+ "connector-grant",+ "virtual-card-approval",+ "publish-approval",+ "connectors",+ "listener-connect",+ "team-access",+ "slack-connect",+ "scm-connect",+ "onepassword-connect",+ "bot-template-share",+];+/// 卡片里能当文字的字段(app 给卡片拼预览时认的那几个,加上名称类)+const CARD_TEXT_KEYS: &[&str] = &[+ "content",+ "text",+ "title",+ "label",+ "prompt",+ "summary",+ "reason",+ "description",+ "detail",+ "target",+ "action",+ "question",+ "body",+ "name",+ "serverName",+ "slug",+ "platform",+ "provider",+ "connectors",+ "toolId",+ "machineLabel",+];+const CARD_TEXT_MAX: usize = 8;++fn str_at<'a>(v: &'a Value, key: &str) -> &'a str {+ v.get(key).and_then(Value::as_str).unwrap_or_default()+}++fn name_of(v: Option<&Value>) -> Option<&str> {+ text_at(v?, "name")+}++/// `**标签**` 起头的一段:群聊里是谁说的、bot 之间的消息是发给谁的。正文是空的(流式中还没来+/// 内容的占位)整段给空,`push` 才滤得掉——只剩一个名字的消息不是消息(2026-10-11 Codex review)+fn labelled(label: &str, body: &str) -> String {+ if body.trim().is_empty() {+ return String::new();+ }+ let mut text = ParsedContent::default();+ text.push_text(&format!("**{label}**"));+ text.push_text(body);+ text.text+}++fn is_image_name(name: &str) -> bool {+ let ext = name.rsplit_once('.').map_or("", |(_, ext)| ext);+ [+ "png", "jpg", "jpeg", "gif", "webp", "heic", "heif", "avif", "bmp", "svg",+ ]+ .iter()+ .any(|known| ext.eq_ignore_ascii_case(known))+}++/// 你发的附件:文件在云端电脑上(`/home/box/…`),本机只有名字+fn attachment_label(e: &Value) -> String {+ let name = text_at(e, "file_name").unwrap_or_else(|| path_tail(str_at(e, "file_path")));+ if e.get("width").is_some() || is_image_name(name) {+ format!("[image: {name}]")+ } else {+ format!("[file: {name}]")+ }+}++/// 图片都是云端的地址或云端电脑上的路径,本机解不出来,留占位+fn text_with_images(m: &Value) -> String {+ let mut text = ParsedContent::default();+ text.push_text(str_at(m, "content"));+ for image in m+ .get("images")+ .and_then(Value::as_array)+ .into_iter()+ .flatten()+ {+ text.push_text(&match text_at(image, "alt") {+ Some(alt) => format!("[image: {alt}]"),+ None => IMAGE_PLACEHOLDER.to_string(),+ });+ }+ text.text+}++/// bot 发给你的文件+fn attachment_text(m: &Value) -> String {+ let url = str_at(m, "url");+ let name = text_at(m, "file_name").unwrap_or_else(|| path_tail(url));+ // 只有网页地址点得开;file:// 指的是云端电脑上的文件+ if url.starts_with("https://") || url.starts_with("http://") {+ format!("[file: {name}]({url})")+ } else {+ format!("[file: {name}]")+ }+}++/// 选项显示的文字:label,没有退回 value+fn option_label(option: &Value) -> Option<&str> {+ text_at(option, "label").or_else(|| text_at(option, "value"))+}++/// 让你选的问题卡片:问题、选项,和你选了什么+fn widget_text(m: &Value, e: &Value) -> String {+ let widget = m.get("widget").unwrap_or(&Value::Null);+ let options: Vec<&Value> = widget+ .get("options")+ .and_then(Value::as_array)+ .into_iter()+ .flatten()+ .collect();+ let mut out = ParsedContent::default();+ out.push_text(str_at(widget, "prompt"));+ let lines: Vec<String> = options+ .iter()+ .filter_map(|option| {+ let label = option_label(option)?;+ Some(match text_at(option, "description") {+ Some(description) => format!("- {label} — {description}"),+ None => format!("- {label}"),+ })+ })+ .collect();+ out.push_text(&lines.join("\n"));+ if let Some(answer) = text_at(e, "respondedValue") {+ // 回的是选项的 value,换回它的文字;自己填的原样+ let label = options+ .iter()+ .find(|option| str_at(option, "value") == answer)+ .and_then(|option| option_label(option))+ .unwrap_or(answer);+ out.push_text(&format!("Answer: {label}"));+ } else if true_at(e, "widgetSkipped") {+ out.push_text("Skipped");+ } else if true_at(e, "widgetDismissed") {+ out.push_text("Dismissed");+ }+ out.text+}++fn email_draft_text(m: &Value, e: &Value) -> String {+ let draft = m.get("draft").unwrap_or(&Value::Null);+ let to: Vec<&str> = draft+ .get("to")+ .and_then(Value::as_array)+ .into_iter()+ .flatten()+ .filter_map(Value::as_str)+ .collect();+ let mut head = format!("Email draft: {}", str_at(draft, "subject").trim());+ if !to.is_empty() {+ head.push_str(&format!("\nTo: {}", to.join(", ")));+ }+ let mut out = ParsedContent::default();+ out.push_text(&head);+ out.push_text(str_at(draft, "body"));+ if let Some(state) = text_at(e, "draftSendState") {+ out.push_text(&format!("Status: {state}"));+ }+ out.text+}++fn slack_draft_text(m: &Value) -> String {+ let draft = m.get("draft").unwrap_or(&Value::Null);+ let mut out = ParsedContent::default();+ out.push_text(&format!(+ "Slack draft to {}",+ str_at(draft, "target").trim()+ ));+ out.push_text(str_at(draft, "body"));+ out.text+}++/// 向你要一个密钥:只有要什么、填没填,值本身从不在缓存里+fn secret_request_text(m: &Value, e: &Value) -> String {+ let request = m.get("secretRequest").unwrap_or(&Value::Null);+ let mut out = ParsedContent::default();+ out.push_text(&format!(+ "Requested a secret: {}",+ str_at(request, "label").trim()+ ));+ out.push_text(str_at(request, "description"));+ if true_at(e, "secretProvided") {+ out.push_text("Provided");+ }+ out.text+}++/// 要你批准的一步操作(自动审核)+fn approval_text(m: &Value) -> String {+ let approval = m.get("approval").unwrap_or(&Value::Null);+ let summary = str_at(approval, "summary").trim();+ let mut out = ParsedContent::default();+ out.push_text(&match text_at(approval, "status") {+ Some(status) => format!("Approval ({status}): {summary}"),+ None => format!("Approval: {summary}"),+ });+ if let Some(command) = text_at(approval, "command") {+ out.push_text(&format!("`{command}`"));+ }+ out.push_text(str_at(approval, "reason"));+ out.text+}++/// 其余卡片:类型名加上卡片里的几段文字+fn card_summary(kind: &str, m: &Value) -> String {+ let mut parts = Vec::new();+ collect_card_text(m, 0, &mut parts);+ let label = humanize(kind).unwrap_or_else(|| "Card".to_string());+ if parts.is_empty() {+ label+ } else {+ format!("{label}: {}", parts.join("\n"))+ }+}++fn collect_card_text(v: &Value, depth: usize, out: &mut Vec<String>) {+ if depth > 3 || out.len() >= CARD_TEXT_MAX {+ return;+ }+ match v {+ Value::Object(map) => {+ for (key, value) in map {+ match value {+ Value::String(s) if CARD_TEXT_KEYS.contains(&key.as_str()) => {+ let s = s.trim();+ if !s.is_empty() && !out.iter().any(|seen| seen == s) {+ out.push(s.to_string());+ }+ }+ Value::Array(items) if CARD_TEXT_KEYS.contains(&key.as_str()) => {+ let names: Vec<&str> = items.iter().filter_map(Value::as_str).collect();+ if !names.is_empty() {+ out.push(names.join(", "));+ }+ }+ _ => collect_card_text(value, depth + 1, out),+ }+ if out.len() >= CARD_TEXT_MAX {+ return;+ }+ }+ }+ Value::Array(items) => {+ for item in items {+ collect_card_text(item, depth + 1, out);+ }+ }+ _ => {}+ }+}++/// `secret-request` → "Secret request";空的给 None+fn humanize(kind: &str) -> Option<String> {+ let words = kind.replace(['-', '_'], " ");+ let mut chars = words.trim().chars();+ let first = chars.next()?;+ Some(first.to_uppercase().chain(chars).collect())+}++fn voice_call(e: &Value) -> String {+ let secs = e+ .pointer("/call/durationMs")+ .and_then(Value::as_f64)+ .map_or(0, |ms| (ms / 1000.0).round() as i64);+ if secs > 0 {+ format!("Voice call ({}:{:02})", secs / 60, secs % 60)+ } else {+ "Voice call".to_string()+ }+}++fn event_text(e: &Value) -> String {+ let event = e.get("event").unwrap_or(&Value::Null);+ match str_at(event, "type") {+ "automation-changed" => format!(+ "Automation {}: {}",+ str_at(event, "action"),+ str_at(event, "automationName")+ ),+ "name-changed" => format!(+ "Renamed from “{}” to “{}”",+ str_at(event, "from"),+ str_at(event, "to")+ ),+ other => humanize(other).unwrap_or_else(|| "Event".to_string()),+ }+}++impl AgentAdapter for GrokBotAdapter {+ fn agent(&self) -> AgentId {+ AgentId::GrokBot+ }++ fn list_session_files(&self) -> Result<Vec<SessionFileRef>> {+ let files = self.store_files()?;+ let mut rosters: HashMap<&str, (&Path, Arc<Roster>)> = HashMap::new();+ for (path, slice) in &files {+ if let Slice::Roster { account } = slice {+ // 列表在却从没读成功过:报错,scanner 把这一家这一轮冻结住——当成"没有对话"会把+ // 卡片整批删掉+ let roster = self+ .roster(path)+ .ok_or_else(|| anyhow!("cannot read the Grok Bot conversation list"))?;+ rosters.insert(account.as_str(), (path.as_path(), roster));+ }+ }+ let mut refs = Vec::new();+ for (path, slice) in &files {+ if let Slice::Replica {+ account,+ conversation,+ } = slice+ {+ let row = rosters+ .get(account.as_str())+ .and_then(|(_, roster)| roster.get(conversation));+ refs.extend(replica_ref(path, conversation, row));+ }+ }+ // 有副本的对话也照列卡片:scanner 按 dedup_rank 取副本,副本被清掉、读不出时退回卡片+ for (path, roster) in rosters.values() {+ refs.extend(roster.iter().map(|(id, row)| card_ref(path, id, row)));+ }+ Ok(refs)+ }++ /// 副本文件,以及卡片的虚拟路径(scanner 按 file_path 重解析时用)+ fn file_ref(&self, path: &Path) -> Option<SessionFileRef> {+ if let Some((roster, id)) = path.to_str().and_then(card_parts) {+ return self+ .roster(roster)?+ .get(id)+ .map(|row| card_ref(roster, id, row));+ }+ let Some(Slice::Replica {+ account,+ conversation,+ }) = self.slice_at(path)+ else {+ return None;+ };+ let roster = self.roster_for(&account);+ let row = roster+ .as_deref()+ .and_then(|roster| roster.get(&conversation));+ replica_ref(path, &conversation, row)+ }++ /// 列表文件变了(改名、隐藏、新消息的预览),同一账号的副本的引用跟着变,它们自己却没动。+ /// 卡片的增删与重比走 `sessions_in`+ fn ref_dependents(&self, path: &Path) -> Vec<PathBuf> {+ let Some(Slice::Roster { account }) = self.slice_at(path) else {+ return Vec::new();+ };+ self.store_files()+ .unwrap_or_default()+ .into_iter()+ .filter_map(|(file, slice)| {+ matches!(&slice, Slice::Replica { account: a, .. } if *a == account).then_some(file)+ })+ .collect()+ }++ /// 列表文件此刻列着的卡片:bot 新建出来、从列表里删掉,卡片当场跟上。文件没了 = 这个账号一张+ /// 卡片都不剩;在却从没读成功过 = 不知道+ fn sessions_in(&self, path: &Path) -> Option<Vec<SessionFileRef>> {+ let Some(Slice::Roster { .. }) = self.slice_at(path) else {+ return None;+ };+ match self.roster(path) {+ Some(roster) => Some(+ roster+ .iter()+ .map(|(id, row)| card_ref(path, id, row))+ .collect(),+ ),+ None => (!path.exists()).then(Vec::new),+ }+ }++ fn parse_session(&self, r: &SessionFileRef) -> Result<ParsedSession> {+ let (meta, messages, unknown) = self.parse(r)?;+ Ok(ParsedSession::derive(meta, &messages, unknown))+ }++ fn parse_transcript(&self, r: &SessionFileRef) -> Result<ParsedTranscript> {+ let (meta, messages, unknown) = self.parse(r)?;+ Ok(ParsedTranscript {+ meta,+ mainline: messages,+ sidechains: Vec::new(),+ unknown_line_count: unknown,+ })+ }++ /// 同一对话的副本永远压过列表里的卡片——卡片只是副本被清掉之后的占位+ fn dedup_rank(&self, path: &str) -> u8 {+ u8::from(is_card(path))+ }++ /// 对话本体在云端,副本是 app 的缓存——移走了它照样写回来。删除只记墓碑,不动任何文件+ /// (确认框因此叫 Hide)+ fn session_paths(&self, _meta: &SessionMeta) -> Vec<String> {+ Vec::new()+ }++ fn with_custom_root(&self, dir: PathBuf) -> Box<dyn AgentAdapter> {+ Box::new(Self::at(store_dir_of(dir)))+ }++ fn data_roots(&self) -> Vec<PathBuf> {+ vec![self.root.clone()]+ }+}++/// 自定义 location 选中的目录 → 存储目录:选的就是 `sand-client-persistence`(或直接放着存储文件的+/// 拷贝)用它本身,其余当 userData 目录。只看选中的路径本身,不存在时落 userData 形态+fn store_dir_of(dir: PathBuf) -> PathBuf {+ if dir.file_name().is_some_and(|name| name == STORE_DIR) {+ return dir;+ }+ let holds_store_files = fs::read_dir(&dir).is_ok_and(|entries| {+ entries+ .flatten()+ .any(|entry| is_store_file(&entry.file_name().to_string_lossy()))+ });+ if holds_store_files {+ dir+ } else {+ dir.join(STORE_DIR)+ }+}++#[cfg(test)]+mod tests {+ use super::*;+ use serde_json::json;++ #[test]+ fn file_names_and_store_keys_round_trip() {+ // 本机存储目录里的真实文件名(键本身不含任何对话内容):编码与解码都对着 app 的写法+ const UI_LAYOUT: &str = "sand.client.slice.ui-layout";+ const NAME: &str = "onqw4zbomnwgszlooqxhg3djmnss45ljfvwgc6lpov2a.blob";+ assert_eq!(store_file_name(UI_LAYOUT).as_deref(), Some(NAME));+ assert_eq!(file_key(Path::new(NAME)).as_deref(), Some(UI_LAYOUT));+ let key = "sand.client.slice.account.google-oauth2%7Cuser_01ABC.transcript.replicas.0f0f-1";+ let name = store_file_name(key).unwrap();+ assert_eq!(file_key(Path::new(&name)).as_deref(), Some(key));+ // 编码后超过 240 字符的键 app 存成摘要名的 .kblob+ assert_eq!(store_file_name(&roster_key(&"x".repeat(150))), None);+ // 字母表外的字符、非零的填充位、写到一半的 .tmp 都不是键+ assert_eq!(base32_decode("onqw1"), None);+ assert_eq!(base32_decode("ob"), None);+ assert_eq!(file_key(Path::new(&format!("{name}.tmp"))), None);+ }++ #[test]+ fn keys_split_into_account_and_slice() {+ assert_eq!(+ slice_of("sand.client.slice.account.github%7C42.transcript.replicas.36c7-b95a"),+ Some(Slice::Replica {+ account: "github%7C42".into(),+ conversation: "36c7-b95a".into()+ })+ );+ assert_eq!(+ slice_of(&roster_key("github%7C42")),+ Some(Slice::Roster {+ account: "github%7C42".into()+ })+ );+ for other in [+ "sand.client.slice.ui-layout",+ "sand.client.slice.account.github%7C42.send-journal",+ "sand.client.slice.account.github%7C42.transcript.replicas.",+ "sand.client.slice.account..roster.last-roster",+ ] {+ assert_eq!(slice_of(other), None, "{other}");+ }+ }++ #[test]+ fn cards_are_told_apart_from_replicas_without_touching_the_disk() {+ assert!(is_card("/x/sand-client-persistence/abc.blob#36c7"));+ assert!(!is_card("/x/sand-client-persistence/abc.blob"));+ assert!(!is_card("/x/sand-client-persistence/abc.kblob"));+ assert_eq!(+ card_parts("/x/abc.blob#36c7").map(|(file, id)| (file.to_path_buf(), id)),+ Some((PathBuf::from("/x/abc.blob"), "36c7"))+ );+ // 真实路径里也可能有 `#`(家目录叫 a#b):不是卡片+ assert_eq!(card_parts("/Users/a#b/x/abc.blob"), None);+ assert_eq!(card_parts("/Users/a#b/x/abc.blob.tmp"), None);+ }++ fn replica_of(entries: Value) -> Replica {+ replica(&json!({"schemaVersion": 1, "value": {"entries": entries, "persistedAt": 1}}))+ .unwrap()+ }++ #[test]+ fn attachments_join_the_message_they_were_sent_with() {+ let r = replica_of(json!([+ {"kind": "user-attachment", "id": "a1", "seq": 1, "timestampMs": 10, "clientNonce": "n1",+ "file_path": "/home/box/agent-data/up/shot.png", "file_name": "shot.png", "width": 10, "height": 10},+ {"kind": "message", "id": "m1", "seq": 2, "timestampMs": 10, "clientNonce": "n1",+ "role": "user", "content": "看这个"},+ {"kind": "user-attachment", "id": "a2", "seq": 3, "timestampMs": 20, "clientNonce": "n2",+ "file_path": "/home/box/agent-data/up/notes.pdf"},+ {"kind": "send-message", "id": "s1", "seq": 4, "timestampMs": 30,+ "message": {"type": "text", "content": "收到"}}+ ]));+ let texts: Vec<(Role, &str)> = r+ .messages+ .iter()+ .map(|m| (m.role, m.text.as_str()))+ .collect();+ assert_eq!(+ texts,+ vec![+ (Role::User, "[image: shot.png]\n\n看这个"),+ (Role::User, "[file: notes.pdf]"),+ (Role::Assistant, "收到"),+ ]+ );+ assert_eq!(r.unknown, 0);+ }++ #[test]+ fn unknown_kinds_and_card_types_are_counted() {+ let r = replica_of(json!([+ {"kind": "hologram", "id": "x", "seq": 1},+ {"kind": "send-message", "id": "y", "seq": 2, "timestampMs": 5,+ "message": {"type": "teleport", "title": "Beam me up"}},+ {"kind": "send-message", "id": "z", "seq": 3, "timestampMs": 6,+ "message": {"type": "connectors", "connectors": ["gmail", "notion"]}}+ ]));+ assert_eq!(r.unknown, 2, "未知的条目种类与卡片类型各记一笔");+ let texts: Vec<&str> = r.messages.iter().map(|m| m.text.as_str()).collect();+ assert_eq!(+ texts,+ vec!["Teleport: Beam me up", "Connectors: gmail, notion"]+ );+ }++ /// 流式中的空占位不成消息:群聊里带 author 的、bot 之间互发的,标签不能把空正文顶成一条+ #[test]+ fn empty_streaming_messages_stay_out_even_with_a_label() {+ let r = replica_of(json!([+ {"kind": "send-message", "id": "s1", "seq": 1, "timestampMs": 5,+ "author": {"name": "Scout"}, "message": {"type": "text", "content": ""}},+ {"kind": "message", "id": "m1", "seq": 2, "timestampMs": 6, "role": "user",+ "fromAgent": {"name": "Scout"}, "content": " "},+ {"kind": "message", "id": "m2", "seq": 3, "timestampMs": 7, "role": "assistant",+ "toAgent": {"name": "Scout"}, "content": ""}+ ]));+ assert!(r.messages.is_empty(), "{:?}", r.messages);+ }++ /// 列表一时读不出(权限、锁):错误过去之后文件的 mtime / size 没变,也得重新读到+ #[cfg(unix)]+ #[test]+ fn a_roster_that_could_not_be_read_is_read_again() {+ use std::os::unix::fs::PermissionsExt;+ let tmp = tempfile::tempdir().unwrap();+ let adapter = GrokBotAdapter::at(tmp.path().to_path_buf());+ let path = tmp+ .path()+ .join(store_file_name(&roster_key("github%7C1")).unwrap());+ fs::write(+ &path,+ r#"{"schemaVersion":4,"value":{"rows":[{"id":"c1","name":"Ada"}]}}"#,+ )+ .unwrap();+ fs::set_permissions(&path, fs::Permissions::from_mode(0o000)).unwrap();+ // root 读得动没有权限的文件,前提不成立就不测+ if fs::read(&path).is_err() {+ assert!(adapter.roster(&path).is_none());+ }+ fs::set_permissions(&path, fs::Permissions::from_mode(0o644)).unwrap();+ assert!(adapter+ .roster(&path)+ .is_some_and(|roster| roster.contains_key("c1")));+ }+}diff --git a/crates/wake-core/src/adapters/kilo.rs b/crates/wake-core/src/adapters/kilo.rsindex e3bacc4..9e60ff0 100644--- a/crates/wake-core/src/adapters/kilo.rs+++ b/crates/wake-core/src/adapters/kilo.rs@@ -42,7 +42,7 @@ const ITEM_FILE: &str = "history_item.json";const INDEX_FILE: &str = "_index.json";/// 可能装过旧版扩展的 VS Code 系编辑器:(用户数据目录名, 显示名)。用户数据根三平台-/// 各异(`vscode_user_data`),目录名相同。显示名作 via 徽章+/// 各异(`electron_user_data`),目录名相同。显示名作 via 徽章const EDITORS: &[(&str, &str)] = &[("Code", "VS Code"),("Code - Insiders", "VS Code Insiders"),@@ -338,7 +338,9 @@ impl KiloLegacyAdapter {/// 在 Wake 启动后才冒出来pub fn new() -> Self {let home = super::home_dir().unwrap_or_default();- let editors = EDITORS.iter().map(|(dir, _)| super::vscode_user_data(dir));+ let editors = EDITORS+ .iter()+ .map(|(dir, _)| super::electron_user_data(dir));let servers = SERVERS.iter().map(|(dir, _)| home.join(dir).join("data"));let roots = editors.chain(servers)diff --git a/crates/wake-core/src/adapters/mod.rs b/crates/wake-core/src/adapters/mod.rsindex 89641e8..f04b9d1 100644--- a/crates/wake-core/src/adapters/mod.rs+++ b/crates/wake-core/src/adapters/mod.rs@@ -10,6 +10,7 @@ pub mod devin;pub mod dsh;pub mod gemini;pub mod grok;+pub mod grok_bot;pub mod hermes;pub mod kilo;pub mod kimi;@@ -27,6 +28,8 @@ pub(crate) mod parse_utils;pub(crate) mod pi_format;pub(crate) mod sqlite_ro;+/// `<文件>#<id>` 虚拟路径拆成两半(不看磁盘)+pub use sqlite_ro::split_virtual_path;/// The local source file for a session, including mirrored remote sessions./// Database-backed sessions resolve to their shared database, without `#<id>`.pub use sqlite_ro::strip_virtual_path as session_source_path;@@ -64,14 +67,24 @@ pub trait AgentAdapter: Send + Sync {fn file_ref(&self, path: &Path) -> Option<SessionFileRef> {parse_utils::default_file_ref(self.agent(), path)}- /// 这份会话文件出现或消失时,还有哪些文件的引用(`file_ref` 的 mtime / size)跟着变——那些- /// 文件没动,watcher 收不到它们的事件。默认没有;Claude 分支的引用数着同目录更早的同根- /// 文件,原件被删、被放回,同目录的分支要重解析(展开 / 折叠复制来的历史)。watcher 对新- /// 出现与消失的路径各问一次,只把引用真变了的交给增量收编;全量扫描本来就逐个重比引用,- /// 用不着它。远程装饰器必须转发+ /// 这条路径上的文件出现、变了或消失时,还有哪些会话文件的引用(`file_ref` 的 mtime / size)+ /// 跟着变——那些文件没动,watcher 收不到它们的事件。watcher 对**每一条不是已入库会话文件的+ /// 事件路径**(新出现的会话文件,或者从不入库的共享边车)与每一条消失的路径各问一次,只把+ /// 引用真变了的交给增量收编;全量扫描本来就逐个重比引用,用不着它。默认没有。Claude 分支的+ /// 引用数着同目录更早的同根文件,原件被删、被放回,同目录的分支要重解析(展开 / 折叠复制来的+ /// 历史);Grok Bot 副本的引用并进了侧栏列表里那一行的指纹,列表变了,同账号的副本都要重比。+ /// 远程装饰器必须转发fn ref_dependents(&self, _path: &Path) -> Vec<std::path::PathBuf> {Vec::new()}+ /// 一个文件装着好几个会话、各以虚拟路径 `<文件>#<id>`(`sqlite_ro::virtual_path`)入库时,这个+ /// 文件**此刻**装着的全部会话。watcher 对每条事件路径(出现、变了、消失)问一次、按它对账:库里+ /// 挂在这个文件名下、这份里没有的出库,新的与引用变了的收编,不用等下一次全量扫描。None = 不是+ /// 这种文件,或这一刻读不出(库里原样不动)。默认 None:SQLite 型的家至今靠启动与 ⌘R 刷新;+ /// Grok Bot 的卡片靠它随侧栏列表增删。远程装饰器必须转发+ fn sessions_in(&self, _path: &Path) -> Option<Vec<SessionFileRef>> {+ None+ }/// 快路径:不解析文件直接给出 meta(Codex 走 state DB)。None = 无快路径fn quick_meta(&self,@@ -181,7 +194,7 @@ pub trait AgentAdapter: Send + Sync {/// 拥有本家 session 文件的位置",凭据/配置/索引这类不产生会话的文件不列。/// 新增 adapter 必须实现:没有默认值,漏了编译就过不去fn data_roots(&self) -> Vec<std::path::PathBuf>;- /// 文件监听根目录。默认 = data_roots 中现存的目录,二十二家实测全部吻合:+ /// 文件监听根目录。默认 = data_roots 中现存的目录,各家实测全部吻合:/// 目录型给出自己的 root,SQLite 型的根是库文件、天然筛空(watcher 只认/// .jsonl,库变更靠启动/手动刷新),codex 的 sessions + archived 一并覆盖。/// 只有当监听范围确实不同于数据根时才覆写——否则一次根路径搬迁@@ -293,12 +306,13 @@ pub(crate) fn env_dir(key: &str) -> Option<std::path::PathBuf> {.map(std::path::PathBuf::from)}-/// VS Code 系编辑器的用户数据目录(`<数据根>/<编辑器>`,下面是 `User/globalStorage`):+/// Electron app 的用户数据目录(`app.getPath('userData')`,`<数据根>/<app 名>`):/// macOS 在 `~/Library/Application Support`,Windows 在 `%APPDATA%`,Linux 在/// `$XDG_CONFIG_HOME`(缺省 `~/.config`)。只做路径推导、不探存在性。全从 `home_dir()`/// 派生——`dirs::config_dir()` 在 Windows 上走 SHGetKnownFolderPath,WAKE_HOME 改道对它-/// 无效。Cursor IDE 的 state.vscdb 与 Kilo 旧版扩展的任务目录共用-pub(crate) fn vscode_user_data(editor: &str) -> std::path::PathBuf {+/// 无效。VS Code 系编辑器(Cursor IDE 的 state.vscdb、Kilo 旧版扩展的任务目录,下面是+/// `User/globalStorage`)与 Grok Bot 的缓存目录共用+pub(crate) fn electron_user_data(app: &str) -> std::path::PathBuf {let home = home_dir().unwrap_or_default();let base = if cfg!(target_os = "macos") {home.join("Library").join("Application Support")@@ -307,7 +321,7 @@ pub(crate) fn vscode_user_data(editor: &str) -> std::path::PathBuf {} else {env_dir("XDG_CONFIG_HOME").unwrap_or_else(|| home.join(".config"))};- base.join(editor)+ base.join(app)}/// 自定义 location / 远程挂载点 `dir` 交给同家哪个实例构造(见 `claims_custom_root`)@@ -328,7 +342,7 @@ pub(crate) fn custom_root_template<'a>(/// 各家数据根共用的 HOME。**全部 adapter 必须走这里**,不要直接/// `dirs::home_dir()`——`WAKE_HOME` 是整组 adapter 的统一改道开关:-/// 契约测试靠它把二十二家指向 fixture 目录,而 `dirs::home_dir()` 只在+/// 契约测试靠它把各家指向 fixture 目录,而 `dirs::home_dir()` 只在/// POSIX 上看 `$HOME`,Windows 上走 SHGetKnownFolderPath、无论如何都指向/// 真实用户目录(于是 Windows 上的契约测试全部落空,2026-08-25 review)。/// 对用户它顺带是便携安装/多档案切换的手动开关。@@ -336,7 +350,7 @@ pub(crate) fn home_dir() -> Option<std::path::PathBuf> {env_dir("WAKE_HOME").or_else(dirs::home_dir)}-/// 全量二十二家 roster,**不按 detect 过滤**。这是全应用唯一的构造点:+/// 全量 roster(每家都在),**不按 detect 过滤**。这是全应用唯一的构造点:/// scanner/watcher/resume/Session locations 面板共享 Workbench 启动时的/// 同一份实例。缺根的家由各自 list_session_files 降级为 Ok(空)(Err 会让/// scanner 把这一家这一轮当成"读不出"冻结住,缺根不是读不出,contract 测试@@ -376,6 +390,7 @@ pub fn create_adapters() -> Vec<Box<dyn AgentAdapter>> {Box::new(devin::DevinAdapter::new()),Box::new(opencode::OpencodeAdapter::kilo()),Box::new(kilo::KiloLegacyAdapter::new()),+ Box::new(grok_bot::GrokBotAdapter::new()),]}diff --git a/crates/wake-core/src/adapters/parse_utils.rs b/crates/wake-core/src/adapters/parse_utils.rsindex 8822d17..0d1f836 100644--- a/crates/wake-core/src/adapters/parse_utils.rs+++ b/crates/wake-core/src/adapters/parse_utils.rs@@ -126,6 +126,28 @@ fn system_time_ms(t: std::time::SystemTime) -> Option<i64> {.map(|d| d.as_millis() as i64)}+/// 路径末段,`/` 与 `\` 都算分隔符:别的机器写下的路径(Codex 的 state DB 可能是 Windows 机器写的、+/// Grok Bot 的附件在云端电脑上),不能交给本机的 `Path`+pub fn path_tail(path: &str) -> &str {+ path.rsplit(['/', '\\']).next().unwrap_or(path)+}++/// 并进 `SessionFileRef.size` 的边车指纹:展示要用的那几个字段的稳定哈希(FNV-1a,段与段之间隔一个+/// 0 字节),取高 32 位——FNV 的低位只由各字节的低位决定,原先按 1024 取模,"Oscar" 与 "Ada 4" 就+/// 撞在一起,改了名也认不出(2026-10-11 Codex review)。size 因此不再是字节数,没有谁拿会话的+/// size 当字节数用(界面、MCP、导出、Clean Up 都现 stat 文件)。按长度求和的话同长的改名认不+/// 出来(Antigravity 与 Kilo 旧版任务还在求和,换过来会让它们的会话各重解析一次)+pub fn sidecar_fingerprint(parts: &[&str]) -> i64 {+ let mut hash: u64 = 0xcbf2_9ce4_8422_2325;+ for part in parts {+ for byte in part.bytes().chain(std::iter::once(0)) {+ hash ^= u64::from(byte);+ hash = hash.wrapping_mul(0x0100_0000_01b3);+ }+ }+ (hash >> 32) as i64+}+/// cwd → 项目显示名(路径末段;空/异常 = "Unknown project")pub fn project_name_of(cwd: &str) -> String {if cwd.is_empty() {@@ -313,6 +335,19 @@ pub fn project_tree_has_session(root: &std::path::Path, agent: AgentId) -> bool})}+/// `optional_string` 的借用版:`key` 上修剪过、非空的字符串+pub fn text_at<'a>(v: &'a Value, key: &str) -> Option<&'a str> {+ v.get(key)+ .and_then(Value::as_str)+ .map(str::trim)+ .filter(|s| !s.is_empty())+}++/// `key` 上是 `true`(缺席、别的类型都算不是)+pub fn true_at(v: &Value, key: &str) -> bool {+ v.get(key).and_then(Value::as_bool) == Some(true)+}+/// JSON 里"有就是非空字符串、否则没有"的字段:标题、模型名、cwd 一类pub fn optional_string(v: Option<&Value>) -> Option<String> {v.and_then(Value::as_str)@@ -1239,6 +1274,24 @@ mod tests {));}+ #[test]+ fn sidecar_fingerprints_tell_renames_apart() {+ // 按 1024 取模时这两个名字撞在同一个值上(2026-10-11 Codex review)+ assert_ne!(+ sidecar_fingerprint(&["Oscar", ""]),+ sidecar_fingerprint(&["Ada 4", ""])+ );+ // 段界算数:字段之间挪一个字不是同一份+ assert_ne!(+ sidecar_fingerprint(&["ab", "c"]),+ sidecar_fingerprint(&["a", "bc"])+ );+ assert_eq!(+ sidecar_fingerprint(&["Ada", "hidden"]),+ sidecar_fingerprint(&["Ada", "hidden"])+ );+ }+#[test]fn jsonl_lines_stop_on_a_persistent_read_error() {// 一直读不出来(EIO、断开的网络盘):交一次 Err 就结束,不打转diff --git a/crates/wake-core/src/adapters/remote.rs b/crates/wake-core/src/adapters/remote.rsindex 30980ac..fdd22df 100644--- a/crates/wake-core/src/adapters/remote.rs+++ b/crates/wake-core/src/adapters/remote.rs@@ -50,7 +50,7 @@ impl RemoteAdapter {}}-/// 对一个 host 构造整组远程实例:二十二家模板 × `with_custom_root`(缓存内+/// 对一个 host 构造整组远程实例:同步的各家模板 × `with_custom_root`(缓存内/// 挂载点,见 remote::REMOTE_LAYOUTS)× 装饰器。追加进 roster 的 active 尾部/// (不进 Session locations 面板)。`templates` 由 roster 唯一构造点传入/// (不变量 8:本模块不得自行二次 create_adapters());产物的数据根 100%@@ -97,6 +97,10 @@ impl AgentAdapter for RemoteAdapter {self.inner.ref_dependents(path)}+ fn sessions_in(&self, path: &Path) -> Option<Vec<SessionFileRef>> {+ self.inner.sessions_in(path)+ }+fn quick_meta(&self,refs: &[SessionFileRef],diff --git a/crates/wake-core/src/adapters/sqlite_ro.rs b/crates/wake-core/src/adapters/sqlite_ro.rsindex e2aa36a..908dc37 100644--- a/crates/wake-core/src/adapters/sqlite_ro.rs+++ b/crates/wake-core/src/adapters/sqlite_ro.rs@@ -77,13 +77,25 @@ pub fn virtual_path(db: &Path, id: &str) -> String {format!("{}#{id}", db.display())}-/// virtual_path 的逆:磁盘上不存在的路径剥掉 `#<id>` 还原库文件本体,-/// 真实存在的路径原样返回(文件管理器 reveal 用)。格式知识只在本文件。+/// 挂在 `db` 名下的全部虚拟路径都落在这个半开区间里:按字节序比,`$` 紧跟在 `#` 后面+/// (`Store::file_paths_in` 拿它走 file_path 的唯一索引,不整表扫)+pub fn virtual_path_bounds(db: &Path) -> (String, String) {+ (virtual_path(db, ""), format!("{}$", db.display()))+}++/// virtual_path 的逆:`<文件>#<id>` → (文件, id);没有 `#` 给 None。不看磁盘——真实路径里也可能+/// 有 `#`,是不是虚拟路径由调用方认(strip_virtual_path 看存在性,Grok Bot 看后缀)+pub fn split_virtual_path(path: &str) -> Option<(&str, &str)> {+ path.rsplit_once('#')+}++/// 磁盘上不存在的路径剥掉 `#<id>` 还原库文件本体,真实存在的路径原样返回(文件管理器 reveal 用)。+/// 格式知识只在本文件。pub fn strip_virtual_path(path: &str) -> &str {if Path::new(path).exists() {path} else {- path.rsplit_once('#').map(|(db, _)| db).unwrap_or(path)+ split_virtual_path(path).map_or(path, |(db, _)| db)}}diff --git a/crates/wake-core/src/bin/wake_cli.rs b/crates/wake-core/src/bin/wake_cli.rsindex 102f987..89bba85 100644--- a/crates/wake-core/src/bin/wake_cli.rs+++ b/crates/wake-core/src/bin/wake_cli.rs@@ -209,7 +209,7 @@ fn setup(db: &Option<PathBuf>) -> String {// sibling_named 取的就是 current_exe 同级目录,从 wake-cli 调恰好对let mcp_bin = mcp::sibling_file("wake-mcp");let path = db_path(db);- // 只探库,不必为一行提示把二十二家 roster 建起来+ // 只探库,不必为一行提示把整份 roster 建起来let db_error = Store::open_read_only(&path).err().map(|e| format!("{e:#}"));cli::setup_text(&cli::SetupFacts {cli_bin: &cli_bin,diff --git a/crates/wake-core/src/bin/wake_mcp.rs b/crates/wake-core/src/bin/wake_mcp.rsindex 2739f53..e546ae2 100644--- a/crates/wake-core/src/bin/wake_mcp.rs+++ b/crates/wake-core/src/bin/wake_mcp.rs@@ -102,7 +102,7 @@ fn main() -> ExitCode {for s in mcp::setup_snippets(&bin) {let _ = writeln!(out, "## {} — {}\n\n{}\n", s.client, s.hint, s.text);}- // 只探库,不必为一行提示把二十二家 roster 建起来+ // 只探库,不必为一行提示把整份 roster 建起来if let Err(e) = Store::open_read_only(&db_path(&args.db)) {let _ = writeln!(out, "Note: {e:#}");}diff --git a/crates/wake-core/src/cleanup.rs b/crates/wake-core/src/cleanup.rsindex 32f8428..b24a662 100644--- a/crates/wake-core/src/cleanup.rs+++ b/crates/wake-core/src/cleanup.rs@@ -823,15 +823,17 @@ pub fn retry_index_updates(store: &Store, batch: &mut CleanupBatch) -> Result<us/// 详情页的删除:移动**之前**先给每份会话文件记放回指纹(`put_back_fingerprint`),再把磁盘/// 目标移进废纸篓、出库并记墓碑(`Store::remove_trashed_sessions`)——用户从废纸篓放回原处,/// 扫描认出同一份文件就撤掉墓碑。返回 true = 一个文件都没移:会话只在别家自己的库里(虚拟-/// 路径),Wake 只是不再列出它+/// 路径),或者 adapter 的 `session_paths` 把文件留在原处,Wake 只是不再列出它pub fn trash_sessions(store: &Store, sessions: &[SessionMeta], targets: &[String]) -> Result<bool> {- let prints: HashMap<String, (i64, i64)> = sessions+ let mut prints: HashMap<String, (i64, i64)> = sessions.iter().filter_map(|s| {put_back_fingerprint(Path::new(&s.file_path)).map(|print| (s.file_path.clone(), print))}).collect();let moved = terminal::trash_paths(targets)?;+ // 指纹只留给真移进废纸篓的文件:留在原处的那份下一轮扫描就会被认成"放回来了",墓碑当场撤掉+ prints.retain(|path, _| moved.iter().any(|m| crate::adapters::path_owns(m, path)));let keys: Vec<String> = sessions.iter().map(|s| s.key.clone()).collect();store.remove_trashed_sessions(&keys, &prints)?;Ok(moved.is_empty())diff --git a/crates/wake-core/src/db.rs b/crates/wake-core/src/db.rsindex ed617ec..acbd9f2 100644--- a/crates/wake-core/src/db.rs+++ b/crates/wake-core/src/db.rs@@ -1214,6 +1214,24 @@ impl Store {.optional()?)}+ /// file_path 落在 `[from, to)` 里的会话路径。watcher 对账 `sessions_in` 时拿它取挂在一个文件+ /// 名下的虚拟路径(区间由 `sqlite_ro::virtual_path_bounds` 给)+ pub fn file_paths_in(&self, from: &str, to: &str) -> Result<Vec<String>> {+ let conn = self.read.lock().unwrap();+ let mut stmt = conn.prepare_cached(+ "SELECT file_path FROM sessions WHERE file_path >= ?1 AND file_path < ?2",+ )?;+ let rows = stmt.query_map(params![from, to], |r| r.get(0))?;+ Ok(rows.collect::<rusqlite::Result<_>>()?)+ }++ /// 这个 key 眼下挂在哪条路径上;没入库给 None+ pub fn file_path_of(&self, key: &str) -> Result<Option<String>> {+ let conn = self.read.lock().unwrap();+ let mut stmt = conn.prepare_cached("SELECT file_path FROM sessions WHERE key = ?1")?;+ Ok(stmt.query_row(params![key], |r| r.get(0)).optional()?)+ }+/// 一条会话停在哪:主线上最后一句用户提问与最后一条助手回复,各折成一行(单元怎么读回/// 一句话在 `adapters::unit_prompt` / `unit_reply`,与写单元的 `units_from_messages` 放在/// 一处)。新会话开场的交接用(`tools::session_start_context`)。两个角色各查各的:一次diff --git a/crates/wake-core/src/models.rs b/crates/wake-core/src/models.rsindex a0018d9..bfe1ffe 100644--- a/crates/wake-core/src/models.rs+++ b/crates/wake-core/src/models.rs@@ -1,13 +1,15 @@use serde::{Deserialize, Serialize};/// 变体声明序即侧栏固定展示序(derive Ord 直接按此序比较)——-/// 顺序为用户指定(2026-08-20),新增 agent 问过用户再定位置,勿擅动老条目+/// 顺序为用户指定(2026-08-20;Grok Bot 2026-10-11 用户定排在 Grok Build 之后),新增 agent+/// 问过用户再定位置,勿擅动老条目#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)]#[serde(rename_all = "kebab-case")]pub enum AgentId {ClaudeCode,Codex,Grok,+ GrokBot,Dsh,Cursor,Opencode,@@ -30,13 +32,14 @@ pub enum AgentId {}impl AgentId {- /// 全部二十二家,**枚举声明序**(= Ord = 用户钉的侧栏展示序;面板成组、+ /// 全部 agent,**枚举声明序**(= Ord = 用户钉的侧栏展示序;面板成组、/// 表单下拉共用同一顺序)。曾误抄 create_adapters 的构造序,下拉与侧栏/// 排序当场对不上——契约测试现在卡它与 Ord 一致- pub const ALL: [AgentId; 22] = [+ pub const ALL: [AgentId; 23] = [AgentId::ClaudeCode,AgentId::Codex,AgentId::Grok,+ AgentId::GrokBot,AgentId::Dsh,AgentId::Cursor,AgentId::Opencode,@@ -82,6 +85,7 @@ impl AgentId {AgentId::CraftAgents => "craft-agents",AgentId::Devin => "devin",AgentId::Kilo => "kilo",+ AgentId::GrokBot => "grok-bot",}}@@ -109,6 +113,7 @@ impl AgentId {"craft-agents" => Some(AgentId::CraftAgents),"devin" => Some(AgentId::Devin),"kilo" => Some(AgentId::Kilo),+ "grok-bot" => Some(AgentId::GrokBot),_ => None,}}@@ -137,6 +142,7 @@ impl AgentId {AgentId::CraftAgents => "Craft Agents",AgentId::Devin => "Devin",AgentId::Kilo => "Kilo Code",+ AgentId::GrokBot => "Grok Bot",}}@@ -239,6 +245,9 @@ impl AgentId {"brands/kilo-light.png"}}+ // 官方 app 图标(黑底圆角方块里一张带两只眼睛的白脸),两模式通用,ZCode 同款。图标里只有+ // 256px 的位图,侧栏尺寸下够用+ AgentId::GrokBot => "brands/grok-bot.png",}}}@@ -984,7 +993,7 @@ pub const UNTITLED: &str = "Untitled";/// 会话 key 的唯一构造点:本地 `{agent}:{native_id}`,远程/// `{agent}:{host}:{native_id}`。scanner 的墓碑查询、watcher 的幸存者反查、/// 远程装饰器的 key 改写都走这里——"远程 key 长什么样"只此一处知识。-/// (二十二家 adapter 的本地两段构造保留各自 `format!`,它们从不涉及 host。)+/// (各家 adapter 的本地两段构造保留各自 `format!`,它们从不涉及 host。)pub fn session_key(agent: AgentId, host: &str, native_id: &str) -> String {if host.is_empty() {format!("{}:{native_id}", agent.as_str())diff --git a/crates/wake-core/src/remote.rs b/crates/wake-core/src/remote.rsindex 07744c5..5af70d6 100644--- a/crates/wake-core/src/remote.rs+++ b/crates/wake-core/src/remote.rs@@ -16,7 +16,7 @@//! ①openrsync(macOS 15+ 的 /usr/bin/rsync)做发送端时,某个源连父目录//! 都不存在会让它中止整份文件列表,排在后面的源全部静默不传,退出码却//! 只是 23;②rsync 家族只要发送端遇到任何 I/O 错误(缺源即算)就整体跳过-//! 删除阶段——没有哪台机器二十二家全装,`--delete` 就永远不会生效。+//! 删除阶段——没有哪台机器各家全装,`--delete` 就永远不会生效。//!//! 同步跑在**独立于扫描的线程**(Workbench::spawn_remote_sync):本地扫描//! 不等网络,不可达 host 只拖慢自己;缓存落盘由 watcher 增量收编,同步@@ -49,7 +49,7 @@ pub struct RemoteAgentLayout {pub exclude: &'static [&'static str],}-/// 二十二家的远程布局。远程主机按 Linux/macOS 默认路径假设(两平台一致,+/// 同步的各家的远程布局。远程主机按 Linux/macOS 默认路径假设(两平台一致,/// 均为 home 相对;OpenCode 的 XDG 变体、CODEX_HOME 这类 env 覆盖在远端/// 探测不到,阶段 1 不支持非默认远程布局)。pub const REMOTE_LAYOUTS: &[RemoteAgentLayout] = &[@@ -275,6 +275,14 @@ pub const REMOTE_LAYOUTS: &[RemoteAgentLayout] = &[},];+/// 有意不做远程同步的家:不进 REMOTE_LAYOUTS,也就没有远程实例。覆盖测试要求每家在两张表里+/// 恰好出现一次——新加的家漏写白名单在测试里爆,而不是静默不同步+pub const NOT_SYNCED: &[AgentId] = &[+ // 本机那份是云端对话的缓存:另一台机器上的 app 缓存着同一批对话,同步过来同一个对话会按 host+ // 各列一遍(副本去重的域含 host)。缓存目录名带空格是次要的,白名单补上引号也不该同步+ AgentId::GrokBot,+];+/// host 名合法性:进 session key 作中段(不能有 ':')、直接作为 ssh/rsync/// 目标(不能以 '-' 开头——那会被当作命令行选项,是参数注入面)。允许/// `user@host`、别名、IPv4;IPv6 字面量请在 `~/.ssh/config` 里包一个别名。@@ -643,6 +651,12 @@ mod tests {}assert!(!layout.mount.starts_with('/'));}+ for agent in NOT_SYNCED {+ assert!(+ seen.insert(*agent),+ "{agent:?} is both synced and not synced"+ );+ }for agent in AgentId::ALL {assert!(seen.contains(&agent), "missing remote layout for {agent:?}");}diff --git a/crates/wake-core/src/scanner.rs b/crates/wake-core/src/scanner.rsindex 4c33e06..129b351 100644--- a/crates/wake-core/src/scanner.rs+++ b/crates/wake-core/src/scanner.rs@@ -357,7 +357,8 @@ pub fn run_memory_sync(adapters: &[Box<dyn AgentAdapter>], store: &Arc<Store>) -/// 写事务内副本裁决(`Store::write_session_guarded`)用的位次查询:按 file_path/// 找拥有它的实例、问它这份副本的 `dedup_rank`;无实例认领的路径落到该家首个/// 实例——与枚举时的候选排序同一把尺子,全量与增量两条写库路径才给出同一个胜者-fn rank_of<'a>(+/// (watcher 预判一份副本值不值得交给 scan_files 也用它)+pub(crate) fn rank_of<'a>(adapters: &'a [Box<dyn AgentAdapter>],agent: crate::models::AgentId,) -> impl Fn(&str) -> u8 + 'a {diff --git a/crates/wake-core/src/services/terminal/mod.rs b/crates/wake-core/src/services/terminal/mod.rsindex b24df6d..202a7ff 100644--- a/crates/wake-core/src/services/terminal/mod.rs+++ b/crates/wake-core/src/services/terminal/mod.rs@@ -155,6 +155,8 @@ pub fn agent_bin(agent: AgentId) -> Option<&'static str> {AgentId::Devin => Some("devin"),// npm 包 @kilocode/cli 装出 `kilo` 与 `kilocode` 两个同一份的命令AgentId::Kilo => Some("kilo"),+ // Grok Bot 是桌面 app,bot 跑在云端电脑上,没有命令行+ AgentId::GrokBot => None,}}@@ -230,6 +232,8 @@ fn resume_args(meta: &SessionMeta) -> Option<(Vec<String>, bool)> {// 新版 CLI 不认(导入 kilo.db 之前它不在库里)——胜出副本是旧任务文件就不画AgentId::Kilo if crate::adapters::kilo::is_legacy_task(&meta.file_path) => None,AgentId::Kilo => Some((vec!["--session".into(), id.into()], true)),+ // Grok Bot:对话在云端、只有桌面 app,没有能接着聊的命令——不画 Open In+ AgentId::GrokBot => None,// Kiro / Gemini CLI 没有按会话 id 续会话的形制AgentId::Kiro | AgentId::Gemini => None,}diff --git a/crates/wake-core/src/watcher.rs b/crates/wake-core/src/watcher.rsindex e67cf95..584843e 100644--- a/crates/wake-core/src/watcher.rs+++ b/crates/wake-core/src/watcher.rs@@ -1,7 +1,7 @@use crate::adapters::AgentAdapter;use crate::db::Store;use crate::models::*;-use crate::scanner::{refresh_claims, refresh_parent_links, scan_files, ScanEvents};+use crate::scanner::{rank_of, refresh_claims, refresh_parent_links, scan_files, ScanEvents};use notify::{RecursiveMode, Watcher};use std::collections::{HashMap, HashSet};use std::path::{Path, PathBuf};@@ -161,19 +161,21 @@ pub(crate) fn process_batch(}}- // 新出现(还没入库)与消失的会话文件可能改变同实例别的文件的引用(`ref_dependents`:- // Claude 的分支数着同目录更早的同根文件)。那些文件没动、没有事件,这里按引用与索引+ // 不是已入库会话文件的路径(新出现的会话文件,或者从不入库的共享边车——Grok Bot 的侧栏列表)+ // 与消失的路径,可能改变同实例别的文件的引用(`ref_dependents`:Claude 的分支数着同目录更早的+ // 同根文件,Grok Bot 的副本并进了列表行的指纹)。那些文件没动、没有事件,这里按引用与索引// 重比,变了的跟本批一起收编——Wake 里删原件、从废纸篓放回、Claude 自己清理旧会话,// 留下的分支都当场展开 / 折叠,不用等下一次全量扫描+ let vanished: Vec<(&PathBuf, usize)> = gone+ .iter()+ .filter_map(|path| resolve_watch_agent(roots, path).map(|ix| (path, ix)))+ .collect();let appeared = present.iter().filter(|(path, _)| matches!(store.file_stamp(&path.to_string_lossy()), Ok(None))).map(|(path, ix)| (path, *ix));- let vanished = gone- .iter()- .filter_map(|path| resolve_watch_agent(roots, path).map(|ix| (path, ix)));- let dependents: Vec<SessionFileRef> = appeared- .chain(vanished)+ let mut dependents: Vec<SessionFileRef> = appeared+ .chain(vanished.iter().copied()).flat_map(|(path, ix)| {let adapter = &adapters[ix];adapter@@ -188,9 +190,52 @@ pub(crate) fn process_batch(}).collect();+ // 装着好几个会话的文件(`sessions_in`,Grok Bot 的侧栏列表):库里挂在它名下的虚拟路径按它+ // 此刻的内容对账——新出现的收编,没了的出库,引用变了的重解析+ let mut dropped: Vec<String> = Vec::new();+ let every_path = present.iter().map(|(path, ix)| (path, *ix));+ for (path, ix) in every_path.chain(vanished.iter().copied()) {+ let adapter = &adapters[ix];+ let Some(listed) = adapter.sessions_in(path) else {+ continue;+ };+ let rank = rank_of(adapters, adapter.agent());+ let (from, to) = crate::adapters::sqlite_ro::virtual_path_bounds(path);+ let Ok(indexed) = store.file_paths_in(&from, &to) else {+ continue;+ };+ let still_there: HashSet<&str> = listed.iter().map(|r| r.file_path.as_str()).collect();+ dropped.extend(+ indexed+ .into_iter()+ .filter(|indexed| !still_there.contains(indexed.as_str())),+ );+ dependents.extend(+ listed+ .into_iter()+ .filter(|r| match store.file_stamp(&r.file_path) {+ Ok(Some(stamp)) => stamp != (r.mtime_ms, r.size),+ // 没入库的:同一会话已由别的文件代表着、那一份的副本位次又严格更优(Grok Bot+ // 有副本的对话),交给 scan_files 也必败;同级的(两个 location 各一张卡片)+ // 交给写事务里的副本裁决按 mtime 定(2026-10-11 Codex review)+ Ok(None) => {+ let key = session_key(r.agent, adapter.host(), &r.native_id);+ match store.file_path_of(&key) {+ Ok(None) => true,+ Ok(Some(indexed)) => rank(&indexed) >= rank(&r.file_path),+ Err(_) => false,+ }+ }+ Err(_) => false,+ }),+ );+ }+let removed_keys: Vec<String> = gone.iter()- .filter_map(|path| store.remove_by_path(&path.to_string_lossy()).ok().flatten())+ .map(|path| path.to_string_lossy().into_owned())+ .chain(dropped)+ .filter_map(|path| store.remove_by_path(&path).ok().flatten()).collect();if !removed_keys.is_empty() {events.on_sessions_changed();@@ -512,4 +557,232 @@ mod tests {assert_eq!(Arc::strong_count(&adapters), 1);assert_eq!(Arc::strong_count(&fx.store), 1);}++ /// 只装着 Grok Bot 一家的存储目录(一个或几个 location)与索引;文件都在账号 github|1 名下,+ /// 不点名 location 的都写在第一个里+ struct GrokBotFixture {+ _tmp: tempfile::TempDir,+ locations: Vec<PathBuf>,+ store: Arc<Store>,+ adapters: Vec<Box<dyn AgentAdapter>>,+ roots: Vec<(PathBuf, usize)>,+ }++ impl GrokBotFixture {+ fn new() -> Self {+ Self::with_locations(1)+ }++ fn with_locations(count: usize) -> Self {+ use crate::adapters::grok_bot::GrokBotAdapter;+ let tmp = tempfile::tempdir().unwrap();+ let locations: Vec<PathBuf> = (0..count)+ .map(|ix| {+ let root = tmp.path().join(format!("location-{ix}"));+ let root = root.join("sand-client-persistence");+ std::fs::create_dir_all(&root).unwrap();+ root+ })+ .collect();+ Self {+ store: Arc::new(Store::open(&tmp.path().join("wake.db")).unwrap()),+ adapters: locations+ .iter()+ .map(|root| GrokBotAdapter::new().with_custom_root(root.clone()))+ .collect(),+ roots: locations.iter().cloned().zip(0..).collect(),+ locations,+ _tmp: tmp,+ }+ }++ fn file_in(&self, location: usize, slice: &str) -> PathBuf {+ let key = format!("sand.client.slice.account.github%7C1.{slice}");+ self.locations[location].join(crate::adapters::grok_bot::store_file_name(&key).unwrap())+ }++ fn file(&self, slice: &str) -> PathBuf {+ self.file_in(0, slice)+ }++ fn roster_in(&self, location: usize) -> PathBuf {+ self.file_in(location, "roster.last-roster")+ }++ fn roster(&self) -> PathBuf {+ self.roster_in(0)+ }++ fn write_roster_in(&self, location: usize, rows: &[String]) {+ std::fs::write(self.roster_in(location), roster_json(rows)).unwrap();+ }++ fn write_roster(&self, rows: &[String]) {+ self.write_roster_in(0, rows);+ }++ /// 一条副本,条目原样给+ fn write_replica(&self, id: &str, entries: &str) -> PathBuf {+ let path = self.file(&format!("transcript.replicas.{id}"));+ let json = format!(+ r#"{{"schemaVersion":1,"value":{{"entries":[{entries}],"persistedAt":1786000000000}}}}"#+ );+ std::fs::write(&path, json).unwrap();+ path+ }++ fn event(&self, paths: &[&Path]) {+ let event = paths.iter().fold(+ notify::Event::new(EventKind::Modify(ModifyKind::Any)),+ |event, path| event.add_path(path.to_path_buf()),+ );+ process_batch(+ &self.adapters,+ &self.store,+ &NullEvents,+ &self.roots,+ vec![Ok(event)],+ );+ }++ fn session(&self, id: &str) -> Option<SessionMeta> {+ self.store.get_session(&format!("grok-bot:{id}")).unwrap()+ }++ fn title(&self, id: &str) -> Option<String> {+ self.session(id).map(|session| session.title)+ }++ fn finds(&self, word: &str) -> bool {+ let (hits, _) = self.store.search(word, &[], None, 10).unwrap();+ !hits.is_empty()+ }+ }++ fn roster_json(rows: &[String]) -> String {+ let rows = rows.join(",");+ format!(r#"{{"schemaVersion":4,"value":{{"rows":[{rows}]}}}}"#)+ }++ fn grok_bot_row_at(id: &str, name: &str, description: &str, activity_ms: i64) -> String {+ format!(+ r#"{{"id":"{id}","name":"{name}","description":"{description}","createdAt":1786000000000,"lastActivityAt":{activity_ms}}}"#+ )+ }++ fn grok_bot_row(id: &str, name: &str, description: &str) -> String {+ grok_bot_row_at(id, name, description, 1786000060000)+ }++ const HELLO: &str = r#"{"kind":"message","id":"m1","seq":1,"timestampMs":1786000000000,"role":"user","content":"hello"}"#;++ /// Grok Bot 在侧栏里改名:只有列表文件有事件,副本文件没动。列表文件的事件经 `ref_dependents`+ /// 把同账号的副本带进同一批重比,标题当场跟上,不用等下一次全量扫描+ #[test]+ fn grok_bot_roster_changes_reach_untouched_replicas() {+ let fx = GrokBotFixture::new();+ fx.write_roster(&[grok_bot_row("c1", "Ada", "")]);+ let replica = fx.write_replica("c1", HELLO);+ fx.event(&[&replica]);+ assert_eq!(fx.title("c1").as_deref(), Some("Ada"));+ fx.write_roster(&[grok_bot_row("c1", "Ada Lovelace", "")]);+ fx.event(&[&fx.roster()]);+ assert_eq!(fx.title("c1").as_deref(), Some("Ada Lovelace"));+ }++ /// 列表里新建的 bot、删掉的 bot,卡片当场跟上(`sessions_in`);列表文件整个没了,卡片一张不剩,+ /// 有副本的对话照列、标题退回第一句话+ #[test]+ fn grok_bot_cards_follow_the_roster() {+ let fx = GrokBotFixture::new();+ let replica = fx.write_replica("c1", HELLO);+ fx.write_roster(&[+ grok_bot_row("c1", "Ada", ""),+ grok_bot_row("c2", "Scout", ""),+ ]);+ fx.event(&[&fx.roster(), &replica]);+ let replica_path = replica.to_string_lossy().into_owned();+ assert_eq!(fx.session("c1").unwrap().file_path, replica_path);+ assert_eq!(fx.title("c2").as_deref(), Some("Scout"));++ fx.write_roster(&[+ grok_bot_row("c1", "Ada", ""),+ grok_bot_row("c3", "Scribe", ""),+ ]);+ fx.event(&[&fx.roster()]);+ assert!(fx.session("c2").is_none(), "列表里删掉的 bot 不该还挂着");+ assert_eq!(fx.title("c3").as_deref(), Some("Scribe"));+ assert_eq!(fx.session("c1").unwrap().file_path, replica_path);++ std::fs::remove_file(fx.roster()).unwrap();+ fx.event(&[&fx.roster()]);+ assert!(fx.session("c3").is_none());+ assert_eq!(fx.title("c1").as_deref(), Some("hello"));+ }++ /// 副本只剩事件、退成卡片挂在副本自己的路径上:卡片才用的描述变了,副本没动也要重解析+ #[test]+ fn grok_bot_fallback_card_follows_the_roster_row() {+ let fx = GrokBotFixture::new();+ let replica = fx.write_replica(+ "c1",+ r#"{"kind":"event","id":"e1","seq":1,"timestampMs":1786000000000,"event":{"type":"name-changed","from":"a","to":"b"}}"#,+ );+ fx.write_roster(&[grok_bot_row("c1", "Ada", "Writes limericks")]);+ fx.event(&[&fx.roster(), &replica]);+ assert_eq!(+ fx.session("c1").unwrap().file_path,+ replica.to_string_lossy()+ );+ assert!(fx.finds("limericks"));+ fx.write_roster(&[grok_bot_row("c1", "Ada", "Writes sonnets")]);+ fx.event(&[&fx.roster()]);+ assert!(fx.finds("sonnets"));+ assert!(!fx.finds("limericks"));+ }++ /// 账号太长、键编码后超过 240 字符的列表存成摘要名的 `.kblob`,键在首行:文件被删之后读不到+ /// 首行,也得认出它是哪个账号的列表、把卡片撤掉+ #[test]+ fn grok_bot_framed_roster_deletion_drops_its_cards() {+ let fx = GrokBotFixture::new();+ let account = "x".repeat(150);+ let key = format!("sand.client.slice.account.{account}.roster.last-roster");+ assert!(crate::adapters::grok_bot::store_file_name(&key).is_none());+ let roster = fx.locations[0].join("0123456789abcdef.kblob");+ let framed = format!(+ "{}\n{}",+ serde_json::to_string(&key).unwrap(),+ roster_json(&[grok_bot_row("c9", "Scout", "")])+ );+ std::fs::write(&roster, framed).unwrap();+ fx.event(&[&roster]);+ assert_eq!(fx.title("c9").as_deref(), Some("Scout"));+ std::fs::remove_file(&roster).unwrap();+ fx.event(&[&roster]);+ assert!(fx.session("c9").is_none(), "列表没了,卡片不该还挂着");+ }++ /// 同一对话在两个 location 里都只有卡片:位次相同,按 mtime(最后活动时间)定胜负。落选那份+ /// 后来更新了,要当场接替,不用等全量扫描+ #[test]+ fn grok_bot_newer_card_from_another_location_takes_over() {+ let fx = GrokBotFixture::with_locations(2);+ fx.write_roster_in(0, &[grok_bot_row_at("c1", "Ada", "", 1786000060000)]);+ fx.write_roster_in(1, &[grok_bot_row_at("c1", "Ada", "", 1786000090000)]);+ fx.event(&[&fx.roster_in(0), &fx.roster_in(1)]);+ let winner = fx.session("c1").unwrap().file_path;+ assert!(winner.starts_with(&*fx.locations[1].to_string_lossy()));++ fx.write_roster_in(+ 0,+ &[grok_bot_row_at("c1", "Ada Lovelace", "", 1786000120000)],+ );+ fx.event(&[&fx.roster_in(0)]);+ let session = fx.session("c1").unwrap();+ assert_eq!(session.title, "Ada Lovelace");+ assert!(session+ .file_path+ .starts_with(&*fx.locations[0].to_string_lossy()));+ }}diff --git a/crates/wake-core/tests/adapter_contracts.rs b/crates/wake-core/tests/adapter_contracts.rsindex ed6d8b2..41ea240 100644--- a/crates/wake-core/tests/adapter_contracts.rs+++ b/crates/wake-core/tests/adapter_contracts.rs@@ -25,6 +25,7 @@ use wake_core::adapters::devin::DevinAdapter;use wake_core::adapters::dsh::DshAdapter;use wake_core::adapters::gemini::GeminiAdapter;use wake_core::adapters::grok::GrokAdapter;+use wake_core::adapters::grok_bot::GrokBotAdapter;use wake_core::adapters::hermes::HermesAdapter;use wake_core::adapters::kilo::{legacy_task_key, migrated_session_id, KiloLegacyAdapter};use wake_core::adapters::kimi::KimiAdapter;@@ -56,6 +57,8 @@ struct TestEnv {kilo_db: PathBuf,kilo_tasks: PathBuf,kilo_cursor_tasks: PathBuf,+ /// Grok Bot 的缓存目录(`<userData>/sand-client-persistence`)+ grok_bot_store: PathBuf,/// 假 HOME 目录本体,持有 TempDir 保证整个测试进程期间不被清理_home: tempfile::TempDir,}@@ -90,6 +93,8 @@ fn setup() -> &'static TestEnv {// 侧档与 SQLite fixture 库的搭建在 tests/common(remote_sync 的假远端// home 复用同一份,两边不会各自漂移)let sc = common::stage_sidecars(home.path());+ // Grok Bot 单独摆:cli / mcp / remote_sync 也用 stage_sidecars,不往它们的索引里塞会话+ let grok_bot_store = common::stage_grok_bot(home.path());common::isolate_home(home.path());TestEnv {@@ -106,6 +111,7 @@ fn setup() -> &'static TestEnv {kilo_db: sc.kilo_db,kilo_tasks: sc.kilo_tasks,kilo_cursor_tasks: sc.kilo_cursor_tasks,+ grok_bot_store,_home: home,}})@@ -3050,6 +3056,11 @@ fn seq_contract_holds_for_all_agents() {Box::new(KiloLegacyAdapter::new()),kilo_task_ref(&env.kilo_tasks, KILO_T3),),+ (Box::new(GrokBotAdapter::new()), grok_bot_ref(GB_ADA, false)),+ (+ Box::new(GrokBotAdapter::new()),+ grok_bot_ref(GB_SCOUT, true),+ ),];for (adapter, r) in &checks {assert_seq_contract(adapter.as_ref(), r);@@ -5084,7 +5095,11 @@ fn remote_adapters_stay_inside_cache_and_rewrite_keys() {let empty = tempfile::tempdir().unwrap();let adapters =wake_core::adapters::remote::create_remote_adapters(&templates, "devbox", empty.path());- assert_eq!(adapters.len(), AgentId::ALL.len(), "每家一个远程实例");+ assert_eq!(+ adapters.len(),+ wake_core::remote::REMOTE_LAYOUTS.len(),+ "同步的每一家一个远程实例"+ );let cache_prefix = empty.path().to_string_lossy().to_string();for adapter in &adapters {assert_eq!(adapter.host(), "devbox");@@ -5260,10 +5275,11 @@ fn roster_appends_remote_instances_for_enabled_hosts() {store.add_remote_host("devbox").unwrap();let roster = wake_core::adapters::create_adapter_roster_for(&store);+ let synced = wake_core::remote::REMOTE_LAYOUTS.len();assert_eq!(roster.active.len(),- local_n + AgentId::ALL.len(),- "每家一个远程实例"+ local_n + synced,+ "同步的每一家一个远程实例");assert_eq!(roster.locations.len(),@@ -5275,7 +5291,7 @@ fn roster_appends_remote_instances_for_enabled_hosts() {.iter().filter(|a| a.host() == "devbox").count();- assert_eq!(remote_count, AgentId::ALL.len());+ assert_eq!(remote_count, synced);// 顺序契约:默认实例在前,"按 agent 找第一个"的兜底不受远程影响assert!(roster.active[..local_n].iter().all(|a| a.host().is_empty()));@@ -6031,3 +6047,273 @@ fn missing_parent_link_stores_mean_no_links_not_unknown() {let cursor = CursorIdeAdapter::new().with_custom_root(dir.path().join("cursor-nope"));assert_eq!(cursor.parent_links(), Some(Vec::new()));}++// ---------------------------------------------------------------- Grok Bot++const GB_ADA: &str = "b0000001-aaaa-bbbb-cccc-000000000001";+const GB_CREW: &str = "b0000002-aaaa-bbbb-cccc-000000000002";+const GB_SCOUT: &str = "b0000003-aaaa-bbbb-cccc-000000000003";+const GB_OLD: &str = "b0000004-aaaa-bbbb-cccc-000000000004";+const GB_ORPHAN: &str = "b0000009-aaaa-bbbb-cccc-000000000009";++/// 列表里的副本(`card = false`)或卡片(`card = true`)引用+fn grok_bot_ref(id: &str, card: bool) -> SessionFileRef {+ GrokBotAdapter::new()+ .list_session_files()+ .expect("grok bot list")+ .into_iter()+ .find(|r| r.native_id == id && r.file_path.contains('#') == card)+ .unwrap_or_else(|| panic!("grok bot {id} (card: {card}) not listed"))+}++fn texts(mainline: &[TranscriptMessage]) -> Vec<(Role, MessageKind, &str)> {+ mainline+ .iter()+ .map(|m| (m.role, m.kind, m.text.as_str()))+ .collect()+}++#[test]+fn grok_bot_parse_contract() {+ let env = setup();+ let adapter = GrokBotAdapter::new();+ assert_eq!(adapter.data_roots(), vec![env.grok_bot_store.clone()]);++ // 有副本的四个对话(一个已不在侧栏)+ 侧栏四行各一张卡片;不相干的切片、写到一半的 .tmp+ // 都不算。同一对话副本恒胜+ let refs = adapter.list_session_files().expect("grok bot list");+ let mut listed: Vec<(&str, bool)> = refs+ .iter()+ .map(|r| (r.native_id.as_str(), r.file_path.contains('#')))+ .collect();+ listed.sort();+ assert_eq!(+ listed,+ vec![+ (GB_ADA, false),+ (GB_ADA, true),+ (GB_CREW, false),+ (GB_CREW, true),+ (GB_SCOUT, true),+ (GB_OLD, false),+ (GB_OLD, true),+ (GB_ORPHAN, false),+ ]+ );+ for r in &refs {+ assert_eq!(+ adapter.dedup_rank(&r.file_path),+ u8::from(r.file_path.contains('#'))+ );+ }++ // 截过头的副本:前面补一句说明,时间与标题取侧栏那一行+ let ada = adapter+ .parse_transcript(&grok_bot_ref(GB_ADA, false))+ .expect("ada");+ assert_eq!(ada.meta.key, format!("grok-bot:{GB_ADA}"));+ assert_eq!(ada.meta.title, "Ada");+ assert_eq!(+ ada.meta.created_at, 1786000000000,+ "bot 建出来的时刻,不是副本里第一条"+ );+ assert_eq!(ada.meta.updated_at, 1786000190000);+ assert_eq!(ada.meta.project_name, "Unknown project");+ assert!(!ada.meta.archived);+ assert_eq!(ada.unknown_line_count, 0);+ use MessageKind::{Meta, Text};+ assert_eq!(+ texts(&ada.mainline),+ vec![+ (+ Role::System,+ Text,+ "── Earlier messages of this conversation are only in Grok Bot ──"+ ),+ (+ Role::User,+ Text,+ "[image: launch-plan.png]\n\nTurn this launch plan into a checklist"+ ),+ (+ Role::Assistant,+ Text,+ "Here is the checklist:\n\n1. Freeze the release branch\n2. Write the changelog\n\n[image: timeline chart]"+ ),+ (+ Role::Assistant,+ Text,+ "Which day should it ship?\n\n- Tuesday\n- Thursday — after the freeze\n\nAnswer: Tuesday"+ ),+ (Role::System, Meta, "Automation created: Daily launch digest"),+ (Role::Assistant, Text, "Asked to connect Gmail"),+ (+ Role::Assistant,+ Text,+ "Requested a secret: Release token\n\nNeeded to publish the release\n\nProvided"+ ),+ (+ Role::Assistant,+ Text,+ "Email draft: Launch checklist\nTo: [email protected]\n\nThe checklist is attached.\n\nStatus: sent"+ ),+ (+ Role::Assistant,+ Text,+ "**Message to Scout**\n\nWatch for competitor launches on Tuesday"+ ),+ (Role::Assistant, Text, "**Message from Scout**\n\nWill do"),+ (Role::System, Text, "Ada was updated"),+ ]+ );+ // 工具调用挂到它前面那条 bot 消息上;流式中的空占位不成消息+ let tools = &ada.mainline[2].tool_calls;+ assert_eq!(tools.len(), 1);+ assert_eq!(tools[0].name, "web_search");+ assert_eq!(tools[0].input_preview, "wake launch checklist");+ assert_eq!(ada.meta.message_count, 8, "系统消息与事件不算");+ // 对话本体在云端,删除只隐藏、不动任何文件+ assert!(adapter.session_paths(&ada.meta).is_empty());++ // 群聊:每条 bot 消息带上是哪个 bot 发的+ let crew = adapter+ .parse_transcript(&grok_bot_ref(GB_CREW, false))+ .expect("crew");+ assert_eq!(crew.meta.title, "Launch crew");+ assert_eq!(+ texts(&crew.mainline),+ vec![+ (Role::User, Text, "What should we post today?"),+ (+ Role::Assistant,+ Text,+ "**Ada**\n\nA thread about the launch"+ ),+ (+ Role::Assistant,+ Text,+ "**Scout**\n\nCompetitors are quiet today"+ ),+ ]+ );++ // 从侧栏藏起来的 bot 归档;侧栏里已没有的旧副本照列,标题退回第一句话+ let old = adapter+ .parse_session(&grok_bot_ref(GB_OLD, false))+ .expect("old");+ assert!(old.meta.archived);+ assert_eq!(old.meta.title, "Old helper");+ let orphan = adapter+ .parse_session(&grok_bot_ref(GB_ORPHAN, false))+ .expect("orphan");+ assert_eq!(orphan.meta.title, "Summarize yesterday's notes");+ assert_eq!(orphan.meta.created_at, 1785800000000);++ // 副本被清掉的对话:卡片承载描述与最后一条预览+ let scout = adapter+ .parse_transcript(&grok_bot_ref(GB_SCOUT, true))+ .expect("scout card");+ assert_eq!(scout.meta.title, "Scout");+ assert_eq!(scout.meta.created_at, 1785500000000);+ assert_eq!(scout.meta.updated_at, 1785600000000);+ assert_eq!(scout.meta.message_count, 0);+ assert_eq!(+ texts(&scout.mainline),+ vec![(+ Role::System,+ Text,+ "Watches competitor launches\n\nLast message: Nothing new from the usual suspects\n\nGrok Bot no longer caches this conversation on this computer — only its last message is available in Wake."+ )]+ );++ // 列表文件不是会话;它变了,同账号的副本要重比(watcher 经 ref_dependents 拿到),卡片按它+ // 此刻列着的对账(sessions_in)+ let roster = common::grok_bot_roster_path(&env.grok_bot_store);+ assert!(adapter.file_ref(&roster).is_none());+ let card = grok_bot_ref(GB_SCOUT, true);+ let back = adapter+ .file_ref(Path::new(&card.file_path))+ .expect("卡片的虚拟路径");+ assert_eq!(+ (back.native_id.as_str(), back.mtime_ms, back.size),+ (GB_SCOUT, card.mtime_ms, card.size)+ );+ let (cards, replicas): (Vec<&SessionFileRef>, Vec<&SessionFileRef>) =+ refs.iter().partition(|r| r.file_path.contains('#'));+ let mut deps = adapter.ref_dependents(&roster);+ deps.sort();+ let mut expect: Vec<PathBuf> = replicas+ .iter()+ .map(|r| PathBuf::from(&r.file_path))+ .collect();+ expect.sort();+ assert_eq!(deps, expect);+ let stamps = |refs: Vec<&SessionFileRef>| {+ let mut out: Vec<(String, i64, i64)> = refs+ .into_iter()+ .map(|r| (r.file_path.clone(), r.mtime_ms, r.size))+ .collect();+ out.sort();+ out+ };+ let listed = adapter.sessions_in(&roster).expect("列表文件装着卡片");+ assert_eq!(stamps(listed.iter().collect()), stamps(cards));+ let replica = grok_bot_ref(GB_ADA, false);+ assert!(adapter+ .ref_dependents(Path::new(&replica.file_path))+ .is_empty());+ assert!(adapter.sessions_in(Path::new(&replica.file_path)).is_none());+}++/// 编码后超过 240 字符的键,app 把文件名换成摘要、键写在首行(`.kblob`);自定义 location 选+/// userData 目录、缓存目录本身或者它的一份拷贝都认+#[test]+fn grok_bot_reads_framed_keys_and_custom_roots() {+ setup();+ let tmp = tempfile::tempdir().unwrap();+ let user_data = tmp.path().join("Grok Bot");+ let store = user_data.join("sand-client-persistence");+ fs::create_dir_all(&store).unwrap();+ let account = format!("auth0%7C{}", "x".repeat(150));+ let framed = |name: &str, key: &str, value: &str| {+ let key = serde_json::to_string(key).unwrap();+ fs::write(store.join(name), format!("{key}\n{value}")).unwrap();+ };+ framed(+ "rosterdigest.kblob",+ &common::grok_bot_roster_key(&account),+ r#"{"schemaVersion":4,"value":{"rows":[{"id":"c1","name":"Framed","description":"","createdAt":1786000000000,"lastActivityAt":1786000060000,"isHiddenFromSidebar":false,"lastEntry":{"kind":"text","text":"ok"}}]}}"#,+ );+ framed(+ "replicadigest.kblob",+ &common::grok_bot_replica_key(&account, "c1"),+ r#"{"schemaVersion":1,"value":{"entries":[{"kind":"message","id":"m1","seq":1,"timestampMs":1786000000000,"role":"user","content":"hello"},{"kind":"send-message","id":"m2","seq":2,"timestampMs":1786000060000,"message":{"type":"text","content":"hi"}}],"persistedAt":1786000060000}}"#,+ );+ for chosen in [user_data.clone(), store.clone()] {+ let adapter = GrokBotAdapter::new().with_custom_root(chosen);+ assert_eq!(adapter.data_roots(), vec![store.clone()]);+ let refs = adapter.list_session_files().expect("list");+ let replica = refs+ .iter()+ .find(|r| !r.file_path.contains('#'))+ .expect("framed replica");+ assert_eq!(replica.native_id, "c1");+ assert_eq!(adapter.parse_session(replica).unwrap().meta.title, "Framed");+ let back = adapter.file_ref(Path::new(&replica.file_path)).unwrap();+ assert_eq!((back.mtime_ms, back.size), (replica.mtime_ms, replica.size));+ let card = refs+ .iter()+ .find(|r| r.file_path.contains('#'))+ .expect("card");+ assert_eq!(adapter.parse_session(card).unwrap().meta.title, "Framed");+ }+ // 直接放着存储文件的拷贝(目录名不是 sand-client-persistence)用它本身+ let copy = tmp.path().join("grok-bot-backup");+ common::copy_tree(&store, ©);+ assert_eq!(+ GrokBotAdapter::new()+ .with_custom_root(copy.clone())+ .data_roots(),+ vec![copy]+ );+}diff --git a/crates/wake-core/tests/common/mod.rs b/crates/wake-core/tests/common/mod.rsindex e8f1bb2..74199ad 100644--- a/crates/wake-core/tests/common/mod.rs+++ b/crates/wake-core/tests/common/mod.rs@@ -445,10 +445,9 @@ pub fn stage_sidecars(home: &Path) -> Sidecars {}}-/// `<home>/…/<编辑器>/User/globalStorage`:VS Code 系编辑器的 globalStorage,与-/// adapters::vscode_user_data 的平台分支逐条对应(改一处必须改另一处,契约测试会因路径-/// 不符而空列)-pub fn vscode_global_storage(home: &Path, editor: &str) -> PathBuf {+/// `<home>/…/<app 名>`:Electron app 的 userData,与 adapters::electron_user_data 的平台分支+/// 逐条对应(改一处必须改另一处,契约测试会因路径不符而空列)+pub fn electron_user_data(home: &Path, app: &str) -> PathBuf {let base = if cfg!(target_os = "macos") {home.join("Library").join("Application Support")} else if cfg!(target_os = "windows") {@@ -456,7 +455,71 @@ pub fn vscode_global_storage(home: &Path, editor: &str) -> PathBuf {} else {home.join(".config")};- base.join(editor).join("User").join("globalStorage")+ base.join(app)+}++/// `<home>/…/<编辑器>/User/globalStorage`:VS Code 系编辑器的 globalStorage+pub fn vscode_global_storage(home: &Path, editor: &str) -> PathBuf {+ electron_user_data(home, editor)+ .join("User")+ .join("globalStorage")+}++/// Grok Bot fixture 的账号段(app 存的是 URI 编码过的账号)+pub const GROK_BOT_ACCOUNT: &str = "google-oauth2%7Cuser_fixture01";++/// Grok Bot 的一份存储文件:键直接编码进文件名。用 adapter 自己的编码器——它对不对由 adapter 的+/// 单测拿本机真实文件名卡着+pub fn grok_bot_store_file(store: &Path, key: &str) -> PathBuf {+ store.join(wake_core::adapters::grok_bot::store_file_name(key).expect("短键直接编码进文件名"))+}++/// fixture 账号的侧栏列表+pub fn grok_bot_roster_path(store: &Path) -> PathBuf {+ grok_bot_store_file(store, &grok_bot_roster_key(GROK_BOT_ACCOUNT))+}++/// fixture 账号的一个对话副本+pub fn grok_bot_replica_path(store: &Path, conversation: &str) -> PathBuf {+ grok_bot_store_file(store, &grok_bot_replica_key(GROK_BOT_ACCOUNT, conversation))+}++pub fn grok_bot_replica_key(account: &str, conversation: &str) -> String {+ format!("sand.client.slice.account.{account}.transcript.replicas.{conversation}")+}++pub fn grok_bot_roster_key(account: &str) -> String {+ format!("sand.client.slice.account.{account}.roster.last-roster")+}++/// Grok Bot 的缓存目录(`<userData>/sand-client-persistence`):检入的明文 fixture——侧栏列表与+/// 各对话的副本——按 app 的写法落成 base32 文件名;另放一个不相干的切片与一份写到一半的 `.tmp`,+/// 都不是会话。返回缓存目录+pub fn stage_grok_bot(home: &Path) -> PathBuf {+ let store = electron_user_data(home, "Grok Bot").join("sand-client-persistence");+ fs::create_dir_all(&store).expect("mkdir grok bot store");+ fs::copy(+ fixture("grok-bot/roster.json"),+ grok_bot_roster_path(&store),+ )+ .expect("stage grok bot roster");+ for entry in fs::read_dir(fixture("grok-bot/replicas")).expect("grok bot replicas") {+ let path = entry.unwrap().path();+ let id = path.file_stem().unwrap().to_string_lossy().to_string();+ fs::copy(&path, grok_bot_replica_path(&store, &id)).expect("stage grok bot replica");+ }+ fs::write(+ grok_bot_store_file(&store, "sand.client.slice.ui-layout"),+ r#"{"schemaVersion":1,"value":{"sidebarWidth":210}}"#,+ )+ .unwrap();+ let in_flight = grok_bot_replica_path(&store, "b0000001-aaaa-bbbb-cccc-000000000001");+ fs::write(+ in_flight.with_extension("blob.tmp"),+ "{\"schemaVersion\":1,",+ )+ .unwrap();+ store}/// `<home>/…/Cursor/User/globalStorage`diff --git a/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000001-aaaa-bbbb-cccc-000000000001.json b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000001-aaaa-bbbb-cccc-000000000001.jsonnew file mode 100644index 0000000..b21ccab--- /dev/null+++ b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000001-aaaa-bbbb-cccc-000000000001.json@@ -0,0 +1,15 @@+{"schemaVersion":1,"value":{"entries":[+{"kind":"user-attachment","id":"e41","seq":41,"timestampMs":1786000100000,"clientNonce":"n41","batchId":"n41","file_path":"/home/box/agent-data/uploads/launch-plan.png","file_name":"launch-plan.png","width":1200,"height":800,"byteSize":204800},+{"kind":"message","id":"e42","seq":42,"timestampMs":1786000100000,"clientNonce":"n41","batchId":"n41","requestId":"r42","role":"user","content":"Turn this launch plan into a checklist","isStreaming":false},+{"kind":"send-message","id":"e43","seq":43,"timestampMs":1786000110000,"requestId":"r42","message":{"type":"text","content":"Here is the checklist:\n\n1. Freeze the release branch\n2. Write the changelog","images":[{"url":"https://example.invalid/chart.png","alt":"timeline chart","width":640,"height":320}]}},+{"kind":"tool-call","id":"e44","seq":44,"timestampMs":1786000111000,"name":"web_search","status":"completed","summary":"wake launch checklist"},+{"kind":"send-message","id":"e45","seq":45,"timestampMs":1786000120000,"requestId":"r42","respondedValue":"tue","message":{"type":"widget","widget":{"prompt":"Which day should it ship?","allowCustom":true,"options":[{"label":"Tuesday","value":"tue"},{"label":"Thursday","value":"thu","description":"after the freeze"}]}}},+{"kind":"event","id":"e46","seq":46,"timestampMs":1786000130000,"event":{"type":"automation-changed","action":"created","automationId":"au1","automationName":"Daily launch digest"}},+{"kind":"send-message","id":"e47","seq":47,"timestampMs":1786000140000,"requestId":"r47","message":{"type":"connector","connector":"Gmail","serverId":"100001","variant":"connect"}},+{"kind":"send-message","id":"e48","seq":48,"timestampMs":1786000150000,"requestId":"r47","secretProvided":true,"message":{"type":"secret-request","secretRequest":{"label":"Release token","description":"Needed to publish the release","target":{"kind":"box-env","name":"RELEASE_TOKEN","field":"value","platform":"github"}}}},+{"kind":"send-message","id":"e49","seq":49,"timestampMs":1786000160000,"requestId":"r47","draftSendState":"sent","message":{"type":"email-draft","draft":{"from":"[email protected]","to":["[email protected]"],"subject":"Launch checklist","body":"The checklist is attached."}}},+{"kind":"message","id":"e50","seq":50,"timestampMs":1786000170000,"requestId":"r50","role":"assistant","toAgent":{"id":"b0000003-aaaa-bbbb-cccc-000000000003","kind":"agent","name":"Scout"},"content":"Watch for competitor launches on Tuesday","isStreaming":false},+{"kind":"message","id":"e51","seq":51,"timestampMs":1786000180000,"role":"user","fromAgent":{"id":"b0000003-aaaa-bbbb-cccc-000000000003","name":"Scout"},"content":"Will do","isStreaming":false},+{"kind":"notice","id":"e52","seq":52,"timestampMs":1786000190000,"text":"Ada was updated"},+{"kind":"send-message","id":"e53","seq":53,"timestampMs":1786000200000,"requestId":"r53","streaming":true,"message":{"type":"text","content":""}}+],"epochHint":"ep-fixture","acceptedSequenceHint":53,"persistedAt":1786000200000,"precedingTimestampMs":1786000050000}}diff --git a/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000002-aaaa-bbbb-cccc-000000000002.json b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000002-aaaa-bbbb-cccc-000000000002.jsonnew file mode 100644index 0000000..e024681--- /dev/null+++ b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000002-aaaa-bbbb-cccc-000000000002.json@@ -0,0 +1,5 @@+{"schemaVersion":1,"value":{"entries":[+{"kind":"message","id":"g1","seq":1,"timestampMs":1786100000000,"clientNonce":"gn1","requestId":"gr1","role":"user","content":"What should we post today?","isStreaming":false},+{"kind":"send-message","id":"g2","seq":2,"timestampMs":1786100010000,"requestId":"gr1","author":{"id":"b0000001-aaaa-bbbb-cccc-000000000001","name":"Ada"},"message":{"type":"text","content":"A thread about the launch"}},+{"kind":"send-message","id":"g3","seq":3,"timestampMs":1786100020000,"requestId":"gr1","author":{"id":"b0000003-aaaa-bbbb-cccc-000000000003","name":"Scout"},"message":{"type":"text","content":"Competitors are quiet today"}}+],"epochHint":null,"acceptedSequenceHint":null,"persistedAt":1786100020000,"cloudAgentPeerIds":[]}}diff --git a/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000004-aaaa-bbbb-cccc-000000000004.json b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000004-aaaa-bbbb-cccc-000000000004.jsonnew file mode 100644index 0000000..eebd28a--- /dev/null+++ b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000004-aaaa-bbbb-cccc-000000000004.json@@ -0,0 +1,4 @@+{"schemaVersion":1,"value":{"entries":[+{"kind":"message","id":"h1","seq":1,"timestampMs":1785900000000,"clientNonce":"hn1","requestId":"hr1","role":"user","content":"Clean up the old notes","isStreaming":false},+{"kind":"send-message","id":"h2","seq":2,"timestampMs":1785900060000,"requestId":"hr1","message":{"type":"text","content":"Done"}}+],"epochHint":null,"acceptedSequenceHint":2,"persistedAt":1785900060000}}diff --git a/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000009-aaaa-bbbb-cccc-000000000009.json b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000009-aaaa-bbbb-cccc-000000000009.jsonnew file mode 100644index 0000000..6538170--- /dev/null+++ b/crates/wake-core/tests/fixtures/grok-bot/replicas/b0000009-aaaa-bbbb-cccc-000000000009.json@@ -0,0 +1,4 @@+{"schemaVersion":1,"value":{"entries":[+{"kind":"message","id":"o1","seq":1,"timestampMs":1785800000000,"clientNonce":"on1","requestId":"or1","role":"user","content":"Summarize yesterday's notes","isStreaming":false},+{"kind":"send-message","id":"o2","seq":2,"timestampMs":1785800030000,"requestId":"or1","message":{"type":"text","content":"Three things happened yesterday."}}+],"epochHint":null,"acceptedSequenceHint":null,"persistedAt":1785800030000}}diff --git a/crates/wake-core/tests/fixtures/grok-bot/roster.json b/crates/wake-core/tests/fixtures/grok-bot/roster.jsonnew file mode 100644index 0000000..841e11b--- /dev/null+++ b/crates/wake-core/tests/fixtures/grok-bot/roster.json@@ -0,0 +1,6 @@+{"schemaVersion":4,"value":{"rows":[+{"id":"b0000001-aaaa-bbbb-cccc-000000000001","name":"Ada","description":"Research assistant for the Wake launch","title":"","avatarShape":"","avatarColor":"amber","createdAt":1786000000000,"updatedAt":1786000200000,"path":"/home/box/sand-data/agents/b0000001-aaaa-bbbb-cccc-000000000001/store.db","lastEntry":{"kind":"text","text":"Email draft: Launch checklist"},"lastMessageId":"e49","newestEntryId":"e53","hasUnread":false,"unreadCount":0,"lastViewedAt":1786000200000,"lastActivityAt":1786000200000,"localActivityAt":1786000000000,"awaitingUserResponse":null,"notificationsEnabled":true,"notifyOnUpdatesEnabled":true,"isHiddenFromSidebar":false,"voiceId":null,"voiceSpeed":1,"voiceLanguage":"auto","origin":"user","harness":"temporal","isGroup":false,"memberIds":[]},+{"id":"b0000002-aaaa-bbbb-cccc-000000000002","name":"Launch crew","description":"","title":"","avatarShape":"","avatarColor":"teal","createdAt":1786100000000,"updatedAt":1786100020000,"path":"/home/box/sand-data/agents/b0000002-aaaa-bbbb-cccc-000000000002/store.db","lastEntry":{"kind":"text","text":"Competitors are quiet today"},"lastMessageId":"g3","newestEntryId":"g3","hasUnread":true,"unreadCount":1,"lastViewedAt":1786100010000,"lastActivityAt":1786100020000,"localActivityAt":1786100000000,"awaitingUserResponse":null,"notificationsEnabled":true,"notifyOnUpdatesEnabled":true,"isHiddenFromSidebar":false,"voiceId":null,"voiceSpeed":1,"voiceLanguage":"auto","origin":"user","harness":"temporal","isGroup":true,"memberIds":["b0000001-aaaa-bbbb-cccc-000000000001","b0000003-aaaa-bbbb-cccc-000000000003"]},+{"id":"b0000003-aaaa-bbbb-cccc-000000000003","name":"Scout","description":"Watches competitor launches","title":"","avatarShape":"","avatarColor":"blue","createdAt":1785500000000,"updatedAt":1785600000000,"path":"/home/box/sand-data/agents/b0000003-aaaa-bbbb-cccc-000000000003/store.db","lastEntry":{"kind":"text","text":"Nothing new from the usual suspects"},"lastMessageId":"s9","newestEntryId":"s9","hasUnread":false,"unreadCount":0,"lastViewedAt":1785600000000,"lastActivityAt":1785600000000,"localActivityAt":1785500000000,"awaitingUserResponse":null,"notificationsEnabled":true,"notifyOnUpdatesEnabled":false,"isHiddenFromSidebar":false,"voiceId":null,"voiceSpeed":1,"voiceLanguage":"auto","origin":"user","harness":"temporal","isGroup":false,"memberIds":[]},+{"id":"b0000004-aaaa-bbbb-cccc-000000000004","name":"Old helper","description":"","title":"","avatarShape":"","avatarColor":"gray","createdAt":1785900000000,"updatedAt":1785900060000,"path":"/home/box/sand-data/agents/b0000004-aaaa-bbbb-cccc-000000000004/store.db","lastEntry":{"kind":"text","text":"Done"},"lastMessageId":"h2","newestEntryId":"h2","hasUnread":false,"unreadCount":0,"lastViewedAt":1785900060000,"lastActivityAt":1785900060000,"localActivityAt":1785900000000,"awaitingUserResponse":null,"notificationsEnabled":false,"notifyOnUpdatesEnabled":false,"isHiddenFromSidebar":true,"voiceId":null,"voiceSpeed":1,"voiceLanguage":"auto","origin":"user","harness":"temporal","isGroup":false,"memberIds":[]}+]}}diff --git a/crates/wake-core/tests/remote_sync.rs b/crates/wake-core/tests/remote_sync.rsindex 3da31ff..3c9b7f9 100644--- a/crates/wake-core/tests/remote_sync.rs+++ b/crates/wake-core/tests/remote_sync.rs@@ -67,9 +67,12 @@ fn build_remote_home(home: &Path) {const KILO_TASKS: &str = ".vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks";-/// 假远端上装着的 agent(Copilot 故意缺席,见 build_remote_home)+/// 假远端上装着的 agent:同步的每一家,Copilot 故意缺席(见 build_remote_home)fn remote_agents() -> impl Iterator<Item = AgentId> {- AgentId::ALL.into_iter().filter(|a| *a != AgentId::Copilot)+ wake_core::remote::REMOTE_LAYOUTS+ .iter()+ .map(|layout| layout.agent)+ .filter(|a| *a != AgentId::Copilot)}const CLAUDE_U1: &str =diff --git a/crates/wake-core/tests/scanner_finale.rs b/crates/wake-core/tests/scanner_finale.rsindex 113a0f3..f74b3ee 100644--- a/crates/wake-core/tests/scanner_finale.rs+++ b/crates/wake-core/tests/scanner_finale.rs@@ -1622,6 +1622,81 @@ fn antigravity_transcript_takes_over_its_index_card() {assert_eq!(rows(), 1);}+/// Grok Bot:副本是 app 的滚动缓存——对话被清出缓存时卡片接替(同一个 key,库里始终一行),+/// 缓存回来时副本接回;侧栏里改名时副本文件没动,全量扫描靠引用里并进的指纹认出来;删除只是+/// 隐藏:缓存文件原样留在原处,下一轮扫描也不会把它当成"从废纸篓放回来了"而撤掉墓碑+#[test]+fn grok_bot_card_stands_in_when_the_cache_drops_a_conversation() {+ use wake_core::adapters::grok_bot::GrokBotAdapter;+ const ID: &str = "b0000001-aaaa-bbbb-cccc-000000000001";+ let key = format!("grok-bot:{ID}");+ let home = tempfile::tempdir().unwrap();+ let cache = common::stage_grok_bot(home.path());+ let adapters: Vec<Box<dyn AgentAdapter>> =+ vec![GrokBotAdapter::new().with_custom_root(cache.clone())];+ let replica = common::grok_bot_replica_path(&cache, ID);+ let roster = common::grok_bot_roster_path(&cache);+ let dir = tempfile::tempdir().unwrap();+ let store = temp_store(dir.path());+ let rows = || {+ store+ .list_sessions(&SessionFilter {+ include_archived: true,+ limit: 50,+ ..Default::default()+ })+ .unwrap()+ .1+ };++ run_scan(&adapters, &store, &Recorder::new(), true).unwrap();+ let s = store.get_session(&key).unwrap().expect("副本入库");+ assert_eq!(s.file_path, replica.to_string_lossy());+ assert_eq!(s.title, "Ada");+ // 四个有副本的对话 + 只剩卡片的 Scout+ assert_eq!(rows(), 5);++ // app 把这个对话清出了缓存:卡片接替+ let kept = std::fs::read(&replica).unwrap();+ std::fs::remove_file(&replica).unwrap();+ run_scan(&adapters, &store, &Recorder::new(), false).unwrap();+ let s = store.get_session(&key).unwrap().expect("卡片接替");+ assert!(s.file_path.ends_with(&format!("#{ID}")), "{}", s.file_path);+ assert_eq!(s.title, "Ada");+ assert_eq!(rows(), 5);++ // 用户又打开了这个对话,缓存回来:增量写入由副本接回+ std::fs::write(&replica, &kept).unwrap();+ let incoming = adapters[0].file_ref(&replica).expect("副本是这个对话的");+ scan_files(&adapters, &store, &Recorder::new(), vec![incoming]);+ let s = store.get_session(&key).unwrap().unwrap();+ assert_eq!(s.file_path, replica.to_string_lossy());++ // 侧栏里改了名:副本没动,全量扫描照样认出来+ let renamed = std::fs::read_to_string(&roster)+ .unwrap()+ .replace(r#""name":"Ada""#, r#""name":"Ada Lovelace""#);+ std::fs::write(&roster, renamed).unwrap();+ run_scan(&adapters, &store, &Recorder::new(), false).unwrap();+ assert_eq!(+ store.get_session(&key).unwrap().unwrap().title,+ "Ada Lovelace"+ );++ // 删除 = 隐藏:不动缓存文件,也不被"放回即恢复"撤掉+ let targets = adapters[0].session_paths(&s);+ assert!(targets.is_empty());+ let hidden = wake_core::cleanup::trash_sessions(&store, &[s], &targets).unwrap();+ assert!(hidden, "一个文件都没移");+ assert!(replica.exists());+ run_scan(&adapters, &store, &Recorder::new(), true).unwrap();+ assert!(+ store.get_session(&key).unwrap().is_none(),+ "缓存文件还在原处,隐藏照样生效(副本与卡片同一个 key)"+ );+ assert_eq!(rows(), 4);+}+/// Cursor 两源端到端:转录带正文的会话固定由 CLI 源胜出(它有 slug 可反推/// 项目),哪怕 IDE 库里那份 lastUpdatedAt 更新、roster 里 IDE 实例排在前面;/// 转录只剩 turn_ended 空壳的会话由 IDE 库副本胜出。按 mtime 裁决的话胜负随diff --git a/crates/wake/assets/brands/grok-bot.png b/crates/wake/assets/brands/grok-bot.pngnew file mode 100644index 0000000..43a2c34Binary files /dev/null and b/crates/wake/assets/brands/grok-bot.png differdiff --git a/crates/wake/src/assets.rs b/crates/wake/src/assets.rsindex 7e87f0e..e9bba72 100644--- a/crates/wake/src/assets.rs+++ b/crates/wake/src/assets.rs@@ -67,6 +67,7 @@ brands!("devin-light","kilo","kilo-light",+ "grok-bot",);fn lookup_product(path: &str) -> Option<&'static [u8]> {diff --git a/crates/wake/src/settings.rs b/crates/wake/src/settings.rsindex 3be8688..daf1b39 100644--- a/crates/wake/src/settings.rs+++ b/crates/wake/src/settings.rs@@ -13,9 +13,9 @@ use wake_core::models::AgentId;use crate::format::tilde_path;use crate::ui::{- action_button, overlay_layers, rails_factor, show_in_fm, zpx, Zpx, BUTTON_SM_H, FONT_BODY,- FONT_CAPTION, FONT_DISPLAY, FONT_HEADING, FONT_LABEL, FONT_TITLE, ICON_TEXT_GAP, RADIUS_BUTTON,- SPACE_LG, SPACE_MD, SPACE_SM, SPACE_XL, SPACE_XS, SPACE_XXL,+ action_button, axis_inset, overlay_layers, rails_factor, show_in_fm, sidebar_title, zpx, Zpx,+ BUTTON_SM_H, FONT_BODY, FONT_CAPTION, FONT_DISPLAY, FONT_LABEL, FONT_TITLE, ICON_TEXT_GAP,+ NAV_ICON, RADIUS_BUTTON, SPACE_LG, SPACE_MD, SPACE_SM, SPACE_XL, SPACE_XS, SPACE_XXL,};use crate::update::{self, UpdateStatus};use crate::workbench::{@@ -29,6 +29,11 @@ const SETTINGS_SIDEBAR_W: Zpx = Zpx(180.);/// 侧栏顶上的标题栏条(gpui-component TitleBar 默认的 34px)。显式给成随缩放的同值:/// traffic light 随缩放挪位,这条不跟着变高的话灯就落到它的下沿上const SETTINGS_TITLEBAR_H: Zpx = Zpx(34.);+/// 导航列的容器内边距(上下两组共用)+const NAV_EDGE: Zpx = SPACE_SM;+/// 导航项左内边距:图标中心压在侧栏中轴(红灯中心线)上,26.75 − 7.5(图标半宽) − 8(NAV_EDGE)。+/// 原先是 12,图标中心落在 27.5+const NAV_ITEM_INSET: Zpx = axis_inset(NAV_ICON, NAV_EDGE);const SETTINGS_PAGE_TOP: Zpx = Zpx(38.);/// Connect 页两条 Setup guide 的去处:MCP 面与命令行面各自的完整文档const CONNECT_GUIDE_URL: &str = "https://github.com/iAmCorey/Wake/blob/main/docs/mcp.md";@@ -386,7 +391,8 @@ impl SettingsView {.id(id).h(zpx(34.)).w_full()- .px(SPACE_MD)+ .pl(NAV_ITEM_INSET)+ .pr(SPACE_MD).gap(SPACE_SM).items_center().rounded(theme.radius)@@ -402,7 +408,7 @@ impl SettingsView {.on_click(move |_, _, cx| {workbench.update(cx, |this, cx| this.select_settings_page(page, cx));})- .child(icon(icon_path).with_size(zpx(15.)).flex_shrink_0())+ .child(icon(icon_path).with_size(NAV_ICON).flex_shrink_0())// 放大档位下侧栏可能比标签窄:单行截断,行高是定的,换成两行会压到下一项.child(div()@@ -437,14 +443,12 @@ impl SettingsView {this.child(TitleBar::new().h(SETTINGS_TITLEBAR_H))}).child(- div()- .px(SPACE_LG)+ // 首字的字形中心压在红灯中心线上,与下面导航图标的中心同一条竖线+ sidebar_title(t("Settings"), window)+ .pr(SPACE_LG).pt(SPACE_SM).pb(SPACE_XL)- .text_size(FONT_HEADING)- .font_semibold()- .text_color(theme.sidebar_foreground)- .child(t("Settings")),+ .text_color(theme.sidebar_foreground),)// 放大档位下两组导航可能比窗口高:包进滚动容器。上面那组 flex_1 把下面那组// 顶到底;放不下时它不会被压到内容以下,于是溢出、可滚@@ -457,7 +461,7 @@ impl SettingsView {.child(v_flex().flex_1()- .px(SPACE_SM)+ .px(NAV_EDGE).gap(zpx(2.)).child(self.render_nav_item("settings-general-nav",@@ -511,7 +515,7 @@ impl SettingsView {).child(v_flex()- .px(SPACE_SM)+ .px(NAV_EDGE).pb(SPACE_SM).gap(zpx(2.)).child(self.render_nav_item(diff --git a/crates/wake/src/theme.rs b/crates/wake/src/theme.rsindex 4a02d15..c31019f 100644--- a/crates/wake/src/theme.rs+++ b/crates/wake/src/theme.rs@@ -116,6 +116,9 @@ pub fn agent_series_color(agent: wake_core::models::AgentId) -> u32 {// 品牌柠檬黄 #F7F569 在白底上几乎看不见(对比 1.15),压深一档;离 Hermes 的// 金色 ΔE00 11.9(色板里最近的一对只有 5.4)Kilo => 0xC8C035,+ // 品牌是黑白的,色板里已有两档灰(Grok Build、ZCode),再加一档分不出来;给离全部现有+ // 颜色最远的一档深莓红(最近的 Kimi 粉 ΔE00 19.9)+ GrokBot => 0xAC396D,}}diff --git a/crates/wake/src/ui.rs b/crates/wake/src/ui.rsindex 7af04e5..df556c6 100644--- a/crates/wake/src/ui.rs+++ b/crates/wake/src/ui.rs@@ -9,8 +9,9 @@ use std::collections::HashSet;use std::ops::{Add, Mul, Neg, Sub};use gpui::{- div, px, AbsoluteLength, AnyElement, App, DefiniteLength, Div, Global, Hsla,- InteractiveElement as _, IntoElement, Length, MouseButton, Pixels, Styled, Window, WindowId,+ div, px, AbsoluteLength, AnyElement, App, DefiniteLength, Div, FontWeight, Global, Hsla,+ InteractiveElement as _, IntoElement, Length, MouseButton, ParentElement as _, Pixels, Styled,+ Window, WindowId,};use gpui_component::{button::Button,@@ -267,7 +268,9 @@ pub const SIDEBAR_EDGE: Zpx = Zpx(10.);// (导航图标、品牌图、文件夹图标、组头的折叠 chevron)的**中心**都压在这条竖线上。// 注意:中心对齐与左缘对齐是同一个自由度,只能满足一个——选了中心,// 图标左缘就会落在 17.75,比红灯左缘还靠左 2.25,这是预期而非错位。-// 两个内边距(LEAD_INSET / TITLE_INSET)是同一条轴推出来的,改一个必须重算另一个。+// 压轴的内边距一律经 `axis_inset(行首元素宽, 容器边距)` 从这条轴推出(侧栏行、组头、底部工具条、+// 设置窗导航),标题的首字宽是现量的(`sidebar_title`)。容易漏的是容器边距那一项:容器的+// 内边距改了,传给 axis_inset 的必须是同一个常量,不然行首元素整列离轴。/// 侧栏中轴(100% 档)。界面缩放时 traffic light 跟着它挪(`ui_zoom::traffic_lights`)pub const LEAD_AXIS: Zpx = Zpx(26.75);@@ -278,17 +281,38 @@ pub const LEAD_BOX: Zpx = Zpx(18.);/// 侧栏导航行的线条图标边长(品牌图占满 18px 槽位,线条图标比实心品牌图视觉轻,小一档/// 才平衡);组头的折叠 chevron 同一档,描边粗细才一致pub const NAV_ICON: Zpx = Zpx(15.);+/// 宽 `lead` 的行首元素中心压轴所需的左内边距:轴 − 半宽 − 容器自己的内边距 `edge`+pub const fn axis_inset(lead: Zpx, edge: Zpx) -> Zpx {+ Zpx(LEAD_AXIS.0 - lead.0 / 2. - edge.0)+}/// 行左内边距 = 26.75(轴) − 9(槽位半宽) − 10(SIDEBAR_EDGE,容器那一半)-pub const LEAD_INSET: Zpx = Zpx(LEAD_AXIS.0 - LEAD_BOX.0 / 2. - SIDEBAR_EDGE.0);+pub const LEAD_INSET: Zpx = axis_inset(LEAD_BOX, SIDEBAR_EDGE);/// 分组项(agent/项目)相对轴的右缩进,表达从属。/// 压轴的只有主导航行与组头;分组项一律偏这么多。pub const SUB_INDENT: Zpx = Zpx(12.);// 组头(Agents / Projects)没有自己的内边距常量:NAV_ICON 的 chevron 按自己的框居中压轴//(见 workbench.rs group_header);靠首字母字形宽度反推的 GROUP_HEAD_INSET 已删(2026-09-22)。-/// 侧栏标题 "Wake" 的左内边距:同样让首字母 W 的字形中心落在轴上。-/// 实测 16px semibold 的 W 宽 14.25、左承距 0.5,文字左缘需 19.65;-/// 减去容器的 SIDEBAR_EDGE 得 9.15,取 9.0(2x 屏下 0.5px 以下的差会被光栅化吃掉)。-pub const TITLE_INSET: Zpx = Zpx(9.);+/// 侧栏标题(主窗的 "Wake" / "Memory",设置窗的 "Settings"):Heading semibold,首字的字形中心+/// 压在中轴上。首字按标题实际继承的字体现量(`layout_width` 走 gpui 的逐帧排版缓存,字号与字重+/// 就是这个 div 自己的),标题换页、换语言照样对得上——原先的 TITLE_INSET = 9 按 "Wake" 的 W 写死,+/// Memory 页与设置窗标题都偏(2026-10-11 用户报设置窗的 S 没压在红灯中心线上)。量的是字宽一半:+/// SF Pro 首字的左承距比右承距略大,字形实际中心再偏右约 0.15,在光栅化步长以内。div 从侧栏左缘+/// 起排,调用方只补纵向与右侧的内边距和颜色+pub fn sidebar_title(title: &'static str, window: &Window) -> Div {+ const WEIGHT: FontWeight = FontWeight::SEMIBOLD;+ let inset = title.chars().next().map_or(Pixels::ZERO, |first| {+ let mut font = window.text_style().font();+ font.weight = WEIGHT;+ let text = window.text_system();+ let width = text.layout_width(text.resolve_font(&font), FONT_HEADING.get(), first);+ (LEAD_AXIS.get() - width / 2.).max(Pixels::ZERO)+ });+ div()+ .pl(inset)+ .text_size(FONT_HEADING)+ .font_weight(WEIGHT)+ .child(title)+}/// 侧栏主导航行高(固定区:All Sessions/Starred;搜索框同高)pub const ROW_HEIGHT: Zpx = Zpx(32.);/// 侧栏子级行高(分组展开项:agent/项目)——比主导航低一级,diff --git a/crates/wake/src/workbench.rs b/crates/wake/src/workbench.rsindex a50a50d..afe1b26 100644--- a/crates/wake/src/workbench.rs+++ b/crates/wake/src/workbench.rs@@ -2397,7 +2397,7 @@ impl UsageBoard {}}- /// Agents 全量列出(总共二十二家);项目/模型长尾长,取前 6+ /// Agents 全量列出(家数有限);项目/模型长尾长,取前 6fn limit(self) -> usize {match self {Self::Agents => usize::MAX,@@ -5596,6 +5596,12 @@ impl Workbench {fn render_sidebar(&self, window: &Window, cx: &Context<Self>) -> impl IntoElement {let theme = cx.theme();+ // Memory 页标题换成 Memory:侧栏顶上就说明现在管的是什么,不另加模式标题行(用户 2026-09-21)+ let title = if self.page == Page::Memory {+ t("Memory")+ } else {+ "Wake"+ };let all_active = self.selected_agent.is_none()&& self.selected_project.is_none()&& !self.favorite_only@@ -5709,27 +5715,13 @@ impl Workbench {))}).child(- div()+ sidebar_title(title, window).flex_shrink_0().h(WINDOW_TITLEBAR_HEIGHT)- .px(SIDEBAR_EDGE).pt(SPACE_XS).pb(SPACE_LG)- .child(- div()- .pl(TITLE_INSET)- .pr(SIDEBAR_EDGE)- .text_size(FONT_HEADING)- .font_semibold()- .text_color(theme.foreground)- // Memory 页标题换成 Memory:侧栏顶上就说明现在管的是什么,- // 不另加模式标题行(用户 2026-09-21)- .child(if self.page == Page::Memory {- t("Memory")- } else {- "Wake"- }),- ),+ .pr(SIDEBAR_EDGE * 2.)+ .text_color(theme.foreground),)// 导航按页切换:Memory 页是记忆的导航(All Memory / Agents / Projects,按记忆// 计数),其余是会话的(搜索框 + All Sessions / Starred + Agents / Projects)@@ -7673,7 +7665,7 @@ fn group_header(// chevron 不占 18px 槽位、只按自己的框居中压轴:槽位居中再接统一间距,墨迹到// 文字会比导航行空出一截(chevron 墨迹只有约 5px 宽,用户 2026-09-22 "间隔太大");// 按框压轴后文字起点比导航行标签左 1.5px,墨迹到文字视觉约 10.9px、与导航行相当- .pl(LEAD_INSET + (LEAD_BOX - NAV_ICON) / 2.)+ .pl(axis_inset(NAV_ICON, SIDEBAR_EDGE)).pr(SIDEBAR_EDGE).pt(SPACE_MD).pb(SPACE_XS)@@ -9607,9 +9599,9 @@ const FOOTER_BTN: Zpx = Zpx(28.);fn sidebar_footer_width() -> Pixels {FOOTER_LEAD_INSET + FOOTER_BTN * 5. + zpx(2.) * 3. + SPACE_SM + SIDEBAR_EDGE}-/// 工具条左内边距 = 26.75(侧栏中轴,红绿灯红灯中心)− 14(按钮半宽):最左那颗-/// 图标的中心压在与导航行行首同一条轴上(用户 2026-09-21)-const FOOTER_LEAD_INSET: Zpx = Zpx(LEAD_AXIS.0 - FOOTER_BTN.0 / 2.);+/// 工具条左内边距 = 26.75(侧栏中轴,红绿灯红灯中心)− 14(按钮半宽),工具条贴着侧栏左缘、+/// 没有容器边距:最左那颗图标的中心压在与导航行行首同一条轴上(用户 2026-09-21)+const FOOTER_LEAD_INSET: Zpx = axis_inset(FOOTER_BTN, Zpx(0.));/// 底部工具条的图标按钮(Zed 状态栏 / Xcode 导航条同款图标条,不带盒子):透明底、/// hover 才出色;`active`(当前页 / 清理模式)用侧栏行的选中色做圆角底 + 选中前景,diff --git a/crates/wake/src/workbench/memory.rs b/crates/wake/src/workbench/memory.rsindex ec624fd..34b18d3 100644--- a/crates/wake/src/workbench/memory.rs+++ b/crates/wake/src/workbench/memory.rs@@ -823,8 +823,7 @@ fn memory_section_label(d: &MemoryDoc, today: NaiveDate, pin_user: bool) -> Shar/// 虚拟路径 `<db>#<id>` 只剥后缀、不 stat(render 每帧调);文件型就是它自己fn memory_display_path(d: &MemoryDoc) -> String {if d.scope == MemoryScope::Thread {- d.path- .rsplit_once('#')+ wake_core::adapters::split_virtual_path(&d.path).map_or_else(|| d.path.clone(), |(db, _)| db.to_string())} else {d.path.clone()diff --git a/docs/cli.md b/docs/cli.mdindex 4f6074b..185f4c4 100644--- a/docs/cli.md+++ b/docs/cli.md@@ -390,7 +390,7 @@ Numeric options outside their range are clamped, not rejected: `--limit 999` on## Agent ids-`claude-code`, `codex`, `grok`, `dsh`, `cursor`, `opencode`, `pi`, `omp`, `kiro`, `kimi`, `gemini`, `copilot`, `antigravity`, `qoder`, `hermes`, `openclaw`, `codebuddy`, `workbuddy`, `zcode`, `craft-agents`, `devin`, `kilo`. Display names (`"Claude Code"`) and a few aliases (`claude`, `deepseek`, `craft`) work too.+`claude-code`, `codex`, `grok`, `grok-bot`, `dsh`, `cursor`, `opencode`, `pi`, `omp`, `kiro`, `kimi`, `gemini`, `copilot`, `antigravity`, `qoder`, `hermes`, `openclaw`, `codebuddy`, `workbuddy`, `zcode`, `craft-agents`, `devin`, `kilo`. Display names (`"Claude Code"`) and a few aliases (`claude`, `deepseek`, `craft`) work too.## Session keys and referencesdiff --git a/docs/mcp.md b/docs/mcp.mdindex 85c30d7..3157da3 100644--- a/docs/mcp.md+++ b/docs/mcp.md@@ -153,7 +153,7 @@ All five tools are read-only and return Markdown text (`content[0].text`). Param| Parameter | Type | Meaning ||---|---|---|| `project` | string | Scope to one project. Pass an absolute path — the agent's working directory is ideal — or a project name. Path matching is three-tier: an exact match of an indexed project path; otherwise the longest indexed project that contains the path (you are in a subdirectory) — your home folder and the filesystem root never count here, since sessions started there are not about the project you are in; otherwise every indexed project below the path (a monorepo root or a parent folder). A bare name matches the project name case-insensitively. When nothing matches, the reply lists the known projects instead of erroring. |-| `agents` | string[] | Only these agents. Ids: `claude-code`, `codex`, `grok`, `dsh`, `cursor`, `opencode`, `pi`, `omp`, `kiro`, `kimi`, `gemini`, `copilot`, `antigravity`, `qoder`, `hermes`, `openclaw`, `codebuddy`, `workbuddy`, `zcode`, `craft-agents`, `devin`, `kilo`. Display names (`"Claude Code"`, `"Gemini CLI"`) and a few aliases (`claude`, `deepseek`, `opencode2`, `craft`) are accepted too. |+| `agents` | string[] | Only these agents. Ids: `claude-code`, `codex`, `grok`, `grok-bot`, `dsh`, `cursor`, `opencode`, `pi`, `omp`, `kiro`, `kimi`, `gemini`, `copilot`, `antigravity`, `qoder`, `hermes`, `openclaw`, `codebuddy`, `workbuddy`, `zcode`, `craft-agents`, `devin`, `kilo`. Display names (`"Claude Code"`, `"Gemini CLI"`) and a few aliases (`claude`, `deepseek`, `opencode2`, `craft`) are accepted too. || `since` | string | Only sessions updated at or after this time. Relative: `30m`, `24h`, `7d`, `2w`. Absolute: `2026-09-01`, `2026-09-01 09:30`, `2026-09-01T09:30:00Z`. Naive date-times are read in local time. || `limit` | integer | Maximum items to return; values outside the allowed range are clamped. |