Files
ycode/docs/reference/workbuddy-reference-import.md
T

47 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# WorkBuddy 本地对话参照导入
2026-10-08 已确认:WorkBuddy AI 的会话正文保存在本地,并非只能从云端获取。
此前参照文档只检查了 AppData 下的 WorkBuddy 目录,遗漏了 `.workbuddy-ai`。
## 数据位置
- `%USERPROFILE%/.workbuddy-ai/workbuddy.db`:`sessions` 表保存标题、工作目录及会话 ID。
- `%USERPROFILE%/.workbuddy-ai/sessions/<pid>.json`:运行进程对应的会话 ID。
- `%USERPROFILE%/.workbuddy-ai/projects/<目录键>/<sessionId>.jsonl`:正文及工具调用记录。
无需 UI 自动化或内存 hook;读取这些文件不会修改 WorkBuddy。
## 转换
```powershell
python scripts/import-workbuddy.py '<会话 JSONL 完整路径>'
python scripts/import-workbuddy.py '<会话 JSONL 完整路径>' --apply
```
默认只预检。`--apply` 先通过 SQLite backup API 备份 Ygent 数据库,再以事务创建独立任务及消息,逐字段回读验证。
同一 WorkBuddy 会话已有导入任务时跳过,避免重复;此脚本不增量同步。
转换文件和数据库备份放在 `%USERPROFILE%/.ygent/imports/`,不写入代码仓库。
默认标题从 WorkBuddy `sessions` 表读取(优先 `custom_title`);无来源数据库时回退到 JSONL 的 `ai-title`,也可用 `--title` 覆盖。
映射规则:
- 用户消息提取 `<user_query>`,过滤系统注入与纯恢复提示。
- 助手消息保留可见正文,不导入内部推理正文、模型凭据或 provider 元数据。`reasoning`事件仅记录存在及相邻可见消息的位置,写入`render_meta.reasoningBefore`;没有可公开展示的摘要时只呈现事件标题,不提供空的展开按钮。
- 行内代码在消息来源cwd下能识别为真实文件/目录时,保存标签、路径和类型;代码文本不改写,原始正文仍用于搜索/复制。普通新对话由共享路径组件通过真实IPC在所属会话工作目录下识别,不按参照会话ID或标题硬编码。
- 工具按 `callId` 匹配结果,在调用位置插入工具行,保留原参数、输出和可用的 description。
- 保留消息时间;没有结果的调用注明“此调用没有执行结果记录”。
- `show_widget` 的 HTML 保留在工具参数中,并在独立 sandbox iframe 内渲染。
## 当前显示限制
2026-10-08补齐呈现元数据:更新版本首次启动迁移到v10后,运行`python scripts/import-workbuddy.py '<源JSONL完整路径>' --enrich --apply`。仅处理已导入且逐条role/content/fn/result与来源完全一致的参照会话;不匹配即拒绝。先备份数据库,再事务更新render_meta并回读验证,保留消息ID、内容、工具数据及顺序。本次829条已验证,新增374个事件位置标记和7个路径关联。来源文件与推理正文均不改写/导入。
“深度思考”当前仅恢复事件位置标题,未恢复内容展开或真实模型的思考阶段流式事件;仍不能作为动态思考行为对标通过。路径标签已支持键盘/点击打开,原生验收只执行只读路径分类,未自动启动外部文件应用。
这是一份参照快照,不会恢复 WorkBuddy 内核上下文。不要把导入记录当作可续接的原内核会话。
Ygent 已按导入顺序呈现正文、工具和权限事件,并只折叠连续的工具调用;工具结果仍主要显示单行摘要。
本次源会话的五份 HTML 制品已在 sandbox iframe 中渲染;其中一份 SVG 的 iframe 高度仍比 WorkBuddy 少 5px。图片附件、内部推理、审批交互和完整工具结果查看器尚未完整呈现。
本次导入的源会话为 `05c73f5f-e3ac-452e-bfde-fd5be036e588`,当前 WorkBuddy 标题和 Ygent 参照任务标题均为“处理大文件”。
转换结果为 26 条用户消息、254 条助手正文、549 条工具调用,其中一条调用没有结果记录。