docs: reconcile production release contracts

docs/物业AI人力资源系统开发规格TechSpec.md

@@ -268,6 +268,7 @@ POST /api/ai/score       req:{ rubricId, dialogue }        resp:{ dimensions, co
 - 同步:`POST /api/sync/pull`(拉取组织人员,MVP 可读快照文件)
 - 知识检索(RAG):`POST /api/knowledge/search` → `{ queryText, category, answer, reference, docs[], snippets[], training[], records[] }`
 - 知识上传解析:`POST /api/knowledge/doc/upload` → `multipart/form-data { file, category }`，支持 `.txt/.md/.markdown/.pdf/.doc/.docx/.xls/.xlsx/.ppt/.pptx`、100MB 内；先落 `sys_oss` 并绑定 `aihr_knowledge_attach.oss_id`，返回 `{ docId, ossId, fileName, category, fragments, snippets[] }`；管理端上传请求 timeout 为 180s。
+- 批量异步上传:`POST /api/knowledge/doc/upload-async` → `multipart/form-data { file, category, batchId }`，只暂存并入队；ZIP ≤500MB，最多 1000 个子文件/2GB 解压量，拒绝 Zip Slip 与嵌套 ZIP，文件名兼容 UTF-8/GBK，同名子文件自动编号；`GET /api/knowledge/doc/upload-items` 轮询批次，`POST /api/knowledge/doc/upload-items/{id}/retry` 单文件重试。
 - 服务端目录导入:`POST /api/knowledge/doc/import-local-task` → `{ directory, category, limit }`，只允许读取 `AIHR_IMPORT_ROOT` / `aihr.import.root` 下的相对目录，写入后台导入任务并逐文件复用上传解析链路；`GET /api/knowledge/doc/import-tasks` 返回任务进度列表；`POST /api/knowledge/doc/import-tasks/{id}/cancel` 取消运行中任务；`POST /api/knowledge/doc/import-local` 保留同步调试。
 - 资料处理状态:`GET /api/knowledge/processing/overview` → 聚合附件状态、片段数、向量化状态、分类、处理链路和事件列表。
 - 片段向量化:同一上传接口在 `category=vector` 模型配置可用时调用 OpenAI-compatible `/embeddings`，写入 `embedding_json/embedding_model/embedding_time`，并尽力 upsert 到 Qdrant；未配置或 Qdrant 不可用不阻塞上传。