---
id: operation.capture-quality-case
name: 记录机器味案例
category: operation
contract_version: 1
description: 从确切正文或资料来源记录待复核案例，经作者审阅确认修、留、问，保留来源与许可。
commands:
- capture_quality_case
- read_quality_case
- list_quality_cases
- open_quality_case_review
- decide_quality_case
- withdraw_quality_case
---
<!-- 导航元信息: {"使用场景": "质量复核与治理\n反馈记录与静态回填", "使用要求": "不扩大授权\n不自动确认或生成规则"} -->

# 记录机器味案例

适用于记录误杀、有效修改、拒绝或事故。采集只形成待复核案例，不能用一次采纳推断通用规则或文学收益。

先读[参考导航](references/目录.md)定位来源坐标、许可与复核要求，再读[案例合同](references/案例合同.md)（安装包资源：审校/案例合同.md）。定位真实来源的身份、版本、分支、全文哈希及码点范围；片段哈希必须对应实际片段。请求不传原文、上下文或伪造的引文；服务从正文/候选/资料权威读取。明确作者允许保全片段时才设置preserve_text=true，资料同时需要sample许可。否则只保存允许的元信息。

调用capture_quality_case，保留command_id用于幂等重试。静态回填用backfill；live_feedback必须有实际作者回执，并关联同章同分支的原文、候选或后续正文。没有回执就保留静态性质，不能捏造实际使用反馈。

通过read_quality_case读取落库结果，再由作者选择sf、snf、boundary或regression，说明修复、保留或询问（repair、retain、ask）的依据。使用open_quality_case_review生成真实审阅，再将具体内容交作者确认后调用decide_quality_case。来源推进或许可变化导致旧审阅失败时，重新读取和审阅，不能复用旧批准。

作者明确要求停止复用已确认案例时调用withdraw_quality_case。历史版本保留可追查，当前案例不再作为规则例证。记录案例不生成规则；规则候选交由“建立机器味规则”入口，正式启用另走效果评测。

CLI对应“审校 <作者配置> 案例采集/案例审阅/案例决定/案例撤回 <请求JSON>”；案例和案例清单可只读查询。不直连数据库、不改正式正文，不执行模型调用。