ChatZulip

ChatZulip 是 ChatArch 的 Zulip 集成包，提供 ChatEnv-backed Zulip 配置、Zulip REST client、read-oriented CLI、Markdown news digest 和 MCP adapter。

快速开始

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

# 先用 ChatEnv 配置 Zulip 凭据，再使用 CLI。
chatenv test -t zulip -I
chatzulip streams
chatzulip topics --stream general
chatzulip search-topics conjecture --all-streams
chatzulip search comparator --stream lean4 --since-hours 168
chatzulip messages --stream general --before 5
chatzulip news --stream general --since-hours 24 --output zulip-news.md

完整包边界、CLI/API 约定和发布顺序见文档页：ChatZulip 规范。

CLI 规范

这个包依赖 chatstyle>=0.2.0,<0.3.0、chatenv>=0.2.10,<0.3.0 和 httpx>=0.28.1,<1.0，新的命令应优先使用：

• CommandSchema / CommandField 描述输入。
• add_interactive_option() 提供统一 -i/-I。
• add_tree_option() 从真实 Click registry 提供 --tree / --tree-brief。
• resolve_command_inputs() 统一缺参补问、默认值、TTY 与校验。
• config.py 和 chatenv.configs entry point 使 zulip provider 可被 ChatEnv 发现；配置统一存入 ~/.chatarch/envs/Zulip/（或 $CHATARCH_HOME/envs/Zulip/）。

目录结构

• src/：包源码
• tests/code-tests/：client、operations、config 等代码测试
• tests/cli-tests/：真实服务/人工运行的 doc-first CLI 用例
• tests/mock-cli-tests/：fake client / mock CLI 自动化测试
• tests/test_version.py：模板级版本 smoke
• docs/：长期维护文档，由 mkdocs 构建

开发说明

扩展脚手架前，先阅读 DEVELOP.md 和 AGENTS.md。