社区候选库使用锁定但未签名的 Packages.gz 元数据，仅用于展示 provenance；候选包全部不可选，生产构建不会克隆或执行该 feed，也不会下载或安装 dl.openwrt.ai 的 IPK。
-
diff --git a/site/styles.css b/site/styles.css
index 4a391d4..2daaad1 100644
--- a/site/styles.css
+++ b/site/styles.css
@@ -410,6 +410,7 @@ footer p { margin: 0; text-align: center; }
.package-option-blocked:hover { border-color: #303940; }
.package-blocked-reason { color: #ffaaa4 !important; }
.component-purpose { color: #d8e0e4 !important; line-height: 1.55; }
+.component-upstream-description { color: #87939b !important; font-size: .7rem; line-height: 1.5; }
.component-package-list { color: var(--muted); overflow-wrap: anywhere; }
.package-pagination {
display: flex;
diff --git a/tests/test_component_catalog_staging.py b/tests/test_component_catalog_staging.py
index 4220705..be507d6 100755
--- a/tests/test_component_catalog_staging.py
+++ b/tests/test_component_catalog_staging.py
@@ -18,6 +18,7 @@
ROOT = Path(__file__).resolve().parent.parent
VALIDATOR = ROOT / "scripts" / "validate-component-catalogs.py"
SOURCE_COMPONENTS = ROOT / "components"
+PURPOSE_MODULE = ROOT / "scripts" / "package_purpose_zh.py"
def canonical(value: Any) -> bytes:
@@ -47,8 +48,14 @@ def setUpClass(cls) -> None:
resolver = importlib.util.module_from_spec(spec)
spec.loader.exec_module(resolver)
requires_arch = "arch" in resolver.PACKAGE_RECORD_KEYS
+ purpose_spec = importlib.util.spec_from_file_location("staging_test_purpose", PURPOSE_MODULE)
+ if purpose_spec is None or purpose_spec.loader is None:
+ raise RuntimeError("unable to load purpose catalog contract for staging tests")
+ purpose = importlib.util.module_from_spec(purpose_spec)
+ purpose_spec.loader.exec_module(purpose)
index = load_json(SOURCE_COMPONENTS / "package-catalog.json")
+ purpose_records: dict[str, list[dict[str, Any]]] = {}
for descriptor in index["shards"]:
source = ROOT / descriptor["path"]
shard = load_json(source)
@@ -88,6 +95,16 @@ def setUpClass(cls) -> None:
descriptor["sha256"] = hashlib.sha256(raw).hexdigest()
descriptor["package_count"] = len(selected_records)
descriptor["selectable_count"] = sum(int(record["selectable"]) for record in selected_records)
+ purpose_records[f"{descriptor['target']}/{descriptor['flavor']}"] = selected_records
+ purpose_payload = purpose.build_purpose_catalog(purpose_records, index["catalog_version"])
+ purpose_raw = purpose.canonical_json(purpose_payload)
+ (cls.baseline_components / "package-purpose-zh.json").write_bytes(purpose_raw)
+ index["purpose_catalog"] = {
+ "locale": "zh-CN",
+ "path": "components/package-purpose-zh.json",
+ "sha256": hashlib.sha256(purpose_raw).hexdigest(),
+ "package_count": purpose_payload["package_count"],
+ }
(cls.baseline_components / "package-catalog.json").write_bytes(canonical(index))
@classmethod
@@ -181,6 +198,10 @@ def test_valid_fixture_is_staged_one_shard_at_a_time(self) -> None:
(staged / "package-catalog.json").read_bytes(),
(components / "package-catalog.json").read_bytes(),
)
+ self.assertEqual(
+ (staged / "package-purpose-zh.json").read_bytes(),
+ (components / "package-purpose-zh.json").read_bytes(),
+ )
finally:
temporary.cleanup()
@@ -197,7 +218,7 @@ def test_rejects_duplicate_json_key(self) -> None:
def mutation(components: Path) -> None:
path = components / "package-catalog.json"
raw = path.read_text(encoding="utf-8")
- needle = '"schema_version":2'
+ needle = '"schema_version":3'
self.assertIn(needle, raw)
path.write_text(raw.replace(needle, f"{needle},{needle}", 1), encoding="utf-8")
@@ -349,6 +370,55 @@ def reclassify(shard: dict[str, Any]) -> None:
),
)
+ def test_rejects_missing_purpose_catalog(self) -> None:
+ self.assert_rejected(
+ "missing purpose catalog",
+ lambda components: (components / "package-purpose-zh.json").unlink(),
+ )
+
+ def test_rejects_purpose_catalog_sha_mismatch(self) -> None:
+ def mutation(components: Path) -> None:
+ with (components / "package-purpose-zh.json").open("ab") as handle:
+ handle.write(b" ")
+
+ self.assert_rejected("purpose catalog SHA mismatch", mutation)
+
+ def test_rejects_missing_purpose_entry_even_with_updated_sha(self) -> None:
+ def mutation(components: Path) -> None:
+ purpose_path = components / "package-purpose-zh.json"
+ payload = load_json(purpose_path)
+ payload["purposes"].pop(next(iter(payload["purposes"])))
+ payload["package_count"] -= 1
+ quality = next(name for name, count in payload["quality_counts"].items() if count)
+ payload["quality_counts"][quality] -= 1
+ raw = canonical(payload)
+ purpose_path.write_bytes(raw)
+ index_path = components / "package-catalog.json"
+ index = load_json(index_path)
+ index["purpose_catalog"]["sha256"] = hashlib.sha256(raw).hexdigest()
+ index["purpose_catalog"]["package_count"] = payload["package_count"]
+ index_path.write_bytes(canonical(index))
+
+ self.assert_rejected("missing purpose entry", mutation)
+
+ def test_rejects_symlinked_purpose_catalog(self) -> None:
+ def mutation(components: Path) -> None:
+ source = components / "package-purpose-zh.json"
+ victim = components.parent / "purpose-victim.json"
+ source.replace(victim)
+ source.symlink_to(victim)
+
+ self.assert_rejected("symlinked purpose catalog", mutation)
+
+ def test_rejects_hardlinked_purpose_catalog(self) -> None:
+ def mutation(components: Path) -> None:
+ source = components / "package-purpose-zh.json"
+ victim = components.parent / "purpose-hardlink-victim.json"
+ source.replace(victim)
+ os.link(victim, source)
+
+ self.assert_rejected("hardlinked purpose catalog", mutation)
+
def test_rejects_hardlinked_source_shard(self) -> None:
def mutation(components: Path) -> None:
source = components / "packages" / "x86_64-official.json"
diff --git a/tests/test_package_catalog.py b/tests/test_package_catalog.py
index 1e45e2a..fceb3a8 100755
--- a/tests/test_package_catalog.py
+++ b/tests/test_package_catalog.py
@@ -18,6 +18,7 @@
RESOLVER_PATH = ROOT / "scripts" / "resolve-components.py"
GENERATOR_PATH = ROOT / "scripts" / "generate-package-catalog.py"
POLICY_PATH = ROOT / "scripts" / "component_package_policy.py"
+PURPOSE_PATH = ROOT / "scripts" / "package_purpose_zh.py"
def load_module(name: str, path: Path):
@@ -32,11 +33,12 @@ def load_module(name: str, path: Path):
resolver = load_module("package_catalog_resolver", RESOLVER_PATH)
generator = load_module("package_catalog_generator", GENERATOR_PATH)
policy = load_module("component_package_policy_test", POLICY_PATH)
+purpose = load_module("package_purpose_zh_test", PURPOSE_PATH)
catalog = resolver.load_catalog()
index = resolver.load_package_catalog_index(catalog)
-assert set(index) == {"schema_version", "catalog_version", "openwrt_version", "shards"}
-assert index["schema_version"] == 2
+assert set(index) == {"schema_version", "catalog_version", "openwrt_version", "purpose_catalog", "shards"}
+assert index["schema_version"] == 3
assert index["catalog_version"] == "2026.07.21.1"
assert index["openwrt_version"] == "25.12.5"
assert [(item["target"], item["flavor"]) for item in index["shards"]] == [
@@ -50,7 +52,8 @@ def load_module(name: str, path: Path):
"components/packages/xiaomi_ax9000-nss.json",
]
-ROOT_KEYS = {"schema_version", "catalog_version", "openwrt_version", "shards"}
+ROOT_KEYS = {"schema_version", "catalog_version", "openwrt_version", "purpose_catalog", "shards"}
+PURPOSE_DESCRIPTOR_KEYS = {"locale", "path", "sha256", "package_count"}
DESCRIPTOR_KEYS = {
"target", "flavor", "path", "sha256", "package_count", "selectable_count", "sources"
}
@@ -67,8 +70,19 @@ def load_module(name: str, path: Path):
TOKEN_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$")
SHA_RE = re.compile(r"^[0-9a-f]{64}$")
assert set(json.loads((ROOT / "components/package-catalog.json").read_text())) == ROOT_KEYS
+purpose_descriptor = index["purpose_catalog"]
+assert set(purpose_descriptor) == PURPOSE_DESCRIPTOR_KEYS
+assert purpose_descriptor["locale"] == "zh-CN"
+assert purpose_descriptor["path"] == "components/package-purpose-zh.json"
+assert SHA_RE.fullmatch(purpose_descriptor["sha256"])
+purpose_path = ROOT / purpose_descriptor["path"]
+purpose_raw = purpose_path.read_bytes()
+assert hashlib.sha256(purpose_raw).hexdigest() == purpose_descriptor["sha256"]
+purpose_payload = json.loads(purpose_raw)
+assert purpose_raw == purpose.canonical_json(purpose_payload)
shards = {}
+all_purpose_keys = set()
for descriptor in index["shards"]:
assert set(descriptor) == DESCRIPTOR_KEYS
assert SHA_RE.fullmatch(descriptor["sha256"])
@@ -151,8 +165,16 @@ def load_module(name: str, path: Path):
if record["package"].startswith("kmod-"):
assert descriptor["flavor"] == "official"
assert record["risk"] == "advanced"
+ all_purpose_keys.add(f"{record['source']}/{record['package']}")
shards[(descriptor["target"], descriptor["flavor"])] = shard
+purpose.validate_purpose_catalog(
+ purpose_payload, index["catalog_version"], expected_keys=all_purpose_keys
+)
+assert purpose_payload["package_count"] == purpose_descriptor["package_count"]
+assert purpose_payload["package_count"] == len(all_purpose_keys)
+assert sum(purpose_payload["quality_counts"].values()) == len(all_purpose_keys)
+
x86 = shards[("x86_64", "official")]
ax_official = shards[("xiaomi_ax9000", "official")]
ax_nss = shards[("xiaomi_ax9000", "nss")]
@@ -496,7 +518,7 @@ def expect_generation_rejected(operation, label: str) -> None:
victim = root / "victim.json"
victim.write_text("do-not-overwrite", encoding="utf-8")
(root / "components/package-catalog.json").symlink_to(victim)
- expect_generation_rejected(lambda: generator._write_catalog(root, []), "target symlink")
+ expect_generation_rejected(lambda: generator._write_catalog(root, [], {"locale": "zh-CN", "path": "components/package-purpose-zh.json", "sha256": "0" * 64, "package_count": 1}), "target symlink")
assert victim.read_text(encoding="utf-8") == "do-not-overwrite"
with tempfile.TemporaryDirectory() as temporary:
@@ -505,7 +527,7 @@ def expect_generation_rejected(operation, label: str) -> None:
victim = root / "victim.json"
victim.write_text("do-not-replace", encoding="utf-8")
os.link(victim, root / "components/package-catalog.json")
- expect_generation_rejected(lambda: generator._write_catalog(root, []), "target hard link")
+ expect_generation_rejected(lambda: generator._write_catalog(root, [], {"locale": "zh-CN", "path": "components/package-purpose-zh.json", "sha256": "0" * 64, "package_count": 1}), "target hard link")
assert victim.read_text(encoding="utf-8") == "do-not-replace"
with tempfile.TemporaryDirectory() as temporary:
@@ -524,7 +546,7 @@ def expect_generation_rejected(operation, label: str) -> None:
with tempfile.TemporaryDirectory() as temporary:
root = Path(temporary)
(root / "components/package-catalog.json").mkdir(parents=True)
- expect_generation_rejected(lambda: generator._write_catalog(root, []), "directory target")
+ expect_generation_rejected(lambda: generator._write_catalog(root, [], {"locale": "zh-CN", "path": "components/package-purpose-zh.json", "sha256": "0" * 64, "package_count": 1}), "directory target")
# Archive member validation permits only directories and ordinary files.
assert generator._validate_archive_members(
diff --git a/tests/test_package_purpose_zh.py b/tests/test_package_purpose_zh.py
new file mode 100755
index 0000000..c33f913
--- /dev/null
+++ b/tests/test_package_purpose_zh.py
@@ -0,0 +1,332 @@
+#!/usr/bin/env python3
+"""Tests for the deterministic Chinese OpenWrt package-purpose catalog."""
+
+from __future__ import annotations
+
+import copy
+import glob
+import hashlib
+import json
+import os
+import re
+import subprocess
+import sys
+import tempfile
+import unicodedata
+import unittest
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+SCRIPTS = ROOT / "scripts"
+if str(SCRIPTS) not in sys.path:
+ sys.path.insert(0, str(SCRIPTS))
+
+import package_purpose_zh as generator
+
+CHINESE_RE = re.compile(r"[\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff]")
+
+
+def current_catalog_facts() -> tuple[str, set[str]]:
+ versions: set[str] = set()
+ keys: set[str] = set()
+ for shard_name in sorted(glob.glob(str(ROOT / "components" / "packages" / "*.json"))):
+ payload = json.loads(Path(shard_name).read_text(encoding="utf-8"))
+ versions.add(payload["catalog_version"])
+ keys.update(f"{record['source']}/{record['package']}" for record in payload["packages"])
+ if len(versions) != 1:
+ raise AssertionError(f"test fixtures have inconsistent catalog versions: {versions}")
+ return next(iter(versions)), keys
+
+
+class PackagePurposeZhTest(unittest.TestCase):
+ @classmethod
+ def setUpClass(cls) -> None:
+ cls.catalog_version, cls.expected_keys = current_catalog_facts()
+ cls.records_by_shard, loaded_version = generator.load_package_shards(
+ ROOT / "components"
+ )
+ if loaded_version != cls.catalog_version:
+ raise AssertionError("loader returned an unexpected catalog version")
+ cls.payload = generator.build_purpose_catalog(
+ cls.records_by_shard, cls.catalog_version
+ )
+
+ def test_fixed_schema_and_all_unique_packages_are_covered(self) -> None:
+ payload = self.payload
+ self.assertEqual(
+ list(payload),
+ [
+ "schema_version",
+ "catalog_version",
+ "package_count",
+ "quality_counts",
+ "purposes",
+ ],
+ )
+ self.assertEqual(payload["schema_version"], 1)
+ self.assertEqual(payload["catalog_version"], self.catalog_version)
+ self.assertEqual(
+ set(payload["quality_counts"]), {"exact", "family", "category"}
+ )
+ self.assertEqual(payload["package_count"], len(self.expected_keys))
+ self.assertEqual(set(payload["purposes"]), self.expected_keys)
+ self.assertEqual(list(payload["purposes"]), sorted(self.expected_keys))
+ self.assertGreaterEqual(payload["quality_counts"]["exact"], generator.MIN_EXACT_PURPOSES)
+ self.assertLessEqual(
+ payload["quality_counts"]["category"] / payload["package_count"],
+ generator.MAX_CATEGORY_SHARE,
+ )
+ generator.validate_purpose_catalog(
+ payload, self.catalog_version, self.expected_keys
+ )
+
+ def test_every_purpose_is_nonempty_chinese_and_control_free(self) -> None:
+ for key, entry in self.payload["purposes"].items():
+ with self.subTest(package=key):
+ self.assertEqual(set(entry), {"purpose", "quality"})
+ self.assertTrue(entry["purpose"].strip())
+ self.assertRegex(entry["purpose"], CHINESE_RE)
+ self.assertFalse(
+ any(
+ unicodedata.category(character) in {"Cc", "Cf"}
+ for character in entry["purpose"]
+ )
+ )
+ self.assertIn(entry["quality"], {"exact", "family", "category"})
+
+ def test_common_packages_have_reviewed_exact_meanings(self) -> None:
+ expectations = {
+ "official/base-files": ("基础文件系统", "OpenWrt"),
+ "official/luci-app-firewall": ("防火墙", "LuCI"),
+ "official/wireguard-tools": ("WireGuard", "VPN"),
+ "official/adguardhome": ("DNS", "广告"),
+ "official/samba4-server": ("SMB", "文件共享"),
+ "official/dockerd": ("Docker", "容器引擎"),
+ "official/collectd": ("指标", "监控"),
+ }
+ for key, words in expectations.items():
+ with self.subTest(package=key):
+ entry = self.payload["purposes"][key]
+ self.assertEqual(entry["quality"], "exact")
+ for word in words:
+ self.assertIn(word, entry["purpose"])
+
+ def test_named_families_use_family_quality(self) -> None:
+ examples = {
+ "official/luci-i18n-base-zh-cn": "翻译",
+ "official/luci-app-acme": "LuCI",
+ "official/luci-proto-autoip": "接口类型",
+ "official/kmod-bluetooth": "内核模块",
+ "official/libarchive": "共享库",
+ "official/python3-asyncio": "Python 3",
+ "official/perl-cgi": "Perl",
+ "official/ruby-json": "Ruby",
+ "official/php8-mod-curl": "PHP",
+ "official/collectd-mod-cpu": "collectd",
+ }
+ for key, expected_text in examples.items():
+ with self.subTest(package=key):
+ self.assertIn(key, self.payload["purposes"])
+ entry = self.payload["purposes"][key]
+ self.assertEqual(entry["quality"], "family")
+ self.assertIn(expected_text, entry["purpose"])
+ translation = self.payload["purposes"]["official/luci-i18n-base-zh-cn"]["purpose"]
+ self.assertIn("base", translation)
+ self.assertIn("zh-cn", translation)
+ self.assertNotIn("base-zh", translation)
+
+ def test_canonical_json_is_stable_and_utf8(self) -> None:
+ first = generator.canonical_json(self.payload)
+ reordered = {
+ "purposes": self.payload["purposes"],
+ "quality_counts": {
+ "category": self.payload["quality_counts"]["category"],
+ "family": self.payload["quality_counts"]["family"],
+ "exact": self.payload["quality_counts"]["exact"],
+ },
+ "package_count": self.payload["package_count"],
+ "catalog_version": self.payload["catalog_version"],
+ "schema_version": self.payload["schema_version"],
+ }
+ self.assertEqual(first, generator.canonical_json(reordered))
+ self.assertIn("基础文件系统".encode("utf-8"), first)
+ self.assertTrue(first.endswith(b"\n"))
+
+ def test_build_is_independent_of_shard_and_record_order(self) -> None:
+ reversed_shards = {
+ shard: list(reversed(self.records_by_shard[shard]))
+ for shard in reversed(list(self.records_by_shard))
+ }
+ rebuilt = generator.build_purpose_catalog(
+ reversed_shards, self.catalog_version
+ )
+ self.assertEqual(
+ generator.canonical_json(self.payload),
+ generator.canonical_json(rebuilt),
+ )
+
+ def test_generation_is_byte_for_byte_deterministic(self) -> None:
+ with tempfile.TemporaryDirectory() as directory:
+ first = Path(directory) / "first.json"
+ second = Path(directory) / "second.json"
+ command = [
+ sys.executable,
+ str(SCRIPTS / "package_purpose_zh.py"),
+ "--components-root",
+ str(ROOT / "components"),
+ ]
+ subprocess.run(command + ["--output", str(first)], check=True)
+ subprocess.run(command + ["--output", str(second)], check=True)
+ self.assertEqual(first.read_bytes(), second.read_bytes())
+ self.assertEqual(
+ first.read_bytes(),
+ (ROOT / "components" / "package-purpose-zh.json").read_bytes(),
+ "committed purpose catalog differs from the current deterministic generator",
+ )
+ generated = json.loads(first.read_text(encoding="utf-8"))
+ generator.validate_purpose_catalog(
+ generated, self.catalog_version, self.expected_keys
+ )
+
+ def test_browser_text_boundaries_and_index_update_contract(self) -> None:
+ sample_key = next(iter(self.payload["purposes"]))
+ for length in (generator.MAX_PURPOSE_LENGTH - 1, generator.MAX_PURPOSE_LENGTH):
+ payload = copy.deepcopy(self.payload)
+ payload["purposes"][sample_key]["purpose"] = "中" * length
+ generator.validate_purpose_catalog(payload, self.catalog_version, self.expected_keys)
+
+ compatibility = copy.deepcopy(self.payload)
+ compatibility["purposes"][sample_key]["purpose"] = "兼容汉字：豈"
+ generator.validate_purpose_catalog(compatibility, self.catalog_version, self.expected_keys)
+
+ with tempfile.TemporaryDirectory() as directory:
+ index_path = Path(directory) / "package-catalog.json"
+ index = json.loads((ROOT / "components" / "package-catalog.json").read_text(encoding="utf-8"))
+ index["purpose_catalog"]["sha256"] = "0" * 64
+ index["purpose_catalog"]["package_count"] = 1
+ index_path.write_text(
+ json.dumps(index, ensure_ascii=False, sort_keys=True, separators=(",", ":")) + "\n",
+ encoding="utf-8",
+ )
+ purpose_bytes = generator.canonical_json(self.payload)
+ generator.update_package_index_descriptor(index_path, self.payload, purpose_bytes)
+ updated = json.loads(index_path.read_text(encoding="utf-8"))
+ self.assertEqual(updated["purpose_catalog"]["package_count"], self.payload["package_count"])
+ self.assertEqual(
+ updated["purpose_catalog"]["sha256"], hashlib.sha256(purpose_bytes).hexdigest()
+ )
+
+ def test_update_index_cli_validates_before_writing_sidecar(self) -> None:
+ with tempfile.TemporaryDirectory() as directory:
+ components = Path(directory) / "components"
+ packages = components / "packages"
+ packages.mkdir(parents=True)
+ for shard in sorted((ROOT / "components" / "packages").glob("*.json")):
+ (packages / shard.name).write_bytes(shard.read_bytes())
+ output = components / "package-purpose-zh.json"
+ original_sidecar = b"sentinel-sidecar\n"
+ output.write_bytes(original_sidecar)
+ (components / "package-catalog.json").write_text(
+ '{"schema_version":2}\n', encoding="utf-8"
+ )
+ result = subprocess.run(
+ [
+ sys.executable,
+ str(SCRIPTS / "package_purpose_zh.py"),
+ "--components-root",
+ str(components),
+ "--output",
+ str(output),
+ "--update-index",
+ ],
+ capture_output=True,
+ text=True,
+ check=False,
+ )
+ self.assertEqual(result.returncode, 2)
+ self.assertIn("exact schema_version 3 contract", result.stderr)
+ self.assertEqual(output.read_bytes(), original_sidecar)
+
+ valid_index = (ROOT / "components" / "package-catalog.json").read_bytes()
+ real_index = components / "real-package-catalog.json"
+ real_index.write_bytes(valid_index)
+ index_path = components / "package-catalog.json"
+ index_path.unlink()
+ index_path.symlink_to(real_index.name)
+ output.write_bytes(original_sidecar)
+ symlink_result = subprocess.run(
+ result.args, capture_output=True, text=True, check=False
+ )
+ self.assertEqual(symlink_result.returncode, 2)
+ self.assertIn("refusing unsafe output target", symlink_result.stderr)
+ self.assertEqual(output.read_bytes(), original_sidecar)
+
+ index_path.unlink()
+ hardlink_peer = components / "hardlink-package-catalog.json"
+ hardlink_peer.write_bytes(valid_index)
+ os.link(hardlink_peer, index_path)
+ output.write_bytes(original_sidecar)
+ hardlink_result = subprocess.run(
+ result.args, capture_output=True, text=True, check=False
+ )
+ self.assertEqual(hardlink_result.returncode, 2)
+ self.assertIn("refusing unsafe output target", hardlink_result.stderr)
+ self.assertEqual(output.read_bytes(), original_sidecar)
+
+ def test_validator_rejects_schema_count_key_and_text_corruption(self) -> None:
+ mutations = []
+
+ extra_top_key = copy.deepcopy(self.payload)
+ extra_top_key["unexpected"] = True
+ mutations.append(("extra top-level key", extra_top_key))
+
+ wrong_schema = copy.deepcopy(self.payload)
+ wrong_schema["schema_version"] = 2
+ mutations.append(("wrong schema version", wrong_schema))
+
+ wrong_quality_keys = copy.deepcopy(self.payload)
+ wrong_quality_keys["quality_counts"]["other"] = 0
+ mutations.append(("extra quality key", wrong_quality_keys))
+
+ wrong_count = copy.deepcopy(self.payload)
+ wrong_count["package_count"] += 1
+ mutations.append(("wrong package count", wrong_count))
+
+ sample_key = next(iter(self.payload["purposes"]))
+ missing_inner_key = copy.deepcopy(self.payload)
+ del missing_inner_key["purposes"][sample_key]["quality"]
+ mutations.append(("missing purpose entry key", missing_inner_key))
+
+ non_chinese = copy.deepcopy(self.payload)
+ non_chinese["purposes"][sample_key]["purpose"] = "generic package"
+ mutations.append(("non-Chinese purpose", non_chinese))
+
+ too_long = copy.deepcopy(self.payload)
+ too_long["purposes"][sample_key]["purpose"] = "中" * (generator.MAX_PURPOSE_LENGTH + 1)
+ mutations.append(("purpose longer than browser contract", too_long))
+
+ control_character = copy.deepcopy(self.payload)
+ control_character["purposes"][sample_key]["purpose"] += "\n破坏"
+ mutations.append(("control character", control_character))
+
+ bad_quality = copy.deepcopy(self.payload)
+ bad_quality["purposes"][sample_key]["quality"] = "guessed"
+ mutations.append(("unknown quality", bad_quality))
+
+ for label, payload in mutations:
+ with self.subTest(label=label):
+ with self.assertRaises(generator.PurposeCatalogError):
+ generator.validate_purpose_catalog(
+ payload, self.catalog_version, self.expected_keys
+ )
+
+ with self.assertRaises(generator.PurposeCatalogError):
+ generator.validate_purpose_catalog(
+ self.payload,
+ self.catalog_version,
+ self.expected_keys | {"official/not-present"},
+ )
+
+
+if __name__ == "__main__":
+ unittest.main(verbosity=2)
diff --git a/tests/test_pages_policy.sh b/tests/test_pages_policy.sh
index db92a23..b65f026 100755
--- a/tests/test_pages_policy.sh
+++ b/tests/test_pages_policy.sh
@@ -14,11 +14,13 @@ CATALOG_STAGER="$ROOT_DIR/scripts/validate-component-catalogs.py"
CATALOG_STAGING_TEST="$ROOT_DIR/tests/test_component_catalog_staging.py"
PACKAGE_CATALOG_GENERATOR="$ROOT_DIR/scripts/generate-package-catalog.py"
PACKAGE_CATALOG_TEST="$ROOT_DIR/tests/test_package_catalog.py"
+PACKAGE_PURPOSE_GENERATOR="$ROOT_DIR/scripts/package_purpose_zh.py"
+PACKAGE_PURPOSE_TEST="$ROOT_DIR/tests/test_package_purpose_zh.py"
COMMUNITY_FEED_LOCK="$ROOT_DIR/manifests/community-feeds.lock"
SITE="$ROOT_DIR/site"
CATALOG="$ROOT_DIR/components/catalog.json"
-for path in "$WORKFLOW" "$GENERATOR" "$PROOF_VERIFIER" "$PROOF_TEST" "$DEVICE_VALIDATOR" "$DEVICE_METADATA" "$DEVICE_TEST" "$UI_TEST" "$CATALOG_STAGER" "$CATALOG_STAGING_TEST" "$PACKAGE_CATALOG_GENERATOR" "$PACKAGE_CATALOG_TEST" "$COMMUNITY_FEED_LOCK" "$CATALOG" "$SITE/index.html" "$SITE/styles.css" "$SITE/app.js" "$SITE/favicon.svg" "$SITE/releases.json" "$SITE/.nojekyll"; do
+for path in "$WORKFLOW" "$GENERATOR" "$PROOF_VERIFIER" "$PROOF_TEST" "$DEVICE_VALIDATOR" "$DEVICE_METADATA" "$DEVICE_TEST" "$UI_TEST" "$CATALOG_STAGER" "$CATALOG_STAGING_TEST" "$PACKAGE_CATALOG_GENERATOR" "$PACKAGE_CATALOG_TEST" "$PACKAGE_PURPOSE_GENERATOR" "$PACKAGE_PURPOSE_TEST" "$COMMUNITY_FEED_LOCK" "$CATALOG" "$SITE/index.html" "$SITE/styles.css" "$SITE/app.js" "$SITE/favicon.svg" "$SITE/releases.json" "$SITE/.nojekyll"; do
test -f "$path" || { echo "missing Pages file: $path" >&2; exit 1; }
done
@@ -31,10 +33,13 @@ test -x "$CATALOG_STAGER"
test -x "$CATALOG_STAGING_TEST"
test -x "$PACKAGE_CATALOG_GENERATOR"
test -x "$PACKAGE_CATALOG_TEST"
-python3 -m py_compile "$GENERATOR" "$PROOF_VERIFIER" "$PROOF_TEST" "$DEVICE_VALIDATOR" "$DEVICE_TEST" "$CATALOG_STAGER" "$CATALOG_STAGING_TEST" "$PACKAGE_CATALOG_GENERATOR" "$PACKAGE_CATALOG_TEST"
+test -x "$PACKAGE_PURPOSE_GENERATOR"
+test -x "$PACKAGE_PURPOSE_TEST"
+python3 -m py_compile "$GENERATOR" "$PROOF_VERIFIER" "$PROOF_TEST" "$DEVICE_VALIDATOR" "$DEVICE_TEST" "$CATALOG_STAGER" "$CATALOG_STAGING_TEST" "$PACKAGE_CATALOG_GENERATOR" "$PACKAGE_CATALOG_TEST" "$PACKAGE_PURPOSE_GENERATOR" "$PACKAGE_PURPOSE_TEST"
python3 "$PROOF_TEST"
python3 "$DEVICE_TEST"
python3 "$CATALOG_STAGING_TEST"
+python3 "$PACKAGE_PURPOSE_TEST"
python3 "$DEVICE_VALIDATOR" --device xiaomi-ax9000 --flavor official --channel ram-test >/dev/null
python3 "$DEVICE_VALIDATOR" --device xiaomi-ax9000 --flavor nss --channel ram-test >/dev/null
if python3 "$DEVICE_VALIDATOR" --device xiaomi-ax9000 --flavor official --channel stable >/dev/null 2>&1; then
@@ -201,14 +206,17 @@ grep -Fq -- "- 'components/**'" "$WORKFLOW"
grep -Fq -- "- 'manifests/community-feeds.lock'" "$WORKFLOW"
grep -Fq -- "- 'tests/test_pages_ui.js'" "$WORKFLOW"
grep -Fq -- "- 'tests/test_package_catalog.py'" "$WORKFLOW"
+grep -Fq -- "- 'tests/test_package_purpose_zh.py'" "$WORKFLOW"
grep -Fq -- "- 'tests/test_pages_policy.sh'" "$WORKFLOW"
grep -Fq -- "- 'tests/test_component_catalog_staging.py'" "$WORKFLOW"
grep -Fq -- "- 'scripts/component_package_policy.py'" "$WORKFLOW"
grep -Fq -- "- 'scripts/generate-package-catalog.py'" "$WORKFLOW"
+grep -Fq -- "- 'scripts/package_purpose_zh.py'" "$WORKFLOW"
grep -Fq -- "- 'scripts/resolve-components.py'" "$WORKFLOW"
grep -Fq -- "- 'scripts/validate-component-catalogs.py'" "$WORKFLOW"
grep -Fq 'node tests/test_pages_ui.js' "$WORKFLOW"
grep -Fq 'python3 tests/test_package_catalog.py' "$WORKFLOW"
+grep -Fq 'python3 tests/test_package_purpose_zh.py' "$WORKFLOW"
grep -Fq 'bash tests/test_pages_policy.sh' "$WORKFLOW"
# Pages imports the backend contract instead of maintaining a weaker YAML copy.
grep -Fq 'python3 scripts/validate-component-catalogs.py' "$WORKFLOW"
diff --git a/tests/test_pages_ui.js b/tests/test_pages_ui.js
index ed87377..a3a9cc3 100755
--- a/tests/test_pages_ui.js
+++ b/tests/test_pages_ui.js
@@ -156,7 +156,7 @@ function makeDom() {
const root = path.resolve(__dirname, '..');
const source = fs.readFileSync(path.join(root, 'site/app.js'), 'utf8');
const testedSource = source.replace(/\nloadReleases\(\);\nloadComponentCatalog\(\);\s*$/, '\n') +
- '\nglobalThis.hooks = { validDevice, validRelease, validReleaseGroup, validVmRelease, validVmReleaseGroup, validUtcTimestamp, compareVersions, loadReleases, generateSnippet, validateComponentCatalog, validatePackageCatalogRoot, validatePackageCatalogShard, validCommunityCandidateProjection, resolveComponentSelection, componentHashPayload, canonicalJson, sha256Hex, normalizedBuildRequest, actionsInputs, loadComponentCatalog, loadPackageShardForSelection, changeComponentSelection, renderComponentChoices, setCurrentPackageRecords: (records) => { currentPackageShard = { packages: records }; currentPackageMap = new Map(records.map((record) => [record.id, record])); currentPackageSearchTerms = packageSearchTerms(currentPackageShard); }, clearVerifiedPackageShardCache: () => verifiedPackageShardCache.clear(), getCurrentPackageRecords: () => [...currentPackageMap.values()], getRequestedComponentIds: () => [...requestedComponentIds], getResolvedComponentIds: () => [...resolvedComponentIds] };\n';
+ '\nglobalThis.hooks = { validDevice, validRelease, validReleaseGroup, validVmRelease, validVmReleaseGroup, validUtcTimestamp, compareVersions, loadReleases, generateSnippet, validateComponentCatalog, validatePackageCatalogRoot, validatePackagePurposeCatalog, validatePackageCatalogShard, validCommunityCandidateProjection, resolveComponentSelection, componentHashPayload, canonicalJson, sha256Hex, normalizedBuildRequest, actionsInputs, loadComponentCatalog, loadPackageShardForSelection, changeComponentSelection, renderComponentChoices, setCurrentPackageRecords: (records) => { currentPackageShard = { packages: records }; currentPackageMap = new Map(records.map((record) => [record.id, record])); currentPackageSearchTerms = packageSearchTerms(currentPackageShard); }, clearVerifiedPackageShardCache: () => verifiedPackageShardCache.clear(), getCurrentPackageRecords: () => [...currentPackageMap.values()], getRequestedComponentIds: () => [...requestedComponentIds], getResolvedComponentIds: () => [...resolvedComponentIds] };\n';
const document = makeDom();
const loggedErrors = [];
const context = vm.createContext({
@@ -166,7 +166,7 @@ const context = vm.createContext({
console: { error: (...args) => loggedErrors.push(args) },
});
vm.runInContext(testedSource, context, { filename: 'site/app.js' });
-const { validDevice, validRelease, validReleaseGroup, validVmRelease, validVmReleaseGroup, validUtcTimestamp, compareVersions, loadReleases, generateSnippet, validateComponentCatalog, validatePackageCatalogRoot, validatePackageCatalogShard, validCommunityCandidateProjection, resolveComponentSelection, componentHashPayload, canonicalJson, sha256Hex, normalizedBuildRequest, actionsInputs, loadComponentCatalog, loadPackageShardForSelection, changeComponentSelection, renderComponentChoices, setCurrentPackageRecords, clearVerifiedPackageShardCache, getCurrentPackageRecords, getRequestedComponentIds, getResolvedComponentIds } = context.hooks;
+const { validDevice, validRelease, validReleaseGroup, validVmRelease, validVmReleaseGroup, validUtcTimestamp, compareVersions, loadReleases, generateSnippet, validateComponentCatalog, validatePackageCatalogRoot, validatePackagePurposeCatalog, validatePackageCatalogShard, validCommunityCandidateProjection, resolveComponentSelection, componentHashPayload, canonicalJson, sha256Hex, normalizedBuildRequest, actionsInputs, loadComponentCatalog, loadPackageShardForSelection, changeComponentSelection, renderComponentChoices, setCurrentPackageRecords, clearVerifiedPackageShardCache, getCurrentPackageRecords, getRequestedComponentIds, getResolvedComponentIds } = context.hooks;
const clone = (value) => JSON.parse(JSON.stringify(value));
const index = JSON.parse(fs.readFileSync(path.join(root, 'site/releases.json'), 'utf8'));
@@ -565,7 +565,7 @@ async function makePackageCatalogFixtures() {
for (let index = 0; index < 147; index += 1) {
const serial = String(index).padStart(3, '0');
x86Packages.push(packageRecord(`pkg-demo-${serial}`, `luci-app-demo-${serial}`, {
- description: `demo-search package ${serial}`,
+ description: index === 1 ? '' : `demo-search package ${serial}`,
feed: index % 2 ? 'packages' : 'luci',
category: index % 3 ? 'services' : 'network',
risk: index % 5 ? 'standard' : 'advanced',
@@ -614,14 +614,59 @@ async function makePackageCatalogFixtures() {
sources: shardSources(feeds),
});
}
+
+ const purposes = {};
+ const qualityCounts = { exact: 0, family: 0, category: 0 };
+ for (const shard of shards) {
+ for (const record of shard.packages) {
+ const key = `${record.source}/${record.package}`;
+ if (Object.hasOwn(purposes, key)) continue;
+ let purpose = `用于管理或扩展 ${record.package} 相关功能。`;
+ let quality = 'category';
+ if (key === 'official/luci-app-firewall-plus') {
+ purpose = '防火墙网页管理、访问控制和规则配置。';
+ quality = 'exact';
+ } else if (key === 'official/block-mount-extra') {
+ purpose = '提供存储挂载相关软件包家族功能。';
+ quality = 'family';
+ } else if (key === 'official/luci-app-demo-042') {
+ purpose = '中文搜索测试：演示网页组件与服务管理。';
+ quality = 'exact';
+ } else if (key === 'kiddin9/luci-app-openclash') {
+ purpose = '代理管理、策略分流与订阅配置。';
+ quality = 'exact';
+ }
+ purposes[key] = { purpose, quality };
+ qualityCounts[quality] += 1;
+ }
+ }
+ const purposeCatalog = {
+ schema_version: 1,
+ catalog_version: componentCatalog.catalog_version,
+ package_count: Object.keys(purposes).length,
+ quality_counts: qualityCounts,
+ purposes,
+ };
+ const purposePath = 'components/package-purpose-zh.json';
+ const purposeRaw = JSON.stringify(purposeCatalog);
+ rawByPath.set(purposePath, purposeRaw);
+
return {
root: {
- schema_version: 2,
+ schema_version: 3,
catalog_version: componentCatalog.catalog_version,
openwrt_version: '25.12.5',
+ purpose_catalog: {
+ locale: 'zh-CN',
+ path: purposePath,
+ sha256: await digestText(purposeRaw),
+ package_count: purposeCatalog.package_count,
+ },
shards: descriptors,
},
shards,
+ purposeCatalog,
+ purposePath,
rawByPath,
};
}
@@ -688,6 +733,23 @@ async function assertFrontendBackendHashContract(target, flavor, requestedIds, p
const packageFixtures = await makePackageCatalogFixtures();
assert.equal(validateComponentCatalog(componentCatalog), true);
assert.equal(validatePackageCatalogRoot(packageFixtures.root, componentCatalog), true);
+ assert.equal(
+ validatePackagePurposeCatalog(packageFixtures.purposeCatalog, componentCatalog, packageFixtures.root.purpose_catalog),
+ true
+ );
+ const purposeTextBoundary = clone(packageFixtures.purposeCatalog);
+ purposeTextBoundary.purposes['official/luci-app-firewall-plus'].purpose = '中'.repeat(359);
+ assert.equal(validatePackagePurposeCatalog(purposeTextBoundary, componentCatalog, packageFixtures.root.purpose_catalog), true);
+ purposeTextBoundary.purposes['official/luci-app-firewall-plus'].purpose = '中'.repeat(360);
+ assert.equal(validatePackagePurposeCatalog(purposeTextBoundary, componentCatalog, packageFixtures.root.purpose_catalog), true);
+ purposeTextBoundary.purposes['official/luci-app-firewall-plus'].purpose = '中'.repeat(361);
+ assert.equal(validatePackagePurposeCatalog(purposeTextBoundary, componentCatalog, packageFixtures.root.purpose_catalog), false);
+ purposeTextBoundary.purposes['official/luci-app-firewall-plus'].purpose = '兼容汉字：豈';
+ assert.equal(validatePackagePurposeCatalog(purposeTextBoundary, componentCatalog, packageFixtures.root.purpose_catalog), true);
+ purposeTextBoundary.purposes['official/luci-app-firewall-plus'].purpose = '包含双向控制符：';
+ assert.equal(validatePackagePurposeCatalog(purposeTextBoundary, componentCatalog, packageFixtures.root.purpose_catalog), false);
+ purposeTextBoundary.purposes['official/luci-app-firewall-plus'].purpose = ' ';
+ assert.equal(validatePackagePurposeCatalog(purposeTextBoundary, componentCatalog, packageFixtures.root.purpose_catalog), false);
assert.equal(validatePackageCatalogShard(packageFixtures.shards[0], packageFixtures.root.shards[0], componentCatalog), true);
assert.equal(validatePackageCatalogShard(packageFixtures.shards[1], packageFixtures.root.shards[1], componentCatalog), true);
assert.equal(await validCommunityCandidateProjection(packageFixtures.shards[1], packageFixtures.root.shards[1]), true);
@@ -752,11 +814,18 @@ async function assertFrontendBackendHashContract(target, flavor, requestedIds, p
assert.deepEqual(initialCalls, [
'components/catalog.json',
'components/package-catalog.json',
+ 'components/package-purpose-zh.json',
'components/packages/x86_64-official.json',
]);
assert.equal(document.querySelector('#component-status').classList.contains('error'), false);
assert.equal(document.querySelector('#component-package-status').classList.contains('error'), false);
assert.match(document.querySelector('#component-package-status').textContent, /OpenWrt 25\.12\.5/);
+ assert.match(document.querySelector('#component-package-status').textContent, /中文目录完整性已验证/);
+ assert.match(
+ document.querySelector('#component-package-status').textContent,
+ new RegExp(`人工精确 ${packageFixtures.purposeCatalog.quality_counts.exact} / 家族规则 ${packageFixtures.purposeCatalog.quality_counts.family} / 分类概述 ${packageFixtures.purposeCatalog.quality_counts.category}`)
+ );
+ assert.equal(initialCalls.includes('components/package-purpose-zh.json'), true);
assert.match(document.querySelector('#component-package-status').textContent, /150 个包，149 个可选择/);
assert.equal(document.querySelector('#component-target').disabled, false);
assert.equal(document.querySelector('#component-target').value, 'x86_64');
@@ -778,6 +847,8 @@ async function assertFrontendBackendHashContract(target, flavor, requestedIds, p
assert.match(document.querySelector('#component-result-status').textContent, /无需搜索即可浏览：共 150 个软件包，当前显示第 1–100 个/);
assert.match(flattenedText('#component-list'), /精选套餐/);
assert.match(flattenedText('#component-list'), /用途 \/ Purpose：/);
+ assert.match(flattenedText('#component-list'), /中文用途（人工精确）：防火墙网页管理、访问控制和规则配置。/);
+ assert.match(flattenedText('#component-list'), /上游说明 \/ Upstream：filter-probe/);
assert.match(flattenedText('#component-list'), /第 1 \/ 2 页/);
const nextPage = flattenChildren(document.querySelector('#component-list'))
.find((item) => item.getAttribute('data-package-page-next') === 'true');
@@ -794,9 +865,26 @@ async function assertFrontendBackendHashContract(target, flavor, requestedIds, p
document.querySelector('#component-search').value = 'demo-search';
renderComponentChoices();
assert.equal(packageOptions().length, 100);
- assert.match(document.querySelector('#component-result-status').textContent, /共 147 个软件包，当前显示第 1–100 个/);
+ assert.match(document.querySelector('#component-result-status').textContent, /共 146 个软件包，当前显示第 1–100 个/);
assert.match(flattenedText('#component-list'), /第 1 \/ 2 页/);
+ document.querySelector('#component-search').value = '中文搜索测试';
+ renderComponentChoices();
+ assert.equal(packageOptions().length, 1);
+ assert.match(flattenedText('#component-list'), /luci-app-demo-042/);
+ assert.match(flattenedText('#component-list'), /中文用途（人工精确）：中文搜索测试：演示网页组件与服务管理。/);
+
+ document.querySelector('#component-search').value = 'block-mount-extra';
+ renderComponentChoices();
+ assert.equal(packageOptions().length, 1);
+ assert.match(flattenedText('#component-list'), /中文用途（家族规则生成）：提供存储挂载相关软件包家族功能。/);
+
+ document.querySelector('#component-search').value = 'luci-app-demo-001';
+ renderComponentChoices();
+ assert.equal(packageOptions().length, 1);
+ assert.match(flattenedText('#component-list'), /中文用途（分类概述，具体用途请核对上游）：用于管理或扩展 luci-app-demo-001 相关功能。/);
+ assert.match(flattenedText('#component-list'), /上游说明 \/ Upstream：上游未提供说明 \/ No upstream description/);
+
document.querySelector('#component-source').value = 'official';
document.querySelector('#component-search').value = 'filter-probe';
document.querySelector('#component-category').value = 'network';
@@ -896,6 +984,42 @@ async function assertFrontendBackendHashContract(target, flavor, requestedIds, p
assert.equal(getCurrentPackageRecords().length, 150);
assert.match(document.querySelector('#component-package-status').textContent, /10947|150/);
+ clearVerifiedPackageShardCache();
+ const purposeShaCalls = [];
+ const tamperedPurpose = new Map([[
+ packageFixtures.purposePath,
+ `${packageFixtures.rawByPath.get(packageFixtures.purposePath)} `,
+ ]]);
+ await loadCatalogWith(fixtureFetch(packageFixtures, purposeShaCalls, tamperedPurpose));
+ assert.equal(document.querySelector('#component-package-status').classList.contains('error'), true);
+ assert.match(document.querySelector('#component-package-status').textContent, /中文用途目录不可用/);
+ assert.equal(getCurrentPackageRecords().length, 0);
+ assert.equal(purposeShaCalls.includes('components/packages/x86_64-official.json'), false);
+ assert.match(loggedErrors.at(-1)[1].message, /purpose catalog sha256 mismatch/);
+
+ clearVerifiedPackageShardCache();
+ const missingPurposeFixtures = {
+ root: clone(packageFixtures.root),
+ shards: clone(packageFixtures.shards),
+ purposeCatalog: clone(packageFixtures.purposeCatalog),
+ purposePath: packageFixtures.purposePath,
+ rawByPath: new Map(packageFixtures.rawByPath),
+ };
+ const missingPurposeKey = 'official/luci-app-firewall-plus';
+ const missingPurposeQuality = missingPurposeFixtures.purposeCatalog.purposes[missingPurposeKey].quality;
+ delete missingPurposeFixtures.purposeCatalog.purposes[missingPurposeKey];
+ missingPurposeFixtures.purposeCatalog.package_count -= 1;
+ missingPurposeFixtures.purposeCatalog.quality_counts[missingPurposeQuality] -= 1;
+ const missingPurposeRaw = JSON.stringify(missingPurposeFixtures.purposeCatalog);
+ missingPurposeFixtures.rawByPath.set(missingPurposeFixtures.purposePath, missingPurposeRaw);
+ missingPurposeFixtures.root.purpose_catalog.package_count = missingPurposeFixtures.purposeCatalog.package_count;
+ missingPurposeFixtures.root.purpose_catalog.sha256 = await digestText(missingPurposeRaw);
+ await loadCatalogWith(fixtureFetch(missingPurposeFixtures, []));
+ assert.equal(document.querySelector('#component-package-status').classList.contains('error'), true);
+ assert.match(document.querySelector('#component-package-status').textContent, /官方包校验失败/);
+ assert.equal(getCurrentPackageRecords().length, 0);
+ assert.match(loggedErrors.at(-1)[1].message, /does not cover this shard/);
+
clearVerifiedPackageShardCache();
const mismatchCalls = [];
const tampered = new Map([[
@@ -1086,7 +1210,7 @@ async function assertFrontendBackendHashContract(target, flavor, requestedIds, p
assertSafeEmptyState();
assert.equal(loggedErrors.length >= 5, true);
- console.log('Pages UI policy: release rendering plus fail-closed catalog selector, dependency/conflict resolution, normalized request hashing, and authenticated Actions handoff');
+ console.log('Pages UI policy: release rendering plus fail-closed package and Chinese-purpose catalogs, Chinese search, normalized request hashing, and authenticated Actions handoff');
})().catch((error) => {
console.error(error);
process.exitCode = 1;
diff --git a/tests/test_static.sh b/tests/test_static.sh
index c3dd3aa..80b9c83 100755
--- a/tests/test_static.sh
+++ b/tests/test_static.sh
@@ -6,6 +6,7 @@ unset GITHUB_ACTIONS GITHUB_REF GITHUB_REPOSITORY GITHUB_RUN_ATTEMPT \
GITHUB_RUN_ID GITHUB_SHA GITHUB_WORKFLOW_REF GITHUB_WORKFLOW_SHA
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
python3 "$ROOT_DIR/tests/test_component_catalog.py"
+python3 "$ROOT_DIR/tests/test_package_purpose_zh.py"
"$ROOT_DIR/tests/test_custom_build_policy.sh"
python3 "$ROOT_DIR/tests/test_custom_artifacts.py"