清醒技能
AI原生数据分析技能。 连接Excel、CSV、MySQL、PostgreSQL——理解业务语义，用SQL查询。
不需要API密钥。里面没有LLM——AI代理是大脑；清醒的技能是双手。
______________________________________________________________________
特性
- 多源：Excel（.xlsx/.xls）、CSV、MySQL、PostgreSQL——所有这些都统一到SQL中
- 语义层：定义表和列的业务含义；作为YAML持久化，Git友好
- 加入探索：自动查找表之间的连接路径（直接+间接）
- 域群集：自动将表分组到业务域中
- 嵌入搜索：用于查找表的可选多语言矢量搜索
- 只读安全：只允许SELECT--在引擎级别阻止了SQL的变异
______________________________________________________________________
安装
pip install lucid-skill
# Or with uv (recommended for OpenClaw)
uv tool install lucid-skill
# Optional: database drivers
pip install "lucid-skill[db]" # MySQL + PostgreSQL
# Optional: embedding search
pip install "lucid-skill[embedding]" # sentence-transformers______________________________________________________________________
快速开始
# Connect a data source
lucid-skill connect csv /path/to/sales.csv
# Explore schema and semantics
lucid-skill init-semantic
# Search tables by business meaning
lucid-skill search "销售额 客户"
# Query with SQL
lucid-skill query "SELECT product, SUM(amount) FROM sales GROUP BY product ORDER BY 2 DESC LIMIT 10"______________________________________________________________________
建筑
Agent ──→ lucid-skill CLI ──→ Connectors (Excel/CSV/MySQL/PG)
│ │
├── Catalog (DuckDB) └── DuckDB (in-memory query engine)
└── Semantic Store (YAML)- 里面没有法学硕士 --清晰的技能提供数据访问；AI代理处理推理
- DuckDB统一 --目录存储+查询引擎，单依赖，无需编译
- 语义持久性 --YAML定义在重启后仍然有效，可以通过Git共享
______________________________________________________________________
支持的数据源
| 类型 | 格式 | 注释 |
|---|---|---|
| Excel | .xlsx, .xls | 支持多张图纸 |
| CSV | .csv | 自动检测编码和分隔符 |
| MySQL | 5.7+/8.0+ | 读取外键和列注释(pip install lucid-skill[db]) |
| PostgreSQL | 12+ | 读取外键和列注释(pip install lucid-skill[db]) |
______________________________________________________________________
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
LUCID_DATA_DIR | ~/.lucid-skill/ | 数据目录（目录、语义存储、模型） |
LUCID_EMBEDDING_ENABLED | false | 启用矢量搜索（首次使用时下载约460 MB模型） |
______________________________________________________________________
安全
- 只读：只有
SELECT/WITH允许发表声明；所有变异的SQL都被阻止 - 未存储凭据：数据库密码永远不会写入磁盘
- 仅限本地：所有数据都保留在您的机器上
______________________________________________________________________
MCP服务器模式
清醒技能也可以作为支持它的平台的MCP服务器：
lucid-skill serve______________________________________________________________________
发展
git clone https://github.com/WiseriaAI/lucid-skill
cd lucid-skill
pip install -e ".[dev]"
pytest许可证
麻省理工学院