feat: 准备对env重新设计

This commit is contained in:
2025-12-14 03:30:28 +08:00
parent 4f2ecebc64
commit 9f44d87544
2 changed files with 64 additions and 0 deletions

9
statements/1.md Normal file
View File

@@ -0,0 +1,9 @@
1. 首先阅读 @statements/optimize.md还有 @README.md 并根据其指引了解跟aide env有关的所有信息
2. 我想对aide env的一些行为和参数进行调整但是我暂时没有很好的思路关于具体的参数命名和数据格式应该如何设计
3. 我想做的调整可以参考 @statements/example-1.md ,注意:
1. proc是旧的命名现已确认更名为aide
2. 里面的所有内容仅能做大意参考,不要被参考内容中出现的子命令名、参数名、参数数据形式、数据文件名等所限制,
你是一位拥有丰富经验的资深软件工程师、系统架构师、人体工程学设计师
我希望你从参考文档example-1中提取大意深度思考全面分析全力发挥你的专业能力和创造力引导我对aide env进行重新设计和开发

55
statements/example-1.md Normal file
View File

@@ -0,0 +1,55 @@
proc environment manager
## 说明
`proc`是一个已经被用户正确安装的程序,可以像`ls``cd``cat``curl`等常用命令一样通过`proc`这个命令名直接随时调用而无需关心其安装路径和程序配置,
proc是一套针对性设计用于专业步骤流程的程序系统的访问入口
可通过`proc`访问其一系列子程序,例如现在将要具体学习的`proc env``env`子项专用于处理项目开发时的开发环境情况问题,
## 行为与用例
> 下方代码片段是用空行分隔的多组命令调用示例每一段注释后直到下一个空行前的一条或多条shell命令是一组同一组的命令是等效的通常较短的命令是其他长命令的参数缺省形式
```bash
# 对于已启用的项目python、jdk、gcc、cmake、cargo、rustc、uv、nodejs等检测其环境的可用性及版本由默认配置或工作目录下的默认环境配置文件决定启用哪些项目的检测
proc env
proc env check
proc env check --all
proc env check --all --env-config ./env-config.toml
# 这一组(也包括下一组`proc env show`)中的`--env-config`选项需要一个文件路径参数用于指定环境配置文件,其默认值是工作目录下的`./env-config.toml`
# 列出所有支持的环境模块并显示:
# 1.当前配置下该环境检测模块是否启用
# 2.该模块支持的操作有些模块可能仅支持check而不支持ensure操作
proc env show
proc env show --all
proc env show --all --env-config ./env-config.toml
# 支持的参数选项同上,运行所有已启用的环境模块检测其环境的可用性及版本,当目标环境不可用时尝试按既定程序修复环境,仅当所有修复都失败时输出失败消息
proc env ensure
# 运行指定的环境模块检测其环境的可用性及版本,且不论其是否已在环境配置中启用
proc env check --spec ['python']
proc env check --spec ['java','rust','uv']
# 这一组中的`--spec`选项需要一个字符串列表参数(即使只有一项),支持的选项可通过`proc env show`获取
# 运行指定的环境模块检测其环境的可用性及版本,且不论其是否已在环境配置中启用,当目标环境不可用时尝试按既定程序修复环境,仅当所有修复都失败时输出失败消息
proc env ensure --spec ['python']
proc env ensure --spec ['java','rust']
```
## IO约定与示例
- env子项仅支持[行为与用例](#行为与用例)中所示的参数选项,不支持动态输入其他参数值
- 输出前缀:
- 成功:✓
- 警告:⚠
- 失败:✗
### 输出示例
```
✓ 虚拟环境可用: /home/user/.local/pro-process-program/.venv/bin/python
```