mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 08:10:48 +08:00
feat: 拆分 environment-setup 为 Python/Node.js 运行时双核心 + 父级路由
新增双核心 skill(深度集成 DesireCore Hatch/Volta + HTTP API + Socket.IO): - python-runtime v1.0.1:Python 运行时管理 · 四级降级:HTTP API → Hatch CLI 绝对路径 → 系统包管理器 → pyenv · references:hatch-desirecore / pyenv-fallback / virtualenv / troubleshooting · scripts/probe-python.sh:输出 JSON 快照供 Claude 解析决策 - nodejs-runtime v1.0.1:Node.js 运行时管理 · 四级降级:HTTP API → Volta CLI → 系统包管理器/NodeSource → nvm/fnm · references:volta-desirecore / nvm-fallback / package-managers / troubleshooting · scripts/probe-node.sh:输出 JSON 快照(含 volta_tools / package_json_volta 等) environment-setup → dev-environment-setup v2.0.1(重命名 + 重写为 router): - 从 1380 行手册瘦身为 ~150 行索引 - 仅负责容器(Docker/Podman)/ WSL2 / 办公依赖速查 / 系统工具 - references/desirecore-runtime.md 沉淀 Hatch/Volta 路径表 + HTTP API 速查 + Socket.IO 事件契约,作为两个核心 skill 的共享底座 - references/decision-tree.md 定义四级降级决策树 - scripts/probe.sh + probe.ps1 系统级 JSON 探测 三个 SKILL.md 的 L0 改为场景驱动结构(何时使用 / 何时不要用 / 怎么做), 让 AI 凭名字与 L0 即可判断匹配场景。 注册更新: - builtin-skills.json:新增 python-runtime / nodejs-runtime / dev-environment-setup (原 environment-setup 移除),按字母序,共 21 个 skill - manifest.json:totalSkills 19→21,lastUpdated 2026-05-02 下游同步: - docx / pdf / xlsx / pptx 中的环境引用从 environment-setup 拆分为 python-runtime / nodejs-runtime / dev-environment-setup 三向指引 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
97
skills/python-runtime/references/pyenv-fallback.md
Normal file
97
skills/python-runtime/references/pyenv-fallback.md
Normal file
@@ -0,0 +1,97 @@
|
||||
# pyenv(L4 社区方案)
|
||||
|
||||
仅在以下情况启用:
|
||||
1. 用户明确要求 pyenv("用 pyenv 装")
|
||||
2. 项目根目录已有 `.python-version` 文件
|
||||
3. L1 (HTTP API) / L2 (Hatch CLI) / L3 (系统包管理器) 全部失败
|
||||
|
||||
如条件不满足,**不要**主动建议 pyenv——优先 DesireCore Hatch。
|
||||
|
||||
## 安装 pyenv
|
||||
|
||||
### macOS / Linux
|
||||
|
||||
```bash
|
||||
curl https://pyenv.run | bash
|
||||
|
||||
# zsh
|
||||
cat >> ~/.zshrc <<'EOF'
|
||||
export PYENV_ROOT="$HOME/.pyenv"
|
||||
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
|
||||
eval "$(pyenv init -)"
|
||||
EOF
|
||||
|
||||
# bash
|
||||
cat >> ~/.bashrc <<'EOF'
|
||||
export PYENV_ROOT="$HOME/.pyenv"
|
||||
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
|
||||
eval "$(pyenv init -)"
|
||||
EOF
|
||||
|
||||
exec "$SHELL"
|
||||
```
|
||||
|
||||
#### 编译依赖
|
||||
|
||||
| 平台 | 命令 |
|
||||
|------|------|
|
||||
| macOS | `brew install openssl readline sqlite3 xz zlib tcl-tk` |
|
||||
| Ubuntu/Debian | `sudo apt install build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev curl git libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev` |
|
||||
| Fedora/RHEL | `sudo dnf install gcc make zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel tk-devel libffi-devel xz-devel` |
|
||||
|
||||
### Windows(pyenv-win)
|
||||
|
||||
```powershell
|
||||
pip install pyenv-win --target "$HOME\.pyenv"
|
||||
# 或
|
||||
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; & "./install-pyenv-win.ps1"
|
||||
```
|
||||
|
||||
环境变量:
|
||||
```powershell
|
||||
[System.Environment]::SetEnvironmentVariable('PYENV', "$HOME\.pyenv\pyenv-win", 'User')
|
||||
[System.Environment]::SetEnvironmentVariable('PYENV_HOME', "$HOME\.pyenv\pyenv-win", 'User')
|
||||
# 然后把 %PYENV%\bin 和 %PYENV%\shims 加入 PATH
|
||||
```
|
||||
|
||||
## 使用 pyenv
|
||||
|
||||
```bash
|
||||
# 列出可装版本
|
||||
pyenv install --list | grep "^ 3\."
|
||||
|
||||
# 安装
|
||||
pyenv install 3.12.4
|
||||
pyenv install 3.11.9
|
||||
|
||||
# 全局默认
|
||||
pyenv global 3.12.4
|
||||
|
||||
# 项目级(生成 .python-version)
|
||||
pyenv local 3.11.9
|
||||
|
||||
# 已装版本
|
||||
pyenv versions
|
||||
|
||||
# 当前激活
|
||||
pyenv version
|
||||
|
||||
# 卸载
|
||||
pyenv uninstall 3.10.14
|
||||
```
|
||||
|
||||
## 镜像加速
|
||||
|
||||
```bash
|
||||
export PYTHON_BUILD_MIRROR_URL="https://npmmirror.com/mirrors/python/"
|
||||
pyenv install 3.12.4
|
||||
```
|
||||
|
||||
## pyenv 常见问题
|
||||
|
||||
| 现象 | 排查 |
|
||||
|------|------|
|
||||
| `pyenv: command not found` | shell 配置未加载,`exec "$SHELL"` 或重启终端 |
|
||||
| 编译时 `ModuleNotFoundError: _ssl` | 缺 `libssl-dev` / `openssl`,按上方编译依赖安装 |
|
||||
| macOS Big Sur 编译失败 | `LDFLAGS="-L$(brew --prefix openssl)/lib" CPPFLAGS="-I$(brew --prefix openssl)/include" pyenv install 3.12.4` |
|
||||
| Windows pyenv 切换无效 | 检查 PATH 中 `%PYENV%\shims` 是否在系统 Python 之前 |
|
||||
Reference in New Issue
Block a user