wandering1
96a3d15efc
门禁解释器解耦
44 条 language: system 钩子此前把解释器写成仓库检出的绝对路径，换机、
换克隆目录都要重写。改为 entry 只写 scripts/gate_python.py + 脚本名，
由启动器按候选链解析：$DTU_GATE_PYTHON > <仓库>/.venv >
<仓库>/.gate/python > PATH。启动器用 execve 替换自身，并把选中的
解释器经 DTU_GATE_PYTHON 传给子进程，保证脚本内再调 Python 时一致。
实测 pre-commit 4.6.2 不展开 ${VAR}；language: script 的 shebang 只做
纯 PATH 改写，会把决定权交给 PATH 首个 python，故不采用。
ci_local.py 预检识别启动器并报出解析结果。
并行工作树统一
task-worktree 新增 bench-gate（强制台架验收）与 merge（编排式合并），
删除 new/abort，done 标 DEPRECATED；台架通过记录改存
.agents/worktrees/.bench-pass-log。keil_build.py 的 plugin_tree_owner
识别 .agents/worktrees/<name> 并返回 pw:<name>。
check_doc_links / gen_refgraph / check_layer_deps 的扫描排除面补上
.agents；并行任务工作树方案重写为单一模型（7 节），取消工作树数量上限，
删历史实测记录节，两处 §7.3 悬空引用改为按语义引用。
文档与约定
本地工具路径环境变量方案 §5 重写为四节：谁跑在哪个 Python 上、写新钩子、
预检对号入座、动环境五步。文档规范的变更记录例外名单由 5 篇减为 4 篇
（本篇实际没有该节）。AGENTS.md 补委派验收口径三条。
验证：pre_commit run --all-files 48 钩子全 Passed；ci_local.py
--preflight-only 报 44 条经启动器 -> 仓库 .venv；keil-build 0 errors
0 warnings；check_doc_links --sections-strict 全通过。
114 lines
4.5 KiB
Python
114 lines
4.5 KiB
Python
#!/usr/bin/env python
|
||
# -*- coding: utf-8 -*-
|
||
"""门禁钩子的统一启动器：替钩子找到该用的解释器，再原样转交脚本。
|
||
|
||
被提交的 .pre-commit-config.yaml 只写 `entry: scripts/gate_python.py <脚本> [参数...]`，
|
||
不出现任何机器相关的解释器路径——换机、换克隆目录、换 PATH 首位都不必改配置。
|
||
|
||
解释器按下面的顺序找，第一个可用的胜出：
|
||
1. $DTU_GATE_PYTHON 显式覆盖（临时切版本、排查「到底跑在谁身上」）
|
||
2. <仓库>/.venv/Scripts/python.exe 约定的仓库内环境（requirements.txt 装在这里）
|
||
3. <仓库>/.gate/python/python.exe 便携解释器（可选，本仓当前未提供）
|
||
4. PATH 上的 python 最后兜底
|
||
|
||
约定纪律（改动前先读 docs/环境与部署/本地工具路径环境变量方案.md §5.1）：
|
||
- 纯标准库、单文件、不 import 仓库内任何模块——它运行在「解释器还不知道是谁」的时刻；
|
||
- 解析出的解释器用环境变量 DTU_GATE_PYTHON 传给子进程，脚本内部再调 Python 时能与钩子保持一致，
|
||
否则「门禁用的版本」和「生成器用的版本」会分叉。
|
||
|
||
退出码：0 表示被调脚本自己退出为 0；启动器自身失败一律 2（与 pre-commit「环境不可用」口径一致，
|
||
见 docs/草稿约定：2 = 配置/环境问题，1 = 检查结论不通过）。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import os
|
||
import sys
|
||
|
||
LAUNCHER_NAME = "gate_python.py"
|
||
|
||
|
||
def repo_root() -> str:
|
||
"""启动器所在仓库根（本文件位于 <仓库>/scripts/ 下）。"""
|
||
return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||
|
||
|
||
def candidates(root: str) -> list[tuple[str, str]]:
|
||
"""返回 [(说明, 解释器路径)]，顺序即优先级。"""
|
||
items: list[tuple[str, str]] = []
|
||
override = os.environ.get("DTU_GATE_PYTHON")
|
||
if override:
|
||
items.append(("$DTU_GATE_PYTHON", override))
|
||
items.append(("仓库 .venv", os.path.join(root, ".venv", "Scripts", "python.exe")))
|
||
items.append(("便携解释器 .gate", os.path.join(root, ".gate", "python", "python.exe")))
|
||
path_python = path_lookup("python")
|
||
if path_python:
|
||
items.append(("PATH", path_python))
|
||
return items
|
||
|
||
|
||
def path_lookup(name: str) -> str:
|
||
"""按 Windows 语义在 PATH 里找可执行文件（含 PATHEXT 展开）。"""
|
||
exts = os.environ.get("PATHEXT", ".COM;.EXE;.BAT;.CMD").split(os.pathsep)
|
||
for directory in os.environ.get("PATH", "").split(os.pathsep):
|
||
if not directory:
|
||
continue
|
||
for ext in [""] + exts:
|
||
candidate = os.path.join(directory, name + ext.lower())
|
||
if os.path.isfile(candidate):
|
||
return candidate
|
||
return ""
|
||
|
||
|
||
def pick(root: str) -> tuple[str, str] | None:
|
||
for label, exe in candidates(root):
|
||
if exe and os.path.isfile(exe):
|
||
return label, exe
|
||
return None
|
||
|
||
|
||
def fail(message: str, root: str) -> int:
|
||
print(f"[gate_python] {message}", file=sys.stderr)
|
||
print("[gate_python] 解释器候选检查结果：", file=sys.stderr)
|
||
for label, exe in candidates(root):
|
||
state = "可用" if exe and os.path.isfile(exe) else "不存在"
|
||
print(f" {label:<16} {exe or '<未设置>'} [{state}]", file=sys.stderr)
|
||
print(
|
||
"[gate_python] 修复：按下面任一方式让第 2 个候选就位——\n"
|
||
" python -m venv .venv && .venv/Scripts/python.exe -m pip install -r requirements.txt\n"
|
||
" 或临时指定：set DTU_GATE_PYTHON=<某个装了依赖的 python.exe>\n"
|
||
" 详细规程 → docs/环境与部署/本地工具路径环境变量方案.md §5",
|
||
file=sys.stderr,
|
||
)
|
||
return 2
|
||
|
||
|
||
def main(argv: list[str]) -> int:
|
||
root = repo_root()
|
||
if len(argv) < 2:
|
||
return fail("缺少目标脚本参数（用法：gate_python.py <脚本> [参数...]）", root)
|
||
|
||
target = argv[1]
|
||
if not os.path.isabs(target):
|
||
target = os.path.join(root, target)
|
||
if not os.path.isfile(target):
|
||
return fail(f"目标脚本不存在：{argv[1]}", root)
|
||
|
||
chosen = pick(root)
|
||
if chosen is None:
|
||
return fail("找不到可用的解释器", root)
|
||
label, exe = chosen
|
||
|
||
if os.environ.get("DTU_GATE_VERBOSE"):
|
||
print(f"[gate_python] {label} -> {exe}", file=sys.stderr)
|
||
|
||
env = dict(os.environ)
|
||
env["DTU_GATE_PYTHON"] = exe
|
||
child_argv = [exe, target, *argv[2:]]
|
||
os.execve(exe, child_argv, env)
|
||
return 0 # 不会走到这里：execve 成功即替换进程
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main(sys.argv))
|