.ai-memory/project_progress.md

---
name: 项目当前进度与待办
description: wx-scan-authorize 三阶段状态快照、当前阻塞项与下一步，用于跨对话续接——新对话应先读本文件
type: project
---

`d:/wx-scan-authorize`（微信公众号扫码授权服务）截至 **2026-10-10** 的状态。

**三阶段进度**

| 阶段 | 内容 | 状态 |
|---|---|---|
| 1 | 扫码授权（`/wechat` 事件 + `/auth/*` + 首次关注送 7 天） | 已上线，微信真实推送已打通 |
| 2 | 使用扣减（`/usage/consume` + session_token + 节流记账） | 已上线 |
| 3 | 充值（微信公众号支付） | **未开始** |
| 附加 | 只读管理后台 `/admin`（计划外新增） | 2026-09-27 已上线 |

代码状态：本地与服务器均在 `f167550`，工作区干净。远端已从 GitHub 迁到自建代码服务器，
现又在应用服务器上跑起 **Gitea**（`git.ethereal-realm.top`，nginx 反代 127.0.0.1:3000），
详见 [生产服务器部署环境](project_server_deploy.md)。

客户端在 `d:/Ethereal-Realm`：CadOcr + cadAgent 已完成编码与客户端侧端到端验证，
`test_wxauth.exe` 已从控制台程序改造成 Win32 对话框，相关改动已提交 SVN r40/r41。详见
[CAD 插件微信授权集成](project_cad_wxauth_integration.md)。

**域名与 HTTPS 已上线（2026-10-10）**

ICP 备案已通过，域名直连可用，不再依赖 Cloudflare 隧道：
- nginx `wechat-api.conf` 已改为 **80→443 跳转 + 443 业务**（Certbot 管理），
  旧的 `app.conf`（IP 直连全量代理）已停用为 `app.conf.bak`。
- 证书 Let's Encrypt，有效至 2027-01-07，`certbot-renew.timer` 自动续期。
- 已验证：`https://ethereal-realm.top/wechat` 可达（422=缺参数，正常）、`/admin` 401、
  `/docs` 200。
- **待收尾**：`cloudflared-quick` 隧道仍在运行，应停用；
  `https://ethereal-realm.top/docs` 仍暴露（用户此前选「暂不处理」）。
- 注意：IP 直连（`http://39.107.55.179`）已失效（`app.conf` 停用），MFC 插件里写死的
  IP 联调地址会受影响。

**阻塞项与待办**

1. **正式公众号受限，无法切换**（2026-10-10，当前最大阻塞）：正式号是**个人订阅号、
   未认证、AppSecret 冻结**，而「带参数二维码」只有认证服务号能用 → 当前流程跑不通。
   详见 [公众号主体与接口权限现状](project_wechat_account.md)。**待用户选路线 A（办个体户
   注册服务号 + 认证）或路线 B（改流程用验证码绑定）**。
2. **阶段 3 充值暂缓**。微信支付要求认证服务号 + 营业执照，与上面同一主体问题。
3. **正式出包前必须去掉编译覆盖** `-DCADOCR_WX_BASE_URL=http://39.107.55.179`
   ——当前本地 DLL 是 IP 联调版，把服务端地址写死成了 IP；且该 IP 入口现已失效，
   需改为域名 `https://ethereal-realm.top`。
4. **AutoCAD 里人工验证 `cadAgent.arx`** ——我这边没有 AutoCAD，只能用户做。
   用户 2026-09-27 明确表示暂不做。
5. **IP 直连暴露 `/docs` 与 `/openapi.json`** ——现域名也暴露（`location /` 全量代理）。
   用户此前选暂不处理，可随手关掉。

**Why:** 会话内的任务列表不跨对话持久化，关闭对话后这些状态不会自动带过去；
只有写进记忆才能在新对话里续上。

**How to apply:** 新对话开始时先读本文件确认进度。动手前先确认公众号主体问题的路线选择，
它决定下一步是「办主体」还是「改代码」。