Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

test(runtime): 完整验证更新暂停与任务续跑

longmeidaoe9e229928c33
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 510910612..59598f742 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -124,7 +124,7 @@ jobs:
- name: 验证在途任务保护与覆盖安装后的恢复
shell: pwsh
run: |
- python smoke_update_tasks.py candidate/Peach/Peach.exe --installer './Peach-${{ needs.windows.outputs.version }}-windows-x64-setup.exe'
+ python smoke_update_tasks.py candidate/Peach/Peach.exe --installer './Peach-${{ needs.windows.outputs.version }}-windows-x64-setup.exe' --apply
if ($LASTEXITCODE -ne 0) { throw '任务保护与恢复验收失败' }
- name: 保留制品验收失败日志
if: failure()
diff --git a/README.md b/README.md
index 40bbc3874..ee39d8b1f 100644
--- a/README.md
+++ b/README.md
@@ -109,7 +109,7 @@ https://github.com/user-attachments/assets/a5610874-e611-41bb-be22-7d99f0d64b62
Windows 独立包可在配置页「应用与维护」检查并下载更新;下载完成后确认重启安装。自动检查与下载默认关闭,可在同一处开启。
-下载更新不会停止任务。应用内重启安装和安装包覆盖安装会保存采集进度、暂停刮削与抽帧,安装完成后自动继续;安装期间发起的采集任务会等待安装完成。取消安装或服务意外退出后,未完成的馆藏资料、本地预览、时间轴缩略图和封面任务也会自动恢复,复用已完成结果;主动关闭缩略图采集则不恢复。
+下载更新不会停止任务。应用内重启安装和安装包覆盖安装会保存采集进度、暂停刮削与抽帧;安装期间发起的采集任务会等待安装完成。安装完成或取消后,仍在运行的 Peach 会自动续跑;如果 Peach 已退出,则在下次启动时恢复未完成的馆藏资料、本地预览、时间轴缩略图和封面任务,复用已完成结果。主动关闭缩略图采集则不恢复。
测试包还没有代码签名。Windows 提示「已保护你的电脑」时,确认文件来自本项目的 Release,再点「更多信息 → 仍要运行」。转码和缩略图要用到 FFmpeg,没装也能浏览和播放 MP4、WebM,安装方法见 [Windows 测试版](docs/TESTING_DESKTOP.md)。
diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md
index 863100717..8fa8beb27 100644
--- a/docs/OPERATIONS.md
+++ b/docs/OPERATIONS.md
@@ -363,7 +363,7 @@ curl -s --noproxy '*' -o /dev/null -w '%{http_code}\n' https://peach.local/healt
- 构建入口是 `scripts/build_windows.ps1`:先用 `scripts/generate_brand_assets.py` 生成方形 Logo 与多尺寸 `.ico`,再构建单一的 `dist/Peach/Peach.exe`。不带参数运行是托盘,`serve`/`migrate` 运行 CLI。
- 对外测试包由 `.github/workflows/release.yml` 构建:`build_windows.ps1 -Standalone` 用 PyInstaller onedir 生成完整的 Windows 程序目录,压缩后由不检出源码的消费任务运行 `scripts/smoke_desktop.py`。冒烟测试会完成首次设置、以 `0.0.0.0` 重启、从本机局域网地址读 `/healthz`、确认 mDNS 已装配,并用访问密码登录。`v<__version__>` 标签与版本不一致会失败;制品验收通过后才创建 GitHub 预发布并附 SHA256。`workflow_dispatch` 只生成和验收制品。
-- 安装包由 `build_windows.ps1 -Installer` 在同一个程序目录上调 Inno Setup 6 的 `ISCC` 编译 `scripts/installer/peach.iss`,产物是 `dist/Peach-<版本>-windows-x64-setup.exe`;找 `ISCC` 的顺序是 `PEACH_ISCC`、`PATH`、两个默认安装位置。默认安装到当前用户的 `%LOCALAPPDATA%\Programs\Peach`,可选择独立、可写且不与数据目录重叠的程序目录。覆盖安装前由随包临时运行时执行 `--installer-prepare`,通知采集任务保存进度并暂停,随后停止托盘,覆盖程序并迁移实际数据目录中的已有账本,最后释放安装保护。安装期间的新采集请求进入等待;安装完成后恢复,取消时原服务也会续跑。卸载走 `--installer-uninstall`,撤销启动项与桌面图标并保留数据。约定与 `AppId` 在 `src/peach/desktop_installer.py`。
+- 安装包由 `build_windows.ps1 -Installer` 在同一个程序目录上调 Inno Setup 6 的 `ISCC` 编译 `scripts/installer/peach.iss`,产物是 `dist/Peach-<版本>-windows-x64-setup.exe`;找 `ISCC` 的顺序是 `PEACH_ISCC`、`PATH`、两个默认安装位置。默认安装到当前用户的 `%LOCALAPPDATA%\Programs\Peach`,可选择独立、可写且不与数据目录重叠的程序目录。覆盖安装前由随包临时运行时执行 `--installer-prepare`,通知采集任务保存进度并暂停,随后停止托盘,覆盖程序并迁移实际数据目录中的已有账本,最后释放安装保护。安装期间的新采集请求进入等待;安装完成或取消后,仍在运行的 Peach 会续跑,已退出则在下次启动时恢复。卸载走 `--installer-uninstall`,撤销启动项与桌面图标并保留数据。约定与 `AppId` 在 `src/peach/desktop_installer.py`。
- 独立包构建会把固定版本的官方 `cloudflared-windows-amd64.exe` 放在 `Peach.exe` 旁边,并用 `scripts/cloudflared-windows.json` 里的 SHA-256 校验。构建前运行 `scripts/fetch_cloudflared.ps1`,或给 `build_windows.ps1 -CloudflaredPath` 一个哈希相同的文件。源码运行不携带这个二进制。
- 每个包都带构建身份:`build_windows.ps1` 在调用 PyInstaller 前把 `{commit, version, built_at}` 写进 `build/windows/build-info.json`,再用 `--add-data` 放到包根,本机托盘与独立测试包共用。构建机没有 git 或源码不是检出时 `commit` 为 `null`,构建照常。`peach.buildinfo.frozen_build()` 只在 `sys.frozen` 时读它;文件缺失或格式不对返回 `None`,托盘照常启动,只是认为自己身份未取得。
- PyInstaller 的资源直接在 `sys._MEIPASS` 下,没有源码树的 `src/` 这一层;打包后的 `migrate`、Web 与品牌资源都要从这里解析,不能在 `config.py` 里固定取 `parents[2]`。
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 1a3d37ba0..b8eceb7b9 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -1,6 +1,6 @@
# Peach 运行核验
-最后核验:2026-10-15
+最后核验:2026-10-16
查 `/healthz`;[待办](PRODUCT_BACKLOG.md)、[复用清单](REUSE.md)、[长期约定](HANDOFF.md)。
@@ -23,6 +23,7 @@
- 收藏、续播、播放墙续页;[路由](ROUTES.md)、[JAV](JAV_DISCOVERY.md)。
- `/healthz` 报 `configurable=true`;配置、选目录共用连接判据;托盘管理 HTTPS 地址、端口及重载。
- 首启记住目录,支持接回已有配置;更新沿用数据根;见 [运行与配置](OPERATIONS.md)。
+- 安装与更新会暂停刮削、抽帧等后台任务,完成或取消后由运行中的 Peach 续跑,已退出则下次启动时恢复;期间新发起的采集等待安装结束,已完成的馆藏处理步骤保留进度。
- 密码未开,局域网匿名可读;首启可跳过密码,配置页可改可关,登录可记住设备。
- macOS 是 reader,代码与 `peach-data` 在内置盘;`peach.local` 经 8900/8443 和 pf 提供 80/443,GET 正常、写入回 409。
- 两端用本机 CA,私钥、凭据不跨机;代码 Git、账本单写者复制、图片 Syncthing;坐标 `<数据根>/config.toml`。
diff --git a/docs/TESTING.md b/docs/TESTING.md
index 36f91699b..c353ed8ef 100644
--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@@ -4,6 +4,8 @@
Windows 发布制品的覆盖升级在 Actions 的「Windows 覆盖升级验收」手动执行:填写已发布的起始版本、目标版本及目标制品的完整构建提交。工作流分别验证 ZIP 原位解压和安装包原位安装,每种路径覆盖默认数据目录与 `PEACH_DATA_ROOT` 指定目录,并上传日志。它使用已发布制品,不重新构建或发布;在线更新和失败回滚仍由 `scripts/smoke_online_update.py` 单独验证。
+Release 工作流还在干净的 Windows runner 上运行 `smoke_update_tasks.py --apply`,使用临时账本验证安装接受正在运行的采集任务、暂停并保留任务标识、覆盖后自动续跑,以及配置保留。脚本默认只预演;本机可以验证 ZIP 与安装助手协议,安装包实装限干净的 Actions runner。
+
## 环境与锁文件
依赖由 uv 按锁文件精确复现。源码安装用 `uv sync --locked`。开发、测试和构建在隔离工作树里建自己的 `.venv`,工作树不碰正在服务的环境;主检出的依赖同步与迁移由重启流程负责,见 [运行与配置](OPERATIONS.md) 的「刷新源码运行态」一节(ADR-0091)。
diff --git a/scripts/smoke_desktop.py b/scripts/smoke_desktop.py
index 84885e2b2..71deeb636 100644
--- a/scripts/smoke_desktop.py
+++ b/scripts/smoke_desktop.py
@@ -25,8 +25,9 @@ import uuid
@contextmanager
def smoke_directory(evidence_dir: Path):
"""失败时只保留本次临时运行的日志,不打包账本与配置。"""
- with tempfile.TemporaryDirectory(prefix="peach-desktop-") as directory:
- root = Path(directory).resolve()
+ directory = tempfile.TemporaryDirectory(prefix="peach-desktop-")
+ try:
+ root = Path(directory.name).resolve()
try:
yield root
except BaseException:
@@ -39,6 +40,21 @@ def smoke_directory(evidence_dir: Path):
(destination / "failure.txt").write_text(traceback.format_exc(), encoding="utf-8")
print(f"制品验收失败,日志:{destination}", file=sys.stderr, flush=True)
raise
+ finally:
+ cleanup_smoke_directory(directory)
+
+
+def cleanup_smoke_directory(directory):
+ """等待 Windows 释放原生缓存目录,持续占用仍判验收失败。"""
+ deadline = time.monotonic() + 15
+ while True:
+ try:
+ directory.cleanup()
+ return
+ except OSError as error:
+ if getattr(error, 'winerror', None) not in (32, 145) or time.monotonic() >= deadline:
+ raise
+ time.sleep(.25)
def artifact_processes(executable: Path) -> list[int]:
diff --git a/scripts/smoke_update_tasks.py b/scripts/smoke_update_tasks.py
index e3c730ab4..148667842 100644
--- a/scripts/smoke_update_tasks.py
+++ b/scripts/smoke_update_tasks.py
@@ -34,7 +34,11 @@ def main():
parser.add_argument('--old-executable', type=Path)
parser.add_argument('--installer', type=Path)
parser.add_argument('--evidence-dir', type=Path, default=Path('smoke-evidence'))
+ parser.add_argument('--apply', action='store_true', help='执行临时安装与任务恢复验收')
args = parser.parse_args()
+ if not args.apply:
+ print('预演:在临时目录完成首启、模拟运行任务、覆盖安装并核验续跑;加 --apply 执行。')
+ return 0
executable = args.executable.resolve(strict=True)
if args.installer:
validate_installer_host()
@@ -117,6 +121,8 @@ def main():
if process is not None and process.poll() is None:
process.terminate()
process.wait(timeout=20)
+ # Windows 在 Popen 释放前仍保留已退出进程的内核句柄。
+ process = None
if args.installer and (application / 'unins000.exe').exists():
subprocess.run([str(application / 'unins000.exe'), '/VERYSILENT', '/SUPPRESSMSGBOXES',
'/NORESTART'], env=environment, timeout=120, check=True)
diff --git a/src/peach/jobs.py b/src/peach/jobs.py
index 37990b7f8..028bb2ebc 100644
--- a/src/peach/jobs.py
+++ b/src/peach/jobs.py
@@ -670,7 +670,6 @@ def job_main(build_parser, run, argv: list[str] | None = None) -> int:
args = build_parser().parse_args(argv)
from .update_tasks import UpdateBusy
try:
- from .update_tasks import activity
db = Path(getattr(args, 'db', Path(args.lock).resolve().parent / 'ledger.db'))
with PidFileLock(args.lock):
return _run_batch_with_updates(db, Path(args.lock).stem, run, args)
diff --git a/tests/test_fastapi_api.py b/tests/test_fastapi_api.py
index 7bb1c3f80..cdf3deeaf 100644
--- a/tests/test_fastapi_api.py
+++ b/tests/test_fastapi_api.py
@@ -3247,7 +3247,7 @@ class UnconfiguredMachineTests(unittest.IsolatedAsyncioTestCase):
self.assertEqual(job_recovery.read(database, 'library-processing')['status'], 'complete')
async def test_cancelled_installation_resumes_the_paused_task_in_the_existing_service(self):
- from peach import job_recovery, settings_file, update_tasks
+ from peach import settings_file, update_tasks
parent = self.settings.db_path.parent
parent.mkdir(parents=True)
database = fresh_ledger(parent)
diff --git a/tests/test_scripts.py b/tests/test_scripts.py
index f494c3635..d39710b8f 100644
--- a/tests/test_scripts.py
+++ b/tests/test_scripts.py
@@ -53,11 +53,41 @@ def load_script(name: str):
return module
+class UpdateTaskSmokeTests(unittest.TestCase):
+ def test_dry_run_does_not_open_artifacts_or_create_installation_data(self):
+ with mock.patch.dict(sys.modules, {'smoke_desktop': load_script('smoke_desktop')}):
+ script = load_script('smoke_update_tasks')
+ with mock.patch.object(sys, 'argv', ['smoke_update_tasks.py', 'missing/Peach.exe']), \
+ mock.patch.object(script, 'smoke_directory') as directory, redirect_stdout(io.StringIO()):
+ self.assertEqual(script.main(), 0)
+ directory.assert_not_called()
+
+
class DesktopSmokeTests(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.script = load_script("smoke_desktop")
+ def test_cleanup_waits_for_a_released_windows_directory(self):
+ error = PermissionError('目录仍被占用')
+ error.winerror = 32
+ directory = mock.Mock()
+ directory.cleanup.side_effect = [error, None]
+ with mock.patch.object(self.script.time, 'sleep'):
+ self.script.cleanup_smoke_directory(directory)
+ self.assertEqual(directory.cleanup.call_count, 2)
+
+ def test_cleanup_preserves_persistent_or_unrelated_failures(self):
+ for winerror in (32, 5):
+ with self.subTest(winerror=winerror):
+ error = PermissionError('无法清理')
+ error.winerror = winerror
+ directory = mock.Mock()
+ directory.cleanup.side_effect = error
+ with mock.patch.object(self.script.time, 'monotonic', side_effect=[0, 16]), \
+ self.assertRaises(PermissionError):
+ self.script.cleanup_smoke_directory(directory)
+
def test_failure_preserves_logs_without_database_or_configuration(self):
with tempfile.TemporaryDirectory() as directory:
evidence = Path(directory).resolve() / "evidence"
diff --git a/tests/test_standalone_update.py b/tests/test_standalone_update.py
index fa1daebcc..39398a2d4 100644
--- a/tests/test_standalone_update.py
+++ b/tests/test_standalone_update.py
@@ -114,7 +114,7 @@ class StandaloneUpdateTests(unittest.TestCase):
from support.ledger import fresh_ledger
fresh_ledger(self.database.parent)
store = TaskRunStore(self.database)
- run = store.start('library-processing', trigger='scheduled')
+ store.start('library-processing', trigger='scheduled')
update.write({}, state='ready', version='1.0.0')
with patch.object(update.distribution, 'standalone', return_value=True), patch.object(update.sys, 'platform', 'win32'):
self.assertEqual(update.request_restart()['state'], 'restarting')
diff --git a/tests/test_update_tasks.py b/tests/test_update_tasks.py
index 82c8a5437..cfbbf3c55 100644
--- a/tests/test_update_tasks.py
+++ b/tests/test_update_tasks.py
@@ -180,7 +180,7 @@ class UpdateTaskTests(unittest.TestCase):
def test_installer_accepts_a_running_task_and_holds_the_pause_until_completion(self):
config = settings_file.load_config(environ={'PEACH_DATA_ROOT': str(self.root)})
- run = self.store.start('library-processing', trigger='manual')
+ self.store.start('library-processing', trigger='manual')
error = self.root / 'prepare-error.txt'
with patch.object(settings_file, 'load_config', return_value=config), patch.object(
desktop_installer, 'stop', return_value=True) as stop, patch.object(