用途:分析 1С 包 XDTO 的结构,展示类型在 1С 语境下的填写方式,包括应赋的值类型、必填项、嵌套对象位置与允许取值,作为编写 XDTO 对象创建与填充代码前的准备步骤,替代阅读 Package.bin 或 XSD 时手工把 xs:decimal 换算为“数字”、把 lowerBound="0" 理解为非必填。
主要能力:根据路径判断入口,源根目录显示包列表(名称、类型数量、namespace),包目录显示导入、入口点与类型清单;给出指定类型的结构;可展开嵌套对象;可用 used-by 查看谁引用该类型,含相邻包。属性按代码填写方式呈现,值类型采用 1С 记法并含限制(如 Строка(6)、Число(18,2)),必填与集合以标记表示,枚举类型列出允许值,未标记属性即非必填。输出会对出现的不明显标记就地解释。
参数:PackagePath(必填,包目录或配置源根,别名 -Path);Namespace(按命名空间选包);Package(按元数据对象名选包);Name(类型名,不选包时在整配置内查找);Depth(嵌套展开深度,默认 1);RequiredOnly(只保留必填属性);Mode(used-by 显示引用方);Limit / Offset(分页,默认 150 行);OutFile(写入文件,UTF-8 BOM)。
使用方式:调用 powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-info.ps1" -PackagePath "<путь>"。典型流程:先列包,再按命名空间看入口与类型,再查具体类型结构;改动类型前用 used-by 评估影响。若已知命名空间和类型名但不知包名,可配合源根使用,例如对应 ФабрикаXDTO.Тип("urn:1C.ru:ClientBankExchange", "ПлатежныйДокумент") 的调用;只知类型名时给出 -Name 与源根,会跨包查找,多个匹配时提示位置以便确认。
适用场景:编写或修改 1С 中创建、填充 XDTO 对象的代码前;需要了解某类型填写要求或引用影响面时。
限制:需要 PowerShell 运行;需要提供可访问的包目录或配置源根;仅提供结构摘要,若需要 XML 架构本身应使用 /xdto-decompile。资料未提供许可、收费与具体平台兼容性等信息。