Zhulong Project Intelligence Kit

质量证据

稳定结论与当次明细,分别保存。

长期基线进入 Git 和 Pages;每次 verifier 的详细报告进入短期 CI artifact;视觉截图只留在临时目录。绿色状态必须能够复跑,但不再靠提交生成文件来证明。

当前稳定基线

页面只读取经过确认的 verification/baselines/latest.json。它没有运行时绝对路径、随机目录或生成时间戳。

整体状态

PASS

engineering-consolidation-start

命令面

74 / 74

每个公开逻辑命令都必须进入 full-command-surface。

工具链

Node.js 24 / npm 11.18.0

CI 与发布工作流固定到 Node.js 24 和 npm 11。

运行时依赖

0

默认路径只依赖 Node.js 标准库。

打开稳定基线 查看 CI 明细

两种项目画像,共用一套核心闭环

文档与 RAG 是按项目需要启用的能力,不是 Zhulong 运行的前提。

项目画像推荐配置必须证明禁止副作用
非文档密集型 reference + rag none codebase、workflow、policy、evidence、completion 正常闭环 不安装、不索引、不查询 RAG,不给出错误 RAG 建议
文档密集型 strict + rag local 文档新鲜度、引用、answer audit 与严格 gate 不使用未经批准的外部服务,不隐藏执行重建

证据分层

不同寿命的证据放在不同位置,减少仓库噪声,也避免发布页展示已经过期的截图。

稳定基线

verification/baselines/

进入 Git,记录 commit、工具链、关键 gate 和分发体积。

当次报告

verification/reports/

本地生成并忽略;CI 上传 Markdown/JSON,保留 7 天。

视觉截图

.zl-tmp/visual/

用于 Playwright 判断空白、溢出与裁切,不进入 Git、Pages 或 npm 包。

发布级验证入口

表格说明每一层证明什么。详细输出从对应 CI run 的 artifact 获取。

入口覆盖范围证据位置
npm test纯函数、参数解析、状态迁移与策略判定CI 日志与测试 reporter
npm run verify:ci文档、RAG 边界、质量审计、runtime、Pages 与发布治理7 天 CI artifact
npm run verify:project-profiles文档密集型和非文档密集型核心闭环7 天 CI artifact
manifest: full-command-surface全部公开逻辑命令与 npm bin;在当前 tier 中只运行一次7 天 CI artifact
npm run verify:visual桌面、移动端、暗色模式、布局和品牌资源本地临时截图与文本摘要
npm run verify:release完整 gate、pack 清单、体积和供应链元数据Release 与 attestation

本地复跑

稳定基线是摘要,不替代命令。任何结论都必须能够在干净环境中重新生成。

npm ci --ignore-scripts
npm run verify:ci
npm run verify:release
npm pack --dry-run --json