文档

快速开始

Conduit 是一个桌面应用。它没有可登录的托管版本,你是在自己的机器上运行它,并使用自己的提供商密钥。

安装

安装包位于 GitHub Releases 页面,当前构建是 最新发布版本,适用于 Windows、macOS 和 Linux。你也可以从源码构建;如果机器上已经装好工具链,整个过程大约需要五分钟。

前置要求

要求版本说明
Node.js20CI 当前基于此版本构建
pnpm10.34.4已固定版本;最简单的方式是执行 corepack enable
Ruststable通过 rustup 安装,并带上 rustfmt 和 clippy
Visual Studio 2022 Build Tools—仅 Windows 需要,用于本地编译

在 Windows 上,仓库自带 check-setup.ps1,会检查这四项并告诉你缺了什么。

构建并运行

terminal
git clone REPO_URL conduit
cd conduit
pnpm install
pnpm dev

pnpm dev 会先启动 Vite 开发服务器,然后启动桌面 shell。第一次 Rust 构建会比较慢,后续构建则是增量的。

命令作用
pnpm dev以开发模式运行应用
pnpm build为你的平台生成原生安装包
pnpm check对 TypeScript workspace 做类型检查

支持的平台

这些二进制文件还没有操作系统级代码签名。 macOS Gatekeeper 和 Windows SmartScreen 会在首次启动时发出警告,因为这些安装包目前没有操作系统级签名。自动更新包会单独签名并验证。从源码构建则可以完全绕过这个警告。

第一次对话

在 Conduit 有能力访问模型之前,它不会让你开始聊天。首次启动时,引导流程会让你选择一个提供商,并提供相应凭据。

使用托管提供商

  1. 打开 设置 → 提供商与密钥(⌘,)。
  2. 选择你的提供商,并粘贴其 API 密钥。
  3. 从 Conduit 通过该提供商拉取到的列表中选择一个模型。

这把密钥会进入你的操作系统凭据存储,即 Windows 凭据管理器、macOS 钥匙串或 Linux Secret Service。Settings(设置)里只保存一个引用,从不保存实际值。在没有钥匙串的机器上,也可以显式选择使用加密的文件型存储。

使用本地模型,无需密钥

安装 Ollama 或 LM Studio,拉取一个模型,然后在设置里选择对应提供商。这样不需要凭据,也不会有任何内容离开你的机器。配合仅本地模式(会彻底拒绝云端提供商)使用时,Conduit 完全不会发出互联网请求。

可以通过 + → 附加文件…、粘贴,或拖放到聊天中来附加图片和文档;在聊天(Chats)中,拖放到聊天的任意位置即可附加,而在其他页面拖放则会把文件添加到文档(Documents)。图片会发给支持图片的模型。PDF、Word、Excel、文本、Markdown、CSV 或 HTML 文件会以文本形式发给每个模型,文本在你的设备上提取;能自行读取 PDF 的模型(Claude、OpenAI、Gemini,以及标明支持文件输入的 OpenRouter 模型)还会收到 PDF 本身,因此图表和扫描页也能读到。每个附件都会说明它将如何发送,或为什么不会发送。

你可以编辑任意一条消息并重新发送:编辑最新一条消息会原地改写它,而编辑更早的消息则会从那一点分叉出一段新对话,原对话保持不变。你还可以将对话导出为 Markdown 或 JSON。

重试会保留每一个回答。重试最后一条回复时,之前的回复会作为一个版本保留下来,回复下方的 ‹ 2 / 3 › 切换器可以在各版本之间切换;对话会从当前显示的那个版本继续。更早的回复也会显示它的各个版本,但不能切换,因为它后面的消息是基于它现有的内容写出来的。重试旁边的箭头会打开模型菜单:你选的模型会再次回答最后一个问题,只对这一条回复有效,对话本身的模型不变。命令面板里也有换一个模型重试…。切换器旁边的比较会在右侧面板中并排打开各个版本,显示每个版本由哪个模型写成、回答内容以及费用。使用这个版本用来为最后一条回复选定一个版本,从此版本创建分支则会从任意版本开始一段新对话。

续写被截断的回复。当回复因达到输出上限而停下时,它下方的提示里会有一个继续按钮。模型会从停下的地方接着写,仍在同一条消息里,你不需要再发新消息。所有提供商都支持这一功能。

模型菜单打开时带有一个搜索框:输入即可筛选所有提供商的列表,按 Enter 选中第一个匹配项;每个提供商的模型按字母顺序排列。推理强度位于聊天设置和 Settings → Chat defaults 中,可选自动、低、中或高。对思考型模型,较低的强度回答更快、花费更少,自动则沿用模型的默认值。它只会发给支持它的模型,并已为 OpenAI、OpenRouter、Anthropic 和 Gemini 做了映射。

Settings → 用量与费用会按天和按模型绘制你的预估费用和 token 图表,并统计每一次模型调用,包括研究运行和工作流步骤。价格依次取自你自己设置的覆盖值、OpenRouter 为其模型列出的价格,以及每个版本内置的 models.dev 目录快照;没有已知价格的模型会如实说明,而不是显示 $0。同一页面还可以在今天的预估支出超过你设定的金额时提醒你:默认关闭,在超出该金额的回复之后每天最多显示一次,并且绝不会中止任何操作。日期的划分与用量图表一致,按 UTC 计算。

支持的提供商

内置提供商共有 23 个——兼容 OpenAI 的端点也算在其中,不是额外加上去的。SambaNova、DeepInfra 和 Novita AI 会公布价格,因此它们的模型会显示费用。

提供商凭据Base URL
AnthropicAPI 密钥可编辑
OpenAIAPI 密钥可编辑
Google GeminiAPI 密钥固定
xAIAPI 密钥可编辑
Z.aiAPI 密钥可编辑
Moonshot AIAPI 密钥可编辑
QwenAPI 密钥可编辑
MiniMaxAPI 密钥可编辑
CerebrasAPI 密钥可编辑
SambaNovaAPI 密钥可编辑
DeepInfraAPI 密钥可编辑
Novita AIAPI 密钥可编辑
NVIDIA NIMAPI 密钥可编辑
DeepSeekAPI 密钥固定
MistralAPI 密钥固定
GroqAPI 密钥固定
Together AIAPI 密钥可编辑
Fireworks AIAPI 密钥可编辑
OpenRouterAPI 密钥固定
OpenCode ZenAPI 密钥固定
Ollama无,本地运行可编辑
LM Studio无,本地运行可编辑
任何兼容 OpenAI 的端点可选可编辑

最后一行包括自托管网关,如 vLLM 和 LiteLLM,也包括尚未有专属适配器的任何厂商:给 Conduit 一个 base URL,如果该端点需要,再提供一个密钥。

接入 GPT、Claude、Grok、GLM、Kimi 等模型

Conduit 可以对接 2026 年实际被大量使用的模型家族——GPT、Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen 和 MiniMax——具体走以下三条路径中的哪一条,取决于你想用的模型。

  1. 内置适配器。Anthropic、OpenAI、Gemini、xAI、Z.ai、Moonshot AI、Qwen、MiniMax、DeepSeek、Mistral、Groq、Together AI、Fireworks AI、Cerebras、SambaNova、DeepInfra、Novita AI 和 NVIDIA NIM 都各自拥有专属提供商:选中它,粘贴密钥,加载模型列表即可。这条路径能直接覆盖 Claude、GPT、Gemini、Grok、GLM、Kimi、Qwen、MiniMax 和 DeepSeek——每一个都自带默认端点,你不需要去查找 base URL。
  2. 网关。OpenCode Zen 或 OpenRouter 会在一个密钥背后收录其余的模型,包括这些服务当下提供的任何其他模型——Conduit 拉取的是实时列表,而不是固定目录。
  3. 任何兼容 OpenAI 的端点。对于没有专属适配器的厂商,或是像 vLLM、SGLang 这样自托管的代理,把兼容 OpenAI 的提供商指向该端点的 base URL,如果它需要密钥就一并提供。

Qwen 的内置适配器默认使用 DashScope 的国际版端点,Moonshot 默认使用 api.moonshot.ai——如果你需要其他区域,这两个字段都可以修改。

键盘快捷键

在 Windows 和 Linux 上,请用 Ctrl 代替 ⌘。

快捷键操作
⌘K命令面板,可搜索、执行命令、切换模型和查找工件
⌘1–⌘9前往首页、聊天、幻灯片、写作、应用、工作流、收件箱、智能体、上下文
⌘N新建对话
⌘,打开 Settings
⌘/打开这个快捷键面板
⌘\切换侧边栏
⌘J切换文档面板
⌘⇧E展开工件面板,或恢复布局
⌘⇧P切换提供商
⌘⇧W切换本轮是否启用网页搜索
⌘⇧F从此处分叉对话
⌘⇧C复制最后一条助手消息
Esc关闭面板,或停止当前响应

命令面板是分模式的:输入 > 查看命令,输入 @ 查找工件,输入 / 选择模型,或者直接输入普通文本来搜索你发过的所有消息。Settings 顶部也有自己的搜索框,可以直接按名称跳到某项设置,不用逐个翻找分区。

工具与连接器

内置工具

这些都不需要额外配置:

除非被标记为只读,工具在运行前都会先征求你的确认。内置的只读工具会自动运行,连接器的工具只有在其服务器把它标记为只读时才会自动运行;其他所有工具在运行前都会先征求你的确认。网页搜索默认是关闭的,首次使用时会征求同意;托管搜索只能通过 Anthropic、OpenAI 或 Gemini 的官方端点运行,一旦你把某个提供商指向自定义 base URL,就会回退到上面的本地后端。发往本地搜索后端的查询会交给对应的服务;默认的 Exa 可能会按其自身条款保留这些查询。

模型的网页抓取只会访问公开的 https 网站:绝不会访问 localhost 或你自己网络中的地址,每次重定向也都会检查。它返回网页的标题和可读文本,而不是原始 HTML,并能读取最大 20 MB 的 PDF。没有文本的扫描版 PDF 算作没有内容可读的网页。

MCP 连接器

Conduit 会以受监管的连接器方式运行 Model Context Protocol 服务器。你可以在连接器页面添加一个本地进程,填入启动它的命令和参数;也可以指向一个使用 streamable HTTP 的远程 MCP 端点。

只有当服务器把某个连接器工具标记为只读(标准的 readOnlyHint,或 Conduit 自己的 permissionLevel 字段)时,它才会不经询问直接运行。其他所有工具都会先询问,你可以让 Conduit 记住这次批准:仅限当前聊天,或始终有效。在 1.0.0-rc.6 之前,大多数第三方服务器上的工具都是不经询问直接运行的,所以你已在使用的连接器现在可能会就以前悄悄运行的工具征求确认。

运行时会对崩溃的本地服务器做退避重启,限制为五分钟内最多三次;它还会限制并发,并把单次调用超时设为三十秒。工具输出在到达模型之前会经过大小限制和脱敏处理,同时还会有结构性防护,防止这些输出被重新当成指令执行,也就是阻断通过工具结果进行提示词注入(prompt injection)的常见路径。

传输方式:当前支持本地 stdio 和远程 streamable HTTP。 不支持旧的 HTTP+SSE。

composer 不仅能调用连接器的工具,还能调用它的 prompt 和 resource:prompt 选择器会先填好某个 prompt 声明的参数,再把结果放进 composer 供你编辑;resource 选择器附加的内容只作用于下一条消息。同意是按连接器逐个征求的,而如果某个 resource 试图夹带指令,它会被拒绝并被点名,而不是被悄悄执行。

在上下文 → 连接器中,运行中连接器的每个工具都会显示它自己声明的性质:只读取、会修改内容,或总是询问。什么都没有声明的工具,每次调用前都会询问;对于你信得过、只会查询信息的工具,勾选仅读取后,它在聊天、智能体和工作流中就不再询问。声明会修改内容、或属于敏感类的工具则仍会询问。当一次聊天要提供的连接器工具超过 20 个,或工具描述很长时,模型拿到的不是完整列表,而是一个 search_tools 工具,由它找到需要的工具,并只在这一轮加载;工具更少时一切照旧,批准方式也和以前一样。如果你的消息里提到了某个连接器,它的工具会直接提供给模型。

在自己机器上连接服务器是文档要解决的问题。把那个服务器摆到客户面前——不用 JSON 配置,也不出现在 Claude Desktop 里面——则是另一个问题。如何向客户演示 MCP 服务器 比较了托管式聊天、配合配置文件的 Claude Desktop,以及交付一个桌面客户端。

Agent 循环

当模型调用工具时,Conduit 会执行它,并在同一轮里把结果回送给模型,继续下一步。你可以在 设置 → 智能体 中控制边界:最大步数可设为 1 到 50,总耗时(wall-clock)预算可设为 30 秒到 30 分钟。聊天界面不再只是一个转圈图标,而是会显示一条实时进度时间线——按跨轮次实际发生的顺序展示思考、工具调用和文本,附带已用时间,并在某一轮卡住时给出提示。

你的智能体

在智能体页面,你只需创建一次智能体——名称、指令、模型、工具、它可以把任务交给哪些智能体,以及 token 上限——之后就能在聊天、任何工作流中使用,或让它按计划运行。工作流保存的是对智能体的引用,所以修改智能体会让所有用到它的地方同步更新;删除智能体时,每个用过它的工作流会各自得到一份副本。新建的配置里带有四个入门智能体:研究员、撰稿人、审阅者和数据分析师。设为有记忆的智能体会在两次运行之间保存自己的笔记,你可以在它的编辑器里查看和修改;读取则让它检索你选定的知识集合。

在聊天中,在消息框里输入 @ 可以为这一轮选择你的某个智能体,也可以点它卡片上的提问。在 设置 → 智能体 下,你可以选择助手可以把任务交给哪些智能体。每次交接都在该智能体自己的模型上运行,并在回复中显示为一行,带有状态、token、费用和用时;回复下方的助手会按模型汇总 token 和费用。一次发出的多项交接会同时运行——默认最多 3 个,在 设置 → 智能体 中可设为 1 到 4 个——但会修改内容的助手,比如使用你的电脑或执行连接器操作的助手,仍然一次只做一件。

点击某次交接,就能观看那个智能体的工作:它的任务、工具调用、token 和费用。停止只会结束那一个助手,改变方向(或直接用消息框)则会在它工作时给它一条新指令。智能体卡片上的按计划运行…可以给它一项任务,每天、工作日、每隔几小时,或在订阅源或文件夹有新内容时执行;每个答案都会进入结果,并可选择发送通知,转为工作流则会把一项例行任务变成可以编辑的普通工作流。文档面板的 ⋯ 菜单可以把聊天中的 HTML、Markdown 或文本文档发给你的审阅者智能体;如果它发现问题,聊天会修订同一份文档。

工件

更长的输出,如文档、脚本或小型网页,会在对话旁边的面板中打开,而不是塞满消息滚动区。Conduit 可以原生渲染文本、带语法高亮的代码、可折叠树形 JSON、Markdown(包括 Mermaid 图表和 KaTeX 公式)以及交互式 HTML。

交互式 HTML 运行在一个只允许脚本、除此之外什么都不允许的沙盒框架中:没有同源访问、没有弹窗、没有顶层导航。表单仍然可以使用——Conduit 会把提交事件交给页面,但提交本身不会把任何内容发送到任何地方。注入的内容策略会设置 connect-src 'none',因此页面无法自行发起请求或打开套接字,而且 Conduit 会从它自己的沙盒地址提供该页面。页面无法调用应用自身的命令。有一个例外,是 macOS 上的已知问题:在 macOS 上,页面的脚本仍然可以建立 WebRTC 连接,内容策略并不覆盖这一点;Windows 和 Linux 在 webview 中已将其拦截。如果你确实需要让工件从特定主机加载图片或字体,可以在 Settings → Privacy & data 的 Artifact Security(工件安全)部分自行放宽。

需要实时数据的页面——比如汇率、天气——仍然可以发出请求。它的 fetch() 调用会先交给 Conduit,Conduit 会拦下对每个新网站的第一次请求,并弹出一条横幅说明是哪个网站。你可以选择只允许这一次、为这个页面始终允许、完全不允许,或者允许该页面访问任何公开网站。之后由 Conduit 代为发起请求:仅限 https,不携带 cookie 或凭据,不访问本地或内网地址,超时时间为 20 秒,响应大小上限为 5 MB,每个页面每分钟最多 120 次请求。页面上的地球图标按钮会列出它请求过的每一个网站和每一次请求。这些权限只属于这一个页面,页面被删除时权限也一并删除。仅本地模式会拒绝这一切;在同一个工件安全设置中关闭“允许页面连接互联网”也能达到同样效果。

把带围栏的代码块粘贴到对话中时,Conduit 会提供将其提升为工件的选项。工件可以导出到磁盘,也可以附带可选的元数据 sidecar 文件。

每个工件只保存一份当前内容。它没有版本历史,编辑会直接原地替换内容,因此任何你想保留副本的东西都应该先导出。

文档

在侧边栏的文档(Documents)中新建一个集合,然后添加文件——支持纯文本、Markdown、CSV、HTML、Word(.docx)、Excel(.xlsx)和 PDF。对于 HTML 文件,Conduit 会读取页面的标题和文本,并略去脚本、样式等代码。你可以在聊天之外,把文件拖放到窗口任意位置来添加,也可以在 composer 里为单次对话附加整个集合。回复会把它所依据的文件显示为可点击的小标签,点开就能看到具体引用的段落。

只有一个文件? 直接把它附加到消息上:+ → 附加文件…、粘贴,或拖放到聊天中。不会建立任何索引,也不涉及嵌入提供商。模型会收到文档的文本(在你的设备上提取),能读取 PDF 的模型还会收到 PDF 本身。无论哪种方式,内容都会作为你消息的一部分发给你选择的聊天提供商;选择 Ollama 或 LM Studio,内容就留在你的机器上。超过 20 MB 的 PDF 只以文本发送,较长文档的文本会在 150,000 个字符处截断。

每个集合只由一个提供商做嵌入——OpenAI、Gemini、OpenRouter 或 Ollama(Anthropic 不能做嵌入)。索引过程会把文档的完整文本发送给这个提供商,因此 Conduit 会在第一次使用时征求同意,按提供商记住你的选择,之后你也可以在文档页面中撤回。选择 Ollama,内容就不会离开你的机器——仅本地模式会强制这一选择。检索本身是混合式的:在同一个本地 SQLite 数据库上同时做向量相似度检索和关键词检索,检索到的段落仍然会发给回答这次对话的提供商。

解析在本地设备上完成,没有 OCR 步骤,所以没有文本层的扫描版 PDF 什么都提取不到——遇到这种情况时,Conduit 会告诉你,而不是导入一份空文档。如果改为附加到消息上,能读取 PDF 的模型仍然可以读懂扫描版 PDF,因为该模型收到的是 PDF 本身。

项目

让一个项目中的每个聊天都使用相同的说明、文档和技能。聊天列表中的项目把聊天按一级分组,不能嵌套;没有任何设置的项目就是普通文件夹。项目的 ⋯ 菜单里有在此新建聊天、项目设置、重命名和删除。删除前会先确认,其中的聊天会保留并移出该项目。在项目设置中可以设置:

项目是在你的设置之上叠加,而不是取而代之。说明按顺序叠加,各自带有标注:先是设置中的说明,然后是项目的,最后是聊天自己的。集合和技能是项目的加上聊天自己添加的。在 composer 中,项目标签会显示聊天属于哪个项目,聊天设置弹出框会列出该聊天还从设置和项目中使用了哪些内容。项目设置在发送消息时读取,所以修改项目会影响其中所有聊天,把聊天移入或移出项目则从下一条消息起生效。工作文件夹是例外:它在创建聊天时复制,因此已在项目中的聊天保留原来的文件夹。

图像生成

OpenAI、Gemini 和 OpenRouter 可以直接在对话中生成图像。由于每张图像都由提供商计费,Conduit 会在生成第一张图像之前征求一次同意——只是聊到图像生成本身并不会触发这个询问。生成结果会作为工件保存在本地,而不是由提供商链接提供,因此不会过期。

个人应用

值得留下的页面可以保存为个人应用:在页面的 ⋯ 菜单中选择另存为应用,就会生成一份副本,你可以从导航栏的应用打开它,也可以从新聊天界面上的你的应用打开。即使删除了那段对话,这份副本也照常可用。保存时会逐项询问要保留该页面的哪些网站权限,你没有勾选的一项都不会保留。之后对话中的页面有变化时,应用会提供更新。内置八个入门应用;可以在应用页面中添加,也可以在带有应用的创意上点击打开应用。

页面(应用,或对话中的页面)还可以声明另外三件事,每一件都由 Conduit 检查。它可以在启动之间保留数据——每个页面最多 5 MB,与你的其他数据存放在一起,开启静态加密时同样加密;清除数据可将其删除。它可以接收几项设置,比如一个城市,由 Conduit 在自己的表单中向你询问,并在不重新加载的情况下传给正在运行的页面。它还可以在你为该页面允许之后向你的 AI 模型提问:提示会指明提供商,并说明何时有文本会离开你的设备,页面得到的只有文本输入和文本输出——没有工具、聊天记录、记忆或文档。

每个个人应用都有自己的设置页面(应用标题栏中的齿轮,或 ⋯ → 设置):由哪个模型回答、每天的 token 用量以及云端模型的每日上限(默认 100,000;你电脑上的模型不受限制)、按键查看的已保存数据(可导出和清除)、它可以使用的网站和提供商,以及一周的单行活动记录——从不记录提示、回复或已保存的值。

幻灯片

描述你的故事,或在任意聊天中要求做一份演示文稿,Conduit 会先起草一份供你批准的故事线,再据此构建一份实时演示文稿:每次修改都是在这份文稿上直接编辑,而不是再生成一个副本。文稿在工作室中打开,中间是放大的幻灯片,聊天窗口在一旁。提出修改要求,助手会只编辑某一张幻灯片,或在整份文稿中替换某个词。

由部件搭建。助手不会编写幻灯片的 HTML:它选择一种版式并填入各个部件——标题、要点、带标签的数字、分栏、引文——再由 Conduit 按主题排版。放不下的过长文字会连同需要缩短的提示一起退回给助手,之后才会生成幻灯片。没有合适版式的幻灯片,仍可使用自由版式。仍然放不下的文字会一档一档缩小,直到仍然可读的字号,而不是重叠或溢出幻灯片;导出的 HTML 和 PDF 与你看到的一致。

用你的数字生成图表。柱状图、折线图和漏斗图由 Conduit 根据助手提供的数据绘制:坐标轴从零开始,柱子按比例绘制,标签不会互相遮挡,字号在房间后排也能看清。全宽图表版式会让图表占满整张幻灯片。助手自己绘制的图示会检查是否有过小的标签。

每次修改后做一次版式检查。助手修改幻灯片后,Conduit 会查看它们的渲染效果。如果文字溢出、重叠、挤到脚注,或者图示无法阅读,助手会获得一轮机会,专门修复这些问题;剩下的会作为备注展示给你。你自己写的文字绝不会被这项检查修改。这项检查能发现上述问题,但不能保证幻灯片设计精良。

脚本把文稿中的每一个字显示为一份文档;可以在那里输入,也可以双击幻灯片上的文字。你写下的文字会在助手重写该幻灯片时保留,除非你要求修改这段文字。历史记录会为每次修改保留一个以你的要求命名的版本,随时可以恢复。内置两套主题,也可以使用助手为你设计的主题。

演示会全屏播放文稿,另有一个独立的演示者视图(当前和下一张幻灯片、演讲者备注、计时器),在你共享幻灯片时保持私密。导出可保存为在任何浏览器中都能自行放映的单个 HTML 文件,或 PDF(仅限 Windows)。幻灯片会向本地数据库添加内容,因此退回到幻灯片功能出现之前的版本会从空数据库开始(旧文件会保留为备份)。

电子表格

要一份预算、价目表、贷款计算器,或任何需要算得对的表格,Conduit 就会做出一张真正的电子表格,在对话旁边打开。助手不会填入自己算好的数字:它写公式,由 Conduit 来计算。数字、货币、百分比和日期格式,多个工作表,冻结的标题行,以及标题、输入值和合计的样式,都是表格的一部分。公式出错时,助手会立刻看到错误(#NAME?、#REF!)并修正。

开口就能修改。和演示文稿一样,它是同一张表格:"加一行安全审计"、"把 C 列改成欧元"或"加一个每月托管费用的工作表",都会修改这张表格,而不是再做一张。新行沿用上一行的格式和公式,紧挨在它上方结束的合计会扩展到包含它。金额使用你要求的货币。表格网格用于查看:点击单元格或用方向键移动,就能在公式栏看到它的公式,用底部的标签页切换工作表。

Excel 进出自如。面板菜单中的另存为 Excel (.xlsx)…会写出一个可在 Excel、Numbers 或 Google 表格中打开的文件,带着公式和计算结果。反过来,把 .xlsx 文件附加到对话,或添加到文档,模型就会把其中的工作表当作表格来读。面板按应用语言的习惯显示数字。

研究

如果一个问题需要的不只是一次快速搜索,就在 composer 的 + 菜单里打开研究(或在首页选择它),然后提问。它要求已开启网页搜索,在仅本地模式下不可用。研究使用本地搜索后端(Exa、Tavily、Brave、你自己的 SearXNG 或 DuckDuckGo),从不使用托管搜索:搜索查询发往该服务,网页文本发往你选择的聊天提供商。

简报。 在任何步骤运行之前,研究会先提出一份简报:它要回答的 1 到 6 个子问题、可选的范围,以及一个深度。你可以编辑并批准它。每种深度规定了它最多能做到哪一步:

它读什么。 它会完整阅读网页,每次三个:包括网页和最大 20 MB 的 PDF,解析在你的设备上完成。扫描版 PDF 没有文本,算作没有内容可读的网页。对于较长的网页或 PDF,模型看到的是开头以及与你的问题相符的部分,而不是全部。

引文核对。 模型会提取论断,每条都附上页面中支持它的原话。只有当引文(至少 20 个字符)确实出现在该网页保存的文本中,这条论断才算数,而这项核对由应用完成,不是模型。随后研究会再次搜索仍未解答的部分,再由撰写者把核对过的论断写成报告。带编号的引用和来源列表也由应用生成,不是模型。

来源可信度。 每个网页都会被评估可信度。可信度较弱的来源会在报告的来源列表中标出,它的论断会注明出处(“一篇未经同行评审的预印本声称……”),或者被省略,绝不会当作既定事实呈现。官方、公共机构和大学的网站绝不会被评为低可信度。这个评级是模型的判断;上面的引文核对则由应用完成。

审阅环节。 报告完成之前,会有一个审阅环节,把每一句话与它所引用的事实以及报告的其余部分逐一核对,并修正或删除它们不支持的内容。研究知道今天的日期,所以“当前”指的是现在,更早的事件按过去来写。因年份、版本、定义或单位不同而有差异的数字会被解释清楚,而不是当作分歧报告;对于未能回答的子问题,会写明哪些网站的页面无法读取。

报告。 结果是聊天文档中的一份 Markdown 文档:摘要、按子问题列出的发现、尚未解决的问题,以及带编号的来源,每条发现都有引用。聊天中的卡片显示摘要,以及已引用和已阅读的来源数量,并带有打开报告按钮。停止会结束运行,并保留到那时为止已找到的内容。

网页无法对它下命令。 网页文本只会进入没有工具的模型调用,所以试图塞入指令的网页无法让它搜索、抓取或保存任何东西。研究的模型调用在它自己的隐藏对话中运行。

局限: 对于较长的网页,模型看到的是节选而不是全部。扫描版 PDF 没有文本。你自己的文档目前还不是来源。思考型模型运行较慢,深入可能在完成之前就达到时间上限。

写作

导航栏中的写作(Ctrl+5,macOS 上为 ⌘5)用于长篇文字:博客文章、技术文档、报告、新闻简报、随笔。可以从导航栏、首页的写作卡片,或首页输入框中的写文章标签打开,然后描述你要写什么。

先有大纲。助手会提出一份大纲:各个章节、每个章节必须讲清什么,以及目标篇幅。你可以编辑、添加、删除或调整章节顺序,并批准它。然后助手会在聊天旁边的 Markdown 编辑器中逐节写出初稿;每一节写好就会立刻出现,初稿会一直写下去,直到大纲的每一节都有了文字。

来源。在来源标签页中,初稿可以上网查找资料(默认关闭)、参考你的文档(Documents)集合,或以一份已完成的研究报告为基础,并优先采用其中经过引文核对的事实。聊天中已完成的研究卡片上有根据此报告写作。来自来源的事实会在初稿中附上链接,没有链接的内容,助手被告知要标上 [TODO],而不是凭空编造。

你写的内容仍然属于你。你输入或修改的任何段落都会被标记为你的,助手会逐字保留,除非你要求修改这段文字;让 AI 编辑可以把它交还给助手。在聊天中提出修改要求,只会重写那一部分。选中文字后可以使用改写、更短、更长、更清楚、修正语法,或输入你自己的指令。显示 AI 写的内容会给助手写的、还没有人编辑过的段落着色。

历史记录会在助手做出每次修改之后以及你自己编辑之后保留一个版本,并可恢复其中任何一个。导出会把初稿保存为 Markdown 或 HTML 文件;如果初稿链接了网页,末尾会附上这些网页的来源列表。

局限: 上网查找资料需要开启网页搜索,在仅本地模式下不可用。只有已完成的研究报告才能作为来源。与研究不同,应用不会对照来源核对初稿中的事实:链接和 [TODO] 标记都是模型的工作,发布之前请自行检查。导出仅支持 Markdown 或 HTML。

工作流

工作流页面会替你运行例行任务。步骤可以抓取网页、搜索网络、运行研究、搜索你的文档、读取工作流专属文件夹中的文件、把 CSV 或 JSON 变成表格、调用你的连接器中只读的工具、让模型做摘要,以及向你提问。结果可以保存为文档、修改幻灯片演示文稿或写作草稿、导出为文件(Markdown、文本、CSV、JSON 或 HTML),或作为记忆建议提出——“保存到记忆”步骤只会提出建议,绝不会自行添加。可以从现成的工作流开始——晨间简报、网页监测、每周研究摘要、每周数据演示文稿——也可以在步骤编辑器中自己搭建。打开任意一次运行,可以看到每个步骤做了什么、用了哪个模型;修好某个步骤后,可从该步骤重新运行,之前的步骤不会重复执行。

也可以直接描述。在工作流页面,或用首页上的“自动化”标签,用你自己的话说出想要什么,聊天模型就会起草一个工作流、检查它,并修复不通过的地方。它会以未保存的状态在编辑器中打开,并附上一份简短清单,列出还需要你来选的内容,例如文件夹或演示文稿;在你说可以之前,不会保存或设定计划。命令面板中的将聊天保存为工作流,会把你在一次聊天中做过的事变成可以再次运行的工作流;它能看到你的消息和用过哪些工具,但看不到网页或文档本身。工作流可以使用自己的模型,每个摘要或 Agent 步骤也可以单独指定:大部分工作用快速、便宜的模型,最后的成文用更强的模型,涉及私密数据的步骤用本地模型。没有选择模型的工作流会跟随聊天所用的模型。

在需要的时候运行。可以立即运行、按计划运行(每天、工作日的固定时间,或每隔几小时),也可以在 RSS 或 Atom 订阅源出现新文章、或其文件夹出现新文件时自动运行:开启自动运行后,每篇新文章或每个新文件都会触发一次单独的运行。“仅当……时继续”步骤会在某个值没有变化、为空或不包含某段文字时悄悄结束运行;通知和保存步骤也可以在要发送或保存的内容与上次相同时自行跳过——所以没有发现新内容的计划运行不会发出通知。如果订阅源或文件夹连续三次读取失败,你会收到一次通知,待它恢复可读后,工作流会自行继续。

开启自动运行时,会先列出工作流可以自行完成的全部操作——它读取的网站、网页搜索、读取的文件夹、连接器、使用的模型和提供商、保存文档——供你批准。如果某次运行需要更多权限(例如编辑之后),它会暂停并询问:允许一次、始终允许或不允许。只读取内容的连接器工具会自行运行;发送、发布或编辑内容的工具会暂停运行并询问你(见下文的“对外操作”)。对演示文稿或草稿的更新绝不会改动你自己写的文字,并且会在更新前后各保留一个版本,因此运行中的“撤销此次更新”或历史记录可以把它恢复。每次运行都有时间和 token 限制,你可以停止正在进行的运行。Conduit 关闭期间错过的运行,会在你打开它时执行一次。

为了在关闭窗口后让计划继续运行,Conduit 可以驻留在托盘并在你登录时在托盘中启动;两者默认都是关闭的,托盘选项只会在你第一次开启计划时提示一次。

用画布查看和修改。打开的工作流可以显示为画布或列表,Conduit 会记住你的选择。画布会画出开始、每个步骤、重复以及它们之间的连线;运行时,每个步骤都会显示它正在运行、已完成、失败、已跳过还是在等你处理,重复步骤会统计已处理的项数。选择一个步骤,可以查看它在某次运行中的输入和输出。编辑时,可以从面板添加步骤,拖动来调整顺序或拖入重复步骤,也可以从一个步骤向另一个步骤拖一根连线,选择哪个输出放入哪个字段。有问题的步骤会被标出,带着未保存的修改离开时会先询问。每个工作流有“步骤”“运行”和“结果”三个标签页。每次完成的运行都会保留它保存的内容并提供预览;“结果”标签页列出这些内容,工作流侧边栏中的“结果”列表涵盖所有工作流并标出未读的,首页则显示工作流的最新动态。

分支和并排的步骤。如果……否则步骤会让运行走向“是”或“否”的一侧,没有走的那一侧会记录为未走此路。一个步骤可以等待任意几个更早的步骤,所以互不依赖的步骤会并排运行,最多同时四个,后面的步骤可以把它们汇合;每个步骤上的运行时机无需拖动连线也能做到同样的事。在此之前保存的工作流依次运行,现在仍然如此。当连接器的只读列表工具返回新内容时,工作流也可以自动开始,检查间隔从 15 分钟到一天:每个之前没见过的条目都会启动一次运行。

对外操作。当某个步骤想使用会发送、发布或编辑内容的连接器工具时,运行会暂停并显示确切的调用。你可以选择发送、编辑后再发送,或不发送(运行会停止并注明原因)。在此工作流中不再询问会让这个操作今后无需询问。在“开始”面板中,对外操作用来为该工作流开启或关闭询问(默认开启),并列出无需询问即可执行的操作,每一项都可以移除。连接器标为敏感的工具总会询问,你在聊天中保留的批准不会带到工作流里。智能体步骤最多可以使用十个连接器工具,也不能调用未在步骤中列出的工具。

智能体和助手。工作流可以定义助手,每个助手有自己的指令、模型、工具和 token 上限。智能体步骤会指明它可以把任务交给哪些助手,为每个助手写一项任务,并取回答案。助手最多只能再往下交办一层,保存时会拒绝助手之间的循环,一个步骤最多交办十二项任务。助手需要的批准与步骤本身相同。智能体页面为每个智能体步骤和助手显示一张卡片:是否正在工作、使用的模型和工具、是否使用你的电脑、交办关系,以及最近 30 天的任务数、失败数和 token 用量,并支持搜索和“全部”“工作中”“助手”筛选。描述一个工作流时,现在可以起草分支、并排的步骤、连接器步骤和助手;模型凭空编造的内容,例如你没有的连接器,会被移除并加以说明。

使用你电脑的智能体。在你开启 Settings → 电脑之前,这一功能是关闭的,那里还有始终询问的规则。工作流按智能体步骤或助手分别选择开启使用电脑,并且必须指定一个文件夹。之后智能体可以在该文件夹中运行命令(带参数的程序,而不是 shell 命令行)、列出、读取和搜索文件,以及写入或编辑文件。每条命令都会先询问,除非工作流的某条允许规则涵盖它,例如 git status *;批准卡片会提供范围最窄的规则,即今后允许此规则。有些命令无论规则如何都会询问:删除文件、git reset --hard、git clean、强制推送、系统和安全工具、shell,以及过长或不常见的命令,另外还有你自己的拒绝规则。有风险的命令会有单独的卡片,主按钮是不运行。智能体读取外部内容之后,例如网页、搜索或连接器的结果,允许规则在这次运行的剩余时间里不再涵盖它的命令,卡片会说明原因。文件修改会显示逐行差异并先询问,除非你允许工作流在它的文件夹中自由修改文件。每个工作流的权限标签页会列出它的命令规则及各自的使用次数、内置的始终询问清单,以及根据你在最近十次运行中批准的命令建议的规则。运行详情会列出每条命令和每次文件修改、批准者、退出码和输出。

限制:在 Windows 上,命令还被限制为不能在文件夹之外写入,网络流量被限制到几乎为零;对无法这样运行的程序,工作流可以关闭这一限制。macOS 和 Linux 没有这种限制,所以在那里,你的批准是唯一的控制手段。

收件箱,以及会等待的运行。收件箱列出你的工作流正在等你处理的一切:提问、审阅、对外操作和命令批准。有事等待时,导航栏会显示一个圆点,新的请求会弹出系统通知。因你而暂停的运行,在你关闭并重新打开 Conduit 之后会继续,保持原来的期限;已完成的步骤不会重新运行,已发出的操作也不会再发一次,如果工作流在等待期间被修改,运行会停止并说明。等待的时间不计入运行的时间上限。

首页

Conduit 打开后先进入首页,它是导航栏中的第一项。一个输入框就能开始任何事:要求做演示文稿,幻灯片会带着故事线打开;其他请求则开始一次聊天。下方的待处理列出等你处理的工作流批准、工作流提问和记忆建议(没有内容时隐藏),工作流的最新动态显示你还没打开的结果,从上次离开的地方继续显示你最近的聊天、演示文稿、草稿和应用,应用的每个区域都有一个带实时数量的卡片;区域为空时则显示一个可以试试的示例。

Ctrl+1 到 Ctrl+9(macOS 上为 ⌘)依次打开首页、聊天、幻灯片、写作、应用、工作流、收件箱、智能体和上下文。管理没有对应的数字;可以从导航栏、首页或命令面板进入,命令面板中为每个区域都提供了“前往”条目。

外观与语言

Conduit 只有一种设计,分两种模式。在 设置 → 外观 中,可以选择深色、浅色或跟随系统,并为每种模式分别挑选主色——按钮、选中内容和当前项目所用的强调色;难以辨认的颜色会被拒绝。同一页面还可以设置界面字号、密度和图表大小。

同一个 Settings 页面会设置界面语言,覆盖 Conduit 提供的全部八种语言。它会改变菜单、按钮、日期和数字的显示方式——但不会改变助手回复所用的语言。

你的数据存放在哪里

Conduit 会把所有内容存到你所在平台的应用数据目录中:对话、消息、提示词和用量记录保存在 SQLite 数据库里;附件和工件则进入按内容寻址的 blob 存储,并按哈希去重。

消息以只追加的事件日志形式写入,并在其上维护一个物化视图,这正是对话在应用中途被强制结束时仍能恢复的原因。启动时,Conduit 会对这两者进行协调。

你也可以在 Settings → Privacy & data 中启用可选的 AES-256-GCM 静态加密,主密钥由你的操作系统钥匙串包裹。它默认关闭,而且目前还不覆盖消息文本,当前范围请查看隐私页面。

故障排查

在 Windows 上构建失败

几乎总是因为缺少 C++ 工具链。安装带有 “Desktop development with C++” 工作负载的 Visual Studio 2022 Build Tools,然后运行 check-setup.ps1 确认。

我的提供商密钥没有保存成功

Conduit 需要可用的操作系统凭据存储。在无头或精简的 Linux 系统上,可能没有运行 Secret Service。你可以启动一个 keyring 守护进程,或者启用加密的文件型凭据存储,但后者需要通过环境变量提供一个密钥。

看不到 Ollama 的模型

请确认 Ollama 正在运行,并且至少已经拉取了一个模型;同时确认 Conduit 为它配置的 base URL 与 Ollama 正在监听的端口一致。

其他问题

你可以从 Settings → Diagnostics 导出诊断包并附到 issue 中。出于设计考虑,其中不包含机密信息、base URL、允许列表或对话内容,而且在生成前会要求你确认其中包含的内容。

查看源码