{message}
You can close this tab and return to the app.
needsAttention] B --> B2[运行中工作区] B --> B3[归档工作区] C --> C1[工作区摘要卡片] ``` **工作区状态属性**： | 属性 | 类型 | 描述 | |------|------|------| | `isRunning` | boolean | 是否正在运行 | | `isPinned` | boolean | 是否固定显示 | | `hasPendingApproval` | boolean | 是否有待审批项 | | `hasRunningDevServer` | boolean | 开发服务器状态 | | `hasUnseenActivity` | boolean | 是否有未读活动 | | `prStatus` | string | PR 状态 | | `filesChanged` | number | 变更文件数 | | `linesAdded` | number | 新增行数 | | `linesRemoved` | number | 删除行数 | 资料来源：[packages/ui/src/components/WorkspacesSidebar.tsx]() ### 4.2 附件上传与 Azure 集成 `useAzureAttachments` Hook 实现了文件上传的状态管理： ```typescript // 上传流程状态转换 上传中 → confirmAttachmentUpload() → 完成 // 状态映射 { status: 'uploading', progress: pct } { status: 'confirming', progress: 100 } { id: result.id, blob_id: result.blob_id } // 完成状态 ``` 资料来源：[packages/web-core/src/shared/hooks/useAzureAttachments.ts]() ## 5. 后端服务 ### 5.1 Rust 后端架构 后端采用 Rust 构建，主要路由位于 `crates/server/src/routes/` 目录： ```mermaid graph LR A[HTTP 请求] --> B[oauth.rs] A --> C[API 路由] B --> D[GitHub OAuth] C --> E[业务逻辑] E --> F[executors] E --> G[数据库] ``` **OAuth 认证端点示例**： ```rust Response::builder() .status(StatusCode::OK) .header("content-type", "text/html; charset=utf-8") .body(body) .unwrap() ``` 资料来源：[crates/server/src/routes/oauth.rs]() ### 5.2 冲突解决对话框 当检测到 Git 冲突时，`ResolveConflictsDialog` 展示冲突文件列表： ```typescript {conflictedFiles.slice(0, 5).map((file) => (
相关源码文件
以下源码文件用于生成本页说明： - [rust-toolchain.toml](https://github.com/BloopAI/vibe-kanban/blob/main/rust-toolchain.toml) - [pnpm-workspace.yaml](https://github.com/BloopAI/vibe-kanban/blob/main/pnpm-workspace.yaml) - [docs/self-hosting/local-development.mdx](https://github.com/BloopAI/vibe-kanban/blob/main/docs/self-hosting/local-development.mdx) - [local-build.sh](https://github.com/BloopAI/vibe-kanban/blob/main/local-build.sh)相关源码文件
以下源码文件用于生成本页说明： - [crates/api-types/src/issue.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/api-types/src/issue.rs) - [crates/api-types/src/issue_tag.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/api-types/src/issue_tag.rs) - [crates/api-types/src/project.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/api-types/src/project.rs) - [crates/db/src/models/task.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/db/src/models/task.rs) - [packages/ui/src/components/KanbanBoard.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/ui/src/components/KanbanBoard.tsx) - [packages/web-core/src/pages/kanban/LocalProjectKanban.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/pages/kanban/LocalProjectKanban.tsx)相关源码文件
以下源码文件用于生成本页说明： - [packages/web-core/src/shared/dialogs/command-bar/WorkspaceSelectionDialog.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/dialogs/command-bar/WorkspaceSelectionDialog.tsx) - [packages/ui/src/components/WorkspacesSidebar.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/ui/src/components/WorkspacesSidebar.tsx) - [packages/web-core/src/shared/components/tasks/TaskDetails/ProcessesTab.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/components/tasks/TaskDetails/ProcessesTab.tsx) - [packages/web-core/src/shared/stores/useUiPreferencesStore.ts](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/stores/useUiPreferencesStore.ts) - [packages/ui/src/components/SessionChatBox.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/ui/src/components/SessionChatBox.tsx)
{t('processes.started', { date: formatDate(process.started_at) })}
{process.completed_at && (
{t('processes.completed', { date: formatDate(process.completed_at) })}
)}
```
资料来源：[packages/web-core/src/shared/components/tasks/TaskDetails/ProcessesTab.tsx:75-85]()
## 会话与工作区关联
### 会话状态显示
`SessionChatBox` 组件在会话界面展示当前工作区的执行摘要：
| 指标 | 显示格式 | 颜色编码 |
|------|----------|----------|
| 文件变更数 | `+N files` | 默认文本色 |
| 新增行数 | `+{linesAdded}` | 绿色 (text-success) |
| 删除行数 | `-{linesRemoved}` | 红色 (text-error) |
```typescript
{t('diff.filesChanged', { count: filesChanged })}
{(linesAdded !== undefined || linesRemoved !== undefined) && (
{linesAdded !== undefined && (
+{linesAdded}
)}
{linesRemoved !== undefined && (
-{linesRemoved}
)}
)}
```
资料来源：[packages/ui/src/components/SessionChatBox.tsx:82-98]()
### 代理图标与导航
会话界面支持代理图标显示和消息导航：
- 代理图标: `renderAgentIcon?.(agent, 'size-icon-xl')`
- 消息导航: `TurnNavigationPopup` 组件用于跳转历史消息
- Todo 进度: `TodoProgressPopup` 展示当前 Todo 状态
资料来源：[packages/ui/src/components/SessionChatBox.tsx:103-125]()
## 工作区偏好设置
### UI 状态持久化
`useUiPreferencesStore` 管理工作区相关的 UI 状态：
| 状态键 | 类型 | 用途 |
|--------|------|------|
| paneSizes | object | 面板尺寸配置 |
| collapsedPaths | object | 文件树折叠状态 |
| fileSearchRepoId | string | 文件搜索仓库 ID |
| layoutMode | string | 当前布局模式 |
| workspacePanelStates | object | 各工作区面板状态 |
| mobileActiveTab | string | 移动端激活标签 |
```typescript
toggleLayoutMode: () =>
set((s) => ({
layoutMode: s.layoutMode === 'workspaces' ? 'kanban' : 'workspaces',
})),
```
资料来源：[packages/web-core/src/shared/stores/useUiPreferencesStore.ts:50-80]()
### 文件树折叠状态持久化
系统支持按工作区独立保存文件树折叠状态：
```typescript
export function usePersistedCollapsedPaths(
workspaceId: string | undefined
): [Set相关源码文件
以下源码文件用于生成本页说明： - [README.md](https://github.com/BloopAI/vibe-kanban/blob/main/README.md) - [packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx) - [packages/web-core/src/shared/keyboard/useWorkspaceShortcuts.ts](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/keyboard/useWorkspaceShortcuts.ts) - [packages/web-core/src/shared/dialogs/command-bar/WorkspaceSelectionDialog.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/dialogs/command-bar/WorkspaceSelectionDialog.tsx) - [packages/ui/src/components/CommandBar.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/ui/src/components/CommandBar.tsx) - [packages/ui/src/components/IssueCommentsSection.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/ui/src/components/IssueCommentsSection.tsx) - [crates/remote/src/db/issues.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/remote/src/db/issues.rs) > **注意**：本页面部分内容基于仓库结构的推断分析。由于仓库已宣布停止运营（sunsetting），部分执行器核心源码文件（如 `crates/executors/src/` 目录下的文件）未在当前检索上下文中完整获取。以下文档综合了 README 说明、UI 组件代码、以及已知的产品功能描述进行编写。packages/ui] --> B[Web Core 层
packages/web-core] B --> C[执行器抽象层
crates/executors] C --> D[Claude 执行器] C --> E[Codex 执行器] C --> F[其他执行器] G[配置文件
Profile] --> C H[工作空间状态
Workspace State] --> B ``` ### 执行器模块结构 根据仓库结构分析，执行器模块的主要组织方式如下： | 模块路径 | 说明 | |---------|------| | `crates/executors/src/lib.rs` | 执行器库入口，定义公共 API | | `crates/executors/src/executor_discovery.rs` | 动态发现机制，支持运行时检测可用代理 | | `crates/executors/src/profile.rs` | 执行器配置管理，存储用户偏好和代理参数 | | `crates/executors/src/executors/mod.rs` | 执行器通用抽象接口 | | `crates/executors/src/executors/claude/mod.rs` | Claude Code 专用执行器实现 | | `crates/executors/src/executors/codex/mod.rs` | Codex 专用执行器实现 | | `shared/schemas/claude_code.json` | Claude Code 通信协议 Schema | 资料来源：[README.md:32]() ## 配置管理 ### 执行器配置（Profile） 每个编码代理都通过 Profile 配置进行管理。配置系统支持以下关键参数： | 配置项 | 类型 | 说明 | |-------|------|------| | `agent_type` | String | 代理类型标识符（如 `claude`, `codex`） | | `api_key` | String | API 认证密钥 | | `model` | String | 指定使用的模型版本 | | `temperature` | Float | 生成随机性控制参数 | | `max_tokens` | Integer | 单次响应最大 token 数 | | `custom_flags` | Object | 代理特定的额外参数 | 配置存储通过 Zustand store `useUiPreferencesStore` 进行前端状态管理： ```typescript // packages/web-core/src/shared/stores/useUiPreferencesStore.ts toggleLayoutMode: () => set((s) => ({ layoutMode: s.layoutMode === 'workspaces' ? 'kanban' : 'workspaces', })), ``` 资料来源：[packages/web-core/src/shared/stores/useUiPreferencesStore.ts:45]() ### UI 配置选择器 在用户界面中，代理和配置的选择通过 `AgentSelector` 和 `ConfigSelector` 组件实现。这些组件出现在工作空间创建和冲突解决对话框中： ```typescript // packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx {profiles && createNewSession && (
{t('processes.started', {
date: formatDate(process.started_at),
})}
{process.completed_at && (
{t('processes.completed', {
date: formatDate(process.completed_at),
})}
)}
```
支持的操作包括：
| 功能 | 触发方式 | 说明 |
|-----|---------|------|
| 复制日志 | 按钮点击 | 将执行日志复制到剪贴板 |
| 查看详情 | 列表项点击 | 显示特定进程的详细信息 |
资料来源：[packages/web-core/src/shared/components/tasks/TaskDetails/ProcessesTab.tsx:1-50]()
## 工单与评论集成
### 评论系统
编码代理的工作成果通过工单评论系统进行交流：
```typescript
// packages/ui/src/components/IssueCommentsSection.tsx
interface IssueCommentsSectionProps {
comments: IssueCommentData[];
commentInput: string;
onCommentInputChange: (value: string) => void;
onSubmitComment: () => void;
editingCommentId: string | null;
editingValue: string;
onEditingValueChange: (value: string) => void;
onStartEdit: (commentId: string) => void;
onSaveEdit: () => void;
onCancelEdit: () => void;
onDeleteComment: (id: string) => void;
reactionsByCommentId: MapCreate Issue] --> B[规划任务
Plan Tasks] B --> C[创建工作空间
Create Workspace] C --> D[选择编码代理
Select Agent] D --> E[执行编码任务
Execute Tasks] E --> F{检查结果} F -->|有冲突| G[解决冲突
Resolve Conflicts] G --> D F -->|成功| H[审查 Diff
Review Diff] H --> I[创建 PR
Create PR] I --> J[合并代码
Merge] ``` ## 平台状态说明 根据项目 README 公告，**Vibe Kanban 项目已于近期宣布停止运营（sunsetting）**。相关公告可在 [vibekanban.com/blog/shutdown](https://www.vibekanban.com/blog/shutdown) 查看。 资料来源：[README.md:1-10]() ## 总结 Vibe Kanban 的编码代理集成系统通过以下核心机制实现与多种 AI 编码代理的无缝协作： 1. **模块化执行器架构**：基于 Rust crate 的插件式设计，支持动态发现和加载不同的编码代理 2. **统一配置管理**：Profile 系统提供灵活的代理参数配置能力 3. **深度工作空间集成**：编码代理在隔离的工作空间中执行，与 Git 仓库和工单系统紧密关联 4. **丰富的交互接口**：支持快捷键、命令面板、冲突解决对话框等多种交互方式 5. **完整的进程监控**：提供进程状态追踪、日志管理和实时反馈机制 --- ## 数据库模型与迁移 ### 相关页面 相关主题：[系统架构总览](#architecture-overview), [本地 API 服务器](#api-server), [工作区管理与执行](#workspace-management)
相关源码文件
以下源码文件用于生成本页说明： - [crates/server/src/routes/oauth.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/routes/oauth.rs) - [packages/web-core/src/shared/stores/useWorkspaceDiffStore.ts](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/stores/useWorkspaceDiffStore.ts) - [packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx) - [packages/web-core/src/shared/hooks/useAzureAttachments.ts](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/hooks/useAzureAttachments.ts) - [packages/remote-web/src/pages/HomePage.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/remote-web/src/pages/HomePage.tsx) - [packages/ui/src/components/CommandBar.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/ui/src/components/CommandBar.tsx)相关源码文件
以下源码文件用于生成本页说明： - [crates/server/src/lib.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/lib.rs) - [crates/server/src/main.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/main.rs) - [crates/server/src/routes/mod.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/routes/mod.rs) - [crates/server/src/routes/workspaces/core.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/routes/workspaces/core.rs) - [crates/server/src/middleware/mod.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/middleware/mod.rs) - [crates/server/src/routes/sessions/mod.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/routes/sessions/mod.rs)相关源码文件
以下源码文件用于生成本页说明： - [crates/server/src/routes/oauth.rs](https://github.com/BloopAI/vibe-kanban/blob/main/crates/server/src/routes/oauth.rs) - [packages/web-core/src/shared/dialogs/auth/GhCliSetupDialog.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/dialogs/auth/GhCliSetupDialog.tsx) - [packages/remote-web/src/pages/HomePage.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/remote-web/src/pages/HomePage.tsx) - [packages/web-core/src/shared/hooks/useAzureAttachments.ts](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/hooks/useAzureAttachments.ts) - [packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx](https://github.com/BloopAI/vibe-kanban/blob/main/packages/web-core/src/shared/dialogs/tasks/ResolveConflictsDialog.tsx)