新增module

This commit is contained in:
2026-11-17 18:58:12 +08:00
parent 8699798ea5
commit 1aaf2e2a6f
4 changed files with 795 additions and 0 deletions
@@ -0,0 +1,33 @@
# 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 无残留。