@hile/ioredis 1.0.7 → 1.0.9

package/README.md

@@ -1,6 +1,6 @@
 # @hile/ioredis
 
-基于 `@hile/core` 的 Redis 集成：将 ioredis 客户端封装为 Hile 服务（单例、随进程退出断开连接）。
+基于 `@hile/core` 的 Redis 集成：将 ioredis 客户端封装为 Hile 服务（单例、可优雅断连）。
 
 ## 安装
 
@@ -8,12 +8,10 @@
 pnpm add @hile/ioredis
 ```
 
-依赖 `@hile/core` 与 `ioredis`，请一并安装。
+同时安装依赖：`@hile/core`、`ioredis`。
 
 ## 快速开始
 
-通过环境变量配置 Redis，用 `loadService` 获取客户端：
-
 ```typescript
 import { loadService } from '@hile/core'
 import ioredisService from '@hile/ioredis'
@@ -24,21 +22,24 @@ const redis = await loadService(ioredisService)
 
 ## 环境变量
 
-客户端从以下环境变量读取配置：
+默认客户端从以下环境变量读取配置：
 
 | 变量 | 说明 |
 |------|------|
 | `REDIS_HOST` | Redis 主机 |
-| `REDIS_PORT` | Redis 端口（字符串会被转为数字） |
+| `REDIS_PORT` | Redis 端口（字符串会转为数字） |
 | `REDIS_USERNAME` | Redis 用户名 |
 | `REDIS_PASSWORD` | Redis 密码 |
 | `REDIS_DB` | Redis 数据库编号，默认 `0` |
 
-行为：服务在首次加载时创建连接并等待 `connect` 事件；进程退出时通过 Hile 的 shutdown 调用 `client.disconnect()`。
+行为说明：
+
+- 服务首次加载时创建连接并等待 `connect` 事件
+- 进程退出时通过 Hile 的 shutdown 调用 `client.disconnect()`
 
 ## 与 @hile/cli 一起使用
 
-若使用 `@hile/cli` 启动应用，可在项目根 `package.json` 中配置自动加载本包默认服务：
+可在 `package.json` 配置自动加载：
 
 ```json
 {
@@ -48,15 +49,15 @@ const redis = await loadService(ioredisService)
 }
 ```
 
-之后在业务中直接 `loadService(ioredisService)` 即可，Redis 客户端会在应用启动时连接、退出时断开。
+这样应用启动时会自动建立 Redis 连接，退出时自动断开。
 
 ## 开发
 
 ```bash
 pnpm install
-pnpm build    # 编译
-pnpm dev      # 监听模式
-pnpm test     # 测试
+pnpm build
+pnpm dev
+pnpm test
 ```
 
 ## License

package/SKILL.md

@@ -1,48 +1,35 @@
 ---
 name: hile-ioredis
-description: Code generation and usage rules for @hile/ioredis. Use when editing this package or when the user asks about @hile/ioredis, Redis as Hile service, or loadService(ioredisService) patterns.
+description: @hile/ioredis 的代码生成与使用规范。适用于 Redis 服务加载、环境变量配置、及与 @hile/core/@hile/cli 集成场景。
 ---
 
-# @hile/ioredis
+# @hile/ioredis SKILL
 
-本文档是面向 AI 编码模型和人类开发者的 **代码生成规范**，阅读后应能正确地使用本库编写符合架构规则的代码。
+本文档规范 `@hile/ioredis` 的使用方式，确保 Redis 客户端生命周期由 Hile 统一管理。
 
----
-
-## 1. 架构总览
-
-`@hile/ioredis` 在 `@hile/core` 之上提供：
+## 1. 架构概览
 
-- **默认导出**：一个通过 `defineService` 定义的 **ioredis Redis 客户端** 服务，配置来自环境变量；创建后等待 `connect` 事件再 resolve，进程退出时通过 `shutdown` 注册 `client.disconnect()`。
+`@hile/ioredis` 提供一个默认导出的 Hile 服务：
 
-依赖：`@hile/core`、`ioredis`。生成代码时必须遵循 Hile 的服务定义与加载规则，通过 `loadService` 获取 Redis 实例并使用 ioredis 的标准 API。
+- 使用环境变量构建 ioredis 客户端
+- 首次加载时建立连接并等待 `connect`
+- 进程退出时调用 `client.disconnect()`
 
----
-
-## 2. 类型与环境变量
+依赖：`@hile/core`、`ioredis`。
 
-### 2.1 环境变量（默认服务）
+## 2. 环境变量
 
 | 变量 | 说明 |
-|------|------|
+|---|---|
 | `REDIS_HOST` | Redis 主机 |
-| `REDIS_PORT` | Redis 端口（字符串会被转为数字） |
+| `REDIS_PORT` | Redis 端口（字符串转数字） |
 | `REDIS_USERNAME` | Redis 用户名 |
 | `REDIS_PASSWORD` | Redis 密码 |
-| `REDIS_DB` | Redis 数据库编号，未设置时默认为 `0` |
-
-行为：服务在 `new Redis(options)` 后监听 `connect`，连接成功后才 resolve；`shutdown` 时调用 `client.disconnect()`。
+| `REDIS_DB` | Redis 数据库编号（默认 `0`） |
 
-### 2.2 类型（生成代码时须遵循）
+## 3. 标准模板
 
-- 默认服务：`defineService(async (shutdown) => { ... return client; })`，返回值为 ioredis 的 `Redis` 实例。
-- 需要类型时从 `ioredis` 自行引入，例如 `import type { Redis, RedisOptions } from 'ioredis'`；本包仅导出默认服务，不 re-export 类型。
-
----
-
-## 3. 代码生成模板与规则
-
-### 3.1 使用默认服务
+### 3.1 加载默认服务
 
 ```typescript
 import { loadService } from '@hile/core'
@@ -53,8 +40,15 @@ await redis.set('key', 'value')
 const value = await redis.get('key')
 ```
 
-### 3.2 规则与反模式
+## 4. 强制规则
+
+1. 统一通过 `loadService(ioredisService)` 获取 Redis 客户端。
+2. 不要再额外封装一个同用途的全局 Redis 单例与本包混用。
+3. 生产环境应通过 `REDIS_*` 变量配置，避免硬编码。
+4. 依赖 Redis 的服务应在服务函数内部加载，不在模块顶层缓存实例。
+
+## 5. API 速查
 
-- 不要在本包外再包一层 `defineService` 封装同一个 Redis 连接；直接使用默认服务即可。
-- 不要忽略环境变量：生产环境必须通过 `REDIS_*` 配置，避免硬编码。
-- 需要扩展配置时，应在本包内扩展环境变量或 options 构造方式，保持单例由 Hile 管理。
+| 导出 | 说明 |
+|---|---|
+| 默认导出 | Hile 服务化 Redis 客户端 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hile/ioredis",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -20,8 +20,8 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "@hile/core": "1.0.16",
+    "@hile/core": "^1.0.17",
     "ioredis": "^5.10.0"
   },
-  "gitHead": "a6eab4e7803f0df7d4bca9a0bdeca76692dbc883"
+  "gitHead": "6672fc4cdc551c4265912cc85ee2e96fc44bc4c9"
 }