Semantic-Infrastructure-Lab/reveal
GitHub: Semantic-Infrastructure-Lab/reveal
渐进式文件披露 CLI 工具,为 AI Agent 提供代码库、数据库和基础设施的结构化、token 高效的检查能力。
Stars: 3 | Forks: 1
# Reveal
**针对代码库、数据库和基础设施的渐进式披露。**
Reveal 是一个命令行工具,提供结构化且高效利用 token 的检查功能,涵盖:
- **代码**:AST 查询、导入、结构分析
- **数据库**:MySQL、PostgreSQL 健康监控
- **基础设施**:SSL 证书、域名、Git 仓库
- **数据**:JSON, CSV, YAML, XML 分析
## 安装
```
pip install reveal-cli
```
## 快速入门
```
# 检查代码结构
reveal file.py
# Database 健康检查
reveal mysql://localhost
# SSL 证书检查
reveal ssl://example.com
# AST 查询
reveal 'ast://src?complexity>30'
```
## 文档
- **快速入门**:`reveal help://quick-start`
- **完整指南**:`reveal help://`
- **Agent 帮助**:`reveal --agent-help`
## 子命令
```
reveal check src/ # Quality check (complexity, maintainability, links)
reveal review main..feature # PR review: diff + check + hotspots in one pass
reveal health ssl://site.com # Health check with exit codes 0/1/2
reveal pack src/ --budget 8k # Token-budgeted snapshot for LLM context
reveal dev new-adapter # Scaffold new adapters/rules
```
## 功能特性
- 🎯 **渐进式披露**:结构 → 元素 → 详情
- 🔍 **统一查询语法**:跨所有适配器进行过滤和排序
- 🤖 **AI 优化**:面向 LLM 的高效 token 输出
- 📊 **质量指标**:复杂度、可维护性、测试覆盖率
- 🔌 **可扩展**:19 个内置适配器,支持 42+ 种语言,易于添加自定义适配器
## 许可证
详见 [LICENSE](LICENSE)。
## 贡献指南
详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
标签:Homebrew安装, LLM上下文优化, Python, RAG辅助, SSL证书检测, Token效率, 云安全监控, 代码分析, 凭证管理, 基础设施检查, 开源, 插件架构, 数据库监控, 文档结构分析, 无后门, 测试用例, 渐进式披露, 网络安全研究, 网络调试, 自动化, 自动化payload嵌入, 逆向工具, 静态分析