06 · Reference

Blog CLI 0.5.0 命令参考

本页由构建后的 Commander 命令树快照渲染；网站构建会校验快照版本，防止教程与程序漂移。

命令、选项与参数

blog

Blog CLI for Tyndall

选项-V, --version · -v, --verbose子命令login · logout · whoami · doctor · config · post

blog login

登录博客管理账号（密码不会显示）

参数[username]

blog logout

注销并清除本地登录令牌

blog whoami

显示当前登录账号

选项--json

blog doctor

检查 CLI、配置和远端 API 连通性

blog config

读取和修改持久化 CLI 配置

子命令list · get · set · unset

blog config list

列出当前生效配置

选项--show-origin

blog config get

读取一项当前生效配置

参数<key>

blog config set

写入一项持久化配置

参数<key> <value>

blog config unset

删除一项持久化配置

参数<key>

blog post

创建、编辑、发布和管理文章

子命令

init · validate · create · list · show · pull · diff · edit · update · publish · unpublish · trash · restore · versions · rollback

blog post init

在本地创建文章模板，不访问网络

参数<file>选项-f, --force

blog post validate

校验 Markdown/frontmatter；默认同时验证远端分类和标签

参数<file>选项--local

blog post create

从已校验的本地 Markdown 文件创建远端草稿

参数<file>选项--dry-run

blog post list

列出文章

选项--status <status> · --lang <lang> · --keyword <keyword> · --page <number> · --page-size <number> · --json

blog post show

查看文章详情

参数<id>选项--json

blog post pull

把远端文章明确下载为本地 Markdown 文件

参数<id> <file>选项-f, --force

blog post diff

比较远端文章与本地 Markdown，不修改任何内容

参数<id> <file>

blog post edit

在本地编辑器中修改文章

参数<id>选项--note <note>

blog post update

用 Markdown 文件更新文章

参数<id> <file>选项--note <note> · --dry-run

blog post publish

发布文章

参数<id>选项-y, --yes · --dry-run

blog post unpublish

下线文章

参数<id>选项-y, --yes · --dry-run

blog post trash

移入回收站文章

参数<id>选项-y, --yes · --dry-run

blog post restore

恢复为草稿文章

参数<id>选项-y, --yes · --dry-run

blog post versions

查看文章版本历史

参数<id>选项--json

blog post rollback

回滚到指定文章版本（历史仍保留）

参数<id> <version-id>选项-y, --yes