16 · 工作区模块参考（Workspace Crates Reference）

代理式研究运行时 · 本章是 jcode DeepWiki 中文译文的独立章节页，保留原始链接、源码锚点、模块标签和章节层级。

项目jcode 章节16 状态全文译文模块智能体运行时、界面与交互、模型调用与提供方适配、系统架构

项目要点页2.5 参考项目项目章节目录jcode DeepWiki 原始章节Workspace Crates Reference 上一章15.3 下一章16.1

源码线索

Cargo.lock
Cargo.toml
docs/COMPILE_PERFORMANCE_PLAN.md
docs/CRATE_OWNERSHIP_BOUNDARIES.md
scripts/bench_selfdev_checkpoints.sh
scripts/check_dependency_boundaries.py
src/ambient/directives.rs
src/ambient/manager.rs
src/ambient/paths.rs
src/ambient/persistence.rs

模块标签

智能体运行时
界面与交互
模型调用与提供方适配
系统架构
测试、发布与运维

中文译文

工作区模块参考（中文译文）

原始 DeepWiki 页面：https://deepwiki.com/1jehuang/jcode/16-workspace-crates-reference

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

翻译模型：deepseek-chat

原文字符数：6000

项目：jcode (jcode)

---

工作空间包参考

架构总览

下图将高级系统功能映射到实现这些功能的具体工作空间包和代码实体。

系统到代码实体映射

graph TD
    subgraph "自然语言空间"
        A["大语言模型（LLM）提供商"]
        B["向量搜索"]
        C["用户通知"]
        D["多会话用户界面"]
        E["自主任务"]
    end

    subgraph "代码实体空间（包）"
        A --> PC["jcode-provider-core"]
        A --> PG["jcode-provider-gemini"]
        A --> PO["jcode-provider-openrouter"]

        B --> JE["jcode-embedding"]

        C --> JNE["jcode-notify-email"]

        D --> JTW["jcode-tui-workspace"]

        E --> JOC["jcode-overnight-core"]
    end

    subgraph "关键代码符号"
        PC --- S1["shared_http_client()"]
        PG --- S2["VertexGenerateContentRequest"]
        PO --- S3["parse_model_spec()"]
        JE --- S4["Embedder::load_from_dir()"]
        JNE --- S5["SendEmailRequest"]
        JTW --- S6["WorkspaceMapWidget"]
        JOC --- S7["OvernightManifest"]
    end

来源：crates/jcode-provider-core/src/lib.rs:8-22、crates/jcode-provider-openrouter/src/lib.rs:228-241、crates/jcode-embedding/src/lib.rs:99-122、crates/jcode-notify-email/src/lib.rs:16-26、crates/jcode-overnight-core/src/lib.rs:1-20。

---

提供商与认证包 {#16.1}

这些包处理不同大语言模型（LLM）后端的抽象以及企业级认证的复杂性。

jcode-provider-core：包含所有提供商共用的基础 shared_http_client，用于最小化 TLS 开销。它定义了成本估算类型（如 RouteCheapnessEstimate）以及 openai_schema 规范化的共享逻辑。
jcode-provider-metadata：管理模型目录和配置文件选择，使系统能够将用户友好的模型名称映射到特定的 API 端点。
jcode-provider-openrouter：实现 OpenRouter 的专用逻辑，包括模型规范解析（例如 model@provider! 语法）和端点健康/延迟缓存。
jcode-provider-gemini：处理与 Google Code Assist 的集成，包括 Google Cloud 的原生 OAuth 流程。
jcode-azure-auth：一个专用工具，用于获取 Microsoft Entra ID（原 Azure AD）令牌，以安全访问 Azure OpenAI 实例。

详情请参阅提供商与认证包。

---

运行时与工具包 {#16.2}

这些包为代理运行时、向量嵌入向量和辅助通信通道提供"繁重工作"。

核心运行时与嵌入向量

jcode-agent-runtime：定义基础错误类型（StreamError）和信号队列（如 SoftInterruptQueue 和 BackgroundToolSignal），允许 TUI 中断正在运行的大语言模型（LLM）生成或工具执行。
jcode-embedding：封装 tract ONNX 运行时，以在本地运行 all-MiniLM-L6-v2 模型。它提供 Embedder 结构体，该结构体使用 384 维空间执行文本 Token 化和向量推理。

通知与用户界面

jcode-notify-email：提供 SMTP 和 IMAP 集成。它可以发送带有"批准/拒绝"按钮的富 HTML 权限请求，并通过 IMAP 轮询回复。它被 AmbientRunner 用于处理远程用户指令 src/ambient/directives.rs:13-21。
jcode-pdf：一个工具包，用于从 PDF 文档中提取文本和结构，作为代理的上下文。
jcode-tui-workspace：包含专门的 TUI 组件，例如 WorkspaceMapWidget，用于可视化多会话环境中不同活动会话之间的关系。
jcode-overnight-core：定义自主长期运行任务的数据结构，包括 OvernightManifest 和任务卡片定义。

运行时交互流程

sequenceDiagram
    participant J as jcode (主程序)
    participant E as jcode-embedding
    participant N as jcode-notify-email

    J->>E: Embedder::load_from_dir()
    J->>E: embed("用户查询")
    E-->>J: EmbeddingVec (f32)

    Note over J, N: 如果触发了安全操作
    J->>N: build_permission_email_html()
    J->>N: send_email(SendEmailRequest)
    N-->>J: Result<()>

来源：crates/jcode-embedding/src/lib.rs:99-122、src/ambient/directives.rs:45-55、docs/COMPILE_PERFORMANCE_PLAN.md:42-60。

详情请参阅运行时与工具包。

--- 来源：docs/CRATE_OWNERSHIP_BOUNDARIES.md:1-100、Cargo.toml:8-61、src/ambient/manager.rs:14-29、src/ambient/persistence.rs:13-51、scripts/check_dependency_boundaries.py:19-51。