|
# MCP目录分页一致性核验工作流
## 套餐描述
核验 MCP 分页目录的 TTL、缓存范围、页序与 cursor 失效，输出可复核的人工新鲜度结论。
## 详细介绍
# MCP目录分页一致性核验工作流
**4个实用技能 · 4步完成 · 每一步都能单独使用**
把 MCP `tools/list`、`prompts/list`、`resources/list` 等分页结果的 `ttlMs`、`cacheScope`、cursor、页序和条目集合整理成可复核的本地门禁：先规范分页合同，再审计重复/缺口/cursor 失效，最后判断新鲜度与是否需要从头重取。套餐只处理脱敏 JSON，不访问 MCP、不刷新缓存、不执行网络请求。
4个可下载技能 · 每个技能可单独运行
## 4步自动化工作流
### 🔵 1 MCP目录分页合同整理
技能文件：`mcp-directory-page-contract-normalizer`
**解决什么：** 统一分页页码、条目、nextCursor、`ttlMs` 和 `cacheScope`，发现页级缓存字段缺失、非法或混用。
**你会得到：** READY/REVIEW、页数、TTL 列表、缓存范围和 `contract_hash`。
**↓ 本步结果自动进入下一步**
### 🟢 2 MCP目录分页一致性审计
技能文件：`mcp-directory-page-consistency-auditor`
**解决什么：** 检查页序、页内重复、cursor 失效、缓存范围漂移和需要从第一页重取的边界，避免分页目录出现重复或缺口。
**你会得到：** PASS/HOLD、页序、问题清单、是否需要从头重取和 `consistency_hash`；不会重新拉取目录。
**↓ 本步结果自动进入下一步**
### 🟠 3 MCP目录分页新鲜度计算
技能文件：`mcp-directory-page-freshness-evaluator`
**解决什么：** 按每页收到时间、`ttlMs` 和通知失效标记判断 FRESH、STALE 或 `REFETCH_FROM_BEGINNING`，把时间判断与最终放行分开。
**你会得到：** 每页的新鲜度结果、从头重取建议、原因和 `freshness_hash`。
**↓ 本步结果自动进入下一步**
### 🟣 4 MCP目录分页新鲜度闸门
技能文件：`mcp-directory-page-freshness-gate`
**解决什么：** 汇总合同、分页一致性和新鲜度结果，区分静态证据已经通过与真实目录是否需要重取，并保留人工确认边界。
**你会得到：** `READY_FOR_HUMAN_DIRECTORY_PAGE_REVIEW` 或 HOLD、阻断原因、`human_decision=PENDING`、`refetch_execute=false` 和 `external_action_executed=false`，形成最终验收包。
**↓ 本步结果形成最终交付**
## 实际示例
脱敏样例包含两个 `tools/list` 页面，均为 `cacheScope=public`，页 0 与页 1 条目不重复，每页有独立 TTL，当前时间仍在有效窗口内。四步输出依次为 READY、PASS、FRESH、READY_FOR_HUMAN_DIRECTORY_PAGE_REVIEW。若 cursor 失效、页内重复、页序倒退、TTL 过期或通知提前失效，则输出 HOLD、STALE 或从头重取建议。该结果是本地测试情境，不代表真实目录已刷新。
## 适合谁
- 维护 MCP 工具、提示词或资源目录分页和客户端缓存的开发团队
- 需要在大目录、工具搜索或多服务器聚合场景中控制重复/缺口/过期风险的 QA、SRE 和平台团队
- 交付 MCP 客户端缓存策略、目录回归或网关聚合验收的实施人员
## 买家只需提供
- 脱敏的分页结果、页码、条目 ID、nextCursor、`ttlMs` 和 `cacheScope`
- 每页接收时间、当前测试时间和通知失效标记
- 组织批准的分页重取、人工复核和缓存共享边界
## 使用方式
1. 使用 Python 3.10 或更高版本，将分页结果和时间字段写成 UTF-8 JSON；不要放入真实客户内容、令牌或完整资源正文。
2. 依次运行分页合同、分页一致性、新鲜度计算和新鲜度闸门，也可单独使用任一步。
3. 在隔离测试环境核对允许、过期和 cursor 失效分支后，再由有权限的客户端决定是否真实重取。
## 交付与验收
- 交付四个独立技能目录，每个包含 `_meta.json`、`SKILL.md`、`README.md`、`agents/openai.yaml`、标准库脚本和脱敏样例。
- 正常样例可重复输出 READY、PASS、FRESH 和 `READY_FOR_HUMAN_DIRECTORY_PAGE_REVIEW`；字段缺失、分页不一致、TTL 过期或 cursor 失效时输出 REVIEW/HOLD/REFETCH_FROM_BEGINNING。
- 文件级验收包含脚本可执行、JSON 可解析、稳定哈希和无网络动作字段；行为级验收包含新鲜、过期、通知失效、重复条目和 cursor 失效分支。
- 不包含 MCP 端点、缓存服务、HTTP 请求、目录刷新、账号、密钥、真实配置发布或人工代办。
## 服务说明
脚本只处理买家有权使用且已经脱敏的本地 JSON，不连接 MCP、缓存、网关或外部 API，不读取凭据，不刷新目录。静态分页核验不能证明真实客户端、代理或服务器已经遵守缓存语义，也不能替代端到端测试和变更审批。MCP 规范、SDK 和客户端缓存实现会变化，正式使用前须由协议、平台和安全负责人复核。本资源不承诺绝对新鲜、零重复、零缺口或固定节省比例。
## 套餐图标
<img id="aimg_f1Zyl" onclick="zoom(this, this.src, 0, 0, 0)" class="zoom" src="https://www.xianshe.com/data/attachment/hl_skillhub/images/bundle_icon_1_1787402701.png" onmouseover="img_onmouseoverfunc(this)" lazyloadthumb="1" border="0" alt="" />
## 包含技能
- [mcp-directory-page-consistency-auditor
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=mcp-directory-page-consistency-auditor)
- [mcp-directory-page-contract-normalizer
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=mcp-directory-page-contract-normalizer)
- [mcp-directory-page-freshness-evaluator
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=mcp-directory-page-freshness-evaluator)
- [mcp-directory-page-freshness-gate
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=mcp-directory-page-freshness-gate)
## 安装方式
此套餐为**付费套餐**，购买后可一键下载全部技能。
🛒 [点击购买并下载 MCP目录分页一致性核验工作流](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=buy&bundle_id=546)
## 收费方式
💴 **现金购买** - 需要支付 ¥169.00
## 前往安装
**[👉 点击前往套餐安装页面](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=bundle&ac=detail&slug=mcp-directory-page-contract-normalizer-dc1acc11d09c)**
| 
喧嚣卡
千斤顶
