项目 Redis

在项目菜单选择 Redis。缓存和可靠订阅共用现有项目导航，数据按项目隔离。

管理缓存

1. 选择缓存页面，创建 JSON 或字符串 key。
2. 设置逻辑到期时间，或选择不设置逻辑到期。
3. 查看容量与 key 列表，按前缀或关键词筛选。

默认额度 1 MiB，上限 16 MiB。容量不足时新内容顶替最旧写入的内容，读取不改变顺序。单项超过额度会被拒绝。管理员调小额度时，界面会要求确认可能淘汰旧内容。

缓存是可回收数据。整个项目缓存容器有 30 天物理 TTL，写入刷新期限。即使未设置逻辑到期，实例内存紧张时也可提前回收。需要保留的消息请使用可靠订阅。

使用可靠订阅

1. 创建主题，再创建独立订阅。订阅从创建后的新消息开始。
2. 向主题发布 JSON 对象消息。结果未知时保留原提交身份与正文重试。
3. 选择订阅并领取消息，查看 60 秒领取期限。
4. 完成处理后点击确认已处理；失败时记录失败结果。

领取不等于处理成功。旧租约到期后不能确认，需要重新领取。最多尝试 10 次。暂停投递仍允许新消息进入主题，恢复后补收；有效领取在暂停期间仍可确认。

项目可靠预算 2 MiB，平台此模块总预算 64 MiB。消息、订阅、24 小时去重和回执预留均占用预算。单消息最多 16 KiB，单结果最多 256 字节，每个消息与订阅组合预留 4096 字节。界面显示预算，额度满时要求裁剪终态消息或删除不用的资源。

裁剪仅清理所有消费者已完成或耗尽的消息。删除主题会清理其消息、订阅和回执，操作前需要确认。裁剪后的 24 小时内，同身份重复发布仍返回原 ID，不会重新执行。

断线与冷更新补收依赖同一 Redis 数据仍存在。它不代表已验证全库备份恢复，也不保证消费者外部副作用只发生一次。

只读成员只能查看。操作需要项目写权限，修改缓存额度需要项目 admin。第一版使用网页用户 JWT，不自动调用工作流。

参见 项目 Redis API。