落地并存测服全端：智能体 Graph/路由、后台切 8180、主账与部署脚本齐备，便于线上重发与验收。

Co-authored-by: Cursor <cursoragent@cursor.com>

inquiry-agent/README.md

@@ -1,8 +1,45 @@
 # 智能体 agent
 
-Python 3.12 + FastAPI。HTTP 默认 `8910`。
+Python 3.12 + FastAPI。HTTP 默认 `8910`；Worker 另起进程。
+
+## 基础框架自检
+
+```text
+set REDIS_BACKEND=memory
+set CHECKPOINT_BACKEND=memory
+python -m agent.foundation_selftest
+python -m agent.runtime_db.migrate --list
+```
+
+PG 真迁移：配好 `PG_*` 后 `python -m agent.runtime_db.migrate`（禁止 `ytd_runtime`）。
+
+消息账本：`MESSAGE_STORE_BACKEND=auto|memory|postgres`（有 DSN 时优先 PG inbox/outbox）。
+
+## Redis 骨架
+
+- 包：`agent/redis_coord/`（连接+前缀、Stream 入队/认领、短幂等、限流、token 缓存）。
+- **db1 不是名字**：Redis 只有数字逻辑库（URL `…/1`），与现网 `…/0` 隔离；可读名是键前缀 **`inquiry_robot:`**。
+- 自检：`set REDIS_BACKEND=memory` 后 `python -m agent.redis_coord.selftest`。
+- 正式：`REDIS_URL=redis://…@host:6379/1` + `REDIS_KEY_PREFIX=inquiry_robot:`（禁止 `ytd:prod:`）。
+
+## LangGraph 骨架
+
+- 包：`agent/graph/`（状态、分文件空节点、interrupt 停点、PG/Memory checkpoint、start/resume/wake）。
+- **无询价主逻辑**；节点只打日志。HTTP 回调禁止 `invoke` 整图。
+- 自检：`set CHECKPOINT_BACKEND=memory` 后执行 `python -m agent.graph.selftest`。
+- 正式：`CHECKPOINT_BACKEND=postgres` + `PG_*` 指向 `inquiry_robot_runtime`（禁止 `ytd_runtime`）。
+
+## 本迭代骨架（路由 / PDF / 识别）
+
+- DeepSeek A：`agent/routing/ordered_actions.py` + `deepseek_a.py`（strict `route_decision` tool；默认 stub，不开费）。
+- 分发：`agent/routing/dispatch.py`；通道 inbox → route → handler 表。
+- 真网开关：`LLM_DATA_USAGE_CONFIRMED=true` 且 `LLM_ALLOW_NETWORK=true`（Worker）才可能打模型。
+- LibreOffice：`agent/jobs/libreoffice.py` + `stream:pdf`（仅 1 槽）；路径 `LIBREOFFICE_PATH`。
+- 识别 / 存档：`stream:recognition` / `stream:archive` 入队壳。
+- 字段合同：仓库 `contracts/*.json`；拉取备份在 `_ref/prod-pull/`（gitignore）。
+- 本机密钥：仓库根 `.env`（gitignore）；新库口令来自服务器 `E:\wwwroot\ops\inquiry_robot_db_secrets.json`。
+- 另：session/suspend/job/死信、LLM 各 mode 空模块、S3 壳、ledger API 签名壳、模板 registry、policy、AIBOT 长连接壳、Java TMS 空包、`deploy/nssm/SERVICES.md`。
 
-## 本迭代：企微文字 echo 回复
 
 链路：回调/注入 → inbox 入队（快回）→ echo handler → outbox → 企微 `message/send`。