常见问题 FAQ

[AAAAAnson]

把常见问题整理在这里，欢迎补充。当然，所有问题都可以通过你的Agent去解决和使用。

---

Q: 如何配置微信公众号 AppID/AppSecret？

A: 部署后访问 http://localhost:7070/settings，填入你的 AppID 和 AppSecret 即可。申请地址：https://mp.weixin.qq.com

Q: 支持哪些 AI 工具？

A: 目前原生支持 Claude Code、OpenAI Codex、OpenClaw。其他支持 REST API 调用的 AI 工具也可以通过 API 接入。

Q: 图片会上传到哪里？

A: 本地图片存储在 data/images/ 目录（Docker 挂载卷）。发布到微信草稿箱时，图片会自动上传到微信 CDN 并替换链接。

Q: 可以不用 Docker 部署吗？

A: 可以，参考 README 的「本地开发」章节，分别启动前后端即可。

Q: 微信兼容性处理包含哪些？

A: 自动 CSS 内联化（premailer）、div → section 标签转换、不支持的 CSS 清洗、图片上传微信 CDN。

---

有其他问题欢迎在下方回复 👇

[aqzas]

Docker 部署的，不论是创建文章还是添加AppID 都显示失败，控制台报错

API Error: AxiosError: Request failed with status code 502
    et http://localhost:7073/assets/api-CVDoXjWx.js:1
    it http://localhost:7073/assets/api-CVDoXjWx.js:3
    R http://localhost:7073/assets/api-CVDoXjWx.js:3
[api-CVDoXjWx.js:6:5595](http://localhost:7073/assets/api-CVDoXjWx.js)
Uncaught (in promise) AxiosError: Request failed with status code 502
    et http://localhost:7073/assets/api-CVDoXjWx.js:1
    it http://localhost:7073/assets/api-CVDoXjWx.js:3
    R http://localhost:7073/assets/api-CVDoXjWx.js:3

[AAAAAnson]

感谢反馈！502 通常是后端服务还没启动好或者启动失败了。

麻烦跑一下这两个命令看下：

docker compose ps
docker compose logs backend --tail 50

把结果贴上来我看看。常见原因是数据目录权限问题，如果日志里有 Permission denied 之类的报错，可以试试：

chmod -R 777 ./data
docker compose restart backend

另外我刚推了一版优化，加了后端健康检查，重新拉取构建应该也能改善这个问题：

docker compose down
docker compose pull
docker compose up -d --build

[aqzas]

感谢回复，我昨天已经debug完了，原因确实是docker backend 没有成功运行起来，提示是data文件夹下面的image还是哪个文件夹没有，可能是你说的权限问题，我手动创建文件夹之后好了

[AAAAAnson]

感谢反馈，如果还有问题可以联系我:)