泛微E10文档编辑器

为什么泛微文档不好改

泛微 E10 知识文档的正文是一段 HTML，编辑器是嵌在 docEdit iframe 里的 CKEditor 4 定制版。问题在于：图片、视频、表情、事项关联都被泛微封装成自己的 .ui-dialog-wrap 对话框；发布态还会清洗一遍样式。直接改很容易出现三类事故：样式在编辑态正确、发布后塌陷；<img> 变成可点击元素，用户一点就弹预览大图；只想改正文里某处，却只能整篇重写。

本技能把能力收敛成一个：对正文 HTML 任意位置精准修改。

它怎么工作

• 登录态先立住。 通过 e10_login.py 使用浏览器弹窗账号密码或扫码、ETEAMSID 令牌、二维码截图三种方式登录，成功后保存 Playwright storage_state JSON，后续脚本用 ctx.add_cookies() 复用，免重复登录。
• 锁定编辑 frame。 打开文档详情页点「编辑」，遍历 page.frames 找到 URL 含 docEdit 的 iframe，所有 DOM 操作限定在该 frame 内。
• 源码模式读写正文。 点 a[title="源码"] 进入源码模式，用 CKEDITOR.instances[...].getData() 读取全量 HTML，正则或字符串定位目标片段，只替换需要改的那一段，再 setData() 写回。banner、二维码、其他段落原样保留。
• 业务对象和附件走专用路径。「事项关联」插入泛微插件卡片，发布后渲染为 [标题]，跳转能力保留；「插入图片」走 .ui-dialog-wrap 上传，拿到 fileId 后用 /api/file/preview?fileId=... 作为 <img src>。
• 检索链路共用登录态。 scripts/esearch/ 提供全文检索、AI 问答总结、按客户名找案例 PPT、筛选 PPT 附件，所有命中要求返回 docId 或链接作为证据。

样式红线与适用边界

写入 <style> 前必须自检，三条铁律来自发布态清洗逻辑：

• 禁用 var() / :root / 自定义属性。 发布态会剥离 CSS 变量规则，一律写字面量颜色如 #3a78d4。
• 不用 border 画线，不用 ::before 塞 emoji。 分隔线和描边改用 box-shadow；图标用真实 <span> 元素加 CSS 背景。::before 的 content 会被清空，残留 CSS 可能变成文档顶部孤儿文本节点。
• <img> 必须加 pointer-events:none。 泛微对图片做了全局事件委托，不加就会点图弹预览。

标准文档格式容器宽度固定 1024px，banner 用 <img class="hero-bg"> 承载而非 background-image:url()；含 logo 的 banner 用 object-fit:cover; object-position:0% 50% 保左侧 logo 不被裁。

适用边界：文档编辑能力针对泛微 E10，其他系统登录态可产出通用 storage_state 但编辑流程不保证可用；ETEAMSID 服务端通常 1–2 小时过期需重新登录；PPT 在线正文提取依赖 playwright 和系统 Edge，不是纯 fetch 能完成。

参考资料

• references/gotchas.md — 发布态样式塌陷清单与自检脚本
• references/document-format-standard.md — 标准文档格式全文
• references/dialog-reference.md — 四个泛微自定义对话框的 DOM 结构与自动化代码
• references/attachments-reference.md — 文档级附件的上传、替换、下载、续传实现
• assets/doc-standard-template.html — 可直接复制修改的格式骨架