- 元数据 + 向量单事务提交,避免 PATCH 半提交(审阅 #2) - vectorstore upsert 改 delete-then-insert 幂等,支持共享 conn - FTS 取全量 + 过滤 oversample,修复 metadata 过滤漏召回(审阅 #4) - PATCH tags 区分 None/[]/非空:保留/清空/替换(审阅 #5) - rebuild 拒绝增量 scope/note_ids,扫描先行 + 失败回滚旧索引(审阅 #6) Co-Authored-By: Claude <noreply@anthropic.com>
Backend
FastAPI + Pydantic 的本地 AI Core / Agent Core。项目使用 uv 管理依赖和虚拟环境。
uv sync
uv run uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
uv sync 首次运行时会自动创建由 uv 管理的 .venv,无需手动执行 python -m venv 或激活环境。
启动后可访问:
团队接口清单见 ../docs/后端接口契约-开发版.md,机器可读契约以运行时的 /openapi.json 为准。
AI Core 与 Agent Core 的模块边界、Mock Provider 和 Tool Calling 调试方式见 ../docs/AI-Core与Agent-Core开发说明.md。
Knowledge Core 与 Retrieval Core 的模块边界、数据模型、接口与检索流程见 ../docs/Knowledge与Retrieval-Core开发说明.md。