ChatSync 文档

ChatSync 是 ChatArch 同步工具方向的 Python CLI 包壳。当前公开 CLI 只提供包信息与真实命令树；后续新增同步能力时，应先落到可复用 Python API，再扩展 CLI、文档和测试。

站点入口：https://arch.gh.wzhecnu.cn/ChatSync/

按场景选择文档

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

文档栏目组织

当前模板只保留长期有用的文档入口，不生成计划类占位页：

• CLI 树：最直观的命令展示入口，包含真实命令树、状态和更新清单。
• 能力地图：当前一等能力、边界和不负责的范围。
• 接口树：命令行背后的可 import Python 接口。

核心入口

• CLI 树

  从 chatsync --tree / chatsync --tree-brief 开始，记录已实现命令、命令状态和交互约定。

  查看 CLI 树

• 能力地图

  用于 review 当前包的能力边界，避免把规划写成已实现功能。

  查看能力地图

• Python 接口树

  保持命令行是薄入口，实质能力放在可 import 的 Python 接口中。

  查看接口树

快速开始

pip install ChatSync
chatsync --version
chatsync --tree
chatsync --tree-brief

文档状态约定

• 已实现：代码、测试或 CLI 路径已经存在。
• 已验证：已经通过本地 smoke、CI 或真实服务实践验证。
• 未实现：只写边界和计划，不写成可执行教程；实现并验证后再升级为操作文档。

本地预览

python -m pip install -e ".[docs]"
mkdocs serve

英文首页见站点语言入口：https://arch.gh.wzhecnu.cn/ChatSync/en/。缺少英文翻译的专题页会按 i18n fallback 回退到中文页面。