ARKCloud IPFS

ARKCloud IPFS 关键词：arkcloud, ARKCloud, arkcloud-ipfs, ARK Cloud, OpenClaw skill, CowAgent skill, Claude Code skill, IPFS, CID, file.arklink.hk, 去中心化存储，上传 API。 使用 ARKCloud 的 token-protected 上传 API，不要调用或暴露原始的 Kubo API 或网关 API。公共上传必须通过 /api/upload。 配置 ARKCLOUD_BASE_URL：可选， 默认为 https://file.arklink.hk。 ARKCLOUD_UPLOAD_TOKEN：POST /api/upload 的 bearer 令牌。 ARKCLOUD_CLIENT_COOKIE：可选浏览器/客户端会话 cookie，用于客户端 API。 ARKCLOUD_CSRF_TOKEN：可选 CSRF 令牌，用于客户端上传/删除 API。 永远不要打印、存储或提交明文令牌、会话 cookie、管理员令牌、钱包私钥、种子短语或 .env 文件。如果用户要求上传机密信息，警告他们并在继续之前要求确认。 上传文件 使用 bearer-token 上传助手进行正常文件上传： python /scripts/arkcloud_upload.py /path/to/file 助手向 POST /api/upload 发送请求，包含 Authorization: Bearer ，并返回包含以下内容的 JSON： cid bytes credits_charged credits_remaining filename duplicate short_url url 如果 duplicate 为 true，ARKCloud 返回了现有的上传记录并且没有收取信用。 上传文件夹 文件夹上传需要登录的客户端会话，因为它使用了 POST /api/client/upload/folder 并且具有 CSRF 保护： python /scripts/arkcloud_upload.py /path/to/folder --folder 如果 ARKCLOUD_CLIENT_COOKIE 或 ARKCLOUD_CSRF_TOKEN 缺失，告诉用户从 https://file.arklink.hk/ 上传文件夹或提供有效的客户端会话和 CSRF 令牌。不要尝试通过原始 IPFS 端点绕过此限制。 列出上传 列出上传需要登录的客户端会话： python /scripts/arkcloud_list.py 它调用 GET /api/client/uploads 并以 JSON 格式打印上传记录。 删除或取消发布上传 删除上传需要登录的客户端会话和 CSRF 令牌： python /scripts/arkcloud_delete.py 它调用 DELETE /api/client/uploads/{upload_id}。将其视为破坏性操作：除非用户明确要求删除，否则在删除之前确认。 错误处理 缺失 ARKCLOUD_UPLOAD_TOKEN：要求用户从 ARKCloud 钱包/客户端 UI 配置令牌。 401 或 403：令牌/会话缺失、过期、不活跃或缺少 CSRF。 信用不足：报告 credits_required 和 credits_balance（如果存在）。 文件太大或路径无效：报告路径并避免重试未更改的内容。 服务不可用：检查 GET /api/health 或询问是否稍后重试。 发布 此技能可以从 GitHub 安装，当仓库保持此路径时：skills/arkcloud-ipfs/SKILL.md 安装示例： /skill install djanngau/arkcloud-ipfs-skill#skills/arkcloud-ipfs cow skill install djanngau/arkcloud-ipfs-skill#skills/arkcloud-ipfs