与控制台首页 screenconsole 中「快捷入口」区域对接的后端为:
/api/system/user_workbench_shortcut/sort、id 升序):GET 无路径参数POST(与当前用户、租户自动绑定,不可代他人建)GET|PUT|PATCH|DELETE /api/system/user_workbench_shortcut/{id}/data 中,为 数组 或 分页 { results: [] };解析见 userWorkbenchShortcutApi.ts 中 unwrapShortcutListData。path(web_path / link / url 等别名字段由适配层读取,绝对 URL 会取 pathname 再与菜单 id 匹配)、槽位 sort(0~4 或 1~5)、是否「常用」/ 橙色高亮(与 index.vue 里「标记为常用」单选、即 highlightIndex 一致:写入时 is_frequent 与 is_active 在同一条上为 true,其余槽为 false;读列表时在 getFrequentFromRow 中把 is_frequent、is_active 等一并当作「是否常用」判断;若你方将 is_active 仅用于启用/未删除且五条均为 true,则不要用该字段表示常用,从 getFrequentFromRow 的键列表中去掉 is_active,仅在写入时删除 is_active 或恒传 true,按你方实际含义改 quickEntryServerAdapter.ts),以及展示用名称、link、icon(见 resolveShortcutDisplayName / resolveShortcutLink / resolveShortcutIcon)。quickEntryServerAdapter.ts 中的 WORKBENCH_SHORTCUT_WRITE 与 getShortcutPathFromRow / getShortcutNameFromRow / getShortcutIconFromRow 的读取逻辑,勿在多个页面里硬编码。id 的槽位用 PATCH 同一路径,无 id 的用 POST;不主动批量删除,除非后续产品要求「以服务端为唯一全量集」并单独实现同步删除策略。GET 无数据、解析失败或请求异常时,仍使用原逻辑:按本地缓存 screenconsole_quick_entry_v2 与侧栏可访问菜单的默认/填充规则生成五项。