ChatLabel

ChatLabel 是一个任务中立、可审计的结构化标注运行器。任务 manifest 定义输入字段、允许标签、适配器和完成闸门；首个内置任务用于完成印尼线路产品工作簿的解析、模型建议、人工校对、校验和 Excel 导出闭环。

0.2 开发线优先完善分类内核：从人工确认表构建可追溯 ground truth、提取 WPS 图片证据、通过 gpt-5.6-sol / xhigh 调用流式 Responses API，并运行无产品组泄漏的交叉验证和固定留出验收。

自动输出是建议结果。完成图片逐项复核、高风险审计和一致性校验前，不应作为最终业务分类。

文档入口：https://arch.gh.wzhecnu.cn/ChatLabel/

安装与运行

pip install ChatLabel
chatlabel --version
chatlabel --tree
chatlabel serve

默认页面：http://127.0.0.1:8765/

配置

ChatLabel 从 ChatEnv 读取名为 apple 的既有 OpenAI profile，也可通过环境变量调整：

进程级 OPENAI_* 会覆盖 profile 值。模型请求只接受 API Key，不把 key 写入任务或评测结果。网页配置接口只显示模型、API 地址和“是否有 API Key”，不会返回凭据内容。

数据与评测

chatlabel dataset-build \
  --data-root /path/to/data \
  --fixtures /path/to/example-cases.json \
  --output-dir /path/to/ground-truth

chatlabel cross-validate \
  --dataset-dir /path/to/ground-truth \
  --output-dir /path/to/cv-results \
  --folds 5 --limit-per-fold 8 --concurrency 2

chatlabel evaluate \
  --dataset-dir /path/to/ground-truth \
  --output-dir /path/to/validation-results \
  --split validation --concurrency 2

ground truth 同时保存来源工作簿、sheet、行号、文件哈希、原始标签、规范化标签、图片哈希和 policy override。旧式 慢线、无当前依据的历史拒收、缺图、条件性结论和冲突记录进入 review queue，不进入准确率 gold。

HTTP API

• GET /healthz：进程健康检查。
• GET /readyz：SQLite、task registry、运行目录和模型配置就绪检查。
• GET /api/v1/model：模型、推理强度、prompt 版本和 API Key 可用状态。
• POST /api/v1/proposals：按文本与可选 base64 图片生成单条 proposal。
• GET /api/v1/task-types：读取版本化任务定义。
• POST /api/v1/jobs：multipart 上传任务类型与 Excel。
• GET /api/v1/jobs/{job_id}/records：分页读取规范化记录、proposal 和 review。
• POST /api/v1/jobs/{job_id}/proposals：运行该工作簿的 proposal 阶段。
• PATCH /api/v1/jobs/{job_id}/records/{record_id}/review：接受、纠正或 unresolved。
• POST /api/v1/jobs/{job_id}/validate：运行覆盖率、备注、冲突、源文件和 WPS 闸门。
• POST /api/v1/jobs/{job_id}/export：仅在闸门通过后生成 Excel、JSONL 和报告。
• GET /api/v1/jobs/{job_id}/artifacts/{artifact_id}：下载持久化产物。

proposal 响应保留模型、状态、延迟与 token 用量，并始终返回 final=false。SQLite 使用 WAL；服务重启后仍可读取 job、record、proposal、review、validation、artifact 和审计事件。

开发验证

python -m pip install -e ".[dev,docs]"
python -m pytest -q
chatlabel --help
chatlabel --tree
python -m build
mkdocs build --strict

进一步查看：CLI 树、能力地图、Python 接口树。