【架构优化】合并 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 天内回复