03 · First remote workflow
从明确配置到显式发布
先建立远端边界,再登录、校验、dry-run、创建草稿、查看、编辑和发布。
配置站点并确认来源
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 42edit 会下载快照、打开编辑器,并带 revision 提交。发布前显示目标并确认;熟练后的自动化才能选择 --yes。