前言¶
使用 OpenAI Codex 相关能力时，额度是否在固定周期内重置、最近一次重置何时发生、下一次计划重置何时公布，往往要靠社区整理的公开信号或第三方页面自行对照。DeepSeek Harness（DSH）把界面、智能体工具和工作流都做成可插拔扩展；若你希望在写提示的 Composer 旁直接看到当日重置结论，并让智能体通过只读工具查询同一套数据，可以安装社区插件 dsh-codex-reset-tracker（DSH 包名 dsh-codex-reset）。该插件由 loshanvren 维护，在 SkillHub 插件目录 中归类为「工作流」。
下面介绍插件定位、能力与安装方式。事实以 GitHub 仓库 README 为准；重置信号与译文数据来自 Did Codex Reset 的公开只读 API，本仓库是其 DSH 集成，API 不包含账号级配额信息。
这是什么¶
dsh-codex-reset-tracker 是面向 Codex「重置事件、日程与来源推文」的 DSH 插件：在 Composer 增加一条入口，点开弹出紧凑状态面板；同时向智能体注册只读工具 codex_reset，用于查询全局状态或分页记录。原始重置公告归因于 Tibo Sottiaux（@thsottiaux）；信号收集与多语言内容由 Did Codex Reset 维护者整理并提供 OpenAPI。
核心功能¶
Composer 状态面板¶
- 面板展示：当日重置状态、最近一次重置时间、下一次计划时间。
- 「当天」按浏览器本地日历日判断；日程类事件不算作已完成的重置。
- 若
completedAt、effectiveAt缺失或无效，摘要会回退使用announcedAt。 - 面板包含 Tibo Sottiaux 来源推文；当中文译文与英文原文不一致时，会同时展示简体译文与英文原文。
- 新的日程公告与已完成的重置事件会显示未读标记；在可见标签页中打开面板后，未读标记会清除。
- 客户端在挂载时请求
/status，之后每 10 分钟自动刷新。
智能体工具 codex_reset¶
工具为只读，支持：
action |
作用 |
|---|---|
status |
返回最新全局与 Banked 重置信号，以及下一次计划重置 |
records |
分页返回记录，可按 kind、page、pageSize 过滤 |
可选参数 lang 用于记录译文。成功响应默认缓存 60 秒。
可在插件对应行的 config 中于 cordis.patch.yml 覆盖下表项：
| 配置项 | 默认值 | 说明 |
|---|---|---|
apiBaseUrl |
https://didcodexreset.com/openapi/v1 |
智能体工具使用的公开 API 根地址 |
cacheTtlSeconds |
60 |
工具响应缓存时长（5–3600 秒） |
timeoutMs |
20000 |
工具调用超时（1000–120000 毫秒） |
公开 API 文档说明：同一 IP 共享限额为每小时 60 次请求。
安装与启用¶
README 给出的方式是从源码加入 DSH profile（请先阅读仓库源码与许可证；插件以当前 dsh 进程权限运行）：
git clone https://github.com/loshanvren/dsh-codex-reset-tracker.git
cd dsh-codex-reset-tracker
dsh plugin --profile <profile> add .
将 <profile> 换成你实际使用的 profile 名称。包在 DSH 加载器与 package.json 中的名称为 dsh-codex-reset（当前资料中版本为 0.3.0）。
典型用法¶
- 安装并启用插件后，在 DSH Web 客户端的 Composer 找到插件入口，打开面板查看当日状态与下次计划时间，并阅读来源推文。
- 在需要由智能体回答「Codex 是否已重置」「最近记录」时，调用
codex_reset：
-action: "status"获取最新信号与下一档日程；
-action: "records"配合kind、page、pageSize翻页；需要译文时传入lang。 - 若 API 地址、缓存或超时与默认不符，在
cordis.patch.yml的插件config中修改上述三项，并留意公开 API 的每小时请求上限。
适用场景与注意¶
适合谁： 日常在 DSH 里编排对话、又需要与社区公开的 Codex 重置信号对齐的开发者；希望 Composer 内一眼看到状态、同时让 Agent 用同一数据源查询记录的场景。
需要注意：
- 数据来自 Did Codex Reset 公开 API，不是 OpenAI 账号后台的配额接口；不能替代官方账单或用量页面。
- 本仓库代码采用 MIT 许可证；Did Codex Reset 的数据与译文、Tibo Sottiaux 的推文与头像等不因本仓库 MIT 而重新授权。
- SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系；安装前请自行审阅 GitHub 源码。
结尾¶
dsh-codex-reset-tracker 把 Did Codex Reset 的公开信号接到 DSH：Composer 侧是带未读提示的状态弹层，智能体侧是只读的 codex_reset 工具。若你的工作流依赖「何时重置、下一档日程、原始公告」这类社区整理信息，可按 README 安装到指定 profile 后使用。
