mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-06-06 05:50:41 +08:00

Files

xyx 4f7037a6b6 fix: replace hardcoded ~/.desirecore paths with ${DESIRECORE_ROOT} variable (#16 )

## Summary

- 将所有技能文件中的硬编码 `~/.desirecore/` 和 `$HOME/.desirecore/` 路径替换为
`${DESIRECORE_ROOT}/` 变量
- 递增 manifest.json version 至 1.2.1

## Why

dev 模式下 `DESIRECORE_HOME=~/.desirecore-dev`，硬编码路径导致技能读取错误的端口文件和目录。主仓库的
`variable-substitutor.ts` 会在运行时将 `${DESIRECORE_ROOT}` 替换为实际根目录。

## Test plan

- [ ] `npm run dev` 启动后触发任意技能，确认端口路径解析为
`~/.desirecore-dev/agent-service.port`
- [ ] prod 模式确认路径为 `~/.desirecore/agent-service.port`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

2026-05-29 15:36:19 +08:00

3.2 KiB

Raw Blame History

包管理器策略（npm / pnpm / yarn）

选型建议

场景	推荐
默认（Node.js 自带）	npm
磁盘高效 / 严格依赖 / monorepo	pnpm（推荐）
项目已用 yarn	yarn classic / berry
DesireCore 应用内	Volta 管理任何之上

通过 DesireCore Volta 安装

VOLTA=${DESIRECORE_ROOT}/runtime/volta/volta
export VOLTA_FEATURE_PNPM=1

"$VOLTA" install pnpm@latest
"$VOLTA" install yarn@latest
"$VOLTA" install npm@10

或 HTTP API：

BASE="https://127.0.0.1:$(cat ${DESIRECORE_ROOT}/agent-service.port)/api/runtime"
curl -sk -X POST "${BASE}/pkg/pnpm/install" -H "Content-Type: application/json" -d '{"version":"latest"}'

项目级固定版本

package.json#volta（首选）

{
  "volta": {
    "node": "22.11.0",
    "pnpm": "9.5.0"
  }
}

在装了 Volta 的环境中 cd 进项目即自动切换。

packageManager 字段（Corepack 标准）

{
  "packageManager": "pnpm@9.5.0"
}

由 Corepack（Node 16.10+ 自带）解析，被 npm/pnpm/yarn 自身识别。可与 Volta 共存。

npm 全局安装

不要用 sudo

错误：

sudo npm install -g pkg     # ❌ 文件 owner 变成 root，后续维护麻烦

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

npm install -g pptxgenjs docx

或用 Volta（自动隔离，无权限问题）：

volta install pptxgenjs   # ❌ Volta 不直接装库；只能装 CLI 工具
# 库依赖应通过项目 package.json 管理

pnpm 配置

# 全局存储位置（pnpm 单存储多链接的核心）
pnpm config get store-dir
# 默认 ~/.local/share/pnpm/store/v3

# 改 registry
pnpm config set registry https://registry.npmmirror.com/

# 全局安装路径（独立于 npm）
pnpm config get global-bin-dir

yarn 配置

# yarn classic
yarn config set registry https://registry.npmmirror.com/

# yarn berry
yarn config set npmRegistryServer https://registry.npmmirror.com/

镜像 / 代理

中国大陆加速

npm config set registry https://registry.npmmirror.com/
pnpm config set registry https://registry.npmmirror.com/
yarn config set registry https://registry.npmmirror.com/

恢复官方：

npm config set registry https://registry.npmjs.org/

公司代理

npm config set proxy http://proxy:port
npm config set https-proxy http://proxy:port

# 取消
npm config delete proxy
npm config delete https-proxy

私有 registry（Verdaccio / Nexus）

# 项目级（.npmrc）
@scope:registry=https://npm.company.com/
//npm.company.com/:_authToken=${NPM_TOKEN}

卸载与清理

# 全局列表
npm ls -g --depth=0
pnpm list -g --depth=0
yarn global list

# 卸载
npm uninstall -g pkg
pnpm uninstall -g pkg
yarn global remove pkg

# 清缓存
npm cache clean --force
pnpm store prune
yarn cache clean

环境快照

probe-node.sh 输出 volta_tools.{node,pnpm,yarn,npm} 列出所有 Volta 管理的版本，registry / proxy 来自 npm 配置。Skill 解析 JSON 即可判断是否需要切换镜像。

3.2 KiB Raw Blame History Unescape Escape