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:
1 parent
2593765add
commit
5c2189efb0
2 files changed
+31
-38
No files matched your search
@@ -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 == "" {
|
||||
|
||||
Reference in new issue
Block a user