hile-ioredis
SKILL.md
@hile/ioredis SKILL
本文档规范 @hile/ioredis 的使用方式,确保 Redis 客户端生命周期由 Hile 统一管理。
1. 架构概览
@hile/ioredis 提供一个默认导出的 Hile 服务:
- 使用环境变量构建 ioredis 客户端
- 首次加载时建立连接并等待
connect - 进程退出时调用
client.disconnect()
依赖:@hile/core、ioredis。
2. 环境变量
| 变量 | 说明 |
|---|---|
REDIS_HOST |
Redis 主机 |
REDIS_PORT |
Redis 端口(字符串转数字) |
REDIS_USERNAME |
Redis 用户名 |
REDIS_PASSWORD |
Redis 密码 |
REDIS_DB |
Redis 数据库编号(默认 0) |
3. 标准模板
3.1 加载默认服务
import { loadService } from '@hile/core'
import ioredisService from '@hile/ioredis'
const redis = await loadService(ioredisService)
await redis.set('key', 'value')
const value = await redis.get('key')
4. 强制规则
- 统一通过
loadService(ioredisService)获取 Redis 客户端。 - 不要再额外封装一个同用途的全局 Redis 单例与本包混用。
- 生产环境应通过
REDIS_*变量配置,避免硬编码。 - 依赖 Redis 的服务应在服务函数内部加载,不在模块顶层缓存实例。
5. API 速查
| 导出 | 说明 |
|---|---|
| 默认导出 | Hile 服务化 Redis 客户端 |
Weekly Installs
17
Repository
cevio/hileFirst Seen
14 days ago
Security Audits
Installed on
opencode17
gemini-cli17
github-copilot17
codex17
kimi-cli17
amp17