ruoyi-ai/docs/url-management.md

URL 管理

URL 管理用于维护 Copilot 新建编程任务页的常用链接。管理端入口为“系统管理 → URL管理”（/system/url），支持新增、编辑、批量删除、名称和状态筛选及分页。

安装与权限

已有数据库执行 增量脚本，可重复执行。新安装使用包含 URL 表、菜单及初始链接的全量 docs/script/sql/ruoyi-ai.sql。脚本创建 sys_url 表和菜单；普通管理角色需分配对应菜单及按钮权限。

接口	权限	用途
GET /system/url/list	system:url:list	名称、状态筛选和分页
GET /system/url/{urlId}	system:url:query	编辑回填
POST /system/url	system:url:add	新增
PUT /system/url	system:url:edit	编辑
DELETE /system/url/{urlIds}	system:url:remove	删除，多个 ID 以逗号分隔
GET /system/url/shortcuts	coding:harness:use 或 system:url:list	当前租户的已启用链接

链接地址仅允许带有效主机名的 HTTP(S) 地址。状态 0 表示启用，1 表示停用；列表和快捷入口按 sortOrder、urlId 升序排列。数据查询和修改遵循当前租户隔离。

使用

在管理端填写名称、地址、说明、顺序和状态后保存。Copilot 点击“新建编程任务”会刷新快捷入口；停用的链接不显示。卡片显示名称、说明和外链标识，并以 noopener,noreferrer 在新标签页打开。加载中、空列表和请求失败均有提示，失败时可重试。

后端实现位于 ruoyi-modules/ruoyi-system 的 SysUrlController、SysUrlServiceImpl；管理端位于 ruoyi-admin/apps/web-antd/src/views/system/url；Copilot 使用 UrlShortcutCards.vue 和 useUrlShortcuts.ts。

2026-09-08 最终验收

• 后端打包、管理端构建和 Copilot 构建通过；Copilot 构建包含类型检查。
• URL 接口 14/14，覆盖 CRUD、分页、排序、输入校验、权限和租户隔离。
• Copilot 单元测试 18/18，卡片状态与点击检查 7/7，EXTERNAL 计划工具回归 2/2。
• 增量 SQL 连续执行两次通过，全量 SQL 的 URL 模块在临时隔离库通过。
• 浏览器完成新增、编辑、筛选、停用隐藏、重新启用刷新和卡片说明检查；临时数据已清理。
• 管理端全项目仍有 103 项既有类型诊断，URL 模块为 0 项。

本轮还修复了 EXTERNAL 模式隐藏 plan_step 的框架问题，使模型能在证据校验后完成计划。原生运行和计划均已到达 COMPLETED。本轮为本地验收；未包含远程部署。新标签页打开参数通过组件测试确认，本轮未新增真实弹窗或手机尺寸实测结论。