Decide

🚀 decide.fyi

Decide.fyi 为美国消费者提供确定性的订阅决策公证服务，帮助用户快速、准确地了解订阅服务的退款、取消、退货和试用等相关政策。

🚀 快速开始

一键安装

点击按钮将安装 Refund Notary 服务器。若要添加全部 4 个服务器，请使用 下方的 JSON 配置。

通过 MCP 连接（Claude 桌面版 / Windsurf / 其他客户端）

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

REST API

# 退款资格检查
curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

# 取消订阅惩罚检查
curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

# 退货资格检查
curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

# 试用条款检查
curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

本地开发检查

启动本地开发服务器：

npx vercel dev

在另一个终端中：

# 处理程序级冒烟测试（无需运行服务器）
npm run smoke

# MCP 端点检查（需要在本地主机:3000 上运行 vercel dev）
npm run mcp:check

# 端到端工作流测试（示例 -> 结果）
npm run workflow:test

✨ 主要特性

• 多服务支持：提供退款、取消订阅、退货和试用条款的检查服务。
• 多客户端兼容：支持多种客户端，如 Cursor、VS Code、Claude、ChatGPT 等。
• 数据实时性：每日自动检查供应商政策页面，确保数据新鲜度。
• 架构优势：无状态、确定性、版本化规则、每日监控、无服务器、零依赖。

📦 安装指南

一键安装

可通过以下按钮一键安装 Refund Notary 服务器：

若要添加全部 4 个服务器，请使用 下方的 JSON 配置。

通过 MCP 连接

使用以下 JSON 配置连接到所有服务：

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

💻 使用示例

基础用法 - REST API

退款资格检查

curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

取消订阅惩罚检查

curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

退货资格检查

curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

试用条款检查

curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

高级用法 - Zendesk 工作流编排

当你希望一个请求返回以下内容时，可以使用工作流端点：

• 来自 /api/decide 的决策分类 (yes | no | tie)
• 相关公证端点的政策结果
• 推荐的 Zendesk 操作 + 标签 + 包含 request_id 的私有备注

端点

• POST https://refund.decide.fyi/api/v1/workflows/zendesk/refund
• POST https://cancel.decide.fyi/api/v1/workflows/zendesk/cancel
• POST https://return.decide.fyi/api/v1/workflows/zendesk/return
• POST https://trial.decide.fyi/api/v1/workflows/zendesk/trial

请求示例

{
  "ticket_id": "ZD-9001",
  "workflow_type": "refund",
  "question": "Should this Adobe annual plan refund request proceed under policy?",
  "vendor": "adobe",
  "region": "US",
  "plan": "individual",
  "days_since_purchase": 5
}

对于 refund 和 return 请求，请包含 days_since_purchase。

确定性测试模式

在测试和持续集成期间，可以设置 decision_override 来绕过模型分类：

{
  "decision_override": "yes"
}

响应示例

{
  "ok": true,
  "flow": "zendesk_refund_v1",
  "ticket_id": "ZD-9001",
  "decision": { "c": "yes", "request_id": "req_123" },
  "policy": { "verdict": "ALLOWED", "code": "WITHIN_WINDOW" },
  "action": {
    "type": "approve_refund",
    "zendesk_tags": ["decide", "decide_yes", "refund_allowed"]
  }
}

📚 详细文档

MCP 服务器信息

所有服务器支持 100 个供应商，服务区域为美国，仅支持个人计划，无状态，无需认证，每分钟 100 个请求。

支持的供应商

服务范围：仅支持美国地区的个人计划。

数据新鲜度

政策信息来源于供应商的官方文档和服务条款。

• 每日自动检查：GitHub Action 会在协调世界时 08:00 运行，对所有 4 项服务（退款、取消、退货、试用）的供应商政策页面进行哈希处理。如果页面发生变化，将开启一个问题进行审核。
• 政策源 URL 跟踪：每个服务在 rules/ 目录下都有自己的源文件，链接到官方政策页面。
• 合规性导出：GET /api/compliance-export 返回跟踪源、哈希值和待处理候选更改的 CSV 快照（?format=json 可获取机器可读输出）。
• 规则版本化：每个规则文件都包含一个 rules_version 字段，用于检测数据陈旧性。

免费 API（默认：无需认证）

所有 4 个政策服务器均可免费使用，无需认证，也无需 API 密钥。 /api/decide 默认公开，可通过在服务器环境变量中设置 DECIDE_API_KEY 进行保护。 如果你在 decidesite 代理后面运行 decide 并使用动态客户密钥，还需设置：

• DECIDE_PROXY_SHARED_TOKEN：在 x-decide-proxy-token 头中需要的共享密钥，用于可信代理调用。
• DECIDE_API_KEY：可信代理转发到上游的后端内部密钥（建议保持后端私有）。

速率限制：每个 IP 每分钟 100 个请求。

政策获取钩子（用于政策检查器浏览器钩子通道）

当直接获取被阻止时，可以使用 POST /api/policy-fetch-hook 作为每日检查器的获取适配器。

请求体：

{
  "url": "https://example.com/policy",
  "vendor": "example_vendor",
  "policy_type": "refund",
  "timeout_ms": 18000
}

认证：

• Authorization: Bearer <POLICY_CHECK_BROWSER_HOOK_TOKEN> 或 x-hook-token: <token>

服务器环境变量：

• POLICY_CHECK_BROWSER_HOOK_TOKEN（端点认证必需）
• POLICY_FETCH_BROWSERLESS_TOKEN（可选；启用无头浏览器渲染优先）
• POLICY_FETCH_BROWSERLESS_CONTENT_URL（可选覆盖；默认 https://chrome.browserless.io/content）
• POLICY_FETCH_ALLOWED_HOSTS（可选，逗号分隔的主机白名单）

检查器（GitHub Actions，仓库 decide）：

• 密钥 POLICY_CHECK_BROWSER_HOOK_URL = 部署的端点 URL（例如：https://decide-1.vercel.app/api/policy-fetch-hook）
• 密钥 POLICY_CHECK_BROWSER_HOOK_TOKEN = 与运行时环境相同的令牌
• 变量 POLICY_CHECK_FETCH_LANES_DEFAULT = browser_hook,direct,zendesk_api,mirror

如有疑问，请联系 decidefyi@gmail.com 或在 X 平台上联系 @decidefyi。

链接

• 网站：https://decide.fyi
• 退款服务：https://refund.decide.fyi
• 取消订阅服务：https://cancel.decide.fyi
• 退货服务：https://return.decide.fyi
• 试用服务：https://trial.decide.fyi
• X/Twitter：@decidefyi
• MCP 规范：https://modelcontextprotocol.io

🔧 技术细节

架构特点

• 无状态：无需数据库、会话，无副作用。
• 确定性：相同输入始终产生相同输出。
• 规则版本化：规则文件包含版本信息，便于跟踪更改。
• 每日监控：GitHub Action 每日检查所有供应商政策页面。
• 无服务器：运行在 Vercel 无服务器函数上。
• 零依赖：核心计算逻辑无外部依赖。
• 主机名路由：Vercel 中间件将子域名路由到正确的 MCP 端点。

局限性

• 仅支持美国地区：目前仅支持美国区域。
• 仅支持个人计划：暂不支持企业/商业计划。
• 按自然日计算：时间窗口基于自然日，而非工作日。
• 静态规则：未考虑促销优惠或特殊情况。

📄 许可证

文档未提及相关许可证信息。

📝 更新日志

未发布

• 新增：GET /api/compliance-export 端点，用于导出政策监控证据（默认 CSV 格式，可通过 ?format=json 获取 JSON 格式）。
• 新增：合规性导出 JSON 和 CSV 路径的冒烟测试覆盖。

v1.2.1 (2026-02-08)

• 更改：子域名主页现在显示相关的公证卡片（退款/取消/退货/试用）。
• 更改：server.json、MCP initialize 和 /.well-known/* 中的版本元数据保持一致。

v1.2.0 (2026-02-02)

• 新增：Cancel Notary MCP（cancel.decide.fyi）—— 取消订阅惩罚检查器。
• 新增：Return Notary MCP（return.decide.fyi）—— 退货资格检查器。
• 新增：Trial Notary MCP（trial.decide.fyi）—— 免费试用条款检查器。
• 新增：基于主机名的中间件路由，适用于所有子域名。
• 新增：取消、退货和试用政策的政策源文件和每日检查。
• 新增：着陆页上的人类/代理模式切换。
• 新增：包含所有 4 个服务器卡片的 MCP 目录。
• 修复：每日政策检查器：添加 contents:write 权限并修复 shell 逻辑。
• 修复：移除导致 404 错误的无效 Cloudflare 电子邮件解码脚本。

v1.1.0 (2026-02-01)

• 新增：支持的供应商数量从 64 个扩展到 100 个。
• 新增：每日政策检查 GitHub Action（协调世界时 08:00 定时执行）。
• 新增：rules/policy-sources.json 中跟踪政策源 URL。
• 新增：MCP 供应商 enum 输入模式，便于代理发现。
• 修复：Vercel 上的 ERR_IMPORT_ATTRIBUTE_MISSING 崩溃问题（Node 22 导入属性）。

v1.0.0 (2026-01-15)

• 新增：初始版本，包含 REST API 和 MCP 服务器。
• 新增：支持 9 个供应商。

由 decide.fyi 团队用心打造。