Metadata-Version: 2.4
Name: tianlong-toolkit
Version: 1.0.0
Summary: 天龙工具箱 — Agent健康监控、安全约束与进化评估
Author: 天龙1号
License: MIT
Project-URL: Homepage, https://github.com/
Keywords: agent,monitoring,safety,ai-agent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# Tianlong Toolkit (天龙工具箱)

> AI Agent health monitoring, safety constraints, evolution evaluation, security audit.
> AI Agent 健康监控、安全约束、进化评估、安全审计 — 全部免费开源。

**Version: v1.0.0** · 459 tests · Pure stdlib · MIT License

```bash
pip install tianlong-toolkit
```

---

## Quick Start / 快速开始

### One-Command Audit / 一键全量审计
```bash
tianlong-audit -d . > audit-report.html
tianlong-audit -d . --output json
```

### Health Check / 健康检查
```bash
tianlong-monitor
tianlong-monitor -o html > report.html
```

### Security Audit / 安全审计
```bash
tianlong-uxu scan .
tianlong-uxu scan --severity critical
tianlong-uxu rules
```

### Safety Guard / 安全约束
```bash
tianlong-safety check -a delete -t config.yaml
tianlong-safety rules
```

### Evolution Judge / 进化评估
```bash
tianlong-judge evaluate --proposal "优化搜索流程"
tianlong-judge history
tianlong-judge metrics
```

### Agent Runner / Agent 执行
```bash
agent-run research --topic "AI Agent 安全"
agent-run code --file /path/to/code.py
agent-run exec --task "批量处理"
agent-run monitor
```

---

## CI/CD Integration / CI/CD 集成

```yaml
# .github/workflows/tianlong-audit.yml
steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-python@v5
    with: { python-version: '3.12' }
  - run: pip install tianlong-toolkit
  - run: tianlong-audit -d . > audit.html
```

## Project Config / 项目配置

```yaml
# .uxurc.yaml
version: "1"
project:
  name: "my-agent"
rules:
  enabled: true
paths:
  exclude:
    - "node_modules/**"
    - ".venv/**"
```

## Modules / 模块

| Module | Function / 功能 | CLI |
|--------|-----------------|-----|
| **monitor** | Health Check / 健康检查 | `tianlong-monitor` |
| **safety** | Safety Guard / 安全约束 | `tianlong-safety` |
| **judge** | Evolution Judge / 进化评估 | `tianlong-judge` |
| **uxu** | Security Audit / 安全审计 (30 rules) | `tianlong-uxu` |
| **dashboard** | Global Dashboard / 全局仪表盘 | `tianlong-dashboard` |
| **audit** | Full Audit / 全量审计 | `tianlong-audit` |
| **evolution** | SelfLearning / 进化闭环 | SDK |
| **brain** | Decision Engine / 决策引擎 | `tianlong-brain` |
| **reporter** | Reporting / 主动汇报 | `tianlong-reporter` |
| **researchengine** | Research Engine / 调研引擎 | `agent-run research` |
| **executor** | Execution Layer / 执行层 | `agent-run exec` |
| **agents** | Sub-Agent SDK | `agent-run` |
| **metacog** | MetaCognition / 元认知 | SDK |
| **onlinestate** | Online State / 在线状态 | SDK |

## License / 许可

MIT — 100% free and open source. No API keys, no license files.
完全免费开源，无需任何授权或 API Key。
