图像与设计
在编写/审查/调试 Fishjam 后端或客户端代码时…
当代码需要与 Fishjam 实例交互(Node/Python 后端、React/React Native/TS 客户端或直接 REST)时使用,按平台与 SDK 文档操作并遵守 token/Sandbox 安全规则。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
在编写/审查/调试 Fishjam 后端特定
解决思路
- 先阅读 `references/platform/SKILL.md`,获取领域模型:rooms、peers、tracks、tokens、notifications。
- 再阅读与你正在构建内容匹配的 SDK 子技能;所有子技能位于 `references/`。
- 任何 Fishjam 相关工作,从 `references/platform/SKILL.md` 开始,查阅术语表、房间类型、认证、通知、REST。
- 编写 Node.js / Express / Fastify / Hono 后端时,阅读 `references/js-server-sdk/SKILL.md`。
- 编写 Python / FastAPI / Flask 后端时,阅读 `references/python-server-sdk/SKILL.md`。
- 编写浏览器 React 应用时,阅读 `references/react-client/SKILL.md`。
- 编写 iOS/Android 的 React Native / Expo 应用时,阅读 `references/react-native-client/SKILL.md`。
- 编写 Vanilla TS / Svelte / Vue / web worker(非 React)时,阅读 `references/react-client/SKILL.md`,再读 `ts-client-escape.md`,使用 `@fishjam-cloud/ts-client`。
- 直接调用 REST(不用 SDK)时,阅读 `references/platform/rest-endpoints.md`。
- 生产 Fishjam 应用始终采用后端(server SDK)+ 客户端(client SDK)架构。
- 原型阶段可跳过后端,改用 Sandbox API;参见 `references/platform/sandbox-vs-production.md`。
- management token 永不离开后端;若泄露,从 Dashboard 重新生成。
- peer token 自创建起有效 24 小时;token 在初始 WS handshake 期间被消费;已建立的会话可自行继续运行。
- 如果 peer 尚未连接,或 24 小时后需要重连,调用 `refreshPeerToken` / `refresh_peer_token` 生成新 token。
- Sandbox API URL 仅限开发环境;任何持有该 URL 的人都能在你的账户上创建房间;绝不将其放入生产客户端构建。
适用边界 · 注意事项
- 不适用于非 Fishjam 的 WebRTC、视频、音频或直播项目。
- 不适用于没有 Fishjam 账号、Dashboard、management token 或相关 SDK 的场景。
- 若只能用 Sandbox API 且无法部署生产后端,不应将其作为生产方案。