yinjianm
f7cef30b9c
补齐订单、优惠券、主题、插件、公告与支付管理页面， 接入对应后台接口、路由入口与工具层类型定义。 同时修复套餐页开关初始化误写问题，避免浏览即触发写操作。 在订阅协议侧为 Stash 导出增加 AnyTLS 版本守卫， 未知版本或低于 3.3.0 时不再导出该协议，并补充回归测试与知识记录。
2.6 KiB
2.6 KiB
admin-frontend 插件管理首版交付 — 需求
确认后冻结，执行阶段不可修改。如需变更必须回到设计阶段重新确认。
核心目标
- 在
admin-frontend中把/system/plugins从结构化占位页升级为真实插件管理工作台。 - 页面视觉继续遵循
apple/DESIGN.md与当前后台 Apple 化风格，并尽量贴近用户提供的目标截图：顶部搜索 / 分组切换 / 状态筛选 / 上传入口，下方插件卡片列表。 - 让管理员可以在同一页面完成插件浏览、筛选、上传、安装、启用 / 禁用、升级、卸载，以及 README / 配置查看与编辑。
功能边界
- 必须接入现有 Laravel 管理接口的真实数据链路：
GET /plugin/typesGET /plugin/getPluginsPOST /plugin/uploadPOST /plugin/installPOST /plugin/uninstallPOST /plugin/enablePOST /plugin/disableGET /plugin/configPOST /plugin/configPOST /plugin/upgrade
- 必须支持：
- 按关键词搜索插件
- 按插件类型切换（全部 / 功能 / 支付方式）
- 按状态筛选（全部 / 已启用 / 已安装未启用 / 未安装 / 可升级）
- 上传 zip 插件包
- 列表中直接执行安装、启用、禁用、升级、卸载动作
- 打开插件详情工作台，查看 README、基础元信息，并对可配置插件进行配置保存
- 必须覆盖加载、空列表、错误、按钮提交中、配置保存成功 / 失败等状态。
非目标
- 本轮不实现主题、公告、支付配置、知识库管理的真实 CRUD 页面。
- 本轮不新增或重构 Laravel 插件管理接口。
- 本轮不接入浏览器端拖拽上传、批量操作或插件市场远程下载能力。
- 本轮不修改
public/assets/admin子模块之外的发布流程。
技术约束
- 技术栈固定为
Vue 3 + TypeScript + Vite + Element Plus。 - 后端真相源以现有
PluginController/PluginConfigService/PluginManager为准，不在前端猜测额外字段。 - 视觉契约优先级：本方案 >
.helloagents/DESIGN.md>apple/DESIGN.md参考原则。 - 构建验证使用
admin-frontend/package.json中已有npm run build。
质量要求
- 插件管理页必须保持 Apple 风格后台的一致性，同时比现有占位页更强调运营效率与状态可读性。
- 卡片与详情工作台中的插件状态、危险动作和受保护插件边界必须清晰可辨。
- README 展示与配置编辑必须是真实数据流，不允许停留在纯展示占位。
- 最终至少完成一次构建验证，并补一份本轮 UI 验收结论。