助手

创建

侧栏 + → 创建助手。首次引导会写入简介与 SOUL.md。也可打开应用内市场一键安装内置入门助手（编程、写作、学习、计划、翻译、电脑小帮手等），或粘贴公开 GitHub / .okbot 源导入。

编辑抽屉

编辑助手分区：详情 / 任务 / 自动化 / 记忆 / 技能 / 资料库（小队无记忆 / 技能）。

• 详情：名称、描述、头像（立体 bot-avatar 或 emoji）、可选模型覆盖（指定供应商 + 模型；空则用全局默认）；高级（开发者模式）可编 SOUL.md、是否启用全局技能等
• 任务：长程任务三栏——未做（backlog，可手动删除）/ 进行中 / 结束；详见 自主进化
• 自动化：该助手的定时任务（查看、暂停或删除）；详见 自主进化
• 记忆 / 技能：仅本助手；全局记忆在设置 → 全局记忆
• 资料库：每助手轻量资料柜（见下）

资料库与笔记

助手目录下 resources.jsonl + resources/：HTML 笔记（type=note）、URL（type=url）、文件夹 / 文件引用、收入副本。

• 对话里可让助手「记一下 / 维护着」；内置工具 manage_note（默认启用且通常自动允许）创建或更新同一篇笔记
• URL：助手回复落盘时，其中的 http(s) 链接会自动收入资料库（按规范化 URL 去重；标题优先用 Markdown 链文案，否则用主机名）；列表显示站点 favicon（失败则网络图标）；点开用系统 / 浏览器打开
• 聊天气泡可附带一帧预览卡片（加载该消息时截一次；不落盘缩略图）
• 资料列表新→旧分页；可预览项（md / 笔记 / 代码文本 / 图片）点开为整屏预览（图片可缩放；其它可下载）；预览 md / 代码复用聊天气泡栈，笔记为可编辑 iframe
• 默认不整库注入模型上下文；升级不迁移旧目录散落文件
• 工具相对路径默认在该助手工作根：交付进资料库写 resources/…，临时脚本/产出写 temp/…；编辑页资料库可列表 / 预览 / 删除（新增主要靠对话与工具）
• 边界：有明确时间点或周期 → 定时；当场要办的分步事项 → 长程任务；只要沉淀文档并维护 → 笔记

输入区 @ 提及

在 Composer 输入 @ 可弹出分组候选：助手 / 小队、自动化（定时任务）、技能。↑↓ 选择，Enter / Tab 插入，Esc 关闭。选中项以 chip 夹在正文中（可整颗删除）；发送时正文携带结构化 token，便于模型识别实体。

自动化与技能目录只取当前会话所属助手或小队（小队技能为成员本地技能并集），不跨成员、不混入全局技能。

中途改向

助手忙碌时输入框仍可编辑。再发一条消息会软改向当前在途回合（取消待续跑并带上新消息重开同一上下文）。也可用独立的停止中止该助手全部在途回合；停止会保留中途检查点，之后在输入框发送「继续」可从检查点续跑（手动停止不会触发静默自动续跑）。回合中若遇瞬时模型 / HTTP / 网络失败，会保留检查点并在同一回合内重试该模型段（默认最多 3 次，含首次；settings.watchdog.transientRetries）。网关还跑全局 Watchdog（默认开，约每 30s）：运行已消失或心跳超时，且磁盘上仍有可安全静默续跑的检查点时自动续跑；待审批、软改向进行中、或手动停止留下的检查点不在此列。小队队长检查点同样可被静默 / 冷恢复。失败的用户消息可在气泡上重试。

会话里的表情回应

助手气泡悬停「更多」可点表情：点选 / 更换会静默唤醒助手（引用该条 + emoji）；再点同一表情则清除且不唤醒。助手也可对用户气泡放表情作简短确认。反应写在消息记录上，不新增时间线气泡。

导出助手 / 导入助手

• 导出助手：修改助手抽屉右上角 → 导出助手，得到 .okbot（未加密 zip）。包内为 bot.json（名称、描述、完整头像字段）+ 可选 SOUL.md + skills/。
• 导入助手：侧栏 + → 导入助手，选择 .okbot 或含 bot.json 的文件夹。始终新建一名助手，不改本机模型密钥。

不含会话、记忆、资料库、定时任务与密钥。社区共享市场开放前，导出/导入与应用内市场是交换助手的主要方式。

与进化、长程任务的关系

装好或创建后，助手会走跨会话记忆与跑后「正在进化」静默维护；对话中还可推进长程任务清单、维护定时与笔记。详见 自主进化。