restore
从备份恢复某个 target。
skillshare restore # 交互式 TUI（浏览 + 恢复）
skillshare restore claude # 最新备份
skillshare restore claude --from 2026-01-19_10-00-00 # 指定备份
skillshare restore claude --dry-run # 预览
何时使用
- 一次同步出了问题，需要将某个 target 恢复到之前的状态
- 你不小心从某个 target 中移除了 skills
- 交互式浏览备份版本，并与当前状态进行对比
交互式 TUI
在 TTY 上，不带参数运行 skillshare restore 会先询问要从备份还是从回收站恢复。选择备份时，先选 target 再浏览它的备份版本：每个版本会显示日期、大小，以及与当前 target 相比会新增或移除哪些项目，也可以在这里删除旧版本。选择回收站则会打开 trash TUI。按键列在界面底部。
使用 --no-tui 跳过 TUI，改为显示纯文本的备份列表。
会发生什么
选项
| 标志 | 描述 |
|---|---|
--all | 同时恢复 skills 和 agents |
--project, -p | 使用 project mode（.skillshare/backups/）；仅限 agents |
--global, -g | 使用 global mode（skills 的默认值） |
--from, -f <timestamp> | 从指定备份恢复 |
--force | 覆盖而不确认 |
--dry-run, -n | 预览而不做任何更改 |
--no-tui | 跳过交互式 TUI，改为显示备份列表 |
restore 也接受一个位置 kind 参数：skillshare restore agents claude 会恢复 claude target 的 agent 备份。
查找备份
列出可用的备份：
skillshare backup --list
Backups ~/.local/share/skillshare/backups
2026-01-20_15-30-00 claude, cursor · 4.2 MB
2026-01-19_10-00-00 claude · 2.1 MB
2026-01-18_09-00-00 claude, cursor · 4.0 MB
3 backups, 10.3 MB
Next
skillshare restore <target> --from <timestamp> roll a target back
示例
# 从最新备份恢复
skillshare restore claude
# 从指定备份恢复
skillshare restore claude --from 2026-01-19_10-00-00
# 预览恢复
skillshare restore claude --dry-run
# 强制恢复（跳过确认）
skillshare restore claude --force
恢复之后
restore 会用快照内容替换 target 目录。由于备份只捕获本地内容——被 symlink 的 skills 会被排除，参见 What Gets Backed Up——之后应运行 sync 把被同步的 skills 找回来：
skillshare restore claude # 从备份恢复本地内容
skillshare sync # 为被同步的 skills 重新创建 symlink
恢复出的内容是普通文件，而不是 symlink。如果该 target 一直只持有本地 skills，那么仅恢复就已足够。
使用场景
意外删除
如果你不小心删除了某个 skill：
skillshare restore claude --from 2026-01-19_10-00-00
撤销更改
如果一次同步出了问题：
skillshare restore claude # 回到同步前的状态
测试
恢复以测试旧版本的 skill：
skillshare restore claude --from 2026-01-15_10-00-00
# 测试旧的 skills……
skillshare sync # 返回当前状态
Agent 恢复
Agent 恢复与 skill 恢复类似，但作用于由 backup agents（以及在 sync agents 之前运行的自动备份）创建的并行 <target>-agents 备份条目：
skillshare restore agents claude # claude 的最新 agent 备份
skillshare restore agents claude --from 2026-01-19_10-00-00
skillshare restore agents -p # Project agents（唯一允许的 project mode）
skillshare restore --all claude # 一次性恢复 skills + agents
在 project mode 下，restore——与 backup 一样——只对 agents 起作用。不带 agents 参数时会报错：
restore is not supported in project mode (except for agents)
通过 skillshare backup --list 列出备份时，agent 备份会以带 -agents 后缀的独立条目显示（例如 claude-agents）。