【架构优化】合并 catalog/assistant handler 中重复的资产引用查找为包级 helper

オープン
#444 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@fx-kurumi がすでに取り組んでいます。

2026年11月13日 から。

  • #445 @fx-kurumi による — オープン

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
15/100
issue の種類
リファクタリング
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
go
領域
backend

調査の方向性

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時間
マージ済み PR(30日)
113

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Tencent/LoopForge のほかの issue

Tencent/LoopForge の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。