# BitSeek Claw 页面操作指南

本指南详细介绍 BitSeek Claw 各个功能模块的具体操作方法。

## 目录

1. [聊天功能](#聊天功能)
2. [AI 同事](#ai-同事)
3. [任务管理](#任务管理)
4. [看板视图](#看板视图)
5. [技能管理](#技能管理)
6. [记忆管理](#记忆管理)
7. [设置配置](#设置配置)

---

## 聊天功能

![聊天界面](images/chat-area.png)

聊天是 BitSeek Claw 的核心功能，用于与 AI 进行对话交流。

### 发送消息

1. **输入消息**
   - 在底部消息输入框中输入文字
   - 支持多行输入（按 `Shift + Enter` 换行）

2. **发送消息**
   - 点击发送按钮 📤
   - 或按 `Enter` 键发送
   - 或按 `Ctrl/Cmd + Enter` 发送

3. **快捷操作**
   - 📎 **选择文件** - 附加文件到消息
   - 🎤 **听写** - 语音输入
   - ⚡ **快速命令** - 插入预设命令

### 会话管理

#### 新建对话
1. 点击左侧边栏的 **"新建对话"** 按钮

#### 切换对话
1. 在左侧边栏的会话列表中点击要切换的对话
2. 会话按时间分组显示（今天、昨天、上周等）

#### 筛选对话
1. 使用搜索框输入关键词筛选
2. 或使用标签筛选

#### 对话操作
- **重命名** - 右键对话 → 重命名
- **删除** - 右键对话 → 删除
- **导出** - 右键对话 → 导出为 Markdown

### 消息操作

#### 编辑消息
1. 将鼠标悬停在消息上
2. 点击编辑图标 ✏️
3. 修改内容后保存

#### 复制消息
1. 将鼠标悬停在消息上
2. 点击复制图标 📋
3. 消息将复制到剪贴板

#### 引用消息
1. 将鼠标悬停在消息上
2. 点击引用图标 💬
3. 引用内容将添加到输入框

### 上下文信息

底部状态栏显示当前会话的上下文：
- **模型** - 当前使用的 AI 模型
- **配置文件** - 当前用户配置
- **工作区** - 当前工作目录
- **推理强度** - AI 推理强度设置

---

## AI 同事

![AI 同事界面](images/ai-colleagues.png)

AI 同事功能允许管理和交互多个 AI 代理。

### 查看 AI 同事列表
1. 点击导航栏的 **"AI 同事"** 按钮
2. 查看所有可用的 AI 代理

### 与 AI 同事对话
1. 在列表中选择一个 AI 同事
2. 点击进入对话界面
3. 输入消息开始交流

---

## 任务管理

![任务管理界面](images/tasks.png)

任务管理功能帮助您跟踪和管理各种任务。

### 查看任务
1. 点击导航栏的 **"任务"** 按钮
2. 查看所有任务列表
3. 按状态、优先级、负责人筛选

### 创建任务
1. 点击 **"新建任务"** 按钮
2. 填写任务信息：
   - 标题
   - 描述
   - 截止日期
   - 优先级
   - 负责人
3. 点击保存

### 任务操作
- **编辑任务** - 点击任务标题进入编辑
- **标记完成** - 点击完成按钮
- **删除任务** - 选择任务后删除
- **添加评论** - 在任务中添加评论

### 任务视图
- **列表视图** - 传统列表显示
- **看板视图** - 看板式显示
- **时间线视图** - 甘特图显示

---

## 看板视图

![看板界面](images/kanban.png)

看板视图提供直观的任务管理界面。

### 看板列
看板通常包含以下列：
- **待办** - 待处理的任务
- **进行中** - 正在进行的任务
- **已完成** - 已完成的任务
- **已归档** - 已归档的任务

### 拖拽任务
1. 在看板列中找到任务卡片
2. 按住鼠标左键拖动
3. 放到目标列中释放

### 管理看板
- **添加列** - 点击添加列按钮
- **重命名列** - 双击列标题
- **删除列** - 右键列 → 删除
- **调整顺序** - 拖动列标题调整顺序

### 卡片操作
- **查看详情** - 点击卡片查看详细信息
- **快速编辑** - 双击卡片快速编辑
- **添加成员** - 将成员添加到任务
- **设置标签** - 添加颜色标签

---

## 技能管理

![技能界面](images/skills.png)

技能管理功能管理 AI 可用的技能库。

### 查看技能列表
1. 点击导航栏的 **"技能"** 按钮
2. 查看所有可用技能
3. 按类别、状态筛选

### 技能分类
- **系统技能** - 内置的核心技能
- **自定义技能** - 用户创建的技能
- **社区技能** - 从社区获取的技能

### 使用技能
1. 在聊天中输入技能命令
2. 或通过技能面板选择
3. AI 将执行相应技能

### 管理技能
- **启用/禁用** - 控制技能是否可用
- **配置参数** - 修改技能设置
- **删除技能** - 移除不需要的技能

---

## 记忆管理

![记忆界面](images/memory.png)

记忆管理功能管理 AI 的记忆系统。

### 记忆子菜单

记忆页面提供以下子菜单选项：

#### 1. 我的备注

![我的备注界面](images/memory-notes.png)

- **功能**：管理个人笔记和备忘
- **操作**：
  - 点击 **"我的备注"** 进入笔记管理
  - 点击 **"编辑"** 按钮修改当前笔记
  - 查看笔记的最后修改时间
- **使用场景**：
  - 记录重要信息和想法
  - 保存待办事项
  - 记录学习心得

#### 2. 用户画像

![用户画像界面](images/memory-profile.png)

- **功能**：管理 AI 对用户的了解
- **内容**：
  - 用户偏好设置
  - 工作习惯
  - 沟通风格
  - 技术栈信息
- **操作**：
  - 查看 AI 已学习的用户特征
  - 手动添加或修改用户信息
  - 删除不准确的用户画像

#### 3. 智能体灵魂

![智能体灵魂界面](images/memory-soul.png)

- **功能**：定义 AI 的个性和行为模式
- **配置项**：
  - **性格特征**：定义 AI 的沟通风格
  - **专业知识**：指定 AI 的专业领域
  - **行为准则**：设置 AI 的行为边界
  - **回复风格**：调整 AI 的回复方式
- **使用场景**：
  - 定制个性化 AI 助手
  - 适应不同工作场景
  - 优化交互体验

### 记忆类型
- **用户记忆** - 关于用户的偏好和习惯
- **会话记忆** - 当前会话的上下文
- **仓库记忆** - 代码库相关记忆

### 查看记忆
1. 点击导航栏的 **"记忆"** 按钮
2. 浏览不同类别的记忆
3. 搜索特定记忆内容

### 管理记忆
- **添加记忆** - 手动添加新记忆
- **编辑记忆** - 修改现有记忆
- **删除记忆** - 删除不需要的记忆
- **导出记忆** - 导出记忆为文件

### 记忆搜索
1. 使用搜索框输入关键词
2. 按类别筛选记忆
3. 按时间排序记忆

---

## 设置配置

![设置界面](images/settings.png)

设置功能配置 BitSeek Claw 的各种选项。

### 设置子菜单

设置页面提供以下子菜单选项：

#### 1. 对话

![对话设置界面](images/settings-conversation.png)

- **功能**：管理当前对话的设置和操作
- **操作选项**：
  - **记录**：将对话导出为 Markdown 文件
  - **JSON**：将对话完整导出为 JSON 格式
  - **导入**：从 JSON 文件导入对话历史
  - **清空**：清空当前对话中的所有消息
- **使用场景**：
  - 备份重要对话
  - 在不同设备间同步对话
  - 清理不需要的对话记录

#### 2. 外观

![外观设置界面](images/settings-appearance.png)

- **功能**：自定义界面外观和主题
- **配置项**：
  - **主题选择**：
    - 深色主题（默认）
    - 浅色主题
    - 跟随系统
  - **字体设置**：
    - 字体大小调整
    - 字体样式选择
  - **布局配置**：
    - 侧边栏显示/隐藏
    - 面板大小调整
    - 动画效果开关
- **使用场景**：
  - 适应不同光线环境
  - 个性化界面风格
  - 优化阅读体验

#### 3. 偏好

![偏好设置界面](images/settings-preferences.png)

- **功能**：设置个人使用偏好
- **配置项**：
  - **语言设置**：
    - 界面语言选择
    - 时间格式设置
    - 日期格式设置
  - **通知设置**：
    - 桌面通知开关
    - 声音提醒设置
    - 通知频率调整
  - **隐私设置**：
    - 数据收集选项
    - 分享偏好设置
    - 清除历史记录
- **使用场景**：
  - 适配本地化需求
  - 管理通知干扰
  - 保护个人隐私

#### 4. 提供商

![提供商设置界面](images/settings-providers.png)

- **功能**：管理 AI 模型提供商配置
- **配置项**：
  - **API 密钥管理**：
    - 添加新的 API 密钥
    - 测试密钥有效性
    - 删除无效密钥
  - **模型配置**：
    - 选择默认 AI 模型
    - 设置模型参数
    - 配置模型优先级
  - **提供商设置**：
    - OpenAI 配置
    - Anthropic 配置
    - Google 配置
    - 其他提供商配置
- **使用场景**：
  - 配置多个 AI 提供商
  - 优化成本和性能
  - 测试不同模型效果

#### 5. 插件

![插件设置界面](images/settings-plugins.png)

- **功能**：管理扩展插件和技能
- **操作选项**：
  - **查看已安装插件**：浏览当前安装的插件
  - **安装新插件**：从插件市场安装
  - **更新插件**：更新到最新版本
  - **卸载插件**：移除不需要的插件
  - **插件配置**：调整插件设置
- **使用场景**：
  - 扩展 BitSeek Claw 功能
  - 安装社区插件
  - 管理插件生命周期

#### 6. 系统

![系统设置界面](images/settings-system.png)

- **功能**：系统级配置和管理
- **配置项**：
  - **数据管理**：
    - 导出所有数据
    - 导入备份数据
    - 清除本地数据
  - **网络设置**：
    - 代理配置
    - 防火墙设置
    - 连接超时设置
  - **调试和日志**：
    - 日志级别调整
    - 调试模式开关
    - 错误报告设置
  - **系统信息**：
    - 版本信息
    - 系统状态
    - 资源使用情况
- **使用场景**：
  - 数据备份和恢复
  - 网络问题排查
  - 系统性能优化



---

## 快捷操作

### 全局快捷键
| 快捷键 | 功能 |
|--------|------|
| `Ctrl/Cmd + N` | 新建对话 |
| `Ctrl/Cmd + /` | 聚焦搜索框 |
| `Ctrl/Cmd + Enter` | 发送消息 |
| `Ctrl/Cmd + ,` | 打开设置 |
| `Esc` | 关闭弹窗 |

### 消息快捷键
| 快捷键 | 功能 |
|--------|------|
| `Enter` | 发送消息 |
| `Shift + Enter` | 换行 |
| `↑` | 编辑上一条消息 |
| `Ctrl/Cmd + C` | 复制选中文本 |

### 导航快捷键
| 快捷键 | 功能 |
|--------|------|
| `1-9` | 切换导航标签 |
| `←` | 收起侧边栏 |
| `→` | 展开侧边栏 |

---

## 故障排除

### 常见问题

#### 消息发送失败
1. 检查网络连接
2. 检查 API 密钥是否有效
3. 查看控制台错误信息

#### 界面无响应
1. 刷新页面（`F5` 或 `Ctrl/Cmd + R`）
2. 清除浏览器缓存
3. 重启 BitSeek Claw 服务

#### 文件无法上传
1. 检查文件大小限制
2. 检查文件类型是否支持
3. 检查网络连接

### 获取帮助
- 查看系统日志（设置 → 日志）
- 查看控制台错误信息
- 访问项目文档
