docs(mcp): 存量英文注释中文化(仅注释,代码零字节改动)

- capability/mcp 整包 17 个文件核查:仅 config.go / registry.go 含英文注释(38 行)→ 全部中文化;
  其余 15 个文件本就全中文,零改动。
- 保留 YAML/Go/JSON 示例行与字符串字面量(非注释,禁止改动)。
- 验收:机械校验为空;gofmt -l 干净;go build/vet/test ./internal/capability/mcp/... 全绿。
This commit is contained in:
AskaEth committed 2026-10-04 16:58:01 +08:00
1 parent 2593765add
commit 5c2189efb0
2 files changed
+31 -38

No files matched your search

+12 -14
View File
@@ -9,17 +9,16 @@ import (
"gopkg.in/yaml.v3"
)
// Load reads MCP server configuration from the process environment. It returns
// every configured server; callers filter on Enabled.
// Load 从进程环境读取 MCP server 配置,返回所有已配置的服务器;
// 由调用方按 Enabled 过滤。
func Load() (*Config, error) {
return FromEnv(os.Environ())
}
// FromEnv builds a Config from a KEY=value pair slice such as os.Environ() or a
// test fixture. Named servers are read from MCP_<NAME>_* for indexes; the
// unnumbered MCP_* variables describe a single default server. When N is a
// positive index, one server is read per group and scanning stops at the first
// group with no NAME/COMMAND/URL set.
// FromEnv 从形如 os.Environ() 或测试夹具的 KEY=value 键值对切片构建 Config。
// 带编号的服务器按索引从 MCP_<NAME>_* 读取;不带编号的 MCP_* 变量描述
// 单台默认服务器。逐组读取(每组一台服务器),扫描在遇到第一组
// NAME/COMMAND/URL 全空的配置时停止。
func FromEnv(pairs []string) (*Config, error) {
env := make(map[string]string, len(pairs))
for _, p := range pairs {
@@ -31,7 +30,7 @@ func FromEnv(pairs []string) (*Config, error) {
return &Config{Servers: fromEnvMap(env)}, nil
}
// FromYAML parses a YAML document describing MCP servers, for example:
// FromYAML 解析描述 MCP server 的 YAML 文档,例如:
//
// servers:
// - name: calc
@@ -48,7 +47,7 @@ func FromYAML(data []byte) (*Config, error) {
return &Config{Servers: doc.Servers}, nil
}
// fromEnvMap builds the server list from a resolved environment map.
// fromEnvMap 从已解析的环境变量 map 构建服务器列表。
func fromEnvMap(env map[string]string) []MCPConfig {
var servers []MCPConfig
if cfg, ok := readOne(env, "MCP"); ok {
@@ -64,8 +63,8 @@ func fromEnvMap(env map[string]string) []MCPConfig {
return servers
}
// readOne reads a single MCPConfig from env using the given variable prefix
// (e.g. "MCP" or "MCP_0"). It reports ok=false when no identifying field is set.
// readOne 用给定的变量前缀(如 "MCP" 或 "MCP_0")从环境读取一台 MCPConfig;
// 没有任何标识字段时返回 ok=false。
func readOne(env map[string]string, prefix string) (MCPConfig, bool) {
p := prefix
if p == "" {
@@ -88,8 +87,7 @@ func readOne(env map[string]string, prefix string) (MCPConfig, bool) {
}, true
}
// splitArgs splits a comma-separated args value, trimming spaces and empty
// entries.
// splitArgs 拆分逗号分隔的 args 值,去掉空白与空项。
func splitArgs(raw string) []string {
raw = strings.TrimSpace(raw)
if raw == "" {
@@ -105,7 +103,7 @@ func splitArgs(raw string) []string {
return out
}
// parseBool parses a boolean value, defaulting to def on empty or invalid input.
// parseBool 解析布尔值;输入为空或非法时返回默认值 def。
func parseBool(raw string, def bool) bool {
raw = strings.TrimSpace(raw)
if raw == "" {