silent-Tiangong: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

Silent-Tiangong（天工） 是全功能可扩展的 GUI + CLI + Server 个人智能终端平台，实现"可对话、可规划、可执行、可扩展、可治理、可远程"的 Agent 能力闭环。支持通过 Connector 接入各类 IM 通道远程调度，并具备图片/视频等多媒体生成能力。

• 语言: Rust (edition 2024)
• 架构: Cargo workspace 多 crate
• 前端: Tauri + React (GUI) / ratatui (TUI)
• Server: silent (HTTP/WS)
• 许可: Apache License 2.0
• 存储位置: ~/.tiangong/

常用开发命令

# 构建
cargo build --release

# 检查（快速验证）
cargo check --workspace

# Lint（严格遵守 warnings）
cargo clippy --workspace --all-targets --tests --benches -- -D warnings

# 格式化
cargo fmt
cargo fmt -- --check  # 仅检查

# 依赖检查
cargo deny check --disable-fetch

# 测试
cargo nextest run --workspace
cargo nextest run --workspace --no-tests pass  # 无测试时通过

# 完整检查链（提交前自动执行）
cargo fmt -- --check && cargo check --workspace && cargo clippy --workspace --all-targets --tests --benches -- -D warnings && cargo nextest run --workspace --no-tests pass

# 运行应用
cargo run --release              # 桌面 UI 模式（默认）
cargo run --release -- cli       # CLI 模式

当前 Core 架构

现行说明见 docs/core-architecture.md 与 docs/agent-loop-refactor/design.md。

当前 crates/tiangong-core 的执行模型是：

• TiangongCore 接收用户消息和控制输入；
• 空闲用户消息通过 start_user_turn 从最新 Session 构建 TurnContext，随后创建一个 turn task；
• 运行中的用户消息通过当前 task 自有命令通道发送 Command::InjectUserMessage，在该 turn 内中断活动、保存新消息并重新分析；
• shared_runtime 只管理共享 Tokio runtime 和活跃 turn task 注册表；
• 每个 turn task 持有自己的上下文和命令接收端，结束后通道随之失效；
• 当前代码不存在常驻 Agent Driver 或 Agent Inbox。

核心模块：

• crates/tiangong-core/src/core/：Core 对外入口、插件装配和输入协调；
• crates/tiangong-core/src/shared_runtime.rs：共享 runtime 与 turn task 生命周期；
• crates/tiangong-core/src/react/：单轮 Agent Loop、命令、工具、压缩和收尾；
• crates/tiangong-core/src/turn_context.rs：单轮执行上下文；
• crates/tiangong-core/src/session.rs：会话消息和持久化状态；
• crates/tiangong-core/src/model.rs：模型客户端抽象。

审查或设计 Core 功能时必须以当前代码和上述两份现行文档为准，不得使用已经删除的 Driver/Inbox 迁移方案。

代码风格约定