ChatMail

ChatArch mail tooling package.

文档入口：https://arch.gh.wzhecnu.cn/ChatMail/

按场景选择文档：

快速开始

pip install -e ".[dev]"
chatmail --help
chatmail --version
chatmail --tree
chatmail --tree-brief
python -m pytest -q
python -m build

当前 CLI 树

ChatMail 使用共享的 chatstyle.add_tree_option() 从真实注册的 Click command surface 生成完整和简洁命令树。当前 CLI 是 root-only，因此两个视图的节点相同。

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

命令行规范

ChatMail 当前保留 root-only CLI 和 ChatEnv typed 配置发现入口。CLI 固定使用 chatstyle>=0.2.0,<0.3.0，配置入口使用 chatenv>=0.2.10,<0.3.0 与 ChatEnv 管理的存储路径。新增交互式命令时，应使用 ChatStyle 的 CommandSchema / CommandField、add_interactive_option() 与 resolve_command_inputs()；没有真实交互命令前，不暴露 scaffold/demo 子命令。

目录结构

• 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。