知乎同步助手（zhihu-sync，旧称 zhihu-publisher）是一个面向知乎平台的内容发布编排入口。它的主要用途是：把用户已有的内容适配成知乎要求的格式，先经本地预览与人工确认，再发布为文章、提问或想法。
主要能力 支持 article（文章）、question（提问）、pin（想法）三种内容形态。整个流程分为几个阶段：draft（整理草稿）、validate（生成知乎适配的结构化结果）、preview（生成本地浏览器预览 HTML）、用户确认、publish（通过知乎 OpenAPI 发布）。每个阶段由对应的子技能（zhihu-validate、zhihu-preview、zhihu-publish）负责具体规则，根技能只规定执行顺序、阶段边界和产物路径。
使用方式 用户提供要发布的标题、正文、图片或链接后，工具会先确认内容形态，再把原始信息整理为 Markdown 草稿，忠实保留用户的标题、正文、事实、观点、结构和语气。未经明确允许，不做删减、精简、扩写、重排或改写。草稿随后经校验生成结构化结果，并生成 HTML 预览，用系统默认浏览器打开供用户核对；用户明确确认后才进行发布。若预览内容有误，修改只能落到草稿，再重新校验与预览，不能直接改校验结果或预览文件。
依赖与凭证 发布前需检查知乎 OpenAPI 凭证来源：进程环境变量 ZHIHU_OPENAPI_APP_KEY / ZHIHU_OPENAPI_APP_SECRET，或共享凭证文件 ~/.zhihu/openapi-credentials.json。本地图片或需转存的公开图片 URL，需通过配套技能 zhihu/zhihu-mediacloud-uploader 上传到知乎媒体云，该技能仅用于图片上传。首次加载时会进行旧版本卸载检查和一次版本更新检查。
适用场景与限制 适用于把已有原创内容整理并发布到知乎的场景。工具明确提示不建议完全由 AI 生成正文，AI 生成或辅助参与的文章、想法可推荐声明 ai_creation；提问的发布接口没有创作声明字段。想法的话题不会在未获明确授权时生成或插入。当前不支持视频发布，发现视频时会提示移除后重新提交。各种产物的失效规则、Git 防误提交规则和预览打开的平台命令要求，均按资料中的详细流程执行；具体平台支持范围与错误处理以对应子技能文档为准，资料未提供更多细则。