Agent Skills
返回列表
WorkBuddy 对话归档

WorkBuddy 对话归档

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4a403661/wb-session-archive。

技能介绍

要解决的问题

WorkBuddy 桌面端左侧会话列表来自主进程读取 ~/.workbuddy/workbuddy.db 里的 sessions 表,并按 status 过滤后推给渲染进程。只改数据库不会让 UI 立刻隐藏会话;若归档后仍在界面里点开并继续对话,主进程会把本地 status 从 archived 改回 completed,而云端仍可能保持已归档。批量整理历史对话、按标题关键字清理旧项目时,需要一套本地 + 云端 + UI 刷新都对齐的流程,而不是单靠 SQL 或单靠云端接口。

技能如何工作

本技能整理了三类存储与一条云端 API 的对应关系:会话索引在 sessions 表,消息流在项目目录下的 .jsonl,云端 conversation_id 映射在 edge-sync-mapping.db。归档时典型三步是:

  1. 本地 DB:UPDATE sessions SET status='archived' WHERE id='…'
  2. 云端:带 JWT 调用归档接口;200 成功,500 且提示已归档视为幂等成功,404 表示未上云可只走本地
  3. 重启客户端:完全退出再打开,主进程重新加载 DB,UI 才会按归档状态隐藏列表项

目录内 archive_conversation.py 可在给定会话 ID 后串联本地改状态、云端请求与结果校验;配合 sqlite3 按 title LIKE 查 ID 即可做批量场景。凭证从桌面端 Data/Public/auth/ 下明文 .info JSON 读取 auth.accessToken 与 account.uid,仅限本机使用,脚本里只保留读取逻辑。

适用边界与注意点

  • Web 版 WorkBuddy 不走该凭证文件,技能面向桌面端。
  • 最省事仍是在 UI 右键「归档」(archiveSession RPC 会同步 DB、云端与刷新事件);脚本 + 重启适合批量。
  • 操作前建议备份:cp ~/.workbuddy/workbuddy.db 到带时间戳的备份路径。
  • 归档完成到 UI 生效之间不要再打开该会话发消息,否则本地状态会被覆盖。

使用场景

  • 历史项目会话太多,需要按标题关键字查出 ID 后批量写入 archived 并同步云端
  • 写自动化前要先确认某会话是否已上云,以便决定 404 时是否只改本地 DB
  • 整理测试用的沙盒会话(is_playground=1),与正式会话走同一套本地+云端+重启流程
  • 发布团队内归档脚本前,只保留从本机 .info 读取 token 的逻辑,避免误传 JWT

适合人员

  • 长期在 WorkBuddy 桌面端跑多个代码项目、需要定期隐藏已完成会话的工程师
  • 要按 SQL 批量归档、又担心只改库导致 UI 仍显示会话的运维/内部工具维护者
  • 需要调用云端归档 API 并理解 200/404/幂等 500 响应的集成脚本作者
  • 在企业多账号环境下,要在 auth 目录里选对与当前产品匹配的 .info 凭证的桌面用户