PrivacyGuard standard offline v0.1.4

v0.1.4 安装验收记录

验收日期：2026-10-11。正式下载：https://github.com/bseazh/PrivacyGuard/releases/tag/offline-standard-v0.1.4

发行文件

macOS 下载 runtime、HaS、PaddleOCR 与 SHA256SUMS，共 4 个文件。

Windows 下载 runtime、HaS、PaddleOCR 与 SHA256SUMS，并额外下载 Install-PrivacyGuard-v0.1.4-r2.cmd、INSTALLER-R2-SHA256SUMS，共 6 个文件。核对两份清单后将 r2 cmd 放入 app，双击安装；不要使用原 runtime 的旧安装入口或早期补充入口。安装后使用原 Launch、Check、Stop 入口。

四个压缩包的 GitHub 资产 SHA-256 与本地 SHA256SUMS 一致。原包及原清单未覆盖；Windows 补充入口使用独立名称和校验清单。

macOS：通过

环境：macOS 14.8.1、Apple Silicon arm64、16 GB 内存，已有 Python 3.11。

在独立目录 /private/tmp/privacyguard-mac-v014.UEv7dW/app 解压最终 runtime，执行真实 Install-PrivacyGuard.command，强制预检及离线依赖安装完成。安装器报告约 1 分钟（本机已有 Python；不是新机器安装耗时承诺）。

启动器及 Test-PrivacyGuard.command 验收结果：后端 online、HaS online、OCR online 且 ready=true，应用地址 http://127.0.0.1:8000。日志在 app/logs，检测报告 last-check.json。

执行 Stop-PrivacyGuard.command 后，复查 launchctl 无 PrivacyGuard 服务记录，8000/8080/8082 无监听。本次最终包没有在缺少 Python 的全新 Mac 上走图形安装器，也未验证 Finder 下载隔离提示。

只支持 macOS 14+ Apple Silicon；Intel Mac 不适配。

Windows：通过

环境：GitHub 托管 Windows Server 2025 x64；不是所有 Windows 10/11 用户机器的兼容性保证。

完整运行：https://github.com/bseazh/PrivacyGuard/actions/runs/38122127746

总耗时：3 分 10 秒。以下步骤均通过：预检、Release 下载、SHA-256、真实 r2 cmd 离线安装、模型解压、端口冲突切换、后端/HaS/OCR 就绪、停止、PID 身份不一致保留 stale 记录、失败启动清理真实进程及监听端口、日志上传。

后续回归 38122461484 中，端口占用测试进程在固定等待 2 秒后尚未监听，与应用争抢 8000，导致后端绑定失败。测试改为等待端口监听并确认归属占用进程，再启动应用。修正后的最终回归全部通过，用时 3 分 15 秒：https://github.com/bseazh/PrivacyGuard/actions/runs/38122856318 。

发现并处理的问题：目录参数末尾反斜杠；PowerShell 7 模块路径污染 Windows PowerShell 5.1；无 BOM 中文脚本被 PowerShell 5.1 错误解析。r2 入口规范化目录、隔离模块路径并统一解压后 ps1 为 UTF-8 BOM。测试中未跳过完整性检查。

国内镜像：待部署

https://privacyguard.snorlaxden.fun/offline-standard-v0.1.4/ 当前检查返回 HTTP 404。SSH 默认 22 端口以本机现有密钥连接 ubuntu@134.175.154.244 返回 Permission denied (publickey,password)。没有上传或修改服务器。

待上传目标为 /home/ubuntu/Project/Documents/PrivacyGuard/offline-standard-v0.1.4/，实际 Web 映射应在取得有效 SSH 认证后确认。部署页面已准备在 deploy/download-site/offline-standard-v0.1.4/，需与发行文件一起上传并校验。

使用边界

此验收覆盖安装及服务生命周期，不替代一次虚构文档的识别、脱敏和导出验收。下载时间按实测速度动态估计，磁盘、内存与管理员授权仍需每台电脑预检。

PrivacyGuard standard offline v0.1.3

Windows launcher CRLF compatibility fix; immutable offline package with verified SHA-256.

PrivacyGuard standard offline v0.1.2

Changelog

v0.1.2

• 构建器拒绝覆盖已有版本目录、Git tag 或 GitHub Release；
• Windows 停止失败或身份不一致时保留并标记 stale 进程记录，避免残留服务失去追踪；
• Windows 故障启动测试同时核对进程记录、真实进程、命令行和监听端口；
• macOS 双击安装在缺少 Python 3.11 时自动打开包内官方安装器，并在完成后继续；
• macOS 预检按实际安装目标卷计算可用磁盘空间；
• macOS 服务日志改为持久保存在应用 logs 目录，Windows 安装日志保证正常关闭。

v0.1.1

• Release 资产改为不可变版本，不再覆盖 v0.1.0 文件；
• Windows 与 macOS 双击安装入口强制执行系统、架构、内存、磁盘、依赖、包完整性、SHA-256 和目录写入检查；
• Windows 停止器在结束进程前核对 PID、可执行文件路径、命令行标记和启动时间，避免 PID 复用导致误杀；
• Windows 与 macOS 启动失败时自动清理本次启动的 PrivacyGuard 服务，同时保留诊断日志；
• 安装日志写入 logs/install.log，服务检测结果写入 logs/last-check.json；
• FAQ 增加预检失败、版本混用、PID 身份不一致、启动失败清理和日志排查说明。

v0.1.0

• 首个 standard 离线发行；
• 提供 macOS Apple Silicon 与 Windows x64 CPU 兼容运行包；
• 包含 HaS、PaddleOCR、Python 3.11 安装器和离线 wheels；
• 提供双击启动、服务健康检查和端口冲突自动切换。

PrivacyGuard Standard Offline v0.1.1

v0.1.1

本版本使用不可变 Release 资产，不再覆盖 v0.1.0。

• 双击安装会强制检查系统、架构、内存、磁盘、Windows VC++ Runtime、离线包完整性、SHA-256 与目录写权限。
• Windows 停止器同时核对 PID、可执行文件路径、命令行和启动时间，防止 PID 复用误杀。
• Windows 与 macOS 启动失败时自动清理本次启动的服务并保留日志。
• 补充安装与故障排查 FAQ。

请只混用同一 v0.1.1 Release 中的 runtime、两个模型包和 SHA256SUMS。

PrivacyGuard Standard Offline Packages v0.1.0

PrivacyGuard Standard v0.1.0 离线安装包。

新手入口：

• 国内平台选择：https://privacyguard.snorlaxden.fun/offline-standard-v0.1.0/
• Agent 安装任务书：https://privacyguard.snorlaxden.fun/offline-standard-v0.1.0/agent-install.md
• GitHub 安装任务书：https://github.com/bseazh/PrivacyGuard/blob/datainfra-runtime/docs/installation/copy-paste-agent-prompt.md
• 验收测试方案：https://github.com/bseazh/PrivacyGuard/blob/datainfra-runtime/docs/installation/acceptance-test.md

零基础用户入口：

• Windows：Install-PrivacyGuard.cmd、Launch-PrivacyGuard.cmd、Check-PrivacyGuard.cmd、Stop-PrivacyGuard.cmd
• macOS：对应的 .command 安装、启动、检测、停止入口
• 默认端口被占用时安全切换到 18000/28000/38000 系列，不结束未知进程
• 实际地址写入 .run，检测结果写入 logs/last-check.json

依赖说明：
前端、Python 3.11 安装器、Python wheels、llama.cpp、HaS 和 PaddleOCR 已包含。Windows 约 164 个 wheels，macOS 约 166 个。standard 不要求 Node.js、Git、Homebrew、WSL、Docker、CUDA 或 NVIDIA GPU。

验证状态：

• macOS 14.8.1 Apple Silicon M2：离线安装、服务启动、8000 端口冲突切换、后端、HaS、OCR 检测通过。
• Windows Server 2025 x64：下载、SHA-256、完全离线安装、8000 端口冲突切换、后端、HaS、OCR、停止与日志收集通过。
• Windows 测试：https://github.com/bseazh/PrivacyGuard/actions/runs/38044040155