# 安装

## 1. 环境

- Python 3.9 或更高版本
- macOS、Linux 或受信任的本地开发环境

## 2. 创建隔离环境

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e '.[test]'
```

## 3. 创建本地秘密

分别生成两个不同的随机值，只导出到当前终端：

```bash
export WM_ADMIN_TOKEN="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
export WM_CSRF_TOKEN="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
```

不要把命令输出贴进聊天、截图、日志或 Git。`.env.example` 只展示变量名，不要直接改成真实值后提交。

## 4. 启动

```bash
wechat-manager-community
```

默认地址为 `http://127.0.0.1:8088`。看到健康检查返回 `{"status":"ok","publish_mode":"dry-run"}` 即完成本地验证。

## 5. 停止与清除登录态

停止服务使用终端中断。清除应用内会话状态：

```bash
curl -X POST http://127.0.0.1:8088/api/session/clear \
  -H "X-WM-Admin-Token: $WM_ADMIN_TOKEN" \
  -H "X-WM-CSRF: $WM_CSRF_TOKEN" \
  -H "Origin: http://127.0.0.1:8088"
```

## 6. 常见失败

- `Missing required environment variable`：当前终端没有导出令牌。
- `Origin not allowed`：请求来源不在 `WM_ALLOWED_ORIGINS`。
- `Remote binding requires...`：默认禁止绑定公网或局域网接口。
- `Community Edition supports dry-run...`：本版不支持真实发布。