Wanoohe Blog
Blog CLIfor Tyndall · v0.5.0

03 · First remote workflow

从明确配置到显式发布

先建立远端边界,再登录、校验、dry-run、创建草稿、查看、编辑和发布。

配置站点并确认来源

设置兼容 Tyndall API
blog config set api-base https://your-tyndall.example/blog
blog config list --show-origin
blog doctor

配置只保存 API 基点,不保存账号密码或令牌。优先级为 BLOG_API_BASE > TYNDALL_API_BASE > 配置文件 > 未配置

登录并识别身份

交互式认证
blog login
blog whoami

密码输入会隐藏。访问令牌和刷新令牌写入用户配置目录;401 时客户端只自动刷新并重试一次,刷新失败会要求重新登录。

先预演,再创建草稿

验证分类标签并查看写入计划
blog post validate article.md
blog post create article.md --dry-run
blog post create article.md

远端校验把分类 slug 和标签名称解析为 ID。未知值只报错,不自动扩充站点数据。create 的服务端结果始终先是草稿。

查看、编辑、显式发布

文章生命周期
blog post list --status draft
blog post show 42
blog post edit 42 --note "完成首稿"
blog post publish 42

edit 会下载快照、打开编辑器,并带 revision 提交。发布前显示目标并确认;熟练后的自动化才能选择 --yes