更新记录

1.2.0（2026-10-08） 下载此版本

1.2.0

• 首次上架：web-view 验码页，配合 @liujialin/web-tools verifyCaptcha
• 使用 window.postMessage 回传结果
• 需 npm install @liujialin/web-tools 并在项目 .env 配置 VITE_CAPTCHA_BASE_URL、VITE_CAPTCHA_SCENE_ID
• 接入说明见 npm 包内 docs/captcha-quickstart.md、docs/uni-integration-guide.md

平台兼容性

uni-app(3.8.5)

web-tools-captcha（Uni 验码页）

配合 npm 包 @liujialin/web-tools 使用（插件市场只提供验码页，逻辑在 npm 里）。

快速接入

1. 插件市场导入本插件（或复制本目录到 uni_modules/）
2. npm install @liujialin/web-tools
3. 复制 npm 包内 .env.example → 项目 .env.production，填写 VITE_CAPTCHA_BASE_URL、VITE_CAPTCHA_SCENE_ID
4. pages.json 注册：

{
  "path": "uni_modules/web-tools-captcha/pages/captcha/index",
  "style": { "navigationBarTitleText": "安全验证" }
}

5. App.vue：

<script setup lang="ts">
import { onLaunch } from '@dcloudio/uni-app'
import { initCaptchaFromEnv, DEFAULT_UNI_CAPTCHA_PAGE_PATH } from '@liujialin/web-tools'

onLaunch(() => {
  initCaptchaFromEnv({
    strict: true,
    env: import.meta.env,
    uniCaptchaPagePath: DEFAULT_UNI_CAPTCHA_PAGE_PATH
  })
})
</script>

6. 业务：await verifyCaptcha({ platform: 'uni' })

文档

• 环境变量：docs/env-configuration.md（安装后在 node_modules/@liujialin/web-tools/docs/env-configuration.md）
• Uni 详细步骤：node_modules/@liujialin/web-tools/docs/uni-integration-guide.md

自检

• [ ] 已配置 VITE_CAPTCHA_* 且 strict: true
• [ ] 已注册 pages.json
• [ ] 已安装 npm 并执行「安装插件三方依赖」