PerryLink/dsh-checkpoint-rewind17

dsh-checkpoint-rewind

提供会话、工作区与配置的统一快照回滚

AI 分析

适合需要对工作状态进行自动备份、差异对比和一键回滚的开发人员。

包名
dsh-checkpoint-rewind
版本
0.6.11
许可证
Apache-2.0
最近更新
2026年9月12日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:PerryLink/dsh-checkpoint-rewind

Configuration

All tunables are Schemastery Config fields (changeable from cordis.yml). Nothing is hardcoded. Provider options (gitBin, snapshotDir, excludeGlobs, verifyByHash) are read from the live config at use time, so cordis.yml changes apply without a restart.

KeyDefaultMeaning
enabledtrueMaster switch; false removes the commands, listeners, and providers entirely
providerautoSnapshot provider: auto (git if available, else copy) · git · copy
gitBingitGit executable path
snapshotDir$DSH_HOME/dsh-checkpoint-rewind (fallback ~/.dsh/dsh-checkpoint-rewind when $DSH_HOME is unset)Root for copy-provider snapshots
maxSnapshots50Checkpoints kept per session (oldest pruned first)
maxSnapshotBytes536870912 (512 MiB)Global incremental-byte soft quota (newest per live session always retained)
pruneOnTurnEndtrueRun quota pruning when a turn ends
mutationTools['bash','write','edit','str_replace_editor','pwsh','terminal_send']Tools treated as mutating at tools/pre-execute
excludeGlobs['node_modules','.git','.dsh','dist','build']Glob patterns skipped by the copy provider
confirmViaautoConfirmation channel: auto (userQuestions first) · userQuestions · approval
listLimit10Checkpoints shown by bare /rewind
preRewindCheckpointwarnGuard checkpoint before restore: warn · require · off
verifyByHashfalseCopy-provider content-hash comparison and restore verification
autoCheckpoint.enabledtrueAutomatic interval snapshots on step/start
autoCheckpoint.intervalMinutes0Interval; 0 = every step
workspaceRestorerestoreWorkspace rollback: restore (safe overwrite) · reset-hard (CC-style, opt-in)
diffRendererpairwiseSettings-page diff renderer: pairwise (line-level text) · side-by-side (per-file two-column)
selectiveRestoretruePer-file selective restore (/rewind … --files) and the panel's per-file checkbox + size total
promptSectiontrueInject a short role-statement prompt section
checkpointTooltrueRegister the checkpoint model tool
- insert:
    - id: checkpoint-rewind
      name: dsh-checkpoint-rewind
      config:
        provider: auto
        maxSnapshots: 50
        maxSnapshotBytes: 536870912
        pruneOnTurnEnd: true
        confirmVia: auto
        preRewindCheckpoint: warn