Happy Thoughts

Happy Thoughts 是一个围绕简单拆分构建的答案产品：

• 共识 (Consensus) 帮助用户思考

• 事实核查 (Fact-checking) 帮助用户建立信任

面向公众的理念不是“选择正确的模型”。 而是：先获得一个有用的答案，当风险较高时，再为更强的验证付费。

从这里开始

如果您刚进入本仓库，请按此路径操作：

1. 了解产品 → 阅读此 README

2. 查看公共 API 接口 → public/llm.txt 或 public/openapi.json

3. 作为提供商集成 → docs/PROVIDER_QUICKSTART.md

4. 借鉴实用模式 → docs/PROVIDER_EXAMPLES.md

5. 探索实践中的提供商合约 → docs/HOSTED_PROVIDER_DELIVERY.md

Related MCP server: hyperd-mcp

本仓库的目标受众

• 集成买家流程的构建者

• 集成供应端的托管提供商

• 审查计划、权益和公共产品行为的运营人员

• 需要合约而非秘密内部实现的协作者

架构一览

将 Happy Thoughts 视为一个简单的 3 层堆栈：

1. 买家层

   • 人类或智能体请求答案

   • 免费从“共识”开始

   • 付费解锁“事实核查”

2. 产品层

   • 执行计划、配额和门控

   • 通过公共合约路由请求

   • 返回带有置信度 + 注意事项的清晰答案格式

3. 提供商层

   • 托管提供商和 Webhook 提供商在底层提供答案

   • 提供商依然重要，但用户无需先了解后端机制

这种分离正是核心所在：产品在顶层感觉简单，而供应端在底层保持灵活。

产品框架

共识 (Consensus)

免费或有上限的入口路径。

共识比较多个模型响应，将其合成为一个单一答案，并返回置信度和注意事项。它专为以下场景设计：

• 日常问题

• 探索性思考

• 低风险决策支持

• 广泛的可访问性

事实核查 (Fact-checking)

付费信任层。

事实核查是针对那些事实置信度比速度或成本更重要的提示词的高保证分支。在内部，请求模式为了兼容性仍然是 verified，但公共产品语言称为事实核查。它旨在返回简洁的最终答案，同时在底层保留更深层的验证结构。它专为以下场景设计：

• 事实核查风格的审查

• 高风险提示词

• 更强的信任信号

• 高级 UX 和计费路径

本仓库包含的内容

• Cloudflare Worker 应用程序代码

• 答案路由和合成逻辑

• 计划/权益脚手架

• 提供商注册 + 托管提供商管道

• 计费和激活流程

• 法律/公共产品文档

• Worker 接口的精选公共代码示例

公共仓库边界

本仓库旨在展示产品界面和集成合约，而非每一个内部排名或编排决策。

公共文档应解释：

• 买家可以调用什么

• 提供商可以集成什么

• 存在哪些计划/门控

• 哪些响应形状和控制是稳定的

公共文档不应泄露：

• 内部加权逻辑

• 私有路由启发式算法

• 隐藏的排名旋钮

• 秘密评估秘方

项目的有趣之处

• 产品化的多模型编排

• 从免费到付费的答案阶梯

• 托管提供商市场方向

• 配额和权益执行

• 提供商故障时的优雅降级

• Worker 原生部署模型

当前实施方向

• 公共请求默认倾向于 共识

• 强制执行免费共识配额

• 事实核查 作为门控付费路径存在

• 提供商供应仍然存在于产品界面之下

• PayPal 捕获流程已强化，仅在完成捕获后激活

可靠性模型

共识旨在优雅地降级。

如果一个提供商失败，请求应在可能的情况下继续完成。 故障元数据会被呈现出来，而不是默默地假装一切完美。

重要的响应级概念包括：

• confidence

• confidence_reason

• models_used

• models_failed

• meta.degraded

• meta.failure_count

计费路径

Happy Thoughts 目前支持两种激活方式：

• x402 / 智能体原生 流程

• PayPal 用于传统结账

PayPal 激活是基于捕获的，而非仅基于批准。 这使得权益激活与实际完成的支付挂钩。

API 调用示例

这些示例是有意为之的产品级且经过脱敏的。它们展示了如何使用 Happy Thoughts 而不暴露内部评分或编排逻辑。

请求共识答案

curl -X POST https://happythoughts.proteeninjector.workers.dev/think \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Give me the strongest argument against this idea.",
    "buyer_wallet": "0xabc123...",
    "mode": "consensus"
  }'

想要垂直领域的示例而不是通用的示例？ 请参阅 docs/PROVIDER_EXAMPLES.md。

请求事实核查

curl -X POST https://happythoughts.proteeninjector.workers.dev/think \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fact-check this product claim and call out weak evidence.",
    "buyer_wallet": "0xabc123...",
    "mode": "verified"
  }'

托管提供商轮询循环

curl https://happythoughts.proteeninjector.workers.dev/provider/jobs/next \
  -H "Authorization: Bearer htp_your_provider_token"

curl -X POST https://happythoughts.proteeninjector.workers.dev/provider/jobs/JOB_ID/respond \
  -H "Authorization: Bearer htp_your_provider_token" \
  -H "Content-Type: application/json" \
  -d '{
    "thought": "Short, direct answer here.",
    "confidence": 0.91,
    "meta": {"style": "direct"}
  }'

仓库结构

• src/ — Worker 逻辑

• public/ — 公共站点资源

• docs/ — 公共集成和提供商文档

• legal/ — 条款、隐私、提供商协议、AUP

有用的入口点

• 公共 API 摘要： public/llm.txt

• 机器可读规范： public/llms-full.txt

• OpenAPI： public/openapi.json

• 提供商快速入门： docs/PROVIDER_QUICKSTART.md

• 提供商示例包： docs/PROVIDER_EXAMPLES.md

• 专业领域列表： docs/SPECIALTIES.md

• 注册快速入门： docs/REGISTRATION_QUICKSTART.md

关于公共清洁度的说明

当本仓库呈现为以下内容时，其价值最高：

• 一个产品工程仓库

• 一个计费 + 权益仓库

• 一个多模型答案系统

• 一个 Worker 原生 API/应用部署

而不是“又一个 LLM 包装器”。

建议的入门文档

• docs/PROVIDER_QUICKSTART.md

• docs/PROVIDER_EXAMPLES.md

• docs/REGISTRATION_QUICKSTART.md

• docs/HOSTED_PROVIDER_DELIVERY.md

状态

活跃的产品仓库，方向明确： 免费共识，付费事实核查，底层提供商基础设施。