第 27 章建议：补一个 MCP 写操作超时后确认结果的最小案例
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 半日
- 初心者へのやさしさ
- 62/100
- issue の種類
- ドキュメント
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 領域
- content, documentation
調査の方向性
content/chapters/chapter-27.md を読み、特に冪等キーとステータスチェックに関する段落を確認し、その章に再利用できるサンプルエントリがすでにあるかどうかを調べる。サンプルは、安定した operation ID をキーとするローカルのモックチケットエンドポイントで、次の3つのパスを扱う：通常の書き込みと読み戻し、応答の欠落に続くステータスクエリと同じキーでのリトライ、ステータスクエリが利用できずチケットが手動対応待ちのままになるケース。デモが1件のチケット、その最終状態、operation ID で相関付けられたログを示したら完了；書き始める前に配置を maintainers に確認する。
索引モデルが issue の本文から書いたものです。
説明
第 27 章「MCP 权限管理」已经提到用幂等键、唯一约束和状态检查避免重复写入。我建议在这一段后面加一个小例子，让读者看到「调用超时」和「业务写入失败」是两种不同的状态。
可以用一个本地模拟工单接口。调用前生成稳定的业务操作 ID，服务端写入后可按 ID 查询结果。同一请求演示三种路径：
- 正常返回，回读确认工单存在。
- 服务端写入后故意丢掉响应。客户端超时后先查状态；需要重试时复用同一个幂等键，最终仍只有一张工单。
- 状态查询也不可用。保持「待确认」，把异常交回人工处理。
用工单数量、最终状态和按操作 ID 关联的日志验收这个示例即可。这个用例来自我在整理 Agent-Ready Engineering 的操作契约时想验证的一项行为。
想请教维护者，这样的补充适合放在本章末尾，还是做成单独的共建案例？如果第 27 章已有适合复用的示例入口，我很乐意先把范围对齐。
- 主要言語
- HTML
- スター
- 520
- フォーク
- 87
- 平均マージ
- 20分
- マージ済み PR（30日）
- 18
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
modelscope/ms-cookbook のほかの issue
-
難易度 4/5 3〜5日 初心者へのやさしさ 45/100
modelscope/ms-cookbook#15 ·
メンテナーはふだん 1 日以内に返信
-
難易度 3/5 1〜2日 初心者へのやさしさ 25/100
modelscope/ms-cookbook#11 ·
メンテナーはふだん 1 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 30/100
modelscope/ms-cookbook#4 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
modelscope/ms-cookbook の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 75/100
BehiSecc/awesome-claude-skills#1354 ·
メンテナーはふだん 7 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 80/100
-
intake mcp-intake needs-human-review priority:high type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
Ikalus1988/MisakaNet#5022 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
Add: BOM Cineオープンapproved check:passed streams:add
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
catalog good first issue help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100