Files
2026-11-12 11:05:55 +08:00

3.3 KiB
Raw Permalink Blame History

前端对接:缺少的接口和字段

对照《Community 前端接口对接文档》和 vibemake 现有页面整理。现有接口已全部接入(js/api.js);下面这些后端没有,前端目前先隐藏或降级。

〇、dev 环境实测发现(dev-vibemake-api.robotquan.com,2026-10-15)

  • 3D 模型改用项目字段 urdfMainUrl / urdfBaseUrl(「我的 → 设置 → 3D 模型」上传 URDF 文件夹);61 个导入项目都还没有上传,首页轮播用站内自带的 4 个模型。
  • 61 个项目的封面都是外部图片(raw.githubusercontent.com 46 个、YouTube 8 个等),国内加载慢,部分 5 MB 以上;建议迁到 OSS(前端对 OSS 图片自动请求 720px WebP 缩略图)。

一、已有接口缺少的字段

接口 / 结构 缺少字段 用在哪里 现在的处理
Project forkCount 卡片、详情页 Fork 按钮旁的数字 不显示数字
Project tags: string[] 详情页话题标签、搜索 不显示
Project license 详情页标题旁的协议徽章 不显示
Project featured(或排序值) 首页轮播精选及顺序 取最近发布、带 robot.json 的前 4 个
PublicUser avatarUrl 所有头像 用昵称首字 + 按 userCode 生成颜色
Comment parentCommentCode、replies 讨论区楼中楼回复 改成平铺评论,不能回复
Comment likeCount、liked 评论点赞 不显示
社区项目列表 查询参数 sort(likes / comments / published) 社区页排序下拉框、首页「本周热门」 隐藏排序;首页按第 1 页的 likeCount 排

二、缺少的接口

接口(建议) 用在哪里 现在的处理
GET /api/community/projects/{code}/commits 已发布版本的提交历史 详情页「动态」标签、文件列表的最近提交 隐藏「动态」标签
GET /api/community/projects/{code}/forks 谁 Fork 了这个项目 详情页「Fork」标签 隐藏「Fork」标签
PATCH /api/users/me 修改昵称 / 头像 个人设置(默认昵称是「用户_xxxx」,用户改不了) 无
GET /api/users/{userCode} + 列表加 owner 筛选 创客主页、按作者看项目 作者名不可点击
GET /api/me/likes 我收藏的项目 社区页「我的收藏」筛选 隐藏
评论回复 / 评论点赞接口 讨论区 见上
跨项目的热门评论 首页「讨论精选」 隐藏该区块
创客排行 首页「创客」 隐藏该区块
订阅(Watch) 详情页订阅按钮 去掉

三、3D 模型

已改为后端字段 urdfMainUrl:有值就在项目页、工作台显示 3D,没有就不显示(不再读取仓库里的 robot.json)。 相对网格路径按 urdfMainUrl 所在目录解析;package://包名/… 优先匹配主文件所在的同名 ROS 包目录,同时兼容 urdfBaseUrl 下的旧版扁平上传。管理端上传前按文件清单改写 URDF 的网格和贴图引用,避免嵌套包目录丢失。2026-11-12 的公开资源排查见 URDF 资源检查。

四、AI 助手

已按新版文档接入(js/assistant.js);创建 / Fork 成功后的卡片链接到工作台 /workspace/<编码>。