Tunc SRC 示例与智能体搭法提示词
Tunc SRC 的三种可用搭法,每种都配一段智能体照着做的提示词:每次改动后保存一个版本、接手别的助手留下的项目,以及回退一个版本。
更新于
下面每种搭法都从一段提示词开始:把它贴给智能体,剩下的由智能体做。不要把 API 密钥放进提示词:用环境变量或密钥管理交给你的工具。Tunc SRC 文档里有每个调用;这一页有的是能用的搭法。
让你的智能体连接到 Tunc SRC
在 Claude 里最快的方式是一个填好内容的链接。它会打开“Add custom connector”,名称和地址已经填好;核对一下再确认。
把 Tunc SRC 加到 ClaudeClaude 免费版只允许一个自定义连接器。Team 和 Enterprise 由 Owner 添加。
在 Claude Code、Cursor,或任何能运行命令、能改自己设置的智能体里,把下面这段贴进去。它会添加连接、等你登录,然后测试一次:
把 Tunc SRC 连接到这个会话。它的 MCP 服务器是 https://mcp.tuncsrc.com/mcp。如果你能运行命令,就运行:claude mcp add --transport http tunc-src https://mcp.tuncsrc.com/mcp。否则把它加到我的 MCP 设置里。然后让我登录(在 Claude Code 里:运行 /mcp,选择 tunc-src,再 Authenticate),等我确认。之后测试一次:创建一个名为 connection-test 的项目,保存一个内容为“能用了”的文件 hello.txt,说明写“连接测试。”,再把这个文件读回来,然后删除这个项目。告诉我你做了什么,以及返回了什么。在 ChatGPT,或者任何通过菜单添加连接器的应用里,让智能体读说明并一步步带你做:
读 https://tuncsrc.com/llms.txt,按菜单一步一步告诉我怎么把 Tunc SRC 接到这个应用里。用登录的方式,不要用 API 密钥。如果这个应用需要特殊模式才能添加连接器,告诉我是哪一个。智能体可以添加连接,但不能替你登录:你在浏览器里授权一次,并选择它可以做什么。想手动做的话,每个客户端的步骤都在下面:
| 客户端 | 步骤 |
|---|---|
| claude.ai, Claude Desktop and Claude mobile | Customize → Connectors → Add custom connector → 名称填 Tunc SRC,URL 填 https://mcp.tuncsrc.com/mcp → Add → Connect。免费版只允许一个自定义连接器;Team 和 Enterprise 由 Owner 在 Organization settings → Connectors 里添加。这个链接会打开对话框,名称和 URL 已经填好: |
| Claude Code | 先添加服务器,然后运行 /mcp,选择 tunc-src,再 Authenticate。 |
| ChatGPT | Settings → Apps & Connectors → Advanced → 打开 Developer mode → Create → 名称填 Tunc SRC,URL 填 https://mcp.tuncsrc.com/mcp,Authentication 选 OAuth → Create → Connect。 |
| Cursor | 加到 ~/.cursor/mcp.json,然后 Settings → MCP:会显示“Needs login” → Login。 |
| VS Code (Copilot) | 命令面板 → MCP: Add Server → HTTP → https://mcp.tuncsrc.com/mcp → 名称 tunc-src → 允许登录提示。 |
| Gemini CLI | 加到 settings.json,然后运行 /mcp auth tunc-src。 |
| Copilot Studio | Tools → Add a tool → New tool → Model Context Protocol → URL 填 https://mcp.tuncsrc.com/mcp → Authentication 选 OAuth 2.0,Dynamic discovery。 |
把一个网站放进 Tunc SRC,每次改动后保存一个版本
要做的事:一个助手正和你一起、跨很多次对话做一个网站(或任何一组文件),你希望每次改动都留着,什么都不丢。搭法:让智能体在 Tunc SRC 里建一个项目,每次改动后保存一个版本。
用 src_repo(operation 为 "create")创建一个名为 my-site 的 Tunc SRC 项目。用 src_write 把我们目前已有的网站文件保存进去:每个文件连同它的 path 和 content 放进 changes,summary 用一句大白话说明这个版本是什么。从现在起,每次我确认一处改动之后,都用 src_write 保存一个新版本,把最新的版本作为 if_version 传入,并告诉我你保存时写的那句话。每次保存就是一个版本,配一句说明。如果保存被拒绝并返回 version_conflict,说明期间有人保存过:智能体重新读取项目,再把自己的改动重做一遍。
接手另一个助手留下的项目
要做的事:昨天一个助手在做某个项目,今天你换了一个应用,或者开了新的对话。搭法:新的助手从 Tunc SRC 读取项目和它的版本,从真正保存下来的内容接着做。
用 src_repo(operation 为 "list")列出我的 Tunc SRC 项目。对 my-site 这个项目,用 src_read(operation 为 "versions")列出最近的版本,告诉我每个版本是谁保存的、什么时候保存的,以及那句说明。然后用 src_read(operation 为 "changes",version 设为最新的那个版本)给我看最新版本改了什么,再用 src_read(operation 为 "folder")读一下顶层文件夹,弄清楚项目里有什么。用 src_events 看看 my-site 从我们上次查看之后发生了什么,并记下 next 的值,下次从那里接着问。版本列表说明了谁在什么时候保存了什么;src_events 则是一份可以持续跟进的记录。它不会唤醒智能体:是智能体自己来问。
最后一次改动弄坏了:回退一个版本
要做的事:最新的改动把网站弄坏了,你想要回上一个版本。搭法:智能体列出版本,把前一个版本恢复回来;它会被保存为一个新版本,所以坏掉的那个版本还在,可以回头查看。
在 Tunc SRC 项目 my-site 里,用 src_read(operation 为 "versions")列出版本,把最新的两个连同它们的说明给我看。然后用 src_write 把最新版本之前的那个版本带回来:restore 传入那个版本,if_version 传入最新的版本,summary 写“回到出问题的改动之前的版本。”保存后把新版本告诉我。恢复永远不会删掉任何东西:更早版本的文件会作为一个新版本保存在最上面。
同一个项目,也可以用 git
工具是智能体使用 Tunc SRC 的方式。如果你自己也用 git,常规的 git 程序可以操作同一个项目:一次 push 和工具的一次保存会进入同一段历史。不需要安装任何 Tunc 的程序。
用 src_repo(operation 为 "describe")查看我的 Tunc SRC 项目 my-site,把 git 程序使用的地址给我,方便我 clone。不要输出任何 API 密钥。值得知道的
- 一次保存最多包含 1000 处文件改动,说明最长 500 个字符。通过工具保存的单个文件最大 100 MiB,src_read 不会整个返回超过 2 MiB 的文件,发往 Tunc SRC 各主机的一次工具请求最大 12 MiB。
- 每次保存都要指明它是从哪个版本开始的(if_version)。过期的版本会被拒绝并返回 version_conflict,所以两个智能体不会悄悄覆盖彼此。
- 放在工作区里的项目由该工作区的成员共用;没有放进工作区的项目只属于你自己。
- 删除项目会连同它的全部版本一起删除,而且无法撤销。只有真的想删时才让助手去删。
- 你的账号页面在 https://tunchub.com/account,可以看到存储用量和已连接的智能体。
