wa-app 是 WA 应用链路服务，提供账号管理、号码探测、注册、登录态检查、长连接会话和消息处理能力，并内置管理 dashboard。

• 账号管理：维护 WAAccount、客户端 profile、注册记录和登录态投影。
• 号码与注册：支持号码探测、SMS 探测、注册请求、OTP 提交和登录态检查。
• 连接与消息：支持长连接会话、消息接收、消息 ack、1:1 文本消息发送和会话查看。
• 数据提取：从消息中提取 OTP/Flag 候选值，并按敏感数据规则保存引用或脱敏投影。
• 管理界面：提供 dashboard，用于账号、联系人、消息、连接状态和账号资料操作。

推荐使用本仓库提供的 Docker Compose 启动服务：

cp .env.example .env
docker compose pull
docker compose up -d

如果你只是本地快速启动，也可以直接 docker compose up -d（不创建 .env 也能启动，未配置值使用 compose 默认值）。

默认端口（固定）：

• Dashboard：http://127.0.0.1:8080（docker-compose.yml 映射）
• gRPC：127.0.0.1:50091

若你确实要改主机映射端口，请直接改 docker-compose.yml 的 ports 行（非配置项）。

.env 中保留少量运行必需配置：

• WA_APP_IMAGE_TAG：镜像标签，生产建议使用固定版本。
• WA_APP_AUTH_PASSWORD：可选 dashboard 单密码登录；为空则关闭鉴权。
• WA_APP_DATA_DIR：容器内持久化目录；默认 /var/lib/wa-app。
• WA_APP_PG_DSN：可选 PostgreSQL DSN；为空时使用内置 SQLite 持久化。
• WA_APP_REDIS_URL：可选 Redis URL；为空时使用内置 SQLite 运行态存储。
• WA_COMMON_PROXY：系统默认 WA 出站代理；账号未配置代理策略且阶段代理为空时使用，仍为空则直连。

PostgreSQL 和 Redis 都是可选组件。需要启用时，在 docker-compose.yml 中取消对应服务注释，并在 .env 中填写 WA_APP_PG_DSN / WA_APP_REDIS_URL。

Dockerfile 支持在 wa-app 仓库内直接构建，不依赖 common-lib 构建上下文：

docker build -t wa-app-service:local .

在 byte-v-forge 聚合目录构建也可用：

docker build -f wa-app/Dockerfile -t wa-app-service:local .

WA APK 逆向工程、字段形状对齐记录、patch 模板和本地分析脚本统一维护在私有仓库：

• https://github.com/byte-v-forge/wa-reverse

wa-app 只保留运行时代码和服务说明，不提交 APK、反编译产物、抓包、WAMSYS blob 或逆向记录。

• LINUX DO - 新的理想型社区