帮助中心

如何使用 TokRepo

从浏览资产到 CLI 同步,这里是你需要知道的一切。

1 快速上手

浏览和发现

通过首页浏览热门资产,用搜索查找特定 Skill,或按精选集浏览官方账号的策展内容。

一键安装

每个资产页面都有即用安装命令。点击"使用这个资产",复制命令,粘贴到你的 AI 工具中。浏览和安装无需注册。

分享你的作品

安装 TokRepo CLI,用 API Token 认证,一条命令推送你的本地 Skill 或 Prompt。你的资产将获得永久链接、版本追踪和社区曝光。

npm install -g tokrepo
tokrepo login
tokrepo push ./my-skill/

2 CLI 命令参考

TokRepo CLI 让你在终端中管理 AI 资产。全局安装后即可使用:

tokrepo login— 使用 API Token 认证
tokrepo login
tokrepo whoami— 显示当前登录用户
tokrepo whoami
tokrepo push <dir>— 推送单个资产目录
tokrepo push ./my-skill/ --private
tokrepo sync <dir>— 扫描并同步目录中所有资产
tokrepo sync ~/.claude/skills/
tokrepo status <dir>— 预览同步状态但不推送
tokrepo status ~/.claude/skills/
tokrepo list— 列出你发布的资产
tokrepo list
tokrepo search <query>— 搜索社区资产
tokrepo search "code review"
tokrepo install <uuid>— 将资产安装到本地
tokrepo install a1b2c3d4-e5f6-...

3 常见问题

TokRepo 是免费的吗?
是的。TokRepo 完全免费——浏览、安装、Fork 和发布资产均不收费。没有付费等级或内容墙。
支持哪些 AI 编码工具?
TokRepo 资产兼容 Claude Code、Cursor、GitHub Copilot、Gemini CLI、OpenAI Codex、Windsurf 和 VS Code。Skills 遵循 agentskills.io 跨平台标准以确保最大兼容性。
如何获取 API Token?
登录 TokRepo,访问提交页面(/workflows/submit)。登录后你的 API Token 会自动显示。复制后在 CLI 中用 tokrepo login 使用。
可以将资产设为私有吗?
可以。推送时加 --private 参数:tokrepo push ./my-skill/ --private。私有资产仅你自己可见。使用 tokrepo sync 时也可加 --private 标志。
tokrepo sync 具体做什么?
sync 扫描目录树,将每个子目录识别为一个资产,计算内容哈希,与你的远端 TokRepo 资产对比,推送新增或修改的内容。未变更的资产会跳过。它是幂等的——可以反复安全执行。
Fork 功能如何工作?
在任意资产页面点击"Fork"即可创建你自己的副本。Fork 后的资产出现在你的个人页面,你拥有完整编辑权限。原资产会追踪 Fork 数作为社区参考。
Token 成本如何估算?
默认基于内容长度估算(约每 4 个字符 1 个 token)。作者在发布时可通过自定义 token_cost 值覆盖,以提供更准确的估算。
TokRepo 支持版本历史吗?
支持。每次通过 CLI 推送或同步更新资产时都会记录新版本。你可以在资产详情页查看版本历史。

4 API 参考

所有 API 以 https://api.tokrepo.com 为基础路径。需要认证的接口在 Header 中添加 Authorization: Bearer tk_xxx。

POST
/api/v1/tokenboard/push/upsert

创建或更新资产(幂等)

POST
/api/v1/tokenboard/push/diff

对比本地资产与远端状态

POST
/api/v1/tokenboard/push/create

创建新资产(总是新建)

GET
/api/v1/tokenboard/workflows/list

列出和搜索已发布资产

GET
/api/v1/tokenboard/workflows/detail

通过 UUID 获取完整资产详情

GET
/api/v1/tokenboard/workflows/raw

获取原始内容(Agent 友好)

GET
/api/v1/tokenboard/tags/list

获取可用标签列表

推送示例

curl -X POST https://api.tokrepo.com/api/v1/tokenboard/push/upsert \
  -H "Authorization: Bearer tk_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Code Review Skill",
    "description": "Automated code review workflow",
    "files": [
      { "name": "SKILL.md", "content": "# Code Review\n..." },
      { "name": "review.md", "content": "## Steps\n..." }
    ],
    "tags": ["code-review", "skill"]
  }'

5 键盘快捷键

聚焦搜索/
下一个 / 上一个资产j / k
打开选中的资产o
收藏 / 取消收藏s
前往首页g h
前往热门g e
显示所有快捷键?

没找到答案?

随时联系我们,通常在 24 小时内回复。

ethanfrostcool@gmail.com