docs(integration): promote Learning project catalog

This commit is contained in:
2026-08-20 00:17:42 +08:00
parent d967b0f6bf
commit a5fc8bf596
14 changed files with 114 additions and 115 deletions

View File

@@ -38,7 +38,7 @@ README 中的远程图片在“发布”时由服务端解析 Markdown AST 并
2. 每一跳重新解析 DNS并拒绝 loopback、私网、链路本地、保留地址、云元数据地址和非公网目标最多 5 次重定向。
3. 单图最大 10 MiB同时限制超时、并发数和 README 图片总量;响应必须是实际可解码的 PNG/JPEG/WebP/GIF/AVIF拒绝 SVG、HTML、XML 和 MIME 欺骗。
4. 将通过校验的字节写入受控对象存储,以内容摘要去重;发布记录引用不可变对象。
5. 把 Markdown 图片地址改写为 `/api/learning/projects/:projectId/media/:mediaId`。详情接口只返回改写后的 Markdown不返回原始远程 URL或对象 key。
5. 把 Markdown 图片地址改写为 `/api/learning/projects/:projectId/media/:mediaId`。详情接口只返回改写后的 Markdown不返回原始远程 URL 或对象 key。
6. Markdown 原始 HTML在客户端被禁用服务端也应在预览与发布时提示被忽略的 HTML避免运营误判展示效果。
封面同样优先返回固定媒体路径。若返回 HTTPS CDN 地址,该地址必须无凭据、由 Works Square 控制且不包含用户隐私。