PPTX/openspec/changes/archive/2026-03-02-migrate-to-uv-package-management/proposal.md at 124ef0e5ce2206a25b4b0cecaa8fdfae3d949fbf

Files

lanyuanxiaoyao 027a832c9a chore: migrate to uv pyproject.toml for dependency management

- Add pyproject.toml with project dependencies
- Remove inline script metadata from yaml2pptx.py
- Update openspec/config.yaml development guidelines
- Update README.md and README_DEV.md documentation
- Archive change: migrate-to-uv-package-management

2026-03-02 22:03:23 +08:00

1.3 KiB

Raw Blame History

Why

当前项目使用 Inline script metadata 模式在 yaml2pptx.py 中指定依赖，这种方式在单文件脚本场景下有效，但随着项目模块化架构的发展，依赖管理需要在项目层面统一管理。迁移到 uv 的原生依赖管理模式（pyproject.toml）是更标准、更可维护的做法。

What Changes

BREAKING: 移除 yaml2pptx.py 中的 Inline script metadata（第 2-10 行）
新增 pyproject.toml 文件，使用 uv 的标准依赖管理格式
更新 openspec/config.yaml 中的开发规范说明（移除 inline metadata 相关描述）
更新 README.md 文档中的依赖管理说明
用户命令使用方式保持不变（仍然使用 uv run yaml2pptx.py ...）

Capabilities

New Capabilities

无新增功能能力。本次变更仅改变依赖管理的内部实现方式。

Modified Capabilities

无需修改现有 spec。用户视角的 CLI 行为、API 接口、功能特性均保持不变。

Impact

yaml2pptx.py: 移除第 2-10 行的 inline metadata
pyproject.toml: 新增项目依赖配置文件
openspec/config.yaml: 更新开发规范（移除 "脚本使用Inline script metadata" 描述）
README.md: 更新依赖管理说明
README_DEV.md: 可能需要同步更新开发规范说明

1.3 KiB Raw Blame History Unescape Escape

Why