用途：整理 Kuroco HeadlessCMS 的 API 设计与内容管理最佳实践，供前端集成与管理操作参考。官方文档可用 /kuroco-docs 技能检索。
主要能力： Part 1 API 集成：端点路径形如 https://{站点键}.g.kuroco.app/rcms-api/{api_id}/{endpoint_path}，可配置模型、操作、缓存、流量限制、是否必须认证。认证支持无认证、静态访问令牌（请求头 X-RCMS-API-ACCESS-TOKEN）、动态访问令牌（JWT）、Cookie（前端需 credentials: 'include'）。令牌认证分两步：先向 login 提交邮箱密码取得 grant_token，再向 token 端点交换 access_token/refresh_token（token 端点不接受邮箱密码）。还包含 IP 限制、CORS 头设置、CSRF 防护、请求限制与浏览限制优先级、后处理输出白名单、缓存清理范围与手动清理、限流响应头与 429 处理、错误码 400/401/403/404/429/500。 Part 2 内容管理：内容定义（TopicsGroup）、分类、扩展字段（键名因站点而异，需用 whoami 的 site.topics_ext_key_format 确认，并以 topics-describe 确定编号对应关系）、Topics API 的 list/details/insert/update/delete/bulk_upsert、筛选语法 filter 与 order_query（分类字段为 contents_type，值用双引号）、文件上传与 CSV 操作、Admin MCP 管理操作。
使用方式：前端按认证方式调用 rcms-api；管理操作通过 Admin MCP 进行，insert/update/delete 必须先经用户确认。
适用场景：Kuroco 站点前端 API 集成、内容 CRUD、数据批量操作与结构确认。
限制：扩展字段上限取决于站点，JSONB 站点 999、旧格式 99；安全设置变更会使已发令牌失效；CORS 变更受 CORS_MAX_AGE 缓存影响；非标准途径更新数据不会自动清缓存。未提供的细节暂未说明。