变更摘要

本 PR 主要对 PyPTO Pro 的语言层 API 声明与文档进行同步整理，核心是统一并内联类型标注：移除 _api.py 中的 Offset、Shape 类型别名，改为在各接口签名中直接使用 Union[List[int], int]、List[int]、Sequence[int] 等显式类型；同时将 TileType 构造函数的返回值标注为具体的 TileTypeDescriptor。相应的参数类型校验与错误信息测试也同步调整，以保证声明、校验和报错保持一致。

主要改动

• 移除类型别名 Offset 与 Shape: 在 _api.py 中删除 Offset = Union[List[int], int] 与 Shape = List[int]，接口签名改为内联显式类型。
• IO/搬运类接口参数类型内联: load、load_tile、store、store_tile 的 offsets/tile_offsets 及 move 的 offset 改为 Union[List[int], int] 或 Optional[Union[List[int], int]]。
• TileType 构造函数返回与形状参数调整: 引入 TileType as TileTypeDescriptor 别名，TileType 返回值由 Any 改为 TileTypeDescriptor，shape/valid_shape 改为 Sequence[int]。
• 其余接口与元数据接口改用显式类型: set_validshape、reinterpret、dump_data、make_tensor 的 shape/stride/shapes 改用 List[int]，并为 reinterpret 的 dtype、shape 增加 Optional 标注。
• 校验表与错误信息同步: _argument_checker.py 从 _LEAF_TYPES 中移除 Shape、Offset 条目并更新注释，test_error_format.py 中断言更新为 pl.TileType: shape expects Sequence[int], got int。

代码审查

✅ 未发现问题

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.

PR Approval Progress

✅ Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

💡 Tip:

• Committer can comment /approve or /lgtm
• Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

gcw_bTlukKC6, thanks for your pull request. All authors of the commits have signed the CLA. 👍

/approve
/lgtm

/approve