用 Cursor AI 批量上传本地目录到 Baklib 资源站点
无需手动写脚本或研究参数：下载官方 importer，配置 API Key，指定本地目录与目标站点，剩下交给 Cursor AI 全自动完成。
👋
目标：把本机 / NAS / 挂载盘里的海量文件，按原目录结构批量导入 Baklib DAM， 并同步创建站点栏目与资源页，让团队能像逛素材库一样检索与复用内容。
适用：素材包 / 归档盘 / 共享盘 / 客户资料交付离线预处理 + API 批量导入可断点、可试跑、可增量支持中文路径
遇到的问题
文件分散在多个目录里，人工上传费时费力；上传后目录结构丢失、标签不统一，检索体验差。
想要的结果
在 Baklib 里保留“原目录层级”，一键导入 DAM，并在站点里自动生成栏目与资源页，实现可浏览、可搜索、可分享。
方案怎么做
用 Baklib Importer 把“路径清单 → 可编辑 Excel → API 导入”串起来：先离线生成 Excel，业务同学可批量补标签/改目录，再执行导入。
导入后得到什么
DAM 里建好集合（目录）与标签，文件全部上传；站点里生成栏目层级与资源页，内容可直接作为“素材资源中心”对内/对外分发。
三步上手：下载 importer → 配置 API Key/站点 → 选择目录并一键执行（示意图）
你只需要准备 3 个信息
1）本地资源目录
例如：
/Users/你的用户名/Downloads/素材包（可以包含中文路径）。2）Baklib API Key
用于上传到 DAM、创建标签/目录、创建站点页面（如开启）。
3）目标站点（site_id）
你希望最终把内容展示在哪个站点栏目里，例如官网、培训站点、客户门户等。
Step 1：下载官方 importer 工具包（一次性）
打开官方仓库：baklib-tools/importer，下载 ZIP 或用 Git 克隆到本地。
建议在 Cursor 里直接打开这个仓库目录作为工作区（Workspace）。后续让 AI 执行时，它能自动读取脚本与文档并按仓库约定落盘产物与日志。
Step 2：配置 API Key（一次性）
你有两种常见方式，任选其一：
- 方式 A（推荐）：在项目根目录创建
.config/并放入 Key（单行文本）。 - 方式 B：复制
config.example.json为config.json，填入access_key/secret_key。
如何获得 API Key:在 Baklib 工作台 -- 个人中心 -- API 密钥
Step 3：在 Cursor 里一句话下达任务（核心）
把下面这段指令复制到 Cursor 对话框里，把尖括号内容替换成你的实际值即可。
请使用当前工作区的 baklib-tools/importer 工具包，把本地目录 <LOCAL_DIR> 下的所有文件批量导入到 Baklib。
要求：
+- 目标站点：site_id = <SITE_ID>，并把文章发布到栏目路径：“培训教程” → “场景应用”。
+- 过程全自动：AI 负责生成路径清单、预处理生成 Excel、调用 API 上传到 DAM，并同步创建站点资源页（如该站点为 CMS）。
+- 先 dry-run 或只导入前 5 条做验证，通过后再全量导入。
+- 上传完成后，生成一篇教程文章并发布（封面 + 配图一并上传到 DAM 并引用）。教程内容要求对外可发布（脱敏本地路径与 ID，隐去密钥）。
我会提供 API Key（已放在本地 .config/ 或 config.json 中），你不要把密钥输出到日志或文章正文。你会看到什么
- AI 先小批量验证（dry-run / max-rows）。
- 通过后开始全量上传：创建 DAM 集合（目录）与标签，上传文件。
- 若选择同步站点页：自动创建栏目与资源页。
- 最终返回：成功/失败统计、可点击的站点链接、以及本地 Excel/日志路径（方便审计与重跑）。
常见问题（FAQ）
Q1：目录层级会被保留吗？
会。Importer 的默认逻辑是“剥离路径前缀后，按剩余路径创建 DAM 集合层级”。你只需要让 AI 在执行前确认
import.path_prefix 的取值是否符合预期。Q2：导入中断怎么办？
Excel 与日志会记录进度；通常重新执行同一条导入命令即可断点续跑。AI 也会在复跑前先检查已存在的目录/标签/页面，避免重复创建。
Q3：我只想上传到 DAM，不创建站点页面？
没问题。把指令里“同步创建站点资源页”的要求去掉即可，AI 会改用仅 DAM 的导入入口脚本。
Q4：如何查看我的 site_id？
前提是你已经安装好 baklib-mcp-server，然后直接问它：
请列出我当前 Baklib MCP 下的所有站点。安装 baklib-mcp 命令：
npx skills add baklib-tools/skills --skill baklib-mcp
