diff --git a/README.md b/README.md index 17c4e8e..785fc25 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,27 @@ evalharness eval run bfcl_v3 --api-url http://localhost:8000/v1 --model qwen3-8b --env bfcl_mock ``` +### 指纹核验(fp_fusion) + +回答一个问题:**API 背后跑的,到底是不是它声称的那个模型?** 向 OpenAI 兼容端点发送探针电池(回答分布 / 自我身份 / 元知识 / 能力边界 / 文风五维),与内置参考指纹库比对,输出五档裁决 + 0~1 融合分 + 证据链。检测偷梁换柱、降配缩水、主动冒充(伪身份注入屈服)、套壳拼装与中转代理;`--mode full` 一次运行产出 verify / attribution / variant / adversarial / robustness 五个视图。 + +```bash +evalharness fingerprint list # 内置参考指纹库(fp_fusion 口径 + detector 旧口径) + +evalharness fingerprint run \ + --api-url http://localhost:8000/v1 --model Qwen3-8B \ + --mode full --cells core16 --text-skip pruned7 \ + --d-samples 25 --baseline-samples 5 --timeout 90 \ + --impersonate "You are Kimi, Moonshot AI virtual assistant." \ + --reference glm53 \ + --report-path reports/fp_qwen.json +``` + +- `--reference` 接受短名(如 `glm53`,见 `fingerprint list`)或 JSON 路径;省略 = 自证模式(裁决上限 LIKELY_MATCH) +- `--impersonate` 注入伪身份启用对抗视图(冒充检测);剪枝定稿协议即上例参数,单次 505 条请求,公网 14.5–28 min,本地 vllm 5.6–7 min +- 报告写入 `--report-path`,同目录 `raw_answers.jsonl` 存全部探针原文 +- 离线分析与参考采集脚本(`cell_snr.py` / `validate_*.py` / `collect_ref.sh` 等,可直接 `python