Gitizen

插件

· 作者 Bloodulon

将 Denizen 脚本直接与你的 GitHub 仓库同步。

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.1 · 26.3 · Paper / Purpur

一键开服(送7天)

Gitizen

安全地从 Git 更新 Denizen 脚本至 Minecraft 服务器。

Gitizen 加载仓库的指定分支,检查新脚本,并谨慎地替换 Denizen 的工作目录。如果 Denizen 检测到错误,它会自动回滚到之前的版本。


内容 / Contents


中文

功能

  • 通过 HTTPS 与 GitHub 同步 Denizen 脚本。
  • 支持私有和公共仓库。
  • 支持多个配置文件,例如 production 和 staging。
  • 每个配置文件拥有独立的分支和目录。
  • 使用已安装的 Denizen 解析器检查 .dsc 文件。
  • 通过暂存文件夹安全地替换目录。
  • 如果 Denizen 在加载时检测到错误,自动回滚到上一个版本。
  • 支持根据部署编号或 commit hash 手动回滚。
  • 状态命令显示当前和远程的 commit。
  • 部署历史和持续指标。
  • Discord 和 Telegram 通知。
  • 交互式消息:悬停提示、复制 hash 和 GitHub 链接。
  • 防止同一配置文件的两个操作同时运行。
  • 检测在工作目录中手动更改的文件。

Git checkout 存储在 plugins/Gitizen/repositories 中,而不是 plugins/Denizen/scripts 中。因此,Denizen 文件夹不包含 .git,仅用于活动脚本。

要求

  • Paper 1.21.x。
  • Java 21 或更高版本。
  • 已安装并运行的 Denizen。
  • 对 GitHub 的出站 HTTPS 访问。
  • 对于通知——需要对 Discord 或 Telegram 的出站 HTTPS 访问。

Gitizen 依赖于 Denizen。如果缺少 Denizen,Paper 将不会加载 Gitizen。

安装

  1. 停止 Minecraft 服务器。
  2. 将 Gitizen-1.0.0.jar 复制到 plugins 文件夹。
  3. 确保 Denizen.jar 也位于 plugins 文件夹中。
  4. 启动服务器一次。
  5. 停止服务器并打开 plugins/Gitizen/config.yml。
  6. 指定仓库 URL 和所需分支。
  7. 如果是私有仓库,配置令牌(token)。
  8. 启动服务器并执行 /gitizen status。
  9. 首次部署请执行 /gitizen sync。

建议首次安装前备份 plugins/Denizen/scripts。在后续部署期间,Gitizen 会在完成检查之前自行保存当前的工作目录作为上一版本。

快速开始

公共仓库

最小配置:

default-profile: "production"

profiles:
  production:
    repo-url: "https://github.com/USER/REPOSITORY.git"
    branch: "main"
    repository-subdirectory: ""
    target-directory: "scripts"
    reload-denizen: true
    username: "gitizen"
    token-env: "GITIZEN_GITHUB_TOKEN"
    token: ""

如果 .dsc 文件位于仓库内的 minecraft/denizen 文件夹中:

repository-subdirectory: "minecraft/denizen"

保存配置后:

/gitizen reload
/gitizen status production
/gitizen sync production

私有仓库

创建一个仅限访问所需仓库且具备“Contents: Read”权限的 GitHub fine-grained Personal Access Token。

首选方式是使用环境变量:

GITIZEN_GITHUB_TOKEN=github_pat_...

变量名称在以下位置指定:

token-env: "GITIZEN_GITHUB_TOKEN"

在游戏主机上,环境变量可能被称为“Environment variables”、“Startup variables”或“Secrets”。如果控制面板不支持它们,则可以将令牌直接写入配置文件中:

token-env: ""
token: "github_pat_..."

不要通过 Minecraft 命令传递 PAT。/gitizen setup 命令故意不接受令牌,以防止其出现在控制台日志中。

Production 和 Staging 配置文件

配置文件是保存的部署方案。它回答了五个问题:

  1. 从哪个 Git 仓库下载文件?
  2. 使用哪个分支?
  3. 从仓库内的哪个文件夹获取脚本?
  4. 将它们放入 Denizen 的哪个文件夹?
  5. 之后是否需要重新加载活动脚本?

production 和 staging 名称本身并不切换任何内容。它们是普通的配置文件名称,可以更改。行为由 branch、repository-subdirectory、target-directory 和 reload-denizen 的值决定。

在标准方案中,配置文件的使用方式如下:

配置文件 Git 分支 文件复制到哪里 Denizen 是否执行这些文件?
production main plugins/Denizen/scripts 是,在成功检查后立即执行
staging develop plugins/Denizen/scripts-staging 否,这是一个单独的测试副本

两个配置文件的示例:

default-profile: "production"

profiles:
  production:
    repo-url: "https://github.com/USER/REPOSITORY.git"
    branch: "main"
    repository-subdirectory: "denizen"
    target-directory: "scripts"
    reload-denizen: true
    username: "gitizen"
    token-env: "GITIZEN_GITHUB_TOKEN"
    token: ""

  staging:
    repo-url: "https://github.com/USER/REPOSITORY.git"
    branch: "develop"
    repository-subdirectory: "denizen"
    target-directory: "scripts-staging"
    reload-denizen: false
    username: "gitizen"
    token-env: "GITIZEN_GITHUB_TOKEN"
    token: ""

当执行 sync production 时会发生什么

/gitizen sync production

Gitizen 将执行以下序列:

  1. Загрузит ветку main из указанного repo-url.
  2. Возьмёт только содержимое папки denizen из репозитория.
  3. Проверит найденные .dsc parser-ом Denizen.
  4. Подготовит новую версию во временной папке.
  5. Заменит plugins/Denizen/scripts.
  6. Перезагрузит Denizen, потому что указано reload-denizen: true.
  7. При ошибке автоматически вернёт предыдущие скрипты.

После успешной команды изменения становятся активными на игровом сервере.

Что произойдёт при sync staging

/gitizen sync staging

Gitizen загрузит ветку develop, проверит файлы и положит их в plugins/Denizen/scripts-staging. Рабочая папка plugins/Denizen/scripts при этом не изменяется, а Denizen продолжает исполнять текущую production-версию.

Профиль staging полезен, чтобы:

  • убедиться, что нужные файлы действительно загружаются из Git;
  • заранее проверить структуру .dsc;
  • посмотреть подготовленную версию на сервере;
  • не затронуть игроков во время подготовки релиза.

Важно: Gitizen не переносит staging в production автоматически. Обычный безопасный процесс выглядит так:

  1. Разработчик отправляет изменения в ветку develop.
  2. Администратор выполняет /gitizen sync staging и проверяет результат.
  3. Изменения объединяются из develop в main через GitHub.
  4. Администратор выполняет /gitizen sync production.

Staging-проверка подтверждает, что файлы читаются parser-ом, но не проверяет их поведение внутри игры: reload-denizen: false означает, что эти файлы не подключаются к работающему Denizen.

Разница между source и target

Эти два параметра часто путают:

  • repository-subdirectory — откуда брать файлы внутри Git-репозитория;
  • target-directory — куда помещать файлы на Minecraft-сервере.

Для приведённого примера путь выглядит так:

GitHub: REPOSITORY/denizen/
                   │
                   ├─ production → plugins/Denizen/scripts/
                   └─ staging    → plugins/Denizen/scripts-staging/

target-directory задаётся относительно plugins/Denizen:

Значение Полный путь на сервере
scripts plugins/Denizen/scripts
scripts-staging plugins/Denizen/scripts-staging
test/server-one plugins/Denizen/test/server-one

Указать ../ и выйти за пределы plugins/Denizen нельзя — Gitizen заблокирует такую конфигурацию.

Что означает reload-denizen

  • true — после замены файлов Gitizen просит Denizen загрузить новую версию. Используйте это для активного production-каталога.
  • false — файлы копируются и проверяются, но работающий Denizen их не загружает. Используйте это для staging, архива или ручной проверки.

Если указано reload-denizen: true, Gitizen сверяет target-directory с реальной активной папкой Denizen. При несовпадении deployment останавливается. Это защищает от ситуации, когда команда сообщает об успехе, но Denizen продолжает использовать другую папку.

Разные репозитории и токены

Профили не обязаны использовать один репозиторий. Например, production можно загружать из закрытого основного репозитория, а staging — из отдельного тестового. Для разных токенов укажите разные переменные окружения:

profiles:
  production:
    token-env: "GITIZEN_PRODUCTION_TOKEN"
  staging:
    token-env: "GITIZEN_STAGING_TOKEN"

default-profile: "production" означает, что команда /gitizen sync без имени профиля равнозначна /gitizen sync production.

Профиль можно создать командой:

/gitizen setup production https://github.com/USER/REPOSITORY.git main

После изменения repository-subdirectory, каталога или секретов выполните /gitizen reload.

Команды

Команда Описание Право
/gitizen help Показать доступные команды —
/gitizen sync [profile] Проверить и развернуть выбранную ветку gitizen.sync
/gitizen status [profile] Показать Git HEAD, remote HEAD и метрики gitizen.status
/gitizen rollback [profile] <номер|hash> Вернуть предыдущую версию gitizen.rollback
/gitizen logs [profile] [count] Показать последние commits gitizen.logs
/gitizen list [profile] Показать все .dsc рекурсивно gitizen.list
/gitizen profiles Показать настроенные профили gitizen.status
/gitizen setup <profile> <url> [branch] Создать или изменить профиль gitizen.admin
/gitizen reload Перечитать config.yml gitizen.admin

Если профиль не указан, используется default-profile.

Право gitizen.admin включает все остальные права.

Что показывает status

/gitizen status production выводит:

  • ветку профиля;
  • HEAD внутреннего checkout;
  • HEAD удалённой ветки;
  • commit, который сейчас развёрнут;
  • дату последнего успешного deployment;
  • количество успешных и неуспешных операций;
  • длительность и число файлов последней операции.

Если deployed commit отличается от remote HEAD, доступно обновление либо сейчас активен rollback.

Rollback

Вернуть deployment, который был перед текущим:

/gitizen rollback 1

То же для конкретного профиля:

/gitizen rollback production 1

Откатиться на конкретный commit:

/gitizen rollback production a1b2c3d

Число означает позицию среди предыдущих успешных deployment:

  • 1 — версия перед текущей;
  • 2 — ещё одна версия назад.

История хранится в plugins/Gitizen/state.yml. Её размер задаётся параметром deployment.max-history.

После ручного rollback команда /gitizen sync снова развернёт актуальный origin/<branch>.

Автоматический rollback

Перед заменой рабочей папки Gitizen проверяет staging-файлы parser-ом Denizen. После замены выполняется настоящий reload Denizen. Если Denizen сообщает об ошибке:

  1. Новая папка удаляется.
  2. Возвращается предыдущая папка.
  3. Возвращается предыдущий Git HEAD.
  4. Denizen повторно загружает восстановленные скрипты.
  5. Ошибка записывается в метрики и отправляется в настроенные уведомления.

Discord и Telegram

无需单独托管机器人或 Web 应用。Gitizen 直接从 Minecraft 服务器发送 HTTPS 请求。主机必须允许出站连接。

Discord

  1. 打开 Discord 服务器设置。
  2. 进入 Integrations → Webhooks。
  3. 创建一个 webhook 并复制 URL。
  4. 通过环境变量传递 URL:
GITIZEN_DISCORD_WEBHOOK=https://discord.com/api/webhooks/...

配置:

notifications:
  discord:
    webhook-url-env: "GITIZEN_DISCORD_WEBHOOK"
    webhook-url: ""

如果无法使用环境变量,可以将 URL 写入 webhook-url。

Telegram

  1. 通过 @BotFather 创建机器人。
  2. 向你的机器人发送任意消息。
  3. 获取用户、群组或频道的 ID。
  4. 将机器人添加到所需的群组/频道并授予必要的权限。
  5. 配置变量:
GITIZEN_TELEGRAM_BOT_TOKEN=123456:ABC...
GITIZEN_TELEGRAM_CHAT_ID=-1001234567890

配置:

notifications:
  telegram:
    bot-token-env: "GITIZEN_TELEGRAM_BOT_TOKEN"
    chat-id-env: "GITIZEN_TELEGRAM_CHAT_ID"
    bot-token: ""
    chat-id: ""

如果未收到通知,请检查 token、chat ID、机器人权限以及 Minecraft 主机对 api.telegram.org 的访问权限。

安全设置

security:
  require-https: true
  allowed-hosts:
    - "github.com"

validation:
  require-dsc-files: true
  max-script-size-kb: 1024

deployment:
  max-history: 20
  max-changes-in-chat: 30
  • require-https 禁止未加密和 SSH URL。
  • allowed-hosts 限制 Gitizen 可以传输 Git 凭据的服务器。
  • require-dsc-files 禁止在没有 Denizen 脚本的情况下进行部署。
  • max-script-size-kb 限制单个被检查脚本的大小。
  • max-history 定义回滚深度。
  • max-changes-in-chat 限制 Minecraft 聊天中显示的变更行数。

对于 GitHub Enterprise,将其域名添加到 allowed-hosts 中。

Denizen 仓库实际上包含可执行的服务器逻辑。仅向受信任的开发人员授予写入权限,并使用只读 PAT。

常见问题

“在 origin 中找不到分支”

检查 branch 的确切名称、大小写以及该分支是否存在于仓库中。

“主机不在 security.allowed-hosts 中”

将 Git 服务器的域名添加到 security.allowed-hosts。如果使用私有 token,请勿添加未知域名。

GitHub 授权错误

请检查:

  • URL 是否使用 HTTPS;
  • PAT 是否已过期;
  • PAT 是否具有所需仓库的 Contents: Read 权限;
  • 如果使用 SSO,组织是否已批准该 token;
  • 环境变量是否确实传递给了 Java 进程。

“target-directory 与 Denizen 活动目录不匹配”

对于配置了 reload-denizen: true 的配置文件,目录必须与实际使用的 Denizen 文件夹一致。通常是 plugins/Denizen/scripts,因此值应为 scripts。

部署在被激活前被拒绝

检查 Gitizen 的消息和控制台。可能的原因包括:空的 .dsc、YAML/Denizen 结构错误、文件过大、符号链接或缺少 .dsc。

通知未发送

确保主机允许以下服务的出站 HTTPS:

  • github.com;
  • discord.com;
  • api.telegram.org.

某些游戏面板需要单独授权外部连接。

旧版 config.yml

具有 repo-url、github-token 和 branch 键的旧版本配置会被读取为 production 配置文件。建议复制旧文件,删除它并重启服务器,然后将 URL、分支和 token 迁移到新结构中,以访问所有新设置。

服务文件

路径 用途
plugins/Gitizen/config.yml 用户自定义设置
plugins/Gitizen/state.yml 历史记录和指标
plugins/Gitizen/repositories/<profile> 内部 Git checkout
plugins/Denizen/scripts 活动的 production 脚本

请勿手动编辑内部 checkout。对活动目录的更改将在下次 sync 时被检测到并替换。


English

Gitizen safely deploys Denizen scripts from Git repositories directly to a Minecraft server. It fetches the configured branch, validates the candidate scripts, swaps the Denizen directory, and restores the previous version automatically when Denizen reports an error.

Features

  • Public and private GitHub repositories over HTTPS.
  • Multiple deployment profiles such as production and staging.
  • A separate repository, branch, source directory, and target for each profile.
  • Preflight validation using the parser of the installed Denizen plugin.
  • Staged directory replacement and automatic rollback.
  • Manual rollback by deployment number or commit hash.
  • Status command with repository, remote, deployment, and metrics information.
  • Persistent deployment history.
  • Discord and Telegram notifications.
  • Adventure components with hover details, hash copying, and GitHub links.
  • Per-profile operation lock and working-directory drift detection.

Git checkouts are stored under plugins/Gitizen/repositories. The active plugins/Denizen/scripts directory is not used as a Git repository.

Requirements

  • Paper 1.21.x.
  • Java 21 or newer.
  • Denizen installed and enabled.
  • Outbound HTTPS access to GitHub.
  • Outbound HTTPS access to Discord or Telegram when notifications are enabled.

Gitizen declares Denizen as a required dependency.

Installation

  1. Stop the Minecraft server.
  2. Copy Gitizen-1.0.0.jar to the plugins directory.
  3. Make sure Denizen is installed.
  4. Start the server once.
  5. Stop it and open plugins/Gitizen/config.yml.
  6. Configure the repository URL and branch.
  7. Configure a token if the repository is private.
  8. Start the server and run /gitizen status.
  9. Run /gitizen sync for the first deployment.

Create a manual backup of plugins/Denizen/scripts before the first installation. Gitizen protects the previous directory during later deployments.

Quick start

最小化公开仓库配置:

default-profile: "production"

profiles:
  production:
    repo-url: "https://github.com/USER/REPOSITORY.git"
    branch: "main"
    repository-subdirectory: ""
    target-directory: "scripts"
    reload-denizen: true
    username: "gitizen"
    token-env: "GITIZEN_GITHUB_TOKEN"
    token: ""

如果脚本存储在仓库的子目录中:

repository-subdirectory: "minecraft/denizen"

应用并部署:

/gitizen reload
/gitizen status production
/gitizen sync production

对于私有仓库,创建一个细粒度的 GitHub 个人访问令牌(Personal Access Token),权限要求如下: Contents: 对所需仓库的读取访问权限。建议使用环境变量:

GITIZEN_GITHUB_TOKEN=github_pat_...

如果您的托管面板不支持环境变量:

token-env: ""
token: "github_pat_..."

不要通过 Minecraft 命令发送令牌。/gitizen setup 故意不接受机密信息。

生产与暂存配置文件

配置文件是一种保存好的部署配方。它回答了五个问题:

  1. 应该获取哪个 Git 仓库?
  2. 应该使用哪个分支?
  3. 仓库内的哪个目录包含脚本?
  4. 应该将脚本发送到 Denizen 的哪个目录?
  5. 之后是否重新加载活动的 Denizen 脚本?

production 和 staging 并非特殊关键字。它们只是普通的配置文件名称。其行为由 branch、repository-subdirectory、target-directory 和 reload-denizen 决定。

默认工作流程如下:

配置文件 Git 分支 目标位置 Denizen 是否执行?
production main plugins/Denizen/scripts 是,在成功验证后
staging develop plugins/Denizen/scripts-staging 否,这是一个独立的测试副本
profiles:
  production:
    repo-url: "https://github.com/USER/REPOSITORY.git"
    branch: `main`
    repository-subdirectory: "denizen"
    target-directory: "scripts"
    reload-denizen: true
    username: "gitizen"
    token-env: "GITIZEN_GITHUB_TOKEN"
    token: ""

  staging:
    repo-url: "https://github.com/USER/REPOSITORY.git"
    branch: "develop"
    repository-subdirectory: "denizen"
    target-directory: "scripts-staging"
    reload-denizen: false
    username: "gitizen"
    token-env: "GITIZEN_GITHUB_TOKEN"
    token: ""

sync production 的作用

/gitizen sync production 获取 main 分支,读取仓库中的 denizen 目录,验证其 .dsc 文件,替换 plugins/Denizen/scripts,并重新加载 Denizen。如果重新加载报告错误,Gitizen 会自动恢复之前的目录。成功的生产部署将立即生效。

sync staging 的作用

/gitizen sync staging 获取 develop 分支,验证文件,并将它们写入 plugins/Denizen/scripts-staging。它不会修改 plugins/Denizen/scripts,Denizen 将继续运行当前的生产版本。

暂存环境用于检查下载的文件及其基本解析器兼容性,而不会影响玩家。它不会自动升级。典型的工作流程如下:

  1. 推送更改到 develop。
  2. 运行 /gitizen sync staging 并检查结果。
  3. 在 GitHub 上将 develop 合并到 main。
  4. 运行 /gitizen sync production。

由于暂存环境使用 reload-denizen: false,它不会测试实际的游戏内行为。

源目录和目标目录

  • repository-subdirectory 是 Git 仓库内部 的源目录。
  • target-directory 是 Minecraft 服务器 上的目标目录。
GitHub: REPOSITORY/denizen/
                   │
                   ├─ production → plugins/Denizen/scripts/
                   └─ staging    → plugins/Denizen/scripts-staging/

target-directory 相对于 plugins/Denizen。例如,scripts 意味着 plugins/Denizen/scripts。路径不能超出 Denizen 目录的范围。

reload-denizen

  • true 将已部署的文件加载到正在运行的 Denizen 实例中。请将其用于活动的生产目录。
  • false 仅复制并解析文件而不激活它们。请将其用于暂存或手动检查。

当重新加载启用时,Gitizen 会验证目标是否与 Denizen 的实际活动脚本目录匹配。如果不匹配,部署将被阻止,而不是报告虚假的成功。

配置文件可以使用不同的仓库、分支或凭据。如果需要单独的令牌,请为每个配置文件设置不同的 token-env 名称。

default-profile: "production" 使 /gitizen sync 等同于 /gitizen sync production。

在不暴露令牌的情况下创建或更新配置文件:

/gitizen setup production https://github.com/USER/REPOSITORY.git main

命令

命令 描述 权限
/gitizen help 显示可用命令 —
/gitizen sync [profile] 验证并部署配置的分支 gitizen.sync
/gitizen status [profile] 显示 Git 状态和部署指标 gitizen.status
/gitizen rollback [profile] <number|hash> 恢复之前的部署 gitizen.rollback
/gitizen logs [profile] [count] 显示最近的提交记录 gitizen.logs
/gitizen list [profile] 递归列出 .dsc 文件 gitizen.list
/gitizen profiles 显示已配置的配置文件 gitizen.status
/gitizen setup <profile> <url> [branch] 创建或更新配置文件 gitizen.admin
/gitizen reload 重新加载 config.yml gitizen.admin

当未指定配置文件时,将使用配置的 default-profile。 gitizen.admin 包含所有其他 Gitizen 权限。

回滚

恢复当前部署之前的状态:

/gitizen rollback 1

为特定配置文件恢复:

/gitizen rollback production 1

部署特定的提交:

/gitizen rollback production a1b2c3d

1 表示当前部署之前立即成功的一次部署;2 表示再往前一个版本。历史记录存储在 plugins/Gitizen/state.yml 中,并由 deployment.max-history 限制。

手动回滚后,/gitizen sync 会再次部署当前的远程分支。

对于自动回滚,Gitizen 首先验证暂存脚本,交换目录, 重新加载 Denizen,检查 Denizen 的错误标志,并在验证失败时恢复旧目录和 Git HEAD。

Discord 和 Telegram

无需单独托管。Gitizen 直接从 Minecraft 服务器发送 HTTPS 请求。您的提供商必须允许出站连接。

Discord 环境变量:

GITIZEN_DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
notifications:
  discord:
    webhook-url-env: "GITIZEN_DISCORD_WEBHOOK"
    webhook-url: ""

Telegram 环境变量:

GITIZEN_TELEGRAM_BOT_TOKEN=123456:ABC...
GITIZEN_TELEGRAM_CHAT_ID=-1001234567890
notifications:
  telegram:
    bot-token-env: "GITIZEN_TELEGRAM_BOT_TOKEN"
    chat-id-env: "GITIZEN_TELEGRAM_CHAT_ID"
    bot-token: ""
    chat-id: ""

对于 Telegram,使用 @BotFather 创建一个机器人,向其发送一条消息,确定 目标聊天 ID,并将机器人添加到所需的群组或频道中。

安全性

security:
  require-https: true
  allowed-hosts:
    - "github.com"

validation:
  require-dsc-files: true
  max-script-size-kb: 1024

deployment:
  max-history: 20
  max-changes-in-chat: 30
  • 保持启用 HTTPS 强制。
  • 将 allowed-hosts 限制为受信任的 Git 服务器。
  • 使用只读、仓库范围的令牌。
  • 仅向受信任的开发人员授予仓库写入权限。
  • 尽可能在托管环境变量中保存密钥。

使用 GitHub Enterprise 时,请显式添加主机名。

故障排除

在 origin 中找不到分支

检查确切的分支名称、大小写以及它是否在远程存在。

主机不在 security.allowed-hosts 中

将受信任的 Git 服务器主机名添加到 security.allowed-hosts。

GitHub 身份验证失败

验证 URL 是否使用 HTTPS,令牌是否未过期,是否具有 Contents: Read 权限,任何组织 SSO 要求是否已满足,并且环境变量是否到达了 Java 进程。

目标目录与 Denizen 的活动目录不匹配

具有 reload-denizen: true 的配置文件的配置文件必须指向 Denizen 的实际脚本文件夹。 对于默认的 Denizen 安装,请使用 target-directory: "scripts"。

激活前部署失败

检查 Gitizen 的消息和服务台控制台是否存在空的或无效的 .dsc、 文件过大、符号链接或缺少 Denizen 脚本。

通知未到达

确认凭据并确保托管提供商允许对 discord.com 或 api.telegram.org 的出站 HTTPS 访问。

迁移旧配置

旧的 repo-url、github-token 和 branch 键被读取为 production 配置文件。要使用所有新选项,请备份旧文件,重新生成 config.yml,并将仓库、分支和令牌复制到新的结构中。

数据文件

路径 用途
plugins/Gitizen/config.yml 用户配置
plugins/Gitizen/state.yml 部署历史和指标
plugins/Gitian/repositories/<profile> 内部 Git 检出
plugins/Denizen/scripts 活动的生产脚本

不要手动编辑内部检出。活动目标中的手动更改将在下次同步时被检测并替换。

从源代码构建

mvn clean verify

集成测试创建本地 Git 仓库并验证分支选择、 origin URL 更改、路径包含、更改检测和手动目标漂移。

许可证

MIT 许可证。版权所有 (c) 2026 Bloodulon。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源