3gpp-tdocs 是一个围绕 3GPP 临时文档(TDoc,Temporary Documents)处理的技术技能模块。TDoc 是参与 3GPP 工作组和子工作组的成员在会议中产生的文档,包含提案、报告以及与 3GPP 标准制定相关的其他文档。
用途 该技能主要用于理解和处理 TDoc 的命名与识别规则,并支持从 FTP 目录抓取、解析 TDoc 文件等操作场景。
主要能力 资料列出了常见 TDoc 编号模式及对应工作组与子组,例如 R1-xxxx 对应 RAN 1、RP-xxxx 对应 RAN Plenary、S4-xxxx 对应 SA 4、SP-xxxx 对应 SA Plenary、C1-xxxx 对应 CT 1、CP-xxxx 对应 CT Plenary,并给出正则表达式 [RSC][1-6P].{4,10}.(zip|txt|pdf)。
该技能包含一个即用型模式模块 scripts/tdoc_pattern.py,为无第三方依赖的 PEP 723 脚本。它提供以下函数:is_valid_tdoc(filename) 用于对 TDoc 文件名做完整匹配校验;parse_tdoc(filename) 用于解析为 TdocMatch(tdoc_id, extension),并带有 .working_group/.subgroup 属性;normalize_tdoc_id(tdoc_id) 用于数据库查询时的大写规范化;infer_working_group_from_tdoc(tdoc_id) 用于由 R/S/C 推断 RAN/SA/CT。
使用方式 可直接运行脚本:mise x uv -- uv run scripts/tdoc_pattern.py;也可从脚本目录导入,例如 from tdoc_pattern import parse_tdoc,然后调用 parse_tdoc("r1-2301234.zip") 得到 TdocMatch(tdoc_id="R1-2301234", extension="zip"),并通过 match.working_group 与 match.subgroup 获取工作组与子组信息。
要点与限制 TDoc ID 大小写不敏感,数据库操作时应统一转为大写;绝大多数(99%+)TDoc 为 .zip 格式;FTP 文件可公开访问、无需认证;获取门户详细元数据需要 EOL 账号;抓取基础目录前应检查是否存在 Docs/、Documents/ 等子目录;应跳过 Inbox/、Draft/、Agenda/、Invitation/、Report/ 等非 TDoc 目录。
参考资料 技能附带的参考文档包括 references/tdoc-number-format.md(编号模式拆解、匹配与非匹配示例、TDoc 分配、ID 规范化、工作组推断)、references/tdoc-metadata.md(门户元数据字段、解析流程、元数据代码模式)、references/ftp-crawling.md(服务器结构、TDoc URL 模式、子目录检测、直接链接、抓取流程)。交叉参考包括 3gpp-working-groups、3gpp-meetings 与 3gpp-portal-authentication。相关资源包括 3GPP 官网 https://www.3gpp.org/、3GPP 门户 https://portal.3gpp.org/ 与 3GPP FTP https://www.3gpp.org/ftp/。