# 版本记录

<!-- dshgp-version:start -->
## 版本列表

| 版本 | 内容 |
|------|------|
| 1.0.9 | **加固 `truncate`：拒绝写出乱序/缺口日志**。源日志里 compaction 等事件的 seq 可能插队（文件顺序并非严格单调），因此改为「按 seq 过滤 + 强制校验保留序列严格 +1 连续」，不合格直接拒绝写盘并提示换 `--seq`；同时丢弃所有无 seq 事件（保留它们会在尾部混出大 seq ⇒ DSH 判 `has seq gap`） |
| 1.0.8 | **新增 `truncate` 命令：按事件 seq 截断会话，用于排查「某段内容导致上游拒绝请求」**（`node cli.mjs truncate <文件> --seq <n> [--yes] [--provider p --model m]`）。安全链：整目录备份 → 吸附到「无未闭合 step」的边界（否则补的 turn/end 会被 DSH 判 `turn/end does not match the open turn with no open step`）→ 按需补 turn/end → seq 连续性校验 → 拒绝残留 seq>keepSeq 的事件（否则 DSH 判 `has seq gap`）→ 原子写回；默认预览，`--yes` 才写。可选 `--provider/--model` 把样本里残留的旧 provider（如 wb 无 adapter）改成当前可用值。新增 `test/test-truncate.mjs`（11 项断言：边界吸附 / 补收尾 / seq 连续 / 无超界 / 备份 / 预览不落盘 / 过小 keepSeq 拒绝） |
| 1.0.7 | 文档同步 useful-tools 0.1.26 的预览/最小宿主行为：`preview.spec.mjs` 可省（标题自动取目录名）；`preview serve` 省略 backend 自动接最近一次 minihost；`minihost start` 默认隔离 `DSH_HOME`（需读真实实例时显式传 `env`）；预览页内错误面板；`gen` 会提示预览产物不要入库 |
| 1.0.6 | **补附件搬运与校验——只搬会话日志不搬 `media/`，打开会话会报 `Attachment object is missing.`**：导入目录时把 `media/sha256:<摘要>.<ext>` 按内容寻址放进 `<DSH_HOME>/attachments/v1/objects/<前两位>/<摘要>`，落盘前用 sha256 校验（内容与文件名不符则拒绝并列出）；`check` 增加附件存在性检查，打印「引用 N，缺失 M」并列出缺失摘要。自测补 5 项断言（落盘/摘要校验/引用统计/缺失报告） |
| 1.0.5 | **修「投放 v4 会话时文件名不带版本段，导致目标实例 workspace 服务启动失败、前端所有会话不可见」**：落盘文件名改为按 `header.version` 生成——v0 用 `session.jsonl.zstd`，其余用 `session.v<version>.jsonl.zstd`（含 `subagents/<id>/`）。配套：`check` 增加「文件名版本段 vs header.version」一致性检查（不一致时给出应为的文件名与修法）；`fix <DSH_HOME>` 增加自动改名修复（默认预览，`--yes` 才执行；只改名不动内容，幂等）；新增 `test/test-naming.mjs`（命名映射 / 检出 / 改名 / 幂等 11 项断言）。另：删除自持的预览生成器、静态服务器、假数据与 minihost 脚本，预览与最小宿主统一由 dsh-useful-tools 提供（连预览标题都由其按目录名生成） |
| 1.0.4 | 代码质量优化（审计评分 77.2→81、warning 66→35）+ 升版三处同步；README 分体式文档重构——文件树/函数列表/版本记录移出 README，独立 md + 链接引用（git-push doc- 三脚本生成）；doc-tree sync 清理 _meta.worktree 变动记录（提交后重新 sync，清掉 tree-doc.json 中的未提交变动元数据）；doc-version 脚本修复后重新生成版本表——五个版本独立成行，接入 dshgp-version 自动维护 |
| 1.0.3 | 升版并同步发版三件套——版本号三处（lib/index.js、package.json、README 版本记录表）升至 1.0.3，新增 .auditignore 豁免单文件入口 lib/client.js（不拆文件、不引入构建链的架构固有行数/嵌套不入审，与 dsh-git-push 对同路径文件的豁免理由一致） |
| 1.0.2 | zip 导出包导入后不可列/不可转——导入时即解包成标准目录形式；转换内置全工作区去重——同 id 会话已存在于其它工作区时提示并移出旧份备份（session-backups，可恢复）后重新转换，杜绝「一个会话两次恢复到不同工作区」的重复副本；CLI import 与 /convert 均生效，前端提示同步 |
| 1.0.1 | 整理浏览器半侧 lib/client.js——消除重复字典、拆长函数、修 TDZ 隐患 |
| 1.0.0 | 首个正式版——浏览器半侧迁至 lib/client.js，修复导入误报未选择文件 |

<!-- dshgp-version:end -->