release: v1.0.3

Author: rockyshi1993

CHANGELOG.md

@@ -1,7 +1,7 @@
 # 变更日志 (CHANGELOG)
 
 > **说明**: 版本概览索引，详细变更见 [changelogs/](./changelogs/) 目录  
-> **最后更新**: 2026-03-22
+> **最后更新**: 2026-05-30
 
 ---
 
@@ -24,6 +24,7 @@
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.0.3](./changelogs/v1.0.3.md) | 2026-05-30 | Patch 修复：收口多级缓存 TTL 回填、分布式失效、函数缓存精确失效、Redis 批量 key 校验，并移除 website 与 source map 发布产物 | [查看](./changelogs/v1.0.3.md) |
 | [v1.0.0](./changelogs/v1.0.0.md) | 2026-03-22 | 🎉 首个正式发布版本。零运行时依赖的 Node.js 多层缓存库，统一工作区所有项目的缓存基础设施 | [查看](./changelogs/v1.0.0.md) |
 
 ---
@@ -32,6 +33,7 @@
 
 | 版本 | 新增 | 变更 | 修复 | 移除 |
 |------|------|------|------|------|
+| v1.0.3 | - | 构建产物精简、README 说明补齐 | 缓存语义与发布前验证链收口 | Rspress website |
 | v1.0.0 | 初始版本 | - | - | - |
 
 ---
@@ -46,4 +48,4 @@
 
 ---
 
-**最后更新**: 2026-03-22
+**最后更新**: 2026-05-30

README.md

@@ -166,6 +166,10 @@ import type { CacheLike, CacheStats, MemoryCacheOptions } from 'cache-hub';
 | `enableTags` | `boolean` | `false` | 开启标签索引，支持 `invalidateByTag` |
 | `enabled` | `boolean` | `true` | `false` 时禁用缓存 |
 
+#### `MemoryCache` 实例方法
+
+除完整 `CacheLike` 接口外，`MemoryCache` 还提供 `getRemainingTtl(key)` 与 `getRemainingTtlMany(keys)`，用于查询未过期键的剩余 TTL；不过期键返回 `null`，不存在或已过期键返回 `undefined`。
+
 #### `CacheLike` 接口
 
 所有缓存实现均满足此接口，可互相替换：
@@ -253,6 +257,14 @@ await adapter.close();
 
 > **需要安装 ioredis**：`npm install ioredis`
 
+`RedisCacheAdapter` 实现完整 `CacheLike` 接口，并额外提供：
+
+| 方法 | 说明 |
+|------|------|
+| `getRemainingTtl(key)` | 查询 Redis 键的剩余 TTL；不过期键返回 `null`，不存在键返回 `undefined` |
+| `getRemainingTtlMany(keys)` | 批量查询剩余 TTL，返回 key 到 TTL 的映射 |
+| `close()` | 关闭适配器自己创建的连接；传入外部 ioredis 实例时不会关闭 |
+
 ---
 
 ### `cache-hub/function-cache` — 函数缓存
@@ -355,7 +367,7 @@ npm test
 # 单元测试 + 覆盖率报告
 npm run test:coverage
 
-# 集成测试（30 个，需要本地 Redis）
+# 集成测试（需要本地 Redis）
 npm run test:integration
 
 # 指定 Redis 地址

changelogs/unreleased.md

@@ -2,10 +2,4 @@
 
 ## Fixed
 
-- 修复 `MultiLevelCache` 在 L2 命中回填 L1 时丢失剩余 TTL 的问题，避免短 TTL 远端数据被扩展成本地长 TTL 或永久缓存。
-- 修复 `DistributedCacheInvalidator.invalidate()` 只广播不先清发送方本地缓存的语义偏差，并同步 README / docs 示例。
-- 修复 `MultiLevelCache` 遇到不支持 TTL 查询的远端 `CacheLike` 时不回填 L1 的兼容性回归；TTL-aware 远端保留剩余 TTL，TTL-unaware 远端按 L1 默认 TTL 策略回填。
-- 修复 `withCache.invalidateAll()` 前缀删除可能误删同前缀手工键的问题，改为精确删除该包装函数实际写入的 key，并在失效前清理已淘汰/过期的历史 key。
-- 修复 `RedisCacheAdapter` 的 `getMany/setMany/delMany` 未统一执行 key 校验的问题。
-- 补齐新增缓存语义分支测试，恢复 Statements / Branches / Functions / Lines 全部 100% 覆盖率。
-- 优化 CJS 构建脚本日志，隐藏预期 `TS1343` 中间诊断，避免成功构建看起来像失败。
+- 暂无。

changelogs/v1.0.3.md

@@ -0,0 +1,40 @@
+# v1.0.3 变更详情
+
+> **发布日期**: 2026-05-30
+> **类型**: Patch release
+> **前置版本**: v1.0.2
+
+---
+
+## 变更概述
+
+cache-hub v1.0.3 聚焦缓存语义修复、文档入口收口和发布产物精简。该版本修复多级缓存 TTL 回填、分布式失效、函数缓存精确失效和 Redis 批量 key 校验相关问题，同时移除未部署且与 README 高度重复的 Rspress website，并关闭发布构建 source map 输出。
+
+---
+
+## Fixed
+
+- 修复 `MultiLevelCache` 在 L2 命中回填 L1 时丢失剩余 TTL 的问题，避免短 TTL 远端数据被扩展成本地长 TTL 或永久缓存。
+- 修复 `DistributedCacheInvalidator.invalidate()` 只广播不先清发送方本地缓存的语义偏差，并同步 README 示例。
+- 修复 `MultiLevelCache` 遇到不支持 TTL 查询的远端 `CacheLike` 时不回填 L1 的兼容性回归；TTL-aware 远端保留剩余 TTL，TTL-unaware 远端按 L1 默认 TTL 策略回填。
+- 修复 `withCache.invalidateAll()` 前缀删除可能误删同前缀手工键的问题，改为精确删除该包装函数实际写入的 key，并在失效前清理已淘汰/过期的历史 key。
+- 修复 `RedisCacheAdapter` 的 `getMany/setMany/delMany` 未统一执行 key 校验的问题。
+- 补齐新增缓存语义分支测试，恢复 Statements / Branches / Functions / Lines 全部 100% 覆盖率。
+- 优化 CJS 构建脚本日志，隐藏预期 `TS1343` 中间诊断，避免成功构建看起来像失败。
+- 移除未部署且与 README 高度重复的 Rspress website 文档站，删除相关 docs 脚本与开发依赖，降低文档同步和依赖维护成本。
+- 关闭 ESM/CJS 发布构建的 source map 输出，避免 `dist/**/*.js.map` 进入 npm 包。
+- 补充 README 中 `MemoryCache` / `RedisCacheAdapter` 的 TTL 查询方法说明，并将集成测试命令说明改为不依赖固定数量的表述。
+
+---
+
+## 验证摘要
+
+- `npm run typecheck`
+- `npm run test:coverage`
+- `npm run build`
+- `npm audit --json`
+- `npm pack --dry-run --json`
+
+---
+
+> **版本历史**: v1.0.3 (2026-05-30) — patch 修复与发布产物精简