Nop File Converter
Documentsnop-file-converterNop File Converter is an Agent Skill for documents published in the entropy-cloud/nop-entropy repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
使用 NOP CLI 工具进行XLang模型文件格式转换，支持 XDSL 模型文件在不同格式（XML/JSON/YAML/XLSX）之间转换
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/entropy-cloud/nop-entropy/blob/HEAD/.opencode/skills/nop-file-converter/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/nop-file-converter, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
我会做什么
- 使用 NOP CLI 的
convert命令在不同 DSL 模型文件格式之间进行转换 - 支持 XML、JSON、YAML、XLSX 等格式之间的相互转换
- 从 Word 文档（docx）中提取附件（如图片）到指定目录
- 正确处理 Nop 框架的 fileType 概念，确保模型文件类型识别准确
什么时候用我
当用户要求进行以下操作时，直接使用本技能，无需额外探索代码库：
- 将 ORM 模型文件从 XLSX 转换为 XML（或反向）
- 将 API 模型文件在不同格式间转换（XML/JSON/YAML/XLSX）
- 转换任何 XDSL 模型文件的格式
本技能提供 nop-cli convert 命令的标准用法，已在技能描述中包含完整示例。
核心功能
文件格式转换
- 命令:
nop-cli convert - 参数:
inputFile: 输入文件路径（必填）-o: 输出文件路径（必填）-a: 附件目录路径（可选，用于 docx 文件）
重要概念：fileType
Nop 框架使用 fileType 来识别文件类型，与普通文件扩展名不同：
- 复合文件类型：对于
orm.xml、api.xlsx等文件名，fileType 取最后两个部分 - 简单文件类型：对于
xlsx、xml等文件名，fileType 就是文件扩展名
为什么重要：Nop 框架大量使用复合文件名（如 app.orm.xml），fileType 能区分普通文件和专用于特定模型的文件。ResourceComponentManager 根据 fileType 查找对应的 FileLoader，确保模型文件正确解析。
使用示例
转换 ORM 模型文件
nop-cli convert input.orm.xml -o output.orm.json
转换 API 模型文件
nop-cli convert input.api.xlsx -o output.api.yaml
转换 Word 文档并提取附件
nop-cli convert input.docx -o output.md -a media