Metadata-Version: 2.4
Name: ChatLabel
Version: 0.1.0
Summary: ChatLabel: structured annotation tasks with auditable workbook workflows
Author-email: ChatArch <1073853456@qq.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/ChatArch/ChatLabel
Project-URL: Repository, https://github.com/ChatArch/ChatLabel
Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatLabel/
Keywords: chatlabel,chatarch,cli
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click<9.0,>=8.0
Requires-Dist: chatstyle<0.3.0,>=0.2.0
Requires-Dist: chatenv<0.3.0,>=0.2.10
Requires-Dist: fastapi<1.0,>=0.110
Requires-Dist: httpx<1.0,>=0.26
Requires-Dist: openpyxl<4.0,>=3.1
Requires-Dist: python-multipart<1.0,>=0.0.9
Requires-Dist: uvicorn<1.0,>=0.27
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: pytest<10,>=8; extra == "dev"
Requires-Dist: twine; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
Requires-Dist: mkdocs-material<10.0,>=9.5; extra == "docs"
Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
Requires-Dist: mike<3.0,>=2.0; extra == "docs"
Dynamic: license-file

<div align="center">
    <a href="https://pypi.python.org/pypi/ChatLabel"><img src="https://img.shields.io/pypi/v/ChatLabel.svg" alt="PyPI 版本" /></a>
    <a href="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml"><img src="https://github.com/ChatArch/ChatLabel/actions/workflows/ci.yml/badge.svg" alt="测试状态" /></a>
    <a href="https://arch.gh.wzhecnu.cn/ChatLabel/"><img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="项目文档" /></a>
</div>

<div align="center">

[英文版](README.en.md) | [简体中文](README.md)
</div>

# ChatLabel

ChatLabel 是一个可审计的标注任务运行器。首个任务配置用于将印尼线路产品工作簿生成分类建议：上传 `.xlsx`、后台处理、查看进度、检查 WPS 单元格图片部件，并下载写入分类和备注的新工作簿。

> 自动输出是建议结果。完成图片逐项复核、高风险审计和一致性校验前，不应作为最终业务分类。

文档入口：<https://arch.gh.wzhecnu.cn/ChatLabel/>

## 安装与运行

```bash
pip install ChatLabel
chatlabel --version
chatlabel --tree
chatlabel serve
```

默认页面：<http://127.0.0.1:8765/>

## 配置

ChatLabel 从 ChatEnv 读取名为 `apple` 的既有 OpenAI profile，也可通过环境变量调整：

| 变量 | 默认值 | 作用 |
| --- | --- | --- |
| `CHATLABEL_DATA_DIR` | `.chatlabel-data` | 上传文件与任务状态目录 |
| `CHATLABEL_CLASSIFIER` | `rules` | `rules` 或 `openai-responses` |
| `CHATLABEL_OPENAI_PROFILE` | `apple` | 要读取的 OpenAI profile |

进程级 `OPENAI_*` 会覆盖 profile 值。网页配置接口只显示模型、API 地址和“是否有凭据”，不会返回凭据内容。

## 开发验证

```bash
python -m pip install -e ".[dev,docs]"
python -m pytest -q
chatlabel --help
chatlabel --tree
python -m build
mkdocs build --strict
```

进一步查看：[CLI 树](docs/cli-tree.md)、[能力地图](docs/capability-map.md)、[Python 接口树](docs/interface-tree.md)。
