Add metadata validation script and module documentation

- Introduced a new Python script `check_agents_metadata.py` for validating agent metadata, including YAML parsing, rating ranges, and cross-references.
- Added usage instructions and exit codes for the script.
- Created a new markdown file `模块目录和功能说明.md` to outline the directory structure and functionality of the modules.
- Added a text file `说明此文件不可AI修改.txt` to specify that certain files should not be modified by AI, including important information about the `dstalk` framework and its modules.

plugins/config/include/toml_parse.h

@@ -1,16 +1,24 @@
+/*
+ * @file toml_parse.h
+ * @brief Lightweight single-header TOML parser (subset: flat key-value pairs).
+ * 轻量级单头文件 TOML 解析器（子集：扁平键值对）。
+ * Copyright (c) 2026 dstalk contributors. GPLv3.
+ */
+
 #pragma once
-// Shared TOML parser — used by both ConfigStore (core) and config plugin.
+// 共享 TOML 解析器 —— 由 ConfigStore（核心）和 config 插件共同使用 / Shared TOML parser — used by both ConfigStore (core) and config plugin.
 // W12.2: Extracted from config_store.cpp:23-61 and config_plugin.cpp:28-66
 //        to eliminate the 74-line code duplication (W11.2 audit Finding 1).
 // Does NOT support: inline tables, arrays, multi-line strings, escape sequences.
+// 不支持：内联表、数组、多行字符串、转义序列。
 
 #include <string>
 
 namespace dstalk {
 namespace toml {
 
-/// Parse a TOML string, calling on_kv(full_key, value) for each key-value pair.
-/// Supports [section] headers, key = "value" pairs, # comments, blank lines.
+/// 解析 TOML 字符串，对每个键值对调用 on_kv(full_key, value) / Parse a TOML string, calling on_kv(full_key, value) for each key-value pair.
+/// 支持 [section] 标题、key = "value" 键值对、# 注释、空行 / Supports [section] headers, key = "value" pairs, # comments, blank lines.
 template<typename F>
 inline void parse(const std::string& content, F&& on_kv)
 {
@@ -18,31 +26,31 @@ inline void parse(const std::string& content, F&& on_kv)
     size_t pos = 0;
 
     while (pos < content.size()) {
-        // Trim left whitespace
+        // 去除左侧空白 / Trim left whitespace
         while (pos < content.size() && (content[pos] == ' ' || content[pos] == '\t'))
             pos++;
         if (pos >= content.size()) break;
 
-        // Extract next line
+        // 提取下一行 / Extract next line
         size_t nl = content.find('\n', pos);
         std::string line = (nl != std::string::npos)
             ? content.substr(pos, nl - pos) : content.substr(pos);
         pos = (nl != std::string::npos) ? nl + 1 : content.size();
 
-        // Trim right whitespace (including \r)
+        // 去除右侧空白（包括 \r） / Trim right whitespace (including \r)
         while (!line.empty() && (line.back() == '\r' || line.back() == ' '))
             line.pop_back();
 
-        // Skip empty lines and comments
+        // 跳过空行和注释 / Skip empty lines and comments
         if (line.empty() || line[0] == '#') continue;
 
-        // Section header: [section_name]
+        // 节标题: [section_name] / Section header: [section_name]
         if (line[0] == '[' && line.back() == ']') {
             current_section = line.substr(1, line.size() - 2);
             continue;
         }
 
-        // Key = value
+        // 键 = 值 / Key = value
         size_t eq = line.find('=');
         if (eq == std::string::npos) continue;