zhihu-content-manager

知乎发文管理 Skill

compatibility

• Python 3.8+ 与 Playwright（pip install playwright && playwright install chromium）
• Chromium 浏览器（默认用 Playwright 自带的；如需指定路径见下文）
• zhihu_state.json：知乎登录态 cookies 文件（由用户本地浏览器登录后导出，不入库）

---

核心工作流

1. 环境准备

import sys
from pathlib import Path
from playwright.sync_api import sync_playwright

# Chromium 路径按优先级解析：
# 1) 环境变量 ZHIHU_CHROME_PATH
# 2) Playwright 自带浏览器（不传 executable_path 即可）
CHROME_PATH = os.environ.get("ZHIHU_CHROME_PATH") or None
STATE_FILE = os.environ.get("ZHIHU_STATE_FILE", "zhihu_state.json")

启动浏览器配置：

browser = p.chromium.launch(
    executable_path=CHROME_PATH,   # None 时使用 Playwright 自带 Chromium
    headless=True,
    args=[
        '--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage',
        '--disable-blink-features=AutomationControlled'
    ]
)
context = browser.new_context(
    storage_state=STATE_FILE,
    user_agent='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
    viewport={'width': 1920, 'height': 1080},
    locale='zh-CN'
)
context.add_init_script("Object.defineProperty(navigator, 'webdriver', {get: () => undefined});")
page = context.new_page()

2. HTML内容规范

发布到知乎的HTML必须遵循以下格式：

段落：<p data-pid="X">内容</p> 标题：<h2> / <h3>（中文编号如"一、""1.1"） 引用：<blockquote data-pid="X">内容</blockquote> 代码块：<code> 标签内所有 < > 必须转义为 < > 图片：必须用 <figure data-size="normal"><img src="URL"/></figure> 包裹 粗体：<b>，不要用 <strong> 列表：<ul><li> 用于结构化知识 公式：行内 <span class="FormulaCSR" data-tex="LaTeX" data-eeimg="1">$LaTeX$</span>，块级 <p data-pid="X"><span class="FormulaCSR" data-tex="LaTeX" data-eeimg="2">$$LaTeX$$</span></p>

绝对禁止：裸 <img> 标签（会被过滤）、<table>（Draft.js无法清除）、未转义的尖括号

3. 发布新文章

导航: https://zhuanlan.zhihu.com/write
  ↓
设置标题（React兼容方式）:
  Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set.call(textarea, "标题")
  textarea.dispatchEvent(new Event('input', { bubbles: true }))
  ↓
上传封面:
  找到 input[type="file"][accept*="image"] (通常是第1个或第2个)
  file_input.set_input_files("/path/to/cover.jpg")
  等待3秒
  清除弹窗: document.querySelectorAll('.Modal-backdrop, .Modal').forEach(el => el.remove())
  ↓
注入HTML内容（分块paste）:
  chunk_size = 15000
  for chunk in [html[i:i+chunk_size] for i in range(0, len(html), chunk_size)]:
      if not first:
          定位到编辑器末尾: focus() + selectAllChildren() + collapseToEnd()
      ClipboardEvent paste注入:
          dt = new DataTransfer()
          dt.setData('text/html', chunk)
          dt.setData('text/plain', chunk)
          editor.dispatchEvent(new ClipboardEvent('paste', { clipboardData: dt, bubbles: true, cancelable: true }))
      等待2秒
  ↓
验证预览包含中文字符
  ↓
点击"发布"按钮（绕过Modal）:
  document.querySelectorAll('.Modal-backdrop, .Modal').forEach(el => el.remove())
  遍历所有button找到textContent.trim() === '发布' 的并click()
  ↓
添加话题标签（编辑页底部）:
  找到placeholder包含"话题"的input
  设置value为"编程"或相关话题
  从Popover建议列表精确匹配点击第一个
  ↓
确认发布: 点击"确认发布"或"确认"按钮