Trae CN Solo 模式历史对话:存储在本地 past-chats 目录,用 `#` 直接引用

背景

在 Trae CN 中开发"项目历史评估"技能时,需要读取 Solo 模式任务的历史对话记录。最初误以为要解析 Trae 内部数据库,浪费大量 token 扫描 workspaceStorage、state.vscdb、IndexedDB 等路径,实际机制非常简单。

本地存储路径:%USERPROFILE%\AppData\Roaming\Trae CN\User\workspaceStorage\{workspaceId}\past-chats\past-chat-*.md,每个工作区一个目录,历史对话以 Markdown 文件保存。Windows 下可用 Win + E 粘贴路径直接打开。
界面查看:Solo 三栏布局中,左侧多任务面板可切换任务查看历史对话;对话面板右上角有历史会话管理(支持跳转、删除、导出,v3.3.41+ 可在多任务面板导出)。
编辑器内引用:在输入框用 #past_chat:任务名 即可引用历史对话,内容由 Trae 客户端自动读取并注入上下文(v3.3.41+ 支持 # 快速引用)。
技能设计要点:AI 技能获取历史对话应只依赖两个来源——当前对话(已在上下文窗口)和用户用 #past_chat: 显式引用;禁止主动扫描 workspaceStorage 等 IDE 内部存储(SOLO 对话同时存于 .vscdb SQLite 库,但不应由 AI 去解析)。

提炼自 inbox/trae/20260424_Optimize_Project_History_Assessment_Skil.md