绑定公众号，把文章直接保存到草稿箱

开始前准备

绑定公众号前，请先确认微信侧的账号权限和开发者凭据都已准备好。下面的配置只需为每个公众号完成一次。

• 一个或多个已认证的微信公众号，并确认每个账号都可以使用草稿和素材接口。
• 公众号后台的 AppID 和 AppSecret。AppSecret 只应交给 Koinote 的绑定表单，不要发到聊天或反馈中。
• Koinote 云端服务当前的微信 API 出口 IP 是 122.51.97.242；自部署用户填写服务器访问微信时使用的公网出口 IP。
• 已登录的 Koinote 终生会员账号；绑定、封面生成和草稿推送对付费会员开放，桌面端本地模式不能连接微信或生成封面。

在微信开发者平台配置

先在微信开发者平台允许 Koinote 的服务端访问接口，再回到 Koinote 填写凭据。微信后台的菜单名称可能随版本调整，但核心位置仍是开发接口管理。

• 登录微信开发者平台 — 打开 developers.weixin.qq.com/platform，登录需要绑定的公众号管理员账号。
• 进入开发接口管理 — 选择要绑定的公众号，进入“开发接口管理”，找到开发者凭据和 IP 白名单。
• 添加 IP 白名单 — Koinote 云端服务请填写 122.51.97.242（微信 API 出口 IP）；自部署用户填写自己的服务器公网出口 IP。多个地址按微信后台要求逐行填写。
• 准备开发者凭据 — 复制 AppID，并生成或复制 AppSecret。微信可能只展示一次，请先保存在密码管理器中。

为什么必须设置 IP 白名单？

微信会校验调用接口的服务器来源。Koinote 只在服务端请求微信，因此白名单里要填服务端出口 IP，而不是你当前电脑的 IP。Koinote 云端服务当前请填写 122.51.97.242；自部署时填写服务器的公网出口地址。

在 Koinote 中绑定并推送

微信侧配置完成后，接下来在 Koinote 绑定账号，并从编辑器把文章保存为草稿。整个流程不会直接发布文章，你仍可在公众号后台检查后再发布。

1. 打开 Koinote 网页端或桌面客户端，并登录终生会员账号。
2. 进入设置 → 微信公众号，为每个账号填写备注、AppID 和 AppSecret。最多可绑定 5 个账号，并可指定其中一个为默认账号。
3. 打开任意文档，在导出菜单中选择“导出到自媒体”，切换到“微信公众号”，再点击“同步到账号草稿箱”。在草稿面板选择目标公众号；未手动选择时使用默认账号。
4. 封面图是可选的；如需 AI 封面，填写提示词并选择预设或自定义 W:H 比例。每成功生成一张封面消耗 20 credits，重新生成也会单独计费。
5. 可以直接点击“保存到公众号草稿箱”；封面可从默认图片、正文图片或 AI 生成中选择。正文图片会先转存到微信素材，再创建草稿；Koinote 不会直接发布文章。

费用与权限

绑定公众号不消耗 credits；每次成功同步草稿消耗 20 credits，失败不会扣除。绑定和草稿推送对付费会员开放；AI 封面生成会额外消耗 20 credits，生成失败不会扣除。封面生成还需要终生会员、可用 credits，以及已配置的封面模型。

遇到错误怎么办

后端出口 IP 不在白名单

回到微信开发者平台的开发接口管理；Koinote 云端服务填写 122.51.97.242，自部署填写服务器公网出口 IP，不要填写本机地址。

公众号没有接口权限

确认公众号已经认证，并能使用草稿箱和素材相关接口；部分账号类型或权限状态需要先在微信侧开通。

封面生成模型未配置或 credits 不足

请先确认账号有至少 20 个可用 credits；如果仍提示模型未配置，请联系 Koinote 管理员。

正文图片转存失败

先回到编辑器等待图片同步完成，再重试。草稿创建失败时，Koinote 会尽力清理刚上传的封面素材。

安全提醒

AppSecret 会在 Koinote 服务端加密保存，客户端不会长期保存明文，也不会发送给封面模型服务商。不要把 AppSecret 放进文档、反馈或截图；如果怀疑泄露，请立即在微信公众平台重置后回到 Koinote 重新绑定。