mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 05:30:39 +08:00
yi-ge
1a50969b93
新增双核心 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>
2.7 KiB
2.7 KiB
pyenv（L4 社区方案）
仅在以下情况启用：
- 用户明确要求 pyenv（"用 pyenv 装"）
- 项目根目录已有
.python-version文件 - L1 (HTTP API) / L2 (Hatch CLI) / L3 (系统包管理器) 全部失败
如条件不满足，不要主动建议 pyenv——优先 DesireCore Hatch。
安装 pyenv
macOS / Linux
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）
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"
环境变量：
[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
# 列出可装版本
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
镜像加速
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 之前 |