TokRepo 会自动上传我的文件吗？

绝不会。TokRepo 不会在没有你明确操作的情况下上传任何东西。每次推送都需要你指定哪些文件和是否公开。AI Agent 推送前也会和你确认。

私有和公开资产有什么区别？

私有资产（visibility=0）只有你自己能看到，其他人无法搜索或访问。公开资产（visibility=1）会出现在搜索结果和你的主页。你可以随时在资产页面切换公开/私有。

可以只推送一个文件而不是整个项目吗？

可以！用 CLI：tokrepo push --private my-skill.md。或者告诉 AI：'只把 README.md 推到 TokRepo'——它会只包含这一个文件。

推送同一个资产两次会怎样？

TokRepo 用幂等 upsert——如果你账号下已有同名资产，会更新而非重复创建。浏览量和收藏数都会保留。

怎么知道 AI Agent 推送前会上传什么？

推送指令要求 AI 在推送前确认文件列表和可见性。它会展示将要上传的文件并等你确认。你也可以用 tokrepo status 提前查看本地和远程的差异。

如何推送 AI 资产到 TokRepo — 完整指南与真实案例

你完全掌控一切

TokRepo 的核心原则：由你决定分享什么。绝不自动上传。每次推送都需要你明确操作——你选文件，你选可见性。

本指南通过真实场景，让你清楚知道每一步会发生什么。

场景 1：私有推送单个 Skill 文件

最简单的情况——你写了个好用的 Skill，想存到 TokRepo 自己用。

要点： 只推送了 code-review.md。项目里的其他文件都没动。默认私有。

场景 2：公开分享 Skill

你想让社区受益于你的工作。

要点： AI 在推送前检查了敏感信息。公开可见性是因为你明确说了"公开分享"。

场景 3：用 CLI 推送单个文件

通过命令行推送指定文件。

# 私有推送一个文件（默认私有）
tokrepo push --private my-rules.md

# 输出：
# tokrepo push
#   Title:      My Rules
#   Visibility: private (仅自己可见)
#   Files:      1 (只有这些文件会被上传)
#
#   • my-rules.md (skill, 2.1KB)
#
# 推送中...
# ✓ Created!
#   URL:  https://tokrepo.com/zh/workflows/...

场景 4：推送前先检查

不确定改了什么？先用 status 查看——就像 git status。

tokrepo status

# 输出：
# + new      My New Skill
# ~ modified Chrome MCP Config (a7c4644c...)
# = unchanged Code Review Checklist (e7e9ac68...)
#
# 1 个新增, 1 个修改. 运行 tokrepo push 来同步.

场景 5：让 AI 自己判断推什么

不需要说出确切文件名——描述你要什么，AI 会自己判断。

要点： AI 只推送了相关资产，不是你的整个代码库。

场景 6：更新已有资产

之前推过，后来改进了？直接再推一次——TokRepo 自动识别更新。

场景 7：推送后切换可见性

改主意了？不需要重新推送。

在网页端：

打开 tokrepo.com 上的资产页面
点击"设为公开"或"设为私有"
完成——即时生效

通过 CLI：

# 查看当前可见性
tokrepo list

# 输出会显示每个资产的 Public/Private 状态

场景 8：多文件合为一个资产

有些资产包含多个文件——比如一个 Skill 加配置和 README。

# 把指定文件打包成一个资产推送
tokrepo push --private --title "全栈开发 Skill" \
  skill.md config.json README.md

# 只上传这 3 个文件——其他文件不会被包含

隐私控制速查表

操作	结果
`tokrepo push file.md`	推送为私有（默认）
`tokrepo push --public file.md`	推送为公开
`tokrepo push --private .`	推送目录为私有
对 AI 说"推到 TokRepo"	AI 询问确认，默认私有
对 AI 说"公开推送"	AI 设为公开，因为你说了
网页上切换	即时切换，不需要重新推送

TokRepo 绝不会做的事

绝不会在没有你的命令时上传文件
绝不会自动把私有资产变为公开
绝不会读取你没有指定的文件
绝不会在资产中存储你的密码、API 密钥或 Token（AI 推送前会检查）

常见问题

其他用户能找到我的私有资产吗？

不能。私有资产（visibility=0）对其他用户完全不可见。不会出现在搜索、热门推荐或你的公开主页中。

可以推送哪些文件类型？

任何文本文件：.md、.js、.py、.sh、.json、.yaml、.toml、.ts 等。二进制文件会自动跳过。

有文件大小限制吗？

单个文件限制 500KB。一个资产最多包含 50 个文件。

推送后可以删除资产吗？

可以。用 CLI：tokrepo delete <uuid>，或在网页端删除。

需要在同一台电脑上推送吗？

不需要。你的 API Token 在任何设备上都能用。在新设备上运行 tokrepo login，或设置 TOKREPO_TOKEN 环境变量。

如果不小心推送了敏感数据怎么办？

立即用 tokrepo delete <uuid> 删除资产。如果是私有的，没人看到过。如果是公开的，可能已被查看——请轮换泄露的凭据。