ReleaseGuard 本地发布审计
ReleaseGuard 按以下固定边界工作:
Phase 1 Deterministic Release Audit
-> Phase 2 OpenVINO Local AI Review
-> Phase 3 Agentic Safe Remediation
-> Phase 4 Human-in-the-loop Release Gate
审计核心始终本地优先且只读:不会执行被审计项目、上传源码或调用云端 LLM。代码修改是独立的处置步骤,只能由外部 AI Coding Agent 在确定性安全策略和明确人工授权边界内执行,并且必须重新审计。AI 语义说明始终是建议,不能改变 Finding、分数或 Gate。
使用
只能调用 scripts\run.ps1。 不要直接调用 client.py、server.py 或内部 Python 模块。
| 目标 | 调用 |
| --- | --- |
| 确定性发布审计 | powershell -ExecutionPolicy Bypass -File scripts\run.ps1 audit "<项目目录>" --format json |
| 本地 AI 增强审计 | powershell -ExecutionPolicy Bypass -File scripts\run.ps1 audit "<项目目录>" --ai --format markdown |
| 查看本地模型服务 | powershell -ExecutionPolicy Bypass -File scripts\run.ps1 ai status |
| 预热本地模型 | powershell -ExecutionPolicy Bypass -File scripts\run.ps1 ai start --wait --timeout 600 |
| 停止本地模型服务 | powershell -ExecutionPolicy Bypass -File scripts\run.ps1 ai stop |
首次 --ai 调用会安装本地运行环境并下载 OpenVINO 模型。下载时间超过宿主限制时,命令会输出确定性审计结果、提示 模型正在下载或加载,并以退出码 3 结束;之后使用:
powershell -ExecutionPolicy Bypass -File scripts\run.ps1 --continue
继续上一个本地待处理请求。不要把 --continue 用于新的项目路径。
结果解释
PASS:没有 Critical 发现且分数至少为 85。WARNING:无 Critical,但仍需在发布前人工复核。BLOCKED:存在 Critical 或分数低于 60,应修复后重新审计。Local AI Review:仅在--ai时出现。Model与Device只来自实际本地 server 状态;若服务、模型或响应不可用,确定性结果仍有效。
AI 建议可能指出上下文风险、误报可能性和修复方案,但不能修改 Finding 的确定性证据、严重级别、分数或 Gate。Secret、Git 冲突、生产 localhost 等硬事实仍由规则引擎决定。
重要边界
- 仅支持 Windows 本地命名管道服务;不会绑定网络端口或暴露公网接口。
CPU和 IntelGPU是默认兼容路径;可用的NPU会被实际检测后使用,不能检测到时不会伪称可用。- 首次模型下载来自公开模型仓库,仅保存模型文件到本机;仓库源码、完整文件、二进制和原始 secret 不会发送给模型或外部 API。
- 返回码:
0成功,1一般参数/运行错误,2本地通信错误,3模型下载或加载尚未完成,需--continue。 - 只在用户明确授权修复时修改被审计项目;修复后重新运行本 Skill。
SAFE项目可在明确授权后由 Agent 进行最小处置;REVIEW_REQUIRED与NEVER_AUTO_FIX不得由 Agent 擅自修改。- Critical/High 人审必须在本地 Dashboard 中完成。自然语言、
actor=human、理由文本及approve、reject、defer、false-positiveCLI 兼容命令均不能构成授权;Dashboard 审批会绑定当前 audit、finding 和 snapshot,并在使用后消费。
微信扫一扫