메뉴
指导在终端用 @baklib/baklib-cli（baklib 命令）通过 Baklib Open API 管理站点、知识库、DAM、成员与用户，以及主题拉取/预览上传与本地 theme dev；含鉴权配置、--json 脚本输出与执行规范。在用户已安装或可安装 baklib CLI、要用命令行/脚本/CI 读写 Baklib 线上数据时使用；Liquid 模版语法见 baklib-theme-dev（需另行安装）。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | baklib-cli |
| description | 指导在终端用 @baklib/baklib-cli（baklib 命令）通过 Baklib Open API 管理站点、知识库、DAM、成员与用户，以及主题拉取/预览上传与本地 theme dev；含鉴权配置、--json 脚本输出与执行规范。在用户已安装或可安装 baklib CLI、要用命令行/脚本/CI 读写 Baklib 线上数据时使用；Liquid 模版语法见 baklib-theme-dev（需另行安装）。 |
baklib 是面向 Baklib Open API 的独立 CLI：在真实 shell 中查询与变更组织内的站点、知识库、资源库等数据，并支持主题文件拉取、预览上传与本地 theme dev。
读写 Baklib 线上数据一律优先使用本 CLI（或用户明确要求的 HTTP 脚本）；不要改用 MCP 或其它未配置的集成方式替代。
npm install -g @baklib/baklib-cli
baklib --version # 需 Node ≥ 20
开发源码：git clone → npm install && npm run build → npm link。
baklib skill install -g
baklib skill install --skill baklib-cli --skill baklib-theme-dev -g
与 npx skills add baklib-tools/skills --skill <id> 相同；可 npx skills add baklib-tools/skills --list 查看 id。
惰性读取：仅 --help / --version 不强制 Token；执行需鉴权的子命令前须已配置。
合并优先级（环境变量最后覆盖文件）：
~/.config/baklib/baklib.json（token、apiHost）.baklib/baklib.json~/.config/BAKLIB_TOKEN 等，见 baklib config --help）BAKLIB_TOKEN、BAKLIB_API_BASE（主机根，默认 https://open.baklib.com；CLI 固定请求 {apiHost}/api/v1）baklib config set-token "<token>"
baklib config set-api-base "https://open.baklib.com"
baklib config set-token "<token>" -g # 仅用户级
baklib config show
全局选项：--json（机器可读 JSON；默认人类可读摘要）、-B / --api-base <url>。
site_id、space_id、article_id、DAM id 等，再 create / update / delete / upload / push。--json；theme pull 等需确认时加 --yes（非 TTY 脚本常用）。template_variables 可用 --vars-file 传入 JSON。baklib config show 与 Token 是否过期；勿编造 API 响应。完整子命令与选项以 baklib <域> --help 为准；详见 references/commands.md。
| 域 | 用途 | 典型入口 |
|---|---|---|
config | 本地凭据 | config show / set-token / reset |
site | 站点、页面、标签 | site list → site pages list --site-id → pages pull / update |
kb | 知识库空间与文章 | kb spaces → kb articles → kb pull / kb push |
dam | 资源上传与片段/链接 | dam upload / dam list / fragment-create |
theme | 平台模板与本地开发 | theme list / pull / dev / push / preview |
member / user | 组织成员与账户 | member list / user me |
skill | 安装 AI 技能 | skill install --skill <id>（可重复；默认 baklib-cli） |
baklib --json kb spaces
baklib --json kb articles --space-id <SPACE_ID>
baklib kb pull --space-id <SID> --article-id <AID> --out ./article.md
baklib --json site list
baklib site pages pull --site-id <SID> --page-id <PID> --out ./page.json
# 编辑 JSON 后
baklib site pages update --site-id <SID> --page-id <PID> --file ./page.json
baklib dam upload --file-path ./logo.png
baklib --json dam list
baklib theme pull cms/guide --out ./cms--guide --yes
cd ./cms--guide && baklib theme dev
baklib theme preview set --path / --template index --vars '{"title":"demo"}'
baklib theme preview url --path /
Liquid/schema 规则见 baklib-theme-dev（baklib skill install --skill baklib-theme-dev）。
--json / 环境变量要点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.
指导使用 Baklib 开源导入工具（路径清单 → Excel → Open API）将本机、NAS 或挂载盘上的文件按目录层级迁入 Baklib 资源库（DAM），并可选择同步创建 CMS 站点资源页。在用户提到批量导入、本地文件进 Baklib、DAM 迁移、importer、 Excel 导入、路径清单预处理时使用。