everything: misleading names in get-resource-links (isOdd) and copy-pasted JSDoc tool names
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 82/100
- Issue 类型
- 缺陷
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
阅读 src/everything/tools/get-resource-links.ts、src/everything/tools/trigger-long-running-operation.ts 和 docs/features.md;之前的 PR #4503 和 #4769 被描述为重构后代码的原型。重命名容易引起误解的 flag,记录偶数和奇数 ID 的映射关系,并更正每个 JSDoc 工具名称。完成标准:flag 与其行为相符,映射关系已记录,并且两个标头都与各自文件注册的工具相符。
由索引模型根据 Issue 内容生成。
描述
Problem
Two small naming slips in the everything server, which people read to learn the protocol:
- In
src/everything/tools/get-resource-links.ts, the flagisOddis computed asresourceId % 2 === 0, so it is true for even IDs (which get Text resources). The behavior is right; the name says the opposite, anddocs/features.mddoesn't say which IDs map to which resource type. - The JSDoc header in
src/everything/tools/get-resource-links.tsnames theget-resource-referencetool (copied from its neighbor), and the one insrc/everything/tools/trigger-long-running-operation.tsmisspells its tool's name.
Expected
Rename the flag (for example to isText), document the even/odd mapping, and have each JSDoc header name the tool its file registers.
Prior work
- #4503 by @Joosboy
- #4769 by @simpleqt
The PR(s) above targeted the pre-refactor code and are closed as part of the backlog triage in #4875; this issue is where the work continues, with the PR(s) as a prototype. Thank you to their authors.
- 主要语言
- TypeScript
- 星标
- 91.4k
- 派生
- 11.8k
- 平均合并
- 7 小时 36 分钟
- 30 天内合并 PR
- 126
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
modelcontextprotocol/servers 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 72/100
modelcontextprotocol/servers#5216 ·
维护者通常 1 天内回复
-
bug v2
难度 2/5 1-3 小时 新手友好度 79/100
modelcontextprotocol/servers#5215 ·
维护者通常 1 天内回复
-
documentation server-git server-time v2
难度 2/5 1-3 小时 新手友好度 72/100
modelcontextprotocol/servers#5213 · 2 条评论 ·
维护者通常 1 天内回复
-
documentation v2
难度 1/5 1-3 小时 新手友好度 78/100
modelcontextprotocol/servers#5212 · 1 条评论 ·
维护者通常 1 天内回复
-
documentation v2
难度 2/5 1-3 小时 新手友好度 76/100
modelcontextprotocol/servers#5211 · 1 条评论 ·
维护者通常 1 天内回复
查看 modelcontextprotocol/servers 的全部 Issue
相似的 Issue
-
[BUG] rag: sentence content can cross the reported sentence boundaries可能已有人在做 @LJK-ikun 今天认领。 未关闭bug
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
bug needs-triage
难度 2/5 1-3 小时 新手友好度 70/100
维护者通常 1 天内回复
-
README: the Resource URI Schemas example's file://documents/* pattern only matches that literal URI未关闭
难度 1/5 1 小时以内 新手友好度 88/100
platformatic/mcp#361 ·
维护者通常 1 天内回复
-
frontend
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
Push: sem service worker ou sem VAPID, o interruptor de Notificações fica ligado sem avisar nada未关闭
难度 2/5 1-3 小时 新手友好度 76/100
melgarafael/DeskcommCRM#3164 ·
维护者通常 1 天内回复