关于 tday
tday 让编码 Agent 在独立的本地应用实例中录制带旁白的功能演示,并上传视频以便编辑和分享。它支持 Web、Electron 桌面、终端和模拟器应用。
主要功能
- 01通过编码 Agent 录制应用演示
- 02使用含临时数据的独立应用实例
- 03检查画面中可能出现的机密
- 04将视频和演示元数据上传至 tday
适用场景
- 01录制新开发的功能
- 02查看哪些功能仍需制作演示
MCP 相关
`tday` MCP 服务在本地通过 stdio 运行,让编码 Agent 使用 tday 的演示录制工作流。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
32收录的工具列表 · 更新于 2 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appUrl | string | 否 | 运行中应用的地址,例如 http://localhost:3000(使用 cdpUrl 时无需提供) |
| cdpUrl | string | 否 | 此机器上运行的桌面应用的调试地址,例如 http://127.0.0.1:9222,用于在独立窗口中捕获应用 |
| device | enum | 否 | desktop | mobile |
| headed | boolean | 否 | 显示浏览器窗口(例如方便开发者登录) |
| window | string | 否 | 使用 cdpUrl 时:应用有多个窗口时,要捕获的应用窗口地址中的一部分 |
| repoDir | string | 否 | 仓库根目录(默认:当前目录) |
| featureIds | array | 否 | 来自捕获提示词或 demo_features 的 tday 功能 ID(为空 = 捕获提示词令牌允许的所有功能) |
| colorScheme | enum | 否 | light | dark |
| storageState | string | 否 | 包含已登录会话的 Playwright storage-state JSON 文件 |
详细介绍
面向编码 Agent 的 tday
使用你已在使用的编码 Agent,为应用录制带旁白的演示视频。让 Agent“录制一个最新功能的 tday 演示”:它会在你的电脑上启动一份独立的应用副本,逐句讲解并演示该功能,检查录制内容中是否有屏幕隐私信息,然后上传视频。tday 会添加配音、光标、镜头移动和样式,演示视频完成后便会出现在 tday 中,可供编辑和分享。
它支持 Web 应用、基于 Electron 构建的桌面应用、终端工具、iOS Simulator 中的 iPhone 应用、模拟器中的 Android 应用,以及 Mac 应用。你需要一个 tday 账户 (tday.com)。
安装
Claude Code
claude plugin install tday --marketplace tday-com/tday-plugins
也可以在会话中运行:/plugin marketplace add tday-com/tday-plugins,然后运行 /plugin install tday@tday。
Cursor
git clone https://github.com/tday-com/tday-plugins.git ~/.cursor/plugins/local/tday
然后在 Cursor 中运行 Developer: Reload Window。
只安装 MCP 服务,一键完成
这会将单独的 tday MCP 服务(不含技能或命令)添加到 Cursor 或 VS Code,并固定为此版本。请使用它们或插件,不要同时使用两者。
Codex
codex plugin marketplace add tday-com/tday-plugins
codex plugin add tday@tday
Grok Build
grok plugin marketplace add tday-com/tday-plugins
grok plugin install tday
首次使用
让 Agent 录制演示。首次使用时,它会调用 tday_sign_in,显示一个链接和一组代码。在任何已登录 tday 的设备上打开该链接(如果这台电脑有浏览器,链接会自动打开),确认代码匹配后选择 Authorize;Agent 随后会继续操作。无论是在沙盒、云端机器还是通过 SSH 使用,流程都相同。登录信息会保存在你电脑上的 ~/.tday/config.json 中,仅你可读取,且这台电脑上的每个编码 Agent 都会使用该信息。登录有效期为 90 天。
在 Claude Code 中,你也可以输入 /tday:demo(可选提供功能名称),或输入 /tday:demos-needed,查看哪些功能还没有演示。
它运行什么,以及它会发送什么
- tday MCP 服务。 该插件会添加一个 MCP 服务
tday,由你的 Agent 使用npx --prefix ~/ -y @tday-com/[email protected] serve启动:这是 npm 上的@tday-com/mcp软件包,固定为此版本。它在你的电脑上通过 stdio 运行,工作目录为你的仓库;npx 会从你的主目录解析该软件包,因此绝不会读取你仓库自己的 package.json。该软件包仅由 tday 的发布工作流发布,并采用其独立许可证。 - 哪些内容会离开你的电脑。 演示录像、你选择上传的屏幕画面,以及与之相关的元数据(功能、步骤、旁白)。绝不会发送你的源代码、
.env值或机密信息:若某段录屏可能显示机密信息,在问题修复前不会上传。请参阅哪些内容会离开你的设备和演示安全。 - 它会连接谁。 tday(
tday.com),使用你的登录信息。每天连接一次 npm 注册表,检查是否有更新版本。无需令牌即可调用 GitHub 或 GitLab 的公共 API,在保存备注到仓库之前检查仓库是否公开(仅发送仓库名称)。对于终端演示,还会从cdn.jsdelivr.net获取符号字体。 - 在你的电脑上。 一个使用临时数据的独立应用演示实例(绝不会触碰你自己的服务器和数据)、用于录制演示的浏览器或模拟器,以及存放在
~/.tday/capture下、结束时会删除的临时文件。有关应用启动方式的备注会写入你仓库的.tday文件夹,不会替你提交任何内容。
该插件还包含一项技能,其中列出了 Agent 遵循的步骤,以及上文提到的两个命令。
链接
许可证
本仓库中的文件采用 MIT 许可证(请参阅 LICENSE)。这些文件启动的
@tday-com/mcp 软件包在 npm 上分发,并采用其独立许可证。
tday 名称、tday 徽标和 Cali(assets/ 中的图标)是 tday 的商标。该许可证不授予使用这些商标的权限。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。