v0.4.0 — 适配 DeepSeek Harness 0.1.5-rc.1（最新版 API 迁移）

🎉 Release v0.4.0

本版本将 dsh-chat-archive 适配到 DeepSeek Harness 最新版 0.1.5-rc.1。
原版本依赖较旧的 DSH API 且 peerDependencies 无法解析最新版，现已完成工程化迁移。

适配 DeepSeek Harness 0.1.5-rc.1 或更高版本

---

🔄 Breaking API 迁移

逐一比对 0.1.1-rc.2 与 0.1.5-rc.1 的类型声明后，修复了以下破坏性变更：

变更点	旧版 (0.1.1/0.1.2)	0.1.5-rc.1（最新）
sessionPersistence.locate()	存在，返回工件路径	❌ 已移除
sessionPersistence.list()	返回 SessionHeader[]	返回 SessionPersistenceSnapshot[]
settings 注册	自由函数 installSettingsSection	服务方法 ctx.settings.installSection
客户端快照存储	@deepseek-ai/dsh-client-runtime	➡️ @deepseek-ai/dsh-client-store

---

✨ 主要变更

Host 端

• 闲置时间检测重构：locate() 移除后，改为在 $DSH_HOME/sessions 下按会话 id 树扫描定位 session.jsonl.* 工件并读取 mtime（兼容 session-<id> 与 <id> 两种目录命名）。
• list() 适配新的 SessionPersistenceSnapshot[] 结构（通过 .header.id 取会话 id）。
• 设置命名空间改用 ctx.settings.installSection(...)，并在 inject 列表加入 settings 服务。

Client 端

• 快照存储依赖迁移：dsh-client-runtime → dsh-client-store。

工程清单

• peerDependencies：^0.1.1-rc.2 → ^0.1.5-rc.1。
• dsh.client.inject 移除已失效的 dsh-client-runtime。
• 版本 0.3.0 → 0.4.0。

脚本 & 文档

• preview-archive.mjs / selfcheck-host.mjs 适配新的 $DSH_HOME/sessions 结构。
• README / CHANGELOG 已同步更新。

---

✅ 验证

• Host 源码通过 0.1.5-rc.1 真实类型 的 tsc --noEmit 校验
• npm run build ✅
• 单元测试 6/6 通过 ✅
• Host 自检（归档 / 防误归档 / 幂等性 / 区间守卫）全部通过 ✅
• 预览脚本正确扫描真实会话存储 ✅

---

📦 安装

# 适配 DSH 0.1.5-rc.1 或更高版本
dsh plugin --profile web add @ohmejj/dsh-chat-archive@0.4.0

v0.3.0 — 首次发布

首次发布

发布首个稳定版本，提供基础功能与完整的插件运行能力。

主要内容

• 完成核心功能实现
• 完成插件基础配置
• 完善构建与发布流程
• 支持 npm 包发布与安装
• 补充项目文档与使用说明

版本信息

• Version: 0.3.0
• Release: 首次正式发布