casebrief

casebrief

将冗长、杂乱的支持工单对话整理成便于人工采取行动的内容。casebrief 是一个用于 CaseMargin 工单推理服务的小型客户端：将工单原始文本交给它，它会返回结构化的案件简报——问题是什么、已经尝试了哪些措施及其结果，以及重要背景；或者返回准备度评分，说明工单是否完整到足以升级至 L2，以及如果尚未达到，还缺少什么。

只有你传入的工单文本会离开本机。响应会原样返回服务给出的内容：传递过程中不会删减、重命名或总结。

配置

两个环境变量用于控制客户端：

• CASEMARGIN_API_KEY（可选）——设置后，每个请求都会通过 Authorization: Bearer <key> 发送该密钥。不设置也不会报错：此时简报生成会使用按 IP 区分的匿名层级，升级检查则免费。
• CASEMARGIN_API_URL（可选）——API 基础 URL。默认为 https://casemargin.com/api（重建值；见下文“端点来源”）。

密钥遵循一条安全规则：如果基础 URL 使用非 https 协议，且不是环回地址（localhost、127.0.0.1、::1），同时又配置了密钥，那么每个工具都会拒绝执行，并提示 refusing to send CASEMARGIN_API_KEY over a non-https origin，且不会发出请求，因此密钥绝不会以明文发送。允许使用 http 环回基础 URL，例如本地开发服务器。本次重建中，检查会在每次调用时执行，而非启动时执行，因此服务器本身仍会启动；这是有意为之并已标明的偏差。

工具

• generate_case_brief — 根据工单对话生成结构化简报：quick_scan（评估、下一步和状态）、full_brief（当前问题、已采取的措施及其结果，以及关键背景）和 metadata（输入长度、简报长度和压缩率）。ticket_content 必须是长度为 10 到 50,000 个字符的字符串。
• check_escalation_readiness — 判断工单是否已准备好升级至 L2：overall_score 为 0 到 100，readiness 为准备度判定，包含五个评分维度 dimensions（问题清晰度、故障排查证据、业务影响、下一步行动和账单申诉依据，每项均包含分数和说明），L2 可能提出的问题（predicted_l2_questions），以及工单仍缺少的内容（missing_items）。ticket_content 必须是长度为 10 到 20,000 个字符的字符串。

任何请求发出前都会进行长度验证；验证失败时，根据所用工具提示 ticket_content must be a string of 10 to 50000 characters 或 ticket_content must be a string of 10 to 20000 characters。上游返回非 2xx 响应时会报错 casemargin error: HTTP <status>；API 无法访问时会报错 casemargin unreachable。

端点来源

原服务的 README 指定了环境变量名称、基于请求头的密钥传递方式、长度限制和上述拒绝规则，但没有指定默认基础 URL 或两个请求路径。这三项均为重建值，已在此标明：

• 默认基础 URL https://casemargin.com/api — 重建值。
• 使用 JSON 请求体 {"ticket_content": "..."} 向 <base>/case-brief 发送 POST 请求 — 重建值（供 generate_case_brief 使用）。
• 使用相同格式的请求体向 <base>/escalation-readiness 发送 POST 请求 — 重建值（供 check_escalation_readiness 使用）。

命令行界面

每个工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/casebrief generate_case_brief '{"ticket_content":"Customer reports the export fails since Tuesday..."}'
npx @reneturcios/casebrief check_escalation_readiness '{"ticket_content":"Customer reports the export fails since Tuesday..."}'
npx @reneturcios/casebrief --version

输出为工具的结果文本（成功时为上游 JSON）。退出码：成功时为 0，运行时错误（包括验证失败、拒绝执行或上游失败）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/casebrief mcp

MCP 客户端配置（密钥为可选项；如有密钥，请通过客户端的环境变量提供）：

{
  "mcpServers": {
    "casebrief": {
      "command": "npx",
      "args": ["-y", "@reneturcios/casebrief", "mcp"],
      "env": {
        "CASEMARGIN_API_KEY": "<your key>"
      }
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/casebrief
docker run --rm ghcr.io/cloudcorprecords/casebrief generate_case_brief '{"ticket_content":"Customer reports the export fails since Tuesday..."}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios