Silent-Tiangong（天工）

面向个人工作流的桌面级 AI 自动化中枢：对话、规划、执行、记忆、工具调用、嵌入式浏览器、多智能体协作、移动端控制和定时任务。

天工是一个基于 Rust、Tauri 和 silent 构建的个人智能终端，以桌面应用为核心形态，同时提供无界面运行方式接入脚本、服务或外部消息通道。核心目标不是只回答问题，而是让 Agent 能围绕真实工作区读取资料、拆解任务、调用工具、执行命令、保存长期记忆，并在你主动要求分工时招募 Sub Agent 协作。

天工内置嵌入式浏览器，Agent 可自主打开网页、读取页面内容、点击元素和填写表单，同时感知用户在浏览器中的操作行为，实现人机协同浏览；通过飞书、微信、QQ 等 IM 平台接入移动端控制，可随时随地远程驱动 Agent，配合定时任务和 Webhook 实现按计划或按事件自动执行。

模型方面，天工完全适配 DeepSeek 的上下文缓存机制，多轮对话中历史消息可被高效命中缓存，显著降低重复传输成本并提升响应速度；DeepSeek 适配已跟进 V4 新版接口（deepseek-v4-pro / deepseek-v4-flash），支持思考模式（reasoning_effort 分档控制）、结构化与文本协议双通道工具调用解析，以及流式 KV cache 命中率统计。模型推荐使用 DeepSeek、Kimi 和 智谱，其他模型可以通过自定义供应商接入。

安全提示：天工默认通过独立 Sandbox Launcher 隔离插件 Sidecar 和按需命令进程。Launcher 分别使用 macOS Seatbelt、Linux bubblewrap、Windows AppContainer 与 Job Object 施加系统级边界；程序缺失、签名无效、自检失败或协议不兼容时拒绝启动受保护进程，不会静默降级。用户可以在「设置 → 沙箱管理」中查看状态、更新 Launcher，并按需配置额外允许目录和环境变量黑名单。关闭按需进程沙箱后，对应进程将以当前用户权限运行，请谨慎操作。

项目起源

天工源于一个朴素的想法：让 AI 从对话工具成长为真正参与个人工作流的智能终端。它不仅理解需求，也能围绕真实工作区读取资料、规划步骤、调用工具、操作网页、执行任务，并把过程和结果清晰地呈现给用户。

我们希望人与 Agent 不是简单的“下达任务并等待”，而是在同一个工作环境中持续协作。用户可以随时观察进度、接管操作、补充信息或调整方向；Agent 也能感知这些变化并继续推进。嵌入式浏览器、可视化工具过程和多智能体协作，都是这一理念的自然延伸。

天工面向的不只是编程，而是资料整理、研究分析、内容创作、网页操作、日常自动化和远程协作等广泛场景。能力通过插件持续扩展，模型可以自由配置，重要数据保存在本地，执行过程由明确的权限和沙箱边界约束。

整个项目以 Rust 为基础，优先追求本地运行、可扩展、可治理和长期可维护，让个人能够建立属于自己的 AI 工作中枢。

核心能力

插件系统

天工的能力以插件形式提供并独立演进，插件通过清单声明入口、权限与能力，运行在受控运行时中与主程序解耦。支持多种插件形态，覆盖从纯界面到带原生 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/，编写自己的插件请参考 插件开发指南。

沙箱与执行边界

天工将“执行命令”和“限制命令能做什么”拆成两个职责：Command 插件负责参数解析、受控环境、超时取消、进程清理和输出处理；Runtime 根据权威会话工作区和用户设置生成策略，独立 Sandbox Launcher 负责验证并施加操作系统隔离。这样不依赖命令名称白名单或 Shell 文本猜测，脚本和子进程也会继承同一执行边界。

• 跨平台实现：macOS 使用 Seatbelt，Linux 使用 bubblewrap，Windows 使用 AppContainer 与 Job Object。
• 默认开启：按需 Sidecar 默认进入沙箱；用户可显式关闭按需进程沙箱，变更在下次创建进程时生效。预加载的常驻服务不接受该开关降级。
• 工作区隔离：Runtime 按工具调用所属会话读取真实工作区，不信任插件页面或调用参数自行声明的工作区。
• 用户授权：在「设置 → 沙箱管理」中可以增加任意目录白名单，并维护不传给进程的环境变量黑名单。
• 管理面保护：应用配置、签名密钥、信任库、Launcher 程序与授权配置由宿主强制保护，用户目录白名单不能覆盖这些保护项。
• 可信启动：Launcher 在线安装并独立更新，每次使用前检查签名、自检结果及协议兼容性；不满足要求时受保护进程拒绝启动，但对话和浏览等不依赖 Launcher 的功能仍可使用。
• 必要例外：官方签名的 Terminal 和 Command 可获得完成 Git 工作流所需的凭据只读能力；macOS 官方 computer-use 为继承应用辅助功能授权采用受控直启。第三方或同名自签插件不能获得这些例外。

Sandbox Launcher 也可作为独立程序使用，平台能力、策略格式和更新方式见 tiangong-sandbox 说明。

多智能体协作

持久 Subagent 适合资料搜集、代码实现、测试验证、方案评审等需要长期身份、跨会话上下文与任务跟踪的工作。Subagent 统一由官方 subagent 插件管理；可关联已有天工会话，也可接入受管 CLI 后端，并在任意会话中激活后绑定当前 Workspace。

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

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

已支持的能力：

• AI 在对话中用 create_agent 工具直接招募成员：同名复用并延续指令与记忆，默认创建后立即激活，可马上派活。
• 长期身份、职责指令、记忆文件和历史产物独立保存。
• 关联已有天工会话，复用其上下文和历史处理新任务。
• CLI 运行后端与统一的消息、任务、运行控制接口。
• 只读、独占写和隔离 worktree 三种 Workspace 策略。
• 任务完成后自动归档结论；可从关联会话整理长期记忆。
• 管理页统一查看激活关系、任务、运行状态、事件和记忆。

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

嵌入式浏览器

天工内置基于 WKWebView 的多标签浏览器，支持 Agent 自主浏览和用户手动操作两种模式协同工作：

• Agent 自主浏览：Agent 可通过 web_fetch 工具打开网页、读取页面内容、提取表单、点击元素和填写字段，操作结果自动注入回对话上下文。
• 用户手动操作：用户在浏览器中浏览、点击、输入时，Agent 通过页面快照和网络事件感知用户行为，结合对话内容给出上下文相关的建议。
• 浏览历史：支持全局浏览历史和标签页内前进/后退导航，历史记录持久化存储。
• 智能感知：Agent 在执行过程中自动检测页面变化（URL 切换、内容更新、网络请求），仅在变化时注入数据，避免重复干扰。

移动端控制

天工通过独立 Bot 制品接入第三方 IM 平台，实现移动端远程控制：天工负责下载、配置、启动、监控和升级 Bot，Bot 通过 Server API 与天工通信。平台专属的扫码授权和凭证存储完全由对应 Bot 制品负责，天工只接收运行状态。

• 已支持平台：飞书、微信、QQ，并支持本地自有 Bot 接入与第三方 Bot 目录贡献。
• 扫码配置：桌面端调用 Bot 制品发起扫码，展示授权二维码与状态；扫码所得凭证由 Bot 自行保存，天工不接触明文。
• 运行托管：Bot 随天工自动运行或手动启停，支持日志查看、配置删除、自动注入天工服务地址和 Token，Windows 停止时抑制终端窗口闪现。
• MCP 主动推送：Bot 自动维护已授权主动发过消息的多目标清单，具备文本、图片和文件推送能力，MCP 注册和注销绑定到 Bot 启停流程。
• 远程管理：通过 tiangong bot 子命令可在无图形界面环境下完成 Bot 的全生命周期管理。

定时与触发

调度与触发能力通过 scheduler 插件提供（底层基于 tiangong-scheduler crate），用于按计划或外部事件驱动 Agent 执行：

• 定时任务：JSON 文件存储（~/.tiangong/scheduler/），复用 silent 框架内置 Scheduler，Server 启动时自动恢复已启用的 Cron Job。
• 双模式编辑：桌面端提供简单模式和 Cron 模式两种编辑器，内置校验和下次触发预览，可关联已有会话复用上下文或自动创建新会话。
• Webhook 触发：Server 内置独立于定时任务的 HTTP 触发能力（~/.tiangong/webhooks/），提供无需认证的外部触发端点和需认证的管理端点，支持可选签名验证。
• 结果推送：定时任务和 Webhook 触发的结果可推送到指定 Bot 通道，与移动端控制联动。

架构

天工采用 Cargo workspace 多 crate 结构，核心引擎和各入口解耦：

crates/
  tiangong-types/       公共类型、消息、会话、任务状态和流事件
  tiangong-config/      配置加载、持久化和日志初始化
  tiangong-llm/         LLM 协议抽象和 Provider 封装
  tiangong-anthropic/   Anthropic Messages API 与 SSE 适配
  tiangong-core/        Agent 循环、工具调用、MCP、Skill、多 Agent 团队
  tiangong-memory/      长期记忆、检索、反刍和工作区隔离
  tiangong-bots/        移动端控制：Bot 制品下载、配置、启停和监控
  tiangong-scheduler/   定时任务（Cron）与 Webhook 触发
  tiangong-cli/         CLI / TUI 前端
  tiangong-entry/       统一命令入口
  tiangong-server/      HTTP REST + WebSocket Server
  tiangong-media/       图片、视频、语音等多媒体能力
  tiangong-plugin-runtime/ 插件注册、宿主策略、Sidecar 路由与 Launcher 管理
  tiangong-sandbox/      跨平台 Sandbox Launcher、策略、验签、自检与更新
  tiangong-toolkit/      插件共享的路径、进程和输出辅助能力
  plugins/              可插拔能力（fs/command/fetch/mcp/skill/memory/
                        scheduler/index/media/prompt/coding/computer-use/
                        browser/terminal/interaction 等，含 WASM 与
                        TypeScript/纯 UI 多种形态）
frontend/               桌面前端
src-tauri/              Tauri 桌面壳

核心执行流程：

用户输入
  ↓
会话与工作区上下文装配
  ↓
ReAct 循环：推理、工具调用、观察、继续执行
  ↓ 工具调用
Runtime 根据所属会话和用户设置生成执行策略
  ↓
Sidecar 经 Launcher 进入系统沙箱并通过 stdio 与宿主通信
  ↓ 工具结果返回 ReAct 循环
默认由主 Agent 直接完成；用户要求分工时招募 Sub Agent 协作
  ↓
结构化事件实时推送到桌面界面与无界面入口

安装

从发布包安装

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

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

macOS 当前构建暂未接入 Apple 签名和公证，首次打开如提示应用已损坏，可执行：

xattr -cr /Applications/天工.app

Linux 服务器安装

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

# 安装编译依赖（Debian/Ubuntu）
sudo apt-get install -y build-essential pkg-config protobuf-compiler libssl-dev ca-certificates curl

# 安装 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）：

tiangong model add-provider deepseek --protocol deepseek --base-url https://api.deepseek.com --api-key-env DEEPSEEK_API_KEY
tiangong model add-model deepseek-v4-pro --provider deepseek --model-id deepseek-v4-pro --capability chat
tiangong model route set chat deepseek-v4-pro
tiangong server config set --host 127.0.0.1 --port 8080
tiangong server token generate
tiangong doctor
tiangong server -d

命令行入口

桌面安装包内包含同一个 tiangong 入口，可用于更新、诊断和后台服务。macOS 可创建软链接：

ln -s /Applications/天工.app/Contents/MacOS/天工 /usr/local/bin/tiangong

Windows 可将安装目录加入 PATH。Linux 安装包通常会直接提供可执行入口。

使用

天工以桌面应用为主要使用方式，模型配置、插件安装、会话管理与沙箱管理均可在设置页完成。首次启动时若 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 接入和本地导入流程。

# Rust 检查
cargo check --workspace

# Rust lint
cargo clippy --workspace --all-targets --tests --benches -- -D warnings

# 格式化
cargo fmt

# 前端构建
yarn --cwd frontend build

# 完整检查链
cargo fmt -- --check && cargo check --workspace && cargo clippy --workspace --all-targets --tests --benches -- -D warnings && cargo nextest run --workspace --no-tests pass

前端开发使用 yarn：

yarn --cwd frontend install
yarn --cwd frontend dev

文档

• 插件开发指南
• Sandbox Launcher 使用说明
• CLI 配置指南
• Server API
• Linux 服务器部署指南
• Bot MCP 主动推送设计
• RFC 0011：多智能体协作系统
• RFC 0015：CLI 模块化配置

许可证

Apache License 2.0