|
|
@@ -21,6 +21,34 @@
|
|
|
- 多模块同时修改时：用 `git add -p` 或分次 `git add` 精确控制 staged 范围
|
|
|
- 提交前：`git diff --cached --stat` 检查 staged 内容是否仅包含目标文件
|
|
|
|
|
|
+### 本地健康报告采集：AI 必须自动拉起依赖
|
|
|
+
|
|
|
+用户说「启动本地」「测报告上传/解析」「启动 opencode / LangGraph」或让 AI 拉起本地环境时： **先探活，缺什么起什么，不要只口述命令。**
|
|
|
+
|
|
|
+| 服务 | 端口 | 探活 | 未在听则执行 |
|
|
|
+|------|------|------|--------------|
|
|
|
+| `cfc-backend` | 9082 | `http://127.0.0.1:9082` | **不要擅自重启 IDE 里已在跑的后端**；仅在确认没进程时再 `mvn spring-boot:run` |
|
|
|
+| LangGraph 报告解析（本地最小服务） | 9000 | `http://127.0.0.1:9000/health` → `{"status":"ok"}` | 见下方启动命令 |
|
|
|
+| opencode（采集兜底） | 4090 | `http://127.0.0.1:4090` | 见下方启动命令 |
|
|
|
+| `pdftotext` | — | `pdftotext -v` | 已装过则不用启动；缺失则 `winget install --id oschwartz10612.Poppler -e` |
|
|
|
+
|
|
|
+**本机 Windows 启动命令（PowerShell，后台跑、不要占用对话）：**
|
|
|
+
|
|
|
+```powershell
|
|
|
+# 1) LangGraph 报告解析（Python 3.14 装不齐完整栈，本地只用最小服务）
|
|
|
+cd d:\Java_code\CFC\cfc-langgraph
|
|
|
+.\.venv\Scripts\python.exe -m uvicorn local_report_app:app --host 0.0.0.0 --port 9000
|
|
|
+
|
|
|
+# 2) opencode
|
|
|
+$env:OPENCODE_ADMIN_PASSWORD = "IwinTrue@123"
|
|
|
+opencode web --port 4090 --hostname 127.0.0.1
|
|
|
+```
|
|
|
+
|
|
|
+- 只测登录/家庭/商城：不必开 9000/4090。
|
|
|
+- 测健康报告上传、异步采集、解析入库：**9000 必须开**，4090 建议开（LangGraph 解析为空时回退）。
|
|
|
+- 指纹脚本是文件不是服务：`docs/scripts/fingerprint_engine.py`（及 `docs/scripts/parsers/` 副本）。`application.yml` 的 `python.executable` 必须是 `python`，禁止走微软商店空壳 `python3`。
|
|
|
+- 完整 `app.main:app`（对话/RAG/whisper）本机默认不启；生产走 `ai.etotem.com.cn`。
|
|
|
+
|
|
|
### 新增 Controller/Service 前必做
|
|
|
|
|
|
1. **查阅接口文档**：先看 `docs/superpowers/api/API_REFERENCE.md`，确认是否已有可复用或可修改的接口
|
|
|
@@ -307,6 +335,10 @@ npm run build # 生产构建 → rsync 到 192.168.16.2
|
|
|
|
|
|
# 数据迁移 (sfms → zxyj)
|
|
|
curl -X POST http://localhost:9082/api/migration/run
|
|
|
+
|
|
|
+# 本地健康报告采集依赖（AI 按「重要工作流」探活后按缺启动）
|
|
|
+cd cfc-langgraph && .venv/Scripts/python.exe -m uvicorn local_report_app:app --host 0.0.0.0 --port 9000
|
|
|
+# opencode: $env:OPENCODE_ADMIN_PASSWORD="IwinTrue@123"; opencode web --port 4090 --hostname 127.0.0.1
|
|
|
```
|
|
|
|
|
|
## 数据库
|
|
|
@@ -365,7 +397,14 @@ curl -X POST http://localhost:9082/api/migration/run
|
|
|
| `cfc-web/AGENTS.md` | Web管理端规范 |
|
|
|
| `tests/AGENTS.md` | 分层测试策略 |
|
|
|
|
|
|
-## opencode自动启动
|
|
|
-当用户要求启动本地opencode时：自动在cli命令行执行如下命令：
|
|
|
+## 本地采集 / AI 服务自动启动
|
|
|
+
|
|
|
+用户要求启动本地、测报告解析、或启动 opencode / LangGraph 时，按上文「本地健康报告采集：AI 必须自动拉起依赖」执行：先探活 9082 / 9000 / 4090，缺哪个起哪个。
|
|
|
+
|
|
|
+```powershell
|
|
|
+cd d:\Java_code\CFC\cfc-langgraph
|
|
|
+.\.venv\Scripts\python.exe -m uvicorn local_report_app:app --host 0.0.0.0 --port 9000
|
|
|
+
|
|
|
$env:OPENCODE_ADMIN_PASSWORD = "IwinTrue@123"
|
|
|
-opencode web --port 4090 --hostname 127.0.0.1
|
|
|
+opencode web --port 4090 --hostname 127.0.0.1
|
|
|
+```
|
