项目侧边栏
概述
项目侧边栏是项目工作区的中央导航枢纽。它提供了工作中所需的每个主要工具和面板的快速访问——从文件管理和版本控制到 AI 聊天会话、任务跟踪、部署等。每个面板都以滑出式覆盖层打开,因此您可以在工具之间跳转而不离开当前视图。
侧边栏沿项目工作区的右侧边缘运行,包含每个面板的图标按钮。点击图标打开该面板的覆盖层,再次点击(或按 Escape)关闭它。侧边栏始终可见,是与项目工具交互的主要方式。
可用面板
侧边栏包含以下面板,每个面板都在下面的章节中有详细文档:
收藏
收藏和整理最常用的项目文件,以便即时访问。
聊天
管理 AI 聊天组、代理会话和对话历史。
GitHub
查看仓库状态、分支、提交和管理拉取请求。
任务
跟踪项目任务、分配优先级和管理工作流程。
部署
监控并触发到已配置托管提供商的部署。
历史日历
在日历时间线上浏览项目活动和文件变更。
构建
查看项目构建的构建日志、状态和输出。
文件树
管理文件树显示设置和项目级操作。
提示框
快速访问提示输入,用于向 AI 代理发送指令。
区块组库
浏览和管理区块库中的可重用组件区块。
已选文件
查看和管理当前选择用于批量操作的文件。
搜索
在整个项目中搜索文件、代码和内容。
隐藏文件
配置在文件树中隐藏的文件和文件夹。

收藏面板
概述
收藏面板是一个侧边栏覆盖层,允许您收藏和整理最常用的项目文件以便快速访问。无需每次都在文件树中查找,将重要文件标记为收藏即可即时找到。
功能
收藏切换
点击任何文件上的星标图标可将其添加到收藏或从收藏中移除。已收藏的文件会出现在收藏面板中以便快速访问。
分组整理
将收藏文件整理到自定义分组中。分组保存在本地,会在会话之间保持。
多文件选择
一次选择多个收藏文件并执行批量操作,如将它们全部添加到任务中。
添加到任务
选择一个或多个收藏文件,一键直接添加到任务中,简化工作流程。
收藏计数器
徽章显示已收藏文件的总数,让您随时了解保存了多少文件。

聊天面板
概述
聊天面板是一个侧边栏覆盖层,用于管理 AI 聊天组和代理会话。它提供了一个中心位置来浏览、创建、编辑和删除聊天对话,以及查看 CLI、SDK 和 ACP 会话日志。
标签页
聊天
浏览和管理 AI 聊天组。创建新组、重命名、搜索现有组或删除不再需要的对话。
CLI
查看基于 CLI 的代理(如 Claude Code、Gemini CLI 和 Codex CLI)的会话日志。每个会话显示代理类型及其品牌标志。
SDK
查看基于 SDK 的代理(包括 Claude SDK、Gemini SDK 和 OpenAI SDK 集成)的会话日志。
ACP
查看 ACP(代理通信协议)代理的会话日志,包括其配置和执行历史。
功能
聊天组管理
创建、重命名、搜索和删除聊天组。每个组可以容纳一个带上下文的完整对话线程。
分页
会话每次加载 50 项,对于大量历史记录提供"加载更多"按钮。
多选
使用 Shift+点击进行跨会话的范围选择。对选中的项目执行批量删除或其他操作。
上下文菜单
右键点击任何会话可访问快捷操作,如删除或查看详细日志。
代理识别
每个会话显示所用 AI 代理的品牌标志(Claude Code、Gemini、Codex、ACP),便于一眼识别。

GitHub 面板
概述
GitHub 面板是一个侧边栏覆盖层,用于直接在 Kaiju Hub AI 中管理项目的 Git 和 GitHub 集成。查看 git 状态、管理分支、生成 AI 驱动的提交消息,以及推送/拉取更改,无需离开工作区。
标签页
状态
查看当前分支、领先/落后远程的提交数,以及已更改文件列表(新增、修改、删除)。
同步
推送、拉取和获取远程仓库的更改。一目了然地查看同步状态。
分支
直接从侧边栏浏览、创建、切换和删除分支。
关联
将项目关联到 GitHub 仓库或取消关联。需要已认证的 GitHub 账户。
功能
AI 提交生成
使用 AI 提供商(Claude、Gemini、Codex)生成提交消息。AI 分析您的暂存更改并为您编写有意义的提交消息。
推送/拉取/获取
一键执行标准的 git 同步操作。状态指示器显示您的本地分支是领先还是落后于远程。
账户管理
添加、移除和切换多个 GitHub 账户。直接在面板中管理认证。
窗口级缓存
Git 状态在窗口级别缓存,以防止重新加载闪烁,并在面板之间切换时提供即时反馈。
任务面板
概述
任务面板是一个侧边栏覆盖层,用于创建和管理项目级任务。每个任务可以包含名称、提示或指令,以及选定的项目文件作为上下文。任务帮助您组织工作项并将其直接提供给 AI 代理。
功能
任务创建
创建包含名称、提示/指令文本和选定项目文件的任务。任务范围限于当前项目。
文件树集成
可调整大小的文件树面板允许您浏览和选择要作为任务上下文附加的项目文件。
多文件选择
选择多个文件包含在任务中。已选文件列表显示所有选择的文件,并提供移除单个项目的选项。
上下文菜单
右键点击任务文件树中的文件可进行快捷操作,如添加到任务或从任务中移除。
文件监视器
集成的文件监视器自动检测项目文件的更改,使任务上下文保持最新。
通知提示
通过通知提示提供成功保存、错误和信息消息的视觉反馈。

部署面板
概述
部署面板是一个侧边栏覆盖层,用于将项目部署到各种托管平台。可用的平台会根据项目类型变化,为您的技术栈提供合适的部署选项。
按项目类型的平台支持
前端 / Web 应用
部署静态网站、SPA 和 SSR 应用。
后端 / Python / API 项目
部署服务器端应用和 API。
WordPress 项目
部署无头 WordPress CMS 设置。
功能
部署管理
创建、查看、更新和删除部署。每个部署跟踪其平台、分支和 git 仓库配置。
自动检测
与项目关联的现有部署在打开面板时会自动检测并列出。
API 密钥管理
管理每个部署平台的 API 密钥。密钥安全存储并与特定部署关联。
平台专属设置
为每个部署配置部署分支、git 仓库、环境变量和平台专属选项。
活跃部署指示器
当前活跃的部署会被高亮显示,一眼即可看到哪个部署是在线的。
上下文菜单
右键点击任何部署可进行快捷操作,包括删除和刷新状态。

Cloudflare 和 R2
Cloudflare 侧栏将项目链接到 Cloudflare R2,以获取工件、媒体、移动版本和桌面更新文件。在更改项目存储设置之前,选择已配置的 Cloudflare 密钥和存储桶。
铲斗连接
选择项目的 R2 存储桶并同步其当前的 Cloudflare 设置。
公共访问
将存储桶保持私有,启用其 R2.dev URL,附加 Cloudflare 自定义域,或使用通过 R2 绑定为私有存储桶提供服务的 Worker 域。
版本和更新
检查上传的发布版本,发布构建工件,管理更新端点,并在确认后删除过时的版本。
共享链接
为选定的 R2 对象创建和管理公共、过期或服务端点链接。
移动版本
当项目的构建工作流程支持时,跟踪上传的移动构建版本和网站发布 APK 链接。
外部变化
域、公共访问、对象和 Webhook 更改会影响 Cloudflare 帐户,并可能会产生提供商使用费。
WordPress 内容
WordPress 内容显示 WordPress 和无头 WordPress 项目。它专注于由 Kaiju Hub 创建或跟踪的插件和主题,将生成的项目内容与网站上已安装的不相关项目分开。
插件
查看 Kaiju 创建的与当前项目关联的插件并打开其本地项目内容。
主题
查看 Kaiju 创建的主题并将其项目文件连接到正确的 WordPress 工作区。
项目范围视图
该面板并不声称是 Kaiju Hub 之外安装的每个插件或主题的完整清单。
部署是分开的
使用部署面板进行 WordPress 连接和发布操作;使用此面板来管理生成的内容本身。
量子硬件
对于启用了显式量子硬件功能的量子模板和导入项目,将显示量子硬件。它将本地工作负载连接到 IBM Quantum、AWS Braket 或 Azure Quantum,而无需将提供商凭证写入项目。
提供商连接
选择已配置的 IBM Quantum、AWS Braket 或 Azure Quantum 帐户。凭证保留在加密的应用程序存储中。
设备选型
列出可用的模拟器和硬件,然后查看状态、提供商、队列信息、量子位和已知的费用说明。
项目简介
将帐户、设备、镜头计数、执行模式和非秘密提供者选项保存在项目的量子配置文件中。
飞行前审查
在提交之前,Kaiju Hub 会显示提供商、设备、模拟器或硬件模式、镜头、工作负载和可用成本信息。
跟踪的职位
查询状态、请求取消和检索结果。全局任务管理器也会跟踪提交的作业。
账单确认
真实的硬件和已知的计费模拟器需要明确的确认。未知的估计并不意味着提供者的工作是免费的。
历史日历面板
概述
历史日历面板是一个侧边栏覆盖层,提供项目历史的日历视图。按日期浏览条目,查看内部和外部上下文历史,以及回顾与特定日期相关的 AI 交互。
功能
交互式日历
使用可视化日历选择器浏览月份和年份。有历史条目的日期会高亮显示,便于一目了然地发现活动。
月份/年份选择器
快速跳转到任何月份和年份,而不是逐月滚动。
历史标签页
在"GitHub"和"内部"标签页之间切换,查看不同类型的历史——git 提交和事件与内部 AI 上下文条目。
条目查看器
点击任何高亮的日期查看当天的所有历史条目。点击单个条目查看其完整详情。
上下文菜单
右键点击条目可进行快捷操作,如查看详情或删除特定历史项。
确认删除
删除历史条目时有确认步骤,防止意外删除。
通知
通知提示确认面板内的成功操作、错误或信息消息。

构建面板
概述
构建面板是一个侧边栏覆盖层,用于构建和打包桌面和移动应用程序。它支持多种框架,提供构建配置、云签名、输出画廊和版本历史。
支持的框架
标签页
构建
配置和触发构建。选择目标平台(iOS、Android、Windows、macOS、Linux、Web),配置签名密钥,设置云签名凭据。
版本
浏览带有文件分组的构建版本历史。查看过去的构建、输出工件和状态。
功能
平台选择
为构建选择一个或多个目标平台:iOS、Android、Windows、macOS、Linux 或 Web。
签名密钥管理
为每个平台配置代码签名密钥。通过应用商店分发桌面和移动应用时需要。
云签名
设置基于云的代码签名,包括 CI/CD 工作流程和远程构建的凭据管理。
构建输出画廊
在可视化画廊中浏览生成的构建工件。预览每次构建的截图和输出文件。
构建状态跟踪
从开始到完成监控每次构建的进度和状态。
文件树项
概述
文件树是项目侧边栏中的主要文件浏览器。它以递归、可展开的树视图显示项目的目录结构。每个文件和文件夹都带有类型专属图标,并支持丰富的交互操作。
功能
递归树视图
文件夹可展开和折叠以显示其内容。树支持深层嵌套,并有可配置的深度限制以保持性能。
文件类型图标
每个文件显示与其类型匹配的图标(例如 TypeScript、JavaScript、JSON、CSS、图片)。文件夹有不同的打开/关闭图标。
拖放
通过拖动文件和文件夹到树中的新位置来移动它们。拖动时会高亮放置目标。
文件选择
点击文件以选择并打开它。使用复选框进行多文件选择,Shift+点击进行范围选择。
上下文菜单
右键点击任何文件或文件夹可进行快捷操作:复制内容、添加到任务、在编辑器中创建/编辑、重构、删除、隐藏、切换收藏或下载。
自动刷新
文件夹会监视文件系统更改,在文件添加、移除或修改时自动刷新。
搜索高亮
搜索时,匹配的文件名在树中高亮显示,帮助您快速定位结果。
收藏切换
每个文件上的星标图标可让您添加或移除收藏,并即时提供视觉反馈。
提供商切换
当检测到多个源根目录或提供商路径时,可在项目内切换。

提示框

概述
提示框位于文件树顶部,提供常用文件操作的快捷操作按钮。它包含用于复制文件内容、从选定文件创建任务以及管理文件树显示的工具。
操作
复制
将当前选定文件的内容复制到剪贴板。便于快速获取代码以粘贴到 AI 聊天或其他编辑器中。
添加到任务
从选定的文件创建新任务。这将打开任务面板,预先附加选定的文件作为上下文,让您定义任务名称和提示以供 AI 代理处理。
区块组库

概述
区块组库是一个可从提示栏(拼图图标)访问的模态框,允许您浏览、搜索和选择可重用的 UI 组件和区块,以作为 AI 对话或任务的上下文。组件按组整理,可以收藏以便快速访问。
功能
组件浏览
浏览按组名整理的所有可用组件和区块。每个组件显示延迟加载的预览缩略图。
搜索和筛选
按名称或描述搜索组件,快速找到所需内容。按类别或组筛选。
延迟加载预览
组件预览使用 IntersectionObserver 按需加载,带有 300px 预加载缓冲区,确保流畅的滚动性能。
组件收藏
收藏常用组件以将其固定在库顶部,方便快速访问。
详情视图
点击任何组件可打开详情模态框,显示其完整预览、描述和元数据。
上下文选择
选择一个或多个组件作为 AI 聊天或任务的上下文。计数器显示当前已选择的数量。
已选文件
概述
已选文件标签页(提示栏中的复选框图标)显示文件树中当前选中/勾选的所有文件。它提供了已选上下文的汇总视图——文件、组件和项目——以便您查看和管理将发送给 AI 代理的内容。
功能
已选文件列表
以字母顺序排列的列表查看所有已勾选的文件。每个文件显示其相对于项目根目录的路径。
组件选择显示
查看区块组库中当前选定的组件以及已勾选的文件。
项目分组
当包含来自多个选定项目的文件时,它们按各自的项目名称分组显示。
移除单个文件
点击任何文件可将其从上下文中取消选择。双击触发取消选择,带有冷却时间以防止意外的快速切换。
全部清除
"全部清除"按钮可一次取消所有已勾选文件的选择,从头开始。

搜索

概述
搜索功能(提示栏中的放大镜图标)提供文件树内的实时文件名筛选。输入时,树会即时更新以仅显示匹配的文件,并高亮显示匹配的词语。
功能
实时筛选
文件树随您输入而筛选。仅显示名称匹配查询的文件,便于在大型项目中快速定位特定文件。
高亮匹配
文件名中匹配的部分以独特的样式视觉高亮显示,便于看出每个结果为何匹配。
自动展开文件夹
当搜索查询匹配折叠文件夹内的文件时,这些文件夹会自动展开以显示匹配结果。
隐藏文件筛选
搜索遵循您的隐藏文件设置——您选择隐藏的文件不会出现在搜索结果中。
隐藏文件

概述
隐藏文件功能(提示栏中的眼睛图标)允许您切换文件树中文件和文件夹的可见性。隐藏的文件会从树视图和搜索结果中过滤掉,保持工作区整洁,专注于重要的文件。
功能
眼睛切换
点击提示栏中的眼睛/关闭眼睛图标来切换隐藏文件的可见性。当眼睛关闭时,隐藏的文件会被过滤掉。
基于路径的隐藏
按路径模式隐藏文件。您可以隐藏特定文件、整个文件夹或匹配模式的文件组。
持久化状态
您的隐藏文件设置在会话之间保持,无需每次打开项目时重新隐藏相同的文件。
上下文菜单集成
右键点击树中的任何文件或文件夹并选择"隐藏",快速将其添加到隐藏文件列表中。
