Wanoohe Blog
Blog CLIfor Tyndall · v0.5.0

02 · Local quickstart

不登录、不联网,先理解命令结构

从帮助、诊断、本地模板和校验开始。未配置 API 不影响本地命令。

逐级发现命令

从根命令走到具体动作
blog --help
blog post --help
blog post validate --help

结构是 主命令 子命令 动作 参数 选项。这里 article.md 是位置参数,--local 是布尔选项。

让诊断失败一次

检查当前环境
blog doctor
Node.js:…
Git:…
API 地址:未配置
远端 API:跳过(尚未配置)
错误:尚未配置 API 地址…

doctor 会展示配置来源、Node、Git、编辑器、令牌和远端连通性。未配置 API 时返回非零退出码,这是可观察的状态,不是安装失败。

创建并校验本地文章

建立练习目录
mkdir my-first-post
cd my-first-post
blog post init article.md
blog post validate article.md --local

init 创建文件,默认不覆盖已有内容;validate --local 只解析 YAML frontmatter 与 Markdown,不读取远端分类和标签。