dsh-file-history 0.2.3 → 0.3.0

package/README.md

@@ -45,7 +45,7 @@ dsh plugin --profile web remove dsh-file-history
 | 只还原文件 | 写回该轮开始前的内容 | 不动 |
 | 只还原对话 | 不动 | 从该轮之前分叉出新会话，原会话保留 |
 | 全部还原 | 写回该轮开始前的内容 | 分叉出新会话并切过去 |
-
+手动改的文件不计入历史，还原时会被快照覆盖。所以真要盖之前会先看一眼：记录之后磁盘上被外面改过的文件有几个，先问一句「仍要覆盖？」——答了才动，取消就一个字节都不写。开分支同样会把磁盘拉到那一版，一样先问。
 手动改的文件不计入历史，还原时会被快照覆盖。
 
 「从这里开分支」把文件摆回那一轮结束时的样子，再看一个新会话接上去，原会话和它之后的轮次一条都不删。时间线上属于父分支的轮次是只读的，四颗按钮都灰着——要动那条线，先用改动条上方那张卡跳过去。
@@ -58,7 +58,19 @@ dsh plugin --profile web remove dsh-file-history
 
 检查点有三种来路：会话开头自动记一个、从某轮分叉时记一个、手动标的。它们进同一条时间线，地位一样，都能还原。分支会话的时间线从它自己往上接——父分支在分叉那一刻之前的轮次与检查点都在，父分支后来另走的路和兄弟分支不在。自动裁剪按分支各算各的：一条线保留自己的最近 `keepRecentTurns` 轮，并在它这一族够 `pruneAfterCheckpoints` 个检查点时以倒数第 N 个为切点。
 
-侧栏时间线底部有两个清理入口：「清除轮次快照」只抹掉逐轮的记录，根节点与分支节点留下，时间线骨架不变；「清除所有分支历史」连检查点一起清，回到刚装插件的样子。两者都作用于当前这条会话线的所有分支，并行的其他会话线不受影响。
+裁剪只在标检查点那一刻发生，所以也在那一刻说：点完「设为检查点」，如果顺手清掉了更早的轮次，提示里会多一句「已清理更早的 N 轮」——轮次不会无声消失。
+
+侧栏时间线底部是这一条会话自己的设置，跟着会话走，不跟着工作区走：第一次拍快照时从插件配置拷一份，之后各管各的；从这条线分出来的会话会带上父会话那一份。五行从常用往下排：
+
+- 「对此会话启用文件历史」默认开着。关掉就是这条会话整件事都停了：不扫盘、不拍快照、不算差异、也设不了新检查点，输入框上方那条不再出现；已经记下来的轮次和检查点照旧在列表里，能看也能还原。从这条线开出来的分支会带上父会话那份设置，包括这个开关。
+- 「每轮自动拍快照」也默认开着。关掉之后只在点「设为检查点」时记录，代价是没有逐轮的卡片和时间线行，只能还原到检查点。
+- 「保留最近轮次」是这一支留多少轮，0 表示不裁。只有族根那条线能改，子会话不显示这一行——留几轮是整支一起算的。
+- 「排除规则」一行一条路径，改完点保存才生效，只影响这一条会话。被排除的路径从下一次拍快照起就不再记录，之前记过的也不会再出现在改动和还原里——记录与比较用的是同一份范围，规则说不管它就真的不管它。
+- 「允许规则」同样一行一条。空着就是全记（现在的行为）；填了就只记这里列出的路径，排除规则仍然在里面继续生效。给「只想盯住几个文件」的会话用。
+
+这几行下面还有一行只读的「占用空间」：这个工作区记下的快照与账本一共占多少，一个快照都没有时不显示。
+
+最下面两个清理入口：「清除轮次快照」只抹掉逐轮的记录，根节点与分支节点留下，时间线骨架不变；「清除所有分支历史」连检查点一起清，回到刚装插件的样子。两者都作用于当前这条会话线的所有分支，并行的其他会话线不受影响。
 
 ## 配置