From 1eb9005f100baff9e3e1d52b4f1f2ff5e8dc1994 Mon Sep 17 00:00:00 2001
From: HenryYannis <247510158+HenryYannis@users.noreply.github.com>
Date: Fri, 30 Oct 2026 09:36:54 +0000
Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E4=B8=89=E8=AF=AD=20README=20+=20C?=
 =?UTF-8?q?I?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

问题：README 中英混在一起，仓库改名后链接还是 Remove-OfficePlus；Quick-Remove.bat
写成“全自动清理”，实际会先扫描再询问确认；覆盖范围表漏了 Software\Microsoft\OfficePLUS；
CI 里没有 ruff/pytest，checkout/setup-python 还停在 v4/v5。

我的改动：
- README 拆成 README.md（简体）、README.zh-Hant.md（繁體）、README.en.md（English），结构一致，
  顶部语言切换；对照代码修正上述事实，链接统一为 HenryYannis/remove-officeplus。
- ci.yml 新增 ubuntu 上的 ruff（E9,F）、compileall、pytest；checkout 升到 v7.0.1、
  setup-python 升到 v7.1.0（按 SHA 固定）。release.yml、e2e.yml 未动。
- 新增 tests/test_checks.py，用 pytest 跑 sync_rules --check、real_sample_check、gui_result_check。

测试：本地 ruff check --select E9,F、compileall、pytest 3 passed。
---
 .github/workflows/ci.yml |  31 +++++-
 README.en.md             | 228 +++++++++++++++++++++++++++++++++++++++
 README.md                | 227 +++++++++++++++++++-------------------
 README.zh-Hant.md        | 228 +++++++++++++++++++++++++++++++++++++++
 tests/test_checks.py     |  29 +++++
 5 files changed, 623 insertions(+), 120 deletions(-)
 create mode 100644 README.en.md
 create mode 100644 README.zh-Hant.md
 create mode 100644 tests/test_checks.py

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index f935f6f..5754712 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -10,10 +10,31 @@ permissions:
   contents: read
 
 jobs:
+  python-lint:
+    name: Ruff、编译检查和 pytest
+    runs-on: ubuntu-latest
+    env:
+      PYTHONUTF8: "1"
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
+        with:
+          python-version: "3.12"
+      - name: 安装 ruff 和 pytest
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff==0.17.3 pytest==9.2.0
+      - name: Ruff（语法错误、未定义名称、未使用的导入）
+        run: ruff check --select E9,F --target-version py38 .
+      - name: 所有 Python 文件都能编译
+        run: python -m compileall -q main.py build_exe.py src scripts tests
+      - name: pytest
+        run: python -m pytest -v tests
+
   powershell-lint:
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - name: Run PSScriptAnalyzer
         shell: pwsh
         run: |
@@ -25,9 +46,9 @@ jobs:
       matrix:
         python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
     steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies & package
@@ -57,8 +78,8 @@ jobs:
     env:
       PYTHONUTF8: "1"
     steps:
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
-      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
         with:
           python-version: "3.11"
       - name: 打包
diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..3145fb1
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,228 @@
+# Remove-OfficePlus
+
+[简体中文](README.md) | [繁體中文](README.zh-Hant.md) | **English**
+
+One-click removal of the Microsoft OfficePLUS Office add-in, its background service and leftover files, with an automatic registry backup before anything is deleted.
+
+[![CI](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/remove-officeplus/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows)
+
+---
+
+## What it removes
+
+Many people find "Microsoft OfficePLUS" (also shown as "微软 PPT 助手 / Office 助手") on their PC without remembering installing it. Removing it by hand usually runs into:
+
+1. **It can't be turned off**: you untick it in Word / Excel / PowerPoint options, and after restarting Office it is ticked again.
+2. **It can't be deleted**: File Explorer says the file is in use.
+3. **It comes back**: after deleting some files, the background service downloads or repairs them on the next boot.
+
+This tool cleans the whole chain, in this order: processes ➔ services ➔ registry (HKLM / HKCU / 32-bit / Click-to-Run Office) ➔ scheduled tasks ➔ cache folders.
+
+| Category | Target path / identifier | Action |
+| :--- | :--- | :--- |
+| **Background service** | `OfficePLUS Service`, plus any service whose program path points to `MSOfficePLUSService.exe` | Stopped and removed with `sc delete` |
+| **Processes holding files** | `MSOfficePLUSService`, `OfficePLUS.AgentLauncher`, `DeepLink`, `OfficePLUS` (only when the program lives in an OfficePLUS folder) | Force-terminated |
+| **System registry (64-bit)** | `HKLM:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | Add-in removed |
+| **System registry (32-bit)** | `HKLM:\Software\Wow6432Node\Microsoft\Office\<App>\Addins\MSOfficePLUS` | Add-in removed |
+| **User registry** | `HKCU:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | Add-in removed |
+| **Add-ins matched by pattern** | In all the locations above and in Click-to-Run Office's virtual registry: add-ins whose name, FriendlyName, Description or Manifest contains "OfficePLUS" | Add-in removed |
+| **Program settings** | `Software\Microsoft\OfficePLUS` (HKLM, HKLM 32-bit, HKCU) | Removed |
+| **Uninstall leftovers** | `...\CurrentVersion\Uninstall\MSOfficePLUS` (HKLM, HKLM 32-bit, HKCU) | Control Panel leftover key removed |
+| **Scheduled tasks** | Tasks whose name or path contains "OfficePLUS" | Removed |
+| **Install folders** | `%ProgramFiles%\Microsoft OfficePLUS`, `%ProgramFiles(x86)%\Microsoft OfficePLUS` | Removed |
+| **Cache and settings** | `%ProgramData%\Microsoft OfficePLUS`<br>`OfficePLUS` and `Microsoft OfficePLUS` under `%LOCALAPPDATA%` and `%APPDATA%` | Removed |
+
+`<App>` means Word, Excel, PowerPoint and Outlook. All rules live in [`src/remove_officeplus/rules.json`](src/remove_officeplus/rules.json), shared by the Python and PowerShell versions.
+
+Other features:
+
+- **Pattern matching**: besides the known names, it finds add-ins whose name or description contains "OfficePLUS" and services whose program points to `MSOfficePLUSService.exe`, so renamed copies are caught too. Other add-ins and services are never touched.
+- **Desktop GUI**: a native window that shows scan status and results at a glance.
+- **No dependencies**: a PowerShell script and a standalone exe; nothing to install on Windows 10 / 11.
+- **Automatic elevation**: a UAC prompt appears when admin rights are needed. If you approve with a different admin account, it still cleans the signed-in user's data.
+- **Look before you delete**: scan only (`-Scan` / `--scan`) and dry run (`--dry-run`).
+
+It targets OfficePLUS specifically. If you meet a new variant or a similar add-in, please open an Issue.
+
+---
+
+## Download and quick start
+
+### Option 1: download the exe (recommended)
+
+1. Download the latest `Remove-OfficePlus-GUI-v<version>.exe` (for example `Remove-OfficePlus-GUI-v1.3.0.exe`) from the [Releases page](https://github.com/HenryYannis/remove-officeplus/releases). If GitHub is unreachable, use the [mirror download page](https://files.xbkjz.cn/apps/officeplus/). The app shows its version in the bottom-right corner; the "下载最新版" (download latest) link opens that mirror page.
+2. Double-click it and choose "Yes" in the UAC prompt.
+3. Click "一键清理" (one-click clean). It cleans and then re-scans automatically.
+
+### Option 2: run online in PowerShell (no download)
+
+Press `Win + X`, open "Terminal" or "PowerShell", then paste and run:
+
+```powershell
+irm https://raw.githubusercontent.com/HenryYannis/remove-officeplus/main/scripts/Remove-OfficePlus.ps1 | iex
+```
+
+The script scans and lists what it found first, and only cleans after you confirm. This command always runs the latest version in the repository; to read the script first, open the link above in a browser.
+
+### Option 3: double-click the bat file (offline)
+
+1. Download the source zip of this repository and extract it.
+2. Double-click `Quick-Remove.bat` in the root folder.
+3. Choose "Yes" in the UAC prompt. The script scans first and cleans after you confirm.
+
+### Option 4: Python
+
+Requires Python 3.8 or later:
+
+```bash
+python main.py            # start the GUI (default)
+python main.py --scan     # scan only
+python main.py --dry-run  # dry run: list what cleaning would delete, change nothing
+python main.py --nuke     # clean (lists the items and asks to confirm; add -f to skip)
+python main.py --version  # show the version
+```
+
+### Command-line options
+
+| PowerShell script | Python | What it does |
+| :--- | :--- | :--- |
+| (no arguments) | `--cli` | Scan, then ask whether to clean |
+| `-Scan` | `--scan` | Scan only, change nothing |
+| — | `--dry-run` | Dry run: list every item cleaning would delete, change nothing |
+| `-Nuke` | `--nuke` | Clean. The Python version lists the items and asks to confirm first; both remind you to save if Office is running |
+| `-Force` | `-f` / `--force` / `--yes` | Skip the confirmation and clean |
+| — | `--gui` | Start the GUI |
+| — | `--version` | Show the version |
+
+With no arguments, the Python version starts the GUI.
+
+> The app's interface and output are currently in Simplified Chinese only.
+
+---
+
+## Safety: backup and restore
+
+- **Back up before deleting**: registry keys are exported to a `.reg` backup before they are deleted; a key whose backup fails is not deleted. After cleaning it re-scans and reports anything that could not be removed.
+- **Where backups and logs go**: `Documents\Remove-OfficePlus 备份`. It holds the registry backup (`.reg`), a restore guide (`如何恢复.txt`) and one log per run (`清理日志_<date>_<time>.txt`) recording what was deleted and what failed, with reasons.
+- **How to restore**: double-click the backup `.reg` file to import it. Deleted program files are not restored; reinstall the program if you need it.
+- **Office will be closed**: Word, Excel, PowerPoint and Outlook must be closed to delete files they hold. If they are running you are reminded to save first, so save your open documents.
+- **Admin rights required**: only an administrator can remove system services and machine-wide registry keys, so a UAC prompt appears.
+- **Just want to look**: scan or dry-run mode changes nothing.
+
+### Real-world test
+
+On 2026-10-23 I tested v1.1.0 on a Windows 10 PC: OfficePLUS installed automatically by Office and OfficePLUS installed from the official installer were both detected and fully removed; the re-scan found 0 items.
+
+| Scan before cleaning | Re-scan after cleaning |
+| :---: | :---: |
+| ![14 leftovers found before cleaning](docs/images/scan-before.png) | ![0 found after cleaning](docs/images/scan-after.png) |
+
+The registry is backed up automatically before cleaning and saved with the log in `Documents\Remove-OfficePlus 备份`:
+
+![Backup folder](docs/images/backup-folder.png)
+
+The raw log and registry backup are in [docs/real-test](docs/real-test/).
+
+---
+
+## Build from source
+
+```bash
+pip install -e .                      # install (editable)
+python -m remove_officeplus --scan    # scan only
+python -m remove_officeplus --dry-run # dry run
+python scripts/sync_rules.py          # after editing rules.json, sync it into the PowerShell script
+python scripts/sync_rules.py --check  # check that both versions use the same rules
+pip install pyinstaller
+python build_exe.py                   # build the exe and SHA256SUMS.txt into dist/
+pip install pytest
+python -m pytest tests                # checks that don't touch the system (rule sync, real sample, GUI messages)
+```
+
+End-to-end tests run on Windows VMs in GitHub Actions ([`.github/workflows/e2e.yml`](.github/workflows/e2e.yml)): they plant fake leftovers and sentinels, clean with Python, PowerShell 5.1 and PowerShell 7, and check that the leftovers are gone, the sentinels are intact and the backup restores. Pushing a `v*` tag makes [`release.yml`](.github/workflows/release.yml) build the exe and upload it to the Release together with `SHA256SUMS.txt`.
+
+### Project layout
+
+```
+remove-officeplus/
+├── .github/
+│   ├── ISSUE_TEMPLATE/          # Issue templates
+│   └── workflows/
+│       ├── ci.yml               # Ruff, pytest, PowerShell lint, rule sync and real-sample checks, exe build
+│       ├── e2e.yml              # plant fake leftovers on Windows, clean for real, verify
+│       └── release.yml          # build and publish the exe when a v* tag is pushed
+├── docs/
+│   ├── images/                  # screenshots used in the README
+│   └── real-test/               # real cleaning log and registry backup sample
+├── scripts/
+│   ├── Remove-OfficePlus.ps1    # PowerShell version (no dependencies)
+│   └── sync_rules.py            # sync rules.json into the PowerShell script
+├── src/
+│   └── remove_officeplus/       # Python version (also used by the GUI and exe)
+│       ├── rules.json           # detection rules (single source)
+│       ├── constants.py         # loads the rules
+│       ├── discovery.py         # finds renamed add-ins and services by pattern
+│       ├── scanner.py           # scanning
+│       ├── cleaner.py           # cleaning
+│       ├── backup.py            # registry backup and restore guide
+│       ├── runlog.py            # cleaning log
+│       ├── user_context.py      # decides which user to clean
+│       ├── winutil.py           # small Windows system helpers
+│       ├── cli.py               # command-line entry
+│       └── gui.py               # GUI
+├── tests/
+│   ├── e2e/                     # end-to-end test scripts
+│   ├── gui_result_check.py      # GUI reports cleaning results truthfully
+│   ├── real_sample_check.py     # checks rules against the real sample
+│   └── test_checks.py           # runs the checks above under pytest
+├── build_exe.py                 # builds the exe (with version info and SHA256)
+├── Quick-Remove.bat             # double-click to run
+├── main.py                      # Python entry point
+├── pyproject.toml               # Python package config
+├── AGENTS.md                    # development rules
+├── SECURITY.md                  # security policy
+└── LICENSE                      # MIT License
+```
+
+### Contributing
+
+Issues and pull requests are welcome. If cleaning left something behind, please attach that run's log to the Issue. If you find a new variant, add it to `rules.json`, ideally with a registry export from a real installation as evidence. Development rules are in [AGENTS.md](AGENTS.md).
+
+---
+
+## FAQ
+
+**Why doesn't unticking it in Office work?**
+
+- OfficePLUS runs a resident system service, `OfficePLUS Service` (`MSOfficePLUSService.exe`), which starts at boot as `LocalSystem`.
+- It writes `LoadBehavior = 3` (load when Office starts) under `HKEY_LOCAL_MACHINE` rather than the current user's `HKCU`. Machine-wide add-in settings take priority over your choice in Office options, so it loads again after a restart.
+- It also keeps settings and update files in `ProgramData` and `AppData`.
+
+**Windows says "Windows protected your PC"?**
+
+The exe is not signed with a code-signing certificate, so SmartScreen may block it the first time. Click "More info" → "Run anyway".
+
+**How do I check the exe hasn't been tampered with?**
+
+Each Release includes `SHA256SUMS.txt`. Run `Get-FileHash .\Remove-OfficePlus-GUI-v*.exe` in PowerShell; if the hash matches the file, the download is unchanged.
+
+**Does it affect Office itself?**
+
+No. It only removes OfficePLUS components from your own PC when you run it, and backs up the registry first. If you want OfficePLUS back, reinstall it from the official source at any time.
+
+**Something is still left after cleaning?**
+
+Run a scan again to see what remains. If it still can't be removed, open an Issue and attach the log from `Documents\Remove-OfficePlus 备份`.
+
+---
+
+## License
+
+[MIT](LICENSE) © Henry Yannis
+
+Website: [xbkjz.cn](https://xbkjz.cn)
+
+**Disclaimer**: this is a free, open-source tool developed by an individual. It is not affiliated with, authorized or endorsed by Microsoft or the OfficePLUS product. Microsoft, Office and OfficePLUS are trademarks of their respective owners and are mentioned only to describe what this tool removes. Use at your own risk.
diff --git a/README.md b/README.md
index 1e5bad6..f89cc02 100644
--- a/README.md
+++ b/README.md
@@ -1,117 +1,91 @@
 # Remove-OfficePlus
 
-<p align="center">
-  <b>一键清理「微软 OfficePLUS」Office 加载项、后台服务和残留文件，删除前自动备份。</b><br>
-  <i>Remove the Microsoft OfficePLUS add-in and its background service, with automatic registry backup.</i>
-</p>
+**简体中文** | [繁體中文](README.zh-Hant.md) | [English](README.en.md)
 
-<p align="center">
-  <img src="https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows" alt="Platform">
-  <img src="https://img.shields.io/badge/Language-PowerShell%20%7C%20Python-blue.svg" alt="Language">
-  <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License">
-</p>
+一键清理「微软 OfficePLUS」Office 加载项、后台服务和残留文件，删除前自动备份注册表。
 
----
-
-## 为什么需要这个项目
+[![CI](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/remove-officeplus/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows)
 
-不少用户发现电脑里多了「微软 OfficePLUS」（也叫「微软 PPT 助手 / Office 助手」），却不记得自己装过。
+---
 
-手动卸载时常见这些问题：
-1. **无法关闭**：在 Word / Excel / PowerPoint 选项中取消勾选插件，重启 Office 后依然被强制勾选加载。
-2. **无法删除**：文件管理器删除提示「文件已被占用」，无法正常删除。
-3. **会重新出现**：即使用某些工具删除了部分文件，开机后又被后台服务自动下载或修复恢复。
+## 能清理什么
 
-### 为什么取消勾选没用
-- **系统服务**：常驻运行 `OfficePLUS Service`（`MSOfficePLUSService.exe`），以 `LocalSystem` 最高权限开机自启。
-- **系统级注册表加载**：在 `HKEY_LOCAL_MACHINE`（而非当前用户 `HKCU`）写入 `LoadBehavior = 3`（随 Office 启动自动加载）。系统级的加载项设置优先于用户在 Office 选项里的勾选，所以取消勾选后重启又会被加载。
-- **缓存文件**：在 `ProgramData` 与 `AppData` 存有配置文件与更新种子。
+不少人发现电脑里多了「微软 OfficePLUS」（也叫「微软 PPT 助手 / Office 助手」），却不记得自己装过。手动卸载时常遇到：
 
----
+1. **关不掉**：在 Word / Excel / PowerPoint 选项里取消勾选，重启 Office 后又被勾上。
+2. **删不掉**：文件管理器提示「文件已被占用」。
+3. **会回来**：删掉部分文件后，开机又被后台服务下载或修复回来。
 
-## 核心特性
+本工具按下面的顺序全链路清理：进程 ➔ 服务 ➔ 注册表（HKLM / HKCU / 32 位 / 即点即用版 Office）➔ 计划任务 ➔ 缓存目录。
 
-- **全链路清理**：进程 ➔ 服务 ➔ 注册表（HKLM / HKCU / 32 位 / 即点即用版 Office）➔ 计划任务 ➔ 缓存目录。
-- **按特征识别**：除了已知名称，还会找出名称、描述里带「OfficePLUS」的加载项，以及程序指向 `MSOfficePLUSService.exe` 的服务，改了名也能找到；其他加载项和服务一概不碰。
-- **先备份再删除**：删除前把注册表导出成 `.reg` 备份，备份失败就不删；每次清理都留一份日志，删完自动复检。
-- **桌面图形界面**：提供原生 GUI 窗口，排查状态与清理结果一目了然。
-- **零依赖运行**：PowerShell 脚本和独立 exe，Windows 10 / 11 无需安装任何环境。
-- **自动提权**：需要管理员权限时自动弹出 UAC；用其他管理员账号授权时，清理的仍是当前登录用户的数据。
-- **只看不删**：支持仅扫描（`-Scan` / `--scan`）和预演（`--dry-run`），先看清楚再决定。
+| 类别 | 目标路径 / 标识 | 处理方式 |
+| :--- | :--- | :--- |
+| **后台服务** | `OfficePLUS Service`，以及程序路径指向 `MSOfficePLUSService.exe` 的任何服务 | 停止并用 `sc delete` 注销 |
+| **占用进程** | `MSOfficePLUSService`、`OfficePLUS.AgentLauncher`、`DeepLink`、`OfficePLUS`（只结束程序路径在 OfficePLUS 文件夹里的） | 强制结束 |
+| **系统注册表（64 位）** | `HKLM:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 删除加载项 |
+| **系统注册表（32 位兼容）** | `HKLM:\Software\Wow6432Node\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 删除加载项 |
+| **用户注册表** | `HKCU:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 删除加载项 |
+| **按特征识别的加载项** | 以上各位置及即点即用版 Office 的虚拟注册表中，名称、FriendlyName、Description 或 Manifest 含「OfficePLUS」的加载项 | 删除加载项 |
+| **程序配置** | `Software\Microsoft\OfficePLUS`（HKLM、HKLM 32 位、HKCU） | 删除 |
+| **卸载残留** | `...\CurrentVersion\Uninstall\MSOfficePLUS`（HKLM、HKLM 32 位、HKCU） | 清理控制面板残留键 |
+| **计划任务** | 名称或路径含「OfficePLUS」的计划任务 | 删除 |
+| **安装目录** | `%ProgramFiles%\Microsoft OfficePLUS`、`%ProgramFiles(x86)%\Microsoft OfficePLUS` | 删除 |
+| **缓存与配置** | `%ProgramData%\Microsoft OfficePLUS`<br>`%LOCALAPPDATA%` 和 `%APPDATA%` 下的 `OfficePLUS`、`Microsoft OfficePLUS` | 删除 |
 
-目前专门针对 OfficePLUS。如果你遇到了它的新变种或类似的加载项，欢迎提交 Issue。
+`<App>` 指 Word、Excel、PowerPoint、Outlook。全部规则写在 [`src/remove_officeplus/rules.json`](src/remove_officeplus/rules.json)，Python 版和 PowerShell 版共用。
 
----
+其他特点：
 
-## 运行前须知
+- **按特征识别**：除了已知名称，还会找出名称、描述里带「OfficePLUS」的加载项，以及程序指向 `MSOfficePLUSService.exe` 的服务，改了名也能找到；其他加载项和服务一概不碰。
+- **图形界面**：原生窗口，扫描状态和清理结果一目了然。
+- **零依赖**：PowerShell 脚本和独立 exe，Windows 10 / 11 不用装任何环境。
+- **自动提权**：需要管理员权限时弹出 UAC；用其他管理员账号授权时，清理的仍是当前登录用户的数据。
+- **只看不删**：支持只扫描（`-Scan` / `--scan`）和预演（`--dry-run`）。
 
-- **会关闭 Office**：清理时要结束 Word、Excel、PowerPoint、Outlook 才能删掉被占用的文件。检测到它们在运行时会先提醒你保存，请先保存好正在编辑的文档。
-- **需要管理员权限**：系统服务和全局注册表只有管理员才能删除，运行时会弹出 UAC 提示。
-- **备份和日志的位置**：`文档\Remove-OfficePlus 备份`。里面有注册表备份（`.reg`）、《如何恢复.txt》和每次的 `清理日志_日期_时间.txt`。
-- **如何恢复**：双击备份的 `.reg` 文件导入即可恢复注册表；删除的程序文件不会恢复，需要的话重新安装即可。
-- **只想先看看**：用扫描或预演模式，不会做任何修改（见下方参数表）。
+目前专门针对 OfficePLUS。遇到它的新变种或类似的加载项，欢迎提交 Issue。
 
 ---
 
-## 快速使用方法
+## 下载与快速使用
 
-### 方式 1：下载独立绿色版程序（小白推荐）
+### 方式 1：下载 exe（推荐）
 
-1. 前往 GitHub 的 [Releases 页面](https://github.com/HenryYannis/Remove-OfficePlus/releases) 下载最新版的 `Remove-OfficePlus-GUI-v版本号.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不开 GitHub 的话，可以从[国内下载页](https://files.xbkjz.cn/apps/officeplus/)下载。程序窗口右下角显示当前版本号，点「下载最新版」也会打开这个页面。
-2. 双击运行程序，在弹出的 UAC 提示中点击「是」授权管理员权限。
-3. 点击「一键清理」即可全自动完成清理与复检。
+1. 到 [Releases 页面](https://github.com/HenryYannis/remove-officeplus/releases) 下载最新的 `Remove-OfficePlus-GUI-v版本号.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不开 GitHub 的话，可以从[国内下载页](https://files.xbkjz.cn/apps/officeplus/)下载。程序窗口右下角显示当前版本号，点「下载最新版」会打开国内下载页。
+2. 双击运行，在 UAC 提示中点「是」。
+3. 点「一键清理」，程序会自动清理并复检。
 
-> **Windows 提示「已保护你的电脑」？** exe 没有购买代码签名证书，第一次运行时 SmartScreen 可能拦截。点「更多信息」→「仍要运行」即可。
->
-> **校验文件**：Release 里附有 `SHA256SUMS.txt`。在 PowerShell 里运行 `Get-FileHash .\Remove-OfficePlus-GUI-v*.exe`，结果和文件里的值一致，说明下载的文件没有被改动。
+### 方式 2：PowerShell 在线运行（免下载）
 
----
-
-### 方式 2：PowerShell 一键在线运行（极速免下载）
-
-无需下载任何文件，直接在 Windows 桌面按快捷键 `Win + X` 打开「终端」或「PowerShell」，粘贴并运行以下命令：
+按 `Win + X` 打开「终端」或「PowerShell」，粘贴运行：
 
 ```powershell
-# 运行极速排查与彻底清理
-irm https://raw.githubusercontent.com/HenryYannis/Remove-OfficePlus/main/scripts/Remove-OfficePlus.ps1 | iex
+irm https://raw.githubusercontent.com/HenryYannis/remove-officeplus/main/scripts/Remove-OfficePlus.ps1 | iex
 ```
 
-脚本会先扫描并列出发现的残留，确认后才清理。这条命令始终运行仓库里的最新版本；如果想先看看脚本内容，可以在浏览器里打开上面的链接。
-
----
+脚本会先扫描并列出发现的残留，确认后才清理。这条命令始终运行仓库里的最新版本；想先看脚本内容，可以在浏览器里打开上面的链接。
 
-### 方式 3：本地双击脚本运行（源码离线推荐）
+### 方式 3：双击 bat（离线）
 
 1. 下载本仓库源码压缩包并解压。
-2. 双击运行根目录下的 `Quick-Remove.bat`。
-3. 在弹出的 UAC 管理员提权窗口点击「是」即可全自动清理。
-
----
+2. 双击根目录下的 `Quick-Remove.bat`。
+3. 在 UAC 提示中点「是」，脚本会先扫描，确认后清理。
 
-### 方式 4：Python 命令行与源码运行
+### 方式 4：Python
 
-如果你已安装 Python 3.8+ 环境：
+需要 Python 3.8 及以上：
 
 ```bash
-# 启动图形桌面窗口 (默认)
-python main.py
-
-# 仅命令行扫描诊断
-python main.py --scan
-
-# 预演：列出清理时会删除的项目，不做任何修改
-python main.py --dry-run
-
-# 命令行执行清理（会先列出要删的项目并询问确认，加 -f 跳过确认）
-python main.py --nuke
-
-# 查看版本号
-python main.py --version
+python main.py            # 启动图形界面（默认）
+python main.py --scan     # 只扫描
+python main.py --dry-run  # 预演：列出清理时会删除的项目，不做任何修改
+python main.py --nuke     # 清理（先列出要删的项目并询问确认，加 -f 跳过确认）
+python main.py --version  # 查看版本号
 ```
 
----
-
-## 命令行参数
+### 命令行参数
 
 | PowerShell 脚本 | Python 版 | 作用 |
 | :--- | :--- | :--- |
@@ -119,14 +93,24 @@ python main.py --version
 | `-Scan` | `--scan` | 只扫描，不做任何修改 |
 | — | `--dry-run` | 预演：列出清理时会删除的每一项，不做任何修改 |
 | `-Nuke` | `--nuke` | 执行清理。Python 版会先列出要删的项目并询问确认；Office 在运行时两者都会先提醒保存 |
-| `-Force` | `-f` / `--yes` | 跳过确认，直接清理 |
+| `-Force` | `-f` / `--force` / `--yes` | 跳过确认，直接清理 |
+| — | `--gui` | 启动图形界面 |
 | — | `--version` | 显示版本号 |
 
 Python 版不带参数时启动图形界面。
 
 ---
 
-## 实测效果
+## 安全：备份与恢复
+
+- **先备份再删除**：要删除的注册表项会先导出成 `.reg` 备份，备份失败的项不删。删完自动复检，没删掉的项会如实列出。
+- **备份和日志的位置**：`文档\Remove-OfficePlus 备份`。里面有注册表备份（`.reg`）、《如何恢复.txt》和每次的 `清理日志_日期_时间.txt`（记录这次删了什么、哪里失败及原因）。
+- **如何恢复**：双击备份的 `.reg` 文件导入即可恢复注册表。删除的程序文件不会恢复，需要的话重新安装即可。
+- **会关闭 Office**：清理时要结束 Word、Excel、PowerPoint、Outlook 才能删掉被占用的文件。检测到它们在运行时会先提醒你保存，请先保存好正在编辑的文档。
+- **需要管理员权限**：系统服务和全局注册表只有管理员才能删除，运行时会弹出 UAC 提示。
+- **只想先看看**：用扫描或预演模式，不会做任何修改。
+
+### 实测效果
 
 2026-10-23 我在一台 Windows 10 电脑上实测了 v1.1.0：无论是 Office 自动装上的 OfficePLUS，还是从官网下载安装包装的，都能扫描出来并清理干净，复扫为 0。
 
@@ -142,35 +126,30 @@ Python 版不带参数时启动图形界面。
 
 ---
 
-## 清理覆盖范围
+## 从源码构建
 
-| 模块类别 | 目标路径 / 标识 | 处理方式 |
-| :--- | :--- | :--- |
-| **后台服务** | `OfficePLUS Service`，以及程序路径指向 `MSOfficePLUSService.exe` 的任何服务 | 停止并使用 `sc delete` 彻底注销服务 |
-| **占用进程** | `MSOfficePLUSService`、`OfficePLUS.AgentLauncher`、`DeepLink` 等 | 强制终止 |
-| **系统注册表（64 位）** | `HKLM:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 彻底移除加载项 |
-| **系统注册表（32 位兼容）** | `HKLM:\Software\Wow6432Node\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 彻底移除加载项 |
-| **用户注册表** | `HKCU:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 彻底移除加载项 |
-| **按特征识别的加载项** | 以上各位置及即点即用版 Office 的虚拟注册表中，名称、FriendlyName、Description 或 Manifest 含「OfficePLUS」的加载项 | 彻底移除加载项 |
-| **卸载残留** | `...\Uninstall\MSOfficePLUS` | 清理控制面板残留键 |
-| **计划任务** | 名称或路径含「OfficePLUS」的计划任务 | 删除 |
-| **安装目录** | `%ProgramFiles%\Microsoft OfficePLUS`、`%ProgramFiles(x86)%\Microsoft OfficePLUS` | 彻底删除所有二进制与 DLL 文件 |
-| **系统与应用缓存** | `%ProgramData%\Microsoft OfficePLUS`<br>`%LOCALAPPDATA%` 和 `%APPDATA%` 下的 `OfficePLUS`、`Microsoft OfficePLUS` | 彻底清空数据与配置 |
-
-全部规则写在 [`src/remove_officeplus/rules.json`](src/remove_officeplus/rules.json)，Python 版和 PowerShell 版共用。
-
-每次清理前，要删除的注册表项会先导出到「文档\Remove-OfficePlus 备份」，双击 `.reg` 文件即可恢复（文件夹里有《如何恢复.txt》）。同一个文件夹里还会留下一份 `清理日志_日期_时间.txt`，记录这次删了什么、哪里失败及原因。
+```bash
+pip install -e .                      # 安装（开发模式）
+python -m remove_officeplus --scan    # 只扫描
+python -m remove_officeplus --dry-run # 预演
+python scripts/sync_rules.py          # 改完 rules.json 后同步到 PowerShell 脚本
+python scripts/sync_rules.py --check  # 检查两边规则是否一致
+pip install pyinstaller
+python build_exe.py                   # 打包 exe，并生成 SHA256SUMS.txt，输出在 dist/
+pip install pytest
+python -m pytest tests                # 不碰系统的检查（规则一致性、真机样本、图形界面提示）
+```
 
----
+端到端测试在 GitHub Actions 的 Windows 虚拟机里运行（[`.github/workflows/e2e.yml`](.github/workflows/e2e.yml)）：种下假残留和哨兵，分别用 Python、PowerShell 5.1、PowerShell 7 清理，检查残留删干净、哨兵完好、备份能恢复。推送 `v*` 标签时，[`release.yml`](.github/workflows/release.yml) 会自动打包 exe 并连同 `SHA256SUMS.txt` 上传到 Release。
 
-## 项目结构
+### 项目结构
 
 ```
-Remove-OfficePlus/
+remove-officeplus/
 ├── .github/
 │   ├── ISSUE_TEMPLATE/          # Issue 模板
 │   └── workflows/
-│       ├── ci.yml               # 语法检查、规则一致性和真机样本检查、打包 exe
+│       ├── ci.yml               # Ruff、pytest、PowerShell 检查、规则一致性和真机样本检查、打包 exe
 │       ├── e2e.yml              # 在 Windows 上种下假残留，真实清理并校验
 │       └── release.yml          # 推送 v* 标签时自动打包 exe 并发布
 ├── docs/
@@ -180,7 +159,7 @@ Remove-OfficePlus/
 │   ├── Remove-OfficePlus.ps1    # PowerShell 版（零依赖）
 │   └── sync_rules.py            # 把 rules.json 同步进 PowerShell 脚本
 ├── src/
-│   └── remove_officeplus/       # Python 版（GUI 和 exe 也用这套代码）
+│   └── remove_officeplus/       # Python 版（图形界面和 exe 也用这套代码）
 │       ├── rules.json           # 识别规则（唯一来源）
 │       ├── constants.py         # 读取规则
 │       ├── discovery.py         # 按特征识别改名的加载项和服务
@@ -189,41 +168,59 @@ Remove-OfficePlus/
 │       ├── backup.py            # 注册表备份与恢复说明
 │       ├── runlog.py            # 清理日志
 │       ├── user_context.py      # 确定要清理哪个用户
+│       ├── winutil.py           # Windows 系统调用的小工具
 │       ├── cli.py               # 命令行入口
 │       └── gui.py               # 图形界面
 ├── tests/
 │   ├── e2e/                     # 端到端测试脚本
-│   └── real_sample_check.py     # 用真机样本核对识别规则
+│   ├── gui_result_check.py      # 图形界面如实提示清理结果
+│   ├── real_sample_check.py     # 用真机样本核对识别规则
+│   └── test_checks.py           # 用 pytest 跑上面这些检查
 ├── build_exe.py                 # 打包 exe（含版本信息和 SHA256）
 ├── Quick-Remove.bat             # 双击运行
 ├── main.py                      # Python 启动入口
 ├── pyproject.toml               # Python 包配置
 ├── AGENTS.md                    # 开发规范
+├── SECURITY.md                  # 安全策略
 └── LICENSE                      # MIT 开源协议
 ```
 
----
-
-## 参与贡献
+### 参与贡献
 
 欢迎提交 Issue 和 Pull Request。清理没删干净时，提交 Issue 请附上那次的清理日志。发现了新的变种特征，欢迎补充到 `rules.json`，最好附上真实安装后的注册表导出作为依据；开发规范见 [AGENTS.md](AGENTS.md)。
 
 ---
 
-## 官方网站
+## 常见问题
 
-- 官网：[xbkjz.cn](https://xbkjz.cn)
+**为什么在 Office 里取消勾选没用？**
 
----
+- OfficePLUS 有一个常驻的系统服务 `OfficePLUS Service`（`MSOfficePLUSService.exe`），以 `LocalSystem` 权限开机自启。
+- 它在 `HKEY_LOCAL_MACHINE`（而不是当前用户的 `HKCU`）写入 `LoadBehavior = 3`（随 Office 启动自动加载）。系统级的加载项设置优先于你在 Office 选项里的勾选，所以取消勾选后重启又会被加载。
+- 它还在 `ProgramData` 和 `AppData` 存有配置文件和更新文件。
+
+**Windows 提示「已保护你的电脑」？**
+
+exe 没有购买代码签名证书，第一次运行时 SmartScreen 可能拦截。点「更多信息」→「仍要运行」即可。
 
-## 免责声明
+**怎么确认下载的 exe 没被改过？**
 
-本项目是个人开发的免费开源工具，与微软公司及 OfficePLUS 产品无任何关联，也未获其授权或认可。Microsoft、Office、OfficePLUS 是其各自权利人的商标，本项目提到它们只为说明清理对象。
+Release 里附有 `SHA256SUMS.txt`。在 PowerShell 里运行 `Get-FileHash .\Remove-OfficePlus-GUI-v*.exe`，结果和文件里的值一致，说明文件没有被改动。
 
-本工具只在你主动操作时，删除你自己电脑上的 OfficePLUS 相关组件，不会影响 Office 本身，删除前会备份注册表。如果你需要 OfficePLUS，可以随时从官方渠道重新安装。使用风险由使用者自行承担。
+**会影响 Office 本身吗？**
+
+不会。本工具只在你主动操作时，删除你自己电脑上的 OfficePLUS 相关组件，删除前会备份注册表。如果你需要 OfficePLUS，可以随时从官方渠道重新安装。
+
+**清理后还有残留怎么办？**
+
+再运行一次扫描看看还剩什么。如果仍然删不掉，请提交 Issue 并附上 `文档\Remove-OfficePlus 备份` 里的清理日志。
 
 ---
 
 ## 开源协议
 
-本项目采用 [MIT License](LICENSE) 开源协议。
+[MIT](LICENSE) © 程小宝
+
+官网：[xbkjz.cn](https://xbkjz.cn)
+
+**免责声明**：本项目是个人开发的免费开源工具，与微软公司及 OfficePLUS 产品无任何关联，也未获其授权或认可。Microsoft、Office、OfficePLUS 是其各自权利人的商标，本项目提到它们只为说明清理对象。使用风险由使用者自行承担。
diff --git a/README.zh-Hant.md b/README.zh-Hant.md
new file mode 100644
index 0000000..8a1a168
--- /dev/null
+++ b/README.zh-Hant.md
@@ -0,0 +1,228 @@
+# Remove-OfficePlus
+
+[简体中文](README.md) | **繁體中文** | [English](README.en.md)
+
+一鍵清理「微軟 OfficePLUS」Office 增益集、背景服務和殘留檔案，刪除前自動備份登錄檔。
+
+[![CI](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/remove-officeplus/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows)
+
+---
+
+## 能清理什麼
+
+不少人發現電腦裡多了「微軟 OfficePLUS」（也叫「微軟 PPT 助手 / Office 助手」），卻不記得自己裝過。手動移除時常遇到：
+
+1. **關不掉**：在 Word / Excel / PowerPoint 選項裡取消勾選，重新啟動 Office 後又被勾上。
+2. **刪不掉**：檔案總管提示「檔案正在使用中」。
+3. **會回來**：刪掉部分檔案後，開機又被背景服務下載或修復回來。
+
+本工具依下面的順序完整清理：處理程序 ➔ 服務 ➔ 登錄檔（HKLM / HKCU / 32 位元 / 隨選即用版 Office）➔ 排程工作 ➔ 快取資料夾。
+
+| 類別 | 目標路徑 / 識別 | 處理方式 |
+| :--- | :--- | :--- |
+| **背景服務** | `OfficePLUS Service`，以及程式路徑指向 `MSOfficePLUSService.exe` 的任何服務 | 停止並用 `sc delete` 註銷 |
+| **占用的處理程序** | `MSOfficePLUSService`、`OfficePLUS.AgentLauncher`、`DeepLink`、`OfficePLUS`（只結束程式路徑在 OfficePLUS 資料夾裡的） | 強制結束 |
+| **系統登錄檔（64 位元）** | `HKLM:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 刪除增益集 |
+| **系統登錄檔（32 位元相容）** | `HKLM:\Software\Wow6432Node\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 刪除增益集 |
+| **使用者登錄檔** | `HKCU:\Software\Microsoft\Office\<App>\Addins\MSOfficePLUS` | 刪除增益集 |
+| **依特徵識別的增益集** | 以上各位置及隨選即用版 Office 的虛擬登錄檔中，名稱、FriendlyName、Description 或 Manifest 含「OfficePLUS」的增益集 | 刪除增益集 |
+| **程式設定** | `Software\Microsoft\OfficePLUS`（HKLM、HKLM 32 位元、HKCU） | 刪除 |
+| **解除安裝殘留** | `...\CurrentVersion\Uninstall\MSOfficePLUS`（HKLM、HKLM 32 位元、HKCU） | 清理控制台殘留機碼 |
+| **排程工作** | 名稱或路徑含「OfficePLUS」的排程工作 | 刪除 |
+| **安裝資料夾** | `%ProgramFiles%\Microsoft OfficePLUS`、`%ProgramFiles(x86)%\Microsoft OfficePLUS` | 刪除 |
+| **快取與設定** | `%ProgramData%\Microsoft OfficePLUS`<br>`%LOCALAPPDATA%` 和 `%APPDATA%` 下的 `OfficePLUS`、`Microsoft OfficePLUS` | 刪除 |
+
+`<App>` 指 Word、Excel、PowerPoint、Outlook。所有規則寫在 [`src/remove_officeplus/rules.json`](src/remove_officeplus/rules.json)，Python 版和 PowerShell 版共用。
+
+其他特點：
+
+- **依特徵識別**：除了已知名稱，還會找出名稱、描述裡帶「OfficePLUS」的增益集，以及程式指向 `MSOfficePLUSService.exe` 的服務，改了名也找得到；其他增益集和服務一概不碰。
+- **圖形介面**：原生視窗，掃描狀態和清理結果一目了然。
+- **免安裝環境**：PowerShell 指令碼和獨立 exe，Windows 10 / 11 不用安裝任何環境。
+- **自動提升權限**：需要系統管理員權限時跳出 UAC；用其他系統管理員帳號授權時，清理的仍是目前登入使用者的資料。
+- **只看不刪**：支援只掃描（`-Scan` / `--scan`）和預演（`--dry-run`）。
+
+目前專門針對 OfficePLUS。遇到它的新變種或類似的增益集，歡迎提交 Issue。
+
+---
+
+## 下載與快速使用
+
+### 方式 1：下載 exe（推薦）
+
+1. 到 [Releases 頁面](https://github.com/HenryYannis/remove-officeplus/releases) 下載最新的 `Remove-OfficePlus-GUI-v版本號.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不開 GitHub 的話，可以從[中國大陸下載頁](https://files.xbkjz.cn/apps/officeplus/)下載。程式視窗右下角顯示目前版本號，點「下载最新版」會開啟這個下載頁。
+2. 按兩下執行，在 UAC 提示中點「是」。
+3. 點「一键清理」，程式會自動清理並複檢。
+
+### 方式 2：PowerShell 線上執行（免下載）
+
+按 `Win + X` 開啟「終端機」或「PowerShell」，貼上執行：
+
+```powershell
+irm https://raw.githubusercontent.com/HenryYannis/remove-officeplus/main/scripts/Remove-OfficePlus.ps1 | iex
+```
+
+指令碼會先掃描並列出發現的殘留，確認後才清理。這條指令一律執行儲存庫裡的最新版本；想先看指令碼內容，可以在瀏覽器裡開啟上面的連結。
+
+### 方式 3：按兩下 bat（離線）
+
+1. 下載本儲存庫原始碼壓縮檔並解壓縮。
+2. 按兩下根目錄下的 `Quick-Remove.bat`。
+3. 在 UAC 提示中點「是」，指令碼會先掃描，確認後清理。
+
+### 方式 4：Python
+
+需要 Python 3.8 以上：
+
+```bash
+python main.py            # 啟動圖形介面（預設）
+python main.py --scan     # 只掃描
+python main.py --dry-run  # 預演：列出清理時會刪除的項目，不做任何修改
+python main.py --nuke     # 清理（先列出要刪的項目並詢問確認，加 -f 略過確認）
+python main.py --version  # 查看版本號
+```
+
+### 命令列參數
+
+| PowerShell 指令碼 | Python 版 | 作用 |
+| :--- | :--- | :--- |
+| （不帶參數） | `--cli` | 掃描後詢問是否清理 |
+| `-Scan` | `--scan` | 只掃描，不做任何修改 |
+| — | `--dry-run` | 預演：列出清理時會刪除的每一項，不做任何修改 |
+| `-Nuke` | `--nuke` | 執行清理。Python 版會先列出要刪的項目並詢問確認；Office 在執行時兩者都會先提醒存檔 |
+| `-Force` | `-f` / `--force` / `--yes` | 略過確認，直接清理 |
+| — | `--gui` | 啟動圖形介面 |
+| — | `--version` | 顯示版本號 |
+
+Python 版不帶參數時啟動圖形介面。
+
+> 程式介面和輸出目前只有簡體中文。
+
+---
+
+## 安全：備份與還原
+
+- **先備份再刪除**：要刪除的登錄機碼會先匯出成 `.reg` 備份，備份失敗的項目不刪。刪完自動複檢，沒刪掉的項目會如實列出。
+- **備份和記錄檔的位置**：`文件\Remove-OfficePlus 备份`（資料夾名稱為簡體中文）。裡面有登錄檔備份（`.reg`）、《如何恢复.txt》和每次的 `清理日志_日期_時間.txt`（記錄這次刪了什麼、哪裡失敗及原因）。
+- **如何還原**：按兩下備份的 `.reg` 檔匯入即可還原登錄檔。刪除的程式檔案不會還原，需要的話重新安裝即可。
+- **會關閉 Office**：清理時要結束 Word、Excel、PowerPoint、Outlook 才能刪掉被占用的檔案。偵測到它們在執行時會先提醒你存檔，請先儲存正在編輯的文件。
+- **需要系統管理員權限**：系統服務和全域登錄檔只有系統管理員才能刪除，執行時會跳出 UAC 提示。
+- **只想先看看**：用掃描或預演模式，不會做任何修改。
+
+### 實測結果
+
+2026-10-23 我在一台 Windows 10 電腦上實測了 v1.1.0：無論是 Office 自動裝上的 OfficePLUS，還是從官網下載安裝檔裝的，都能掃描出來並清理乾淨，重新掃描為 0。
+
+| 清理前掃描 | 清理後重新掃描 |
+| :---: | :---: |
+| ![清理前掃描到 14 處殘留](docs/images/scan-before.png) | ![清理後重新掃描為 0](docs/images/scan-after.png) |
+
+清理前會自動備份登錄檔，和清理記錄檔一起放在「文件\Remove-OfficePlus 备份」：
+
+![備份資料夾](docs/images/backup-folder.png)
+
+原始記錄檔和登錄檔備份見 [docs/real-test](docs/real-test/)。
+
+---
+
+## 從原始碼建置
+
+```bash
+pip install -e .                      # 安裝（開發模式）
+python -m remove_officeplus --scan    # 只掃描
+python -m remove_officeplus --dry-run # 預演
+python scripts/sync_rules.py          # 改完 rules.json 後同步到 PowerShell 指令碼
+python scripts/sync_rules.py --check  # 檢查兩邊規則是否一致
+pip install pyinstaller
+python build_exe.py                   # 打包 exe，並產生 SHA256SUMS.txt，輸出在 dist/
+pip install pytest
+python -m pytest tests                # 不碰系統的檢查（規則一致性、實機樣本、圖形介面提示）
+```
+
+端對端測試在 GitHub Actions 的 Windows 虛擬機裡執行（[`.github/workflows/e2e.yml`](.github/workflows/e2e.yml)）：植入假殘留和哨兵，分別用 Python、PowerShell 5.1、PowerShell 7 清理，檢查殘留刪乾淨、哨兵完好、備份能還原。推送 `v*` 標籤時，[`release.yml`](.github/workflows/release.yml) 會自動打包 exe 並連同 `SHA256SUMS.txt` 上傳到 Release。
+
+### 專案結構
+
+```
+remove-officeplus/
+├── .github/
+│   ├── ISSUE_TEMPLATE/          # Issue 範本
+│   └── workflows/
+│       ├── ci.yml               # Ruff、pytest、PowerShell 檢查、規則一致性和實機樣本檢查、打包 exe
+│       ├── e2e.yml              # 在 Windows 上植入假殘留，實際清理並驗證
+│       └── release.yml          # 推送 v* 標籤時自動打包 exe 並發布
+├── docs/
+│   ├── images/                  # README 用的實測截圖
+│   └── real-test/               # 實機清理記錄檔和登錄檔備份樣本
+├── scripts/
+│   ├── Remove-OfficePlus.ps1    # PowerShell 版（免安裝環境）
+│   └── sync_rules.py            # 把 rules.json 同步進 PowerShell 指令碼
+├── src/
+│   └── remove_officeplus/       # Python 版（圖形介面和 exe 也用這套程式碼）
+│       ├── rules.json           # 識別規則（唯一來源）
+│       ├── constants.py         # 讀取規則
+│       ├── discovery.py         # 依特徵識別改名的增益集和服務
+│       ├── scanner.py           # 掃描
+│       ├── cleaner.py           # 清理
+│       ├── backup.py            # 登錄檔備份與還原說明
+│       ├── runlog.py            # 清理記錄檔
+│       ├── user_context.py      # 決定要清理哪個使用者
+│       ├── winutil.py           # Windows 系統呼叫的小工具
+│       ├── cli.py               # 命令列入口
+│       └── gui.py               # 圖形介面
+├── tests/
+│   ├── e2e/                     # 端對端測試指令碼
+│   ├── gui_result_check.py      # 圖形介面如實提示清理結果
+│   ├── real_sample_check.py     # 用實機樣本核對識別規則
+│   └── test_checks.py           # 用 pytest 執行上面這些檢查
+├── build_exe.py                 # 打包 exe（含版本資訊和 SHA256）
+├── Quick-Remove.bat             # 按兩下執行
+├── main.py                      # Python 啟動入口
+├── pyproject.toml               # Python 套件設定
+├── AGENTS.md                    # 開發規範
+├── SECURITY.md                  # 安全性政策
+└── LICENSE                      # MIT 開源授權
+```
+
+### 參與貢獻
+
+歡迎提交 Issue 和 Pull Request。清理沒刪乾淨時，提交 Issue 請附上那次的清理記錄檔。發現了新的變種特徵，歡迎補充到 `rules.json`，最好附上實際安裝後的登錄檔匯出作為依據；開發規範見 [AGENTS.md](AGENTS.md)。
+
+---
+
+## 常見問題
+
+**為什麼在 Office 裡取消勾選沒用？**
+
+- OfficePLUS 有一個常駐的系統服務 `OfficePLUS Service`（`MSOfficePLUSService.exe`），以 `LocalSystem` 權限開機自動啟動。
+- 它在 `HKEY_LOCAL_MACHINE`（而不是目前使用者的 `HKCU`）寫入 `LoadBehavior = 3`（隨 Office 啟動自動載入）。系統層級的增益集設定優先於你在 Office 選項裡的勾選，所以取消勾選後重新啟動又會被載入。
+- 它還在 `ProgramData` 和 `AppData` 存有設定檔和更新檔。
+
+**Windows 提示「Windows 已保護您的電腦」？**
+
+exe 沒有購買程式碼簽章憑證，第一次執行時 SmartScreen 可能攔截。點「其他資訊」→「仍要執行」即可。
+
+**怎麼確認下載的 exe 沒被改過？**
+
+Release 裡附有 `SHA256SUMS.txt`。在 PowerShell 裡執行 `Get-FileHash .\Remove-OfficePlus-GUI-v*.exe`，結果和檔案裡的值一致，表示檔案沒有被改動。
+
+**會影響 Office 本身嗎？**
+
+不會。本工具只在你主動操作時，刪除你自己電腦上的 OfficePLUS 相關元件，刪除前會備份登錄檔。如果你需要 OfficePLUS，可以隨時從官方管道重新安裝。
+
+**清理後還有殘留怎麼辦？**
+
+再執行一次掃描看看還剩什麼。如果仍然刪不掉，請提交 Issue 並附上 `文件\Remove-OfficePlus 备份` 裡的清理記錄檔。
+
+---
+
+## 開源授權
+
+[MIT](LICENSE) © 程小宝
+
+官網：[xbkjz.cn](https://xbkjz.cn)
+
+**免責聲明**：本專案是個人開發的免費開源工具，與微軟公司及 OfficePLUS 產品無任何關聯，也未獲其授權或認可。Microsoft、Office、OfficePLUS 是其各自權利人的商標，本專案提到它們只為說明清理對象。使用風險由使用者自行承擔。
diff --git a/tests/test_checks.py b/tests/test_checks.py
new file mode 100644
index 0000000..9d646ee
--- /dev/null
+++ b/tests/test_checks.py
@@ -0,0 +1,29 @@
+"""用 pytest 跑一遍不碰系统的检查脚本，Linux 和 Windows 上都能跑。
+
+这些脚本本身就能单独运行（CI 里也会单独跑），这里只是把它们收进 pytest，
+方便本地一条命令 `pytest tests` 全部检查。E2E 脚本会改动系统，不在这里跑。
+"""
+import os
+import subprocess
+import sys
+
+import pytest
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+CHECKS = [
+    ["scripts/sync_rules.py", "--check"],
+    ["tests/real_sample_check.py"],
+    ["tests/gui_result_check.py"],
+]
+
+
+@pytest.mark.parametrize("args", CHECKS, ids=lambda a: " ".join(a))
+def test_check_script(args):
+    env = dict(os.environ, PYTHONUTF8="1")
+    res = subprocess.run(
+        [sys.executable] + [os.path.join(ROOT, args[0])] + args[1:],
+        cwd=ROOT, env=env, capture_output=True, text=True, encoding="utf-8",
+        errors="replace", check=False,
+    )
+    assert res.returncode == 0, f"{' '.join(args)} 失败：\n{res.stdout}\n{res.stderr}"

From 3a7cad6e93199ab1013ad97e67d1cdd1af8d3099 Mon Sep 17 00:00:00 2001
From: HenryYannis <247510158+HenryYannis@users.noreply.github.com>
Date: Fri, 30 Oct 2026 10:49:29 +0000
Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=E7=BB=9F=E4=B8=80=E7=89=88?=
 =?UTF-8?q?=E6=9D=83=E7=BD=B2=E5=90=8D=EF=BC=9B=E4=BB=93=E5=BA=93=E9=93=BE?=
 =?UTF-8?q?=E6=8E=A5=E4=B8=8E=E5=BD=93=E5=89=8D=E4=BB=93=E5=BA=93=E5=90=8D?=
 =?UTF-8?q?=E4=B8=80=E8=87=B4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 LICENSE           | 2 +-
 README.en.md      | 8 ++++----
 README.md         | 8 ++++----
 README.zh-Hant.md | 8 ++++----
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/LICENSE b/LICENSE
index 4762c59..30eeafd 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 程小宝 (Cheng Xiaobao - xbkjz.cn)
+Copyright (c) 2026 程小宝 (Henry Yannis)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/README.en.md b/README.en.md
index 3145fb1..0b3a844 100644
--- a/README.en.md
+++ b/README.en.md
@@ -4,8 +4,8 @@
 
 One-click removal of the Microsoft OfficePLUS Office add-in, its background service and leftover files, with an automatic registry backup before anything is deleted.
 
-[![CI](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml)
-[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/remove-officeplus/releases)
+[![CI](https://github.com/HenryYannis/Remove-OfficePlus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/Remove-OfficePlus/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/Remove-OfficePlus/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 ![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows)
 
@@ -53,7 +53,7 @@ It targets OfficePLUS specifically. If you meet a new variant or a similar add-i
 
 ### Option 1: download the exe (recommended)
 
-1. Download the latest `Remove-OfficePlus-GUI-v<version>.exe` (for example `Remove-OfficePlus-GUI-v1.3.0.exe`) from the [Releases page](https://github.com/HenryYannis/remove-officeplus/releases). If GitHub is unreachable, use the [mirror download page](https://files.xbkjz.cn/apps/officeplus/). The app shows its version in the bottom-right corner; the "下载最新版" (download latest) link opens that mirror page.
+1. Download the latest `Remove-OfficePlus-GUI-v<version>.exe` (for example `Remove-OfficePlus-GUI-v1.3.0.exe`) from the [Releases page](https://github.com/HenryYannis/Remove-OfficePlus/releases). If GitHub is unreachable, use the [mirror download page](https://files.xbkjz.cn/apps/officeplus/). The app shows its version in the bottom-right corner; the "下载最新版" (download latest) link opens that mirror page.
 2. Double-click it and choose "Yes" in the UAC prompt.
 3. Click "一键清理" (one-click clean). It cleans and then re-scans automatically.
 
@@ -221,7 +221,7 @@ Run a scan again to see what remains. If it still can't be removed, open an Issu
 
 ## License
 
-[MIT](LICENSE) © Henry Yannis
+[MIT](LICENSE) © 2026 Henry Yannis
 
 Website: [xbkjz.cn](https://xbkjz.cn)
 
diff --git a/README.md b/README.md
index f89cc02..f9516e0 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,8 @@
 
 一键清理「微软 OfficePLUS」Office 加载项、后台服务和残留文件，删除前自动备份注册表。
 
-[![CI](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml)
-[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/remove-officeplus/releases)
+[![CI](https://github.com/HenryYannis/Remove-OfficePlus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/Remove-OfficePlus/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/Remove-OfficePlus/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 ![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows)
 
@@ -53,7 +53,7 @@
 
 ### 方式 1：下载 exe（推荐）
 
-1. 到 [Releases 页面](https://github.com/HenryYannis/remove-officeplus/releases) 下载最新的 `Remove-OfficePlus-GUI-v版本号.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不开 GitHub 的话，可以从[国内下载页](https://files.xbkjz.cn/apps/officeplus/)下载。程序窗口右下角显示当前版本号，点「下载最新版」会打开国内下载页。
+1. 到 [Releases 页面](https://github.com/HenryYannis/Remove-OfficePlus/releases) 下载最新的 `Remove-OfficePlus-GUI-v版本号.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不开 GitHub 的话，可以从[国内下载页](https://files.xbkjz.cn/apps/officeplus/)下载。程序窗口右下角显示当前版本号，点「下载最新版」会打开国内下载页。
 2. 双击运行，在 UAC 提示中点「是」。
 3. 点「一键清理」，程序会自动清理并复检。
 
@@ -219,7 +219,7 @@ Release 里附有 `SHA256SUMS.txt`。在 PowerShell 里运行 `Get-FileHash .\Re
 
 ## 开源协议
 
-[MIT](LICENSE) © 程小宝
+[MIT](LICENSE) © 2026 程小宝
 
 官网：[xbkjz.cn](https://xbkjz.cn)
 
diff --git a/README.zh-Hant.md b/README.zh-Hant.md
index 8a1a168..5386353 100644
--- a/README.zh-Hant.md
+++ b/README.zh-Hant.md
@@ -4,8 +4,8 @@
 
 一鍵清理「微軟 OfficePLUS」Office 增益集、背景服務和殘留檔案，刪除前自動備份登錄檔。
 
-[![CI](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/remove-officeplus/actions/workflows/ci.yml)
-[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/remove-officeplus/releases)
+[![CI](https://github.com/HenryYannis/Remove-OfficePlus/actions/workflows/ci.yml/badge.svg)](https://github.com/HenryYannis/Remove-OfficePlus/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/HenryYannis/remove-officeplus)](https://github.com/HenryYannis/Remove-OfficePlus/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 ![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-0078D6.svg?logo=windows)
 
@@ -53,7 +53,7 @@
 
 ### 方式 1：下載 exe（推薦）
 
-1. 到 [Releases 頁面](https://github.com/HenryYannis/remove-officeplus/releases) 下載最新的 `Remove-OfficePlus-GUI-v版本號.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不開 GitHub 的話，可以從[中國大陸下載頁](https://files.xbkjz.cn/apps/officeplus/)下載。程式視窗右下角顯示目前版本號，點「下载最新版」會開啟這個下載頁。
+1. 到 [Releases 頁面](https://github.com/HenryYannis/Remove-OfficePlus/releases) 下載最新的 `Remove-OfficePlus-GUI-v版本號.exe`（例如 `Remove-OfficePlus-GUI-v1.3.0.exe`）。打不開 GitHub 的話，可以從[中國大陸下載頁](https://files.xbkjz.cn/apps/officeplus/)下載。程式視窗右下角顯示目前版本號，點「下载最新版」會開啟這個下載頁。
 2. 按兩下執行，在 UAC 提示中點「是」。
 3. 點「一键清理」，程式會自動清理並複檢。
 
@@ -221,7 +221,7 @@ Release 裡附有 `SHA256SUMS.txt`。在 PowerShell 裡執行 `Get-FileHash .\Re
 
 ## 開源授權
 
-[MIT](LICENSE) © 程小宝
+[MIT](LICENSE) © 2026 程小宝
 
 官網：[xbkjz.cn](https://xbkjz.cn)