致远 OA 文档库批量下载（API 直连，绕过 WebOffice/AOPR）
适用场景
- 目标：致远 A8 协同 OA 的文档类模块（文档中心、文档库）。
- 用户想批量把整棵目录树下的文档导出到本地，形成可编辑文件库。
- 文档通常是普通 Office 文件（doc/docx/xls/xlsx/ppt/pptx/pdf），未加密，直接下载即可编辑，无需 AOPR。
为什么走 API 而不是浏览器自动化（方法论）
- 浏览器在沙箱里往往无法 CDP 调试，pyautogui/pywinauto 也控制不了窗口 → GUI 路线走不通。
- 即便能开浏览器，WebOffice 缓存是临时文件、路径不稳定、还要 AOPR 解密，链路脆弱。
- 最优解：在浏览器 F12 → Network 复制一个有效请求（含会话 Cookie），用 Python
requests重放，纯 API 完成"枚举 + 下载"。
接口与调用格式（通用，所有路径都带 /seeyon 上下文）
基地址：https://<OA域名>/seeyon
1. 获取会话 Cookie（必须用户从 F12 提供）
让用户打开 OA，F12 → Network，复制任一 ajax.do 请求的 cURL → 提取其中的 Cookie: 头。
典型字段：标准会话令牌（如 JSESSIONID 等，其余字段名随 OA 版本不同）。直接复制 F12 里的完整 Cookie 头即可，无需关心每个字段的具体名称。
> ⚠️ Cookie 会过期（几小时~1天）。失效后需重新抓。切勿把含真实 Cookie 的脚本外传。
2. 枚举目录树（关键接口）
POST /seeyon/ajax.do?method=ajaxAction&managerName=docHierarchyManager
- 展开文件夹：managerMethod=getTreeNodesForDocIndex，arguments=[{"id":<节点id>,"resId":<节点id>,"frType":<数字>,"projectTypeId":null}]
- 文档库根：arguments=[{"isLibRoot":"true"}]
- 系统根：arguments=[{"isRoot":"true"}]
返回 JSON 数组，节点含 docResource.id / docResource.frName / docResource.frType / docResource.isFolder。
3. 列出某目录内容（同时含子文件夹 + 文档，递归只需这一个）
POST /seeyon/ajax.do?method=ajaxAction&managerName=docHierarchyManager&managerMethod=getRightNewListData
- arguments 为 JSON 数组：[flipInfo, docResource参数]
- flipInfo = {"page":1,"size":200,"isSearch":false,"_condition":null,"_value1":"","_value2":""}
- docResource参数 = {"entranceType":"6","isShareAndBorrowRoot":"false","frType":<数字>,"resId":<节点id>,"all":"true","list":"true","read":"true","add":"true","edit":"true","del":"true","lend":"true","openToZone":"true","print":"true","download":"true","isSearch":"false","searchCondition":"","searchValue1":"","searchValue2":"","projectTypeId":null,"searchType":""}
- 响应 data 每项含：docResource(id/frName/isFolder/frType/sourceId/mimeTypeId) + isUploadFile(bool) + createDate + vForDocDownload。
- 子文件夹和文档都在 data 里：isFolder=true 为文件夹，递归再调一次本接口；否则为文档。
- 分页：当 len(data)==size 且 <total 时 page+=1 继续。
4. 下载文档（未加密原文件）
GET /seeyon/fileDownload.do?method=download&viewMode=download&fileId=<docResource.sourceId>&createDate=<行.createDate>&filename=<docResource.frName>&v=<行.vForDocDownload>&CSRFTOKEN=null
- 响应体即 Office 文件（magic 字节 PK=zip 类 docx/xlsx/pptx，\xd0\xcf=老版 doc/xls/ppt，%P=pdf）。直接 wb 落盘。
- CSRFTOKEN=null 即可（该环境 CSRF token 固定为字符串 "null"）。
关键坑位（必看）
- 所有端点都要带
/seeyon前缀，否则 404。 frType决定能否展开：
-frType=31：普通文件夹/文档，树展开和列表都正常（绝大多数业务目录都是它）。
-frType=47：文档库类型的虚拟库根（如"XX集团文档"），getTreeNodesForDocIndex和getRightNewListData对它都返回空，无法展开。遇到"卡在库根"时，不要死磕——让用户从浏览器打开目标子目录，F12 复制那个子目录（通常是 frType=31 节点）的请求 cURL，直接以它的节点 id 作为入口即可。- 入口节点怎么找：让用户打开目标目录页，F12 看
doc.do?method=docIndex&docResId=XXXX的 Referer，或复制展开该目录的getTreeNodesForDocIndex请求arguments里的 id，那就是可展开的 frType=31 节点。 - Cookie 过期：出现 401/空响应/重定向到登录页时，重新抓 cURL。
- 文件名去非法字符：Windows 下把
<>:"/\|?*替换为_；若frName无扩展名，按mimeTypeId补（47→.docx, 41→.doc, 48→.xlsx, 49→.pptx, 3→.xls, 4→.ppt, 44/50→.pdf 等）。 - 断点续传：下载前检查目标文件已存在且 >0 字节则跳过。
标准流程（交付步骤）
- 用户提供 F12 复制的 cURL（含 Cookie）和入口目录的 cURL（含可展开节点 id）。
- 将 BASE / COOKIES / START_NODE / START_FR / OUT_ROOT 填入
scripts/download.py顶部配置区。 - 先
python scripts/download.py --dry-run统计目录数/文档数，确认规模与结构。 - 再
python scripts/download.py正式下载，输出到 OUT_ROOT，按 OA 原目录结构镜像。 - （可选）跑完生成一份 HTML 总清单（按分类列文件 + 大小）方便核对。
完整实现
可运行脚本见 scripts/download.py（已含递归列举、直接下载、分页、断点续传、非法文件名处理、dry-run 统计）。运行前只需替换顶部配置区的占位符。
