BI Palette 使用指南

1. 浏览公域池

首页默认显示公域池。你可以按「最新」「收藏数」「官方优先」排序，点击卡片缩略图预览完整 BI 看板效果。

2. 收藏与点赞

登录后可以收藏或点赞公域方案。收藏会出现在 Workbench 的「我的收藏」集合中；点赞只表达偏好，不会复制方案到「我的方案」。

3. AI 生成方案

在 Workbench 顶部的 AI 输入区用自然语言描述想要的 BI 配色风格即可生成方案。生成结果会先进入预览区，你可以预览、保存、丢弃或再次生成。

4. 我的方案

「我的方案」只展示你保存过的 AI 生成方案。你可以预览、删除，或将它发布到公域池；发布前系统会要求确认。

5. 公开与取消公开

发布到公域池后，其他登录用户可以看到、收藏和点赞。取消公开后，该方案会从公域池和其他用户的收藏列表中消失。

6. API 调用

平台提供公开的查询 API，无需登录即可在任意程序中读取公域池的配色方案。接口地址为 https://www.bicolor.design，响应为标准 JSON。

curl "https://www.bicolor.design/api/palettes?sort=favorites&pageSize=5"

curl "https://www.bicolor.design/api/palettes/11111111-1111-4111-8111-111111111111"

常用参数：sort（latest / favorites / official）、page、pageSize（1–100）、source（preset / ai_generated / user_custom）。每个方案返回 12 个语义色与仪表板/组件双背景色。接口限流为每 IP 60 次/分钟，完整文档见 docs/API.md。