# Star 开发者中心

Star 为多个前端站点提供统一的登录、会员、积分、支付、AI 任务、动态定价、媒体存储和访问统计能力。本开发者中心同时服务人工开发者和 AI 编程工具。

## 从这里开始

1. 在 Star Admin 注册站点，取得唯一的 `site_id`，登记生产与测试 Origin、精确登录回调地址。
2. 按[配置与登录](/docs/configuration/)接入 Star Auth，并验证登录、刷新和退出。
3. 按业务需要选择[支付与订阅](/docs/payments/)、[模型与任务](/docs/tasks/)、[聊天接入](/docs/chat/)、[动态定价](/docs/pricing/)或[AI 工具](/docs/tools/)。
4. 在全局布局加入[PV / UV 统计](/docs/analytics/)，最后执行[上线验收](/docs/verification/)。

## 服务地址

```env
AUTH_BASE_URL=https://auth.starhk.uk
PAY_BASE_URL=https://pay.starhk.uk
TASK_BASE_URL=https://task.starhk.uk
DOCS_BASE_URL=https://doc.starhk.uk
```

## 平台边界

| 服务 | 负责内容 | 前端禁止事项 |
|---|---|---|
| Star Auth | 登录、会话、会员、积分、PV / UV | 不直接修改积分或套餐 |
| Star Pay | 商品、Stripe / Airwallex Checkout、订单、退款履约 | 不提交金额，不发放权益，不暴露支付密钥 |
| Star Task | 模型、报价、扣点、同步/流式聊天、异步任务、R2 结果 | 不写死供应商，不自行计算最终扣点 |
| RokoAPI | Star Task 内部模型供应和路由 | 前端不直接持有平台 Token |

## 面向 AI 开发工具

AI 工具应从 [SKILL.md](/skill/SKILL.md) 开始，并只加载当前任务需要的在线参考文件。所有参考文件都以 `text/markdown` 返回，可跨机器直接读取。

```text
请先完整阅读 https://doc.starhk.uk/skill/SKILL.md，
再按其中路由读取与本次任务相关的 references 文档。
不要假定能访问任何本机 Star 仓库。
```

## 运行时真相来源

文档描述稳定契约；模型启停、站点可用范围、商品价格和具体扣点必须读取运行时接口。不要把后台可变数据复制成长期硬编码。

- 模型与模式：`GET https://task.starhk.uk/v1/models?view=products&site_id=<SITE_ID>`
- 聊天模型：`GET https://task.starhk.uk/v1/models?view=chat-picker&site_id=<SITE_ID>`；调用使用 `POST /v1/ai/chat`，不是 `/v1/tasks`
- AI 工具：`GET https://task.starhk.uk/v1/tools?site_id=<SITE_ID>`
- 支付能力：`GET https://pay.starhk.uk/api/v1/payment-methods/public?site_id=<SITE_ID>`
- 公共商品：`GET https://pay.starhk.uk/api/v1/products/public`

通用图片理解使用稳定工具 ID `image-understanding`，联网搜索使用 `web-search-chat`。调用、上传、轮询、失败退款和 0.01 点精度要求见 [AI 工具](/docs/tools/)；前端只依赖工具契约，不选择或感知后端实现。

## 上线原则

任何新站点都必须验证站点隔离、未登录续接、重复提交幂等、支付 Webhook 最终一致性、任务失败退款、永久媒体 URL、移动端布局和前端产物无密钥。

## 图片分辨率定价

[1K/2K/4K 分档定价接入](/docs/image-resolution-pricing/)：服务端报价、可选价格版本保护、站点自定义价格、显式跟随上游，以及已接入站点的兼容规则。