> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codebanana.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 项目与聊天

> 在 CodeBanana 中与团队成员进行沟通与协作

## **项目**

项目是工作的核心单元，将代码、环境与协作整合到同一个工作空间中。

#### **项目列表**

项目列表提供灵活的管理与导航能力：

**筛选与排序**：

* 可按项目类型、owner、创建时间、最近活动时间等进行筛选和排序

**项目类型与结构**：

* 提供以下类型的可视化标识：
  * GitHub 项目
  * 本地项目
* 来自同一代码仓库分支的项目会 **归类到同一个父级项目下**

<img src="https://mintcdn.com/gen-d40df51d/YMfJXjBWXHTcjQ7n/images/projectlist.png?fit=max&auto=format&n=YMfJXjBWXHTcjQ7n&q=85&s=9886e84a2346414fc60b4f656df48f6e" alt="Projectlist" width="2294" height="1264" data-path="images/projectlist.png" />

<img src="https://mintcdn.com/gen-d40df51d/YMfJXjBWXHTcjQ7n/images/projectsort.png?fit=max&auto=format&n=YMfJXjBWXHTcjQ7n&q=85&s=c6154b72cf339d33113ccfa4eaea1824" alt="Projectlist 1" width="2294" height="1264" data-path="images/projectsort.png" />

**项目操作**：

* 可通过 “…” 菜单查看更多操作
* 所有具有破坏性的操作都会受到权限控制

**文件与文件夹管理**：

* 文件夹：重命名、新建、上传、复制路径、移动、删除、下载
* 文件：重命名、复制路径、移动、删除、下载

**复制相对路径**：

* 复制文件相对于项目根目录或工作区根目录的路径
* 删除操作需要具备 **agent 级权限**

**限制条件**：

* 仅 **项目 Owner** 可以删除项目
* 仅当 Owner 拥有 **多于一个项目** 时，才允许删除
  <Frame>
    <img src="https://mintcdn.com/gen-d40df51d/YMfJXjBWXHTcjQ7n/images/operateproject.png?fit=max&auto=format&n=YMfJXjBWXHTcjQ7n&q=85&s=f5b3887257b5c314cd02a52bc0fd0434" alt="Operateproject" width="2294" height="1264" data-path="images/operateproject.png" />
  </Frame>

#### **创建项目**

CodeBanana 支持多种方式初始化项目

**项目来源**：

* 创建本地项目
* 从 GitHub 或 GitLab 导入

**模板**：

* 基于不同使用场景提供预配置模板：
  * 包含样式、skills 和 agent 设置
* 也支持从 **Custom（空项目）** 开始

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/gptI4s88cSsrzk-w/images/StudioPage.png?fit=max&auto=format&n=gptI4s88cSsrzk-w&q=85&s=20a51fdff46974fad9f0a20d5a4e519f" alt="Studio Page" width="2294" height="1264" data-path="images/StudioPage.png" />
</Frame>

## **用户指南**

创建新项目后，项目文件树中会自动生成一个 **User Guide** 目录。

该目录包含 CodeBanana 核心功能的详细说明文档，提供中英文两个版本，覆盖 Studio 中的主要模块，并具备以下两个作用：

* 作为用户可阅读的 **参考资料**，帮助理解产品能力
* 作为 Agent 在执行任务时可访问的 **知识来源**

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/uBYDhVCb0YArfR98/images/projectuserguide.png?fit=max&auto=format&n=uBYDhVCb0YArfR98&q=85&s=010c1db67c4c4005b9e2b48ed778457b" alt="Projectuserguide" width="2834" height="1310" data-path="images/projectuserguide.png" />
</Frame>

### **添加成员**

项目中的 **所有成员** 都可以根据协作者属于组织内部还是外部，通过两种方式扩展项目团队。

**添加组织成员**

可将组织中的现有成员直接加入项目群聊，无需通知。

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/hiopx0JciD1rXxmv/images/inviteorgnew.png?fit=max&auto=format&n=hiopx0JciD1rXxmv&q=85&s=1de4c0a9a37758136b63fc1595ef11dd" alt="Inviteorgnew" width="2816" height="1320" data-path="images/inviteorgnew.png" />
</Frame>

**邀请外部联系人**

通过 **Invite external contacts** 功能，使用邮箱将外部协作者加入项目：

* 会向外部联系人发送通知和邀请邮件
* 他们 **不会成为您的组织成员**
* 其访问权限仅限于被邀请加入的项目

这非常适用于：

* 临时协作者
* 客户或利益相关方
* 需要查看或参与项目、但不需要完整组织权限的外部合作伙伴

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/hiopx0JciD1rXxmv/images/inviteexternalnew.png?fit=max&auto=format&n=hiopx0JciD1rXxmv&q=85&s=0561fd07d29c1fb716ec8d2afd038cb9" alt="Inviteexternalnew" width="2814" height="1320" data-path="images/inviteexternalnew.png" />
</Frame>

### **成员管理**

项目成员由 **项目 Owner** 统一管理。Owner 可点击 Agent 面板右上角的图标进入成员管理。

**移除成员**

**项目 Owner** 可以将成员移出项目群组：

* 被移除成员将 **失去对项目及其聊天的访问权限**
* 该操作通常用于：
  * 管理团队成员变动
  * 撤销外部协作者的访问权限

**解散群组**

* **项目 Owner** 可以解散整个项目群组：
  * 所有成员都会 **被移出群聊**
  * 当前协作会话将被视为 **终止**
  * 此操作不可撤销，需谨慎使用

只有 **Owner** 拥有执行这些操作的权限，以确保团队结构的关键变更始终 **可控且安全**。

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/BzGAfBPDYfUlypk3/images/groupmanagement.png?fit=max&auto=format&n=BzGAfBPDYfUlypk3&q=85&s=4bbf47424db7eb37e76dde1052d0e48f" alt="Groupmanagement" width="2294" height="1264" data-path="images/groupmanagement.png" />
</Frame>

#### **支持接入**

项目支持请求专属技术支持：

* 使用 **Request Support** 可将技术支持成员引入项目聊天
* 系统会自动为该项目聊天分配一位支持人员
* 在支持会话期间：所有 token 用量将按 **1.5 倍** 计费

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/kgHe-RHFT1OWO47E/images/supportaccess.png?fit=max&auto=format&n=kgHe-RHFT1OWO47E&q=85&s=7a895476a85a603b8712c2c6c2ecf22d" alt="Supportaccess" width="2294" height="1264" data-path="images/supportaccess.png" />
</Frame>

## Chat

聊天提供了一个 **专用于人与人沟通的空间**，与 agent 驱动的工作流相互独立。它适用于协同、快速讨论以及跨团队沟通。

您可以通过两种方式发起新的聊天：

* 点击 **New Chat** 创建群聊
* 前往 **Personal Center → Contacts**，选择某位成员发起一对一聊天

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/kgHe-RHFT1OWO47E/images/chat.png?fit=max&auto=format&n=kgHe-RHFT1OWO47E&q=85&s=1e7174b8ed35481d3f4695a79ad94a47" alt="Chat" width="2294" height="1264" data-path="images/chat.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/kgHe-RHFT1OWO47E/images/contacts-1v1.png?fit=max&auto=format&n=kgHe-RHFT1OWO47E&q=85&s=e55d50efb85a77a530e6a1fc5cec4cbf" alt="Contacts 1v1" width="2294" height="1264" data-path="images/contacts-1v1.png" />
</Frame>

#### **消息功能**

聊天支持高效沟通所需的基础消息能力：

* 复制、引用和转发消息
* 成员加入或退出群组时自动发送通知
* 支持搜索：
  * 组织联系人
  * 聊天记录

**转发行为**

* 消息可转发至：
  * 当前群组
  * 其他群组（需要手动选择）
* 限制说明：
  * 在 **Team Agent** 中，消息只能转发到具备 agent 权限的目标位置
  * 在 **My Agent** 和 **Discussion** 中，转发不受限制
* **Restore（与 agent 相关）**
  * 可用于 agent 对话中的用户 prompt
  * 支持将对话、模型记忆和项目状态回退到之前的某个节点
  * 不适用于标准的纯聊天会话

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/N7XVmlPAEYzrzsrK/images/messageaction.png?fit=max&auto=format&n=N7XVmlPAEYzrzsrK&q=85&s=68eb78b0ca5c5666971d98963d502a8f" alt="Messageaction" width="2294" height="1264" data-path="images/messageaction.png" />
</Frame>

### **新消息**

新消息可帮助您快速识别聊天、项目和通知中的最新动态，使您能够与团队实时保持同步。

#### **新消息出现的位置**

新消息提示会出现在以下关键区域：

* **Chats**
* **Projects**
* **Notifications**

这些提示会标明哪些位置出现了新的互动或更新。

#### **优先级处理**

并非所有消息都具有相同优先级：

* **@mentions 的优先级高于** 普通新消息
* 被提及的消息会优先展示，帮助您先处理需要立即关注的内容

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/kgHe-RHFT1OWO47E/images/newmessage.png?fit=max&auto=format&n=kgHe-RHFT1OWO47E&q=85&s=6e75f59e4601f2500033bb9f817da193" alt="Newmessage" width="2294" height="1264" data-path="images/newmessage.png" />
</Frame>

## Notification

通知帮助您及时了解工作空间中的重要动态，包括权限和协作相关事件。

通知涵盖以下关键事件：

* Agent 权限申请与审批
* 组织加入申请及状态更新
* 外部项目邀请
* 账单与用量更新（达到限制时）
* 群组邀请

所有通知都会集中展示在 **Notifications 面板** 中，您可以：

* 跟踪需要您处理的事项
* 快速跳转到相关项目或对应上下文

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/Ai1aJV78H79LCZ5t/images/notification.png?fit=max&auto=format&n=Ai1aJV78H79LCZ5t&q=85&s=b77ba52d81588aea925c38fb00818c8d" alt="Notification" width="2294" height="1264" data-path="images/notification.png" />
</Frame>
