南昌职业大学—校园文档格式转换 Skill
面向南昌职业大学师生的轻量级格式转换工具。在校园场景中，师生经常需要在不同格式之间转换文件：
课程作业需要从 TXT 转成 DOCX 或 PDF 提交、课表和成绩单需要在 CSV 和 XLSX 之间转换、
校园活动海报需要在 PNG/JPEG/WebP 之间切换、社团通知需要从 Markdown 转成 HTML 发布。
首次使用时自动在用户本地创建 Python 运行环境并安装依赖，不向 Skill 目录写入任何内容。
校园使用场景
| 场景 | 输入 | 目标格式 | 说明 |
|---|---|---|---|
| 课程作业提交 | TXT/Markdown | DOCX、PDF | 将手写笔记或 Markdown 草稿转为正式文档提交 |
| 课表/成绩单整理 | CSV | XLSX | 将教务系统导出的 CSV 转为 Excel 方便编辑 |
| 校园活动海报 | PNG/JPEG | WebP、PDF | 转换海报图片格式用于不同发布渠道 |
| 社团通知发布 | Markdown | HTML、PDF | 将 Markdown 通知转为网页或 PDF 分发 |
| 校园数据整理 | JSON/YAML | CSV、XLSX | 将结构化数据转为表格便于查阅 |
| PPT 资料转换 | TXT/Markdown | PPTX | 将文字素材快速转为演示文稿 |
| 图片素材适配 | BMP/TIFF | PNG/JPEG | 将不同来源的图片转为通用格式 |
操作方式
在 Windows 上使用 scripts/format-conversion.ps1。首次调用会在用户本地缓存目录创建 Python 环境并安装 requirements.txt 中的依赖包。
检查文件信息
转换前先检查文件类型和可用目标格式：
& "$PSScriptRoot\scripts\format-conversion.ps1" inspect --input "INPUT" --json
执行转换
将一个文件转换为目标格式：
& "$PSScriptRoot\scripts\format-conversion.ps1" transcode --input "INPUT" --target "FORMAT" --destination "OUTPUT" --json
检查运行环境
& "$PSScriptRoot\scripts\format-conversion.ps1" doctor --json
操作规则
- 使用绝对路径指定输入和输出文件。
- 从 JSON 响应的
outputs[].path读取实际输出路径，不要猜测文件名。 - 默认不覆盖已有文件；仅在用户明确允许时添加
--overwrite参数。 - 文档转换保留可读内容和表格结构，不保证 Office 排版完全一致。
- 首次使用若依赖安装失败，确认网络可用后运行
scripts/bootstrap.ps1。 - 参考 references/formats.md 了解支持的格式路线。
- 参考 references/portability.md 了解打包和移植方式。
