| name | zhihu-publish |
| description | 通过 forked camoufox-cli 持久化 session zhihu 在知乎发布文章或回答。知乎无可用公开 API，需通过浏览器操作完成发布。 |
| metadata | {"openclaw":{"emoji":"📝"}} |
知乎发布
通过 camoufox-cli 持久化 session zhihu（一个且只有一个持久化 session，fail-first 队列：同 session 已有命令在跑时新命令直接 fail）在知乎上发布文章或回答。知乎没有对个人开发者开放的发布 API，只能通过浏览器自动化。
主力后端 = target=camoufox。下方命令 / 示例只针对 target=camoufox。
target=host / target=node：只按本 skill 的「流程 + 提示事项」走--何时有头 / 何时无头 / 频率限制 / 错误处理约定是后端无关的，照本 skill 执行。不要照搬 camoufox-cli ... 命令，用你当前后端自带的浏览器工具语义调用即可。
前置条件
- 持久化 session
zhihu 已登录（登录态存 session profile 里）。本 skill 与 login-manager 完全无关--自管探活 + 登录，不导出 cookie/UA 落中央存储。
- 首次使用 / 登录态失效时，走自管有头手动登录流：
camoufox-cli --session zhihu --persistent --headed --json open "https://www.zhihu.com"- 告知用户「知乎 浏览器已打开，请在窗口里手动登录，完成后告诉我」
- 等用户回复后
snapshot 零登录态就位
- 登录后close session--登录态落磁盘 profile，不留进程占内存；本 skill 下次
--session zhihu --persistent 重起无头即恢复，用完再 close。
不导出 cookie/UA--登录态只在 session profile 里闭环，不落 ~/.openclaw/logins/。本 skill 不调用 cookies export / identity export。
发布文章
1. 启持久化 session + 打开创作页：
camoufox-cli --session zhihu --persistent --json open "https://zhuanlan.zhihu.com/write"
2. sleep 3-5 加载编辑器，snapshot 确认 .WriteIndex-page 或 .PostEditor 出现
3. snapshot 拿到标题输入框 ref：input[placeholder*="标题"] 或 .WriteIndex-titleInput input
4. camoufox-cli --session zhihu --persistent --json type <标题-ref> "文章标题"
- 最长 100 字符
5. snapshot 拿到正文编辑器 ref：.ProseMirror 或 .public-DraftEditor-root 或 [contenteditable="true"]
6. camoufox-cli --session zhihu --persistent --json click <正文-ref> 聚焦编辑器
7. camoufox-cli --session zhihu --persistent --json type <正文-ref> "正文内容"
- 知乎使用富文本编辑器（ProseMirror / Draft.js），不支持直接输入 Markdown
- Markdown 内容需先转换为纯文本或手动分段输入
8. （可选）添加话题：snapshot 找"添加话题"按钮 ref -> click -> type 话题名称 -> 从下拉选
9. snapshot 找"发布"按钮 ref -> camoufox-cli --session zhihu --persistent --json click <发布-ref>
10. sleep 3，snapshot 确认发布成功（URL 变为文章详情页）
正文格式
知乎编辑器支持：标题（H1/H2）/ 粗体 / 斜体 / 链接 / 图片（需先上传）/ 代码块 / 引用 / 有序无序列表。不支持直接输入 Markdown--需通过编辑器工具栏或快捷键操作。
发布回答
1. 启持久化 session + 打开问题页：
camoufox-cli --session zhihu --persistent --json open "https://www.zhihu.com/question/{question_id}"
2. sleep 3-5 加载
3. 找"写回答"按钮并点击。两种方式：
- snapshot 找 button ref（文本为"写回答"）后 camoufox-cli click @<ref>
- 若 click 卡死/无响应，改用 eval 绕过：
camoufox-cli --session zhihu --persistent --json eval "var b=Array.from(document.querySelectorAll('button')).find(function(x){return x.textContent.trim()==='写回答'}); if(b){b.click();'CLICKED'}else{'NOT_FOUND'}"
4. sleep 3-5 等编辑器出现，snapshot 拿到编辑器 ref（textbox 或 contenteditable）
5. 填写回答内容（见下方"填写正文"段）
6. ⚠️ 发布前必做：设置「创作声明」（见下方"创作声明"段）
7. snapshot 找"发布回答"按钮 ref -> click
8. sleep 3，确认发布成功（URL 变为 /question/.../answer/... 详情页）
填写正文
知乎编辑器是 Draft.js（[contenteditable=true]），填写正文用 fill 命令：
camoufox-cli --session zhihu --persistent --json fill @<编辑器-ref> "正文纯文本"
⚠️ fill 不会自动清空旧内容--如果编辑器已有内容（如之前填过或导入了内容），必须先清空：
camoufox-cli --session zhihu --persistent --json eval "var e=document.querySelector('[contenteditable=true]');e.focus();document.execCommand('selectAll',false,null);document.execCommand('delete',false,null);'CLEARED'"
清空后再 fill，否则两段内容会拼在一起。
导入公众号文章（可选）
知乎编辑器工具栏有"导入链接"功能，支持导入微信公众号文章：
- snapshot 找"导入"按钮 -> click -> 切换到"导入链接"tab
- 在 textbox 中填入公众号文章 URL -> 点"开始导入"
- 导入可能失败（知乎规范过滤：含导流二维码、广告外链、违禁词等会拦截；内容重复/敏感词会导入失败）
- 导入失败时，改用直接 fill 正文的方式
创作声明（发布前必做）
⚠️ 发布回答前必须设置创作声明，否则需要发布后重新编辑补设。
编辑器底部有「发布设置」区域，其中包含「创作声明」下拉框（combobox），默认值为"无声明"。
对于 AI 辅助创作的内容，必须选择"包含 AI 辅助创作 作者对内容负责"：
1. snapshot 找「创作声明」combobox ref
2. click 展开 combobox -> snapshot 找 option "包含 AI 辅助创作 作者对内容负责" -> click 该 option
3. 确认 combobox 文本变为"包含 AI 辅助创作 作者对内容负责"
可选值：无声明 / 包含剧透 / 包含医疗建议 / 虚构创作 / 包含理财内容 / 包含 AI 辅助创作 作者对内容负责
编辑已发布的回答
若发布时遗漏了创作声明，可通过编辑补设：
- 打开回答详情页，找"编辑回答"按钮 -> click
- 编辑器打开后，滚动到底部找「创作声明」combobox
- 设置声明后，找"提交修改"按钮 -> click
- sleep 3 确认保存成功
图片上传
知乎编辑器插入图片需先上传：
1. snapshot 找编辑器工具栏的"图片"按钮 ref -> click 触发文件选择
2. snapshot 拿到弹出的 <input type="file"> ref
3. camoufox-cli --session zhihu --persistent --json upload <图片-input-ref> <image.jpg>
- forked cli upload 命令底层走 Playwright setInputFiles，无需 CDP setFileInput hack
4. sleep 等待上传完成（snapshot 看图片出现在编辑器）
必做约束
- 用完即 close 持久化 session
zhihu--登录态 + 指纹冻结在磁盘 profile，不留进程占内存；下次发布 --session zhihu --persistent 重起无头即恢复。只在 session 卡死时 camoufox-cli --session zhihu --json close teardown。
- 同 session 已有命令在跑时，新命令 fail-first（返回
session zhihu 正忙，请等待当前操作完成后再试）--读到这条文本就等当前操作完成再重试，不要盲试。
- 每次发布间隔 60 秒以上，避免触发反垃圾。
Pitfalls
pitfall: editor_not_prosemirror
- 触发：知乎编辑器 DOM 结构变更
- 症状：
.ProseMirror 选择器找不到编辑器
- workaround：fallback 到
.public-DraftEditor-root 或 [contenteditable="true"]
pitfall: markdown_not_supported
- 触发：直接粘贴 Markdown 文本到编辑器
- 症状：Markdown 标记原样显示，不被渲染
- workaround：用编辑器工具栏格式化，或分段输入（先输入纯文本，再用快捷键加粗/设标题等）
pitfall: image_upload_timeout
- 触发：上传大图片
- 症状：上传进度卡住
- workaround：图片压缩到 2MB 以内再上传；超时后重试一次
pitfall: anti_spam_check
- 触发：短时间内发布多篇内容
- 症状：出现验证码或"操作过于频繁"提示
- workaround：每次发布间隔 60 秒以上
pitfall: numeric_html_entities
- 触发：从知乎复制内容时
- 症状：文本含
你 等编码
- workaround：解码 HTML 实体后再使用
pitfall: click_timeout
- 触发：
camoufox-cli click @<ref> 命令卡死或被 SIGKILL
- 症状：click 命令无响应，进程被杀
- workaround：改用
eval 里调 element.click() 绕过：先 querySelectorAll 找到目标按钮，直接 .click()
pitfall: fill_not_clearing
- 触发：编辑器已有内容时直接
fill 新内容
- 症状：新旧内容拼接在一起
- workaround：fill 前先
eval 执行 selectAll + delete 清空编辑器
pitfall: import_link_blocked
- 触发：使用知乎"导入链接"功能导入公众号文章
- 症状：导入后编辑器为空，无报错提示
- workaround：知乎规范会过滤含导流二维码、广告外链、违禁词的内容。导入失败后改用
fill 直接填入纯文本
错误处理
| 情况 | 处理 |
|---|
| 未登录 / 登录墙 | 走前置条件的有头手动登录流，重试一次 |
| 编辑器未加载 | 等待 5 秒后重试，检查选择器 |
| 发布按钮灰色 | 检查标题/正文是否已填写 |
| 验证码 / 频率限制 | 等待 60 秒后重试 |
| session 正忙（fail-first） | 等当前操作完成再重试，不要盲试 |
| click 命令卡死 | 改用 eval + element.click() 绕过 |
发布后
必须调用 published-track 技能记录本次发布。
