CLI 树¶
ChatSync 当前是 root-only CLI,并使用共享的 chatstyle.add_tree_option() 从真实注册的 Click command surface 生成命令树:
chatsync --tree显示参数签名,适合接口审查。chatsync --tree-brief保留同一组节点和说明,但省略参数签名。
当前没有业务命令参数,因此完整和简洁视图相同。这个页面不能手写未来命令。
完整命令树¶
chatsync
├── --help # Show this message and exit.
├── --version # Show the version and exit.
├── --tree # Print the registered CLI tree and exit.
└── --tree-brief # Print the registered CLI tree without parameter signatures and exit.
简洁命令树¶
chatsync
├── --help # Show this message and exit.
├── --version # Show the version and exit.
├── --tree # Print the registered CLI tree and exit.
└── --tree-brief # Print the registered CLI tree without parameter signatures and exit.
状态契约¶
chatsync --help必须暴露--tree和--tree-brief。chatsync --tree必须 exit 0,并显示带参数签名的真实注册面。chatsync --tree-brief必须 exit 0,并显示省略参数签名的同一注册面。chatsync hello必须失败;hello不是业务命令。- 当前入口不会同步目录、写入远端状态或打印
CHATSYNC_API_KEY。 - 新增同步能力时,先增加可复用 Python API,再新增 CLI command,并同步完整/简洁树。