英文版 | 简体中文

ChatCDN

ChatArch CDN tooling package.

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

按场景选择文档：

场景	文档
第一次安装、运行命令行、确认包可用	CLI 树
校对当前包有哪些一等能力和边界	能力地图
从 Python 代码调用包能力	接口树

快速开始

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

命令行规范

这个模板默认依赖 chatstyle>=0.1.1,<0.2.0 和 chatenv>=0.2.3,<0.3.0，新增命令应优先使用：

• CommandSchema / CommandField 描述输入。
• add_interactive_option() 提供统一 -i/-I。
• resolve_command_inputs() 统一缺参补问、默认值、TTY 与校验。
• 默认生成 config.py 和 chatenv.configs 入口点，使包可被 ChatEnv 发现；只有明确不需要 ChatEnv 接入时才使用 --without-chatenv-provider。

目录结构

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