القائمة
指导使用 Baklib 开源导入工具（路径清单 → Excel → Open API）将本机、NAS 或挂载盘上的文件按目录层级迁入 Baklib 资源库（DAM），并可选择同步创建 CMS 站点资源页。在用户提到批量导入、本地文件进 Baklib、DAM 迁移、importer、 Excel 导入、路径清单预处理时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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 字段。
指导在终端用 @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.