Blog CLI for Tyndall
用一款真实工具，学会命令行工具的共同语言
Blog CLI 把 Markdown 文件、明确的参数、退出码和文章状态机连接起来。它服务于 Tyndall 站点管理员，也是一条完整的 CLI 学习路径。
它解决什么问题
可视化后台适合浏览和偶尔编辑；命令行适合把文章纳入编辑器、文件系统、Git 和自动化脚本。Blog CLI 不隐藏这些边界：本地文件和远端文章是两个状态，读取、比较、校验和写入是不同操作。
| 能做 | 不能做 |
|---|---|
| 本地生成和校验 Markdown | 替代 Tyndall 服务端权限与审计 |
| 登录后管理草稿、版本和状态 | 让没有管理员账号的访客发布文章 |
| 输出表格或 JSON，进入管道 | 自动创建未知分类或标签 |
| 保留 tyndall-mcp AI 客户端入口 | 连接任意非 Tyndall 内容系统 |
像发现其他 CLI 一样开始
blog --version
blog --help
blog post --help0.5.0
Usage: blog [options] [command]
…--help 是命令树的入口。遇到陌生命令时，先逐级查看帮助，不需要先背参考手册。
从入门到自动化
- 安装：克隆源码，检查工作区，安装依赖，运行测试，构建并链接命令。
- 本地练习：用
post init和validate --local理解参数、选项与退出码。 - 首次远端操作：显式配置 API，诊断环境，登录，dry-run，创建草稿，再显式发布。
- 形成心智模型：区分 stdout/stderr、环境变量/配置文件、本地快照/revision、命令/副作用。
- 进入自动化：使用
--json、管道、--yes和 409 冲突处理。