文档

安装

unlose 是一个 Windows 服务 + 桌面应用,一个 MSI 安装包装完(需要 Windows 10/11 x64,管理员权限)。安装后服务随系统自启,保护默认开启。

官方安装包只有本站与官方 GitHub 仓库提供。当前版本为未签名版本,代码完全开源(Apache-2.0)可自行审计与编译;签名版本将在后续 Release 中提供。请通过 SHA256 校验值核对下载完整性(见各 Release 页)。
首次运行若显示"Windows 已保护你的电脑":点击"更多信息" → "仍要运行"。这是 SmartScreen 对未签名软件的默认提示(只出现一次),并非病毒警告——校验 SHA256 与官方一致即可放心安装。

想找历史版本与 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 精确到行。可以勾选单个文件或目录挑捡恢复(勾目录含子树、自动去重),恢复到指定新目录——绝不覆盖当前文件。整卷恢复执行前会二次确认。

每次还原前 unlose 会自动补拍一张快照——即使还原失败,也不会损失当前状态。

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 个单元测试
代码 Apache-2.0;unlose 名称与 Logo 为商标,fork 请换名(见 TRADEMARK.md)。

我们如何计数

unlose 软件本身零遥测:不收集任何使用数据、无账号、从不联网"打卡"。官网使用隐私友好的 Umami 统计(无 Cookie、不收集个人信息)来改进内容。我们的口径完全公开:

  • 软件:零遥测,无任何数据上报;更新检查每天一次,仅向官网 GET 一个静态版本号文件,不携带任何用户或机器信息
  • 官网:使用 Umami(无 Cookie、不收集个人信息、可自托管)统计页面访问与下载点击,仅用于改进官网内容
  • 下载量:以 GitHub Releases 的公开下载计数为准(GitHub API)
  • 所有指标每月在透明运营报告中公开——即使收入为 0,报告照发

简言之:你的文件和操作属于你;官网统计止于匿名访问。

安全策略

完整安全策略见仓库 SECURITY.md:漏洞报告走 GitHub Private Advisory 或 security@unlose.dev;响应 SLA:48 小时确认接收 / 7 天初步评估 / 30 天修复或缓解。

范围说明:unlose 是事后兜底安全网,不拦截命令。破坏性命令永远不会被阻止——那是拦截器的职责。