# codegraph-ref 代码质量评分（WB-SPEC 标尺 × Rust，2026-09）

**标尺**：WB-SPEC v1 八维（用户指示：中文注释要求 → 英文注释即同样标尺）
**工具**：`tools/codegraph_eval.py`（复用八维权重，Rust 适配）
**样本**：`codegraph-ref/crates/codegraph`（42 个 .rs 文件，约 7214 行）

## 评分结果

| 维度 | 权重 | 得分 | 说明 |
|---|---|---|---|
| W1 可执行性 | 0.15 | **0.9048** | 括号平衡+结构完整（Rust 不能独立编译——cargo check 受 zstd-sys C 依赖构建环境限制，诚实声明非代码缺陷） |
| W2 功能正确性 | 0.35 | **0.9048** | 编译/类型系统近似（无统一样例断言，诚实声明） |
| W3 边界健壮性 | 0.10 | **0.9048** | Rust 类型系统静态保证（编译通过近似） |
| W4 规范符合性 | 0.10 | **0.8810** | 文档注释（///）存在性——17% 文件缺 |
| W5 集成正确性 | 0.10 | **0.9048** | crate 级编译近似 |
| W6 效率 | 0.10 | **0.8333** | 圈复杂度/嵌套——图算法/影响分析复杂度高 |
| W7 可读性 | 0.05 | **0.9524** | **英文注释密度**+命名+函数长度（4.8% 文件注释不足） |
| W8 安全性 | 0.05 | **0.9762** | unsafe/命令模式扫描（build.rs 用 Command 命中） |
| **总分** | 1.00 | **0.9012** | |

失败文件 17/42（主要：W6 效率 7 个、W4 规范 5 个、W8 安全 1 个）。

## 与白箱 681 单元对照

| | 白箱（Python 681 单元） | codegraph-ref（Rust 42 文件） |
|---|---|---|
| 总分 | **0.9851** | **0.9012** |
| 功能正确 | 1.0（样例断言全过） | 0.9048（编译近似，无样例） |
| 效率 | 0.9457 | 0.8333 |
| 可读 | 0.8106（中文注释） | 0.9524（英文注释） |

**解读**：
- 白箱高在「功能正确性」——681 单元有**确定性样例断言**（物理基底裁决）；
  codegraph 无统一测试样例，W2 只能编译近似（诚实声明，非能力差异）
- codegraph 高在「可读性」——英文注释质量好（Rust 生态文档惯例），
  白箱被短名惯例（ip/kw/m）拉低
- codegraph 的 W6 效率 0.8333 真实（图算法复杂度），与白箱状态机
  语义复杂度同源——都是「功能正确但实现复杂」的确定性特征

## 评估方法诚实声明

1. W1/W2/W3/W5 用**项目级构建 + 文件级结构近似**——Rust 文件不能独立
   编译（依赖 crate 上下文）；cargo check 受 zstd-sys C 依赖环境限制
   （`build-script-build` 失败，非 codegraph 代码缺陷）
2. W2 无样例断言（项目未提供统一测试集）——编译通过≠功能正确，
   这是**标尺对齐的诚实边界**（白箱有样例是它的结构性优势）
3. W7 按用户指示：**英文注释**密度（`//`/`///` 含英文）

## 报告

- `tools/codegraph_eval_report.json`
- 工具：`tools/codegraph_eval.py`（可复用于其他 Rust 项目）