dsh-workspace-snapshot-fork
将 DeepSeek Harness 会话及其历史工作区状态一起分叉
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Yu-Zhuang1/dsh-workspace-snapshot-fork#6b48e5df46df0c2e0e286e39725adbbb22fe2828Workspace Snapshot Fork 以 dsh-workspace-snapshot-fork 发布，当前版本为 0.1.0-alpha.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →dsh-workspace-snapshot-fork is a third-party plugin that extends DeepSeek Harness's built-in session forking. In addition to copying the session history through the selected completed turn, it creates an independent workspace for the new session and restores the files recorded at that fork point. The source session's workspace remains unchanged.
Alpha release: Windows support has been tested with the DSH Web profile. Linux and macOS are not yet verified.
Each completed turn receives an immutable Git-backed workspace checkpoint. When the user forks that turn in the DSH Web UI, the plugin copies the session-log prefix and materializes the matching files in a new workspace.
| Source workspace | Fork behavior |
|---|---|
| Plain directory | Materializes the checkpoint from a private snapshot repository. |
| Git repository root with a commit | Creates a new worktree and dsh/workspace-fork/<id> branch in the source repository, then restores the checkpoint files. History, remotes, hooks, and repository configuration remain available. |
| Directory nested inside a Git repository | Uses the private snapshot behavior. |
| Git repository without an initial commit | Uses the private snapshot behavior. |
Historical uncommitted changes appear as ordinary changes in a Git child worktree. The parent directory is never changed.
^22.19.0 or >=24.0.0PATH| Platform | Status |
|---|---|
| Windows | Supported and tested |
| Ubuntu/Linux | Not yet verified |
| macOS | Not yet verified |
This release supports the DSH 0.1.1-rc.x line. DeepSeek Harness is in developer preview, so upgrade compatibility is not assumed.
Install this release into the web profile:
dsh plugin --profile web add "github:Yu-Zhuang1/dsh-workspace-snapshot-fork#v0.1.0-alpha.1"
For a DSH source checkout, prefix the same command with pnpm:
pnpm dsh plugin --profile web add "github:Yu-Zhuang1/dsh-workspace-snapshot-fork#v0.1.0-alpha.1"
Restart DSH after installing or updating the package. This bundle targets the Web profile only; the shipped headless profile has no session-fork RPC or workspace registry.
The default bundle configuration is:
mode: workspace
storageRoot: <DSH_HOME>/workspace-snapshot-fork/snapshots
childRoot: <DSH_HOME>/workspace-snapshot-fork/workspaces
exclude: [.git, node_modules, .env, .env.*, .DS_Store]
DSH_HOME defaults to ~/.dsh. To override the configuration for the Web profile, edit $DSH_HOME/profiles/web/cordis.patch.yml and add the complete entry below:
- id: workspace-snapshot-fork
config:
mode: workspace
storageRoot: !!js dshHomePath('workspace-snapshot-fork/snapshots')
childRoot: !!js dshHomePath('workspace-snapshot-fork/workspaces')
exclude: [.git, node_modules, .env, .env.*, .DS_Store]
DSH replaces the complete config value rather than merging individual fields, so retain every field when overriding it.
Set mode: native in the complete profile entry to delegate new forks to DSH unchanged. Native mode records no new workspace checkpoints, but archive cleanup still releases existing checkpoints. DSH watches the profile patch and applies a valid mode change while the Web process is running.
After switching back to workspace, only subsequently completed turns receive checkpoints. Native-mode turns are not captured retroactively.
The plugin uses its own snapshot index and deliberately does not treat the source repository's .gitignore as a security policy. A file ignored by source Git is captured unless it matches this plugin's exclude list.
exclude..env or .env.* from the list may store credentials in local snapshots.Read SECURITY.md before using this plugin on sensitive workspaces.
Archiving a session removes its checkpoint map. A snapshot ref is removed only after no unarchived session map references it. Forked child sessions inherit the selected parent prefix's checkpoint maps, so they can continue forking inherited turns after the parent is archived.
Successful child workspaces, Git worktrees, and dsh/workspace-fork/* branches are not deleted automatically. Review their uncommitted files, then clean up a Git child with:
git -C <source-repository> worktree remove <child-workspace>
git -C <source-repository> branch --delete dsh/workspace-fork/<id>
Use --force only when you intentionally want to discard uncommitted child files. Plain child directories are also user-owned after a successful fork.
dsh plugin --profile web remove dsh-workspace-snapshot-fork
For a DSH source checkout, prefix the command with pnpm. Uninstalling stops future checkpoints and workspace-aware forks; it does not delete existing snapshots or child workspaces. Remove any plugin override from $DSH_HOME/profiles/web/cordis.patch.yml after uninstalling.
mode: workspace is active.The package has no runtime npm dependencies. Tests invoke local Git and create only temporary directories.
npm run check
npm test
npm pack --dry-run