mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 08:30:42 +08:00
feat: skills i18n 改造（schemaVersion 1.1，零向后兼容） (#1)
* feat: skills i18n 改造 — schemaVersion 1.1，零向后兼容
把 21 个 skills + 1 个 agent + manifest/categories 全量迁移到 schemaVersion 1.1
的 i18n 结构，配套 CI AI 翻译流水线（GitHub Models）与本地工具链。
## 关键变更
### 数据结构（破坏性，schemaVersion 1.0 → 1.1）
- SKILL.md: 顶层 name 改为 ASCII slug（== 目录名，符合 agentskills.io 规范）；
中文显示名/short_desc/description 全部迁入 metadata.i18n.<locale>
- agents/<id>/agent.json: shortDesc/fullDesc/tags/persona.{role,traits} 迁入
i18n.<locale>；changelog[].changes 改为 { <locale>: string[] } 对象
- categories.json: 每个分类的 label/description 迁入 i18n.<locale>，顶层只剩
color/icon
- manifest.json: 加 supportedLocales / defaultLocale；顶层 description 迁入
i18n.<locale>
### Body 文件结构
- 根 SKILL.md = frontmatter + default_locale (en-US) body
- SKILL.<locale>.md = 各 locale 的 markdown body（首行 <!-- locale: xx --> 自校验）
### 工具链（scripts/i18n/）
- glossary.json: zh→en 术语表 + do_not_translate 白名单
- schema/skill-frontmatter.schema.json: i18n frontmatter JSON Schema
- validate-i18n.py: 8 条校验规则（name 合规 / locale 完整性 / hash 一致性等）
- translate.py: GitHub Models / Anthropic 双 backend，sha256 增量翻译
- migrate.py: 一次性迁移脚本（旧格式 → i18n 结构）
### CI（.github/workflows/）
- i18n-validate.yml: PR 触发跑 validate + translate --check
- i18n-translate.yml: PR 触发用 GitHub Models（默认 openai/gpt-5-mini）翻译缺失
locale，自动追加 commit；可切到 ANTHROPIC_API_KEY 走 Claude
### 文档
- docs/I18N.md: 作者贡献指南（schema 说明 / 提交流程 / 常见问题）
- README.md: 加多语言段落
## 验证
- uv run scripts/i18n/validate-i18n.py: OK，49 文件 0 错误
- uv run scripts/i18n/translate.py --check: 0 stale locale
- 21 skills 标题数 zh-CN == en-US 严格对齐（最大 66=66）
- skills-ref 规范校验：全部通过（顶层 name ASCII slug + description 单字段）
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(i18n): 修复 PR #1 review 反馈的 6 项问题
- schema: translated_by 正则放宽为 ^(human|ai:[A-Za-z0-9._:/-]+)$，接受
'ai:github:openai/gpt-5-mini' 这类 backend:model 形式（CI 翻译输出格式）
- README + docs/I18N.md: 修正"CI 用 Claude API"误导描述，正确说明默认是
GitHub Models（openai/gpt-5-mini）+ GITHUB_TOKEN，可选切到 Anthropic
- skills/minimax-tts/SKILL.md & SKILL.zh-CN.md: 删除多余的 ``` 闭合，避免
Markdown 后续渲染错乱
- skills/docx/SKILL.md: 翻译时丢失的 • Unicode escape 示例已恢复，
与 zh-CN 版本对齐
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
GitHub
101
skills/s3-storage-operations/SKILL.zh-CN.md
Normal file
101
skills/s3-storage-operations/SKILL.zh-CN.md
Normal file
@@ -0,0 +1,101 @@
|
||||
<!-- locale: zh-CN -->
|
||||
|
||||
# s3-storage-operations 技能
|
||||
|
||||
## L0：一句话摘要
|
||||
|
||||
让 Agent 通过 DesireCore HTTP API 操作 S3 兼容对象存储，实现文件上传/下载/列举/删除并生成可分享的下载链接。
|
||||
|
||||
## L1：概述与使用场景
|
||||
|
||||
### 能力描述
|
||||
|
||||
s3-storage-operations 是一个**工具技能（Tool-Skill）**，通过 DesireCore Agent Service 的 HTTP API 与用户预配置的 S3 兼容对象存储（AWS S3、七牛云 Kodo、MinIO 等）交互。
|
||||
|
||||
**架构变更（v2.0）**：S3 操作已从内置工具迁移为 HTTP REST API 端点，可通过 curl 从任意环境调用。Claude Code 的 Global Skill（`desirecore-s3-storage`）包含完整的 curl 调用指南。
|
||||
|
||||
核心原则：用户的 S3 连接已在 **资源 → 对象存储** 中预配置。API 自动解析连接——Agent 无需关心连接细节，专注于操作本身。
|
||||
|
||||
### 使用场景
|
||||
|
||||
- 用户要求「上传文件」、「放到存储里」、「保存到 S3」
|
||||
- 用户要求「给我个下载链接」、「分享这个文件」、「从 S3 下载」
|
||||
- 用户要求「看看存储里有什么」、「列出桶里的文件」
|
||||
- 用户要求「从 S3 删除」、「清理临时文件」
|
||||
- 工作流产出文件（报告、导出、图片）需要通过 URL 分享
|
||||
- Agent 需要读取存储在 S3 中的数据进行处理
|
||||
|
||||
## L2：详细规范
|
||||
|
||||
### 端口发现
|
||||
|
||||
```bash
|
||||
PORT=$(cat ~/.desirecore/agent-service.port)
|
||||
```
|
||||
|
||||
### API 端点
|
||||
|
||||
| 端点 | 方法 | 说明 |
|
||||
| --------------------- | ------ | ------------------------------- |
|
||||
| `/api/s3/connections` | GET | 列出可用连接摘要 |
|
||||
| `/api/s3/upload` | POST | 上传文件（multipart/form-data） |
|
||||
| `/api/s3/download` | GET | 生成下载链接或下载文件 |
|
||||
| `/api/s3/list` | GET | 列出对象 |
|
||||
| `/api/s3/objects` | DELETE | 删除对象 |
|
||||
|
||||
### 快速参考
|
||||
|
||||
```bash
|
||||
PORT=$(cat ~/.desirecore/agent-service.port)
|
||||
|
||||
# 列出连接
|
||||
curl -k "https://127.0.0.1:${PORT}/api/s3/connections"
|
||||
|
||||
# 上传
|
||||
curl -k -X POST "https://127.0.0.1:${PORT}/api/s3/upload" \
|
||||
-F "file=@local-file.pdf" -F "key=remote/path.pdf"
|
||||
|
||||
# 获取下载链接
|
||||
curl -k "https://127.0.0.1:${PORT}/api/s3/download?key=remote/path.pdf"
|
||||
|
||||
# 列出对象
|
||||
curl -k "https://127.0.0.1:${PORT}/api/s3/list?prefix=remote/"
|
||||
|
||||
# 删除
|
||||
curl -k -X DELETE "https://127.0.0.1:${PORT}/api/s3/objects" \
|
||||
-H "Content-Type: application/json" -d '{"key":"remote/path.pdf"}'
|
||||
```
|
||||
|
||||
### 连接解析机制
|
||||
|
||||
所有 API 端点均接受可选 `connection_id` 参数。未指定时，系统按以下优先级自动解析：
|
||||
|
||||
```
|
||||
指定 ID → isDefault=true → 第一个 status="connected" → 第一个连接
|
||||
```
|
||||
|
||||
### 错误处理
|
||||
|
||||
所有错误返回统一格式：
|
||||
|
||||
```json
|
||||
{ "success": false, "error": "描述信息", "code": "ERROR_CODE" }
|
||||
```
|
||||
|
||||
错误代码：`NO_CONNECTION` | `NOT_FOUND` | `UPLOAD_FAILED` | `DOWNLOAD_FAILED` | `DELETE_FAILED` | `LIST_FAILED` | `INVALID_REQUEST`
|
||||
|
||||
### 安全红线
|
||||
|
||||
| 规则 | 说明 |
|
||||
| -------------------- | ----------------------------------------------------- |
|
||||
| **禁止上传敏感文件** | `.env`、凭证文件、私钥等绝不上传 |
|
||||
| **删除前必须确认** | 调用删除 API 前应与用户确认意图 |
|
||||
| **不假设连接存在** | API 返回 `NO_CONNECTION` 时，引导用户在界面中添加连接 |
|
||||
|
||||
### 集成点
|
||||
|
||||
- **S3 Routes** — `lib/agent-service/routes/s3-routes.ts`: HTTP API 实现
|
||||
- **S3 Client** — `lib/agent-service/s3-client.ts`: AWS V4 签名，CRUD 操作
|
||||
- **Connection Resolver** — `lib/agent-service/s3-connection-resolver.ts`: 自动选择连接
|
||||
- **Global Skill Sync** — `lib/agent-service/global-skill-sync.ts`: 启动时写入 Global Skill
|
||||
- **Port Discovery** — `~/.desirecore/agent-service.port`: 端口发现文件
|
||||
Reference in New Issue
Block a user