把 DSH 会话存成一个 .dsproj 工程文件：像 Word 那样保存，像工程文件那样拷走。
换个 DSH、换台机器，打开这个文件就能接着上次的话题继续。
已上架 · listed on
English · 中文
 --- ## 核心功能与使用场景 DSH 把每条会话都记在 `~/.dsh/sessions/` 里，`session.v4.jsonl.zstd` 是追加写的 zstd 帧。这样做很稳，但带来三个麻烦： - **想带走一条会话，得整目录搬。** `~/.dsh` 里有会话、记忆、附件、索引、插件状态，几个 GB 起步，搬一次等于换整台机器。 - **想存档一条对话，只能手动拷文件。** 拷完是个没有名字的 UUID 目录，过两周就想不起来它是哪次讨论。 - **两台机器轮流用，谁覆盖谁说不清。** 直接同步 `~/.dsh` 会让索引、状态、日志互相打架。 `dsh-session-save` 把这堆东西收成一个文件：**一个会话 = 一个 `.dsproj`**，名字是会话标题，里面是这条对话的全部历史加它所在工作区的记忆与引用附件。发给别人、丢进网盘、归档进项目仓库，都只是"一个文件"的事。 装上后，标题栏右侧多出四个图标： | 图标 | 动作 | 说明 | | :--: | --- | --- | | 📁 | **打开** | 选一个 `.dsproj` → 导入 → 自动切到那个会话 | | 💾 | **保存** | 第一次弹「另存为」，之后每点一次覆盖同一个文件 | | 🔄 | **自动保存** | 开着的话，每步结束自动写回那个文件 | | 📄✏️ | **另存为** | 每次都弹窗口，可以换名字或换位置，原文件保留 | 空会话页面的新会话行右侧还会多一个「打开」胶囊按钮。刚进 DSH、还没有对话时，也能直接开一个工程文件。  ## 快速上手 1. 聊到一半点 💾（或者直接点 🔄 开自动保存，它会先替你存一次）。 2. 弹窗里确认文件名，默认是「会话标题 + 会话创建时间」，比如 `把会话存成工程文件-20261025-1043.dsproj`。 3. 之后每点一次 💾 就覆盖它；想留一份快照就点 📄✏️。 在另一台机器上：点 📁 选这个文件，会话会出现在列表里并自动切过去，接着上次的话继续说。 ## 文件命名与保存保护 ``` 把会话存成工程文件-20261025-1043.dsproj └── 会话标题 ──┘ └─ 创建时间 ─┘ ``` - 标题取日志里最新的 `session/title`（DSH 自己起的那个，通常是第一句话或 LLM 的概括）。 - 时间取会话**创建**时间，不是点保存的时间。同一个会话每次另存为都得到同一个名字，不会越存越乱。 - `\ / : * ? " < > |` 和控制字符换成空格，连续空白折叠，最长 60 字。 - 还没起标题的会话退回 `20261025-1043-session-7f3a2c91.dsproj`（时间 + id 前 8 位）。 - 目录用上次保存的目录，第一次是桌面。 - **覆盖保存不改名**：记住的是完整路径，标题后来变了也不会突然冒出一个新文件。 ### 保存时的存在性保护 保存的目标是「那个路径上的那个文件」，不是「那个路径」。所以每次写盘之前都会先看它还在不在： - **手动保存**发现不在了（被删、被移走、磁盘或网盘没挂上）→ 弹窗把原来那个路径摊给你看，三个选择：**就在这里新建**（原路径上重新起一份） / **另存到别处**（换个位置，原路径不碰） / **取消**（什么都不写）。默认什么都不写，不会在空位上放一个同名空壳。 - **自动保存**发现不在了 → **自己关掉自动保存**，并在界面告诉你原因（带原路径），这一轮不写盘。 - 目标**文件夹**整个没了（比如网盘没挂上）也一样：报「目标目录不存在」，不再悄悄 `mkdir -p` 把目录和文件一起造出来。 ## 打开与导入流程 点「打开」之后，Host 侧按这个顺序判断（`importPackage()`）： ```mermaid flowchart TD A[读 .dsproj] --> B{本机有这个会话 id 吗} B -- 没有 --> C[问：打开到哪个工作区] C --> D[导入，并把 header 的 cwd 改写成本机路径] B -- 有 · createdAt 相同 · cwd 相同 --> E[直接切过去，不复制不写盘] B -- 有 · createdAt 相同 · cwd 不同 --> F[就地再开一份，换新 id 落地] B -- 有 · createdAt 不同 --> G[冲突面板：四选一] D --> H[切到该会话] E --> H F --> H G --> H ``` 导入时的交互与落盘行为： - **本机没有这个会话**：弹窗询问「打开到哪个工作区」，确认后改写 header 里的工作区路径并切过去。打开成功后，这个 `.dsproj` 会被记成该会话的「保存位置」——接着点 💾 就是存回同一个文件。 - **本机已有且完全一致**（`createdAt` 相同且 `cwd` 相同）：直接切过去，不复制也不写盘。 - **同会话换工作区落地**（`createdAt` 相同但 `cwd` 不同）：换新 id 落地（`relocate`），就地再开一份。 - **会话冲突**（`createdAt` 不同）：弹出冲突面板，把两边并排列出来（标题、创建时间、体积、工作区 / 导出机器），四个按钮供选择： | 按钮 | 做什么 | | --- | --- | | 取消 | 什么都不做 | | 另存为副本 | 换新 id 落盘，两条历史都留着 | | 用文件覆盖本机 | 先给本机那份留 `.bak-<时间戳>`，再写回同一目录 | | 用本机的 | 只切到本机那份，不写盘 |