泛微E10文书定档案管理

解决什么问题

对接泛微E10档案核心系统时，开发者常面临三类问题：全宗查询、借阅车/借阅单管理、全文检索、预归档上传等场景分散在不同接口链路中，需手动拼装参数、处理多步骤调用顺序；不同场景的缓存策略不一致，易出现重复请求或参数失效；接口返回的原始数据含大量内部ID，需二次映射为用户可读的业务信息，且调用过程中若直接暴露接口名、技术参数，会增加用户理解成本。此外，认证逻辑与接口调用耦合，导致核心业务逻辑难以独立维护。

技能如何工作

技能的核心是通过标准化接口调用流程与统一缓存管理解决上述问题。调用前需先读取 references/catalog.md 定位目标接口，再查阅单接口文档确认参数与响应格式，完整接口地址与认证由 weaver-e10-login skill 统一处理，本技能不拼接地址、不实现认证。

同一 ETEAMSID 下的环境级缓存可大幅减少重复请求：

• appId、borrowCarObjId、borrowCarViewId 等环境级参数首次获取后缓存复用，ETEAMSID 变更时自动清除
• 列表/检索接口返回的内部ID（如档案ID、借阅车记录ID）静默缓存，后续操作直接复用，无需重复查询

参数展示遵循「业务语言优先」原则：

• 交互反馈仅使用题名、全宗名、档案号等业务字段，不暴露内部ID
• 过程播报仅保留「文件预检」「保存到档案库」等业务动作名称，去除接口名、参数值等技术细节
• 未确认的业务归属字段（如上传目标全宗）必须列选项供用户确认，不擅自假设默认值

适用边界与注意点

• 依赖 weaver-e10-login 完成认证与完整接口地址拼接，无独立认证能力
• 预归档上传需严格按 getTree → getFonds → preUploadCheck → upload → saveFile 五步顺序调用，步骤不可逆
• 失败边界明确：租户未导入档案应用（错误码80002）、无电子文件库节点、无上传权限（permissionType.upload=false）等场景需立即停止并提示原因
• 涉及附件上传时，需提前提醒用户附件内容可能发送至大模型服务，确认无敏感信息后才可处理
• 不自动切换同类候选接口，同类型接口调用失败后需说明原因