修改底层请求逻辑，封装请求方法

docs/superpowers/plans/2026-07-10-tac-layer-real-mount-fix.md

@@ -0,0 +1,72 @@
+# TAC Layui 实际挂载点修复实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**目标：** 修复 Layui 遮罩已显示、验证码接口已返回 200，但 TAC 验证窗口仍不显示的问题。
+
+**架构：** `CaptchaPages.createCaptchaLayer` 使用 Layui `layer.open` 的字符串 `content` 创建弹层内部真实挂载节点；弹层创建完成后再从 `document` 查询该实际节点，并把它交给 `CaptchaConfig.bindEl`。这样 Layui 负责弹层，TAC 挂到已经进入页面的真实 DOM。
+
+**技术栈：** Layui 2.11.5、TAC 原生 CSS/JS、原生 JavaScript、Node `assert` 测试。
+
+## 全局约束
+
+- 计划创建时间：2026-07-10 10:59:52 +08:00。
+- 不修改 `public/tac/css/tac.css`、`public/tac/js/tac.min.js` 或 Layui 第三方文件。
+- 不新增验证码自定义 CSS，不注入样式，不传 TAC 视觉配置。
+- 保留 `auth-pages.js -> CaptchaPages.ensureToken -> TAC` 调用链，只修正弹层挂载点。
+
+---
+
+### 任务 1：复现“遮罩有但实际挂载点不可见”
+
+**文件：**
+- 修改：`tests/captcha-pages.test.js`
+
+- [x] **步骤 1：写失败测试**
+
+断言 `layer.open` 的 `content` 是包含唯一 `data-captcha-layer-box` 的字符串；`createCaptchaLayer` 必须在弹层打开后从 `document.querySelector` 取到实际挂载节点并返回。
+
+- [x] **步骤 2：运行失败测试**
+
+运行：`node tests\captcha-pages.test.js`
+
+预期：失败，当前实现仍返回打开前创建的原生 DOM。
+
+### 任务 2：修正实际挂载点
+
+**文件：**
+- 修改：`public/js/captcha-pages.js`
+
+- [x] **步骤 1：最小实现**
+
+增加内部自增 ID，用字符串内容创建 `<div data-captcha-layer-box="..."></div>`；`layer.open` 后查询该节点并作为 `box` 返回。
+
+- [x] **步骤 2：运行聚焦测试**
+
+运行：`node tests\captcha-pages.test.js; node --check public\js\captcha-pages.js`
+
+预期：全部通过。
+
+### 任务 3：记录和回归
+
+**文件：**
+- 修改：`docs/pc-api-page-integration-tracker-2026-07-09.md`
+- 修改：`docs/superpowers/plans/2026-07-10-tac-layer-real-mount-fix.md`
+
+- [x] **步骤 1：补充 PC-019 记录**
+
+记录用户浏览器复现现象、根因、修正方式、验证命令。
+
+- [x] **步骤 2：最终验证**
+
+运行：`node tests\auth-page-structure.test.js; node tests\captcha-pages.test.js; node --check public\js\captcha-pages.js; git diff --check`
+
+预期：全部通过；`git diff --check` 仅允许 Git 行尾提示，不允许空白错误。
+
+## 完成记录
+
+- 完成时间：2026-07-10 11:04:18 +08:00。
+- 根因：PC-018 只让 `layer.open` 不再因 `.parents()` 报错，但仍把打开前创建的临时 DOM 返回给 TAC；真实浏览器里 Layui 遮罩已出现，`/captcha/challenge` 也返回 200，但 TAC 没有挂到可见弹层内容区。
+- 修复：`layer.open` 使用字符串 `content` 创建弹层内部真实节点，随后通过 `document.querySelector('[data-captcha-layer-box="..."]')` 获取实际挂载点并交给 `CaptchaConfig.bindEl`。
+- 约束：未修改 `public/tac`，未新增验证码 CSS，未传 TAC 视觉配置。
+- 验证：失败测试已先复现；修复后 `node tests\captcha-pages.test.js` 和 `node --check public\js\captcha-pages.js` 通过。最终回归记录见 `docs/pc-api-page-integration-tracker-2026-07-09.md` 的 PC-019。