SuperAPI AI 工具集

code-storage

编程与开发

查看项目

更新于 10-16 09:51

技能介绍

code.storage 是一个管理型 Git 基础设施层,本技能用于与其交互,涵盖仓库、分支、提交、文件、标签、笔记、Git 同步等操作。提供官方 SDK:TypeScript/JavaScript(@pierre/storage)、Python(pierre-storage)、Go(github.com/pierrecomputer/sdk/packages/code-storage-go),并支持自定义 HTTP 传输(TypeScript 可选 fetch,默认 global fetch,无自动重试,重试与取消由调用方负责,不影响 Git CLI)。

使用前需设置环境变量:ORG_NAME、PIERRE_PRIVATE_KEY、CODE_STORAGE_BASE_URL、CODE_STORAGE_TOKEN。每个请求需携带用私钥签名的 JWT,令牌按仓库授权(org:read 为组织级)。JWT 含 iss、sub、repo、scopes、refs、iat、exp;refs 为按序匹配的 [模式, 操作] 数组,支持 no-force-push、no-push、verify-sig 等策略。权限范围包括 git:read、git:write、repo:write、org:read。Git 远程 URL 格式为 https://t:{JWT}@{ORG_NAME}.code.storage/{REPO_ID}.git,用户名为 t,密码为 JWT。

主要 REST 端点(基础地址 https://api.{org}.code.storage/api/v1,请求头 Authorization: Bearer $CODE_STORAGE_TOKEN)覆盖:创建/列出/获取/删除仓库,创建/列出/删除分支、分支差异、合并预览与合并,创建提交(commit-pack、diff-commit)、列出提交、提交差异、恢复分支,列出文件与元数据、获取文件内容、blame、grep 搜索、下载归档,标签与笔记的增删查,拉取上游、分离上游,以及通用 Git 凭据管理。支持从 GitHub、GitLab、Bitbucket、Gitea、Forgejo、Codeberg、sr.ht 等同步,也可从现有仓库 fork。

限制方面:JWT 需自行生成,令牌按仓库或组织授权;分支删除不能删除默认分支;仓库删除为异步;TypeScript 的 fetch 选项无自动重试,需避免盲目重试写操作或复用已消费的流式请求体;文档未说明具体收费、价格、平台或效果,亦未提供完整安装命令。