market/README.md

# DesireCore Market

DesireCore 官方市场仓库，存放经过官方验证的 Agent 和 Skill 定义。

## 目录结构

```
.
├── manifest.json      # 仓库元数据
├── categories.json    # 分类配置
├── README.md          # 本文件
├── agents/            # Agent 定义目录
│   ├── task-master/
│   │   └── agent.json
│   ├── code-reviewer/
│   │   └── agent.json
│   ├── business-analyst/
│   │   └── agent.json
│   ├── writing-coach/
│   │   └── agent.json
│   ├── translator/
│   │   └── agent.json
│   └── data-analyst/
│       └── agent.json
└── skills/            # Skill 定义目录
    ├── web-search/
    │   └── skill.json
    ├── file-manager/
    │   └── skill.json
    ├── calendar-sync/
    │   └── skill.json
    ├── doc-parser/
    │   └── skill.json
    └── email-client/
        └── skill.json
```

## Agent 清单

| ID | 名称 | 分类 | 定位 |
|----|------|------|------|
| task-master | 任务管家 | 效率 | 智能任务规划与追踪专家 |
| code-reviewer | 代码审查官 | 开发 | 资深代码审查与质量把控 |
| business-analyst | 商业洞察师 | 商业 | 数据驱动的商业分析顾问 |
| writing-coach | 写作教练 | 创意 | 从构思到润色的写作伙伴 |
| translator | 译界通 | 沟通 | 跨文化沟通与专业翻译 |
| data-analyst | 数据洞察师 | 数据 | 数据科学与业务洞察专家 |

## Skill 清单

| ID | 名称 | 分类 | 风险等级 | 功能概述 |
|----|------|------|----------|----------|
| web-search | 网络搜索 | 效率 | 中 | 智能搜索与信息聚合 |
| file-manager | 文件管家 | 开发 | 高 | 本地文件系统管理 |
| calendar-sync | 日历同步 | 商业 | 中 | 日历服务连接与调度 |
| doc-parser | 文档解析器 | 数据 | 低 | 50+ 格式文档解析 |
| email-client | 邮件助理 | 沟通 | 高 | 智能邮件管理与起草 |

## 数据格式

### Agent 定义 (agents/{id}/agent.json)

```json
{
  "id": "string",
  "name": "string",
  "avatar": { "t": "string", "bg": "string" },
  "shortDesc": "string",
  "fullDesc": "string",
  "category": "productivity|development|business|creative|media|communication|data|management",
  "tags": ["string"],
  "version": "semver",
  "latestVersion": "semver",
  "updatedAt": "YYYY-MM-DD",
  "maintainer": { "name": "string", "verified": boolean },
  "downloads": number,
  "rating": number,
  "ratingCount": number,
  "installStatus": "not_installed",
  "persona": {
    "role": "string",
    "traits": ["string"],
    "tools": ["string"]
  }
}
```

### Skill 定义 (skills/{id}/skill.json)

```json
{
  "id": "string",
  "name": "string",
  "icon": "lucide-icon-name",
  "shortDesc": "string",
  "fullDesc": "string",
  "category": "productivity|development|business|creative|media|communication|data|management",
  "tags": ["string"],
  "version": "semver",
  "latestVersion": "semver",
  "updatedAt": "YYYY-MM-DD",
  "maintainer": { "name": "string", "verified": boolean },
  "downloads": number,
  "rating": number,
  "ratingCount": number,
  "installStatus": "not_installed",
  "riskLevel": "low|medium|high",
  "requires": {
    "tools": ["string"],
    "connections": ["string"]
  },
  "compatibleAgents": ["string"]
}
```

## 设计令牌

头像背景色使用 DesireCore 设计系统：

- **Green (#34C759)**: 效率、商业类
- **Blue (#007AFF)**: 开发、沟通类
- **Purple (#AF52DE)**: 创意、数据类

## 多语言（i18n）

仓库支持多语言展示与多语言 SKILL.md 正文。当前覆盖 `zh-CN`（简体中文，源语言）与 `en-US`（英文，默认 fallback），由 `manifest.json#supportedLocales` 声明。

- **作者只交一种语言**，CI 自动翻译为其余语言。CI 默认走 [GitHub Models](https://docs.github.com/en/github-models)（`openai/gpt-5-mini`，使用 repo 内置 `GITHUB_TOKEN` + `permissions: models: read`）；可切到 Anthropic Claude（设置 `vars.TRANSLATE_BACKEND=anthropic` 与 `secrets.ANTHROPIC_API_KEY`）。
- **顶层 `name` 字段为 ASCII slug**（== 目录名），中文显示名安放在 `metadata.i18n.zh-CN.name`，符合 [agentskills.io 规范](https://agentskills.io/specification)。
- **正文文件**：`SKILL.md`（默认语言）+ `SKILL.<locale>.md`（其他语言）兄弟文件。

工具：

```bash
# 校验 i18n 完整性
uv run scripts/i18n/validate-i18n.py

# 检查哪些 locale 缺翻译（不调 API）
uv run scripts/i18n/translate.py --check

# 本地翻译：默认 GitHub Models（需要 fine-grained PAT 含 Models: Read）
GITHUB_TOKEN=ghp_... uv run scripts/i18n/translate.py

# 切到 Anthropic Claude
TRANSLATE_BACKEND=anthropic ANTHROPIC_API_KEY=sk-ant-... \
  uv run scripts/i18n/translate.py
```

详细规范见 [docs/I18N.md](docs/I18N.md)。

## 许可证

MIT License - 详见 [LICENSE](LICENSE)