chatclash 0.1.0

ChatArch proxy toolkit for Clash, subconverter, and proxy service operations.

English | 简体中文

chatclash

ChatArch proxy toolkit for Clash, subconverter, and proxy service operations.

快速开始

pip install -e ".[dev]"
chatclash setup clash /tmp/clash --dry-run
chatclash setup clash /tmp/clash -y
chatclash status /tmp/clash
chatclash proxy env
python -m pytest -q

订阅转换依赖外部 subconverter 服务：

chatenv use -t chatclash sub-main
chatclash sub status
chatclash sub url
chatclash sub generate -o /tmp/clash/config.yaml --dry-run
chatclash sub generate -o /tmp/clash/config.yaml -y

CLI 规范

项目依赖 chatstyle>=0.1.0 和 chatenv>=0.1.1，命令输入优先使用：

• CommandSchema / CommandField 描述输入。
• add_interactive_option() 提供统一 -i/-I。
• resolve_command_inputs() 统一缺参补问、默认值、TTY 与校验。

目录结构

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