模板市场

模板市场用于沉淀可复用的 窗口脚本 与 执行器配置，管理端维护上架，桌面客户端浏览并一键创建。

概念

概念	说明
分类	模板分组（如「生意参谋」「通用执行器」），含名称、编码、描述、排序
模板类型	window_script（窗口脚本） / executor_config（执行器配置）
模板字段	分类、名称、描述、视频简介、图片列表、业务数据 bizPayload、发布状态
市场	仅展示 status=published 且 active=true 的模板

业务数据 bizPayload

• 窗口脚本：映射到窗口字段，例如 name / host / preload / preloadCode / cron / cronStatus / json
• 执行器配置：映射到执行器字段，例如 name / description / type / context / config / maxRetries 等

架构

管理端 (server/admin + server/front)
  模板管理 / 分类管理  ——CRUD——► DB templates / template_categories
                                         │
                                         │ 公开 API（CORS）
                                         ▼
桌面端渲染进程 (src/renderer)
  模板市场页 / 创建弹窗  ——fetch——► /api（开发：Vite 代理 → 管理端）
                                 生产：VITE_TEMPLATE_MARKET_BASE_URL

管理端

菜单：模板市场 → 模板管理 / 分类管理（seed 已写入）。

能力	路径 / API
分类 CRUD	POST /api/template-categories、/list、/update、/delete；GET /all
模板 CRUD	POST /api/templates、/list、/update、/delete
市场列表（公开）	POST /api/templates/market/list
市场详情（公开）	GET /api/templates/market/:id
市场分类（公开）	GET /api/template-categories/market

建表见 server/admin/databse/{mysql,postgres}/schema/；示例数据与菜单见对应 seed/01_seed.sql。

桌面端消费

入口	行为
顶栏「模板市场」	浏览已发布模板（分类 / 类型 / 关键词）
窗口管理 →「从模板创建」	选择 window_script → 预填创建表单
窗口操作 →「从模板填充」	用模板字段覆盖当前窗口编辑表单
执行器管理 →「从模板创建」	选择 executor_config → 预填并写入 context 等

开发模式：electron.vite.config.ts 将 /api 代理到 http://127.0.0.1:8086，前端请求基址为 /api。

生产或自定义基址：

VITE_TEMPLATE_MARKET_BASE_URL=http://localhost:8086/api

管理端需先启动且模板已发布，客户端才能拉到数据。

客户端 API（src/renderer/src/api/webApi）

API	说明
getWebApiBaseUrl / getTemplateMarketBaseUrl	当前市场基址（开发为 /api）
getTemplateMarketCategoriesApi	市场分类
getTemplateMarketListApi	市场列表（type / categoryId / keyword）
getTemplateMarketDetailApi	市场详情（含 bizPayload）

使用建议

1. 管理端先建分类，再录入模板并填写合法 bizPayload JSON。
2. 将状态设为 已发布 后，桌面端市场与创建入口即可选到。
3. 首发建议少量高质量官方模板（同一垂直场景），再扩展分类。