nonebot-plugin-git-poller 0.1.5__tar.gz

nonebot_plugin_git_poller-0.1.5/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.3
+Name: nonebot-plugin-git-poller
+Version: 0.1.5
+Summary: 按群订阅 Git 仓库更新的 NoneBot2 插件，支持多仓库、多分支定时拉取
+Author: kusadact
+License: MIT
+Requires-Dist: nonebot2>=2.0.0
+Requires-Dist: nonebot-adapter-onebot>=2.1.3
+Requires-Dist: nonebot-plugin-apscheduler>=0.5.0
+Requires-Dist: nonebot-plugin-localstore>=0.6.0
+Requires-Dist: dulwich>=1.2.6
+Requires-Dist: py7zr>=1.1.0
+Requires-Dist: urllib3>=2.0.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="https://v2.nonebot.dev/store">
+    <img src="https://raw.githubusercontent.com/fllesser/nonebot-plugin-template/refs/heads/resource/.docs/NoneBotPlugin.svg" width="310" alt="logo">
+  </a>
+
+## nonebot-plugin-git-poller
+
+[![LICENSE](https://img.shields.io/github/license/kusadact/nonebot-plugin-git-poller.svg)](./LICENSE)
+[![pypi](https://img.shields.io/pypi/v/nonebot-plugin-git-poller.svg)](https://pypi.org/project/nonebot-plugin-git-poller/)
+[![python](https://img.shields.io/badge/python-3.10|3.11|3.12|3.13-blue.svg)](https://www.python.org)
+[![uv](https://img.shields.io/badge/package%20manager-uv-black?style=flat-square&logo=uv)](https://github.com/astral-sh/uv)
+[![codecov](https://codecov.io/gh/kusadact/nonebot-plugin-git-poller/graph/badge.svg)](https://codecov.io/gh/kusadact/nonebot-plugin-git-poller)
+
+</div>
+
+按群订阅 Git 仓库更新的 NoneBot2 插件，支持多仓库、多分支定时拉取，自动推送 commit 更新摘要并上传源码压缩包。
+
+## 安装
+
+在 NoneBot 项目目录中安装插件：
+
+```bash
+uv add nonebot-plugin-git-poller
+```
+
+在 `pyproject.toml` 中加载插件：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot_plugin_git_poller"]
+```
+
+## 配置
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `git_poller_default_schedule` | 否 | `每日04:00` | 新关注仓库的默认定时规则；留空关闭默认定时注册。 |
+| `git_poller_timezone` | 否 | `Asia/Shanghai` | 定时任务时区。 |
+| `git_poller_proxy` | 否 | 空 | HTTP/HTTPS Git 拉取代理。 |
+| `git_poller_timeout` | 否 | `60.0` | HTTP/HTTPS Git 拉取超时，单位秒。 |
+| `git_poller_archive_password` | 否 | 空 | 全局默认压缩包密码；为空时默认不设置密码。 |
+| `git_poller_file_base_url` | 条件 | 空 | 上传压缩包时使用的 NoneBot HTTP 服务根地址；Bot 和 OneBot/NapCat 不在同一个文件系统时必须配置，例如 http://nonebot:8088。 |
+
+## 指令
+
+```text
+/关注仓库 仓库url [--分支名]
+/取关仓库 仓库url [--分支名]
+/设置仓库 仓库url [--分支名]
+/拉取仓库 仓库url [--分支名]
+/仓库摘要 仓库url [--分支名]
+/仓库列表
+```
+
+带 URL 的命令都支持可选分支后缀，例如 `/关注仓库 https://example.test/repo.git --dev`。`/关注仓库` 不写分支时追踪远端默认分支；其他命令不写分支时优先使用本群本仓库的唯一订阅，若同仓库关注了多个分支则需要写 `--分支名`。
+
+`/关注仓库` 在当前群关注仓库。同一个群可以关注同一仓库的不同分支。
+
+`/取关仓库` 移除当前群的对应仓库分支订阅，不影响其他群。
+
+`/设置仓库` 进入设置流程。Bot 会回复：
+
+```text
+输入设置数字选项
+1. 修改当前仓库推送抓取时间
+2. 修改当前仓库上传压缩包密码（选择后输入无则清除当前仓库密码回到全局默认）
+```
+
+回复 `1` 后，下一条消息必须是合法定时格式。回复 `2` 后，下一条消息会保存为当前仓库压缩包密码，此时输入 `无` 会清除当前仓库密码并回到全局默认。输入非法会取消。
+
+`/仓库列表` 显示当前群关注的仓库、分支、定时、启用状态、`last_success_sha` 和压缩包密码来源。
+
+`/拉取仓库` 立即拉取当前群已关注的仓库，上传最新的源码压缩包。
+
+`/仓库摘要` 仅拉取远端并展示本群记录与远端 HEAD 的差异。
+
+## 定时格式
+
+支持：
+
+```text
+每日hh:mm
+每x天hh:mm
+周xhh:mm
+```
+
+`每x天` 的 `x` 使用 1 到 30 的整数；`周x` 只支持汉字 `一二三四五六日/天`

nonebot_plugin_git_poller-0.1.5/README.md

@@ -0,0 +1,87 @@
+<div align="center">
+  <a href="https://v2.nonebot.dev/store">
+    <img src="https://raw.githubusercontent.com/fllesser/nonebot-plugin-template/refs/heads/resource/.docs/NoneBotPlugin.svg" width="310" alt="logo">
+  </a>
+
+## nonebot-plugin-git-poller
+
+[![LICENSE](https://img.shields.io/github/license/kusadact/nonebot-plugin-git-poller.svg)](./LICENSE)
+[![pypi](https://img.shields.io/pypi/v/nonebot-plugin-git-poller.svg)](https://pypi.org/project/nonebot-plugin-git-poller/)
+[![python](https://img.shields.io/badge/python-3.10|3.11|3.12|3.13-blue.svg)](https://www.python.org)
+[![uv](https://img.shields.io/badge/package%20manager-uv-black?style=flat-square&logo=uv)](https://github.com/astral-sh/uv)
+[![codecov](https://codecov.io/gh/kusadact/nonebot-plugin-git-poller/graph/badge.svg)](https://codecov.io/gh/kusadact/nonebot-plugin-git-poller)
+
+</div>
+
+按群订阅 Git 仓库更新的 NoneBot2 插件，支持多仓库、多分支定时拉取，自动推送 commit 更新摘要并上传源码压缩包。
+
+## 安装
+
+在 NoneBot 项目目录中安装插件：
+
+```bash
+uv add nonebot-plugin-git-poller
+```
+
+在 `pyproject.toml` 中加载插件：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot_plugin_git_poller"]
+```
+
+## 配置
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `git_poller_default_schedule` | 否 | `每日04:00` | 新关注仓库的默认定时规则；留空关闭默认定时注册。 |
+| `git_poller_timezone` | 否 | `Asia/Shanghai` | 定时任务时区。 |
+| `git_poller_proxy` | 否 | 空 | HTTP/HTTPS Git 拉取代理。 |
+| `git_poller_timeout` | 否 | `60.0` | HTTP/HTTPS Git 拉取超时，单位秒。 |
+| `git_poller_archive_password` | 否 | 空 | 全局默认压缩包密码；为空时默认不设置密码。 |
+| `git_poller_file_base_url` | 条件 | 空 | 上传压缩包时使用的 NoneBot HTTP 服务根地址；Bot 和 OneBot/NapCat 不在同一个文件系统时必须配置，例如 http://nonebot:8088。 |
+
+## 指令
+
+```text
+/关注仓库 仓库url [--分支名]
+/取关仓库 仓库url [--分支名]
+/设置仓库 仓库url [--分支名]
+/拉取仓库 仓库url [--分支名]
+/仓库摘要 仓库url [--分支名]
+/仓库列表
+```
+
+带 URL 的命令都支持可选分支后缀，例如 `/关注仓库 https://example.test/repo.git --dev`。`/关注仓库` 不写分支时追踪远端默认分支；其他命令不写分支时优先使用本群本仓库的唯一订阅，若同仓库关注了多个分支则需要写 `--分支名`。
+
+`/关注仓库` 在当前群关注仓库。同一个群可以关注同一仓库的不同分支。
+
+`/取关仓库` 移除当前群的对应仓库分支订阅，不影响其他群。
+
+`/设置仓库` 进入设置流程。Bot 会回复：
+
+```text
+输入设置数字选项
+1. 修改当前仓库推送抓取时间
+2. 修改当前仓库上传压缩包密码（选择后输入无则清除当前仓库密码回到全局默认）
+```
+
+回复 `1` 后，下一条消息必须是合法定时格式。回复 `2` 后，下一条消息会保存为当前仓库压缩包密码，此时输入 `无` 会清除当前仓库密码并回到全局默认。输入非法会取消。
+
+`/仓库列表` 显示当前群关注的仓库、分支、定时、启用状态、`last_success_sha` 和压缩包密码来源。
+
+`/拉取仓库` 立即拉取当前群已关注的仓库，上传最新的源码压缩包。
+
+`/仓库摘要` 仅拉取远端并展示本群记录与远端 HEAD 的差异。
+
+## 定时格式
+
+支持：
+
+```text
+每日hh:mm
+每x天hh:mm
+周xhh:mm
+```
+
+`每x天` 的 `x` 使用 1 到 30 的整数；`周x` 只支持汉字 `一二三四五六日/天`

nonebot_plugin_git_poller-0.1.5/pyproject.toml

@@ -0,0 +1,40 @@
+[project]
+name = "nonebot-plugin-git-poller"
+version = "0.1.5"
+description = "按群订阅 Git 仓库更新的 NoneBot2 插件，支持多仓库、多分支定时拉取"
+authors = [
+    {name = "kusadact"},
+]
+license = {text = "MIT"}
+dependencies = [
+    "nonebot2>=2.0.0",
+    "nonebot-adapter-onebot>=2.1.3",
+    "nonebot-plugin-apscheduler>=0.5.0",
+    "nonebot-plugin-localstore>=0.6.0",
+    "dulwich>=1.2.6",
+    "py7zr>=1.1.0",
+    "urllib3>=2.0.0",
+]
+requires-python = ">=3.10"
+readme = "README.md"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=7.1.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.0,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv]
+required-version = ">=0.11.0"
+default-groups = ["dev"]
+
+[tool.uv.build-backend]
+module-name = "nonebot_plugin_git_poller"
+module-root = "src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

nonebot_plugin_git_poller-0.1.5/src/nonebot_plugin_git_poller/__init__.py

@@ -0,0 +1,449 @@
+from __future__ import annotations
+
+import asyncio
+from datetime import datetime, timedelta
+
+from nonebot import get_bots, logger, on_command, require
+from nonebot.adapters.onebot.v11 import Bot, GroupMessageEvent, Message
+from nonebot.exception import FinishedException
+from nonebot.matcher import Matcher
+from nonebot.params import ArgPlainText, CommandArg
+from nonebot.plugin import PluginMetadata
+
+require("nonebot_plugin_apscheduler")
+require("nonebot_plugin_localstore")
+
+from nonebot_plugin_apscheduler import scheduler
+
+from .command_args import parse_repo_command_args
+from .config import Config, plugin_config
+from .file_server import register_archive_file_route
+from .message import (
+    ArchiveUploadUriError,
+    build_archive_delivery_text,
+    send_update_to_group,
+    upload_archive_to_group,
+)
+from .mirror import GitPollerService
+from .schedule import parse_schedule
+
+__plugin_meta__ = PluginMetadata(
+    name="Git Poller",
+    description="按群订阅 Git 仓库更新，支持多仓库、多分支定时拉取",
+    usage=(
+        "/关注仓库 仓库url [--分支名]\n"
+        "/取关仓库 仓库url [--分支名]\n"
+        "/设置仓库 仓库url [--分支名]\n"
+        "/仓库列表\n"
+        "/拉取仓库 仓库url [--分支名]\n"
+        "/仓库摘要 仓库url [--分支名]"
+    ),
+    type="application",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+)
+
+service = GitPollerService(plugin_config)
+COMMAND_PRIORITY = 10
+
+follow_repo = on_command(
+    "关注仓库",
+    priority=COMMAND_PRIORITY,
+    block=True,
+)
+unfollow_repo = on_command(
+    "取关仓库",
+    priority=COMMAND_PRIORITY,
+    block=True,
+)
+configure_repo = on_command(
+    "设置仓库",
+    priority=COMMAND_PRIORITY,
+    block=True,
+)
+list_repos = on_command(
+    "仓库列表",
+    priority=COMMAND_PRIORITY,
+    block=True,
+)
+pull_repo = on_command(
+    "拉取仓库",
+    priority=COMMAND_PRIORITY,
+    block=True,
+)
+summarize_repo = on_command(
+    "仓库摘要",
+    priority=COMMAND_PRIORITY,
+    block=True,
+)
+
+
+@follow_repo.handle()
+async def _(event: GroupMessageEvent, matcher: Matcher, args: Message = CommandArg()) -> None:
+    try:
+        parsed = _repo_args(args)
+    except ValueError as exc:
+        await matcher.finish(f"用法：/关注仓库 仓库url [--分支名]\n{exc}")
+    if parsed is None:
+        await matcher.finish("用法：/关注仓库 仓库url [--分支名]")
+    group_id = int(event.group_id)
+    try:
+        result = await service.follow_repo(group_id, parsed.url, parsed.branch)
+        if result.already_following:
+            await matcher.finish(
+                f"本群已经关注：{result.identity.display_name}\n"
+                f"分支：{result.subscription.branch}\n"
+                f"定时：{result.subscription.schedule}"
+            )
+        await matcher.finish(
+            f"已关注：{result.identity.display_name}\n"
+            f"分支：{result.subscription.branch}\n"
+            f"定时：{result.subscription.schedule}\n"
+            f"当前 commit 已记录，后续有新提交时推送。"
+        )
+    except FinishedException:
+        raise
+    except Exception as exc:
+        logger.exception("git poller follow command failed")
+        await matcher.finish(f"关注仓库失败：{exc}")
+
+
+@unfollow_repo.handle()
+async def _(event: GroupMessageEvent, matcher: Matcher, args: Message = CommandArg()) -> None:
+    try:
+        parsed = _repo_args(args)
+    except ValueError as exc:
+        await matcher.finish(f"用法：/取关仓库 仓库url [--分支名]\n{exc}")
+    if parsed is None:
+        await matcher.finish("用法：/取关仓库 仓库url [--分支名]")
+    try:
+        identity, removed = service.unfollow_repo(
+            int(event.group_id),
+            parsed.url,
+            parsed.branch,
+        )
+        if removed:
+            _schedule_repo_cleanup(identity.key)
+            await matcher.finish(f"已取关：{identity.display_name}")
+        await matcher.finish(f"本群没有关注：{identity.display_name}")
+    except FinishedException:
+        raise
+    except Exception as exc:
+        logger.exception("git poller unfollow command failed")
+        await matcher.finish(f"取关仓库失败：{exc}")
+
+
+@configure_repo.handle()
+async def _(
+    event: GroupMessageEvent,
+    matcher: Matcher,
+    args: Message = CommandArg(),
+) -> None:
+    try:
+        parsed = _repo_args(args)
+    except ValueError as exc:
+        await matcher.finish(f"用法：/设置仓库 仓库url [--分支名]\n{exc}")
+    if parsed is None:
+        await matcher.finish("用法：/设置仓库 仓库url [--分支名]")
+    try:
+        identity, subscription = service.get_repo_subscription(
+            int(event.group_id),
+            parsed.url,
+            parsed.branch,
+        )
+    except Exception as exc:
+        logger.exception("git poller configure command failed")
+        await matcher.finish(f"设置仓库失败：{exc}")
+    matcher.state["repo_url"] = parsed.url
+    matcher.state["repo_branch"] = subscription.branch
+    matcher.state["repo_identity_name"] = identity.display_name
+    matcher.state["repo_subscription_branch"] = subscription.branch
+    matcher.state["repo_config_group_id"] = int(event.group_id)
+    matcher.state["repo_config_user_id"] = int(event.user_id)
+    await matcher.send(
+        "输入设置数字选项\n"
+        "1. 修改当前仓库推送抓取时间\n"
+        "2. 修改当前仓库上传压缩包密码（选择后输入无则清除当前仓库密码回到全局默认）"
+    )
+
+
+@configure_repo.got("setting_choice")
+async def _(
+    event: GroupMessageEvent,
+    matcher: Matcher,
+    choice: str = ArgPlainText("setting_choice"),
+) -> None:
+    if not _same_config_session(event, matcher):
+        await matcher.finish("输入非法，已取消设置。")
+    choice = choice.strip()
+    if choice not in {"1", "2"}:
+        await matcher.finish("输入非法，已取消设置。")
+    matcher.state["setting_choice"] = choice
+    if choice == "1":
+        await matcher.send("请输入新的推送抓取时间，例如：每日04:00、每3天04:00、周一04:00")
+    else:
+        await matcher.send("请输入新的压缩包密码。输入 无 则清除当前仓库密码回到全局默认。")
+
+
+@configure_repo.got("setting_value")
+async def _(
+    event: GroupMessageEvent,
+    matcher: Matcher,
+    value: str = ArgPlainText("setting_value"),
+) -> None:
+    if not _same_config_session(event, matcher):
+        await matcher.finish("输入非法，已取消设置。")
+    group_id = int(event.group_id)
+    url = str(matcher.state["repo_url"])
+    branch = matcher.state.get("repo_branch")
+    if branch is not None:
+        branch = str(branch)
+    choice = str(matcher.state["setting_choice"])
+    value = value.strip()
+    if not value:
+        await matcher.finish("输入非法，已取消设置。")
+
+    if choice == "1":
+        try:
+            parse_schedule(value, plugin_config.git_poller_timezone)
+            identity, subscription = service.update_repo_schedule(
+                group_id,
+                url,
+                branch,
+                value,
+            )
+            _register_schedule(subscription.schedule)
+        except Exception as exc:
+            logger.exception("git poller schedule setting failed")
+            await matcher.finish(f"输入非法，已取消设置：{exc}")
+        await matcher.finish(
+            f"设置成功：{identity.display_name}\n"
+            f"分支：{subscription.branch}\n"
+            f"推送抓取时间：{subscription.schedule}"
+        )
+
+    password = None if value in {"无", "none", "None", "NONE", "clear", "Clear", "CLEAR"} else value
+    try:
+        identity, subscription = service.update_repo_archive_password(
+            group_id,
+            url,
+            branch,
+            password,
+        )
+    except Exception as exc:
+        logger.exception("git poller archive password setting failed")
+        await matcher.finish(f"输入非法，已取消设置：{exc}")
+    status = "回到全局默认" if subscription.archive_password is None else "已设置当前仓库密码"
+    await matcher.finish(
+        f"设置成功：{identity.display_name}\n"
+        f"分支：{subscription.branch}\n"
+        f"压缩包密码：{status}"
+    )
+
+
+@list_repos.handle()
+async def _(event: GroupMessageEvent, matcher: Matcher) -> None:
+    subscriptions = service.list_group_subscriptions(int(event.group_id))
+    if not subscriptions:
+        await matcher.finish("本群还没有关注任何仓库。")
+    lines = ["本群关注的仓库："]
+    for index, (repo_key, subscription) in enumerate(subscriptions.items(), start=1):
+        status = "启用" if subscription.enabled else "停用"
+        last_sha = subscription.last_success_sha[:8] if subscription.last_success_sha else "未记录"
+        password_status = "仓库密码" if subscription.archive_password else "全局默认"
+        lines.append(
+            f"{index}. {subscription.url}\n"
+            f"   key: {repo_key}\n"
+            f"   branch: {subscription.branch} / schedule: {subscription.schedule} / {status}\n"
+            f"   last_success_sha: {last_sha}\n"
+            f"   archive_password: {password_status}"
+        )
+    await matcher.finish("\n".join(lines))
+
+
+@pull_repo.handle()
+async def _(bot: Bot, event: GroupMessageEvent, matcher: Matcher, args: Message = CommandArg()) -> None:
+    try:
+        parsed = _repo_args(args)
+    except ValueError as exc:
+        await matcher.finish(f"用法：/拉取仓库 仓库url [--分支名]\n{exc}")
+    if parsed is None:
+        await matcher.finish("用法：/拉取仓库 仓库url [--分支名]")
+    group_id = int(event.group_id)
+    try:
+        result = await service.pull_repo(group_id, parsed.url, parsed.branch)
+        await upload_archive_to_group(
+            bot,
+            group_id,
+            result.archive,
+            config=plugin_config,
+        )
+        service.mark_pull_success(group_id, result.identity.key, result.target_sha)
+        await matcher.finish(
+            build_archive_delivery_text(
+                result.payload,
+                result.archive,
+                title="拉取完成",
+            )
+        )
+    except FinishedException:
+        raise
+    except Exception as exc:
+        logger.exception("git poller pull command failed")
+        await matcher.finish(f"拉取仓库失败：{exc}")
+
+
+@summarize_repo.handle()
+async def _(bot: Bot, event: GroupMessageEvent, matcher: Matcher, args: Message = CommandArg()) -> None:
+    try:
+        parsed = _repo_args(args)
+    except ValueError as exc:
+        await matcher.finish(f"用法：/仓库摘要 仓库url [--分支名]\n{exc}")
+    if parsed is None:
+        await matcher.finish("用法：/仓库摘要 仓库url [--分支名]")
+    group_id = int(event.group_id)
+    try:
+        summary = await service.summarize_repo(group_id, parsed.url, parsed.branch)
+        payload = summary.result.payload
+        if payload.previous_sha == payload.target_sha:
+            await matcher.finish(
+                f"仓库摘要：{payload.repo_name}\n"
+                f"分支：{payload.branch}\n"
+                f"本地与远程相同：{payload.target_short_sha}"
+            )
+        await send_update_to_group(bot, group_id, payload)
+        behind_text = (
+            f"本地记录落后远程 {summary.behind_count} 个 commit。"
+            if summary.behind_count is not None
+            else "本地记录与远程存在差异。"
+        )
+        await matcher.finish(
+            f"仓库摘要已发送：{payload.repo_name}\n"
+            f"分支：{payload.branch}\n"
+            f"{behind_text}\n"
+            f"本地记录未更新。"
+        )
+    except FinishedException:
+        raise
+    except Exception as exc:
+        logger.exception("git poller summary command failed")
+        await matcher.finish(f"仓库摘要失败：{exc}")
+
+
+async def run_scheduled_check(schedule: str) -> None:
+    bots = get_bots()
+    if not bots:
+        logger.warning("git poller scheduled check skipped: no bot is connected")
+        return
+    bot = next(iter(bots.values()))
+    try:
+        async for result in service.poll_schedule(schedule):
+            try:
+                await upload_archive_to_group(
+                    bot,
+                    result.result.group_id,
+                    result.archive,
+                    config=plugin_config,
+                )
+                await bot.send_group_msg(
+                    group_id=int(result.result.group_id),
+                    message=build_archive_delivery_text(
+                        result.result.payload,
+                        result.archive,
+                        title="拉取完成",
+                    ),
+                )
+                service.mark_success(result.result)
+            except ArchiveUploadUriError as exc:
+                logger.exception(
+                    f"git poller scheduled archive upload URI failed: "
+                    f"group={result.result.group_id}, repo={result.result.repo_key}"
+                )
+                try:
+                    await bot.send_group_msg(
+                        group_id=int(result.result.group_id),
+                        message=str(exc),
+                    )
+                except Exception:
+                    logger.exception(
+                        f"git poller scheduled upload error notification failed: "
+                        f"group={result.result.group_id}, repo={result.result.repo_key}"
+                    )
+                continue
+            except Exception:
+                logger.exception(
+                    f"git poller scheduled push failed: "
+                    f"group={result.result.group_id}, repo={result.result.repo_key}"
+                )
+                continue
+    except Exception:
+        logger.exception(f"git poller scheduled check failed: {schedule}")
+
+
+async def cleanup_unsubscribed_repo(repo_key: str) -> None:
+    try:
+        await asyncio.to_thread(service.cleanup_unsubscribed_repo, repo_key)
+    except Exception:
+        logger.exception(f"git poller delayed cleanup failed: repo={repo_key}")
+
+
+def _register_schedules() -> None:
+    for schedule_rule in sorted(service.scheduled_rules()):
+        _register_schedule(schedule_rule)
+
+
+def _cleanup_orphaned_storage_on_startup() -> None:
+    try:
+        service.cleanup_orphaned_storage()
+    except Exception:
+        logger.exception("git poller startup orphan cleanup failed")
+
+
+def _register_schedule(schedule_rule: str) -> None:
+    try:
+        spec = parse_schedule(schedule_rule, plugin_config.git_poller_timezone)
+    except ValueError:
+        logger.exception(f"git poller skipped invalid schedule: {schedule_rule}")
+        return
+    if spec is None:
+        return
+    scheduler.add_job(
+        run_scheduled_check,
+        spec.trigger,
+        args=[schedule_rule],
+        id=f"git_poller:{schedule_rule}",
+        max_instances=1,
+        coalesce=True,
+        replace_existing=True,
+        **spec.trigger_kwargs,
+    )
+    logger.info(f"git poller scheduler registered: {spec.description}")
+
+
+def _schedule_repo_cleanup(repo_key: str) -> None:
+    run_at = datetime.now() + timedelta(hours=1)
+    scheduler.add_job(
+        cleanup_unsubscribed_repo,
+        "date",
+        args=[repo_key],
+        id=f"git_poller:cleanup:{repo_key}",
+        run_date=run_at,
+        replace_existing=True,
+    )
+    logger.info(f"git poller delayed cleanup scheduled: repo={repo_key}, run_at={run_at}")
+
+
+def _repo_args(args: Message):
+    return parse_repo_command_args(str(args))
+
+
+def _same_config_session(event: GroupMessageEvent, matcher: Matcher) -> bool:
+    return (
+        int(event.group_id) == int(matcher.state.get("repo_config_group_id", -1))
+        and int(event.user_id) == int(matcher.state.get("repo_config_user_id", -1))
+    )
+
+
+_register_schedules()
+_cleanup_orphaned_storage_on_startup()
+register_archive_file_route(plugin_config)