用途：通过命令行管理自己的 Substack 发布，并读取他人公开的通讯内容，适合自动化写作与发布流程。
主要能力：读取公开内容（feed scan、feed crawl、feed crawl-all，无需 cookie 与 profile）；管理文章（创建草稿、列出、更新、排期、取消排期、发布、修订已发布文章、删除草稿与排期文章）；管理版块（section list/add/remove/set）。
使用方式：先按需配置 profile，如 sub-cli profile add <name> <publication>、profile login、profile list。作者类命令（post、section）每次都要显式传 --profile <name>，不要依赖默认 profile。机器可读输出用 --json，只解析 stdout，进度与错误在 stderr。
执行原则：命令直接执行，退出码判断结果——0 成功；1 一般失败；2 用法错误（按提示修正参数，不要原样重试）；3 认证过期（需人工执行 profile login）；4 被限流（等待数分钟后重试）。不要每次命令前都做 profile check。profile list 每个会话运行一次即可并缓存。Cookie 通常一到两周过期。--no-retry 可关闭内置重试。
须人工确认：发布（post publish）不可撤回且可能给订阅者发邮件；修订已发布文章会立即改变读者所见；删除已发布文章影响所有订阅者；增删版块改动发布结构且 section remove 不可撤销；排期会按时间发送邮件。修订前应展示 --dry-run 预览并征得同意，恢复用备份路径执行 post revise <id> <backup> --profile p --yes。
限制：修订受“pending changes”或 URL 变更限制，遇到拒绝退出码为 1 且不修改内容；--change-url 会使旧 URL 停止更新，须先征询。修订可能不生效部分字段，需报告。封面只能是托管 http(s) URL；正文图片用本地路径，发布命令会上传并改写为托管 URL，文件缺失会中止。爬取文件带有额外 front matter 键，post create 会警告并忽略。安装方式为手工安装技能，不锁定包版本；命令报未知参数说明 CLI 版本较旧，应按实际打印的用法回退。作者本地 npm 更新可用 sub-cli update。具体价格与平台支持暂未提供。