Metadata-Version: 2.4
Name: passshore-agent
Version: 0.1.2
Summary: PassShore Agent — AI 代码质量本地守门人 / local AI code quality gatekeeper
Author: PassShore Team
License: MIT
Project-URL: Homepage, https://passshore.com
Project-URL: Source, https://github.com/passshore/passshore-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Security
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: passshore-engine>=0.1.0
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn[standard]>=0.29
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13.0
Requires-Dist: pydantic>=2.0
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Dynamic: requires-python

<!--
  PassShore Agent — 中英双语 README
  发布到 PyPI 时作为包描述。
-->

# PassShore Agent

> **中文**：AI 代码质量的本地守门人。装完即用，一键扫描，自动生成看板。  
> **English**: Local AI code quality gatekeeper. Install and run — one command to scan, auto-generated dashboard.

---

## 📖 中文说明

### 一句话

PassShore Agent 是跑在你本地机器上的 AI 代码质量检测服务。它用 **167 条行业标准**（OWASP、等保、DSMM、CIS…）检查你的代码，自动评分、自动生成看板、自动阻止低质量代码合并。

### 安装

```bash
pip install passshore-agent
```

### 快速开始

```bash
# 启动看板（浏览器打开 http://localhost:9100/dashboard）
passshore-agent

# 扫描当前目录
passshore check .

# 质量门禁检查（CI 用）
passshore ci . --threshold 0.5
```

### 核心功能

| 功能 | 说明 |
|------|------|
| **14 类检查器** | 安全、架构、API、数据、权限、性能、合规… |
| **7 个深度扫描器** | 依赖漏洞、BOLA/BFLA、OpenAPI、GraphQL、Secrets |
| **自适应质量门禁** | 按项目成熟度自动调整阈值 |
| **Web 看板** | 实时质量仪表盘、趋势图、徽章 |
| **MCP 协议** | 对接 Hermes/OpenCode 等 AI 编程工具 |

### 许可证

MIT

---

## 📖 English

### One-liner

PassShore Agent is a local AI code quality inspection service. It checks your code against **167 industry standards** (OWASP, DSMM, CIS, etc.), auto-scores, auto-generates dashboards, and blocks low-quality merges.

### Install

```bash
pip install passshore-agent
```

### Quick Start

```bash
# Start dashboard (open http://localhost:9100/dashboard in browser)
passshore-agent

# Scan current directory
passshore check .

# Quality gate check (CI use)
passshore ci . --threshold 0.5
```

### Features

| Feature | Description |
|---------|-------------|
| **14 Checkers** | Security, architecture, API, data, permission, performance, compliance… |
| **7 Deep Scanners** | Dependency vulns, BOLA/BFLA, OpenAPI, GraphQL, Secrets |
| **Adaptive Quality Gate** | Auto-tunes thresholds by project maturity |
| **Web Dashboard** | Real-time quality dashboard, trends, badges |
| **MCP Protocol** | Integrates with Hermes/OpenCode AI coding tools |

### License

MIT
