# 光辉治理管道：把"AI 协作宪法"变成一键可跑的代码质量门禁

> 一套面向 AI 协作项目的开源治理与代码质量门禁框架，零安装、自包含、不污染宿主环境。

## 为什么要做这个

现在越来越多人用 AI 写代码，但 AI 交付的质量、安全、合规往往"凭感觉"。我们想把一套原创的 **「AI 协作治理方法论」**（宪法 → 执行引擎 → 门禁四步全链）从理念落成**可执行的工具**，让任何 AI 协作项目在交付前自动完成：自检、证据留存、合规审查、沙箱验证。

核心思路是"宪法级保护"——每一次代码修改都要走完整证据链，杜绝"无证据交付、裸奔上线"。

## 它是什么

纯 Node.js 实现，**零外部依赖、零硬编码、路径无关**，下载解压即可在任意机器任意目录运行。内置便携 Node，不要求你本机装环境。

核心能力：

- **通用自检**：零依赖验证包完整性，双击即跑。

- **门禁四步全链**：证据表 → Gate-C 全链 → 独立审查 → 沙箱测试，一步不漏。

- **质量门禁**：eslint 语义扫描、密钥扫描、硬编码扫描、路径热编、链接一致性、时间对齐、P3 防漏。

- **宪法级保护**：证据表 10 分钟内有效，过期即拦截，强制"先留证据再交付"。

## 怎么用

本包不绑定任何 IDE，可在 CodeBuddy / Trae / VSCode / Cursor 等支持"规则 / 记忆"的 AI IDE 上使用。实际使用流程：

1. 把本包目录添加到 IDE 工作区，作为被引用的本地包；

2. 在对话中让 AI「加载光辉」，读取包内治理规则并内化为本次会话的强制约束；

3. 让 AI 把这套治理规则持久化为永久记忆，之后每次新会话自动加载；

4. 此后像平常一样协作，执行代码修改时治理管道会自动启用四步全链门禁保驾护航。

Windows 双击 `运行门禁.bat` 即可；macOS / Linux 跑 `bash run-gate.sh`。

## 开源地址（三平台同步）

- Gitee：https://gitee.com/huqinchai/guanghui

- GitCode：https://gitcode.com/huqinchai/guanghui

- AtomGit：https://atomgit.com/huqinchai/guanghui

欢迎 Star / Fork / 提 Issue。MIT 协议，可自由使用。