法眼·AI合同审查

SKILL.md

# 法眼（LawEye）v2.3.0

> AI 合同风险审查技能，接入 ClawHub + 支付宝 AI 收，统一 ¥0.50/次付费。

## 简介

法眼（LawEye）是一款基于规则引擎的 AI 合同风险审查服务，通过 ClawHub 平台对外提供技能调用。用户上传合同文本后，服务自动识别违约责任、知识产权、付款条件、保密条款等 15 类法律风险，并输出结构化审查报告。

**本技能已接入支付宝 AI 收（Alipay AI Pay），调用时自动触发支付流程，无需人工干预。**

## 前置要求

使用本技能前，用户需在 ClawHub 中提前安装以下技能：

- **`alipay-authenticate-wallet`** — 开通支付宝钱包能力，完成支付宝身份认证和授权。安装方法：对智能体说"从 ClawHub 帮我安装 alipay-authenticate-wallet、alipay-payment-skill，安装后帮我开启支付宝支付功能"，按指引完成授权开通。
- **`alipay-pay-for-402-service`** — 处理 HTTP 402 支付拦截，自动完成扫码支付流程。当技能返回 402 状态码时，此技能自动接管支付交互，无需手动处理。

## 端到端收费流程

```
用户调用技能
    ↓
AI 读取合同内容并发送审查请求
    ↓
服务端返回 HTTP 402 Payment Required
（附支付信息：¥0.50，服务ID: API_58301E4006C04DD4）
    ↓
ClawHub 自动激活 alipay-pay-for-402-service 技能处理支付拦截：
  1. 保存 Payment-Needed 响应头中的支付信息
  2. 调用 alipay-bot 402-buyer-pay 发起支付请求
  3. 用户扫码完成支付宝付款（¥0.50）
  4. 查询支付状态，确认支付成功
  5. 将支付凭证写入 X-Payment-Credential 请求头
    ↓
带 X-Payment-Credential 头重试审查请求
    ↓
服务端校验凭证 → 调用审查引擎 → 自动返回合同审查报告
```

- **支付服务**：支付宝 AI 收，服务 ID：`API_58301E4006C04DD4`
- **支付拦截处理**：由 ClawHub 的 `alipay-pay-for-402-service` 技能自动接管，完成保存 Payment-Needed 头 → 调起 alipay-bot → 用户扫码 → 查询状态 → 带凭证重试的全流程
- **履约确认**：支付成功后服务端自动调用 `alipay.aipay.agent.fulfillment.confirm` 确认履约

## 定价

| 档位 | 价格 | 说明 |
|------|------|------|
| standard | ¥0.50/次 | AI合同风险审查，覆盖违约责任、知识产权、付款条件等15类法律风险 |

> 自 v2.3.0 起，原 basic（¥0.10）/ pro（¥1.00）分档定价统一为 ¥0.50/次，简化计费模型。

## API 端点

- **基础 URL**：`https://ai-gaoqian.xyz`
- **审查接口**：`POST /review`
- **健康检查**：`GET /health`

## 请求格式

```http
POST /review HTTP/1.1
Host: ai-gaoqian.xyz
Content-Type: text/plain; charset=utf-8
X-Payment-Credential: <支付宝支付凭证>
X-Service-Tier: standard

<合同全文>
```

### 未支付时（402 响应）

```http
HTTP/1.1 402 Payment Required
X-Payment-Info: {"service":"法眼·AI合同审查","amount":"0.50","currency":"CNY", ...}
X-Payment-Provider: alipay

{"error": "payment_required", "payment_info": {...}, "hint": "请使用支付宝 AI 付完成支付后，在请求头 X-Payment-Credential 中附带支付凭证重试"}
```

## 响应格式

支付成功后返回 JSON 格式审查报告：

```json
{
  "risks": [
    {
      "clause": "违约责任",
      "risk_level": "high",
      "description": "违约金上限未设，存在超额赔偿风险",
      "suggestion": "建议增加违约金上限条款，不超过合同总金额的 30%"
    }
  ],
  "summary": "本合同存在 3 处高风险条款，建议重点审查违约责任与知识产权归属。",
  "score": 62
}
```

## requires.env

> 以下环境变量由服务端配置，技能调用者无需关心。

| 变量名 | 说明 | 必填 |
|--------|------|------|
| `ALIPAY_APP_ID` | 支付宝应用 APP ID | 是 |
| `ALIPAY_PRIVATE_KEY_PATH` | 应用私钥路径 | 是 |
| `ALIPAY_PUBLIC_KEY_PATH` | 支付宝公钥路径 | 是 |
| `LAWEYE_PORT` | 服务监听端口，默认 8888 | 否 |

## 更新日志

| 版本 | 日期 | 说明 |
|------|------|------|
| v2.3.0 | 2025-07 | 接入支付宝 AI 收（服务ID: API_58301E4006C04DD4），统一 ¥0.50/次付费；删除 basic/pro 分档定价；更新 SKILL.md 收费流程说明 |
| v2.2.0 | 2025-06 | 修复凭证校验逻辑，增加 sandbox/production 环境切换 |
| v2.1.0 | 2025-05 | 初始版本，basic/pro 分档定价 |

## 部署

详见 `deploy.md`（服务端部署指南）。