智能代理
概述
智能代理部分是项目中的核心 AI 工作区。它允许您创建和管理代理标签页——无论是基于 CLI、SDK 还是 ACP。每个标签页运行一个独立的 AI 代理会话，因此您可以同时使用多个代理或对话。
Kaiju Hub AI内置了对Anthropic Claude Code、Google Gemini和OpenAI Codex的支持。Pro版本还支持自定义CLI添加，如OpenCode。
默认打开的代理由您在项目信息区域中选择的提供商和模式决定。每次左键点击+按钮时，都会使用该默认设置打开一个新选项卡。
Kaiju Hub AI 上下文系统
工作原理
Kaiju Hub AI 使用独特的上下文捆绑系统与 AI 代理通信。它不直接发送原始消息，而是将每个提示打包成一个结构化的上下文文件，AI 将其作为一个整体读取。该捆绑包含您的提示文本、任何附加的图片、附加的文件，以及您包含的区块或项目的引用。
当您发送消息时，Kaiju Hub AI 将所有这些部分组装成一个捆绑文件并传递给 AI 代理。代理一次读取整个捆绑，从而完整访问您附加的所有内容，一切都在一个有组织的上下文中。
捆绑内容
提示文本
您发送给 AI 代理的消息作为主要指令包含在内。
附加图片
您附加的任何图片都包含在捆绑中。您不受少量图片的限制——可以在单条消息中发送多张图片。
附加文件
您附加的文件会被捆绑，以便 AI 可以直接读取和引用其内容。
项目引用
如果您从项目中心附加了项目，其路径会被包含，以便 AI 可以直接引用和处理该项目。
区块引用
区块库中的区块可以附加到消息中。AI 将读取并利用区块内容作为其上下文的一部分。
跨会话记忆
每个捆绑在发送后都存储在后端。这意味着 AI 可以引用同一会话中之前标签页的上下文，还可以回顾之前的完整聊天会话。例如，如果您上周就某个特定功能进行了对话，AI 可以回忆您讨论的内容和您提出的要求。
这种跨会话记忆在所有标签页中都有效。如果您在一个标签页中发送了内容，该上下文可供 AI 从任何其他标签页或未来的会话中引用。
为何重要
减少令牌使用
通过将上下文捆绑到结构化文件中而不是附加原始历史记录，系统显著减少了令牌消耗。
更多上下文材料
您可以包含更多上下文——多张图片、多个文件、项目引用和区块——而不会遇到典型的限制。
持久化历史
AI 保持对跨会话过去对话的感知，因此您不需要重复自己或重新解释之前的工作。
添加标签页
概述
代理工具栏中的+按钮允许您创建新的代理选项卡。左键点击+按钮会立即使用在项目信息区域中选择的默认代理打开新选项卡。右键点击+按钮会打开一个下拉菜单，您可以在其中选择特定的代理类型。
支持的代理类型
Markdown 查看器
概述
Markdown 查看器标签页在代理区域内渲染 Markdown 内容。它用于直接在工作区中显示格式化的文档、代理指令、技能文件和其他基于 Markdown 的内容，无需切换到外部编辑器。
功能
富文本渲染
支持完整的 Markdown 语法，包括标题、列表、带语法高亮的代码块、表格、链接和图片。
代理文档
以可读格式查看代理指令文件（CLAUDE.md、agents/*.md、skills/*/SKILL.md）。
内联显示
内容在代理标签页区域内内联渲染，因此您可以在活动代理会话旁阅读文档。
代理区域
概述
代理区域是与 AI 代理交互的主要工作区。它显示聊天消息、带语法高亮渲染代码、显示文件和组件上下文，并提供管理对话的控件。每个代理标签页都有自己独立的代理区域。
标签页组件
代码终端标签页
用于基于 CLI 的代理（Claude Code、Gemini CLI、Codex CLI）。显示类似终端的界面，代理在其中执行命令并实时显示输出。
SDK 聊天标签页
用于基于 SDK 的代理（Claude SDK、Gemini SDK、OpenAI SDK）。提供与代理交互的对话聊天界面。
ACP 聊天标签页
用于 ACP（代理通信协议）代理。专门用于与动态协议代理通信的聊天界面。
代理与技能标签页
浏览和管理代理能力、自定义代理以及当前项目的技能定义。
会话历史面板
查看当前代理类型的所有过去会话日志，并能够加载和回顾之前的对话。
图片画廊
浏览当前项目会话中 AI 代理生成的图片。
上下文历史
概述
上下文历史面板跟踪整个项目中与 AI 代理共享的所有上下文。它将上下文分为内部和外部来源，让您完全了解代理访问了哪些信息。
上下文类型
内部上下文
从项目内部生成的上下文——选定的文件、勾选的代码、组件选择以及您在聊天会话中明确提供给代理的文件内容。
外部上下文
来自项目外部的上下文——网络搜索结果、获取的 URL、导入的文档或代理引用的其他外部数据源。
功能
时间顺序日志
上下文条目按时间顺序列出，以便您追踪共享了什么以及何时共享。
文件注册表
内部文件注册表跟踪与代理共享的所有文件，包括增强的元数据和每个文件的唯一 ID。
上下文指示器
聊天输入区域显示上下文指示器，显示当前附加的文件数量，让您始终了解哪些上下文是活跃的。
上下文模态框
点击上下文指示器可打开详细的模态框，显示所有当前上下文——文件、组件和项目——并提供添加或移除项目的选项。
内部与外部
概述
代理工具栏中的内部/外部切换控制 CLI 代理（包括自定义代理）的启动方式。这决定了代理是在内置工作区终端中运行还是在系统上的单独外部终端窗口中运行。
模式
内部
代理在内置工作区终端中运行。输出在代理区域内内联显示，会话完全由 Kaiju Hub AI 管理。
外部
代理在单独的系统终端窗口中启动（例如 PowerShell、Terminal、iTerm）。当您需要完整的终端环境或想在其他命令行工具旁运行代理时很有用。
Shell 选择器
在外部模式下，会出现一个下拉菜单，让您选择使用哪个 shell（例如 PowerShell、命令提示符、Git Bash）。选定的 shell 用于启动外部 CLI 代理会话。
增强聊天输入
概述
增强聊天输入是代理工作区底部的主要输入区域。它不仅仅是一个简单的文本框——提供图片附件、屏幕录制、文件附件、组件选择、语音输入以及 AI 上下文的精细权限控制。
附件按钮
画廊（图片集合）
打开图片上传模态框，您可以浏览、选择和上传要包含在消息中的图片。支持多选、缩略图和拖放上传。
图片弹出模态框
点击任何附加的图片缩略图可在全尺寸居中覆盖查看器中打开。通过 X 按钮或点击模态框外部关闭。
屏幕录制
直接从聊天输入进行屏幕录制。录制器以可配置的 FPS（30 或 60）捕获帧，跟踪帧数和时长，并生成包含元数据的清单。录制的帧可以附加到消息中以提供视觉上下文。
文件附件
使用回形针图标将项目文件直接附加到消息中。
工作区上下文
使用大脑图标添加工作区上下文——包括项目文件和元数据，以增强 AI 的理解。
组件选择
使用拼图图标从库中选择组件或区块作为上下文。
包含上下文
概述
"包含上下文"按钮是聊天输入区域左侧边栏的第一个图标。它允许您在将消息发送给 AI 代理之前附加项目上下文——如已勾选的文件、选定的组件或工作区元数据。
使用方法
左键点击
打开上下文面板，您可以浏览和选择要在下一条消息中包含的文件和项目上下文。
右键点击
立即将当前上下文包含在消息中，无需打开面板。这是一个快捷方式，用于附加当前选定的文件和上下文。
项目图片
概述
项目图片面板是与项目关联的所有图片的集中画廊。上传截图、设计稿、参考图片或任何您想附加到 AI 对话中或在工作区内保持整理的视觉资产。
功能
上传图片
点击上传区域或直接将图片拖放到面板中。您也可以使用 Ctrl+V / Cmd+V 从剪贴板粘贴图片。
图片网格
上传的图片以缩略图网格显示，便于浏览和选择。
选择控制
点击选择单张图片，或使用全选/取消全选来管理批量选择。选定的图片可以通过"全部删除"来删除。
附加到消息
选定的图片可以在向 AI 代理发送消息时作为视觉上下文包含，为您的请求提供参考材料。
屏幕录制
概述
屏幕录制面板允许您捕获屏幕录制并配置捕获设置。录制的帧保存为图片，可以附加到 AI 代理对话中，为您的请求提供视觉上下文。
捕获设置
捕获速度
在慢速（2 FPS）和正常（4 FPS）之间选择。如果录制太快或遗漏内容，使用慢速。正常速度捕获更多细节但使用更多存储。
每张图片帧数
控制每张图片合并多少帧。设为 1 表示单独截图，较高的值则生成在单张图片中显示多帧的网格组合。
网格列数
设置将多帧合并为单张图片时的网格布局列数。使用 1 表示垂直堆叠，较高值表示宽网格。
捕获源
选择要捕获的屏幕或显示器。显示可用的显示器及其分辨率和位置详情。主显示器会标记以便识别。
录制标签页
录制标签页显示所有之前捕获的录制。浏览过去的会话，查看捕获的帧，并将它们附加到新的 AI 对话中作为视觉参考。
设置
概述
设置面板为活动的 AI 代理提供配置选项。从聊天输入侧边栏的齿轮图标访问。设置控制权限模式和其他代理特定的行为。
权限模式
跳过所有权限
启用后，绕过代理的所有权限检查（等同于 --dangerously-skip-permissions）。这允许代理在没有确认提示的情况下执行文件编辑、终端命令和其他操作。
需要重启
权限设置的更改在下次会话时生效。关闭并重新打开代理标签页以应用新配置。
语音输入
概述
语音输入按钮是聊天输入侧边栏底部的麦克风图标。它提供平台原生的语音转文本功能，让您可以通过语音向 AI 代理口述消息而不是打字。
工作原理
激活
点击麦克风图标开始语音输入。监听时图标显示活动状态。
口述
自然说话，您的语音会使用系统的语音识别功能（Windows 上的 Windows Speech、macOS 上的听写）实时转录到聊天输入字段中。
发送
口述完成后，查看转录的文本，点击发送或按 Enter 将消息提交给代理。
快捷方式
鼠标中键
在 Windows 和 Mac 上（如果鼠标有中键），按中键开始录制。在聊天输入区域再次点击中键停止录制并自动发送消息。
自定义快捷键
您可以在设置的语音标签页中设置语音输入的自定义键盘快捷键。这允许您无需使用鼠标即可开始和停止语音录制。