mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-07-23 03:03:45 +08:00
5b7708a6126e5528ba4fd46a9c89257127382bf0
## 概述 / Summary 把 market 从「内容仓库」转型为「元数据注册表」的仓库侧改动,配合客户端 PR [desirecore/desirecore#919](https://github.com/desirecore/desirecore/pull/919) 与 [ADR-038](https://github.com/desirecore/desirecore-docs/blob/main/技术/决策/ADR-038-市场元数据注册表与两层技能模型.md)。 原则:market 只放元数据、不放第三方内容;内置技能仍 bundled(有界例外)。每条第三方条目用 `entry.json`(元数据 + `source` 指针),正文放各自源仓库、安装时按需获取。 ## 改动 / Changes ### S10 — minimax 迁出为官方独立仓库 - `minimax-image-gen` / `minimax-tts`(均 `author=desirecore`)迁至新建的官方开源仓库 **[desirecore/skills-minimax](https://github.com/desirecore/skills-minimax)**(MIT,monorepo, 一仓多技能)。 - market 改用 `skills/<id>/entry.json` 的 pointer 引用(`source.path` 指入子目录,`ref` 锁定 commit `6e39eee`),删除内联 `SKILL.md`。 ### S11 — 许可署名合规 - 新增根 `LICENSE`(MIT)与 `THIRD_PARTY_NOTICES.md`。 - 标注 Anthropic **docx/pdf/pptx/xlsx 为 source-available(非开源、仅供演示参考)**、 frontend-design 等为 Apache-2.0;每条 entry 的 `license`/`redistribution` 为单条真相源。 ### S12 — 外部技能改为纯 pointer(取代 #32 的 vendoring) - 把 [#32](https://github.com/desirecore/market/pull/32) 的 10 个外部技能写成 `entry.json` pointer(**不再 vendor 上游源码**): - MIT/MIT-0 → `partner`/`community` + `allowed` - 无声明许可(meituan / netease)→ `pointer` + `source-pointer-only` - luckin 打包产物 → `pointer` + `verify-package-terms`(`source.kind=zip`) ## 说明 / Notes - 外部条目的 `name`/`category` 为基于上游 URL 的合理初值,后续可随上游元数据完善。 - 客户端(#919)已支持 `entry.json` 读/装与体积守护栏;本 PR 合并后,主仓库需重新 `npm run sync-market` 重打包 `defaults/market.zip`。 > 注:`follow-builders`(zarazhangrui/follow-builders, MIT)是 #32 `external-skills.json` 外部技能集合中的一员,属本次迁移范畴,非额外引入。 Co-authored-by: yi-ge <jackyoncode@gmail.com>
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)
{
"id": "string",
"name": "string",
"avatar": { "t": "string", "bg": "string" },
"shortDesc": "string",
"fullDesc": "string",
"category": "productivity|development|business|creative|communication|data",
"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)
{
"id": "string",
"name": "string",
"icon": "lucide-icon-name",
"shortDesc": "string",
"fullDesc": "string",
"category": "productivity|development|business|creative|communication|data",
"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(
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 规范。 - 正文文件:
SKILL.md(默认语言)+SKILL.<locale>.md(其他语言)兄弟文件。
工具:
# 校验 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。
许可证
MIT License - 详见 LICENSE
Languages
Python
74%
HTML
23%
Shell
1.6%
JavaScript
1%
PowerShell
0.4%