17 · 术语表（Glossary）

术语表（中文译文）

原始 DeepWiki 页面：https://deepwiki.com/1jehuang/jcode/17-glossary

翻译时间：2026-05-27T08:45:33.822Z

翻译模型：deepseek-chat

原文字符数：19046

项目：jcode (jcode)

---

术语表

相关源文件

以下文件被用作生成此 Wiki 页面的上下文：

• crates/jcode-overnight-core/Cargo.toml
• crates/jcode-overnight-core/src/helper_tests.rs
• crates/jcode-overnight-core/src/lib.rs
• crates/jcode-overnight-core/src/prompts.rs
• src/agent.rs
• src/bin/tui_bench.rs
• src/compaction.rs
• src/compaction_tests.rs
• src/import_tests.rs
• src/lib.rs
• src/main.rs
• src/memory.rs
• src/memory_agent.rs
• src/memory_tests.rs
• src/message.rs
• src/overnight.rs
• src/protocol.rs
• src/protocol_tests.rs
• src/provider/anthropic.rs
• src/provider/claude.rs
• src/provider/copilot.rs
• src/provider/mod.rs
• src/provider/openai.rs
• src/server.rs
• src/server/client_actions.rs
• src/server/client_comm.rs
• src/server/client_lifecycle.rs
• src/server/client_session.rs
• src/server/client_state.rs
• src/server/comm_control.rs
• src/server/comm_session.rs
• src/server/comm_sync.rs
• src/server/swarm.rs
• src/session.rs
• src/sidecar.rs
• src/tool/communicate.rs
• src/tool/memory.rs
• src/tui/app.rs
• src/tui/app/commands_overnight.rs
• src/tui/app/conversation_state.rs
• src/tui/backend.rs
• src/tui/info_widget.rs
• src/tui/info_widget_memory_render.rs
• src/tui/markdown.rs
• src/tui/mermaid.rs
• src/tui/mod.rs
• src/tui/ui.rs

本页面提供了 jcode 代码库中使用的特定术语、行话和架构概念的全面参考。它作为技术桥梁，帮助新入职的工程师理解高层领域概念与其在 Rust 源代码中具体实现之间的映射关系。

核心运行时概念

智能体（智能体）

管理单个对话会话的核心状态机。它负责编排大语言模型（LLM）提供者、工具执行和会话持久化之间的循环。

• 实现：Agent 结构体，位于 src/agent.rs:139-188。
• 关键循环：run_turn（及其辅助方法）处理修复、内存注入、提供者调用和工具执行的序列 src/agent.rs:13-14。
• 中断：管理诸如 soft_interrupt_queue、background_tool_signal 和 graceful_shutdown 等信号 src/agent.rs:166-171。

会话（会话）

对话的持久化记录，包含消息历史、元数据（模型、提供者）和环境快照。

• 实现：Session 结构体，位于 src/session.rs:64-155。
• 持久化：使用 JSON 快照和 JSONL 日志的混合模型，确保崩溃恢复和性能 src/session.rs:12-15。

工具注册表（工具注册表）

负责发现和调用智能体可用工具（Tool）能力的子系统。它管理内置工具、本地项目工具和动态 MCP 工具。

• 实现：Registry 结构体，位于 src/agent.rs:141 和 src/tui/app.rs:20。
• 上下文：工具使用 ToolContext src/agent.rs:40 执行，该上下文提供对文件系统和会话状态的访问。

上下文压缩（压缩）

减少对话历史 Token 数量的过程，以适配模型上下文限制，同时保留必要信息。

• 实现：CompactionManager 和 CompactionEvent，位于 src/tui/app.rs:8 和 src/agent.rs:30。
• 模式：通过 handle_set_compaction_mode 进行管理 src/server/client_lifecycle.rs:34。

来源：src/agent.rs:139-188、src/session.rs:64-155、src/tui/app.rs:8-20、src/server/client_lifecycle.rs:34

---

服务器与多客户端架构

jcode 采用单服务器、多客户端模型运行，使用 Unix 域套接字（或 Windows 命名管道）。

Shared 服务端（共享服务器）

管理多个活跃 Agent 实例并协调"Swarm"活动的后台进程。

• 实现：ServerRuntime 处理核心服务器循环 src/server.rs:52。
• 生命周期：通过 client_lifecycle.rs 管理，该文件处理换行符分隔的 JSON 协议并处理会话附加 src/server/client_lifecycle.rs:1-12。

Swarm（集群）

协调层，允许多个智能体（会话）在同一仓库中协同工作。

• 协调器：管理集群状态和任务分配的主会话 src/server.rs:105。
• 通信：通过 handle_comm_message 处理会话之间的广播或直接消息传递 src/server/client_lifecycle.rs:8。

Socket Handoff / Reload（套接字移交/重载）

一种在不中断活跃客户端连接的情况下更新 jcode 二进制文件的机制。服务器通过 exec 执行新二进制文件并传递监听套接字文件描述符。

• 逻辑：位于 src/server/reload.rs 和 src/server/socket.rs。

图表：服务器-客户端实体映射

此图表将概念性的"远程连接"桥接到服务器中的具体代码实体。

graph TD
    subgraph "客户端空间（TUI）"
        A["App (src/tui/app.rs)"] -- "RemoteConnection" --> B["TcpStream/UnixStream"]
    end

    subgraph "服务器空间（jcode 服务器）"
        B -- "JSON 协议" --> C["handle_client (src/server/client_lifecycle.rs)"]
        C --> D["ServerRuntime (src/server/runtime.rs)"]
        D --> E["SessionAgents: HashMap<String, Arc<Mutex<Agent>>>"]
        E --> F["Agent (src/agent.rs)"]
        F --> G["Session (src/session.rs)"]
    end

    subgraph "协调层"
        D --> H["SwarmState (src/server.rs)"]
        D --> I["SwarmMutationRuntime (src/server/swarm_mutation_state.rs)"]
    end

来源：src/server.rs:96-108、src/tui/app.rs:43-50、src/server/client_lifecycle.rs:1-60

---

TUI 与渲染子系统

ProcessingStatus（处理状态）

当前 UI 请求的生命周期状态，用于驱动动画（如 Chroma Wave）和状态指示器。

• 变体：Idle、Sending、Connecting、Thinking、Streaming、RunningTool src/tui/app.rs:32。

InfoWidget（信息组件）

浮动 UI 面板，占据终端中的空白区域，显示上下文使用情况、集群状态或图表。

• 实现：WidgetKind，位于 src/tui/info_widget.rs:71-102。
• 优先级：每个组件都有 priority（优先级）和 preferred_side（首选侧，Left/Right），用于布局计算 src/tui/info_widget.rs:106-144。

Mermaid 管线（Mermaid 管线）

使用图像将 Mermaid 图表渲染到终端的系统。

• 实现：src/tui/mermaid.rs。
• 流程：源代码 -> jcode_tui_mermaid -> 终端协议（Kitty/Sixel/iTerm2）src/tui/mermaid.rs:1-16。

图表：Markdown 到终端 UI 流程

此图表展示了大语言模型（LLM）的 Markdown 内容如何转换为 TUI 中的可视化元素。

graph LR
    subgraph "输入处理"
        A["StreamEvent (src/message.rs)"] --> B["StreamBuffer (src/tui/stream_buffer.rs)"]
    end

    subgraph "渲染引擎"
        B --> C["IncrementalMarkdownRenderer (src/tui/markdown.rs)"]
        C --> D{块类型？}
        D -- "文本/代码" --> E["syntect 高亮"]
        D -- "Mermaid" --> F["Mermaid 管线 (src/tui/mermaid.rs)"]
    end

    subgraph "UI 组合"
        E --> G["draw_messages (src/tui/ui_viewport.rs)"]
        F --> H["IMAGE_STATE (jcode-tui-mermaid)"]
        H --> G
        G --> I["ratatui::Frame"]
    end

来源：src/tui/markdown.rs、src/tui/mermaid.rs、src/tui/ui.rs:169、src/tui/app.rs:32

---

内存与智能

记忆管理器（内存管理器）

管理事实和偏好的长期存储。

• 实现：MemoryState 及相关类型，位于 src/tui/info_widget.rs:32-35。
• Sidecar（伴生进程）：MemoryActivity 组件跟踪后台内存智能体的相关性验证和级联检索 src/tui/info_widget.rs:81。

提供方特征（提供者特征）

不同大语言模型（LLM）后端（Anthropic、OpenAI、OpenRouter 等）的抽象层。

• 定义：Provider 特征，位于 src/provider/mod.rs:40-48。
• 原生压缩：某些提供者（如 OpenAI）支持 OpenAINativeCompactionMode，使用 encrypted_content 高效维护会话上下文 src/provider/openai.rs:129-158。

Soft Interrupt（软中断）

一种在不取消当前生成的情况下，将信息（如集群警报或任务完成通知）注入智能体上下文的机制。

• 实现：SoftInterruptQueue，位于 src/agent.rs:167。

---

缩写与行话

术语	定义	代码指针
MCP	模型上下文协议（Model Context Protocol）——用于动态工具发现。	src/tui/app.rs:11
TUI	终端用户界面（Terminal User Interface，基于 ratatui）。	src/tui/mod.rs
JSONL	JSON Lines——用于会话日志记录的格式。	src/session.rs:12
RSS	常驻内存集大小（Resident Set Size）——为 jemalloc 调优而跟踪。	src/main.rs:7-19
Sixel/Kitty	用于图表渲染的终端图像协议。	src/tui/mermaid.rs:1-16
EWMA	指数加权移动平均（Exponentially Weighted Moving Average）——用于计时和资源调度。	src/tui/app.rs:8
KV Cache	键值缓存（Key-Value Cache）——跟踪命中率以评估提供者效率。	src/tui/info_widget.rs:91
Overnight	用于大型任务的长时间运行自主智能体模式。	src/overnight.rs

来源：src/main.rs:7-19、src/agent.rs:167、src/server.rs:52、src/tui/app.rs:8-32、src/provider/mod.rs:40-48、src/tui/mermaid.rs:1-16、src/session.rs:12-15