基于 pingdotgg/t3code 的个人增强分支,面向中文使用、多仓库协同开发和美团内部研发流程。在上游 Web、Electron 桌面端和 React Native 移动端架构之上,扩展需求管理、代码平台集成、Skills 管理和模型配置。
代理运行在你自己的电脑或远程服务器上,客户端通过同一个环境管理项目、对话、终端、代码变更和任务。使用已有的代理订阅或自行配置的 API 服务;本项目不提供模型服务。
本分支仓库:uiliugang/t3code。下列增强以当前仓库已合入的提交为准,各端支持范围以对应使用指南为准。
- 多代理开发:接入 Codex、Claude Code、Cursor、Grok Build、OpenCode、Antigravity 等代理,在对话中完成开发、执行命令和审查代码。
- 项目与任务管理:按项目组织对话,使用独立 Git Worktree 隔离任务,查看每轮变更、检查点并恢复文件。
- 代码协作:查看差异、提交和推送代码,创建、评审、关联及跟踪 PR。
- 远程访问:从浏览器、桌面或手机连接运行代理的环境,支持局域网、Tailscale 和 T3 Connect。
- 自动化与代理工具:通过 MCP 操作项目和任务,使用定时任务和 Webhook 驱动工作流。
以上能力继承自 T3 Code。下面列出本分支增加或强化的部分。
| 方向 | 本分支增加或强化的能力 |
|---|---|
| 中文与外观 | 支持简体中文界面,补齐设置和常用操作翻译;让代理生成的提交及 PR 文案遵循界面语言;增加主题、Claude Desktop 主题下的 GoLand 代码配色及差异颜色设置。 |
| 多仓库工作区 | 将前端、后端等仓库组成一个工作区,为各仓库创建独立 Worktree,选择主仓库,配置仓库上下文及脚本范围,按仓库查看变更、提交、终端和编辑器入口。 |
| 项目导入 | 批量选择本地文件夹导入项目,识别已有项目和重复仓库;支持单仓库分组,优化分组标识和项目展示。 |
| 需求管理 | 统一浏览 MEP ONES 和 GitHub Issues,支持看板与列表、项目和负责人筛选、新建、详情及状态变更;自动识别 GitHub 仓库,并从近期美团 PR 及关联分支发现 MEP 空间,也可手动覆盖。 |
| 分支关联需求 | 为已推送分支关联 GitHub Issue 或 MEP 工作项;按工作区仓库和分支聚合展示关联需求。GitHub 关联保存在 T3 环境中,美团关联写入 MEP;每个分支当前关联一个需求。 |
| 美团研发集成 | 接入美团代码平台,支持仓库、PR 和评审流程;支持 MOA 免登或大象授权,在 PR 中向选定评审人发送大象链接。 |
| Skills 管理 | 统一管理共享安装包和各代理使用位置,收纳已有技能、筛选已托管技能、管理目录链接;支持每日更新检查、更新策略、版本恢复,以及目录冲突备份和原位置恢复。 |
| 模型配置 | 支持 Codex 和 Claude BYOK,分别配置连接方式与运行时来源;同类代理共享托管安装,账号凭据独立保存;支持自定义模型 ID、同步 API 模型目录和模型工具调用检查。 |
| Git 与 Worktree | 默认限制新 Worktree 基于 main/master,保护主分支;合并后安全快进本地主分支,可选清理已合并分支和 Worktree;支持按组手动清理和重建。 |
| 配置迁移 | 导入、导出客户端偏好、主题、快捷键、模型配置及项目设置;可在另一环境克隆仓库并恢复项目或工作区分组,查看进度和重试失败导入。 |
| 日常体验 | 可选预测下一条用户消息;优化 Markdown 默认预览、Diff 文件类型筛选、变更预览和用量展示。 |
| 连接与发行 | 改善 SSH 环境运行时下载失败时的中转回退;为本分支构建和发布 macOS Apple Silicon、Linux 和 Android 安装包。 |
查看 本分支 Releases 中的 macOS Apple Silicon(arm64)DMG、Linux x64/arm64 AppImage 与 DEB、macOS arm64 和 Linux x64/arm64 CLI,以及 Android arm64 APK。没有对应安装包的平台可从源码运行。
- macOS 包采用 ad hoc 签名,未经过 Apple 公证,首次打开可能需要在系统安全设置中明确允许。通过「设置 → 关于」可查找新版安装包,不会自动安装。
- Linux AppImage 和 DEB 支持应用内更新。仍关闭更新功能的旧版需要先手动安装一次新版。
- Android 使用独立包名
com.uiliugang.t3code。通过本仓库的 APK 更新,安装前需要确认;不接收上游 Android OTA 更新。
每个正式 Release 附带 SHA256SUMS。手动下载时,可将安装包或 CLI 压缩包与该文件放在同一目录,使用 shasum -a 256 <文件名>(macOS)或 sha256sum <文件名>(Linux)计算摘要,并与清单中对应文件的值核对。Android 升级应使用本仓库同一签名的 APK,不要卸载旧版来规避升级失败,以免丢失本地设置。
本分支使用独立的 0.0.x 版本序列。上一版误标为 0.1.9,正确版本为 0.0.18,本轮目标版本为 0.0.19;是否已发布以 Releases 页面为准。已安装误发 0.1.9 的桌面或 CLI 用户,需要在修正版发布后手动安装一次 0.0.19,不能依赖自动更新识别较低版本号。Android 0.0.19 使用更高的安装序号,可从误发版保留数据升级。
上游的 npx t3@latest、应用商店和包管理器入口分发的是上游版本,不包含本分支的增强。要安装本分支的 CLI,请使用本仓库的安装脚本。
macOS Apple Silicon 和 Linux x86_64/arm64 桌面应用也可以通过同一条命令安装或更新。先退出 T3 Code,再运行:
curl -fsSL https://raw.githubusercontent.com/uiliugang/t3code/main/scripts/install-desktop.sh | sh脚本自动识别系统和架构,校验后安装对应的 DMG 或 AppImage。macOS 默认安装到 /Applications,Linux 默认安装到 ~/Applications,不修改用户数据,也不会启用 macOS 应用内自动更新。指定版本、安装目录及更新方式见桌面安装说明。
没有 Apple 开发者账号时,本分支无法通过 Developer ID 签名和 Apple 公证消除首次打开的拦截。确认安装包来自可信来源后,将应用拖入「应用程序」文件夹,尝试打开一次,再前往「系统设置 → 隐私与安全性」选择「仍要打开」,按提示确认。
也可以在终端中移除该应用的下载隔离标记,然后重新打开:
xattr -dr com.apple.quarantine "/Applications/T3 Code.app"
open "/Applications/T3 Code.app"如果应用安装在其他位置,请将两处路径替换为实际路径。此操作只移除指定应用的隔离标记,不代表应用通过了 Apple 验证,也不会关闭系统的 Gatekeeper。重新下载或更新后可能需要再次处理。
需要 Git。仓库的 ./vp 启动器会准备 package.json 指定的 Node.js 和 Vite+;已有匹配工具链时也可直接使用 vp。
git clone https://github.com/uiliugang/t3code.git
cd t3code
./vp i
./vp run dev使用终端输出的地址访问 Web 客户端,不要假定固定端口。开发环境使用隔离的数据目录,首次启动可能复制本机已有 T3 数据的裁剪副本,详见 开发指南。
启动桌面开发模式:
vp run dev:desktop开发模式通过同源代理访问服务端,无需设置 VITE_HTTP_URL 或 VITE_WS_URL。
在运行 T3 服务端的机器上安装并认证至少一种代理,例如 Claude Code。其他代理的安装入口见 安装与首次运行。Antigravity 可在设置中安装并使用 Google 登录。
订阅账号和第三方 API 是不同的配置方式。使用自有 API 时,请按下方 BYOK 流程配置。
- 在设置中选择界面语言、代理和默认模型。Web 和桌面端的语言入口为 Settings → General → Language,移动端可在设置中搜索 Language 或 语言。仅支持 English 和 简体中文,选择保存在当前设备;部分未翻译文本仍显示英文。
- 添加项目,或通过 Settings → Projects → Import folders 批量导入本地仓库。
- 新建任务,选择当前检出目录或新的 Worktree,再选择代理和模型并发送需求。
- 在变更面板检查代码,完成提交、推送和 PR。需要异地继续时,从另一客户端连接同一环境。
从侧栏或命令面板选择 Create group,选择环境、仓库和主仓库。一个组支持 1–16 个仓库;可在 Settings → Projects → Repositories 配置别名、上下文和路径。
目前多仓库任务支持 Codex 和 Claude。新任务选择 Worktree 后,各仓库分别准备检出目录和初始化脚本,全部准备完成才启动代理。项目动作的 Run in repositories 决定脚本在哪些仓库运行。现有任务保留创建时的仓库绑定。
在任务详情中选择对应仓库查看 Diff、提交或打开终端。需要释放空间时,在 Settings → Worktrees → Local worktrees 选择单个 Worktree 或整组清理;分支、提交和对话历史保留,可重建目录,但被删除的忽略文件(如 .env)不能恢复。
打开 Requirements board,选择环境及 MEP 或 GitHub 数据源,按项目、负责人搜索工作项,切换看板或列表,查看详情、新建需求或修改状态。
Settings → Code → Issue management 展示自动识别的仓库和 MEP 空间,可重新检测或手动覆盖;多个 MEP 空间 ID 使用逗号分隔。MEP 依赖服务端已安装并登录的 ones2,GitHub 使用源码管理中的认证。
推送开发分支后,在仓库详情的 Linked issues 添加需求链接;换绑前先解除当前关联。解除关联不会删除需求,GitHub 关联也不会在 PR 合并时自动关闭 Issue。
在能访问美团网络的服务端安装 code-cli 0.1.27 或更新版本:
npm install -g @ee/code-cli@latest --registry=http://r.npm.sankuai.com
code-cli auth login
code-cli auth statusMOA 免登可用时会自动使用;也可在 Settings → Source control → Meituan Code 保存 MIS,通过大象完成授权。大象授权需要服务端具备相应 CIBA 配置;其他环境使用 CLI 登录。
发送评审链接前,在 Settings → Connections → Communication 配置大象应用 Client ID 和 Client Secret。应用需具备员工查询及机器人发消息权限;随后在 PR 摘要中选择评审人并执行 Send PR link。
本构建启用 GitHub 和美团代码平台,其他上游托管平台集成当前关闭。完整说明见 源码管理。
打开 Settings → Skills,安装技能或将已有技能纳入管理,再选择共享目录及代理使用位置。托管技能通过目录链接分发,位置冲突时先备份原内容再替换。
为每个技能选择自动更新、手动更新或不更新;有本地修改时,自动应用会被阻止,需先确认处理方式。可以恢复早期版本、停止托管并保留文件、恢复原位置或卸载。Web、桌面和移动端共享所连接环境的管理结果。
详见 Skills 管理与更新。
在 Settings → Providers 先选择目标环境,再添加 Codex 或 Claude。连接方式决定账号或 API 凭据,运行时来源决定使用本地 CLI 还是 T3 托管安装。切换安装来源不等于切换账号;同一环境的同类提供商共享托管安装,但凭据、BYOK 状态和代理进程独立。
Codex 的 API Key 连接使用 Responses API。填写服务商基础 URL(保留 /v1 等前缀,不包含 /responses)、密钥或密钥引用,以及准确的模型 ID。已有 CLI 登录和 API 连接分别保存配置,不需要覆盖原有 CLI 认证。模型目录变化后可执行 Sync models from provider,手动添加的模型及选项会保留。详见 Codex 连接与 API 配置。
在 Settings → Providers 添加 Claude,创建后将连接方式切换为 API 密钥,填写服务商地址、协议和凭据,添加准确且区分大小写的模型 ID。账号与 API 连接分别保存配置,切回时恢复。
服务支持 Anthropic Messages API 或 OpenAI Chat Completions,请选择对应协议。服务端仍需安装 Claude Code,或指定其可执行文件。
保存后先执行 Check connection;需要验证实际推理和工具调用时,在对应模型旁执行 Test model & tools,后者会发送请求并产生 API 用量。密钥保存在所选环境,远程场景中的 localhost 指服务端机器。
配置目录和可执行文件路径都属于选中的服务端环境,而不是当前浏览器或手机。排查账号或模型不一致时,先核对连接方式及高级设置中的路径;不要复制整个代理配置目录来共享账号。模型测试会产生实际 API 用量,连接检查成功不代表推理和工具调用已通过。
在 Settings → Voice 选择转写位置。Web 和桌面端需要选择环境;移动端可使用设备语音服务或明确选择已连接环境。环境转写需要下载或选择支持的模型,录音会发送给该环境处理。云端转写另需对应 API 配置,可能产生费用。
转写结果先进入草稿,确认发送后才交给代理。可随时取消录音;选定环境离线时不会自动改用其他环境。详见 语音输入。
- Web / 桌面:在 Settings → General → Import and export 导出或导入配置;移动端入口为 Settings → About → Client Storage。需要在新机器恢复项目时,选择克隆仓库和创建项目或工作区组。导出不包含账号凭据和对话历史,但动作命令及自定义指令按原样导出,分享前请检查。
- 在 Settings → Chat → Show predicted messages 开启下一条消息预测。建议可先放入草稿编辑,再由你发送;默认关闭,会消耗文本生成模型的用量。
修改代码前请阅读 AGENTS.md 和 CONTRIBUTING.md。提交前运行 vp run check:changed,检查本次变更涉及的文件。
本项目沿用上游 LICENSE,感谢 T3 Code 及其贡献者。上游文档中的发行入口、平台支持和默认行为可能与本分支不同,请结合本文及当前实现使用。