mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-07-23 07:03:51 +08:00

Files

Yige 329fb5fed1 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 发布；旧客户端调用该端点仍只清检测缓存（不报错），文档短暂超前可接受

2026-06-09 11:27:13 +08:00

10 KiB

Raw Blame History

name, description, version, type, risk_level, status, disable-model-invocation, tags, metadata, market

name

description

version

type

risk_level

status

disable-model-invocation

tags

metadata

market

dev-environment-setup

Use this skill as a router/index when the user faces a development environment question that spans multiple domains: containers (Docker/Podman), WSL2 on Windows, office-skill dependencies (DOCX/PDF/XLSX/ PPTX), or system tools (LibreOffice/Poppler/Pandoc/Tesseract). For pure Python issues use python-runtime skill; for pure Node.js issues use nodejs-runtime skill. Triggers include: "setup environment", "PATH", "WSL", "WSL2", "docker not found", "podman", "container", "office dependency", "LibreOffice", "poppler", "pandoc", "tesseract", or any cross-cutting environment question. 使用场景：用户提到环境配置、PATH、容器、Docker、Podman、WSL、WSL2、办公依赖、系统工具，或不确定属于 Python / Node.js 时的入口指引。

2.0.4

procedural

low

enabled

true

environment

docker

container

wsl

office

system-tools

router

author

updated_at

i18n

desirecore

2026-06-09

default_locale

source_locale

locales

zh-CN

en-US

zh-CN

en-US

name	short_desc	description	body	source_hash	translated_by
开发环境综合配置	开发环境综合入口（容器 / WSL / 办公依赖 / 系统工具）	Use this skill as a router/index when the user faces a development environment question that spans multiple domains: containers (Docker/Podman), WSL2 on Windows, office-skill dependencies (DOCX/PDF/XLSX/ PPTX), or system tools (LibreOffice/Poppler/Pandoc/Tesseract). For pure Python issues use python-runtime skill; for pure Node.js issues use nodejs-runtime skill. Triggers include: "setup environment", "PATH", "WSL", "WSL2", "docker not found", "podman", "container", "office dependency", "LibreOffice", "poppler", "pandoc", "tesseract", or any cross-cutting environment question. 使用场景：用户提到环境配置、PATH、容器、Docker、Podman、WSL、WSL2、办公依赖、系统工具，或不确定属于 Python / Node.js 时的入口指引。	./SKILL.zh-CN.md	sha256:748e754b5537ea01	human

name	short_desc	description	body	source_hash	translated_by	translated_at
Dev Environment Setup	Unified dev environment entry (container / WSL / office deps / system tools)	Use this skill as a router/index when the user faces a development environment question that spans multiple domains: containers (Docker/Podman), WSL2 on Windows, office-skill dependencies (DOCX/PDF/XLSX/ PPTX), or system tools (LibreOffice/Poppler/Pandoc/Tesseract). For pure Python issues use python-runtime skill; for pure Node.js issues use nodejs-runtime skill. Triggers include: "setup environment", "PATH", "WSL", "WSL2", "docker not found", "podman", "container", "office dependency", "LibreOffice", "poppler", "pandoc", "tesseract", or any cross-cutting environment question. Use when the user mentions environment setup, PATH, containers, Docker, Podman, WSL, WSL2, office dependencies, system tools, or needs an entry-point guide when uncertain whether the issue belongs to Python or Node.js.	./SKILL.md	sha256:748e754b5537ea01	human	2026-06-09

icon

dev-environment-setup Skill (v2.0.0 router)

L0: One-line Summary

When to use: The user needs to

Install / troubleshoot Docker or Podman containers ("docker not found", daemon startup, registry mirror, etc.)
Configure WSL2 (Linux Subsystem) on Windows
One-shot install of office skill dependencies (Python packages + npm packages + system tools required by DOCX / PDF / XLSX / PPTX)
Install system tools: LibreOffice / Poppler / Pandoc / Tesseract / qpdf / ImageMagick / Ghostscript / Git
Uncertain whether the issue belongs to Python or Node.js, and a comprehensive diagnosis is needed first

When not to use: Use python-runtime for pure Python issues, and nodejs-runtime for pure Node.js issues.

How to do it: First run scripts/probe.sh (use probe.ps1 on Windows) to obtain a system snapshot JSON, and route to the corresponding references or sub-skill based on the result; this skill is also the source of truth for DesireCore's built-in Hatch / Volta / HTTP API / Socket.IO integration (references/desirecore-runtime.md).

L1: Routing Rules

Route directly to the corresponding skill or document by the keywords in the user's question:

Keyword / Scenario	Path
python / pip / venv / pyenv / hatch / virtualenv / PEP 668	`python-runtime` skill
node / npm / pnpm / yarn / volta / nvm / fnm / EACCES	`nodejs-runtime` skill
docker / podman / container / container daemon	`references/container.md`
WSL / WSL2 / Windows Linux Subsystem	`references/wsl.md`
DOCX / PDF / XLSX / PPTX dependencies / office skill dependencies	`references/office-deps.md`
LibreOffice / poppler / pandoc / tesseract / qpdf	`references/system-tools.md`
Unsure of category, want a quick diagnosis	First run `scripts/probe.sh` and inspect the JSON
DesireCore Hatch / Volta / HTTP API / Socket.IO	`references/desirecore-runtime.md`
User edited `.zshrc` / an env var / proxy / `setx`, but tools can't see it	`POST /api/runtime/environment/refresh` reloads the login environment (see `references/desirecore-runtime.md` §7, no app restart needed)
Four-tier fallback decision (API → CLI → package manager → community solution)	`references/decision-tree.md`

L2: Detailed Specification

Step 1: Quick Diagnosis

bash skills/dev-environment-setup/scripts/probe.sh > /tmp/env-probe.json
cat /tmp/env-probe.json | jq .

For the meaning of output fields, see references/probe-snapshot.md. On Windows use scripts/probe.ps1.

Step 2: Route by Result

desirecore_api non-empty → take the HTTP API path (references/desirecore-runtime.md)
tools.python3.available = false or tools.node.available = false → enter the corresponding sub-skill
tools.docker.available = false and the user needs containers → references/container.md
wsl.installed = false and Windows user → references/wsl.md

Step 3: Execute the Sub-skill Decision Tree

Both python-runtime and nodejs-runtime have their own four-tier fallback (L1 API → L2 built-in CLI → L3 system package manager → L4 community solution), defined in the shared references/decision-tree.md.

Step 4: Office Skill Dependencies

Quick lookup for the office quartet (DOCX / PDF / XLSX / PPTX) dependencies: references/office-deps.md. Includes one-shot install commands for Python packages, npm packages, and system tools.

Step 5: System Tools

Installation and troubleshooting for LibreOffice / Poppler / Pandoc / Tesseract / qpdf / ImageMagick / Ghostscript: references/system-tools.md.

DesireCore Built-in Environment Management Base

DesireCore embeds Hatch (Python) and Volta (Node.js), providing complete environment management via HTTP API + Socket.IO. This skill and the sub-skills (python/nodejs) all rely on:

Document	Content
`references/desirecore-runtime.md`	Binary path table, HTTP API quick-reference, Socket.IO event contracts, `EnvironmentSnapshot` data structure
`references/decision-tree.md`	Four-tier fallback flowchart, concrete signals for failure detection, switch prompts
`references/probe-snapshot.md`	Probe script JSON output protocol

Important Constraints

Do not write strong keywords like python / node / pip / npm into this skill's description—those belong to their respective sub-skills, to avoid trigger conflicts.
API first: scripts/probe.sh first checks ${DESIRECORE_ROOT}/agent-service.port; if it exists, recommend the HTTP API path.
Cache coherence + env reload: after any install/uninstall completes, call POST /api/runtime/environment/refresh to invalidate the cache before subsequent GETs; the same endpoint also reloads login environment variables (re-reads .zshrc / registry and precise-syncs into process.env), so when a user reports a freshly-changed env var that tools can't see, call it proactively too (no app restart; the returned envDiff confirms the changes).
Cross-platform: every command template provides both macOS / Linux and Windows (PowerShell) versions.

Sub-skill and Document Manifest

skills/
├── python-runtime/        # Python environment (Hatch first)
├── nodejs-runtime/        # Node.js environment (Volta first)
└── dev-environment-setup/         # This skill (composite entry)
    ├── references/
    │   ├── desirecore-runtime.md
    │   ├── decision-tree.md
    │   ├── probe-snapshot.md
    │   ├── container.md
    │   ├── wsl.md
    │   ├── office-deps.md
    │   └── system-tools.md
    └── scripts/
        ├── probe.sh
        └── probe.ps1

Upgrade Notes (v1.x → v2.0.0)

v1.x was a 1380-line all-in-one manual, now split.
Python-related → python-runtime
Node.js-related → nodejs-runtime
Docker / WSL / office dependencies / system tools → this skill's references/
DesireCore Hatch / Volta upgraded from "optional community solution" to mandatory L1/L2 primary path

Downstream skills (docx / pdf / xlsx / pptx) should rewrite "for Python environment issues, see dev-environment-setup" to "for Python environment issues, see python-runtime / for Node.js environment issues, see nodejs-runtime".

10 KiB Raw Blame History Unescape Escape