dsh-point

为 DeepSeek Harness 提供 Point 检查点和基于祖先关系的 Session 续接。

Point 是唯一的历史单位：保存 Point、从 Point 继续，以及在真正需要时按需读取一个已授权的祖先 Point。插件不会把全部旧 Session 自动塞进新上下文。

功能

• /point-stash [标题]：保存上一个 Point 之后完整、参与者可见的事件。
• Workspace Point DAG：在 DSH Web 中查看父子关系、节点详情，并显式选择 Continue from this Point。
• Continue：创建或复用确定性的 DSH Session，只携带 Point 祖先清单，不复制历史事件。
• point_read(point_id)：模型按需读取祖先 Point 的原始事件；非祖先 Point 会被拒绝。
• 崩溃恢复：根据不可变 Point 元数据恢复游标，避免重复保存。
• 保留原始可见消息、内容块、来源元数据和成对工具调用；不把 compaction 结果当作新历史。

环境要求

• Node.js 22.19 或更新版本
• DeepSeek Harness 0.1.0-rc.6
• PATH 中可用的 point CLI

如果尚未安装 Point：

python3 -m pip install "git+https://github.com/guix4ever/point.git"

安装

dsh plugin --profile web add dsh-point

安装后重启 DSH。插件通过 cordis.patch.yml 同时加载 Host 能力和 Web Client。

使用

在一次完整工作结束后输入：

/point-stash 简短说明本次工作

随后可在对话页的 Points 标签查看当前 Workspace 的 Point 图。选择节点不会产生副作用；只有点击 Continue from this Point 才会创建续接 Session。

续接 Session 只拿到祖先 Point 清单。需要历史细节时，模型可以调用：

point_read(point_id)

插件只允许读取当前续接链上的祖先 Point。

开发验证

npm ci
npm run typecheck
npm test
npm pack --dry-run

源码使用 TypeScript，位于 src/ 与 client-src/。运行产物位于 lib/ 并提交进仓库，因此通过 Git 安装时不需要本地构建。

当前范围

• UI 面向 DSH 当前支持的 Web Client Module；Host 能力可以被其他入口复用。
• 图谱保持克制：支持横向滚动，不引入 pan/zoom、聚类、图框架或第二套历史概念。
• 自动化测试已覆盖真实 Point CLI、崩溃恢复、祖先权限、Host 重启幂等，并完成真实 DSH Web/Chromium 验收；首版不要求付费模型调用验收。

License

MIT