Menú
BobanStaff（博办数字员工）客户端用户使用手册。当用户询问如何使用客户端进行聊天、与总管协作编排、招募员工、管理技能、查看任务排班、设置桌面宠物、管理扩展插件、切换工作空间、配置系统设置，或遇到使用中的问题（激活失败、登录失败、技能不加载、任务未执行、宠物不显示等）时使用。涵盖所有功能模块的操作步骤和常见问题解答。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Use when automating the digital employee desktop embedded browser via shell_execute and browserctl—navigation, forms, clicks, snapshots, or page text extraction on OA/CRM/ERP sites. Not for pure information lookup (use web_search first). Triggers include health showing browser_available false, SPA wait timing, iframe @eN, alert/confirm dialogs, or opening session artifact HTML.
Use when user reports `command not found` errors for python/node/git/curl, version incompatibility, or "missing Python dependency" / "Node.js required" in skill output.
"当需要用 lark-cli 操作飞书多维表格（Base）时调用：适用于建表、字段管理、记录读写、视图配置、历史查询，以及角色/表单/仪表盘管理；也适用于把旧的 +table / +field / +record 写法改成当前命令写法。涉及字段设计、公式字段、查找引用、跨表计算、行级派生指标、数据分析需求时也必须使用本 skill。"
帮助用户从 ClawHub 镜像技能市场发现并安装 Agent 技能。当用户问「有没有 XX 技能」「怎么写标书/做测试」「找个技能」「扩展能力」时使用。优先用 search_market_skills 搜索；无合适结果时用内置技能或 ZIP 导入。
收集用户遇到的问题（BUG）并提交到官方后台。当用户表达「反馈 bug / 报问题 / 提建议 / 吐槽 / 这里有问题 / 要反馈 / 提个意见 / 报个错 / 体验不好 / 想反馈」等反馈意图时使用——会弹出反馈表单让用户填写并提交。
撰写技术方案、标书 / 投标书、可行性报告、白皮书、需求文档、调研报告、长报告等较长正式文档的三步协作流程（澄清需求 → 大纲方案确认 → 分章写作）。当用户要写技术方案、标书、投标书、可行性报告、白皮书、长报告、需求文档、调研报告等长文档，或需要分章节、要审大纲、按模板正式成文时使用。
| name | user-usage-manual |
| description | BobanStaff（博办数字员工）客户端用户使用手册。当用户询问如何使用客户端进行聊天、与总管协作编排、招募员工、管理技能、查看任务排班、设置桌面宠物、管理扩展插件、切换工作空间、配置系统设置，或遇到使用中的问题（激活失败、登录失败、技能不加载、任务未执行、宠物不显示等）时使用。涵盖所有功能模块的操作步骤和常见问题解答。 |
BobanStaff（产品包名 BobanStaffNext）数字员工客户端使用指南。本文档帮助你了解和使用客户端的全部功能。
首次在一台设备上使用时，可能需要先完成设备激活：
┌──────────────┬──────────────────────────────────────┬─────────────┐
│ 工具栏 │ │ 右侧面板 │
│ ┌────────┐ │ │ ┌─────────┐ │
│ │总管 │ │ 聊天主区域 │ │通知/ │ │
│ │员工列表 │ │ │ │制品/ │ │
│ │工作空间 │ │ │ │工作台 │ │
│ └────────┘ │ │ └─────────┘ │
│ │ │ │
│ 技能 | 日历 │ │ │
│ 工作台 │ │ │
└──────────────┴──────────────────────────────────────┴─────────────┘
不熟悉客户端时，可直接向总管提问（如「怎么用工作台」「怎么下发任务」），总管会结合本手册逐步说明。
联系人面板中有两类对话对象：
| 类型 | 说明 |
|---|---|
| 总管（curator） | 唯一的编排入口。理解你的需求后组队、派发任务、监控执行、汇总交付物，可调度所有员工 |
| 员工（employee） | 单个 AI 员工，各有专长和技能，可直接单聊 |
没有"群聊"功能。需要多人协作时，直接告诉总管你的目标，由总管自动组队并在后台编排；或分别与各员工单聊。总管对话中可用
@指定优先处理的员工。
最近联系人列表可折叠为仅图标模式。
与总管对话时，除普通聊天外还提供编排视图：
总管快捷指令（在输入框输入 / 触发，快捷指令在前、总管技能在后）：
| 指令 | 作用 |
|---|---|
| 查看进度 | 汇报进行中计划与各子任务状态 |
| 汇总交付物 | 列出已产出交付物与位置 |
| 团队复盘 | 复盘团队近期表现 |
| 团队与能力 | 查看团队名册与能力画像 |
| 质检返工 | 质检交付物并安排返工 |
| 缺口诊断 | 诊断人手/技能缺口并给建议 |
| 取消计划 | 取消进行中的编排计划 |
| 功能 | 操作 | 说明 |
|---|---|---|
| 斜杠命令 | 输入 / | 触发快捷指令 / 可用技能列表 |
| @ 提及 | 输入 @ | 在总管对话中提及特定员工，优先处理 |
| 上传文件 | 点击附件按钮 | 上传文件到对话中供 AI 分析 |
| 停止生成 | 点击停止按钮 | 中断 AI 正在生成的回复 |
点击工具栏"招募"按钮，或在联系人面板点击"添加"。
点击左侧工具栏的技能标签页。
| 方式 | 操作 |
|---|---|
| 远程市场 | 浏览远程技能库，按分类筛选，点击"安装"（需登录远程账号 remote_login） |
| ZIP 导入 | 点击"导入 ZIP"，选择本地 .zip 技能包，自动解析 frontmatter，冲突时提示覆盖 |
| 从制品导入 | 在制品面板的技能草稿（skills_draft）上右键"导入到技能库" |
点击技能卡片查看 ID、中文名、描述、提示词、文件列表与 SKILL.md：
updateLocalSkill），删除仅限本地技能点击左侧工具栏的工作台标签页。
| 区域 | 内容 |
|---|---|
| 左侧面板 | 业绩指标（绩效系数 / 当月金额 / 排名，需 remote_performance）、排班月历、今日任务列表 |
| 主区域 | 可拖拽自定义的看板网格（HTML 看板区块） |
| 右侧面板 | 员工监控面板（月历、任务总计、执行详情） |
工作台的区块来自总管生成的 HTML 看板：
空状态提示："还没有看板，在右侧让总管生成一个 HTML 看板，然后在资源面板里「钉到工作台」"。
点击左侧工具栏的日历标签页（也可在工作台左侧打开排班）。
通过排班编辑弹窗选择员工、日期范围、班次时段、备注，保存即生效。
定时任务存储在 employee_tasks 表（唯一数据源）。创建/编辑员工时通过 TaskService.upsert_employee_tasks() 写入；GET /workspaces/{id}/tasks/sync 重算 next_run_at 并刷新 APScheduler。
dispatch_type 为 skill 或 mcp 的活跃任务confirm_url，执行后写入确认记录last_heartbeat_at 检测卡住的任务tasks/sync）聊天界面右侧的制品/资源面板。
按用途分为多个根：
| 根目录 | 说明 |
|---|---|
| 制品（artifacts） | AI 生成的代码和文档 |
| 上传（uploads） | 用户上传的附件 |
| 技能草稿（skills_draft） | 待导入技能库的技能文件 |
| 工作空间（workspace） | 该员工跨会话的全部产物 |
| 公共区（public） | 跨员工共享的文件 |
支持搜索过滤、查看代码（高亮）、文本、图片、表格、文档、HTML、Markdown。大文件有流式加载指示。
| 操作 | 说明 |
|---|---|
| 查看内容 | 点击文件自动渲染 |
| 下载 | 右键或下载按钮（downloadResource） |
| 删除 | 右键或删除按钮（deleteResource） |
| 复制路径 | 右键复制文件绝对/相对路径 |
| 导入为技能 | 对技能草稿点击"导入到技能库" |
| 钉到工作台 | 对 HTML 制品"钉到工作台"，生成看板区块 |
| 在文件管理器中显示 | 仅 Electron 桌面版 |
| 刷新列表 | 点击刷新按钮 |
应用支持多工作空间，团队、对话、技能、排班任务都按工作空间隔离：
id、name、root_path，归属当前用户（user_id）workspace_id 作用域工具栏的铃铛图标（有未读时呈高亮/动画）。
| 类型 | 颜色 |
|---|---|
| 任务完成 | 绿 |
| 任务失败 | 红 |
| 任务超时 | 橙 |
| 任务卡住 | 紫 |
| 任务运行中 | 蓝 |
| 待处理 | 琥珀 |
设置 → 宠物标签页。
| 选项 | 说明 |
|---|---|
| 启用/禁用 | 开关宠物窗口 |
| 皮肤选择 | 内置皮肤（默认 "eve"）、已安装自定义皮肤、Codex 兼容皮肤 |
| 从 zip 安装 | 宠物设置页「从 zip 安装…」，解压到 ~/.boban-staff-next/pets/ |
| 显示策略 | 始终显示 / 主窗口隐藏时显示 |
| 置顶 | 是否始终保持在其他窗口之上 |
自定义皮肤目录：
| 来源 | 路径 | 说明 |
|---|---|---|
| 本应用安装 | ~/.boban-staff-next/pets/<文件夹>/ | zip 安装或手动放置；可卸载 |
| Codex 兼容 | ~/.codex/pets/<文件夹>/ | Petdex / Codex 生态；只读扫描 |
每个宠物文件夹需含 pet.json + 雪碧图（spritesheet.webp 或 sprite.webp）。列表以文件夹名为标识；若 pet.json 的 id 与文件夹名不同，应用会自动匹配。支持 petdex:// 协议加载雪碧图。
| 场景 | 显示文字 |
|---|---|
| 待机 | — |
| 录音中 | "录音中，再点结束" |
| 识别中 | "识别并发送给总管…" |
| 提示 | "点击说话，再点结束并发送" |
工具栏的齿轮图标，或系统托盘右键菜单"打开设置"。
| 标签页 | 功能 |
|---|---|
| 账号与隐私 | 查看个人信息（头像/姓名/部门等）、上传头像、修改密码、退出登录 |
| 通用 | 主题（浅色/深色/跟随系统）、开机自启、自动更新、桌面通知、代理并发/运行参数 |
| 快捷键 | 查看键盘快捷键参考列表 |
| 模型 | 配置 AI 模型与已连接的模型供应商（模型名称、API Key、API 地址、最大输入 Token 等） |
| 宠物 | 桌面宠物设置（见第十章） |
| 插件 | 扩展插件管理（见第十二章） |
| 关于 | 应用版本号、版权信息、检查更新 |
设置 → 插件标签页。
| 操作 | 说明 |
|---|---|
| 启用/禁用 | 开关切换，禁用后扩展服务停止 |
| 打开界面 | 有 UI 的扩展可打开独立窗口 |
| 安装 ZIP | 点击"安装扩展"，选择本地 .zip 扩展包 |
| 卸载 | 确认后删除扩展文件 |
| 刷新列表 | 点击刷新按钮 |
手动安装的扩展位于 ~/.boban-staff-next/extensions/<扩展ID>/，每个扩展必须包含 digital-employee.extension.json 清单文件。
| 菜单项 | 说明 |
|---|---|
| 显示窗口 | 将主窗口带到前台 |
| 打开设置 | 直接打开设置页面 |
| 重启应用 | 重启整个应用（含 Python 后端） |
| 退出 | 完全退出应用 |
| 可能原因 | 解决方法 |
|---|---|
| 授权码错误或过期 | 核对授权码，必要时联系管理员重新发放 |
| 账号密码错误 | 检查用户名和密码 |
| 后端未启动 | 确认后端服务是否运行 |
| 网络/服务器配置不通 | 检查登录页的服务器端地址（IP/端口） |
| 密码过期 | 按提示修改密码后再登录 |
| 可能原因 | 解决方法 |
|---|---|
| AI 模型未配置 | 前往"设置 → 模型"检查 API Key 和模型名称 |
| 员工没有技能 | 为该员工安装至少一个技能 |
| 后端服务异常 | 查看 ~/.boban-staff-next/logs/ 下日志 |
SKILL.md）dispatch_type 为 skill 或 mcptasks/syncpet.json 与雪碧图；若 id 与文件夹名不一致，重新在列表中选择对应项digital-employee.extension.json.exe，macOS 需同时包含 .dmg、.zip 与 latest-mac.yml~/.boban-staff-next/logs/ 下的日志文件用户数据根目录为 ~/.boban-staff-next/（与 Python 后端一致）：
| 数据 | 路径 |
|---|---|
| 用户数据根 | ~/.boban-staff-next/ |
| 日志文件 | ~/.boban-staff-next/logs/ |
| 扩展插件 | ~/.boban-staff-next/extensions/ |
| 自定义宠物皮肤（本应用） | ~/.boban-staff-next/pets/ |
| Codex 兼容宠物皮肤 | ~/.codex/pets/ |
| 内置员工技能（仓库内） | apps/server/local-employees/ |
工作空间与项目产物由后端按工作空间根目录（
root_path）及项目目录管理；登录凭证由 Electron 安全存储（electron-store）保存，非明文auth.json。
删除上述路径即可重置对应数据。注意：清空数据库将清除所有员工、对话和任务数据。