docs: document parse_document and bump version to 1.3.11

Changelog, README (install pin, capability table, usage, deployment recipe, operations notes, known limits), env example, architecture, roadmap, the M3 design erratum and the CHSAnalyzer3 consumption notes.

.env.example

@@ -193,6 +193,15 @@ PGW_TELEMETRY_BACKEND=none               # sqlite | postgres | none(必填)
 # OCR__MONKEY__2__TIMEOUT_S=300
 # OCR__MONKEY__2__TRUST_ENV=false
 # OCR__RETRY__MAX_ATTEMPTS=3              # per-scope 韧性键与 LLM scope 同一套
+# 整份文档解析(parse_document,1.3.11):建议用**独立 scope** 指向同一服务,自带超时/重试/期限:
+# OCR_DOC__MONKEY__1__BASE_URL=http://10.77.0.20:7866
+# OCR_DOC__MONKEY__1__API_KEY=none
+# OCR_DOC__MONKEY__1__MODEL=monkey-ocr
+# OCR_DOC__MONKEY__1__TIMEOUT_S=600       # ≥ 最大页数 × 1.5s × 余量(共用 GPU 争用取 5 倍以上);不是总耗时上界
+# OCR_DOC__MONKEY__1__MAX_CONCURRENCY=2   # 服务为 sync-only 后端时取 1(每实例 /parse 全局串行)
+# OCR_DOC__MONKEY__1__TRUST_ENV=false
+# OCR_DOC__RETRY__MAX_ATTEMPTS=2          # 超时/GET 失败的重试会重新 POST 整份文档重算,压低
+# OCR_DOC__CALL_DEADLINE_S=900            # 单份硬上限;须 ≤ PGW_LEASE_TTL_S(缺省 1500)
 
 # ══ SOAK_OCR scope(P7 OCR 压测;tools/soak/run_soak.py --scenario P7 --scope SOAK_OCR)══
 # 双真实实例 + 黑洞(连接超时)+ 坏端口(连接拒绝)故障池;