lanyuanxiaoyao
66472cbd86
重构命令行接口，建立清晰的子命令架构，提升用户体验和代码可维护性。 主要变更： - 移除传统模式，统一使用子命令架构（check/convert/preview） - 将 preview 从 convert 的标志独立为子命令，职责分离 - 重命名参数：--no-check → --skip-validation - 新增 --force/-f：convert 命令支持强制覆盖已存在文件 - 新增 --host：preview 命令支持配置主机地址（局域网预览） - 新增 --no-browser：preview 命令支持不自动打开浏览器 - 优化 --port 默认值：从固定端口改为随机端口（30000-40000） 破坏性变更： - 不再支持传统模式（yaml2pptx.py input.yaml output.pptx） - convert 命令不再支持 --preview 参数，需使用 preview 子命令 文档更新： - 更新 README.md 和 README_DEV.md 的所有使用示例 - 更新命令行选项说明表格 - 新增 CLI 接口规范文档 OpenSpec： - 创建 cli-interface 规范（新能力） - 更新 browser-preview-server 规范（修改的能力） - 归档 refactor-cli-args change（45/45 任务完成）
11 lines
963 B
YAML
11 lines
963 B
YAML
schema: spec-driven
|
||
|
||
context: |
|
||
本项目始终面向中文开发者，使用中文进行注释、交流等内容的处理，不考虑多语言；
|
||
本项目编写的python脚本和任何python命令都始终使用uv运行，脚本使用Inline script metadata来指定脚本的依赖包和python运行版本，命令使用uv run python -c "xxx"执行命令；
|
||
严禁直接使用主机环境的python直接执行脚本或命令，严禁在主机环境直接安装python依赖包；
|
||
本项目编写的测试文件、临时文件必须放在temp目录下；
|
||
严禁污染主机环境的任何配置，如有需要，必须请求用户审核操作；
|
||
当前项目的面向用户的使用文档在README.md；当前项目的面向AI和开发者的开发规范文档在README_DEV.md；每次功能迭代都需要同步更新这两份说明文档；
|
||
所有的文档、日志、说明严禁使用emoji或其他特殊字符，保证字符显示的兼容性；
|