feat: human-captcha-modal.md

Author: SeasonsChange422

docs/components/human-captcha-modal.md

@@ -67,11 +67,37 @@ const verify = async () => {
 | -------------- | ---------------------- | ----------------------------------- | ----------------------------------------------------- |
 | text           | 标题/说明/按钮文案     | `HumanCaptchaTextOptions`           | 内置中文默认文案                                      |
 | position       | 随机定位与 clamp       | `HumanCaptchaPositionOptions`       | `{ centerJitterPx: 120, clampMarginPx: 12 }`          |
-| size           | 弹窗尺寸               | `HumanCaptchaSizeOptions`           | `{ widthPx: 360, heightPx: 220 }`                     |
+| size           | 弹窗尺寸               | `HumanCaptchaSizeOptions`           | `{ widthPx: 360, heightPx: 200 }`                     |
+| canvas         | canvas 文案绘制样式    | `HumanCaptchaCanvasOptions`         | `{}`                                                  |
 | antiAutomation | 反自动化信号（可关闭） | `HumanCaptchaAntiAutomationOptions` | `{ minSolveTimeMs: 700, requirePointerTravelPx: 80 }` |
 | challenge      | 挑战类型（可插拔）     | `HumanCaptchaChallengeOption`       | `click-button`                                        |
+| security       | 安全相关配置           | `HumanCaptchaSecurityOptions`       | `{ shadowRootMode: 'closed' }`                        |
 | timeoutMs      | 超时自动取消           | `number`                            | `0`（不超时）                                         |
 
+### canvas
+
+用于控制标题/说明/按钮文案的 canvas 绘制样式（可选）。常见需求是调整字号或颜色：
+
+```ts
+import { createHumanCaptcha } from 'tml-ui'
+
+const captcha = createHumanCaptcha({
+  canvas: {
+    titleStyle: { fontSizePx: 18, fontWeight: 600 },
+    messageStyle: { fontSizePx: 14 },
+    buttonStyle: { fontSizePx: 14 }
+  }
+})
+
+await captcha.verify()
+```
+
+### security
+
+| 字段           | 说明                                   | 类型                   | 备注 |
+| -------------- | -------------------------------------- | ---------------------- | ---- |
+| shadowRootMode | ShadowRoot 模式（默认 closed，尽力而为） | `'closed' \| 'open'` | `open` 建议仅用于测试/调试 |
+
 ### antiAutomation
 
 | 字段                   | 说明             | 类型     | 备注            |
@@ -92,8 +118,13 @@ const captcha = createHumanCaptcha({
     type: 'custom',
     factory: (ctx) => {
       // 你的 UI 可以挂载到 ctx.mountPoint
-      // 完成挑战后调用 ctx.requestSolve()
+      // 注意：mountPoint 初始会包含默认按钮，你可以复用/替换它
+
+      // 完成挑战后调用 ctx.requestSolve()（会应用 antiAutomation 门槛）
       // 取消则调用 ctx.cancel()
+
+      // 如需读取信号，可使用：
+      // const { openedAtMs, pointerTravelPx } = ctx.getSignals()
       ctx.requestSolve()
 
       return {