Zhihu Publisher

Zhihu Publisher

Prepare or publish a reviewed Zhihu article from the canonical repository source. Publication authorization follows CLAUDE.md's Precedence Rule and Publishing section.

Inputs

• Source Markdown path or topic.
• Intended language and title, if the user specifies them.
• Optional target column, cover, tags, source URL, GitHub link, or paper link.

If the source path is missing, inspect .github/publisher/posts_queue.txt, .github/publisher/media/not-published.md, and recent docs/blog/posts/ entries before asking the user.

Platform Entry Points

• Editor: https://zhuanlan.zhihu.com/write
• Creator center: https://www.zhihu.com/creator
• Observed profile: https://www.zhihu.com/people/yun-wei-64-11

Use a browser surface with the logged-in session when UI work is required. Never bypass authentication with search results or alternate sources.

References

Load references/platform-preferences.md when choosing Zhihu-native framing, title, opening, "想法" format, or promotion/link balance. Load references/ai-works.md for Zhihu AI Works fields, campaign notes, project material, and reusable copy.

Browser-Only Platform Boundary

Do not directly access Zhihu APIs, internal endpoints, or background HTTP interfaces under any circumstances. All verification, drafting, QA, screenshots, and ledger evidence must come from normal browser interactions that a regular logged-in user can perform: navigating pages, scrolling profile/article lists, clicking visible controls, reading rendered page content, using the editor UI, and capturing screenshots.

Draft Preparation

1. Read the canonical Chinese source and extract title, summary, tags, images, code blocks, source URL for the ledger, GitHub links, and paper links.
2. Build a Zhihu copy in canonical syndication mode:
   • remove YAML front matter
   • preserve the article body by default
   • preserve the source title and first paragraph exactly
   • convert relative images to checked public URLs or prepare manual image upload
   • convert tables, formulas, Mermaid, footnotes, or complex HTML only when the target editor cannot render them faithfully
3. Preserve links already present in the source. A visible eunomia.dev original/canonical note is optional and is not added by default.
4. Keep the opening, section order, claims, examples, and conclusion unchanged. If the source needs a content fix, update it first or skip syndication. Rewrite, translate, shorten, expand, reorder, or split only when the user explicitly asks for that specific publication.

Draft Archive

Before opening the Zhihu editor, write or update the Zhihu draft record under draft/media/YYYY-MM-DD/<source-slug>/zhihu.md using the local date. For unchanged Chinese canonical syndication, the file may reference the source body instead of duplicating it, but it must record the exact title, source URL for the ledger if known, GitHub/paper links, column/tags if known, source/project note if useful, media choices, and QA state.

Editor Workflow

1. Open https://zhuanlan.zhihu.com/write.
2. Fill the title field, observed as 请输入标题（最多 100 个字）.
3. For long-form posts, prefer a local .md or .docx artifact prepared before opening the editor. Use Zhihu's visible document import path when available (toolbar more/menu import); paste only for short text or when import is not available.
4. Avoid post-paste surgical repair in the Zhihu editor. If a long draft needs structural fixes, regenerate the local artifact and re-import into a fresh draft when practical.
5. Verify visually:
   • heading hierarchy is preserved
   • code blocks are readable
   • tables do not collapse
   • images render
   • links point to intended GitHub, docs, project, or paper sources
   • Treat visible public-page DOM inspection as sufficient QA. If Page.captureScreenshot times out, do not retry it; verify the title, structure, code blocks, tables, image loading, and links through the visible DOM/page instead.
6. In the publish/settings flow, choose a relevant question when Zhihu offers a question selector. Verify the selected question is topical before final publish; do not leave an unrelated default question selected.
7. Set cover and column inclusion only when the user requested them or the choice is obvious from prior posts.
8. Complete the visible 发布 action when the task requests publication or the queue item is marked 排队; do not ask for duplicate confirmation. Stop at preview only for a draft or preview task.