` 初始为空，`waitForNetworkIdle` 不够，必须 `await wait(15)`。 ### 2. 进入图文发布页创作平台支持两种入口进入图文编辑页，脚本会**自动兼容**两种 UI： - **方式 A（顶部 tab）**：页面顶部有「上传视频 / 上传图文 / 写长文」tab 导航，点击「上传图文」 - **方式 B（下拉菜单）**：页面有「发布笔记」下拉按钮，点击展开后选「上传图文」脚本逻辑：先试方式 A（按文本遍历点击），检查是否出现 `input.upload-input`；如果没有，回退到方式 B（snapshotText 匹配 ref 点击）。 ```js // 方式 A：点击顶部「上传图文」tab const tabClicked = await js(`(() => { const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null, false) let node while (node = walker.nextNode()) { if (node.textContent.trim() === '上传图文') { let element = node.parentElement for (let i = 0; i < 4; i++) { if (!element) break element.click() element.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, view: window })) element = element.parentElement } return true } } return false })()`) await wait(3) // 检查是否已进入图文编辑页 if (!await js(`!!document.querySelector('input.upload-input')`)) { // 方式 B：回退到「发布笔记」下拉菜单 const pageText = await snapshotText() const matchPublish = pageText.match(/发布笔记.*?\[ref=(\d+)/) if (matchPublish) { await click('@' + matchPublish[1]) await wait(2) const text2 = await snapshotText() const matchUpload = text2.match(/上传图文.*?\[ref=(\d+)/) if (matchUpload) { await click('@' + matchUpload[1]) await waitForNetworkIdle(5) await wait(3) } } } ``` > **注意**：两种 UI 可能同时存在或随版本切换，脚本以 `input.upload-input` 是否出现为判断标准，自动选择可用入口。 ### 3. 上传图片（CDP 批量） **不能用** `uploadFile()` 传逗号分隔多文件路径（不生效）。**必须用 CDP**： ```js const doc = await cdp('DOM.getDocument', {}) const inputNode = await cdp('DOM.querySelector', { nodeId: doc.root.nodeId, selector: 'input.upload-input' }) await cdp('DOM.setFileInputFiles', { files: ['/abs/path/img1.png', '/abs/path/img2.png', ...], nodeId: inputNode.nodeId }) await wait(8) // 等待图片处理 ``` - 图片推荐尺寸：1080x1440（3:4 竖屏） - 最多 18 张 ### 4. 填写标题 ```js await fillInput('css:input[placeholder="填写标题会有更多赞哦"]', '标题内容') ``` ### 5. 填写正文正文区域是 `contenteditable="true"` 的富文本编辑器： ```js // 先 focus 编辑器 await js(`document.querySelector('[contenteditable="true"]').focus()`) // 再用 typeText 输入（支持换行和 #话题标签） await typeText('正文内容...\n\n#话题1 #话题2') await wait(1) // 按 Esc 关闭话题建议弹窗 await pressKey('Escape') ``` ### 6. 点击发布按钮（最关键的坑点） #### 问题小红书的「发布」按钮封装在 **``** 自定义组件中，使用 **closed Shadow DOM**： ```html #shadow-root (closed) ← closed 意味着 host.shadowRoot 返回 null

``` #### 无效的方法 | 方法 | 结果 | |---|---| | `querySelector('button.ce-btn.bg-red')` | 找不到（在 shadow DOM 内） | | `host.shadowRoot.querySelector(...)` | `shadowRoot` 为 `null`（closed） | | `click('@N')` / 坐标点击 | snapshotText 不穿透 shadow DOM | | `cdp('DOM.performSearch', {pierce: true})` | 找到节点但 nodeId=0 | | `cdp('Input.dispatchMouseEvent', {x, y})` | 不触发 Vue 事件 | #### 成功的方法 **直接调用组件暴露的内部方法 `_onPublish()`**： ```js const host = document.querySelector('xhs-publish-btn') // 检查状态 const disabled = host.getAttribute('submit-disabled') // 'false' = 可点 const loading = host.getAttribute('submit-loading') // 'false' = 未加载 // 触发发布 host._onPublish() ``` **原理**：`` 是 Web Component，原型链上暴露了 `_onPublish` 和 `_onSave` 方法。通过 `host._onPublish()` 直接调用，绕过 Shadow DOM 封装。 **发现方法**：`Object.getOwnPropertyNames(Object.getPrototypeOf(host))` 列出原型方法找到 `_onPublish`。 ### 7. 等待发布完成调用 `_onPublish()` 后按钮进入 loading，约 5-10 秒后页面会重置并出现 `published=true` URL 参数。验证： ```js const info = await pageInfo() if (info.url.includes('published=true') || info.url.includes('note-manage')) { cliLog('SUCCESS: 发布成功！') } ``` ### 8. 清理 ```js await completeTaskSpace(task.id, { keep: false }) ``` ## 快速复用修改 `scripts/publish_note.sh` 中的 4 个参数后直接运行： ```bash IMAGE_DIR="/path/to/images" IMAGES="img1.png,img2.png,img3.png" TITLE="标题" BODY='正文内容\n\n#话题1 #话题2' bash ~/.workbuddy/skills/xhs-image-note-release/scripts/publish_note.sh ``` ## 注意事项 1. **沙箱**：如果报错 `from the default agent sandbox`，需在 WorkBuddy 设置中关闭沙箱后重试 2. **SPA 渲染**：首次加载等 15 秒，不要用 `waitForNetworkIdle` 代替 3. **话题标签**：正文中的 `#话题` 自动被识别，输入后弹建议列表，按 `Escape` 关闭 4. **发布频率**：**严禁**短时间连续发多篇，可能触发风控；建议每次发布间隔至少 5 分钟 5. **权限设置**：发布前如需设置权限（公开/仅自己可见），在填正文后、点发布前操作 6. **标题特殊字符**：脚本中 TITLE 变量会插入 JS 单引号字符串，**严禁**包含单引号，否则会中断脚本 7. **正文特殊字符**：脚本中 BODY 变量会插入 JS 模板字符串，**严禁**包含反引号（``` ` ```）和 `${`，否则会中断脚本 ## Resources ### scripts/ - `scripts/publish_note.sh` — 一键发布脚本，修改 4 个参数即可复用 ### references/ - `references/publish-method.md` — 完整方法文档，含失败方案对比表和技术原理详解。**按需加载**：当需要了解发布按钮失败方案的完整对比、或需要排查 closed Shadow DOM 穿透问题时阅读此文件；正常发布流程无需提前加载