mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-06-06 11:50:41 +08:00

Files

xyx 4f7037a6b6 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)

2026-05-29 15:36:19 +08:00

7.2 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

s3-storage-operations Skill

L0: One-line Summary

Lets the Agent operate S3-compatible object storage through the DesireCore HTTP API — uploading, downloading, listing, and deleting files, and generating shareable download links.

L1: Overview and Use Cases

Capability Description

s3-storage-operations is a Tool-Skill that interacts with the user's pre-configured S3-compatible object storage (AWS S3, Qiniu Kodo, MinIO, etc.) via the DesireCore Agent Service HTTP API.

Architecture change (v2.0): S3 operations have been migrated from a built-in tool to HTTP REST API endpoints, callable via curl from any environment. Claude Code's Global Skill (desirecore-s3-storage) contains the full curl invocation guide.

Core principle: the user's S3 connection is pre-configured under Resources → Object Storage. The API resolves the connection automatically — the Agent does not need to worry about connection details and can focus on the operation itself.

Use Cases

The user asks to "upload a file", "put it in storage", or "save to S3"
The user asks for "a download link", "share this file", or "download from S3"
The user asks to "see what's in storage" or "list files in the bucket"
The user asks to "delete from S3" or "clean up temp files"
A workflow produces files (reports, exports, images) that need to be shared via URL
The Agent needs to read data stored in S3 for further processing

L2: Detailed Specification

Port Discovery

PORT=$(cat ${DESIRECORE_ROOT}/agent-service.port)

API Endpoints

Endpoint	Method	Description
`/api/s3/connections`	GET	List available connection summaries
`/api/s3/upload`	POST	Upload a file (multipart/form-data)
`/api/s3/download`	GET	Generate a download link or download a file
`/api/s3/list`	GET	List objects
`/api/s3/objects`	DELETE	Delete an object

Quick Reference

PORT=$(cat ${DESIRECORE_ROOT}/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"}'

Connection Resolution

All API endpoints accept an optional connection_id parameter. When unspecified, the system resolves it automatically with the following priority:

Specified ID  →  isDefault=true  →  first status="connected"  →  first connection

Error Handling

All errors return a unified format:

{ "success": false, "error": "描述信息", "code": "ERROR_CODE" }

Security Red Lines

Rule	Description
No uploading sensitive files	Never upload `.env`, credential files, private keys, etc.
Confirm before deletion	Always confirm intent with the user before calling the delete API
Do not assume a connection exists	When the API returns `NO_CONNECTION`, guide the user to add a connection in the UI

Integration Points

S3 Routes — lib/agent-service/routes/s3-routes.ts: HTTP API implementation
S3 Client — lib/agent-service/s3-client.ts: AWS V4 signing, CRUD operations
Connection Resolver — lib/agent-service/s3-connection-resolver.ts: automatic connection selection
Global Skill Sync — lib/agent-service/global-skill-sync.ts: writes the Global Skill on startup
Port Discovery — ${DESIRECORE_ROOT}/agent-service.port: port discovery file

7.2 KiB Raw Blame History