mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-10-21 06:04:03 +08:00
Yige
8f7953948f
## 中文 补齐已有 owner 与已锁定上游内容可证明的许可证、技能类型和收录版本。保留 Anthropic Source Available 和其他附加条件，不把所有内容统一标为 MIT，不提升 listing-only 的安装准入。 README 保留最新的双语结构及以 manifest 为准的数量口径，增加静态目录不存访问量、下载量、评分或 Stars 的边界。 发布兼容性：**本 PR 不包含**两支团队新增的本地化字段，也不包含微信支付 `latestVersion: 1.0`；旧客户端会拒绝这些新字段，另以待发布 PR 保留，等匹配客户端发布后再合并。 验证：47 项目录校验测试、19 项 i18n 测试、5 项合集生成测试通过；完整目录/i18n/翻译新鲜度检查通过，6 个固定来源合集的生成检查通过，2 个浮动来源按既有规则明确跳过。发现并修复了生成器在 Windows 使用反斜杠造成的误报：输出改为 POSIX 路径，比较规则不放宽、不重写合集数据。 ## English Fill only license, type and listed-release facts supported by existing owners or pinned upstream content. Preserve custom license restrictions and acquisition eligibility. Keep the current bilingual README and manifest-derived inventory; do not author usage analytics. This PR deliberately excludes localized team fields and the two-part WeChat Pay version that older clients reject. Those changes remain pending a compatible client release. Validation passes: 47 catalog-validator tests, 19 i18n tests, five collection-generator tests, complete catalog and translation checks, and generated inventory checks for six pinned collections. Two mutable sources remain explicitly skipped. Fix Windows-generated path separators without weakening comparison or changing declared children.
9.5 KiB
9.5 KiB
license, name, description, version, type, risk_level, status, disable-model-invocation, tags, metadata, market
| license | name | description | version | type | risk_level | status | disable-model-invocation | tags | metadata | market | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| MIT | nodejs-runtime | Use this skill when the user needs to install, upgrade, or troubleshoot Node.js, npm, pnpm, yarn, and JavaScript/TypeScript runtime environments. Covers four-tier fallback strategy: (1) DesireCore HTTP API for in-app installation, (2) DesireCore built-in Volta CLI for Node.js + package manager version management, (3) system package managers (brew/apt/dnf/winget/NodeSource), (4) community nvm/fnm as last resort. Also covers global package management, npm registry/proxy configuration, EACCES permission errors, and PATH troubleshooting. Triggers include: "install node", "node not found", "npm not found", "npm EACCES", "pnpm", "yarn", "volta", "nvm", "fnm", "nodejs version", "package-lock", or any Node.js / npm runtime error. 使用场景：用户需要 安装 Node.js、安装 npm、 pnpm、yarn、配置全局包、解决 EACCES、PATH 问题、镜像/代理配置。 | 1.0.3 | procedural | low | enabled | true |
|
|
|
nodejs-runtime Skill
L0: One-line Summary
When to use: the user needs to install Node.js / upgrade Node / switch Node multi-version / install or configure
npm / pnpm / yarn / troubleshoot node: command not found, npm: command not found,
EACCES global install permission errors, node-gyp build failures, registry mirror / proxy issues, or other
Node.js runtime problems, or when other skills (pptx using pptxgenjs, etc.) report "Node.js unavailable".
How: prefer the DesireCore built-in Volta and follow a four-tier fallback (HTTP API → Volta CLI → system package manager brew/apt/NodeSource/winget → community options nvm/fnm).
L1: Overview and Use Cases
Capability Description
Procedural skill. Before each Node.js environment operation, run scripts/probe-node.sh to obtain a JSON snapshot, then choose a path according to the four-tier fallback in ../dev-environment-setup/references/decision-tree.md.
Use Cases
- "node not found" / "npm not found"
- The user requests to install/upgrade Node.js
- Multi-version switching (based on
package.json#voltaor.nvmrc) - Install/manage pnpm / yarn / npm
- "EACCES: permission denied" (npm global install permission error)
- Configure registry / proxy
- Other skills (pptx, etc.) report Node.js unavailable
Core Value
- DesireCore first: Volta + HTTP API as L1/L2, avoiding pollution of the system Node
- JSON-driven decisions: the probe script outputs structured data that Claude can parse directly
- package.json#volta compatible: Volta automatically switches versions per project
L2: Detailed Specification
Step 1: Environment Probe (mandatory)
bash skills/nodejs-runtime/scripts/probe-node.sh > /tmp/node-probe.json
cat /tmp/node-probe.json | jq .
See ../dev-environment-setup/references/probe-snapshot.md for field definitions.
Step 2: Choose an Execution Path
| Condition | Path |
|---|---|
desirecore_api non-empty |
L1 HTTP API |
desirecore_api empty, volta_path non-empty |
L2 Volta CLI |
| Neither of the above | L3 System package manager (brew / apt / NodeSource / winget) |
| L1–L3 all fail or user explicitly requests | L4 Community options (nvm / fnm) |
Step 3: Execute (only the main path is shown; see each reference for details)
L1: HTTP API (→ references/volta-desirecore.md)
PORT=$(cat ${DESIRECORE_ROOT}/agent-service.port)
BASE="https://127.0.0.1:${PORT}/api/runtime"
# 列出可装版本
curl -sk "${BASE}/node/available"
# 触发安装（异步）
curl -sk -X POST "${BASE}/node/install" \
-H "Content-Type: application/json" \
-d '{"version":"22"}'
# 安装包管理器
curl -sk -X POST "${BASE}/pkg/pnpm/install" \
-H "Content-Type: application/json" \
-d '{"version":"latest"}'
# 完成后刷新缓存
curl -sk -X POST "${BASE}/environment/refresh"
L2: Volta CLI Absolute Path (→ references/volta-desirecore.md)
VOLTA=${DESIRECORE_ROOT}/runtime/volta/volta
export VOLTA_HOME=${DESIRECORE_ROOT}/runtime/volta
export VOLTA_FEATURE_PNPM=1
"$VOLTA" install node@22
"$VOLTA" install pnpm@latest
"$VOLTA" install yarn@latest
"$VOLTA" list all
# 项目级固定（修改 package.json#volta）
"$VOLTA" pin node@22 pnpm@9
Windows: %USERPROFILE%\.desirecore\runtime\volta\volta.exe.
L3: System Package Manager
| Platform | Command |
|---|---|
| macOS | brew install node |
| Debian/Ubuntu | NodeSource: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install nodejs |
| Fedora/RHEL | curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - && sudo dnf install nodejs |
| Arch | sudo pacman -S nodejs npm |
| Windows | winget install OpenJS.NodeJS.LTS |
L4: nvm / fnm (→ references/nvm-fallback.md)
Only enable when explicitly requested by the user or when the above fail.
Step 4: Package Manager Strategy
See references/package-managers.md for details:
- pnpm (recommended, disk-efficient, strict dependencies)
- yarn (Berry / Classic)
- npm (default, ships with Node.js)
- Project-level
package.json#voltaautomatic switching
Step 5: Troubleshooting
See references/troubleshooting.md for details:
- npm EACCES permission errors (do not use sudo npm)
- registry / proxy configuration
- node-gyp build failures
- "node: command not found" when nvm is installed
Important Constraints
- Never
sudo npm install -g: use a user-level prefix or Volta/nvm. - Refresh after modifying the environment: for L1, call
POST /api/runtime/environment/refresh; for other paths, re-run the probe. - Cross-skill collaboration: when
pptxand others need Node.js, install via this skill's main path; for npm package quick reference, see../dev-environment-setup/references/office-deps.md. - Respect package.json#volta: when this field is detected, prefer Volta — do not switch to nvm.
References
- Decision tree:
../dev-environment-setup/references/decision-tree.md - DesireCore foundation:
../dev-environment-setup/references/desirecore-runtime.md - Probe protocol:
../dev-environment-setup/references/probe-snapshot.md - Office dependencies (npm packages):
../dev-environment-setup/references/office-deps.md