메뉴
指导使用 Baklib 开源导入工具（路径清单 → Excel → Open API）将本机、NAS 或挂载盘上的文件按目录层级迁入 Baklib 资源库（DAM），并可选择同步创建 CMS 站点资源页。在用户提到批量导入、本地文件进 Baklib、DAM 迁移、importer、 Excel 导入、路径清单预处理时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
指导在终端用 @baklib/baklib-cli（baklib 命令）通过 Baklib Open API 管理站点、知识库、DAM、成员与用户，以及主题拉取/预览上传与本地 theme dev；含鉴权配置、--json 脚本输出与执行规范。在用户已安装或可安装 baklib CLI、要用命令行/脚本/CI 读写 Baklib 线上数据时使用；Liquid 模版语法见 baklib-theme-dev（需另行安装）。
Baklib 专用：根据 CHANGELOG/更新说明撰写面向用户的对外发布日志（Markdown 正文 + 封面图提示词）， 用于 release.baklib.cn 等站点页；含标题规范、help.baklib.cn/术语表内链、DaisyUI baklib 品牌与 Liquid Glass 封面。 在用户要写 Baklib 发布日志、release note、版本更新文章、或从 CHANGELOG 生成对外稿时使用；出图与 MCP 写入须先确认。
Baklib 站点主题（模板）开发：Liquid 目录与命名、`config/settings_schema.json` 与模板 `{% schema %}`、多语言 `locales`、对象与指令/过滤器、静态页 URL、seeds 与迁移；站点表单 `form_tag`/`form_field_tag` 全量说明见 references/forms.md。并含「新建主题脚手架」「参考站复刻工作流」、本地 `baklib theme dev` 预览，以及 CLI 初始化 manifest（template.json，见 references/theme-init-template-manifest.md）。新建或迭代主题起步模版、写 template.json、theme init/apply 时必读该文档；完成主题开发后应把过程沉淀进 manifest 的 developmentNotes/workflow。页面预览参数用 `baklib theme preview set`（theme-preview-page-config.md），勿让用户手填面板。在用户编写 .liquid、配置 schema、新建模板、复刻参考站或排查模板与变量时使用；详规见 references/。
本地 MinerU 将 PDF/Office/图片转为 Markdown（含 images/ 图文、表格与公式识别）。复杂版式、扫描件、长书须先确认页范围与后端。用户要转 PDF、提取表格、OCR、或问「这篇 PDF 讲了什么」时使用。
通过 Playwright CDP 连接用户本机 Chrome，提供页面感知 JSON（链接、输入框、按钮等）与类人操作（点击、填写、滚动、截图）。 业务逻辑由消费该技能的 AI 决策，脚本不做站点硬编码。用于网页调研、表单填写、可控交互抓取； 涉及发布评论、点赞、关注、私信、表单提交等写入外部系统的操作前须先向用户确认执行计划。
Self-contained guide for writing Baklib BKE Markdown (L1/L2, DAM dam-id, file colon-syntax, link cards, fragments, embeds, tables). Use when authoring or importing BKE Markdown, inserting DAM assets, or resolving DAM ids via MCP; not for editor implementation or maintaining product docs repos.
| name | baklib-data-import |
| description | 指导使用 Baklib 开源导入工具（路径清单 → Excel → Open API）将本机、NAS 或挂载盘上的文件按目录层级迁入 Baklib 资源库（DAM），并可选择同步创建 CMS 站点资源页。在用户提到批量导入、本地文件进 Baklib、DAM 迁移、importer、 Excel 导入、路径清单预处理时使用。 |
官方工具仓库：https://github.com/baklib-tools/importer
核心流程：生成 UTF-8 路径清单（每行一个绝对路径）→ 离线预处理生成 Excel → 在表中可选填写「打标签」「新目录」→ 配置 Open API → 执行导入脚本。
pip install -r requirements.txtaccess_key、secret_key、目标 site_id 及正确的 api.base_url（见控制台 / 文档）在 macOS / Linux 上可用 find 导出文件列表（详见仓库 docs/02-file-list-mac-linux.md）：
find /你的根目录 -type f > file_list.txt
清单需为 UTF-8，每行一个绝对路径。
python3 preprocessing/extract-file-paths.py ./file_list.txt --split 10000 --format excel
预处理不访问网络。--split 可按行数拆成多个表；输出目录中的 .xlsx 供下一步编辑。
长时间导入期间的增量文件：若从开始清单到导入完成相隔很久，客户可能在原磁盘继续写入新文件。导入结束后可再扫一遍磁盘，用清单差集只挑出新增路径：
python3 preprocessing/compare_file_lists.py \
--baseline ./file_list_at_import_start.txt \
--current ./file_list_rescan.txt \
-o ./new_files_only.txt
# 或 --scan /数据根目录（清单勿放在该目录内，避免被当成新文件）
得到 new_files_only.txt 后，可再执行本技能第 2 步 extract-file-paths.py 生成 Excel 并走导入。详见 importer 仓库 preprocessing/README.md。
按 docs/03-excel-guide.md 理解各列；可批量填写 打标签、新目录，覆盖或补充仅由路径推导的结果。
将 config.example.json 复制为仓库根目录的 config.json，填写密钥与导入段参数（示例字段名以仓库内文件为准）：
site_id、api.base_url、api.access_key、api.secret_keyimport.path_prefix：去掉盘符/共享根等前缀后，用于对齐 Baklib 中 DAM 目录层级；过深时受 import.max_depth 等限制import.skip_directories：可选，跳过指定相对路径子树**excel_path_prefix + local_path_root**（见官方 README 与 docs/）仅导入资源库（DAM）：
python3 baklib_import/import_files_to_dam.py --excel ./your.xlsx --config config.json
DAM + CMS 站点资源页（Wiki 类站点请仅用 DAM 脚本）：
python3 baklib_import/import_files_to_site.py --excel ./your.xlsx --config config.json
首次运行强烈建议：--dry-run 和/或 --max-rows 10 试跑；更多参数见 docs/05-import-runbook.md。
config.json、含内部路径的 Excel 或敏感日志提交到 Git。.gitignore 本地 config.json；用户自己的副本需自行保管。| 路径 | 用途 |
|---|---|
docs/00-index.md | 总入口与阅读顺序 |
docs/01-workflow-sop.md | 端到端 SOP |
docs/04-import-quickstart.md | API 导入快速开始 |
docs/05-import-runbook.md | 命令行参数与行为 |
代理协助用户时：若涉及具体列名、Windows 排障或高级参数，应引导阅读上述文档或打开仓库中对应文件，避免臆造未在文档中出现的 API 字段。