用户指南

平台概览

JAcoworks 提供两种使用模式，满足不同场景需求。

本地模式

本地模式是 JAcoworks 的默认工作方式。AI Agent 以 sidecar 进程运行在你的电脑上，通过 RPC 协议与桌面端通信。

特点：

  • 对话数据本地处理，仅 LLM 推理请求发送到云端
  • Agent 可直接读写你选择的工作目录中的文件
  • 支持智能记忆，跨会话记住你的偏好和上下文
  • 启动快速，无需等待容器分配

适用场景: 日常开发辅助、文件处理、代码编写、文档撰写

OpenClaw 模式

OpenClaw 是 JAcoworks 的云端协作模式。每个用户分配独立的 LXD 容器，Agent 在云端安全沙箱中运行。

特点：

  • 独立容器环境，完全隔离
  • 通过 WebSocket 实时通信
  • 适合需要特定环境或团队协作的场景
  • Ed25519 设备密钥认证

适用场景: 团队协作项目、需要特定运行环境的任务

详细了解 OpenClaw 模式，请参阅 OpenClaw 协作模式。

界面介绍

侧边栏

侧边栏位于窗口左侧，包含以下元素：

  • 新对话按钮: 创建新的对话会话
  • 会话列表: 所有历史对话，按时间排序
  • 模式切换: 在本地模式和 OpenClaw 模式之间切换

你可以通过拖拽侧边栏边缘调整宽度，或点击折叠按钮将其收起。

对话区域

对话区域占据窗口主体部分：

  • 消息流: 用户消息和 Agent 回复交替显示
  • Markdown 渲染: 支持代码高亮、表格、列表等富文本格式
  • 流式输出: Agent 的回复实时逐字显示
  • 工具状态: 当 Agent 使用工具（如读写文件、搜索）时，会显示工具执行状态

顶部工具栏

  • 模型选择器: 切换当前使用的 AI 模型
  • 工作空间选择: 设置或切换工作目录
  • 设置按钮: 打开设置面板

底部输入区

  • 消息输入框: 支持多行输入（Shift+Enter 换行）
  • 发送按钮: 发送消息（Enter）
  • 输入过程中可随时按 Esc 取消

基本对话流程

  1. 创建或选择会话: 点击「+ 新对话」或从侧边栏选择已有会话
  2. 选择模型（可选）: 根据任务需要切换 AI 模型
  3. 设置工作空间（可选）: 如果需要 Agent 访问文件，选择工作目录
  4. 输入消息: 在底部输入框中描述你的需求
  5. 等待回复: Agent 会实时流式返回回答
  6. 继续对话: 基于 Agent 的回复继续追问或提出新需求

提示: 对话会自动保存，下次打开应用时可以继续之前的对话。会话标题由 AI 自动生成。

功能模块

深入了解各功能模块：