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)
This commit is contained in:
2026-05-29 15:36:19 +08:00
committed by GitHub
parent 3015a3ffb8
commit 4f7037a6b6
52 changed files with 192 additions and 192 deletions

View File

@@ -162,10 +162,10 @@ POST /api/agents/{agentId}/skills
```bash
# 全局技能的 sidecar 文件路径
~/.desirecore/skills/{skillId}/{filename}
${DESIRECORE_ROOT}/skills/{skillId}/{filename}
# Agent 级技能的 sidecar 文件路径
~/.desirecore/agents/{agentId}/skills/{skillId}/{filename}
${DESIRECORE_ROOT}/agents/{agentId}/skills/{skillId}/{filename}
```
### 3. 通过 API 管理已有技能
@@ -291,7 +291,7 @@ Content-Type: application/json
**全局技能**(所有 Agent 可见):
```
~/.desirecore/skills/
${DESIRECORE_ROOT}/skills/
└── my-new-skill/
├── SKILL.md # 必须:技能定义文件
├── examples/ # 可选:示例文件
@@ -302,7 +302,7 @@ Content-Type: application/json
**Agent 级技能**(仅指定 Agent 可见):
```
~/.desirecore/agents/{agentId}/
${DESIRECORE_ROOT}/agents/{agentId}/
└── skills/
└── my-new-skill/
├── SKILL.md
@@ -381,7 +381,7 @@ requires:
以下示例展示如何使用 Write 工具创建一个全局技能:
```
目标路径:~/.desirecore/skills/daily-summary/SKILL.md
目标路径:${DESIRECORE_ROOT}/skills/daily-summary/SKILL.md
```
写入内容:
@@ -475,8 +475,8 @@ metadata:
| 优先级 | 作用域 | 路径 | 可见范围 |
| ------ | ---------- | ---------------------------------------- | ------------------ |
| 最高 | Project 级 | `.claude/skills/` (项目根目录) | 当前项目所有 Agent |
| 中 | Agent 级 | `~/.desirecore/agents/{agentId}/skills/` | 仅该 Agent |
| 最低 | Global 级 | `~/.desirecore/skills/` | 所有 Agent |
| 中 | Agent 级 | `${DESIRECORE_ROOT}/agents/{agentId}/skills/` | 仅该 Agent |
| 最低 | Global 级 | `${DESIRECORE_ROOT}/skills/` | 所有 Agent |
**同名覆盖规则**:高优先级作用域的同名技能会覆盖低优先级的。例如 Agent 级有一个 `data-analysis` 技能,会覆盖全局同名技能。