feat(solve): monte_carlo_integral 落地，修掉体积符号真 bug

实现由用户本人写；Codex 只碰工程侧 + 一处纯 bug（决策 31）。

- 真 bug：体积写成 lows - highs，奇数维为负（1D x^2 于 [0,1] 得 -0.3324、3D 得 -0.5005）；
  2D 因两个负号相乘"看着对"（+0.2499），把 bug 藏住。改成 widths = highs - lows 后
  复测 0.3324 / 0.5005 / 1.9971（[0,2]）全部正确
- docstring：补 func / n / random_state 与 Raises；写清 metrics["mean"] 才是积分估计值、
  data 是 n 个样本各自的贡献（决策 51）；修掉跑不通的 Examples（data 是数组，bool(数组) 会抛）
- tests/test_solve.py：摘 1 条 skip + 新增 4 条（3D 奇数维 / [0,2] 宽度 / 2D+params / 非法 bounds）
- 验证：197 收集 / 166 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：STATUS 决策 51 + 3 条待办 + 下一站 random_walk；CHANGELOG；易错点 22/23，第 3 条复发 +1

CHANGELOG.md

@@ -399,6 +399,32 @@
 - `docs/dev/personal-pitfalls.md`：新增第 **21** 条（公式里的 `^` 不是乘方，且被 `except` 吞成 `success=False`），索引补到 21。
 - docstring 的 "Wald 区间" 同步改为 "Wilson score 区间"。
 
+### Added
+- `solve.monte_carlo_integral` 落地（**L1，S 档**，实现由用户本人写）：`bounds` → 自造 `(n, d)` 均匀样本 → 逐点求值 →
+  `mean(func(X) × 体积)`；内部自造 `sampler` / `simulator` 再复用 `monte_carlo` —— "造批 → 一次算 → 汇总"的第二次复用。
+  `params` 额外记 `bounds` / `dimension`；配套 `tests/test_solve.py` 新增 4 条 + 摘 1 条 skip。
+
+### Fixed
+- **`monte_carlo_integral` 的体积符号写反**（真 bug，按决策 31 修）：写成 `wights = lows - highs`，奇数维体积为负 ——
+  1D `x²` 于 `[0,1]` 实测 **-0.3324**（应 +1/3）、3D `x` 得 **-0.5005**（应 +1/2）；**2D `x·y` 却得 +0.2499 "看着对"**
+  （两个负号相乘抵消，把 bug 藏住）。改成 `widths = highs - lows` 后复测 **0.3324 / 0.5005 / 1.9971（`[0,2]`）** 全部正确。
+- `monte_carlo_integral` 的 docstring `Examples` 跑不通：断言 `abs(r.data - 1 / 3) < 0.01`，而 `data` 是 n 个样本的贡献数组，
+  `bool(数组)` 会抛 `ValueError: truth value ... is ambiguous`；改成断言 `metrics["mean"]`。
+- 格式：`simulate.py` 里 `def random_walk` 前只留了 1 个空行；`tests/test_solve.py` 有 3 处留了 3 个空行。
+
+### Changed
+- `monte_carlo_integral` 的 docstring 补齐 `func` / `n` / `random_state` 三节 `Parameters` 与 `Raises`（原文只有 `bounds` +
+  Notes + Examples）；`Returns` 写清"**`metrics["mean"]` 才是积分估计值**，`data` 是 n 个样本各自的贡献"（**决策 51**）。
+- `tests/test_solve.py`：摘掉 `test_monte_carlo_integral_converges_to_analytic_value` 的 skip，新增 3 条"抓符号"用例
+  （3D 奇数维、`[0,2]` 宽度、2D + `name`/`dimension`/`bounds` 三个 params）与 1 条非法 `bounds` 抛 `ValueError`；
+  `solve` 段 25 → **30** 条，全量 **197 收集 / 166 passed / 31 skipped / 0 xfail**（ruff 0 / pyright 0）。
+- `STATUS.md`：L1 清单加入 `monte_carlo_integral`；新增**决策 51** 与「`monte_carlo_integral` 的 3 条待办」；
+  「下一步」改成从 `random_walk` 接着写；验证计数更新为 166 / 31；`monte_carlo_probability` 的 6 条待办收窄到 1 条。
+- `docs/dev/personal-pitfalls.md`：新增第 **22 / 23** 条（失败结果的 `message` 被包装层无条件覆盖；体积/宽度也会减反、
+  维度奇偶会把符号错误藏住），第 3 条（注解与 docstring 不一致）**复发 +1**，索引补到 23。
+- `tmp/type_demo.py`（gitignored）：用 pyright 证明 `Callable[..., bool]` 会**拒绝**一个注解良好的向量化 `event`
+  （`ndarray` 与 `bool` 不兼容），`Callable[..., Any]` 才收 —— 这是决策 50 那条遗留的实际代价。
+
 ## [0.0.1] - 2026-10-01
 
 ### Added