TradingAgents-CN 统一数据标准与实施路径跨市场CN/HK/US标识、行业、单位、时区与冲突仲裁工程指南【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN日期2025-10-19 · 项目TradingAgents-CN · 文档定位数据一致性标准PIT与跨源融合的工程指南导读本文是 TradingAgents-CN 在构建 CN/HK/US 三市场统一数据层时的工程标准与实施路径说明围绕「标识、市场交易所、行业分类、单位时区、指标定义、冲突仲裁」六大不一致问题定义了基于full_symbol exchange_mic:symbol主键的 Canonical Schema并给出从字典发布、适配器规范化到数据服务接口、黄金样本测试、前后端交付的四阶段落地计划。读完本文你将掌握一套可直接用于多源行情、财务与基础信息融合的字段标准、枚举字典、规范化函数签名、仲裁与置信度评分规则以及项目当前在 app/models/stock_models.py、app/services/data_sources/tushare_adapter.py 与 app/routers/multi_market_stocks.py 中的对应落地证据。1. 核心问题拆解六类数据不一致跨市场、跨数据源的金融数据融合首先面对的是「同一事物、多种说法」。文档将问题收敛为六类维度不一致表现行业分类中文/英文/GICS/NAICS/自定义口径不一致且层级不同行业/板块/子行业语义错位市场与交易所CN/HK/US 与 SSE/SZSE/HKEX/NASDAQ/NYSE 的字段、符号各说各话标识ts_code、symbol、full_symbol、yfinance规范不同港股是否补零、A 股是否带后缀不一致单位与时区币种CNY/HKD/USD、金额单位元/百万/亿、时间与时区格式不统一字段定义财务指标口径GAAP/IFRS/CAS、“行业/板块”语义层级不同值冲突不同源给出名称/行业/财务数据不一致需要仲裁与置信度规则这些问题的本质是缺乏一个权威的中间表示Canonical Form每个数据源各自携带一套隐式约定直接消费必然产生歧义。文档给出的解法是建立统一数据模型让所有来源在进入系统时先“翻译”到规范口径。2. 统一数据模型Canonical Schema统一数据模型分为七个域各域解决一类问题。2.1 标识与命名Identity主键采用full_symbol exchange_mic:symbolexchange_mic使用 ISO 10383 标准如XSHG、XSHE、XHKG、XNAS、XNYS。symbol规则A 股不带后缀的 6 位数字如600519full_symbol形如XSHG:600519或XSHE:000001。港股不做左侧补零的纯数字字符串如5、0005、2388full_symbol形如XHKG:0005。保留vendor_symbols.hk_pad_left4的适配能力如yfinance: 0005.HK。美股字母代码如AAPLfull_symbol形如XNAS:AAPL或XNYS:MSFT。扩展标识isin推荐、countryISO 3166-1、currencyISO 4217。供应商映射保留vendor_symbols { tushare: 600519.SH, yfinance: 600519.SS, akshare: 600519 }便于反向解析与对账。这一设计与仓库现有模型方向一致app/models/stock_models.py 中StockBasicInfoExtended已同时维护symbol6 位数字patternr^\d{6}$、full_symbol与兼容字段code并通过extra allow保持向后兼容MarketInfo子模型则承载market/exchange/exchange_name/currency/timezone的规范描述。2.2 市场与交易所Market/Exchangemarket取值CN、HK、USexchange_mic与exchange_name对齐timezone使用 IANA如Asia/Shanghai。交易日历统一由日历服务提供含竞价/连续竞价/收盘阶段。仓库中的枚举已先行落地app/models/stock_models.py 定义了MarketType Literal[CN, HK, US]、ExchangeType Literal[SZSE, SSE, SEHK, NYSE, NASDAQ]、CurrencyType Literal[CNY, HKD, USD]而 app/routers/multi_market_stocks.py 的/api/markets端点以元数据形式返回三市场的currencyCNY/HKD/USD、timezoneAsia/Shanghai、Asia/Hong_Kong、America/New_York与trading_hours正是该标准的运行时体现。2.3 行业分类Industry Taxonomy采用GICS 作为规范口径四级sector、industry_group、industry、sub_industry含gics_code。原始行业字段保留source_industry.name、source_industry.taxonomy如 CN-Industry/GICS/NAICS、source_industry.level、source_industry.code、map_confidence。提供映射表CN/自定义 → GICS无法精确映射时标注approximatetrue与置信区间。设计要点是**“规范口径唯一、原始信息不丢”**GICS 只作为对外输出的统一视图来源口径全部留痕映射过程显式记录置信度避免在映射链路上二次丢失信息。2.4 单位与币种Units/Currency金额统一以数值 单位乘数表示valueunit_multiplier如1e6/1e8保留原始单位unit_hint如 元/百万/亿。currency统一为 ISO 4217区别report_currency与trading_currency提供fx_rate_timestamp以便需要时折算。仓库中的 Tushare 适配器已经展示了“单位不一致必须显式转换”的实践app/services/data_sources/tushare_adapter.py 在get_realtime_quotes中对成交量做了「手 → 股」的换算vol vol * 100并在代码注释中明确标注这一单位语义避免下游把“手”当“股”使用。2.5 时间与时区Time/Timezone所有事件与行情时间戳采用UTC保留timezone以描述来源时区支持session_id与阶段枚举auction/open/regular/close。支持 PITPoint-in-Timeasof、effective_date、data_version、feature_version确保复现实验可重放。PIT 是金融数据分析与回测的关键同一标的在不同时点看到的“最新”数据可能不同只有冻结data_version/feature_version才能让历史实验精确复现。这与 app/models/stock_models.py 中为股票基础信息与行情模型预留的data_version字段形成呼应。2.6 指标定义Metric Definitionsaccounting_standardGAAP/IFRS/CAS中国会计准则保留definition_notes与restatementtrue/false。规范字段示例revenue、net_income、eps_basic、eps_diluted、gross_margin、book_value_per_share必要时提供normalized_value与转换说明。三市场财务数据最隐蔽的坑在会计口径同一“净利润”CAS 与 IFRS/GAAP 的确认时点与范围可能不同因此规范字段必须同时携带accounting_standard与重述标记跨市场对比前先做口径归一。2.7 值冲突仲裁Arbitration加权聚合综合source_priority可信度预设、freshness时间新鲜度、cross_validation与第二来源校验、variance来源间差异。输出confidence_score0–1与source_of_truth最终取值来源保留conflict_log以便审核。提供人工覆盖台帐manual_override含审计字段与过期策略。仲裁不是简单“取平均”而是四要素加权source_priority决定来源可信底座仓库中 Tushare 适配器通过_get_default_priority()返回 3注释明确“数字越大优先级越高”可作为优先级语义的参考实现freshness惩罚过时数据cross_validation鼓励多源一致variance抑制离群值。最终输出置信度与来源留痕供审计与人工兜底。3. 实施路径Phased Plan标准要落地需按四个阶段渐进推进Phase 0字典与规范产出exchange_mic、market、timezone枚举字典确定full_symbol规则与港股补零适配选项。行业映射初稿CN/自定义 → GICS定义不可映射与近似映射标记。指标口径定义与度量单位规范PIT 与版本字段约定。Phase 1适配器与规范化函数normalize_symbol(source, code)解析并生成full_symbol与vendor_symbols。map_industry(source_field)映射到 GICS 并产出map_confidence。normalize_units(value, unit_hint, currency)标准化数值与单位乘数区分报告币与交易币。normalize_time(ts, timezone)统一到 UTC 并保留来源时区。Phase 2数据服务接口GET /meta/symbol/resolve输入任意ts_code/symbol/yfinance输出规范化身份与映射。GET /data/candles入参full_symbol/start/end/granularity/adjustment返回ts(open/high/low/close/volume/turnover/currency)timezoneUTC含exchange_mic/market/unit_multiplier元数据。GET /data/industry返回 GICS 规范字段与来源映射。Phase 3校验与测试构建黄金样本集CN/HK/US 各 50–100 标的覆盖多来源差异与典型边界。单元/集成测试符号解析、行业映射、单位标准化、时间归一化与仲裁评分。观测与审计生成冲突报告与人工覆盖审计台帐。Phase 4交付与集成前后端联调统一模型接入回测与模拟交易服务SSE/WebSocket 推送采用规范字段。文档与版本发布标准与字典文件冻结data_version/feature_version与兼容策略。仓库中的配套规划文档 docs/tech_reviews/2025-10-21-multi-market-data-architecture-guide.md 进一步给出了混合架构图UnifiedMarketDataService作为统一查询接口层向下路由到 A 股/港股/美股三套独立数据服务与各自 MongoDB 集合*_cn/*_hk/*_us其代码模板可参考 docs/tech_reviews/2025-10-21-multi-market-code-templates.md含parse_full_symbol/normalize_symbol的调用方式、字段映射trade_date→date、vol→volume、turnover→amount的 DataFrame 归一化逻辑。4. 关键枚举与规则摘要枚举/规则取值marketCN、HK、USexchange_micXSHGSSE、XSHESZSE、XHKGHKEX、XNASNASDAQ、XNYSNYSEfull_symbolexchange_mic:symbolA 股不带后缀、港股不强制补零、美股字母代码timezoneIANA 时区所有时间戳以UTC存储行业采用 GICS 四级保留来源字段与映射置信度5. 快速示例美股 AAPLsymbolAAPLfull_symbolXNAS:AAPLyfinanceAAPL。A 股贵州茅台symbol600519full_symbolXSHG:600519tushare600519.SHyfinance600519.SS。港股长江和记symbol0005full_symbolXHKG:0005yfinance0005.HK适配器支持左补零 4。注意港股示例中“不强制补零”与“vendor 适配补零”同时成立规范层symbol为0005仅在对接yfinance时按hk_pad_left4适配为0005.HK——这正是「规范主键 vendor 映射」设计的价值所在。仓库配套文档中的前端工具函数formatSymbolDisplay也展示了展示层可自行决定补零如港股补 5 位与存储层规范解耦可参考 docs/tech_reviews/2025-10-21-multi-market-code-templates.md。6. 落地检查清单Checklist明确full_symbol与exchange_mic作为唯一主键完成字典发布。完成 CN/HK/US 的符号解析与来源映射适配器。发布 GICS 映射表与map_confidence规则标注不可映射场景。金额单位标准化与币种处理记录unit_multiplier与fx_rate_timestamp。时间归一化至UTC保留timezone与session_id。启用仲裁与置信度评分生成冲突与覆盖审计报告。冻结data_version/feature_version确保 PIT 可复现。7. 结语与当前仓库落地状态统一数据标准是 TradingAgents-CN 从“单市场 A 股框架”走向“跨市场多源融合”的地基工程。从当前仓库代码看标准的关键骨架已部分落地枚举与模型MarketType/ExchangeType/CurrencyType、MarketInfo、带full_symbol与data_version的扩展模型见 app/models/stock_models.py多市场接口/api/markets提供三市场元数据与跨市场搜索路由见 app/routers/multi_market_stocks.py单位与优先级实践Tushare 适配器中的“手→股”换算与优先级设定见 app/services/data_sources/tushare_adapter.py统一服务与代码模板UnifiedMarketDataService的拆分路由与字段归一化设计见 docs/tech_reviews/2025-10-21-multi-market-data-architecture-guide.md 与 docs/tech_reviews/2025-10-21-multi-market-code-templates.md。文档同时明确了后续动作在docs/config/发布字典与映射 JSON/YAML 文件并在app/routers数据路由与各数据源适配器中逐步落地规范化函数与仲裁逻辑。对于接手的工程团队建议按 Phase 0 → Phase 4 顺序推进并以黄金样本集作为跨源融合质量的回归基线。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TradingAgents-CN 统一数据标准与实施路径：跨市场（CN/HK/US）标识、行业、单位、时区与冲突仲裁工程指南
TradingAgents-CN 统一数据标准与实施路径跨市场CN/HK/US标识、行业、单位、时区与冲突仲裁工程指南【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN日期2025-10-19 · 项目TradingAgents-CN · 文档定位数据一致性标准PIT与跨源融合的工程指南导读本文是 TradingAgents-CN 在构建 CN/HK/US 三市场统一数据层时的工程标准与实施路径说明围绕「标识、市场交易所、行业分类、单位时区、指标定义、冲突仲裁」六大不一致问题定义了基于full_symbol exchange_mic:symbol主键的 Canonical Schema并给出从字典发布、适配器规范化到数据服务接口、黄金样本测试、前后端交付的四阶段落地计划。读完本文你将掌握一套可直接用于多源行情、财务与基础信息融合的字段标准、枚举字典、规范化函数签名、仲裁与置信度评分规则以及项目当前在 app/models/stock_models.py、app/services/data_sources/tushare_adapter.py 与 app/routers/multi_market_stocks.py 中的对应落地证据。1. 核心问题拆解六类数据不一致跨市场、跨数据源的金融数据融合首先面对的是「同一事物、多种说法」。文档将问题收敛为六类维度不一致表现行业分类中文/英文/GICS/NAICS/自定义口径不一致且层级不同行业/板块/子行业语义错位市场与交易所CN/HK/US 与 SSE/SZSE/HKEX/NASDAQ/NYSE 的字段、符号各说各话标识ts_code、symbol、full_symbol、yfinance规范不同港股是否补零、A 股是否带后缀不一致单位与时区币种CNY/HKD/USD、金额单位元/百万/亿、时间与时区格式不统一字段定义财务指标口径GAAP/IFRS/CAS、“行业/板块”语义层级不同值冲突不同源给出名称/行业/财务数据不一致需要仲裁与置信度规则这些问题的本质是缺乏一个权威的中间表示Canonical Form每个数据源各自携带一套隐式约定直接消费必然产生歧义。文档给出的解法是建立统一数据模型让所有来源在进入系统时先“翻译”到规范口径。2. 统一数据模型Canonical Schema统一数据模型分为七个域各域解决一类问题。2.1 标识与命名Identity主键采用full_symbol exchange_mic:symbolexchange_mic使用 ISO 10383 标准如XSHG、XSHE、XHKG、XNAS、XNYS。symbol规则A 股不带后缀的 6 位数字如600519full_symbol形如XSHG:600519或XSHE:000001。港股不做左侧补零的纯数字字符串如5、0005、2388full_symbol形如XHKG:0005。保留vendor_symbols.hk_pad_left4的适配能力如yfinance: 0005.HK。美股字母代码如AAPLfull_symbol形如XNAS:AAPL或XNYS:MSFT。扩展标识isin推荐、countryISO 3166-1、currencyISO 4217。供应商映射保留vendor_symbols { tushare: 600519.SH, yfinance: 600519.SS, akshare: 600519 }便于反向解析与对账。这一设计与仓库现有模型方向一致app/models/stock_models.py 中StockBasicInfoExtended已同时维护symbol6 位数字patternr^\d{6}$、full_symbol与兼容字段code并通过extra allow保持向后兼容MarketInfo子模型则承载market/exchange/exchange_name/currency/timezone的规范描述。2.2 市场与交易所Market/Exchangemarket取值CN、HK、USexchange_mic与exchange_name对齐timezone使用 IANA如Asia/Shanghai。交易日历统一由日历服务提供含竞价/连续竞价/收盘阶段。仓库中的枚举已先行落地app/models/stock_models.py 定义了MarketType Literal[CN, HK, US]、ExchangeType Literal[SZSE, SSE, SEHK, NYSE, NASDAQ]、CurrencyType Literal[CNY, HKD, USD]而 app/routers/multi_market_stocks.py 的/api/markets端点以元数据形式返回三市场的currencyCNY/HKD/USD、timezoneAsia/Shanghai、Asia/Hong_Kong、America/New_York与trading_hours正是该标准的运行时体现。2.3 行业分类Industry Taxonomy采用GICS 作为规范口径四级sector、industry_group、industry、sub_industry含gics_code。原始行业字段保留source_industry.name、source_industry.taxonomy如 CN-Industry/GICS/NAICS、source_industry.level、source_industry.code、map_confidence。提供映射表CN/自定义 → GICS无法精确映射时标注approximatetrue与置信区间。设计要点是**“规范口径唯一、原始信息不丢”**GICS 只作为对外输出的统一视图来源口径全部留痕映射过程显式记录置信度避免在映射链路上二次丢失信息。2.4 单位与币种Units/Currency金额统一以数值 单位乘数表示valueunit_multiplier如1e6/1e8保留原始单位unit_hint如 元/百万/亿。currency统一为 ISO 4217区别report_currency与trading_currency提供fx_rate_timestamp以便需要时折算。仓库中的 Tushare 适配器已经展示了“单位不一致必须显式转换”的实践app/services/data_sources/tushare_adapter.py 在get_realtime_quotes中对成交量做了「手 → 股」的换算vol vol * 100并在代码注释中明确标注这一单位语义避免下游把“手”当“股”使用。2.5 时间与时区Time/Timezone所有事件与行情时间戳采用UTC保留timezone以描述来源时区支持session_id与阶段枚举auction/open/regular/close。支持 PITPoint-in-Timeasof、effective_date、data_version、feature_version确保复现实验可重放。PIT 是金融数据分析与回测的关键同一标的在不同时点看到的“最新”数据可能不同只有冻结data_version/feature_version才能让历史实验精确复现。这与 app/models/stock_models.py 中为股票基础信息与行情模型预留的data_version字段形成呼应。2.6 指标定义Metric Definitionsaccounting_standardGAAP/IFRS/CAS中国会计准则保留definition_notes与restatementtrue/false。规范字段示例revenue、net_income、eps_basic、eps_diluted、gross_margin、book_value_per_share必要时提供normalized_value与转换说明。三市场财务数据最隐蔽的坑在会计口径同一“净利润”CAS 与 IFRS/GAAP 的确认时点与范围可能不同因此规范字段必须同时携带accounting_standard与重述标记跨市场对比前先做口径归一。2.7 值冲突仲裁Arbitration加权聚合综合source_priority可信度预设、freshness时间新鲜度、cross_validation与第二来源校验、variance来源间差异。输出confidence_score0–1与source_of_truth最终取值来源保留conflict_log以便审核。提供人工覆盖台帐manual_override含审计字段与过期策略。仲裁不是简单“取平均”而是四要素加权source_priority决定来源可信底座仓库中 Tushare 适配器通过_get_default_priority()返回 3注释明确“数字越大优先级越高”可作为优先级语义的参考实现freshness惩罚过时数据cross_validation鼓励多源一致variance抑制离群值。最终输出置信度与来源留痕供审计与人工兜底。3. 实施路径Phased Plan标准要落地需按四个阶段渐进推进Phase 0字典与规范产出exchange_mic、market、timezone枚举字典确定full_symbol规则与港股补零适配选项。行业映射初稿CN/自定义 → GICS定义不可映射与近似映射标记。指标口径定义与度量单位规范PIT 与版本字段约定。Phase 1适配器与规范化函数normalize_symbol(source, code)解析并生成full_symbol与vendor_symbols。map_industry(source_field)映射到 GICS 并产出map_confidence。normalize_units(value, unit_hint, currency)标准化数值与单位乘数区分报告币与交易币。normalize_time(ts, timezone)统一到 UTC 并保留来源时区。Phase 2数据服务接口GET /meta/symbol/resolve输入任意ts_code/symbol/yfinance输出规范化身份与映射。GET /data/candles入参full_symbol/start/end/granularity/adjustment返回ts(open/high/low/close/volume/turnover/currency)timezoneUTC含exchange_mic/market/unit_multiplier元数据。GET /data/industry返回 GICS 规范字段与来源映射。Phase 3校验与测试构建黄金样本集CN/HK/US 各 50–100 标的覆盖多来源差异与典型边界。单元/集成测试符号解析、行业映射、单位标准化、时间归一化与仲裁评分。观测与审计生成冲突报告与人工覆盖审计台帐。Phase 4交付与集成前后端联调统一模型接入回测与模拟交易服务SSE/WebSocket 推送采用规范字段。文档与版本发布标准与字典文件冻结data_version/feature_version与兼容策略。仓库中的配套规划文档 docs/tech_reviews/2025-10-21-multi-market-data-architecture-guide.md 进一步给出了混合架构图UnifiedMarketDataService作为统一查询接口层向下路由到 A 股/港股/美股三套独立数据服务与各自 MongoDB 集合*_cn/*_hk/*_us其代码模板可参考 docs/tech_reviews/2025-10-21-multi-market-code-templates.md含parse_full_symbol/normalize_symbol的调用方式、字段映射trade_date→date、vol→volume、turnover→amount的 DataFrame 归一化逻辑。4. 关键枚举与规则摘要枚举/规则取值marketCN、HK、USexchange_micXSHGSSE、XSHESZSE、XHKGHKEX、XNASNASDAQ、XNYSNYSEfull_symbolexchange_mic:symbolA 股不带后缀、港股不强制补零、美股字母代码timezoneIANA 时区所有时间戳以UTC存储行业采用 GICS 四级保留来源字段与映射置信度5. 快速示例美股 AAPLsymbolAAPLfull_symbolXNAS:AAPLyfinanceAAPL。A 股贵州茅台symbol600519full_symbolXSHG:600519tushare600519.SHyfinance600519.SS。港股长江和记symbol0005full_symbolXHKG:0005yfinance0005.HK适配器支持左补零 4。注意港股示例中“不强制补零”与“vendor 适配补零”同时成立规范层symbol为0005仅在对接yfinance时按hk_pad_left4适配为0005.HK——这正是「规范主键 vendor 映射」设计的价值所在。仓库配套文档中的前端工具函数formatSymbolDisplay也展示了展示层可自行决定补零如港股补 5 位与存储层规范解耦可参考 docs/tech_reviews/2025-10-21-multi-market-code-templates.md。6. 落地检查清单Checklist明确full_symbol与exchange_mic作为唯一主键完成字典发布。完成 CN/HK/US 的符号解析与来源映射适配器。发布 GICS 映射表与map_confidence规则标注不可映射场景。金额单位标准化与币种处理记录unit_multiplier与fx_rate_timestamp。时间归一化至UTC保留timezone与session_id。启用仲裁与置信度评分生成冲突与覆盖审计报告。冻结data_version/feature_version确保 PIT 可复现。7. 结语与当前仓库落地状态统一数据标准是 TradingAgents-CN 从“单市场 A 股框架”走向“跨市场多源融合”的地基工程。从当前仓库代码看标准的关键骨架已部分落地枚举与模型MarketType/ExchangeType/CurrencyType、MarketInfo、带full_symbol与data_version的扩展模型见 app/models/stock_models.py多市场接口/api/markets提供三市场元数据与跨市场搜索路由见 app/routers/multi_market_stocks.py单位与优先级实践Tushare 适配器中的“手→股”换算与优先级设定见 app/services/data_sources/tushare_adapter.py统一服务与代码模板UnifiedMarketDataService的拆分路由与字段归一化设计见 docs/tech_reviews/2025-10-21-multi-market-data-architecture-guide.md 与 docs/tech_reviews/2025-10-21-multi-market-code-templates.md。文档同时明确了后续动作在docs/config/发布字典与映射 JSON/YAML 文件并在app/routers数据路由与各数据源适配器中逐步落地规范化函数与仲裁逻辑。对于接手的工程团队建议按 Phase 0 → Phase 4 顺序推进并以黄金样本集作为跨源融合质量的回归基线。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考