| name | zhihu-draft-helper |
| description | 当用户提到知乎、知乎发文、知乎发布文章、知乎草稿、知乎编辑文章、知乎登录后操作、知乎API、知乎直连发布、知乎草稿工具、知乎内容同步、绕过知乎编辑器、知乎批量发布、帮我发一篇知乎测试文章、帮我在知乎上操作网页时使用。 |
| version | 1.0.0 |
| last_updated | "2026-04-18T00:00:00.000Z" |
知乎草稿助手
版本:1.0.0
更新日期:2026-04-18
功能:通过API直接操作知乎草稿,绕过富文本编辑器限制,支持创建、读取、更新草稿,支持从Markdown文件同步内容。
用于在Minis内通过API和浏览器完成知乎草稿相关操作,包括直连API创建草稿、网页端最终发布、内容同步等。
适用范围
- 通过API直接创建知乎草稿
- 通过API读取和更新草稿
- 将本地Markdown文件同步到知乎草稿
- 在网页端完成最终发布操作
- 批量创建和管理草稿
- 绕过知乎富文本编辑器限制
核心功能
1. API直连操作(已验证)
- 草稿创建:
POST /api/v4/editor/default-settings
- 草稿读取:
GET /api/v4/editor/default-settings?content_token={id}
- 草稿更新:
PATCH /api/v4/editor/default-settings?content_token={id}
2. 网页端操作
- 打开编辑页面完成最终发布
- 设置话题、封面图、摘要等
- 处理发布审核状态
3. 文件同步
- 从Markdown文件读取内容
- 保持格式转换(Markdown → 知乎格式)
- 批量同步多篇文章
工作流程
快速发布流程
- 获取Cookie:通过浏览器登录知乎,获取Cookie环境文件
- 创建草稿:使用API工具创建草稿
- 网页发布:在浏览器中打开编辑页面,点击发布按钮
- 验证状态:检查发布是否成功
详细步骤
步骤1:获取知乎Cookie
browser_use navigate --url https://zhuanlan.zhihu.com/write
browser_use get_cookies
步骤2:使用API工具
cd /var/minis/shared/my_mini_skills/zhihu-draft-tool
./zhihu_draft_tool_wrapper.sh create \
--base-id 2028607956032176996 \
--title "文章标题" \
--content-file content.md \
--summary "文章摘要" \
--comment-permission all
python3 zhihu_draft_tool.py get \
--cookie "$COOKIE_STRING" \
--id 2028871642558787933
步骤3:网页端发布
browser_use navigate --url https://zhuanlan.zhihu.com/p/{草稿ID}/edit
browser_use wait_for_dom_stable --timeout 10
browser_use click --selector .Button--primary.Button--blue
工具文件位置
主工具脚本
/var/minis/shared/my_mini_skills/zhihu-draft-tool/zhihu_draft_tool.py
/var/minis/shared/my_mini_skills/zhihu-draft-tool/zhihu_draft_tool_wrapper.sh
文档和示例
README.md - 完整使用说明
test_example.sh - 使用示例
docs/ - API分析文档
已验证的API接口
1. 创建草稿
POST https://zhuanlan.zhihu.com/api/v4/editor/default-settings
参数:{
"content_token": "基础草稿ID",
"title": "文章标题",
"content": "文章内容",
"summary": "摘要",
"comment_permission": "all|registered_only|none"
}
2. 读取草稿
GET https://zhuanlan.zhihu.com/api/v4/editor/default-settings?content_token={草稿ID}
3. 更新草稿
PATCH https://zhuanlan.zhihu.com/api/v4/editor/default-settings?content_token={草稿ID}
实际测试案例
测试草稿1:API功能测试
测试草稿2:大学随记同步
常见问题处理
1. Cookie失效
- 重新登录知乎获取新Cookie
- 检查Cookie环境文件路径是否正确
2. 基础草稿ID无效
- 使用有效的草稿ID作为模板
- 可以通过访问已有草稿编辑页面获取ID
3. 发布按钮灰色
- 检查是否设置了必要的话题
- 确认内容不为空
- 可能需要添加封面图
4. 发布后仍在草稿状态
- 知乎可能有审核机制
- 新账号发布可能需要时间
- 检查是否有错误提示
使用场景
场景1:批量内容发布
- 自动化创建多个草稿
- 从本地目录批量同步Markdown文件
- 统一设置摘要和评论权限
场景2:内容同步
- 将CSDN、博客园等平台内容同步到知乎
- 保持格式和内容一致性
- 避免手动复制粘贴
场景3:绕过编辑器限制
- 知乎富文本编辑器对前端状态管理严格
- 通过API直接操作数据层
- 避免与编辑器交互的问题
场景4:API集成
- 作为其他发布工具的组件
- 集成到自动化工作流中
- 提供知乎发布能力
注意事项
安全注意事项
- Cookie保护:不要分享或泄露Cookie
- 使用频率:避免高频请求,防止被封禁
- 内容合规:遵守知乎社区规范
技术限制
- 最终发布:仍需网页端点击发布按钮
- 审核机制:新内容可能需要审核
- API稳定性:知乎可能更改API接口
最佳实践
- 先测试后使用:先用测试内容验证功能
- 保存草稿ID:记录创建的草稿ID便于管理
- 定期备份:重要内容本地备份
更新记录
v1.0.0 (2026-04-18)
- 初始版本发布
- 包含API直连创建、读取、更新草稿功能
- 支持从Markdown文件同步内容
- 包含网页端发布流程
- 已验证在实际环境中可用