hackdoc · pyquick · Aug 11, 2025 · Aug 11, 2025 · Aug 11, 2025 · Aug 12, 2025
diff --git a/.flake8 b/.flake8
@@ -0,0 +1,4 @@
+[flake8]
+extend-ignore = E501, E203
+per-file-ignores =
+    Resources/constants.py:E704
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -0,0 +1 @@
+open_collective: oclp-r
diff --git a/.github/workflows/build-app-wxpython.yml b/.github/workflows/build-app-wxpython.yml
@@ -0,0 +1,77 @@
+name: CI - Build wxPython
+
+on:
+  push:
+    paths-ignore:
+      - 'docs/**'
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build wxPython
+    runs-on: macos-26
+    if: github.repository_owner == 'hackdoc'
+    permissions:
+      contents: write
+    env:
+      # GitHub Information
+      branch: ${{ github.ref }}
+      commiturl: ${{ github.event.head_commit.url }}${{ github.event.release.html_url }}
+      commitdate: ${{ github.event.head_commit.timestamp }}${{ github.event.release.published_at }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Dependencies
+        run: |
+          rm -rf Univ*
+          rm -rf *pay*.dmg
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install -r requirements.txt
+
+      - name: Force Universal2 charset for Python
+        run: |
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip uninstall -y charset_normalizer
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip download --platform macosx_10_9_universal2 --only-binary=:all: charset-normalizer
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install charset_normalizer-*-macosx_10_9_universal2.whl
+
+      - name: Prepare Assets (--prepare-assets)
+
+        run: >
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 Build-Project.command
+          --run-as-individual-steps
+          --prepare-assets
+
+      - name: Prepare Application (--prepare-application)
+        run: >
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 Build-Project.command
+          --git-branch "${{ env.branch }}" --git-commit-url "${{ env.commiturl }}" --git-commit-date "${{ env.commitdate }}"
+          --reset-pyinstaller-cache
+          --run-as-individual-steps
+          --prepare-application
+
+      - name: Prepare Package (--prepare-package)
+        run: >
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 Build-Project.command
+          --prepare-package
+      - name: Delete previous pre-release
+        if: github.event_name == 'push'
+        uses: dev-drprasad/[email protected]
+        with:
+          keep_latest: 0
+          delete_prerelease_only: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Create Pre-Release on Push
+        if: github.event_name == 'push'
+        uses: softprops/action-gh-release@v2
+        with:
+          #tag_name: push-${{ github.sha }}
+          tag_name: 3.0.1
+          name: 3.0.1 Tahoe Test
+          body: ${{ github.event.head_commit.message }}
+          prerelease: true
+          files: |
+            ./dist/AutoPkg-Assets.pkg
+            ./dist/OCLP-R.pkg
+            ./dist/OCLP-R-Uninstaller.pkg
diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
@@ -0,0 +1,25 @@
+name: CI - Validation
+on:
+  push:
+    paths-ignore: 
+      - 'docs/**'
+  workflow_dispatch:
+  release:
+    types: [published]
+jobs:
+  build:
+    name: Validate
+    runs-on: macOS-26
+    if: github.repository_owner == 'hackdoc'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - name: Validate
+        run: |
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install --upgrade pip
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install -r requirements.txt
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install packaging
+          /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 OCLP-R-GUI.command --validate
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,43 @@
+.DS_Store
+OCLP-GUI.command
+/payloads/Apple
+/payloads/*.zip
+/payloads/BuildManifest.plist
+/payloads/*.sucatalog
+/payloads/*.pkg
+/payloads/__MACOSX
+/App
+/Build-Folder
+/build
+/dist
+/.vscode
+__pycache__/
+*.kext
+*.py[cod]
+*$py.class
+/docs/.vuepress/dist
+/docs/.vuepress/.config.js.swp
+/docs/yarn-error.log
+/docs/node_modules/
+/payloads/List.txt
+/payloads/Installer.sh
+/payloads/Info.plist
+/payloads/seed.plist
+/payloads/AutoPkg-Assets.pkg
+/payloads/AutoPkg-Assets.pkg.zip
+/payloads/Universal-Binaries
+/payloads/OpenCore-Legacy-Patcher
+/payloads/InstallAssistant.pkg.integrityDataV1
+/payloads.dmg
+/Universal-Binaries.dmg
+/payloads/OpenCore-Legacy-Patcher-*.plist
+/payloads/KDK.dmg
+*.log
+/Universal-Binaries.dmg
+/payloads/KDKInfo.plist
+/payloads/update.sh
+/payloads/OpenCore-Patcher.app
+/.x86_64_venv
+*afdesign~lock~
+main.py
+/.idea
diff --git a/.pylintrc b/.pylintrc
@@ -0,0 +1,13 @@
+[MASTER]
+
+init-hook="from pylint.config import find_pylintrc; import os, sys; sys.path.append(os.path.dirname(find_pylintrc()))"
+
+[MESSAGES CONTROL]
+
+disable=unused-import,
+        subprocess-run-check,
+        line-too-long,
+        too-few-public-methods,
+        missing-module-docstring,
+        missing-class-docstring,
+        missing-function-docstring
diff --git a/.trae/documents/为support文件夹中的文件配置翻译.md b/.trae/documents/为support文件夹中的文件配置翻译.md
@@ -0,0 +1,41 @@
+# 为support文件夹中的文件配置翻译
+
+## 目标
+为support文件夹中所有未配置翻译的文件创建对应的翻译函数，每个文件对应一个翻译函数。
+
+## 已完成的翻译函数
+- arguements.py → arguements()
+- defaults.py → defaults()
+- generate_smbios.py → generate_smbios()
+- global_settings.py → global_settings()
+- install.py → install()
+- integrity_verification.py → integrity_verification()
+- kdk_handler.py → kdk_handler()
+
+## 需要添加的翻译函数
+1. analytics_handler.py → analytics_handler()
+2. commit_info.py → commit_info()
+3. logging_handler.py → logging_handler()
+4. macos_installer_handler.py → macos_installer_handler()
+5. metallib_handler.py → metallib_handler()
+6. network_handler.py → network_handler()
+7. private.py → private()
+8. reroute_payloads.py → reroute_payloads()
+9. subprocess_wrapper.py → subprocess_wrapper()
+10. updates.py → updates()
+11. utilities.py → utilities()
+12. validation.py → validation()
+
+## 实现步骤
+1. 为每个需要翻译的文件创建一个对应的翻译函数
+2. 每个翻译函数包含英文和中文两种语言的翻译字典
+3. 翻译字典包含该文件中所有需要翻译的文本
+4. 保持与现有翻译函数相同的格式和结构
+
+## 注意事项
+- 每个翻译函数的命名格式为：`def 文件名():`
+- 翻译字典中键为英文文本，值为对应语言的翻译
+- 对于中文语言点(language_point==0)，提供中文翻译
+- 对于英文语言点(language_point==1)，保持英文原文
+- 确保所有需要翻译的文本都被包含在翻译字典中
+- 保持代码格式一致，使用相同的缩进和换行格式
diff --git a/Build-Project.command b/Build-Project.command
@@ -0,0 +1,135 @@
+#!/usr/bin/env python3
+"""
+Build-Project.command: Generate OCLP-R.app and OCLP-R.pkg
+"""
+
+import os
+import sys
+import time
+import argparse
+
+from pathlib import Path
+
+from ci_tooling.build_modules import (
+    application,
+    disk_images,
+    package,
+    sign_notarize
+)
+
+
+def main() -> None:
+    """
+    Parse Command Line Arguments
+    """
+
+    parser = argparse.ArgumentParser(description="Build OCLP-R Suite", add_help=False)
+
+    # Signing Parameters
+    parser.add_argument("--application-signing-identity", type=str, help="Application Signing Identity")
+    parser.add_argument("--installer-signing-identity", type=str, help="Installer Signing Identity")
+
+
+    # Notarization Parameters
+    parser.add_argument("--notarization-apple-id", type=str, help="Notarization Apple ID", default=None)
+    parser.add_argument("--notarization-password", type=str, help="Notarization Password", default=None)
+    parser.add_argument("--notarization-team-id", type=str, help="Notarization Team ID", default=None)
+
+    # GitHub Actions CI/CD Parameters
+    parser.add_argument("--git-branch", type=str, help="Git Branch", default=None)
+    parser.add_argument("--git-commit-url", type=str, help="Git Commit URL", default=None)
+    parser.add_argument("--git-commit-date", type=str, help="Git Commit Date", default=None)
+
+    # Local Build Parameters
+    parser.add_argument("--reset-dmg-cache", action="store_true", help="Redownload PatcherSupportPkg.dmg and regenerate payloads.dmg", default=False)
+    parser.add_argument("--reset-pyinstaller-cache", action="store_true", help="Clean PyInstaller Cache", default=False)
+
+    # CI/CD Parameters for individual steps
+    # If not specified, will run all steps
+    parser.add_argument("--run-as-individual-steps", action="store_true", help="CI: Run as individual steps", default=False)
+    parser.add_argument("--prepare-application", action="store_true", help="CI: Prepare Application", default=False)
+    parser.add_argument("--prepare-package", action="store_true", help="CI: Prepare Package", default=False)
+    parser.add_argument("--prepare-assets", action="store_true", help="CI: Prepare Assets", default=False)
+
+    # Analytics Parameters
+    parser.add_argument("--analytics-key", type=str, help="Analytics Key", default=None)
+    parser.add_argument("--analytics-endpoint", type=str, help="Analytics Endpoint", default=None)
+
+    # Help
+    parser.add_argument("--help", action="store_true", help="Show this help message and exit", default=False)
+
+    # Parse Arguments
+    args = parser.parse_args()
+
+    if args.help:
+        parser.print_help()
+        print("\n\nIf running outside of CI/CD, simply run the following command:")
+        print("$ python3 Build-Project.command")
+        sys.exit(0)
+
+    # Set 'Current Working Directory' to script directory
+    os.chdir(Path(__file__).resolve().parent)
+
+
+    if (args.run_as_individual_steps is False) or (args.run_as_individual_steps and args.prepare_assets):
+        # Prepare workspace
+        disk_images.GenerateDiskImages(args.reset_dmg_cache).generate()
+
+    if (args.run_as_individual_steps is False) or (args.run_as_individual_steps and args.prepare_application):
+        # Prepare Privileged Helper Tool
+        sign_notarize.SignAndNotarize(
+            path=Path("./ci_tooling/privileged_helper_tool/com.hackdoc.oclp-r.privileged-helper"),
+            signing_identity=args.application_signing_identity,
+            notarization_apple_id=args.notarization_apple_id,
+            notarization_password=args.notarization_password,
+            notarization_team_id=args.notarization_team_id,
+        ).sign_and_notarize()
+
+        # Build OCLP-R.app
+        application.GenerateApplication(
+            reset_pyinstaller_cache=args.reset_pyinstaller_cache,
+            git_branch=args.git_branch,
+            git_commit_url=args.git_commit_url,
+            git_commit_date=args.git_commit_date,
+            analytics_key=args.analytics_key,
+            analytics_endpoint=args.analytics_endpoint,
+        ).generate()
+
+        # Sign OCLP-R.app
+        sign_notarize.SignAndNotarize(
+            path=Path("dist/OCLP-R.app"),
+            signing_identity=args.application_signing_identity,
+            notarization_apple_id=args.notarization_apple_id,
+            notarization_password=args.notarization_password,
+            notarization_team_id=args.notarization_team_id,
+            entitlements=Path("./ci_tooling/entitlements/entitlements.plist"),
+        ).sign_and_notarize()
+
+
+    if (args.run_as_individual_steps is False) or (args.run_as_individual_steps and args.prepare_package):
+        # Build OCLP-R.pkg and OCLP-R-Uninstaller.pkg
+        package.GeneratePackage().generate()
+
+        # Sign OCLP-R.pkg
+        sign_notarize.SignAndNotarize(
+            path=Path("dist/OCLP-R.pkg"),
+            signing_identity=args.installer_signing_identity,
+            notarization_apple_id=args.notarization_apple_id,
+            notarization_password=args.notarization_password,
+            notarization_team_id=args.notarization_team_id,
+        ).sign_and_notarize()
+
+        # Sign OCLP-R-Uninstaller.pkg
+        sign_notarize.SignAndNotarize(
+            path=Path("dist/OCLP-R-Uninstaller.pkg"),
+            signing_identity=args.installer_signing_identity,
+            notarization_apple_id=args.notarization_apple_id,
+            notarization_password=args.notarization_password,
+            notarization_team_id=args.notarization_team_id,
+        ).sign_and_notarize()
+
+
+if __name__ == '__main__':
+    _start = time.time()
+    main()
+    print(f"Build script completed in {str(round(time.time() - _start, 2))} seconds")
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# Auto detect text files and perform LF normalization
		* text=auto