ChatTea 0.1.1

ChatTea: ChatArch Python package

English | 简体中文

ChatTea

ChatTea 是 ChatArch 的 Gitea 管理 CLI/API 包，第一版聚焦本地 Gitea 的安装、初始化、启动、token 配置和基础仓库操作。

快速开始

pip install -e ".[dev]"
chattea --help
python -m pytest -q

常用流程

安装并初始化 Gitea

chattea server install --version 1.26.4 --prefix ~/.local/share/chattea/gitea
chattea server init --work-path ~/gitea --http-port 3000
chattea server serve --work-path ~/gitea --config ~/gitea/custom/conf/app.ini

使用 user systemd 管理服务

chattea server start --work-path ~/gitea --config ~/gitea/custom/conf/app.ini
chattea server status
chattea server logs --lines 100
chattea server stop

配置 API token

chattea set-token --url http://127.0.0.1:3000 --token "$GITEA_TOKEN"
chattea server health

仓库操作

chattea repo list
chattea repo view gitea_admin/demo
chattea repo create --owner gitea_admin --name demo
chattea repo clone gitea_admin/demo
chattea repo migrate --clone-url https://github.com/ChatArch/ChatTea.git --owner gitea_admin --name ChatTea

CLI 结构

chattea
├── set-token
├── server
│   ├── install
│   ├── init
│   ├── serve
│   ├── start
│   ├── stop
│   ├── restart
│   ├── status
│   ├── logs
│   ├── version
│   └── health
└── repo
    ├── list
    ├── view
    ├── create
    ├── clone
    └── migrate

目录结构

• 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。接口树见 docs/interface-tree.md。