【架构优化】从 config.LoadEndpoints 中拆出端口解析 httpPortFromEnv 并合并重复的 trimURL(env()) 为 envURL

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

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

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

2026年11月13日 から。

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

評価

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

調査の方向性

Start in internal/config/endpoints.go, where LoadEndpoints repeats trimURL(env(...)) six times and inlines the AGENTFLOW_HTTP_PORT default and 1-65535 check. The refactor adds envURL and httpPortFromEnv and keeps the existing error text. Done means the internal/config tests, gofmt, and go vet pass. A linked pull request (#425) is already open, so check it before starting.

索引モデルが issue の本文から書いたものです。

説明

现状问题

internal/config/endpoints.go 的 LoadEndpoints 里:

  • trimURL(env("AGENTFLOW_...")) 这个"读环境变量并当 URL 规整"的写法重复了 6 次(AGENTFLOW_WORKER_URL、AGENTFLOW_API_URL、AGENTFLOW_CONTROL_URL、两处 AGENTFLOW_PLATFORM_MCP_URL、AGENTFLOW_AGENT_TOOL_GATEWAY_URL),读起来噪音较多;
  • AGENTFLOW_HTTP_PORT 的默认值回退与 1~65535 校验内联在函数开头,与地址推导混在一起。

重构方案

  • 新增包内 helper envURL(key) = trimURL(env(key)),替换上述 6 处;
  • 拆出 httpPortFromEnv() (string, error),负责默认值回退与端口校验,错误文案保持 invalid AGENTFLOW_HTTP_PORT %q 不变;
  • LoadEndpoints 只保留按角色推导地址的逻辑。WithPrivateAgentToolGateway 中 env(...) == "" 的判断语义不同(值为 / 时),保持不动。

影响范围

仅 internal/config/endpoints.go 及其测试;导出接口、返回值与错误文案不变,无行为变化。

验证方式

  • 新增测试覆盖 httpPortFromEnv(默认值、合法值、非数字、越界)与 envURL(空白、尾部 /);
  • 原有 internal/config 测试全部通过;gofmt、go vet ./internal/config/、go test ./internal/config/。
主要言語
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 を短くまとめたダイジェスト。