切换手册章节
storages 目录里，哪份文件适合查什么？
图里两项几乎同名：session_projcache 是文件夹，session_projcache.json 是文件。要查失踪的聊天、上次定时提醒或找不到的项目，请先分清它们与 workspace.json、schedule.json 各自负责什么。
本篇目录 5 节
先找到当前运行实例的数据目录
Windows 本机采用默认设置时，在资源管理器地址栏输入 %USERPROFILE%\.dsh\storages。macOS 或 Linux 的默认位置是 ~/.dsh/storages。截图只说明当时查看的 Windows 用户目录，别照抄截图中的账号或盘符。
如果启动 Harness 时设置了 DSH_HOME，请在该目录下找 storages；显式配置的数据根优先，具体存储插件的 root 也可单独配置。使用远程 Web 工作台时，看运行 Harness 服务那台电脑的数据目录。在同一数据根下，桌面端与 CLI 可以共享产品数据，各自的可执行插件环境有独立位置。
对照资源管理器里的四项
| 截图中的项目 | 里面有什么 | 适合回答什么 |
|---|---|---|
| workspace.json | 工作区登记、显示顺序、项目与会话的关联、归档及置顶。 | 这个项目登记到哪？哪些会话被归档了？ |
| schedule.json | 定时任务的持久记录，包括绑定会话、规则、指令与状态。任务有过投递时，可带投递回执。 | 提醒设置何时触发、投到了哪个会话？投递回执只确认消息进入收件箱，实际执行要查会话。 |
| session_projcache/ | RC5 默认按会话保存的派生缓存。其 sessions/ 下每个会话可有一份 <会话ID>.json，方便快速显示会话标题等列表信息。 | 为什么会话列表能很快显示标题？这是程序为快速读取保留的检查点。 |
| session_projcache.json | 早期整份写在一个文件里的缓存形式，可能在升级后保留。 | 旧布局是否还留在磁盘？单凭文件名与修改时间，看不出当初是否成功导入。 |
作者提供的 Windows 实图，账号名已遮盖。不同版本、后端和使用记录可能产生不同文件。
- 1地址栏定位 storages
- 2找到 workspace.json
新文件夹和旧文件为何能同时存在？
RC5 打开新的逐会话缓存时，如果新目录树里还没有已声明表的记录文件，就会检查旁边旧格式的同名 JSON。旧文件有效、名称和格式版本兼容时，它将记录写入新目录，并保留源文件原样。新目录已有记录文件时，程序会跳过这一整次旧文件导入，以免旧值覆盖新状态。
我们用发布包做了一个隔离实验。准备一条虚构的第 6 版旧缓存，在新的暂存目录启动缓存服务，得到一份第 7 版的逐会话文件，原文件字节完全相同。再给旧文件补一条虚构记录并重启，已有新目录没有重新导入它。这个实验解释了截图所示布局为何可能出现；截图没有记录该电脑的迁移经过。
只读排查，按你遇到的问题选一行
| 遇到的情况 | 先做什么 | 怎样判断 |
|---|---|---|
| 项目名在左栏，文件夹打不开 | 对照索引的 path，在同一台机器和账户下用资源管理器访问实际目录。 | 先分清盘未挂载、目录已移动和拒绝访问。旧归属可能保留；让有权限的目录所有者核对权限。 |
| 要找会话原话、工具结果 | 先打开对应会话看历史。RC5 Web 会话的更多操作提供“下载 Session 日志”，也可用 /export。 | 默认原始日志来自 sessions/。导出的 ZIP 可能包括子会话和被引用的附件，分享前检查内容。 |
| 缓存里找不到最近一条聊天 | 先打开对应会话，对照历史与会话 ID。 | 缓存保存部分派生值，也可能暂时落后；有无某个缓存字段不能断定原话已丢失。 |
| 索引报错或列表看起来少了 | 核对当前 Host、运行账号、数据根、归档和实际目录。只需核对文件时，将索引复制到自己的临时目录，再用文本查看器打开副本。 | 保留原件与错误信息。避免手改 ID、清空数组、重命名或删除缓存来试错。文件内容与程序内存同时变化时，手工写回会破坏排查依据。 |
怎样认识日志文件名和截图顶部的蓝条
默认后端把会话日志按版本保存，采用 Zstandard 压缩。本次两个空会话在落盘后都产生了 session.v4.jsonl.zstd。历史数据可能出现其他代际文件名，明确关闭压缩后也会看到 .jsonl。用会话界面的查看或导出入口读内容，可以省去手动定位、解压和识别日志版本。
编辑器截图最上方的蓝条是 VS Code 的工作区信任提示。只读查看 JSON 可以保持受限模式。判断 Harness 能否写入项目，要查 Harness 本次任务的工具和权限，两处提示属于不同应用。
来源与延伸阅读
知识库与演示素材
知识库附录含录屏分镜。练习包里的 INDEX.md 可按题目查找会议简报、只读目录核对、Cordis 报销回执，以及门店销售和团队练习。