@agentunion/kite 1.5.0 → 1.6.0

package/extensions/services/redis/ALIGNMENT_CHECKLIST.md

@@ -0,0 +1,121 @@
+# Redis 模块对齐检查表
+
+## 三个参考模块对比
+
+| 机制/特性 | backup | auth | model_service | Redis 当前 | 优先级 |
+|----------|--------|------|---------------|-----------|--------|
+| **1. 启动验证** |
+| `_validate_and_prepare()` | ✅ 行998 | ✅ 行1045 | ✅ 行929 | ❌ | P0 |
+| `_prepare_local_mode()` | ✅ 行1012 | ✅ 行882 | ✅ 行956 | ❌ | P0 |
+| `_prepare_remote_mode()` | ✅ 行1047 | ✅ 行916 | ✅ 行1010 | ❌ | P1 |
+| stdin 读取 boot_info | ✅ 行1029 | ✅ 行890 | ✅ 行972 | ✅ 简化版 | P0 |
+| **2. 日志系统** |
+| `_SafeWriter` | ✅ 行151 | ✅ 行151 | ✅ 行151 | ❌ | P0 |
+| `_tprint()` 时间戳日志 | ✅ 行269 | ✅ 行206 | ✅ 行305 | ❌ | P0 |
+| `_write_log()` 写入文件 | ✅ 行289 | ✅ 行226 | ✅ 行325 | ❌ | P0 |
+| latest.log | ✅ 行1021 | ✅ 行897 | ✅ 行979 | ❌ | P0 |
+| crashes.jsonl | ✅ 行1025 | ✅ 行901 | ✅ 行983 | ❌ | P0 |
+| daily log 归档 | ✅ 行192 | ✅ 行115 | ✅ 行213 | ❌ | P1 |
+| **3. 异常处理** |
+| `_write_crash()` | ✅ 行222 | ✅ 行159 | ✅ 行213 | ❌ | P0 |
+| `_setup_exception_hooks()` | ✅ 行306 | ✅ 行193 | ✅ 行283 | ❌ | P0 |
+| 主线程异常捕获 | ✅ 行308 | ✅ 行195 | ✅ 行285 | ❌ | P0 |
+| 子线程异常捕获 | ✅ 行318 | ✅ 行199 | ✅ 行295 | ❌ | P0 |
+| **4. 配置加载** |
+| `_load_module_config()` | ✅ 行37 | ✅ 行36 | ✅ 行37 | ❌ | P0 |
+| module.md frontmatter 解析 | ✅ 行37-87 | ✅ 行36-87 | ✅ 行37-87 | ❌ | P0 |
+| `MODULE_NAME` 全局变量 | ✅ 行148 | ✅ 行90 | ✅ 行148 | ✅ 硬编码 | P0 |
+| `_module_config` 全局变量 | ✅ 行147 | ✅ 行89 | ✅ 行147 | ❌ | P0 |
+| **5. WebSocket 连接** |
+| `_ws_loop()` 重连循环 | ✅ 行416 | ✅ 行936 | ✅ 行454 | ✅ 简化版 | P0 |
+| 指数退避策略 | ✅ 行420-468 | ✅ 行940-958 | ✅ 行458-496 | ✅ 简化版 | P0 |
+| 错误码分类 | ✅ 行439-456 | ✅ 行400-405 | ✅ 行390-395 | ❌ | P1 |
+| `_ws_connect()` | ✅ 行551 | ✅ 行558 | ✅ 行596 | ✅ 简化版 | P0 |
+| 认证流程 | ✅ 行561-573 | ✅ 行567-573 | ✅ 行605-612 | ✅ | P0 |
+| **6. 消息分发** |
+| `_ws_receiver()` 三路分发 | ✅ 行591 | ✅ 行593 | ✅ 行635 | ✅ | P0 |
+| system.require_init 检测 | ✅ 行608 | ✅ 行608 | ✅ 行647 | ✅ | P0 |
+| 事件通知处理 | ✅ 行611 | ✅ 行611 | ✅ 行650 | ✅ 简化版 | P0 |
+| RPC 请求处理 | ✅ 行613 | ✅ 行613 | ✅ 行652 | ✅ | P0 |
+| RPC 响应处理 | ✅ 行616 | ✅ 行615 | ✅ 行654 | ✅ | P0 |
+| **7. 初始化流程** |
+| `_do_init()` | ✅ 行483 | ✅ 行495 | ✅ 行541 | ✅ | P0 |
+| event.subscribe | ✅ 行490 | ✅ 行502 | ✅ 行548 | ✅ | P0 |
+| registry.register | ✅ 行501 | ✅ 行508 | ✅ 行559 | ✅ | P0 |
+| module.ready | ✅ 行534 | ✅ 行546 | ✅ 行581 | ✅ | P0 |
+| reason 字段 | ✅ 行486 | ✅ 行496 | ✅ 行542 | ✅ | P0 |
+| **8. 事件处理** |
+| `_handle_event_notification()` | ✅ 行673 | ✅ 行673 | ✅ 行718 | ❌ | P0 |
+| system.ping 处理 | ✅ 行680 | ✅ 行678 | ✅ 行725 | ✅ | P0 |
+| module.shutdown 处理 | ✅ 行693 | ✅ 行690 | ✅ 行738 | ✅ | P0 |
+| SYSTEM_BROADCAST_EVENTS 过滤 | ✅ 行701 | ✅ 行697 | ❌ | ❌ | P1 |
+| **9. RPC 处理** |
+| `_handle_rpc_request()` | ✅ 行710 | ✅ 行701 | ✅ 行750 | ✅ | P0 |
+| health RPC | ✅ 行740 | ✅ 行734 | ✅ 行777 | ❌ | P1 |
+| status RPC | ✅ 行750 | ✅ 行738 | ✅ 行784 | ❌ | P1 |
+| 业务 RPC 方法 | ✅ 5个 | ✅ 7个 | ❌ | ✅ 6个 | P0 |
+| **10. Ping/Pong** |
+| `_handle_ping_event()` | ✅ 行661 | ✅ 行666 | ✅ 行706 | ✅ | P0 |
+| `_publish_event()` | ✅ 行652 | ✅ 行652 | ✅ 行692 | ✅ | P0 |
+| **11. 弹性连接** |
+| connection_elastic 支持 | ✅ True | ❌ False | ✅ True | ❌ | P2 |
+| `_handle_connection_offer()` | ✅ 行865 | ✅ 行841 | ✅ 行913 | ❌ | P2 |
+| `_handle_connection_release()` | ✅ 行921 | ✅ 行897 | ✅ 行969 | ❌ | P2 |
+| `_connect_slot()` | ✅ 行876 | ✅ 行852 | ✅ 行924 | ❌ | P2 |
+| `_slot_recv_loop()` | ✅ 行894 | ✅ 行870 | ✅ 行942 | ❌ | P2 |
+| `_extra_ws` 字典 | ✅ 行392 | ✅ 行265 | ✅ 行380 | ❌ | P2 |
+| **12. 优雅退出** |
+| `_handle_shutdown()` | ✅ 行935 | ✅ 行811 | ✅ 行866 | ✅ 简化版 | P0 |
+| module.shutdown.ack | ✅ 行941 | ✅ 行817 | ✅ 行872 | ❌ | P0 |
+| module.exiting | ✅ 行943 | ✅ 行819 | ✅ 行874 | ❌ | P0 |
+| module.shutdown.ready | ✅ 行964 | ✅ 行830 | ✅ 行895 | ❌ | P0 |
+| 清理附加连接 | ✅ 行953 | ✅ 行822 | ✅ 行885 | ❌ | P1 |
+| **13. RPC 管理** |
+| `_pending_rpc` 字典 | ✅ 行395 | ✅ 行270 | ✅ 行383 | ✅ | P0 |
+| `_rpc_call()` with future | ✅ 行622 | ✅ 行622 | ✅ 行660 | ✅ | P0 |
+| `_handle_rpc_response()` | ✅ 行644 | ✅ 行644 | ✅ 行682 | ✅ | P0 |
+| 超时处理 | ✅ 3.0s | ✅ 3.0s | ✅ 3.0s | ✅ | P0 |
+| **14. 远程模式** |
+| `_remote_mode_loop()` | ✅ 行1102 | ✅ 行960 | ✅ 行1140 | ❌ | P2 |
+| `_remote_connect()` | ✅ 行1116 | ✅ 行960 | ✅ 行1154 | ❌ | P2 |
+| Gateway 认证 | ✅ 行1120 | ✅ 行971 | ✅ 行1158 | ❌ | P2 |
+| Token 缓存 | ✅ 行1077 | ❌ | ✅ 行1115 | ❌ | P2 |
+| **15. 其他** |
+| 测试事件循环 | ✅ 行983 | ❌ | ✅ 行1021 | ❌ | P3 |
+| 配置管理 RPC | ✅ 行790-861 | ❌ | ❌ | ❌ | P3 |
+
+## 优先级说明
+
+- **P0**：核心机制，必须实现（启动、日志、异常、连接、消息分发、初始化、shutdown）
+- **P1**：重要机制，应该实现（错误码分类、health/status RPC、日志归档、事件过滤）
+- **P2**：高级机制，可选实现（弹性连接、远程模式）
+- **P3**：辅助机制，暂不实现（测试循环、配置管理）
+
+## Redis 当前状态总结
+
+✅ **已实现（简化版）**：
+- 基础连接和认证
+- system.require_init 处理
+- _do_init() 流程
+- RPC 请求/响应处理
+- ping/pong
+- 业务 RPC 方法（6个）
+
+❌ **缺失（P0 必须补齐）**：
+- 启动验证流程
+- 完整日志系统
+- 异常处理和崩溃记录
+- 配置加载
+- 事件处理分层
+- 完整 shutdown 流程（ack → exiting → ready）
+- SafeWriter 安全输出
+
+❌ **缺失（P1 应该补齐）**：
+- 错误码分类重连
+- health/status RPC
+- 日志归档
+- SYSTEM_BROADCAST_EVENTS 过滤
+
+❌ **缺失（P2 可选）**：
+- 弹性连接
+- 远程模式

package/extensions/services/redis/ALIGNMENT_STATUS.md

@@ -0,0 +1,548 @@
+# Redis 模块对齐状态表
+
+## 对齐参考模块
+
+- **backup** (`extensions/services/backup/entry.py`) - 1151 行，最完整的参考实现
+- **auth** (`extensions/services/auth/entry.py`) - 1045 行，认证服务
+- **model_service** (`extensions/services/model_service/entry.py`) - 1180 行，模型服务
+
+## 对齐状态总览
+
+| 类别 | 总计 | ✅ 已对齐 | 🟡 部分对齐 | ❌ 未对齐 | 优先级 |
+|------|------|----------|------------|----------|--------|
+| 1. 启动验证 | 4 | 1 | 0 | 3 | P0 |
+| 2. 日志系统 | 6 | 0 | 0 | 6 | P0 |
+| 3. 异常处理 | 4 | 0 | 0 | 4 | P0 |
+| 4. 配置加载 | 4 | 1 | 0 | 3 | P0 |
+| 5. WebSocket 连接 | 4 | 2 | 2 | 0 | P0 |
+| 6. 消息分发 | 4 | 4 | 0 | 0 | P0 |
+| 7. 初始化流程 | 5 | 5 | 0 | 0 | P0 |
+| 8. 事件处理 | 4 | 2 | 0 | 2 | P0 |
+| 9. RPC 处理 | 4 | 3 | 0 | 1 | P0/P1 |
+| 10. Ping/Pong | 2 | 2 | 0 | 0 | P0 |
+| 11. 弹性连接 | 6 | 0 | 0 | 6 | P2 |
+| 12. 优雅退出 | 5 | 1 | 0 | 4 | P0 |
+| 13. RPC 管理 | 4 | 4 | 0 | 0 | P0 |
+| 14. 远程模式 | 4 | 0 | 0 | 4 | P2 |
+| 15. 其他 | 2 | 0 | 0 | 2 | P3 |
+
+**总计**：58 项机制
+- ✅ 已对齐：25 项 (43%)
+- 🟡 部分对齐：2 项 (3%)
+- ❌ 未对齐：31 项 (54%)
+
+---
+
+## 详细对齐表
+
+### 1. 启动验证机制
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_validate_and_prepare()` | ✅ 行998 | ✅ 行1045 | ✅ 行929 | ❌ | 未对齐 | P0 |
+| `_prepare_local_mode()` | ✅ 行1012 | ✅ 行882 | ✅ 行956 | ❌ | 未对齐 | P0 |
+| `_prepare_remote_mode()` | ✅ 行1047 | ✅ 行916 | ✅ 行1010 | ❌ | 未对齐 | P1 |
+| stdin 读取 boot_info | ✅ 行1029 | ✅ 行890 | ✅ 行972 | ✅ 简化版 | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 必须**：添加 `_validate_and_prepare()` 和 `_prepare_local_mode()`，确保启动前验证环境和创建必要目录
+- **P1 可选**：`_prepare_remote_mode()` 用于远程模式，Redis 暂不需要
+
+---
+
+### 2. 日志系统
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_SafeWriter` | ✅ 行151 | ✅ 行151 | ✅ 行151 | ❌ | 未对齐 | P0 |
+| `_tprint()` 时间戳日志 | ✅ 行269 | ✅ 行206 | ✅ 行305 | ❌ | 未对齐 | P0 |
+| `_write_log()` 写入文件 | ✅ 行289 | ✅ 行226 | ✅ 行325 | ❌ | 未对齐 | P0 |
+| latest.log | ✅ 行1021 | ✅ 行897 | ✅ 行979 | ❌ | 未对齐 | P0 |
+| crashes.jsonl | ✅ 行1025 | ✅ 行901 | ✅ 行983 | ❌ | 未对齐 | P0 |
+| daily log 归档 | ✅ 行192 | ✅ 行115 | ✅ 行213 | ❌ | 未对齐 | P1 |
+
+**对齐建议**：
+- **P0 必须**：添加完整日志系统（SafeWriter + tprint + write_log + latest.log + crashes.jsonl）
+- **P1 可选**：日志归档功能，按天保存历史日志
+
+---
+
+### 3. 异常处理
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_write_crash()` | ✅ 行222 | ✅ 行159 | ✅ 行213 | ❌ | 未对齐 | P0 |
+| `_setup_exception_hooks()` | ✅ 行306 | ✅ 行193 | ✅ 行283 | ❌ | 未对齐 | P0 |
+| 主线程异常捕获 | ✅ 行308 | ✅ 行195 | ✅ 行285 | ❌ | 未对齐 | P0 |
+| 子线程异常捕获 | ✅ 行318 | ✅ 行199 | ✅ 行295 | ❌ | 未对齐 | P0 |
+
+**对齐建议**：
+- **P0 必须**：添加完整异常处理机制，捕获主线程和子线程异常并写入 crashes.jsonl
+
+---
+
+### 4. 配置加载
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_load_module_config()` | ✅ 行37 | ✅ 行36 | ✅ 行37 | ❌ | 未对齐 | P0 |
+| module.md frontmatter 解析 | ✅ 行37-87 | ✅ 行36-87 | ✅ 行37-87 | ❌ | 未对齐 | P0 |
+| `MODULE_NAME` 全局变量 | ✅ 行148 | ✅ 行90 | ✅ 行148 | ✅ 硬编码 | 已对齐 | P0 |
+| `_module_config` 全局变量 | ✅ 行147 | ✅ 行89 | ✅ 行147 | ❌ | 未对齐 | P0 |
+
+**对齐建议**：
+- **P0 必须**：添加 `_load_module_config()` 函数，从 module.md 解析 frontmatter 配置
+
+---
+
+### 5. WebSocket 连接
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_ws_loop()` 重连循环 | ✅ 行416 | ✅ 行936 | ✅ 行454 | ✅ 简化版 | 部分对齐 | P0 |
+| 指数退避策略 | ✅ 行420-468 | ✅ 行940-958 | ✅ 行458-496 | ✅ 简化版 | 部分对齐 | P0 |
+| 错误码分类 | ✅ 行439-456 | ✅ 行400-405 | ✅ 行390-395 | ❌ | 未对齐 | P1 |
+| `_ws_connect()` | ✅ 行551 | ✅ 行558 | ✅ 行596 | ✅ | 已对齐 | P0 |
+| 认证流程 | ✅ 行561-573 | ✅ 行567-573 | ✅ 行605-612 | ✅ | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 已完成**：基础重连和认证已实现
+- **P1 建议**：添加错误码分类，区分可恢复错误（重连）和不可恢复错误（退出）
+
+---
+
+### 6. 消息分发
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_ws_receiver()` 三路分发 | ✅ 行591 | ✅ 行593 | ✅ 行635 | ✅ | 已对齐 | P0 |
+| system.require_init 检测 | ✅ 行608 | ✅ 行608 | ✅ 行647 | ✅ | 已对齐 | P0 |
+| 事件通知处理 | ✅ 行611 | ✅ 行611 | ✅ 行650 | ✅ | 已对齐 | P0 |
+| RPC 请求处理 | ✅ 行613 | ✅ 行613 | ✅ 行652 | ✅ | 已对齐 | P0 |
+| RPC 响应处理 | ✅ 行616 | ✅ 行615 | ✅ 行654 | ✅ | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 已完成**：消息分发机制完整
+
+---
+
+### 7. 初始化流程
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_do_init()` | ✅ 行483 | ✅ 行495 | ✅ 行541 | ✅ | 已对齐 | P0 |
+| event.subscribe | ✅ 行490 | ✅ 行502 | ✅ 行548 | ✅ | 已对齐 | P0 |
+| registry.register | ✅ 行501 | ✅ 行508 | ✅ 行559 | ✅ | 已对齐 | P0 |
+| module.ready | ✅ 行534 | ✅ 行546 | ✅ 行581 | ✅ | 已对齐 | P0 |
+| reason 字段 | ✅ 行486 | ✅ 行496 | ✅ 行542 | ✅ | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 已完成**：初始化流程完整
+
+---
+
+### 8. 事件处理
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_handle_event_notification()` | ✅ 行673 | ✅ 行673 | ✅ 行718 | ❌ | 未对齐 | P0 |
+| system.ping 处理 | ✅ 行680 | ✅ 行678 | ✅ 行725 | ✅ | 已对齐 | P0 |
+| module.shutdown 处理 | ✅ 行693 | ✅ 行690 | ✅ 行738 | ✅ | 已对齐 | P0 |
+| SYSTEM_BROADCAST_EVENTS 过滤 | ✅ 行701 | ✅ 行697 | ❌ | ❌ | 未对齐 | P1 |
+
+**对齐建议**：
+- **P0 必须**：添加 `_handle_event_notification()` 函数，统一处理事件通知
+- **P1 建议**：添加 SYSTEM_BROADCAST_EVENTS 过滤，避免处理不相关的系统广播
+
+---
+
+### 9. RPC 处理
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_handle_rpc_request()` | ✅ 行710 | ✅ 行701 | ✅ 行750 | ✅ | 已对齐 | P0 |
+| health RPC | ✅ 行740 | ✅ 行734 | ✅ 行777 | ❌ | 未对齐 | P1 |
+| status RPC | ✅ 行750 | ✅ 行738 | ✅ 行784 | ❌ | 未对齐 | P1 |
+| 业务 RPC 方法 | ✅ 5个 | ✅ 7个 | ❌ | ✅ 6个 | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 已完成**：业务 RPC 方法已实现（6个 Redis 操作）
+- **P1 建议**：添加 health 和 status RPC，提供健康检查和状态查询
+
+---
+
+### 10. Ping/Pong
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_handle_ping_event()` | ✅ 行661 | ✅ 行666 | ✅ 行706 | ✅ | 已对齐 | P0 |
+| `_publish_event()` | ✅ 行652 | ✅ 行652 | ✅ 行692 | ✅ | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 已完成**：Ping/Pong 机制完整
+
+---
+
+### 11. 弹性连接
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| connection_elastic 支持 | ✅ True | ❌ False | ✅ True | ❌ | 未对齐 | P2 |
+| `_handle_connection_offer()` | ✅ 行865 | ✅ 行841 | ✅ 行913 | ❌ | 未对齐 | P2 |
+| `_handle_connection_release()` | ✅ 行921 | ✅ 行897 | ✅ 行969 | ❌ | 未对齐 | P2 |
+| `_connect_slot()` | ✅ 行876 | ✅ 行852 | ✅ 行924 | ❌ | 未对齐 | P2 |
+| `_slot_recv_loop()` | ✅ 行894 | ✅ 行870 | ✅ 行942 | ❌ | 未对齐 | P2 |
+| `_extra_ws` 字典 | ✅ 行392 | ✅ 行265 | ✅ 行380 | ❌ | 未对齐 | P2 |
+
+**对齐建议**：
+- **P2 可选**：弹性连接用于多实例场景，Redis 单实例暂不需要
+
+---
+
+### 12. 优雅退出
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_handle_shutdown()` | ✅ 行935 | ✅ 行811 | ✅ 行866 | ✅ 简化版 | 部分对齐 | P0 |
+| module.shutdown.ack | ✅ 行941 | ✅ 行817 | ✅ 行872 | ❌ | 未对齐 | P0 |
+| module.exiting | ✅ 行943 | ✅ 行819 | ✅ 行874 | ❌ | 未对齐 | P0 |
+| module.shutdown.ready | ✅ 行964 | ✅ 行830 | ✅ 行895 | ❌ | 未对齐 | P0 |
+| 清理附加连接 | ✅ 行953 | ✅ 行822 | ✅ 行885 | ❌ | 未对齐 | P1 |
+
+**对齐建议**：
+- **P0 必须**：完善 shutdown 流程，添加 ack → exiting → ready 三阶段事件
+- **P1 可选**：清理附加连接（弹性连接场景）
+
+---
+
+### 13. RPC 管理
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_pending_rpc` 字典 | ✅ 行395 | ✅ 行270 | ✅ 行383 | ✅ | 已对齐 | P0 |
+| `_rpc_call()` with future | ✅ 行622 | ✅ 行622 | ✅ 行660 | ✅ | 已对齐 | P0 |
+| `_handle_rpc_response()` | ✅ 行644 | ✅ 行644 | ✅ 行682 | ✅ | 已对齐 | P0 |
+| 超时处理 | ✅ 3.0s | ✅ 3.0s | ✅ 3.0s | ✅ | 已对齐 | P0 |
+
+**对齐建议**：
+- **P0 已完成**：RPC 管理机制完整
+
+---
+
+### 14. 远程模式
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| `_remote_mode_loop()` | ✅ 行1102 | ✅ 行960 | ✅ 行1140 | ❌ | 未对齐 | P2 |
+| `_remote_connect()` | ✅ 行1116 | ✅ 行960 | ✅ 行1154 | ❌ | 未对齐 | P2 |
+| Gateway 认证 | ✅ 行1120 | ✅ 行971 | ✅ 行1158 | ❌ | 未对齐 | P2 |
+| Token 缓存 | ✅ 行1077 | ❌ | ✅ 行1115 | ❌ | 未对齐 | P2 |
+
+**对齐建议**：
+- **P2 可选**：远程模式用于分布式部署，Redis 本地模式暂不需要
+
+---
+
+### 15. 其他
+
+| 机制 | backup | auth | model_service | Redis | 状态 | 优先级 |
+|------|--------|------|---------------|-------|------|--------|
+| 测试事件循环 | ✅ 行983 | ❌ | ✅ 行1021 | ❌ | 未对齐 | P3 |
+| 配置管理 RPC | ✅ 行790-861 | ❌ | ❌ | ❌ | 未对齐 | P3 |
+
+**对齐建议**：
+- **P3 暂不需要**：测试循环和配置管理是辅助功能
+
+---
+
+## 对齐优先级总结
+
+### P0 级别（必须实现，共 35 项）
+
+**已完成（17 项）**：
+- ✅ stdin 读取 boot_info
+- ✅ WebSocket 连接和认证
+- ✅ 消息三路分发（事件/RPC请求/RPC响应）
+- ✅ system.require_init 检测
+- ✅ 初始化流程（subscribe + register + ready）
+- ✅ system.ping 处理
+- ✅ module.shutdown 处理
+- ✅ Ping/Pong 机制
+- ✅ RPC 管理（pending_rpc + future + 超时）
+- ✅ 业务 RPC 方法（6个 Redis 操作）
+- ✅ MODULE_NAME 全局变量
+
+**未完成（18 项）**：
+- ❌ 启动验证（_validate_and_prepare + _prepare_local_mode）
+- ❌ 日志系统（SafeWriter + tprint + write_log + latest.log + crashes.jsonl）
+- ❌ 异常处理（_write_crash + _setup_exception_hooks + 主/子线程捕获）
+- ❌ 配置加载（_load_module_config + frontmatter 解析 + _module_config）
+- ❌ 事件处理（_handle_event_notification）
+- ❌ 优雅退出（shutdown.ack + exiting + shutdown.ready）
+
+### P1 级别（建议实现，共 9 项）
+
+- ❌ 远程模式准备（_prepare_remote_mode）
+- ❌ 日志归档（按天保存）
+- ❌ 错误码分类重连
+- ❌ SYSTEM_BROADCAST_EVENTS 过滤
+- ❌ health RPC
+- ❌ status RPC
+- ❌ 清理附加连接
+
+### P2 级别（可选，共 10 项）
+
+- ❌ 弹性连接（6 项机制）
+- ❌ 远程模式（4 项机制）
+
+### P3 级别（暂不需要，共 2 项）
+
+- ❌ 测试事件循环
+- ❌ 配置管理 RPC
+
+---
+
+## 行动计划
+
+### 阶段 1：P0 核心机制对齐（必须完成）
+
+#### 1.1 日志系统（最高优先级）
+```python
+# 添加到 entry.py 顶部
+class _SafeWriter:
+    """安全的 stdout/stderr 写入器"""
+    # 处理 BrokenPipeError
+
+def _tprint(msg: str, file=sys.stdout):
+    """带时间戳的日志输出"""
+    # [YYYY-MM-DD HH:MM:SS.mmm] msg
+
+def _write_log(msg: str):
+    """写入日志文件"""
+    # 写入 latest.log
+
+def _write_crash(exc_type, exc_value, exc_tb):
+    """写入崩溃日志"""
+    # 写入 crashes.jsonl
+```
+
+**参考**：`backup/entry.py` 行 151-289
+
+---
+
+#### 1.2 异常处理
+```python
+def _setup_exception_hooks():
+    """设置异常钩子"""
+    # 主线程异常：sys.excepthook
+    # 子线程异常：threading.excepthook
+```
+
+**参考**：`backup/entry.py` 行 306-330
+
+---
+
+#### 1.3 配置加载
+```python
+def _load_module_config() -> dict:
+    """从 module.md 加载配置"""
+    # 解析 frontmatter (YAML)
+    # 返回配置字典
+
+_module_config = _load_module_config()
+```
+
+**参考**：`backup/entry.py` 行 37-87
+
+---
+
+#### 1.4 启动验证
+```python
+def _validate_and_prepare():
+    """验证环境并准备目录"""
+    # 检查必要环境变量
+    # 调用 _prepare_local_mode()
+
+def _prepare_local_mode():
+    """准备本地模式"""
+    # 创建日志目录
+    # 打开 latest.log 和 crashes.jsonl
+```
+
+**参考**：`backup/entry.py` 行 998-1046
+
+---
+
+#### 1.5 事件处理统一入口
+```python
+def _handle_event_notification(ws, msg: dict):
+    """统一处理事件通知"""
+    event_type = msg.get("event")
+    if event_type == "system.ping":
+        await _handle_ping_event(ws, msg)
+    elif event_type == "module.shutdown":
+        await _handle_shutdown(ws, msg)
+    # ... 其他事件
+```
+
+**参考**：`backup/entry.py` 行 673-708
+
+---
+
+#### 1.6 完整 Shutdown 流程
+```python
+async def _handle_shutdown(ws, msg: dict):
+    """处理 shutdown 事件"""
+    # 1. 发送 module.shutdown.ack
+    # 2. 发送 module.exiting
+    # 3. 清理资源（关闭 Redis）
+    # 4. 发送 module.shutdown.ready
+    # 5. 关闭 WebSocket
+```
+
+**参考**：`backup/entry.py` 行 935-975
+
+---
+
+### 阶段 2：P1 增强机制（建议完成）
+
+#### 2.1 Health & Status RPC
+```python
+async def _rpc_health(params: dict) -> dict:
+    """健康检查"""
+    return {"status": "healthy", "redis_ready": _redis_ready}
+
+async def _rpc_status(params: dict) -> dict:
+    """状态查询"""
+    return {
+        "module_id": "redis",
+        "uptime": time.monotonic() - _start_ts,
+        "redis_ready": _redis_ready,
+        # ... 更多状态信息
+    }
+```
+
+**参考**：`backup/entry.py` 行 740-788
+
+---
+
+#### 2.2 错误码分类重连
+```python
+# 在 _ws_loop 中区分错误类型
+if close_code in [1000, 1001]:  # 正常关闭
+    break
+elif close_code in [4001, 4003]:  # 认证失败
+    _tprint("Authentication failed, exiting")
+    break
+else:  # 可恢复错误
+    # 指数退避重连
+```
+
+**参考**：`backup/entry.py` 行 439-456
+
+---
+
+#### 2.3 日志归档
+```python
+def _archive_old_logs():
+    """归档历史日志"""
+    # 按天保存到 {YYYY-MM}/{YYYY-MM-DD}.log
+```
+
+**参考**：`backup/entry.py` 行 192-220
+
+---
+
+### 阶段 3：测试验证
+
+#### 3.1 单元测试
+- 测试 Redis RPC 方法（ping, get, set, hget, hset, info）
+- 测试日志系统（tprint, write_log, write_crash）
+- 测试配置加载
+
+#### 3.2 集成测试
+- 测试完整启动流程
+- 测试 system.require_init → _do_init → module.ready
+- 测试 system.redis_ready 事件发布
+- 测试 shutdown 流程（ack → exiting → ready）
+
+#### 3.3 压力测试
+- 测试 Redis 并发读写
+- 测试异常恢复（模拟崩溃）
+- 测试重连机制
+
+---
+
+## 实施建议
+
+### 推荐顺序
+
+1. **先完成 P0 核心机制**（阶段 1）
+   - 这些是标准 Kite 模块的必备机制
+   - 确保 Redis 模块能正常启动、运行、退出
+   - 确保日志和异常能被正确记录
+
+2. **再实现 P1 增强机制**（阶段 2）
+   - 提升模块的健壮性和可观测性
+   - 添加 health/status RPC 便于监控
+   - 完善错误处理和日志归档
+
+3. **最后编写测试**（阶段 3）
+   - 单元测试验证各个功能
+   - 集成测试验证完整流程
+   - 压力测试验证稳定性
+
+### 时间估算
+
+- **阶段 1（P0）**：约 2-3 小时
+  - 日志系统：30 分钟
+  - 异常处理：20 分钟
+  - 配置加载：20 分钟
+  - 启动验证：30 分钟
+  - 事件处理：20 分钟
+  - Shutdown 流程：30 分钟
+
+- **阶段 2（P1）**：约 1-2 小时
+  - Health/Status RPC：30 分钟
+  - 错误码分类：20 分钟
+  - 日志归档：30 分钟
+
+- **阶段 3（测试）**：约 2-3 小时
+  - 单元测试：1 小时
+  - 集成测试：1 小时
+  - 压力测试：1 小时
+
+**总计**：约 5-8 小时
+
+### 风险提示
+
+1. **日志系统**：SafeWriter 必须正确处理 BrokenPipeError，否则可能导致模块崩溃
+2. **异常处理**：必须捕获所有异常并写入 crashes.jsonl，否则难以调试
+3. **Shutdown 流程**：必须按顺序发送 ack → exiting → ready，否则 Launcher 无法正确管理生命周期
+4. **配置加载**：必须正确解析 module.md frontmatter，否则模块配置错误
+
+---
+
+## 附录：代码行数对比
+
+| 模块 | 总行数 | 日志系统 | 异常处理 | 配置加载 | 启动验证 | 连接管理 | 消息分发 | 初始化 | 事件处理 | RPC处理 | Shutdown |
+|------|--------|----------|----------|----------|----------|----------|----------|--------|----------|---------|----------|
+| backup | 1151 | 138 | 108 | 50 | 48 | 135 | 80 | 51 | 35 | 150 | 40 |
+| auth | 1045 | 106 | 34 | 53 | 34 | 135 | 80 | 51 | 35 | 120 | 19 |
+| model_service | 1180 | 174 | 70 | 50 | 81 | 142 | 83 | 40 | 32 | 34 | 29 |
+| **redis (当前)** | **~600** | **0** | **0** | **0** | **0** | **135** | **80** | **51** | **20** | **150** | **20** |
+| **redis (目标)** | **~1000** | **138** | **108** | **50** | **48** | **135** | **80** | **51** | **35** | **150** | **40** |
+
+**预计新增代码**：约 400 行（P0 机制）
+
+---
+
+## 总结
+
+Redis 模块当前完成度：**43%**（25/58 项机制）
+
+**核心问题**：缺少标准 Kite 模块的基础设施（日志、异常、配置、启动验证、完整 shutdown）
+
+**解决方案**：按照 backup 模块模板，补齐 P0 级别的 18 项机制
+
+**预期效果**：完成后 Redis 模块将成为标准 Kite 模块，具备完整的可观测性、健壮性和生命周期管理能力

package/extensions/services/redis/config.json5

@@ -0,0 +1,8 @@
+{
+  redis_mode: "external",
+  redis_url: "redis://127.0.0.1:6379",
+  redis_password: "",
+  allow_fallback: true,
+  redis_retry_initial: 1,
+  redis_retry_max: 30,
+}