ChatServe

ChatServe 命令行包。

快速开始

pip install chatserve
chatserve --version
chatserve --tree
chatserve --tree-brief
chatserve hello ChatArch

开发检验：

pip install -e ".[dev,docs]"
python -m pytest -q
python -m build
mkdocs build --strict

CLI 树

ChatServe 使用 chatstyle.add_tree_option() 从真实注册的 Click 命令生成完整和简明视图：

chatserve
├── --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.
└── hello [NAME] [--interactive]  # Print a greeting; text output only, with no persistent side effects.

--tree-brief 保留相同节点和说明，但省略 hello 的参数签名。完整的两个视图见命令树文档。

CLI 规范

• 公共根命令固定为 chatserve，并暴露 --version、--tree 和 --tree-brief。
• Click 命令树由 chatstyle>=0.2.0,<0.3.0 的注册表渲染器生成，不维护包内树渲染器。
• hello 使用 CommandSchema、add_interactive_option() 与 resolve_command_inputs()；-I 可禁用缺参提示。
• 问候语生成逻辑可通过 chatserve.operations.format_greeting() 直接复用。

目录结构

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