docs(dev-environment-setup): /environment/refresh 补充重新加载登录环境变量语义 (#24)

## 变更说明 / Description

配合客户端 PR
[desirecore/desirecore#808](https://github.com/desirecore/desirecore/pull/808):`POST
/api/runtime/environment/refresh` 端点现在除清检测缓存外,还会**重新抓取登录 shell / Windows
注册表环境并精确同步到 `process.env`**。本 PR 更新 `dev-environment-setup` skill 文档,让
AI 在「用户改了 `.zshrc` / `setx` 但工具看不到」时能主动调用该端点(无需用户重启 App)。

Companion to client PR desirecore#808: the `/environment/refresh`
endpoint now also reloads login-shell / Windows-registry env and
precise-syncs into `process.env`. This PR updates the
`dev-environment-setup` skill docs so the AI proactively calls it when a
user reports a freshly-changed env var that tools can't see.

## 改动 / Changes

- `references/desirecore-runtime.md`:第三节端点表更新 + 第七节扩展(重新加载语义 + `envDiff`
返回结构 + 「何时主动调用」触发场景 + 局限)
- `SKILL.md` / `SKILL.zh-CN.md`:L1 路由表新增「用户改了 `.zshrc` / 环境变量 / 代理 /
`setx` 但工具看不到 → 刷新端点」+ 重要约束第 3 条扩展(中英双语同步)
- `version` 2.0.3 → 2.0.4;并修正 #16 起遗留的 `source_hash` stale 值(`7e4baaf` →
`748e754b`,已用 `scripts/i18n` 同款算法验证)

## 说明 / Notes

- 该 skill 为 `translated_by: human`,中英两份已手动同步
- 文档描述的端点能力随客户端 PR desirecore#808 发布;旧客户端调用该端点仍只清检测缓存(不报错),文档短暂超前可接受
This commit is contained in:
2026-06-09 11:27:13 +08:00
committed by GitHub
parent 954891f9c2
commit 329fb5fed1
3 changed files with 32 additions and 11 deletions

View File

@@ -32,6 +32,7 @@ HTTP API / Socket.IO 集成的事实源(`references/desirecore-runtime.md`
| LibreOffice / poppler / pandoc / tesseract / qpdf | `references/system-tools.md` |
| 不确定属于哪类、想要快速诊断 | 先跑 `scripts/probe.sh` 看 JSON |
| DesireCore Hatch / Volta / HTTP API / Socket.IO | `references/desirecore-runtime.md` |
| 用户改了 `.zshrc` / 环境变量 / 代理 / `setx`,但工具看不到 | `POST /api/runtime/environment/refresh` 重新加载登录环境(见 `references/desirecore-runtime.md` 第七节,无需重启 App |
| 四级降级决策API → CLI → 包管理器 → 社区方案) | `references/decision-tree.md` |
## L2详细规范
@@ -78,7 +79,7 @@ DesireCore 内置 HatchPython和 VoltaNode.js通过 HTTP API + So
1. **不要把 python / node / pip / npm 强关键词写入本 skill description**——这些归属各自的子 skill避免触发冲突。
2. **API 优先**`scripts/probe.sh` 第一步检测 `${DESIRECORE_ROOT}/agent-service.port`;存在则推荐 HTTP API 路径。
3. **缓存协同**:任何安装/移除完成后,调 `POST /api/runtime/environment/refresh` 失效缓存再发后续 GET。
3. **缓存协同 + 重新加载环境**:任何安装/移除完成后,调 `POST /api/runtime/environment/refresh` 失效缓存再发后续 GET;该端点同时会重新加载登录环境变量(重抓 `.zshrc` / 注册表并精确同步到 `process.env`),故用户改了环境变量却反馈工具看不到时,也应主动调它(无需重启 App返回 `envDiff` 可向用户确认变更)
4. **跨平台**:所有命令模板提供 macOS / Linux + WindowsPowerShell双版本。
## 子 skill 与文档清单