内容
# Weckr 软件开发工具包
面向 SaaS 创始人的 AI 成本和利润率智能 - 精确查看哪些用户的使用成本高于其支付的费用，按 LLM 调用计算，零额外延迟。
将软件开发工具包集成到您的应用中，获取一个仪表盘，显示每个用户/功能/模型的成本，并推荐更便宜的替代方案。设置每个计划的支出上限，软件开发工具包在 LLM 调用前强制执行。
## 选择您的语言
| | 软件包 | 安装 | 源代码 |
|---|---|---|---|
| **TypeScript / Node** | [`@weckr/sdk`](https://www.npmjs.com/package/@weckr/sdk) | `npm install @weckr/sdk` | [`typescript/`](./typescript) |
| **Python** | [`weckr-sdk`](https://pypi.org/project/weckr-sdk/) | `pip install weckr-sdk` | [`python/`](./python) |
| **Claude / Cursor (MCP)** | [`@weckr/mcp`](https://www.npmjs.com/package/@weckr/mcp) | `npx -y @weckr/mcp` | [`mcp/`](./mcp) |
每个子文件夹都有完整的设置文档、示例和支持的模型列表。
## 无需注册即可试用
[**实时演示仪表盘 →**](https://app.useweckr.com/demo)
使用虚构的 SaaS 的种子数据进行点击，无需注册。
## 启动模板
克隆一个已经集成 Weckr 的完整 AI SaaS，几分钟内即可部署。两者都使用 MIT 许可证。
* [weckr-nextjs-starter](https://github.com/Ghiles3232/weckr-nextjs-starter): Next.js 14、Supabase 身份验证、Stripe 计费、OpenAI 端点和 Weckr 跟踪每个用户的成本和利润率。
* [weckr-fastapi-starter](https://github.com/Ghiles3232/weckr-fastapi-starter): FastAPI、Claude 端点、SQLite 和 Weckr 跟踪每个用户的成本和利润率。
## 工作原理
1. 您使用 `wk.chat(client, opts)` 包装 LLM 调用。
2. 软件开发工具包将调用转发到 OpenAI / Anthropic / Gemini，并返回原始结果 - 在请求路径上没有增加延迟。
3. 调用完成后，软件开发工具包将日志异步发送到 Weckr API，包含 `(userId, feature, model, tokens, latency, plan)`。
4. 后端根据公开的每个令牌定价计算成本（客户端无法伪造成本），并存储每个请求的 `(cost, revenue, margin)`。
5. 仪表盘汇总了每个用户、每个功能、每个模型的成本和利润率，并显示亏损用户和更便宜的模型推荐。
## 发送的内容
仅发送上述调用元数据 - 模型名称、令牌计数、延迟、计划和您的 `userId` 字符串。**绝不会发送提示文本或完成文本。**
## 获取 API 密钥
[app.useweckr.com](https://app.useweckr.com) - 免费层级，无需信用卡。
## 问题和支持
对集成有疑问或有功能请求？
开启讨论：https://github.com/Ghiles3232/weckr-sdks/discussions
我们会回复每一个问题。
## 许可证
MIT - 请参阅 [LICENSE](./LICENSE)。
