القائمة
BobanStaff（博办数字员工）客户端用户使用手册。当用户询问如何使用客户端进行聊天、与总管协作编排、招募员工、管理技能、查看任务排班、设置桌面宠物、管理扩展插件、切换工作空间、配置系统设置，或遇到使用中的问题（激活失败、登录失败、技能不加载、任务未执行、宠物不显示等）时使用。涵盖所有功能模块的操作步骤和常见问题解答。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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。
删除上述路径即可重置对应数据。注意：清空数据库将清除所有员工、对话和任务数据。