返回目录

dsh-filesnap

编辑精选维护状态: 活跃

extracurricular-ai/dsh-filesnap

dsh-filesnap — 把对话和它改过的文件一起回退到某一轮之前,不需要 git 仓库. A blazing-fast rewind and redo plugin for DeepSeek Harness, powered by a 🦀 Rust core, tracking the conversion and the files it changed, no git required, low disk consumption

前往 GitHub项目主页
$ dsh plugin --profile web add dsh-filesnap

41

星标

9

Fork

TypeScript

语言

Apache-2.0

许可证

2026-08-27

创建于

2026-08-28

最近推送

一个原生 DSH 插件,通过分叉出的对话副本与 Rust 快照引擎把对话和工作区文件一起回退——无需 Git,可用 /redo 撤销,并可用 /rewind status 检视。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-09-04

许可证

Apache-2.0

01它能帮你完成什么?

  • 把 DeepSeek Harness 的对话与其工作区一起回退到更早的一轮

    在所选轮次分叉出的对话副本,以及被还原的工作区文件(写入与删除都被撤销)

    希望在不使用 Git 的情况下对智能体改过的文件做撤销/重做的 DeepSeek Harness 用户

  • 核查插件捕获了什么、哪些文件未被保护

    `/rewind status` 给出的存储用量报告,以及未被保护的文件及其各自排除原因

    在信任某次回退前希望审查快照覆盖范围的运维人员

02如何接入 DeepSeek Harness?

前置条件

  • 带 `web` 或 `headless` 配置的 DeepSeek Harness
  • Node.js `^22.19` 或 `>=24`
  • x64 或 arm64 架构的 Linux、macOS 或 Windows

安装步骤

  1. 01

    运行 `dsh plugin --profile web add dsh-filesnap`(无界面用法把 `web` 换成 `headless`)。

    $ dsh plugin --profile web add dsh-filesnap

  2. 02

    在 `~/.dsh/profiles/web/cordis.patch.yml` 中添加一条补丁行(`- insert: - id: filesnap / name: dsh-filesnap`)。

  3. 03

    重启该配置,跑一轮智能体,然后输入 `/rewind`。

验证接入成功

  • 运行 `dsh --profile web --dump-config | grep -A 1 filesnap`,确认出现了 `filesnap` 这一行。

03DSH 适配与能力边界

DSH 适配原生运行时

以 dsh 插件行的形式挂载,并在加载时注册自身的会话事件;通过 `dsh plugin add` 安装,再用一条 cordis 补丁行启用。

  • 对话与文件一起回退

    已捕获工作区状态的 DeepSeek Harness 会话在所选择轮次分叉出的对话副本,以及被还原的工作区文件

    在加载时注册会话事件,因此被捕获的会话依赖该插件保持安装
  • Rust 快照引擎

    每次模型步骤之前的工作区文件按内容寻址、跨轮复用的快照;还原在 Node 进程之外执行

  • 可检视的状态

    `/rewind status` 命令存储用量报告,以及未被保护文件的清单(含各自排除原因)

04适合谁?何时不该用?

适合

  • 希望在不使用 Git 的情况下对智能体改过的文件做撤销/重做的 DeepSeek Harness 用户
  • 在信任某次回退前希望审查快照覆盖范围的运维人员

不适合

  • 卸载插件会导致包含其事件类型的会话无法读取,直到重新安装;磁盘上的会话数据保持完整。

05兼容性、维护与安全提示

  • 卸载插件会导致包含其事件类型的会话无法读取,直到重新安装;磁盘上的会话数据保持完整。
  • 还原会覆盖文件,因此目标轮次必须明确给出;像“后退三轮”这样的相对寻址被刻意不支持。
2026-08-272026-08-28v0.2.1

Apache-2.0 · 活跃维护中(最新发布 v0.2.1,2026-08-27 发布)

06常见问题

如何在 DeepSeek Harness 中安装 dsh-filesnap?

运行 `dsh plugin --profile web add dsh-filesnap`(无界面用法把 `web` 换成 `headless`),然后在 `~/.dsh/profiles/web/cordis.patch.yml` 中添加一条补丁行(`- insert: - id: filesnap / name: dsh-filesnap`),再重启该配置。

它需要安装 Git 或 Rust 吗?

不需要。原生的 filesnap 二进制随包安装,因此你不需要 Rust、Git 或独立运行时;它在代码仓库与普通目录中都能工作,且从不改动提交、分支、stash 或 worktree 状态。

/rewind 做什么,又如何撤销?

回退会在所选轮次分叉出对话副本,并把工作区还原到该分叉中。在还原写入开始前会捕获一个救援点,而 `/redo` 会撤销落在当前会话中的这次回退。

如果我卸载插件会怎样?

包含其事件类型的会话会变得无法读取,直到你重新安装插件;数据在磁盘上保持完整。由于 dsh 还没有为仓库外插件事件类型提供受支持的注册 API,该插件在加载时注册自身会话事件。

如何查看捕获了什么、哪些未被保护?

运行 `/rewind status`。它会报告存储用量,并列出未被保护的文件及其排除原因,便于你在信任某次回退前审查快照覆盖范围。

08数据与来源

  • 作者声明github.come7d13a98fda3…

    $ dsh plugin --profile web add dsh-filesnap

  • 作者声明github.come7d13a98fda3…

    DeepSeek Harness with a `web` or `headless` profile

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-04。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。