文档
安装
unlose 是一个 Windows 服务 + 桌面应用,一个 MSI 安装包装完(需要 Windows 10/11 x64,管理员权限)。安装后服务随系统自启,保护默认开启。
想找历史版本与 SHA256 校验值?所有版本 →
# 下载官方 MSI(unlose.app 或 GitHub Releases)后,双击安装,或命令行静默安装:
unlose-setup-x64.msi /quiet
# 服务注册为 unloseService,安装后立即启动
# PowerShell 校验 SHA256(与 Release 页公布值比对)
Get-FileHash unlose-setup-x64.msi -Algorithm SHA256 快速开始
无需任何配置。服务在后台运行:AI Agent 启动时自动快照、定时快照默认每天 3 个定点时刻(08:00 / 13:00 / 18:00,可在设置页切换为按 6/12/24/48 小时间隔)。打开主界面即可看到保护状态和全部历史时间点。
# 打开主界面(开始菜单或托盘图标)
# 查看状态
unlose status
# 查看快照列表
unlose list-snapshots CLI 命令
CLI 带严格退出码(0=成功 / 1=业务失败 / 2=用法错误),适合脚本化集成。
# 手动快照
unlose snapshot --label "开工前先保护"
# 还原(还原前会自动补拍兜底快照)
unlose restore-snapshot <id>
# 全部命令
unlose snapshot [--label <text>]
unlose status
unlose list-snapshots
unlose delete-snapshot <id>
unlose restore-snapshot <id> 数据还原
还原有两条路:桌面界面(推荐,可视化)与 CLI(脚本化)。
沉浸式还原:双栏时间轴对比历史快照与当前状态,四色 Diff 标出删除/修改/新增文件,行级 Diff 精确到行。可以勾选单个文件或目录挑捡恢复(勾目录含子树、自动去重),恢复到指定新目录——绝不覆盖当前文件。整卷恢复执行前会二次确认。
AI Agent 集成
unlose 开箱识别 30+ 款主流 AI Agent(Claude Code、Cursor、Copilot、Gemini CLI、Kimi、Qwen、Codex、DeepSeek 等),检测到会话启动即自动快照。
独有能力"全局记忆注入":安装时向你的 ~/AGENTS.md 和已安装 Agent 的全局记忆文件幂等注入防护指令(原文保留、注入块标记包裹),AI 自己会读——"会话前快照、危险操作前快照、用 unlose 恢复"。卸载时全部移除,零残留。
# MCP Server(AI 工具通过 MCP 调用快照)
# 配置示例(settings 页可复制):
{
"mcpServers": { "unlose": { "command": "unlose", "args": ["mcp"] } }
}
# skill 文件随包分发:unlose-snapshot.skill.md 安全与隐私
unlose 是安全工具,安全与隐私是设计基线:
- 零遥测:不收集任何使用数据,无账号、无云端
- 不录屏、不录音、不记录按键,也不读取文件内容供审查——只保留文件系统快照
- 快照存放在 VSS 卷影存储中,不是普通文件——文件级删除(包括 AI Agent 和勒索软件)够不到它们
- 命名管道 IPC 有 ACL 限制;还原请求有路径穿越防护
- 日志仅本地保存于 %ProgramData%\unlose\logs
发现漏洞请通过 GitHub Private Advisory 或 security@unlose.dev 报告(48 小时内确认接收,7 天内初步评估,30 天内修复或缓解)。
从源码构建
需要 .NET 8 SDK,Windows 10/11 x64。完整测试套件本地可跑。
git clone https://github.com/unlose-app/unlose.git
cd unlose
dotnet build src/Unlose.sln -c Release
dotnet test src/Unlose.Tests # 134 个单元测试我们如何计数
unlose 软件本身零遥测:不收集任何使用数据、无账号、从不联网"打卡"。官网使用隐私友好的 Umami 统计(无 Cookie、不收集个人信息)来改进内容。我们的口径完全公开:
- 软件:零遥测,无任何数据上报;更新检查每天一次,仅向官网 GET 一个静态版本号文件,不携带任何用户或机器信息
- 官网:使用 Umami(无 Cookie、不收集个人信息、可自托管)统计页面访问与下载点击,仅用于改进官网内容
- 下载量:以 GitHub Releases 的公开下载计数为准(GitHub API)
- 所有指标每月在透明运营报告中公开——即使收入为 0,报告照发
简言之:你的文件和操作属于你;官网统计止于匿名访问。
安全策略
完整安全策略见仓库 SECURITY.md:漏洞报告走 GitHub Private Advisory 或 security@unlose.dev;响应 SLA:48 小时确认接收 / 7 天初步评估 / 30 天修复或缓解。