Files
ai-platform/.trae/documents/easy-sales-skill-html-module-plan.md
2026-11-17 18:58:12 +08:00

2.4 KiB

EasySales Skill 独立 HTML 模块接入计划

Context

将附件 EasySales-Skill.html 作为平台的独立模块,通过 /easy-sales-skill 访问,但不在首页模块导航中出现。附件为完全自包含的单文件页面,CSS、JavaScript 均内联,无外部资源或存储依赖,包含 tab、复制、关键词分流、模式切换、搜索和 todo 等交互。

实施方案

采用“React 独立路由 + 同源全屏 iframe + 静态 HTML”的最小接入方式,复用现有 Sanrui 模块的 iframe 隔离思路,但按当前资源规范放入 mod-assets,避免样式、脚本和 DOM 操作影响平台。

  1. 放置静态页面

    • 将附件原样复制为 public/mod-assets/easy-sales-skill/index.html。
    • 不修改上传的源文件,不创建 public/easy-sales-skill,避免静态目录与 SPA 路由同名导致 nginx 重定向问题。
  2. 新增模块容器

    • 新建 src/modules/easy-sales-skill/App.tsx。
    • 默认导出 React 组件,使用固定定位的全视口容器和 100% 宽高 iframe。
    • iframe 地址为 /mod-assets/easy-sales-skill/index.html,设置明确的 title、无边框及与源页面一致的背景色。
    • 使用内联样式,不新增 CSS 文件,不操作父页面 body、Portal 或 storage。
  3. 注册独立路由

    • 修改 src/App.tsx,通过 React.lazy 动态导入新组件。
    • 新增 /easy-sales-skill 精确路由,复用现有 RequireAuth 和 ModuleTitle,标题设为“EasySales 易销智能体 · 四大 Skill 使用说明”。
  4. 保持首页导航不变

    • 不修改 src/modules/registry.ts,不增加模块配置。
    • 不修改 HomePage.tsx,不新增隐藏字段或特殊过滤逻辑;路由可直接访问,但首页不会生成对应卡片。
    • 不修改 package.json、Vite 或 nginx 配置,不新增依赖。

验证

  1. 运行 npm run build,确认 TypeScript、样式检查和模块独立性检查全部通过。
  2. 确认产物包含 dist/mod-assets/easy-sales-skill/index.html,且不存在 dist/easy-sales-skill 目录。
  3. 在浏览器直接访问并刷新 /easy-sales-skill,确认登录守卫、页面标题、完整布局及 iframe 加载正常。
  4. 验证 tab/锚点、复制、关键词分流、模式切换、搜索和 todo 交互,无白屏、双滚动条或控制台异常。
  5. 返回首页,确认没有 EasySales 模块卡片,且首页样式和全局 DOM 无残留。