创建本地内容寻址工作区存档,提供差异预览和两阶段确认恢复。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-time-machine
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:zjukop/dsh-time-machine
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
给 DeepSeek Harness 装上一台工作区时光机:改之前存档,改崩后安全回去。
dsh-time-machine 是一个本地优先的 DeepSeek Harness 插件。它把工作区保存为内容寻址快照,展示当前文件与存档之间的差异,并通过“两阶段确认”恢复文件。
为什么可能爆火
- 一句话能演示:“鲸鱼,重构前存个档。”
- 解决真痛点:Agent 的上下文能撤销,不代表已经写入磁盘的文件能撤销。
- 安全感可视化:恢复前明确展示新增、修改、删除文件数量。
- 本地优先:文件内容不会上传到额外服务。
- 不要求 Git:草稿、未初始化仓库、被忽略文件同样能保护。
安装
npx @deepseek-ai/dsh plugin --profile web add dsh-time-machine
重启 dsh web。本地开发时也可以传入当前目录:
npx @deepseek-ai/dsh plugin --profile web add .
DSH 的插件管理会调用 pnpm,请确保 pnpm --version 能正常运行。
对话示例
重构登录模块前,先给工作区存个档,叫“登录重构前”。
看看当前工作区和“登录重构前”相比变了什么。
预览回到“登录重构前”,先不要真的恢复。
只有在用户看过预览并明确同意后,Agent 才应调用真正的恢复工具。
工具
| 工具 | 作用 |
|---|---|
time_machine_checkpoint |
创建存档 |
time_machine_list |
查看存档 |
time_machine_diff |
只读比较 |
time_machine_restore_preview |
预览恢复并签发短时一次性令牌 |
time_machine_restore |
使用令牌执行恢复 |
恢复默认使用 merge:恢复旧文件,但保留存档后新增的文件。exact 会删除这些新增文件,必须在预览时明确选择,并使用与该模式绑定的确认令牌。
存储与边界
- 数据默认存储在工作区的
.dsh-time-machine/。 - 默认忽略
.git、node_modules、.DS_Store、存储目录和符号链接。 - 单文件默认上限 10 MiB,单次存档默认上限 200 MiB。
- 当前版本不是 Git 替代品:没有分支、远端同步或垃圾回收。
- Developer Preview 阶段的 DSH API 可能发生破坏性变化。本插件按官方源码当前的工具注册契约开发,并以 npm 已发布的
@deepseek-ai/dsh-tools@0.0.1-rc.1做独立构建验证。
开发
npm install
npm run check
License
MIT
链接
同类插件
yjh051108/dsh-routing-suite★ 7021
一个仓库三件套:DSH 插件包的运行时注入器(注入、热重载、卸载、开发侧挂区一键转正、路由自愈,外带设置页插件管理:列出、卸载、拖入文件夹内化)、任务感知的思维模式路由 agent 预设(router-standard / router-spec / router-react)、以及分级两级任务协议(commit_star / lock_stage / revise_do / edit_plan / mark_task / redteam_verdict 六个工具,任务状态落盘)。注入器实现直接在库内,安装的是它自己的行为而不是一份依赖清单。
strukto-ai/mirage#dsh★ 3785
把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Slack、Gmail、Notion、Postgres)而非宿主磁盘,支持按挂载点设置读/写/执行模式、按命令选择沙箱(进程内 monty、pyodide、quickjs;远程 docker、e2b、daytona),并可在虚拟终端中安装 CLI(git、gh、slack、linear、ntn、gws,或自行注册的程序树)作为命令头词。
first-fluke/oh-my-agent#dsh★ 1460
在工具执行前后以及尝试结束当前轮次时运行项目 OMA 检查。随插件安装 OMA CLI 依赖,并在首次使用时初始化未配置的项目。需要 Node.js 22+;首次初始化需要网络连接和项目目录写入权限。
MichengAI/dsh-skills-manager★ 561
在设置里管理本地 DSH 技能,并只读查看公共 Agent 技能。
hust-open-atom-club/oh-dsh★ 324
社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。
Fishquito7/dsh-skill-mcp-panel★ 277
在 DSH Web 设置中管理技能与 MCP 服务器:技能卡片热启停、工作区作用域、分组、批量迁移与拖拽导入,以及 stdio/HTTP MCP 增删改查、连接测试、密钥脱敏,并附带统一 dsh-panel 命令行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。