diff --git a/docs/v2/17-batch-delivery-records.md b/docs/v2/17-batch-delivery-records.md index 3a306f5..a9cbbf0 100644 --- a/docs/v2/17-batch-delivery-records.md +++ b/docs/v2/17-batch-delivery-records.md @@ -56,16 +56,44 @@ - **界面点击未由自动化驱动**:本机无 playwright/puppeteer/chromium-cli,发起预审是通过 与页面按钮同一条代理请求完成的;"点按钮"这一步没有脚本化证据。 -- **材料确认步骤未在浏览器走一遍**:本轮直接用已存在的演示项目 DEMO-B; - "新建演示项目→确认材料"这一段仍只有 T02 的服务与测试覆盖。 +- **材料确认已走通(部分闭合)**:通过应用自己的入口补齐演示项目缺的字段—— + `POST /documents` 上传按解析器键名书写的材料(`operating_cashflow: 1200`)→ + 项目待确认候选 → `POST /supplements` 带 `candidate_ids` 确认 → + `financial.operating_cashflow` 等 3 个字段生效(revision 5→6)。 + **未闭合部分**:仍是接口调用而非浏览器点击。 - **演示角色需要 `XINGBANG_DEMO_ROLE_LOGIN=1`**:否则 worker 的 `authorized()` 会把 演示角色发起的运行判为"权限已撤销"(运行会失败但可读)。这是配置要求,需写入部署说明。 -- **模型类技能始终失败**:未配置内网模型,语义核查永远 `RUN_STEP_FAILED`; - 因此"完整跑完"路径仍未验证(不是本批的接通问题,但影响演示观感)。 +- **模型已接通,但预算不足**:配置 DeepSeek(`XINGBANG_LOCAL_MODEL_*`)后,模型类技能 + `corporate.analysis` 真实发起调用,先后遇到两类失败,都如实记成降级: + 1. `模型引用未知字段` —— 模型的引用被字段守卫拒绝;根因是演示项目缺 + `financial.operating_cashflow`,经上面"上传+确认"补齐后不再出现(守卫工作正常)。 + 2. `工具调用预算耗尽` —— 补齐字段后模型继续调用只读工具,超过方案冻结的 + `max_tool_calls: 12` 而终止。 + **待定**:提高演示方案的 `max_tool_calls`(阈值属产品/评审决定,不擅自改)或收敛 + Skill 的工具使用指令。在此之前,"模型全程跑完"仍未验证。 - 取消中的运行不产出视图(只处理 completed/partial/failed)。 --- +## 运行环境配置(本地演示,2026-09-30 实测) + +复现本记录需要以下环境变量。**密钥一律不入库、不写入任何文件**:本地演示用 shell 变量 +展开传入,正式环境请用部署系统的密钥管理。 + +```bash +XINGBANG_DEMO_ROLE_LOGIN=1 # 演示角色发起运行必需,否则 worker 判"权限已撤销" +XINGBANG_LOCAL_MODEL_URL=https://api.deepseek.com/v1 +XINGBANG_LOCAL_MODEL_NAME=deepseek-flash # 可换 deepseek-v4-pro(语义核查质量优先) +XINGBANG_LOCAL_MODEL_KEY=<你的 DeepSeek API Key> +# 后端启动前清空代理:实测直连 api.deepseek.com 可用(HTTP 200), +# 系统代理 127.0.0.1:7890 不可用(HTTP 000,与 AGENTS.md 记录的坑一致) +``` + +启动:`cd backend && venv/Scripts/python.exe -m uvicorn app:app --host 127.0.0.1 --port 8012`; +前端:`npm run dev -- -p 3212`,并设 `RISK_AGENT_BACKEND_URL=http://127.0.0.1:8012`(v2 隔离端口)。 + +--- + ## 第二批:完成历史经验加工流程 状态:**未开始**。