语雀批量管理文档有四种方案：一、内置批量操作功能，支持转移、删除、复制；二、调用api+脚本实现定制化批量处理；三、借助yuque-exporter导出元数据辅助决策再迁移；四、通过浏览器控制台执行临时js操作。
如果您在语雀中积累了大量文档，但发现单篇操作效率低下、目录结构难以统一维护，或需对数十篇文档执行转移、删除、复制等一致动作，则说明当前管理方式已触及人工处理的瓶颈。以下是实现语雀批量管理文档的多种可行方案：
一、使用语雀内置批量操作功能
语雀知识库管理页面原生支持对多篇文档进行集中操作，无需第三方工具或开发能力，适用于常规运维场景。该方式直接调用平台前端接口，响应快且权限受账户角色严格控制。
1、进入目标知识库首页，点击右上角「管理文档」按钮，跳转至文档管理视图。
2、在文档列表中，勾选左侧复选框选择多个文档；支持按住 Ctrl（Windows）或 Command（Mac）键多选，也可点击顶部“全选”快速选取当前页全部文档。
3、点击页面上方操作栏中的「转移」按钮，在弹出窗口中选择目标知识库，确认后所有选中文档将同步迁移至指定位置。
4、如需批量删除，点击「删除」按钮，系统将提示二次确认；删除操作不可逆，请确保已提前完成本地备份或导出。
5、点击「复制」可将选中文档批量复制到同一知识库或其他知识库，新文档标题自动添加“副本”后缀以作区分。
二、通过语雀 API + 自动化脚本批量管理
对于企业用户、技术团队或需定制化逻辑（如按标签筛选、按更新时间过滤、跨知识库条件迁移）的场景，调用语雀开放API可实现精准可控的批量管理。该方式要求具备基础编程能力及 API Token 权限配置。
1、登录语雀官网，进入「设置」→「开发者管理」，点击「生成新令牌」，勾选 repo.public_write、user.info、repo.list 等必要权限范围，保存生成的 Token 值。
2、准备运行环境：安装 Node.js（v14+），新建项目目录并初始化 npm，执行 npm install node-fetch 或其他 HTTP 客户端依赖。
3、编写 JavaScript 脚本，使用 GET /repos/{namespace}/{slug}/docs 接口拉取目标知识库全部文档元数据，结合条件（如 updated_at > '2025-01-01'）筛选目标文档 ID 列表。
4、遍历文档 ID，对每篇文档发起 PUT /docs/{id} 请求修改其 book_id 字段，实现静默转移；或调用 DELETE /docs/{id} 执行批量删除。
5、运行脚本前，务必在测试知识库中验证逻辑，避免误操作影响生产内容。
三、借助 yuque-exporter 工具反向驱动批量管理
yuque-exporter 本质为导出工具，但其完整获取文档元数据与目录结构的能力，可被延伸用于辅助批量管理决策。适用于需“先审阅、再操作”的审慎型管理流程。
1、执行 npx yuque-exporter --token=your_token 命令，工具自动下载全部文档元数据（含标题、slug、book_id、updated_at、toc_order 等字段）至本地 ./storage/meta.json。
2、使用 VS Code 或任意文本编辑器打开 meta.json，按需筛选字段：例如提取所有 book_id 不等于目标知识库 ID 的文档，生成待转移清单。
3、将筛选结果整理为 CSV 文件，包含 doc_id, title, current_book_id, target_book_id 四列，作为后续 API 脚本的输入源。
4、编写轻量级迁移脚本，逐行读取 CSV，调用语雀 API 更新每篇文档所属知识库，迁移过程可记录日志并跳过失败项，保障操作可追溯。
5、迁移完成后，再次运行 yuque-exporter 导出新知识库结构，比对前后 meta.json 文件差异，验证批量操作结果。
四、利用浏览器控制台执行临时批量操作
在无法部署脚本或仅需一次性快速处理时，可通过浏览器开发者工具注入 JavaScript 代码，直接操作当前页面 DOM 与语雀前端暴露的 SDK 实例。该方式门槛低、见效快，但仅限当前会话有效，不推荐长期依赖。
1、打开语雀「管理文档」页面，确保已加载全部目标文档（可滚动到底部触发分页加载）。
2、按 F12 打开开发者工具，切换至 Console 标签页。
3、粘贴并执行以下代码片段（以批量勾选全部可见文档为例）：document.querySelectorAll('input[type="checkbox"][name="doc"]').forEach(cb => cb.checked = true);
4、若需批量点击「转移」按钮，执行：document.querySelector('button[aria-label="转移"]').click();
5、此操作绕过前端防重复提交机制，请勿连续多次执行，避免触发平台风控限制。
