Metadata-Version: 2.4
Name: zcyclaw
Version: 0.1.0
Summary: 政府采购智能顾问 - 基于RAG的法规问答CLI工具
Project-URL: Homepage, https://github.com/brucehuu/zyclaw
Project-URL: Repository, https://github.com/brucehuu/zyclaw
Project-URL: Issues, https://github.com/brucehuu/zyclaw/issues
Author: zyclaw
License: MIT
License-File: LICENSE
Keywords: ai-agent,cli,government-procurement,rag
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Requires-Python: >=3.11
Requires-Dist: chromadb>=0.5
Requires-Dist: httpx>=0.27
Requires-Dist: loguru>=0.7
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic>=2.0
Requires-Dist: python-docx>=1.2.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.30; extra == 'anthropic'
Provides-Extra: crawler
Requires-Dist: playwright>=1.40; extra == 'crawler'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: fastembed
Requires-Dist: fastembed>=0.4; extra == 'fastembed'
Provides-Extra: full
Requires-Dist: anthropic>=0.30; extra == 'full'
Requires-Dist: fastembed>=0.4; extra == 'full'
Description-Content-Type: text/markdown

# zyclaw

政府采购智能顾问 — 基于 RAG 的法规问答 CLI 工具。

独立于采购平台，基于中国政府采购法律法规提供专业问答、采购方式推荐等功能。核心开源，数据本地存储，隐私第一。

## 功能

- **法规智能问答**：基于 16 部核心法规（766 条法条），回答自动标注法条来源
- **流式输出**：token-by-token 逐字显示，体验流畅
- **多 LLM 支持**：DeepSeek / 智谱 GLM / 通义千问 / Moonshot / OpenAI / Ollama / Anthropic
- **开箱即用**：预构建法规数据随包分发，安装即可使用
- **本地优先**：向量库、配置、日志全部本地存储，API Key 直连 LLM 厂商

## 快速开始

```bash
# 安装
uv tool install zyclaw

# 或使用 pip
pip install zcyclaw

# 初始化配置（选择 LLM 提供商 + 输入 API Key）
zcyclaw init

# 单次问答
zcyclaw ask "询价采购需要满足什么条件？"

# 交互式多轮问答
zcyclaw ask -i

# 更新法规数据
zcyclaw update

# 查看数据统计
zcyclaw stats
```

## 配置

配置文件位置：`~/.zcyclaw/config.json`

支持环境变量覆盖，前缀 `ZCYCLAW_`，双下划线分隔嵌套：

```bash
export ZCYCLAW_PROVIDERS__DEEPSEEK__API_KEY=sk-xxx
export ZCYCLAW_DEFAULT_PROVIDER=deepseek
```

## 可选安装

```bash
# Anthropic 后端支持
uv tool install "zcyclaw[anthropic]"

# 本地 Embedding（fastembed/BGE-M3）
uv tool install "zcyclaw[fastembed]"

# 完整安装
uv tool install "zcyclaw[full]"
```

## 内置法规

| 效力层级 | 法规 |
|----------|------|
| 法律 | 政府采购法、招标投标法 |
| 行政法规 | 政府采购法实施条例、招标投标法实施条例 |
| 部门规章 | 货物和服务招标投标管理办法、非招标采购方式管理办法、竞争性磋商采购方式管理暂行办法、框架协议采购方式管理暂行办法、促进中小企业发展管理办法、需求管理办法、信息公开办法、评审专家管理办法、进口产品管理办法、代理机构管理暂行办法、政府和社会资本合作项目政府采购管理办法、关于促进政府采购公平竞争优化营商环境的通知 |

## 技术栈

Python 3.11+ / Typer / Rich / Pydantic / ChromaDB / httpx / loguru

## 许可证

MIT License
