34 lines
2.4 KiB
Markdown
34 lines
2.4 KiB
Markdown
# 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 无残留。
|