baklib CLI 把站点管理、知识库操作、DAM 资产和主题开发封装成可审计的命令行流程。
让 AI Agent 和开发者从查询到发布，不需要离开终端。
适合在 Codex、Cursor、Claude Code 等 AI Agent 工具中使用。全局安装后即可在终端直接调用。
npm install -g @baklib/baklib-cli四大操作域、一套命令行接口。AI Agent 和开发者可以直接完成从查询到发布的完整流程。
命令输出面向 Agent 解析，--json 结构化返回，无需人类阅读优化，每步可审计可回放。
拉取主题模板、本地 Vite 热更新预览、修改后推送上线，完整主题 round-trip 一条命令链完成。
DAM 文件上传、知识片段创建、链接资源管理、内容集合操作，全部素材管理一行命令完成。
空间列表、文章拉取为 Markdown、本地编辑后推送更新。命令行完成知识库内容的完整编辑闭环。
只要宿主可以调用本地 CLI 或安装 Skills，就能把 Baklib 管理流程接入自动化工作流。
七大命令域、一套 CLI。覆盖从站点配置到主题开发的全部 Baklib 管理操作。
凭据与配置管理。Token 设置、API 主机配置、多级配置合并（用户级 → 项目级 → 环境变量）。
站点与页面管理。站点列表、页面 CRUD、JSON round-trip、标签管理，全面覆盖站点操作。
知识库操作。空间列表、文章 CRUD、Markdown 拉取推送、YAML frontmatter 双向同步。
素材与资源中心。文件上传、知识片段创建、链接管理、集合与限额查询，命令行搞定全部资产管理。
主题全生命周期。模板拉取、本地 Vite 预览、热更新、预览缓存推送，完整的主题开发 CLUI。
组织与账户管理。成员列表与详情查询、当前用户信息、用户列表，团队管理不离开终端。
AI 技能管理。一键安装 Agent 技能，让 Cursor、Claude Code 等工具理解 Baklib 操作流程。
Agent 不猜测字段，也不绕过流程。管理 Baklib 资源按固定顺序完成查询、拉取、编辑、推送和上线。
npm install -g @baklib/baklib-cli
baklib config set-token "<token>"
baklib --json site list
baklib kb pull --space-id <SID> --article-id <AID> --out ./article.md
本地编辑 JSON / Markdown 内容
baklib kb push --file ./article.md
baklib theme pull && cd theme && baklib theme dev
在 Cursor、Claude Code 等 Agent 工具中，加载 baklib 技能后只需一句话指令——Agent 自动执行查询、拉取、编辑到推送的全部步骤。
「把帮助中心首页的文章列表更新，新写一篇接入指南，推送到线上」 —— 一句话，Agent 开始执行
查询
STEP 1
列出组织下所有站点，确定要操作的目标站点 ID。Agent 读取返回的 JSON，自动提取 site_id。
拉取
STEP 2
baklib kb spaces → 获取空间列表
baklib kb articles --space-id <SID>
baklib kb pull --space-id <SID> --article-id <AID> --out ./article.md
文章导出为 Markdown + YAML frontmatter。
编辑
STEP 3
在本地编辑 Markdown 内容。frontmatter 中的 space_id / article_id 供推送时定位目标。
推送
STEP 4
baklib kb push --file ./article.md
CLI 解析 frontmatter 中的目标信息，自动创建或更新文章。
上线
STEP 5
baklib theme preview set --path / --template index --vars '{"title":"demo"}'
baklib theme preview url --path /
预览确认 → 关闭 dev 后正式生效。
整个过程由 AI Agent 自动执行，不人工介入。
CLI 的 --json 结构化输出让 Agent 可以自主读取结果、判断步骤切换、处理错误重试。
baklib CLI — 所有命令面向 AI Agent 和人类双模式设计，--json 输出可被脚本和 Agent 直接解析。
baklib config set-token
设置 API Token（用户级或项目级）
baklib config show
查看当前配置路径与 Token 状态
baklib config set-api-base
配置 API 主机地址
baklib config reset
清除凭据字段
baklib site list
列出组织下所有站点
baklib site pages pull
导出页面 JSON（含 template_variables）
baklib site pages update
更新页面（支持 --vars-file）
baklib site tags list
管理站点标签
baklib kb spaces
列出所有知识库空间
baklib kb articles
列出空间下所有文章
baklib kb pull
导出 Markdown + YAML frontmatter
baklib kb push
从 Markdown 创建或更新文章
baklib dam upload
上传文件到 DAM
baklib dam list
列出资源列表
baklib dam fragment-create
创建知识片段
baklib dam link-create
创建链接资源
baklib theme pull
下载主题文件到本地
baklib theme dev
启动本地 Vite 预览面板
baklib theme preview set
设置预览模板与路径变量
baklib theme push
上传到预览缓存
baklib member list
列出组织成员
baklib user me
查看当前用户信息
baklib skill install
安装 Agent 技能
baklib --help
查看所有命令和参数
baklib <域> --help
查看具体命令域的帮助说明
baklib --json <cmd>
输出结构化 JSON（面向脚本/Agent）
AI Agent 操作 baklib CLI 时必须遵守的规则，确保数据安全和内容一致性。
list 确认 ID，再 create/update
--json + --yes，避免 Agent 卡在交互确认
baklib config show 与 Token 是否过期
--help，不猜不编
# 安装
npm install -g @baklib/baklib-cli
# 配置 Token
baklib config set-token your-api-token
# 列出站点
baklib --json site list
# 拉取知识库文章
baklib kb pull \
--space-id <SID> \
--article-id <AID> \
--out ./article.md
# 编辑后推送更新
baklib kb push --file ./article.md详细文档：baklib.com · GitHub
Baklib Open API 是 Baklib 平台的 HTTP 接口。CLI 是其命令行封装，Agent 和开发者可以通过 CLI 直接调用所有 Open API 功能，不需要手动构造 HTTP 请求。
--help 和 --version 不需要 Token。实际管理操作需要先在 Baklib 后台获取 API Token，执行 baklib config set-token <token> 配置。
用 baklib theme pull 下载 → 本地修改 → baklib theme dev 预览确认 → baklib theme push 上传预览缓存。确认效果后，在 Baklib 主题管理中将预览缓存发布为正式版本。
默认输出是格式化摘要，适合终端查看。--json 输出原始 JSON 结构，适合 jq 处理和 Agent 解析。脚本和非交互环境推荐加 --json。
使用项目级配置。在每个站点目录下创建 .baklib/baklib.json，CLI 自动从当前目录向上查找最近的配置文件，实现多站点上下文自动切换。
完全可以。baklib CLI 设计为人类和 Agent 共用一套接口。任何终端用户都可以直接执行 baklib site list 等命令，输出清晰可读。