Tether AI 编码工作台

Tether 是什么

Tether 是一个本地优先的 AI 编码工作台，以 Electron 桌面应用形式运行，构建在 Pi 生态 之上。它让 DeepSeek 以及 OpenAI 兼容模型在明确的权限边界内检查、编辑并验证你的代码仓库。

模型请求直接发往你配置的供应商或本地网关，不经过 Tether 中转；界面与会话数据都留在本机。

核心特性

• DeepSeek 优先：支持自定义 Base URL、模型发现与推理等级控制，同时兼容 OneAPI、Ollama、vLLM 等 OpenAI 兼容端点。
• 过程可见可控：工具调用、命令输出、文件改动与上下文用量实时呈现。
• 权限边界：提供 Plan、Ask、Workspace、Full Access 四种模式。
• 可恢复编辑：基于补丁检查点，/undo 可还原上一轮的文件改动。
• 本地状态：设置、凭据与会话保存在 ~/.tether，无遥测、无托管代理。
• 桌面工作流：项目线程、@ 文件引用、生成中排队、图片输入、明暗主题、差异预览与中英文界面。

架构分层

React Renderer
  conversation, diff, settings, project and session UI
        │  contextBridge / Electron IPC
        ▼
Electron Main
  windows, workspace, credentials, agent process host
        │  JSON-RPC over stdio
        ▼
tether-agent-core
  Tether permissions, sandbox, tools, checkpoints, MCP, sessions
        │
        ▼
Pi ecosystem
  agent loop · model protocol · coding-agent extensions · RPC · TUI

渲染进程没有直接的 Node.js 访问权限，桌面能力通过 src/shared/types.ts 中的类型化 IPC 契约传递；Agent 运行在独立的工作进程中。崩溃后，磁盘上的会话可以继续作为对话使用，但 Tether 不会静默重放未完成的命令。

权限模式

沙箱属于纵深防御，不能替代对陌生仓库命令的人工审查。

Agent Skills

Skills 由 Pi 运行时加载，标准位置包括：

• 项目级（需信任工作区）：.agents/skills/<name>/SKILL.md、.pi/skills/<name>/SKILL.md
• 用户全局：~/.tether/skills/<name>/SKILL.md、~/.agents/skills/<name>/SKILL.md

每个 Skill 是一个包含 SKILL.md 的目录，frontmatter 必须包含 name 与 description。通过 /skill:name 调用，在输入框键入 / 可查看已加载的 Skills。

快速上手

从 GitHub Releases 下载对应平台安装包（macOS arm64、Windows 10/11 x64），然后：

1. 打开项目文件夹。
2. 配置 DeepSeek API Key 或兼容端点。
3. 描述任务，审阅工具活动与差异，必要时使用 /undo。

macOS 当前为开发签名，若被 Gatekeeper 拦截，可右键选择「打开」，或执行：

xattr -cr /Applications/Tether.app

本地开发

需要 Node.js >=22.19 与 pnpm：

pnpm install
pnpm dev

常用检查命令：

pnpm typecheck
pnpm test
pnpm build

应用从 npm 消费 tether-agent-core；开发 Runtime 本身时，可临时链接 ../tether-runtime/packages/core。

隐私与许可

Tether 不运行遥测或模型中转服务，会话、设置与凭据均留在本地。但为完成任务，提示词、相关代码上下文与图片仍会发送给你选择的模型、网关或 OCR 服务。项目以 MIT 协议开源，Pi 生态依赖保留各自的许可与版权声明。