【Bug已解决】[TimesFM 2.5] window_size argument raises AttributeError 解决方案一、现象长什么样TimesFM 2.5 是 Google 的时间序列基础模型用于零样本预测。你按旧文档/示例传window_size参数做预测结果报# 现象 Aforecast 不接受 window_size TypeError: forecast() got an unexpected keyword argument window_size # TimesFM 2.5 的 forecast 签名改成用 context_len / horizon_len不再认 window_size # 现象 B内部引用了不存在的属性 AttributeError: TimesFMForForecasting object has no attribute window_size # 代码某处写了 self.window_size但 2.5 版本没定义这个属性 # 被重命名为 self.context_len 之类 # 现象 C传了 window_size 但被忽略用了错误的默认窗口 # 预测长度/上下文切分用的是别的值结果与预期不符 # 典型触发 from timesfm import TimesFM model TimesFM.from_pretrained(google/timesfm-2.5) # 旧示例 out model.forecast(seriesmy_series, window_size64) # 报现象 A/B最典型的指纹旧版本或社区示例用window_size控制上下文窗口升级到 2.5 后这个参数被改名/移除于是传了就TypeError/AttributeError不传就用错默认值。二、背景TimesFM 这类时间序列基础模型的预测流程是把历史序列按上下文窗口context window切块每块喂给模型预测未来horizon步。这个窗口大小在不同版本里的参数名经历了演变早期版本用window_size表示上下文窗口长度。2.5 版本API 重构改用语义更明确的context_len上下文长度和horizon_len预测长度window_size不再出现在forecast()签名里。问题出在用户和一堆旧示例/教程仍按window_size调用而 2.5 的代码既没接受这个 kwarg内部某些路径又残留了对self.window_size属性的引用没随重构改名→ 传参直接TypeError或者在不传参但走某分支时AttributeError。这属于API 改名但没做好向后兼容的典型。三、根因根因有两类forecast()签名去掉了window_size但调用方仍传。 TimesFM 2.5 的forecast(series, context_len, horizon_len)不含window_size。旧调用forecast(series, window_size64)把window_size当 kwarg 传入Python 报unexpected keyword argument。内部残留self.window_size属性引用。 重构时把属性从self.window_size改名为self.context_len但某几条代码路径如_maybe_pad_context、_split_into_windows忘了改仍写self.window_size→AttributeError: has no attribute window_size。这类 bug 只在特定输入/分支触发所以有时报、有时不报。四、最小可运行复现下面用纯 Python 模拟forecast 签名去掉 window_size 但内部残留 self.window_size 引用from typing import Optional class _TimesFM: def __init__(self, context_len: int 32): self.context_len context_len # 重构后改名 # 注意没定义 self.window_size def forecast(self, series, context_len: Optional[int] None, horizon_len: int 16): # 新签名只用 context_len ctx context_len or self.context_len # 有 bug某分支残留了对旧属性的引用 effective getattr(self, window_size, None) # 若有人写 self.window_size 会 AttributeError if effective is None: effective ctx return fforecast ctx{effective} horizon{horizon_len} def _buggy_branch(self): # 模拟重构遗漏直接引用已删除的属性 return self.window_size # AttributeError # 复现现象 A传 window_size 给新签名 m _TimesFM() try: m.forecast(series[1,2,3], window_size64) print(复现失败) except TypeError as e: print(复现成功(现象A):, e) # 复现现象 B内部残留 self.window_size try: m._buggy_branch() print(复现失败) except AttributeError as e: print(复现成功(现象B):, e) # 修正用 context_len print(修正:, m.forecast([1,2,3], context_len64))运行后传window_size触发TypeError现象 A_buggy_branch触发AttributeError现象 B修正为用context_len后正常复现并修复了两类的根因。五、解决方案第一层最小直接修复最快的止血调用时改用 2.5 的正确参数名context_len/horizon_len并给模型补一个window_size兼容属性若内部残留引用from timesfm import TimesFM # 1) 调用改用新参数名 model TimesFM.from_pretrained(google/timesfm-2.5) out model.forecast( seriesmy_series, context_len64, # 取代旧 window_size horizon_len32, # 预测长度 ) # 2) 若模型内部残留 self.window_size 引用现象 B # 在加载后补一个兼容属性property桥接 if not hasattr(model, window_size): # 用 property 把 window_size 映射到 context_len避免 AttributeError type(model).window_size property( lambda self: self.context_len, lambda self, v: setattr(self, context_len, v), )第一层让用户立刻消除TypeError/AttributeError用正确的context_len跑预测。六、解决方案第二层结构性改进用TimesFMParamAdapter把旧参数名window_size→ 新参数名context_len的兼容做进调用层旧代码无需改from dataclasses import dataclass from typing import Optional dataclass class TimesFMParamAdapter: 把旧 API 的 window_size 兼容映射到 TimesFM 2.5 的 context_len。 default_context_len: int 32 def normalize(self, kwargs: dict) - dict: # 兼容window_size - context_len if window_size in kwargs: kwargs.setdefault(context_len, kwargs.pop(window_size)) # 确保 context_len 有值 kwargs.setdefault(context_len, self.default_context_len) return kwargs def ensure_attr(self, model): # 给模型补 window_size property桥接到 context_len消除内部 AttributeError if not hasattr(type(model), window_size): type(model).window_size property( lambda self: self.context_len, lambda self, v: setattr(self, context_len, v), ) return model # 使用旧代码不动 adapter TimesFMParamAdapter(default_context_len64) adapter.ensure_attr(model) # 旧调用方式继续可用 out model.forecast(seriesmy_series, window_size64) # adapter 已桥接 # 实际上应在调用前归一化 kwargs kwargs adapter.normalize({series: my_series, window_size: 64}) out model.forecast(**kwargs)TimesFMParamAdapter的语义是API 改名不应破坏旧调用用适配层把window_size映射到context_len并补属性桥接旧代码零修改即可运行。七、解决方案第三层断言 / CI 守护用 pytest 固化forecast 接受 context_len、window_size 被兼容映射、内部不引用缺失属性import pytest def test_window_size_maps_to_context_len(): from tfm_adapter import TimesFMParamAdapter a TimesFMParamAdapter() kw a.normalize({series: [1,2,3], window_size: 64}) assert window_size not in kw assert kw[context_len] 64 def test_ensure_attr_bridges_window_size(): from tfm_adapter import TimesFMParamAdapter class M: def __init__(self): self.context_len 32 m M() TimesFMParamAdapter().ensure_attr(m) # 像访问旧属性一样访问 window_size应桥接到 context_len assert m.window_size 32 m.window_size 64 assert m.context_len 64 def test_no_attribute_error_internally(): from tfm_adapter import TimesFMParamAdapter class M: def __init__(self): self.context_len 32 def use_window(self): return self.window_size # 内部残留引用 m M() TimesFMParamAdapter().ensure_attr(m) assert m.use_window() 32 # 不再 AttributeErrorCI 跑pytest tests/test_timesfm_window_size.py以后只要有人又把window_size当 kwarg 直接传或内部残留引用测试立刻红灯。八、排查清单当 TimesFM 2.5 报window_size相关错误按顺序查unexpected keyword argument window_size→ 2.5 改用了context_len调用改用新名。has no attribute window_size→ 内部残留旧属性引用用ensure_attr桥接context_len。预测长度/上下文不对 → 确认context_len/horizon_len传的是你想要的值而非旧默认。旧代码不想改 → 用TimesFMParamAdapter把window_size兼容映射到context_len。长期方案API 改名时保留兼容适配层adapter/property 桥接而非直接删参数。九、小结[TimesFM 2.5]: window_size argument raises AttributeError 的根因是TimesFM 2.5 把上下文窗口参数从window_size改名为context_len/horizon_len但调用方仍传旧名TypeError且内部某些分支残留对self.window_size的引用AttributeError属于API 改名缺向后兼容的典型。第一层调用改用context_len/horizon_len并给模型补window_sizeproperty 桥接立刻消除报错。第二层用TimesFMParamAdapter把window_size→context_len兼容映射 属性桥接做进调用层旧代码零修改。第三层pytest 断言window_size 被映射、属性桥接有效、内部不引用缺失属性防止回归。记住库的 API 改名时保留一层向后兼容适配参数重映射 旧属性 property 桥接比直接删参数更友好否则旧示例/旧代码会成片报 TypeError/AttributeError。