ChatSage

ChatSage 是 ChatArch 的 Python CLI package scaffold。当前公开 CLI 保持最小的 root-only 命令面；只有真实 Sage 能力实现后才会注册业务子命令。

快速开始

pip install ChatSage
chatsage --help
chatsage --version
chatsage --tree
chatsage --tree-brief

当前 CLI 树

当前没有业务命令参数，因此完整树和简洁树相同：

chatsage
├── --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.

CLI 规范

• 根命令显式命名为 chatsage，并暴露 --version、--tree 和 --tree-brief。
• --tree / --tree-brief 由 chatstyle>=0.2.0,<0.3.0 从真实 Click 注册面生成，不维护包内 renderer。
• 模板遗留的 hello demo 命令已移除，不作为公开兼容面保留。
• 当前包没有 env/profile/config 行为，因此不依赖 ChatEnv；未来需要配置时，应注册 typed provider，并使用 ChatEnv 管理的存储路径。

目录结构

• src/：包源码
• tests/code-tests/：代码测试和历史测试迁移
• tests/cli-tests/：真实 CLI 测试，doc-first
• tests/mock-cli-tests/：mock/fake CLI 测试，doc-first
• docs/：长期维护文档，由 mkdocs 构建

开发说明

扩展脚手架前，先阅读 DEVELOP.md、AGENTS.md 和 CLI 树文档。