2.4 KiB
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 操作影响平台。
-
放置静态页面
- 将附件原样复制为
public/mod-assets/easy-sales-skill/index.html。 - 不修改上传的源文件,不创建
public/easy-sales-skill,避免静态目录与 SPA 路由同名导致 nginx 重定向问题。
- 将附件原样复制为
-
新增模块容器
- 新建
src/modules/easy-sales-skill/App.tsx。 - 默认导出 React 组件,使用固定定位的全视口容器和 100% 宽高 iframe。
- iframe 地址为
/mod-assets/easy-sales-skill/index.html,设置明确的title、无边框及与源页面一致的背景色。 - 使用内联样式,不新增 CSS 文件,不操作父页面 body、Portal 或 storage。
- 新建
-
注册独立路由
- 修改
src/App.tsx,通过React.lazy动态导入新组件。 - 新增
/easy-sales-skill精确路由,复用现有RequireAuth和ModuleTitle,标题设为“EasySales 易销智能体 · 四大 Skill 使用说明”。
- 修改
-
保持首页导航不变
- 不修改
src/modules/registry.ts,不增加模块配置。 - 不修改
HomePage.tsx,不新增隐藏字段或特殊过滤逻辑;路由可直接访问,但首页不会生成对应卡片。 - 不修改
package.json、Vite 或 nginx 配置,不新增依赖。
- 不修改
验证
- 运行
npm run build,确认 TypeScript、样式检查和模块独立性检查全部通过。 - 确认产物包含
dist/mod-assets/easy-sales-skill/index.html,且不存在dist/easy-sales-skill目录。 - 在浏览器直接访问并刷新
/easy-sales-skill,确认登录守卫、页面标题、完整布局及 iframe 加载正常。 - 验证 tab/锚点、复制、关键词分流、模式切换、搜索和 todo 交互,无白屏、双滚动条或控制台异常。
- 返回首页,确认没有 EasySales 模块卡片,且首页样式和全局 DOM 无残留。