AIcreat/readme.md

X2WeChat Studio

把 X 上的优质文章快速改写为公众号可发布版本，并支持同步推送到 IM。

1. 启动

cp .env.example .env
# 填写 .env 中的 OPENAI / 微信 / IM 参数

docker compose up --build

启动后访问：http://localhost:18000

容器默认将数据库挂载到宿主机目录 ./data（AUTH_DB_PATH=/app/data/app.db），更新容器镜像不会清空历史账号和会话数据。

2. 使用流程

1. 在页面左侧粘贴 X 文章内容。
2. 点击 AI 改写，自动生成标题、摘要、正文。
3. 点击 发布到公众号草稿箱。
4. 可选点击 发送到 IM 同步到团队群。

3. 环境变量说明

• OPENAI_API_KEY：AI 改写能力。
• OPENAI_BASE_URL：可选，兼容第三方网关。
• OPENAI_MODEL：默认 gpt-4.1-mini。
• WECHAT_APPID / WECHAT_SECRET：公众号发布必填。
• WECHAT_AUTHOR：草稿默认作者名。
• IM_WEBHOOK_URL：IM 推送地址（飞书/Slack/企微等）。
• IM_SECRET：可选签名。
• AUTH_DB_PATH：账号数据库文件路径（SQLite）。
• AUTH_SESSION_TTL_SEC：普通登录会话时长（秒）。
• AUTH_REMEMBER_SESSION_TTL_SEC：勾选“限时免登”时的会话时长（秒）。
• AUTH_PASSWORD_RESET_KEY：忘记密码重置码（用于“用户名+重置码”找回，默认 x2ws-reset-2026，建议改掉）。

4. 说明

• 未配置 OPENAI_API_KEY 时，系统会使用本地降级改写模板，便于你先跑通流程。
• 建议发布前人工复核事实与引用，避免版权和失真风险。
• 登录页支持“限时免登”，设置页支持修改密码；忘记密码页支持通过“用户名 + 重置码”重置密码。

5. 数据备份与恢复

数据库文件默认在 ./data/app.db，可直接备份该文件：

cp ./data/app.db ./data/app.db.bak.$(date +%Y%m%d_%H%M%S)

恢复时停止服务后覆盖回去：

docker compose down
cp ./data/app.db.bak.YYYYMMDD_HHMMSS ./data/app.db
docker compose up -d