FAQ · 05

常见问题与排错

约 1 分钟阅读 Apache-2.0 本文基于 v0.1.0（2026-11-01）

01出的表跟我感觉不符，先查什么

1. 查证据行：每条风险结论都带指向台账行的证据引用，先顺着证据回查——多数时候是台账数据本身（状态没更新、证据栏空着）。 2. 查权重：你觉得重要的事排后面，多半是权重口径和你的团队不一致，改 packs/project/rules.example.yaml。 3. 查阈值：三档阈值是通用口径，你的项目节奏快就收紧。

02指标算出来是空的 / 全是满分

现象	原因	怎么办
体检卡是空的	台账字段没对上（`name` 列缺失整行跳过）	对照「安装与数据接入」的五列表头
全是满分	`evidence` 栏全空——无证据不出风险结论	把「阻塞了 / 延了 / 拍板没落」的事补进证据栏再跑
承诺兑现率不生效	台账里没有「拍板 → 兑现」的对应行	拍板事项与完成记录要成对出现在台账里

03能不能一次看多个项目

台账本身可以有多行，但体检视角一次一个项目——跨项目组合视角（资源冲突、项目间依赖图谱）是刻意不做的边界。多项目就多跑几份台账。

04数据存在哪、会不会上传

存哪：体检在你本机完成，findings.json 落在你指定的位置；引擎零联网、零第三方依赖，rules.validate 之外的任何动作都不碰网络。
上传吗：不上传。台账原文、体检结果都留在你机器上。

05想加一个我们自己行业的指标，从哪下手

打开 packs/project/rules.example.yaml（全字段中文注释），按内置五条的格式加一条：指标名 + 判据字段 + 三档阈值 + 权重。改完先跑 rules.validate，再喂两三行台账对照手工预期。需要接入弈枢工作台或私有化部署，见官网「联系我们」。