沉默天宫

安装编译依赖（Debian/Ubuntu）

sudo apt-get install -y build-essential pkg-config protobuf-compiler libssl-dev ca-certificates curl

安装

从发布包安装

在 GitHub Releases 下载当前系统对应的安装包：

• macOS：下载 .dmg，打开后将「天工」拖入「应用程序」目录。
• Windows：下载 .msi 或 .exe，按安装向导完成安装。
• Linux：下载 .AppImage、.deb 或 .rpm，按发行版习惯安装或直接运行。

macOS 安装包已接入 Developer ID 签名与 Apple 公证，可直接打开。

Linux 服务器安装

在无桌面环境的服务器上（VPS、云主机、Docker 容器），推荐通过源码编译获得纯 CLI/Server 二进制（不依赖 WebKit/GTK 等桌面运行时）：

```bash

安装 Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh && source "$HOME/.cargo/env"

编译

git clone https://github.com/silent-rs/Tiangong.git && cd Tiangong cargo build --release sudo install -m 0755 target/release/tiangong /usr/local/bin/tiangong

服务端通过网页配置页完成无界面配置（详见 [`docs/linux-server-deployment.md`](docs/linux-server-deployment.md)）：

使用

天工以桌面应用为主要使用方式，模型配置、插件安装、会话管理与沙箱管理均可在设置页完成。首次启动时若 Sandbox Launcher 尚未就绪，应用会尝试从官方清单安装并验证；安装失败不会阻塞对话，但依赖沙箱的工具会拒绝执行，可稍后在「设置 → 沙箱管理」中重试。源码运行时默认启动桌面应用：

cargo run --release

需要接入外部系统或在无桌面环境运行时，同一入口也提供无界面运行方式（详见 Linux 服务器部署指南）：

tiangong server -d        # 后台启动 Server
tiangong server stop      # 停止后台 Server
tiangong update --check   # 检查更新

更新机制：桌面应用通过设置页或 tiangong update 自动下载安装更新；无界面二进制（Linux 服务器）当前需重新编译或下载新版本二进制替换（tiangong update --check 仅检查版本不自动安装）。配置独立存储在 ~/.tiangong/，更新二进制不丢失配置。

界面预览

网页配置

无桌面环境的全部配置（智能体、模型、Server、插件管理与各插件配置页）统一在网页配置页完成，页面与桌面设置页使用同一套组件；配合 --host / SSH 隧道可在本地浏览器中配置服务器上的天工（详见 CLI 配置指南）：

tiangong config                                  # 本机打开配置页
tiangong config --host 0.0.0.0 --port 8800 --no-open   # 服务器：打印访问地址
tiangong bot start feishu                         # 在后台启动已配置的 Bot（如开机脚本中使用）

tiangong cli 对话中输入 /config 也可打开同一配置页。

配置

默认数据目录：

~/.tiangong/
  models.json           模型配置：Provider + Model + Routing
  server.json           Server 监听配置（host/port/auth_token）
  custom-prompt.md      自定义 Prompt（独立文件，CLI 可直接编辑）
  skills.json           Skill 配置
  sessions/             会话持久化
  logs/                 运行日志
  media/                生成或归档的媒体文件
  data/<插件 id>/        插件自有数据，旧版位于存储根的数据由各插件首次启动时自行迁入：
    mcp/                MCP 配置 mcp.json 与能力缓存
    memory/             长期记忆数据（含独立 config.json）
    scheduler/          定时任务（jobs.json 与运行记录）
    subagent/           Subagent 身份（agents/）与运行态（runtime/）
    index/              工作区与会话全文索引
  auth/                 账号登录凭据（如 ChatGPT OAuth 令牌，默认禁止插件读取）
  plugins-dev/          自建插件开发目录
  sandbox/              Sandbox Launcher 与伴生签名

模型配置采用 Provider、Model、Routing 三层结构。api_key 支持 ${ENV_VAR} 环境变量引用，便于避免明文保存密钥。自定义 Prompt 独立存储为 custom-prompt.md，可在 tiangong config 配置页中编辑。

详细的 Linux 服务器部署、systemd 托管、反向代理与更新策略见 部署指南。

强烈推荐的插件

天工的能力取决于装了哪些插件。下面三个官方插件让 Agent 能直接看到、操作你的电脑，强烈推荐安装；其中 Computer Use 是天工最有特色的插件，建议首先安装。安装方式：「设置 → 插件管理」中从官方目录安装并启用。

插件系统

天工的 Agent 能力全部以插件形式提供并独立演进，主程序只负责运行时、路由与边界。插件通过清单声明入口、权限与能力，运行在受控运行时中与主程序解耦。支持多种插件形态，覆盖从纯界面到带原生 sidecar 的完整场景：

• 人机协同：插件延续天工的人机协同理念，同一个插件既可以向 Agent 声明工具能力，也可以向用户贡献界面与交互（拓展区 App、输入区动作、输入覆盖层、审批与用户征询），让插件成为人与 Agent 共用的协作界面，而不是单向的自动化工具。
• 工具命名与展示：插件工具统一以 {插件id}__{工具名} 暴露给模型，描述标注来源插件，同名工具不再互相覆盖；工具结果抬头、工具行图标（plugin.json 的 tool_icons，支持 工具名:参数=取值 特指声明，如按 action 区分操作）与工具视图（session.message-item 的 replace 贡献声明 tools，接管工具调用展开区；未声明时以文本默认显示）均由插件提供，宿主不按工具名写死展示。
• 权限与能力声明：插件在清单中声明 entrypoints、permissions 与 capabilities，主程序按声明路由请求；实际会话工作区和执行策略由宿主根据调用上下文确定，插件载荷不能自行扩大权限。
• 进程隔离：WASM 逻辑由 Wasmtime 能力边界约束，Sidecar 默认通过 stdio 与宿主通信并由 Sandbox Launcher 启动；命令名称、参数文本不再作为安全边界，最终访问范围由操作系统沙箱实施。
• 独立签名发布：每个插件单独构建、签名和发布，CI 校验签名清单与目录结构，支持默认插件推荐、安装进度展示、按需启停与更新，失败不影响主进程稳定性。
• 自建插件：@silent-ai/plugin-creator 提供 ui-app / ts-tool / ts-npx / node-sidecar / node-tool 五种工程模板，也可用 cargo run -p xtask -- new-plugin <id> 生成纯 UI 最小骨架；构建产物经「设置 → 插件管理 → 导入本地插件」走正式安装链路（清单校验 → 事务安装 → 注册表加载）。官方 Plugin Creator 插件支持在对话中直接创建、构建、签名并安装插件，安装后当前会话即可通过 call_local_plugin 动态调用，无需新开会话。

官方插件一览：

插件源码位于根目录 plugins/，编写自己的插件请参考 插件开发指南。

多智能体协作（`subagent` 插件）

持久 Subagent 适合资料搜集、代码实现、测试验证、方案评审等需要长期身份、跨会话上下文与任务跟踪的工作。Subagent 统一由官方 subagent 插件管理，提供三种运行后端：原生 Subagent（默认，系统为其建立专属会话并跨任务延续上下文）、关联已有天工会话、受管 CLI 进程；在任意会话中激活后绑定当前 Workspace。

内置的进程内 Agent Team 已移除，多智能体协作统一由 subagent 插件提供。升级后如未安装该插件，可在设置的「插件管理」页从官方目录安装；旧会话中已保存的 Agent 消息与事件仍可只读查看。

在扩展区或对话中创建 / 选择持久 Subagent
    ↓
在当前会话激活并绑定 Workspace
    ↓
发送普通消息或提交有完成条件的正式任务
    ↓
完成、阻塞或失败通过可靠反馈返回发起会话

已支持的能力：

• AI 在对话中用 create_agent 工具直接招募成员：同名复用并延续指令与记忆，默认创建后立即激活，可马上派活。
• 长期身份、职责指令、记忆文件和历史产物独立保存；成员完成任务后可自行沉淀经验与追加长期指令。
• 成员之间可直接发送协作消息组成集群，并维护各自的工作规划、背景约定与当前任务。
• 只读、独占写和隔离 worktree 三种 Workspace 策略，同一 Workspace 同时只有一个写入者。
• 管理页统一查看激活关系、待处理工作、任务、运行状态、事件和记忆。

详细设计见 RFC 0011：多智能体协作系统；后续能力以 subagent 插件形式迭代。

嵌入式浏览器（`browser` 插件）

官方 browser 插件提供基于系统 WebView 的多标签浏览器，宿主负责 WebView 容器与标签生命周期，支持 Agent 自主浏览和用户手动操作两种模式协同工作：

• Agent 自主浏览：Agent 可通过 web_fetch 打开网页读取正文，超长正文保留头尾、中间省略，需要细节时用 web_page_text 分段读取或关键词搜索；还可查询 DOM、提取并填写表单、点击元素。
• 用户手动操作：用户在浏览器中浏览、点击、输入时，Agent 通过页面快照感知用户行为，结合对话内容给出上下文相关的建议。
• 浏览历史：支持全局浏览历史和标签页内前进/后退导航，历史记录持久化存储。
• 智能感知：只有引起页面变化（URL 切换、内容更新）时才注入变化内容，快照在队列中只保留最新一条，避免过程数据重复干扰对话。

桌面操控（`computer-use` 插件）

官方 computer-use 插件让 Agent 能操作浏览器之外的原生桌面应用，适合微信、系统设置、自绘界面等无法通过网页或命令完成的场景：

• 应用唤起与分屏：按应用名唤起或启动目标应用，并自动与天工窗口分屏；输入区提供「恢复窗口」按钮，一键还原天工窗口。
• 截图观察：按窗口、区域或全屏截图并直接注入模型上下文，按逻辑尺寸缩放，坐标可直接换算为点击位置。
• 真实输入：系统级键鼠合成（macOS CGEvent / Windows SendInput），支持点击、拖拽、滚动、文本输入和组合键，操作过程以虚拟指针和按键 HUD 可视化展示。
• 控件树：原生控件可读取无障碍树并执行按下、聚焦、赋值等语义动作（macOS AX、Windows UI Automation、Linux AT-SPI2）。
• 平台差异：以上能力在 macOS 与 Windows 上完整可用；Linux 目前仅支持控件树，唤起、截图、键鼠、分屏均未实现，详见 强烈推荐的插件 中的平台支持表。

相关设计见 docs/computer-use/。