chore: sync local code on 2026-06-08

.dockerignore

@@ -0,0 +1,21 @@
+.git
+.gitignore
+.venv
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache
+.mypy_cache
+.vscode
+.idea
+
+backend/.env
+backend/tests
+frontend
+docs
+example_uploads
+
+node_modules
+npm-debug.log*
+yarn-error.log*

backend/.env.example

@@ -20,6 +20,15 @@ LANGSMITH_TRACING=false
 # 如需覆盖运行时输出的根目录，请设置 APP_RUNTIME_DIR（绝对路径）
 # APP_RUNTIME_DIR=
 
+# ============================================================================
+# PostgreSQL / pgvector（推荐）
+# ============================================================================
+# 开发环境可直接使用 pgsql.txt 中的 Docker 启动方式，然后把连接串指向容器。
+# 默认建议创建独立数据库，如 ctb；若直接使用 postgres 默认库，也可改为 /postgres。
+# APP_DATABASE_URL=postgresql+psycopg://postgres:root@localhost:15432/ctb
+# APP_DATABASE_ECHO=false
+# APP_POSTGRES_VECTOR_DIMENSIONS=1536
+
 # ============================================================================
 # 文字擦除模型权重（可选）
 # ============================================================================
@@ -45,6 +54,14 @@ LANGSMITH_TRACING=false
 # APP_DEFAULT_PADDLEOCR_USE_DOC_UNWARPING=false
 # APP_DEFAULT_PADDLEOCR_USE_CHART_RECOGNITION=false
 
+# ============================================================================
+# RAG 语义检索配置（可选）
+#
+# Embedding 模型复用 APP_DEFAULT_OPENAI_* 的 key 和 base_url。
+# 如果未配置 OpenAI provider，RAG 将降级为不生成向量，语义搜索自动回退到 hash 模糊匹配。
+# ============================================================================
+# APP_RAG_EMBEDDING_MODEL=text-embedding-3-small
+
 # ============================================================================
 # 验证码邮件 — SMTP 配置（注册验证码 + 找回密码共用）
 #

backend/agents/error_correction/agent.py

@@ -8,6 +8,21 @@
 import re
 import threading
 import time
+
+# ============================================================
+# Monkeypatch: 修复 langgraph 依赖冲突
+# ============================================================
+try:
+    import langgraph.runtime
+    if not hasattr(langgraph.runtime, 'ExecutionInfo'):
+        class ExecutionInfo: pass
+        langgraph.runtime.ExecutionInfo = ExecutionInfo
+    if not hasattr(langgraph.runtime, 'ServerInfo'):
+        class ServerInfo: pass
+        langgraph.runtime.ServerInfo = ServerInfo
+except ImportError:
+    pass
+
 from langchain.agents import create_agent
 from langchain.agents.structured_output import ToolStrategy
 from langchain_core.messages import SystemMessage, HumanMessage