diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 0eb4f27..75ed72b 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -14,7 +14,7 @@
```
agent/
├── README.md 设计文档(API/数据模型/部署总览)
-├── docker-compose.yml 编排:agent-core + agent-executor 两个服务
+├── docker-compose.yml 编排:agent-core / agent-executor(+init) / wxbot(微信接入,代码在 ./wxbot 不入 git)
├── config.yml 运行时配置(含密钥,已 .gitignore)
├── data/ 默认数据卷(任务目录、SQLite、prompt dump)
├── tasks/ 任务目录挂载点(同 ./data 顶层等价,二选一)
@@ -424,7 +424,7 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks`
- **方向三条线**:① Web(设置页→账户→微信绑定)→ `/api/wechat` → wxbot `/api/instances*`(实例控制,QR SVG 代理给页面 `
`,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message → 分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`。
- **投递游标** `last_msg_id` 落库 + 每绑定串行队列:重启不重发旧回复,wxbot 短暂不可达不丢(下一条连带补齐);errAck/纯工具轮(空文本)不进微信,`__blocks__` 图消息降级为占位文案。
- **降级承诺**:`wxbot.url` 未配 = 功能整体静默关闭(启动零日志噪声、设置页入口隐藏);配了但 wxbot 没起 = restore 只留一行 info,面板显示未连接,所有外呼失败只 warn,绝不阻塞/抛出未捕获异常影响 Web 主流程(鉴权/探活失败同样只降级)。
-- 鉴权:core→wxbot = wxbot 自身 auth.tokens 白名单(模板直接引用 `${WXBOT_TOKEN}`);wxbot→core = `/wxhook` 挂 auth.middleware 之前,Bearer 服务 token 哈希后定长比较(同 auth.js 形态),token 未配一律 503(fail closed)。
+- 鉴权:双向共用一个服务 token(根 .env `WXBOT_TOKEN`,init.sh 生成/复用)——core→wxbot 时 wxbot 把该 env 自动并入 /api 白名单;wxbot→core 走 `/wxhook`(挂 auth.middleware 之前,Bearer 哈希后定长比较,token 未配一律 503 fail-closed)。wxbot 零配置文件(同 executor 模式),接线全靠 env,config.yml 仅作可选覆盖。
---
@@ -545,7 +545,7 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks`
- `mcp_servers[].timeout_ms` —— 该服务单次 `tools/call` 的最大等待,默认 60000(夹在 1s~10min);工具发现/握手用固定 15s,不受本项影响。
- `mcp_servers[].tools_allow` / `tools_deny` —— 发现阶段的工具名单(字符串数组,按服务端原始名):allow 白名单,deny 在其后叠加(deny 优先);用于压低发给模型的工具数(如浏览器类服务)。
- `executor.url` / `executor.token` —— 留空走环境变量 `EXECUTOR_URL` / `EXECUTOR_TOKEN`(compose 默认注入)。
-- `wxbot.url` / `wxbot.token` —— 微信接入(§5.13,可选):url 留空/未配时功能整体静默关闭;留空时读 env `WXBOT_URL` / `WXBOT_TOKEN`(compose 默认注 `http://wxbot:8093`,`.env` 置 `WXBOT_URL=` 可关);token 与 wxbot 侧 `.env` 同值,双向共用(出向控制 + 入向 /wxhook 回调)。
+- `wxbot.url` / `wxbot.token` —— 微信接入(§5.13,可选):url 留空/未配时功能整体静默关闭;留空时读 env `WXBOT_URL` / `WXBOT_TOKEN`(compose 默认注 `http://wxbot:8093`;根 .env 置 `WXBOT_URL=` 可关);`WXBOT_TOKEN` 由 scripts/init.sh 生成/复用,同一值注进 core 与 wxbot 两侧双向互信(wxbot 零配置文件,同 EXECUTOR_TOKEN 模式)。
---
diff --git a/scripts/init.sh b/scripts/init.sh
index e3fda16..f6074e5 100755
--- a/scripts/init.sh
+++ b/scripts/init.sh
@@ -6,13 +6,17 @@
# 用法:
# ./scripts/init.sh # 全用默认值(无模型、admin/admin)
# BIGMODEL_KEY=xxx AUTH_USER=me ./scripts/init.sh # 给几个变量就行
+# ./scripts/init.sh --env-only # 只刷新 .env(含同步 wxbot/.env),不动 config.yml
#
# 输入(都可选):
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(0~3 个)
# ZHIPU_KEY image_task / video_task 的智谱 key(空 = 这两个服务 enable: false)
# AUTH_USER / AUTH_PASSWORD 登录账号(默认 admin / admin,请自行改掉)
# PUBLIC_IP / AGENT_PORT 对外地址与端口,写进 public_link.base_url(PUBLIC_IP 空则尝试自动探测)
-# AUTH_SECRET / EXECUTOR_TOKEN 一般不用给:不给就自动生成并复用(见下)
+# AUTH_SECRET / EXECUTOR_TOKEN / WXBOT_TOKEN 一般不用给:不给就自动生成并复用(见下)
+#
+# 微信接入(wxbot 已合入根 compose,作为栈内服务):本脚本只负责生成/复用根 .env 的 WXBOT_TOKEN;
+# wxbot 自身零配置文件(compose 注 env + 内置默认,同 executor 模式),无需任何同步动作。
#
# config.yml 只写 deploy 相关的段:platforms / auth / mcp_servers / public_link;
# 其余配置项一律走 server/config.js 的 DEFAULTS(完整清单见 app/config.example.yml)。
@@ -26,6 +30,9 @@ set -euo pipefail
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$REPO_DIR"
+# 支持 --env-only 参数:只刷 .env 密钥(幂等,绝不碰 config.yml)
+if [ "${1:-}" = "--env-only" ]; then ENV_ONLY=1; fi
+
CONFIG_YML="$REPO_DIR/config.yml"
ENV_FILE="$REPO_DIR/.env"
@@ -36,9 +43,13 @@ ZHIPU_KEY="${ZHIPU_KEY:-}"
AUTH_USER="${AUTH_USER:-admin}"
AUTH_PASSWORD="${AUTH_PASSWORD:-admin}"
PUBLIC_IP="${PUBLIC_IP:-}"
-AGENT_PORT="${AGENT_PORT:-8090}"
+# 记住用户是否显式给了端口(下面 .env 复用逻辑不能踩掉显式传参)
+AGENT_PORT_INPUT="${AGENT_PORT:-}"
+AGENT_PORT="${AGENT_PORT_INPUT:-8090}"
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-}"
AUTH_SECRET="${AUTH_SECRET:-}"
+# 微信接入服务 token(core ↔ wxbot 双向共用,compose 两侧同值注入;wxbot/ 子项目不入 git)
+WXBOT_TOKEN="${WXBOT_TOKEN:-}"
log() { echo -e "\n\033[1;32m===== $* =====\033[0m"; }
info() { echo -e "\033[1;36m[INFO]\033[0m $*"; }
@@ -61,20 +72,33 @@ log "生成 $ENV_FILE"
if [ -f "$ENV_FILE" ]; then
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(sed -n 's/^EXECUTOR_TOKEN=//p' "$ENV_FILE" | head -1)}"
AUTH_SECRET="${AUTH_SECRET:-$(sed -n 's/^AUTH_SECRET=//p' "$ENV_FILE" | head -1)}"
+ WXBOT_TOKEN="${WXBOT_TOKEN:-$(sed -n 's/^WXBOT_TOKEN=//p' "$ENV_FILE" | head -1)}"
+ # AGENT_PORT 同理复用:避免不带参数重跑时把部署机自定义端口重置回 8090(显式传参优先)
+ AGENT_PORT="${AGENT_PORT_INPUT:-$(sed -n 's/^AGENT_PORT=//p' "$ENV_FILE" | head -1)}"
+ AGENT_PORT="${AGENT_PORT:-8090}"
fi
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(gen_hex 32)}"
AUTH_SECRET="${AUTH_SECRET:-$(gen_hex 32)}"
+WXBOT_TOKEN="${WXBOT_TOKEN:-$(gen_hex 32)}"
cat > "$ENV_FILE" <