沉默天宫

安装编译依赖（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 当前构建暂未接入 Apple 签名和公证，首次打开如提示应用已损坏，可执行：

xattr -cr /Applications/天工.app

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/silent-Tiangong.git && cd silent-Tiangong cargo build --release sudo install -m 0755 target/release/tiangong /usr/local/bin/tiangong

服务端通过模块化 CLI 完成无界面配置（详见 [`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/，更新二进制不丢失配置。

模块化配置（0.12.0+）

无桌面环境可通过 CLI 完成与桌面设置页等价的分模块配置（设计详见 RFC 0015）：

tiangong model list                      # 查看模型配置
tiangong model route set chat deepseek-v4-pro  # 切换 chat 模型
tiangong server token show               # 查看 Server Token
tiangong memory enable                   # 启用 Memory
tiangong prompt edit                     # 编辑自定义 Prompt
tiangong bot list                        # 查看已配置 Bot
tiangong bot start feishu                # 启动指定 Bot
tiangong config show                     # 配置概览
tiangong doctor                          # 环境诊断

配置

默认数据目录：

~/.tiangong/
  models.json           模型配置：Provider + Model + Routing
  server.json           Server 监听配置（host/port/auth_token）
  custom-prompt.md      自定义 Prompt（独立文件，CLI 可直接编辑）
  skills.json           Skill 配置
  mcp.json              MCP 配置
  sessions/             会话持久化
  logs/                 运行日志
  media/                生成或归档的媒体文件
  memory/               长期记忆数据（含独立 config.json）
  sandbox/              Sandbox Launcher 与伴生签名

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

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

插件系统

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

• 人机协同：插件延续天工的人机协同理念，同一个插件既可以向 Agent 声明工具能力，也可以向用户贡献界面与交互（拓展区 App、输入区动作、审批与用户征询），让创建的插件成为人与 Agent 共用的协作界面，而不是单向的自动化工具。
• 权限与能力声明：插件在清单中声明 entrypoints、permissions 与 capabilities，主程序按声明路由请求；实际会话工作区和执行策略由宿主根据调用上下文确定，插件载荷不能自行扩大权限。
• 进程隔离：WASM 逻辑由 Wasmtime 能力边界约束，Sidecar 默认通过 stdio 与宿主通信并由 Sandbox Launcher 启动；命令名称、参数文本不再作为安全边界，最终访问范围由操作系统沙箱实施。
• 独立签名发布：每个插件单独构建、签名和发布，CI 校验签名清单与目录结构，支持默认插件推荐、安装进度展示、按需启停与更新，失败不影响主进程稳定性。
• 自建插件：提供脚手架与工程模板（ui-app / ts-tool / ts-npx / node-sidecar），可通过 cargo run -p xtask -- new-plugin <id> 或 @silent-ai/plugin-creator 初始化；构建产物经「设置 → 插件管理 → 导入本地插件」走正式安装链路（清单校验 → 事务安装 → 注册表加载），官方 Creator 插件还支持在天工内直接创建、签名并安装插件。

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