【架构优化】合并 catalog/assistant handler 中重复的资产引用查找为包级 helper
維護者通常 1 天內回覆
評估
研究方向
The three duplicated lookups are the agentNamesReferencing, sandboxNamesReferencing and workflowNamesReferencingSandbox methods on catalogHandlers in internal/httpapi/catalog.go and assistantHandlers in internal/httpapi/assistant_approval.go. Pull request #445 is already open against this issue, so check it before starting. Done means the package-level helpers in asset_references.go are used by both handlers, the new asset_references_test.go passes, and go test ./internal/httpapi/ is green.
由索引模型根據 Issue 內容生成。
描述
现状问题
internal/httpapi/catalog.go（catalogHandlers）与 internal/httpapi/assistant_approval.go（assistantHandlers）各自定义了一份逐字相同的资产引用查找方法：
agentNamesReferencing(kind, id)：列出引用某规则/技能的角色名sandboxNamesReferencing(kind, id)：列出引用某 Dockerfile/环境脚本的沙箱名workflowNamesReferencingSandbox(id)：列出引用某沙箱的流程名
两份实现共约 45 行重复，只依赖 *repo.Store 的只读查询，与各自 handler 的其它状态无关。目录删除校验（catalog）和助手删除审批预警（assistant）判断"是否仍被引用"的口径本应一致，重复实现容易在后续修改时只改一边而出现偏差。
重构方案
- 新建包级 helper 文件
internal/httpapi/asset_references.go，提供三个无 receiver 的函数agentNamesReferencing(st *repo.Store, kind, id)、sandboxNamesReferencing(st, kind, id)、workflowNamesReferencingSandbox(st, id)，实现与现有代码逐行一致（符合 AGENTS.md「纯共享的包级 helper 可以放独立 helper 文件」）。 - 删除两个 handler 上的重复方法，调用处改为传
h.repo。 - 现有测试中对旧方法的调用同步改为调用包级函数。
影响范围
仅 internal/httpapi 包内部未导出函数；不涉及 HTTP 接口、错误文案、返回值或排序，行为不变。
验证方式
- 新增
asset_references_test.go覆盖三个函数（重复引用只计一次、kind 区分、未引用返回空）。 gofmt、go vet ./internal/httpapi/、go test ./internal/httpapi/通过（本机缺 Chromium 的浏览器用例除外，与 main 一致）。
- 主要語言
- Go
- 星號
- 141
- 分支
- 28
- 平均合併
- 1 天 15 小時
- 30 天內合併 PR
- 113
環境準備
- 提供 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue，再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫，在一個分支上完成修改。
- 送出 Pull Request，並在描述裡引用這個 Issue 編號。
Tencent/LoopForge 的其他 Issue
-
難度 2/5 1-3 小時 新手友好度 74/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 75/100
維護者通常 1 天內回覆
-
[Bug]: 官方镜像未安装 wecom-cli，企业微信通知报「通知服务未安装 wecom-cli」可能已有人在做 @newexploreor 於 1 天前認領。 未關閉bug
難度 2/5 1-3 小時 新手友好度 76/100
Tencent/LoopForge#156 · 1 則留言 · 已指派 1 人 ·
維護者通常 1 天內回覆
-
【架构优化】合并 gitwork/workbranch.go 中 push/pull 重复的默认提交身份注入为 withFallbackIdentity可能已有人在做 @fx-kurumi 今天認領。 未關閉
難度 2/5 1-3 小時 新手友好度 40/100
維護者通常 1 天內回覆
-
【架构优化】从 runtime.installNPMCLI 中拆出 npm 参数拼装 npmCLIInstallArgs 与安装结果启用 activateNPMStage可能已有人在做 @fx-kurumi 今天認領。 未關閉
難度 2/5 1-3 小時 新手友好度 30/100
維護者通常 1 天內回覆
查看 Tencent/LoopForge 的全部 Issue
相似的 Issue
-
team:library-maintainers
難度 2/5 1-3 小時 新手友好度 82/100
padok-team/burrito#1208 · 1 則留言 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 62/100
bazel-contrib/rules_go#4784 · 1 則留言 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 75/100
-
難度 2/5 1-3 小時 新手友好度 62/100
POSIdev-community/aictl#40 ·
-
難度 1/5 1 小時以內 新手友好度 62/100
prime-radiant-inc/evener#6306 ·
維護者通常 1 天內回覆