什么是tc-protohub
tc-protohub 是一个专为 AI Agent 设计的 ProtoHub 原型管理工具，旨在简化在私有沙箱环境中对原型的创建、更新与发布流程。该工具通过自动化脚本和严格的配置验证机制，确保用户能够安全高效地管理其设计原型。它支持将本地目录或 ZIP 文件直接上传为新的原型，也允许覆盖更新已有原型，同时提供按名称搜索原型的能力，极大提升了开发者在原型迭代阶段的效率。所有操作均需通过环境变量进行身份认证，并强制校验入口文件的存在性，以避免因结构错误导致预览失效。 该工具的核心优势在于其智能化的更新逻辑：当用户请求“更新某个原型”但未明确指定 ID 时，系统会自动调用列表查询功能，根据名称匹配现有项目。若仅有一个匹配项，则自动执行更新；若存在多个或无匹配，则会提示用户进一步确认，防止误操作。此外，默认 API 地址为本地服务 `http://localhost:48080`，但可通过环境变量灵活调整，适应不同部署环境。整个流程围绕 `publish.py` 脚本展开，涵盖发布、列出、获取预览链接等关键动作，形成闭环的原型生命周期管理方案。 值得注意的是，tc-protohub 特别强调健壮性与安全性。它不仅要求必须设置 `PROTOHUB_API_KEY` 和 `PROTOHUB_URL` 两个环境变量，还严格禁止在未获得用户输入的情况下使用占位值或跳过验证。一旦任一配置缺失且未在会话中补全，系统将立即终止执行并引导用户提供必要信息。这种设计有效避免了因凭证错误引发的权限问题（如 401 错误），也杜绝了因缺少 `index.html` 导致的预览崩溃风险。
核心功能特点
- 支持目录或 ZIP 文件的自动化打包与上传，自动创建新原型或更新现有原型
- 强制校验入口文件 index.html，确保原型可正常预览
- 提供按名称搜索原型的功能，便于快速定位需更新的目标项目
- 支持获取原型的公开预览链接，方便演示与分享
- 内置智能更新逻辑：当用户未指定 ID 时，自动查询同名原型并判断是否唯一匹配
- 严格的环境变量验证机制，确保 API 密钥与服务地址正确配置
适用场景
tc-protohub 特别适合需要频繁进行原型版本迭代的团队协作场景。例如，设计师完成一次界面改版后，可通过命令行将修改后的构建目录直接推送到 ProtoHub，无需手动登录后台上传。若此前已存在名为‘登录页面’的原型，系统会先检索确认唯一性，再执行内容覆盖，整个过程高度自动化。对于远程协作或 CI/CD 流程中的前端交付环节，该工具也能无缝集成，实现从代码提交到原型上线的快速通道。 另一个典型应用场景是原型库的日常维护。当团队积累了大量原型时，开发者常需查找特定名称的原型以进行更新或调试。tc-protohub 的列表查询功能允许通过关键词快速筛选，避免在冗长的原型列表中手动翻找。结合预览链接生成能力，还能一键分享给产品或客户查看最新效果，显著提升沟通效率。尤其在敏捷开发模式下，每日站会后即时更新原型状态成为可能，使决策始终基于最新视觉稿。 此外，该工具对错误处理有明确规范，能有效应对常见异常情况。比如遇到 401 错误会明确提示认证失败，建议检查 API 密钥；遇到 404 则告知目标原型不存在，引导用户重新选择或新建。这些细粒度反馈机制降低了使用者的学习成本，即使非技术人员也能在指导下完成基本操作。整体而言，tc-protohub 将原本繁琐的原型管理工作转化为轻量级命令行操作，适用于个人开发者、设计团队乃至企业级原型资产管理系统。