Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Changelog

本文件记录项目的所有重要变更。

格式遵循 Keep a Changelog,版本号遵循 语义化版本规范。

[Unreleased]

[1.0.3b1] - 2026-10-25

新增

  • 建用户时可以同时创建一个默认专家。权限按页面 Tab 拆开,也可以按组折叠
  • 用户组可以限制技能包、知识库、连接器、模型、存储和专家谁能看见
  • 技能包可以共享,并用文件树编辑。创建专家、团队等资源时可以选头像
  • 表单和对话可以让 AI 润色。搜索增加 DeepSeek 与元宝,模型支持 OpenAI Responses API

修复

  • 云端协同共享后可以直接对话。回复进行中不会被刷新冲掉,也不能删掉这场会话
  • 手机截图写到专家自己的工作区。只改定时任务文案时,间隔任务不再重新计时
  • 浏览器工作台恢复中文输入。主动关怀等对话安静后再发
  • 向导密码随数据目录迁移。Linux 桌面无边框窗口可以拖边缘调整大小

变更

  • 云端协同默认打码对端地址和账号。共享来的资源在头像上做标记
  • 支持子路径部署。飞牛原生包标记为 x86

安全

  • 密钥改为加密保存,旧明文仍能读出。插件上传和解压限制了体积

[1.0.2] - 2026-10-18

新增

  • 两台 Octop 可以连起来用:通过云端协同使用对方的专家,能聊天,也能改对方工作区里的文件
  • 专家可以组队。主持人负责分派任务和收尾总结,成员的回复会回到聊天,也会同步到即时通讯
  • 新连接器:企查查、OpenAlex、语雀、Obsidian、Agent Mail,以及钉钉命令行(设备码登录后可查通讯录、日程和文档)
  • 可以用公司的 LDAP 账号登录。Telegram 机器人可以限定哪些用户能跟它说话
  • 记忆可以手改「用户档案」和「强记忆」。和已有记忆打架时先请你确认,不会悄悄覆盖;也可以备份和恢复
  • 技能和技能包可以导出成一个 ZIP,换一台机器再导入。技能包可以关掉别人的打包下载
  • 定时任务可以只跑一次,跑完自动停用,仍留在列表里。聊天进行中可以再补一句,不用等这一轮结束
  • 每个专家可以设定默认对话方式:问答、规划或动手。侧栏可以按自己的账号重新排列
  • 语音支持腾讯云边说边出字。当前模型不可用时,可以按健康状态自动换一个
  • 知识库旁边可以按文件夹浏览文档。新增业务流程、知识工作等专家模板。内置助手可以回答产品和用法问题
  • 别的程序可以通过 Agent MCP 网关调用这个 Agent。ONNX 模型可以不连 Hugging Face 直接加载

修复

  • 中文 Windows 上,搜索或执行命令碰到编码问题时,不再把整轮对话判失败,也不再把命令输出弄丢
  • 旧版 Word(.doc)在知识库里改为显示抽出的文字,在工作区、对话和技能里改为下载
  • 云端团队刷新页面后,正在生成的成员回复还在。对方拒绝登录时,不会把你自己的账号退出
  • 删掉会话会一并清掉它留下的数据。远程存储卡住时,不再挡住整个服务启动
  • 邮件标题里没有按规范编码的中文,可以正常读出来

修复

  • 生成模型服务商配置弹窗:关闭「启用生图工具」或「启用生视频工具」后,「保存」「验证凭证」「测试模型」不再全部失去响应。模型输入框随开关卸载后不再出现在 validateFields() 的结果里,弹窗却直接对它调用 .trim(),抛出的异常被静默吞掉,于是每个按钮都变成空操作;现在改从表单完整 store 回读被保留的模型值,关闭工具也不会丢掉已配置的模型(Fixes #2100)

变更

  • 聊天侧栏分成专家、团队、云端三块;还没有团队或云端连接时,可以直接去创建
  • 个性化里的技能、子智能体、工具、插件、性格和记忆可以分别授权,不必一次全开
  • 输入栏不常用的入口收进「+」。没有开启审批时,不再出现批准按钮
  • 飞牛提供 ARM 安装包,安装后走建账号向导

[1.0.2b9] - 2026-10-16

新增

  • 新增钉钉 CLI 连接器:通过官方钉钉 Workspace CLI(dws)操作通讯录、聊天、日程、文档等;保存后在连接器设置里用设备码登录授权钉钉账号,默认使用钉钉官方应用,也可填写自建应用的 AppKey / AppSecret(#930)
  • 聊天侧栏可置顶专家,并按专家名或会话标题搜索
  • 新增业务流程专家模板,涵盖 SOP、操作手册、流程优化、风险评估、供应商评估和运营报告;中文界面默认使用中文,基于用户提供的材料工作,无需连接器。
  • 自建技能可以单个或批量导出为一个 ZIP;技能包也可以整包导出为同一个 ZIP 格式,再导入到其他专家或技能包(#260)。技能包可以关闭打包下载,关闭后其他用户不能导出 ZIP,创建者和管理员仍可下载
  • 记忆页新增「用户档案」Tab 手动编辑 USER.md,与「强记忆」复用编辑器和会话快照;Agent 文件工具只读。保存后核对 USER.md/MEMORY.md 与普通记忆:手动文档优先,明确冲突转候选审核并提示用户,重复内容避免重复召回。停止的 Agent 也可检查,语义检查不确定或不可用时明确提示,旧版本候选禁止采纳。
  • 记忆页新增「强记忆」Tab,用户可手动编辑 MEMORY.md,支持停止状态的 Agent。每个会话首次加载全文快照并持续复用,修改对新会话生效。用户说「记住」通过 memory_save 保存到 octop-memory,Agent 不再自动改写 MEMORY.md。
  • 聊天侧栏置顶专家;业务流程专家;技能与技能包导出 ZIP
  • 记忆页可手改用户档案与强记忆,冲突转入审核
  • 技能、工具与团队的决策模型;通道插件;模型健康切换
  • 对外 Agent MCP 网关;ONNX 模型可离线加载

修复

  • 无路径搜索不再打满主机内存;失败回合会正常结束
  • 云端专家结束态、未安装插件提示,以及对端模型与知识库显示
  • 用量显示专家名;定时任务会话有标题;文件描述符与 accept 日志
  • Docker 外部数据库重启、知识库运行时与安装后重启提示
  • Embedding 与 rerank 分开识别;飞牛 beta 可升级并保留浏览器驱动
  • 安装向导在已有用户后不再签发令牌

变更

  • 用户消息的复制、编辑按钮一直显示
  • 升级 octop-memory 1.0.2、octop-harness 1.0.4、octop-gateway 1.0.3

[1.0.2b8] - 2026-10-14

新增

  • 对话 mid-turn steering
  • 当前专家记忆备份、恢复与存储维护
  • Telegram 可限制允许的用户 ID

修复

  • Windows 记忆备份恢复;微信旧库定时任务与重启后推送
  • 审批放通、Steer 续跑,以及历史加载中消息消失
  • 知识库上限为 0、本地索引内存、技能集缺包、WPS / 旧版 Word
  • 云端协同多链接与附件;撤销授权未清 API Key
  • App 内下载、输入法回车误提交、命令行默认模型说明

变更

  • 升级 octop-harness 1.0.3 与 octop-gateway 1.0.2

[1.0.2b7] - 2026-10-12

新增

  • Obsidian CLI 连接器;内置连接器目录改为中英文 JSON
  • arXiv 论文检索;Telegram 可限制允许的用户 ID
  • 腾讯云实时语音;记忆提炼预算与超时可配置
  • 云端桥接命令行;会话列表显示进行中与待处理状态
  • 权限选择与自定义侧栏对齐,对话始终可用

修复

  • 便携版启动时向 Python 子进程传递 packages 路径,修复 Linux 安装浏览器报找不到 playwright 的问题(#1996)
  • 回复操作始终可见;无 PostgreSQL 驱动时仍用 SQLite 启动
  • 团队审批期间保留成员回复;删除会话或用户时清理 checkpoint 与工作区
  • 桌面端保留监听配置,支持拖入文件夹,端口占用时不另起实例
  • Docker 首次启动、云端协同连接,以及不兼容的流式用量参数
  • 暗色主题编辑器、英文界面残留中文、便携版升级与输入栏「+」菜单
  • 飞牛原生启动退出、元宝图标,以及对端专家的模型与知识库保存

变更

  • 头像、技能卡片、个人设置抽屉与登录页外观
  • 升级 octop-harness 与 octop-memory;README 加入 Octop Pet

新增

  • 模型配置支持显式选择 OpenAI Chat Completions 或 Responses API,并可按模型启用受限的 Responses → Chat Completions 协议回退

[1.0.2b6] - 2026-10-04

新增

  • Agent Mail 连接器(授权、邮件工具、新邮件任务)

  • LDAP 目录登录

  • 专家默认对话模式;输入栏「+」菜单;未开审批时隐藏批准入口

  • 飞牛 ARM 安装包与多架构镜像

  • 邮箱连接器读取含裸非 ASCII 字节邮件头(如未 MIME 编码的中文发件人/主题)时崩溃 Object of type Header is not JSON serializable:search_emails/read_email 改用 email.policy.default 解析并统一 str() 转换,同时自动解码 MIME 编码头为可读文本;正文中声明未知字符集(如 unknown-8bit)时回退 UTF-8 而非抛 LookupError。影响所有基于该通用 IMAP/SMTP 适配器的邮箱(QQ/网易/Gmail 等)。

新增

  • 专家可配置默认对话模式(Ask / Plan / Craft):新建 / 编辑专家及从专家创建时可选,新建对话与无模式粘性的线程(含 IM / CLI / cron 渠道)按该默认解析,缺省为 Craft;已有对话保持各自粘性的模式不变(Fixes #1310)。
  • 记忆提炼调用参数可配置:记忆设置页新增提炼输出预算、单次提炼/批量整理等待超时;API 另支持 extract_extra_body 传递思考开关等厂商参数。参数经 agent 配置透传到 harness 的记忆辅助调用,与提炼时机(空闲/间隔)相互独立,深度思考的本地模型不再必然撑爆默认 120 秒读取超时(Fixes #1360,需配套 octop-harness / octop-memory 的同名变更)。

变更

  • octop-harness 升到 1.0.1;飞牛安装改为建账号向导

修复

  • 会话「放通所有 / 放通这些工具」后后续 execute 仍弹审批
  • 误报流式失败、提问卡不弹出、TLS 下内部 MCP、过长工具名
  • 远程存储卡住堵住启动;S3 / Postgres 浏览;桌面 beta 覆盖安装;飞牛 8089 残留
  • Windows 全盘存储根、邮箱非 ASCII 头、缺失界面文案
  • PWA 诊断页在手机上可滚动

[1.0.2b5] - 2026-09-29

新增

  • Octop↔Octop 云端桥接,经隧道使用远程专家(聊天与工作区可写;工具/插件/渠道部分可写;技能包、全局 ACP、连接器、知识库仅本机)
  • 内置助手可回答产品与使用问题
  • 可配置 Ollama 本地模型下载目录
  • 账号可自定义侧边栏;角色改为存模板 id(账号侧栏与权限快照,不是运行时角色同步)

修复

  • 媒体预览 CSP、Langfuse 环境变量、IM 附件元数据
  • CLI 状态文件原子读写;移动端采集失败后停止 JPEG 流
  • 服务关闭时仍可识别本机 Ollama 模型
  • Dashboard 设计 token、知识库暗色预览、备份导入内置技能过滤
  • 旧插件 harness_agent 导入;移动端输入框避让视口

变更

  • 更新 README 路线图、锚点与产品名链接

[1.0.2b4] - 2026-09-27

新增

  • 侧栏可按账号自定义;角色模板 id 持久化

修复

  • 暗色主题下知识库 Markdown 预览不可见

变更

  • README 路线图与产品链接更新

[1.0.2b3] - 2026-09-26

新增

  • 角色模板、邀请快照与头像;登录页「记住登录状态」
  • 企查查同时支持一键 OAuth 与 API Key
  • 团队产物、工具轨迹与主持人收尾;管理员批量策略与令牌

变更

  • 运行时依赖切换为 octop-harness / octop-gateway / octop-memory / octop-browser 1.0.0

修复

  • 团队聊天与 IM:思考仅在团队房间默认折叠,工具状态改为通用提示
  • 知识库文档上限与重命名、审计/会话列表 limit、多 worker 下角色与 HITL 即时生效
  • 内置技能写保护、超大插件 UI 剥离、端口/验证码分数/IPv6 等边界校验
  • 旧备份恢复时幂等补齐 schema v18

[1.0.2b2] - 2026-09-23

新增

  • Teams 主持人改写派工,成员回复同步 IM
  • 企查查、OpenAlex 连接器

修复

  • 专家编辑、聊天欢迎标题与专家切换预填
  • FPK 预发布版本解析、沙箱 ACP 委托、桌面重启 WAL、定时任务失败后 prompt 残留
  • 连接器 OAuth 回调安全加固

[1.0.2b1] - 2026-09-22

新增

  • 技能包新增「复制策略」(copy_policy,默认 snapshot 行为不变):创建者/管理员可按包设为 lock(复制出的工作区副本带 origin/locked 水印,非创建者在工作区写接口被拒)或 deny(复制端点 403、前端按钮禁用);复制成功与拒绝均落 audit。锁定副本在 Agent 工具层的写保护依赖 harness 侧配合,已在 issue 中单列(#770)
  • 登录验证码新增极验行为验 v4(#870):设置页配置 captcha_id / captcha_key,登录弹窗完成验证,服务端按官方协议 HMAC-SHA256 签名后到 gcaptcha4 二次校验(form-urlencoded,仅 result=success 放行)
  • 对话支持默认折叠思考与工具过程(浏览器本地偏好)(#718)
  • 对话中可隐藏不常用的共享专家(浏览器本地偏好)(#589)
  • 腾讯云语音新增实时(流式)识别:开启后输入框麦克风为按住说话,边说边显示中间结果、松开即出全文;凭据仅保存在服务端,浏览器只收到开关状态;配置存于语音 provider 的 extra_json,无数据库迁移

修复

  • 切换专家或会话时,聊天输入框不再沿用上一专家的一次性预填提示词,改为恢复目标专家/会话的草稿(#363)

  • 聊天输入框对话模式与模型按钮改为仅显示图标(选中项放到 tooltip),模型选择弹框补上提供商 logo

  • 发布专家时保留源专家的公开头像(内置 SVG 或远程肖像);仅上传过自定义图片时才走快照头像接口,不再发布后只剩默认图标

  • CLI cron run-now 等待执行及状态、审计落库完成后再关闭内嵌服务;执行失败返回非零退出码,不再提前打印 ok(#946)

  • 专家清单生成读取技能元数据改用共享 frontmatter 解析器:模块内自带的解析只认首行 --- 并按 : 逐行切分,导致 description: >- 折叠块被当成字面量 '>-'、前导 HTML 注释会让整段 frontmatter 失效——技能描述以空值/错值进入生成提示词,进而写坏专家清单的 description 与 welcome_message

  • date: 定时触发与 cron: 一样使用 default_timezone,裸 ISO 时间不再回落宿主系统时区

  • HITL resume 流失败时将 pending 标为 expired(不再像成功批准),避免错误状态误导排查

  • SQLite 写事务改用 BEGIN IMMEDIATE:多 worker(octop run --workers N)或 CLI 与服务并发写入时,先读后写的事务不再因快照过期而立即报 database is locked

  • 登录页「忘记密码」改为按需展开:优先提示联系管理员,本机 CLI 重置作为次要说明(#869)

  • iOS PWA 状态栏不再虚化遮挡内容:顶栏改为不透明、去掉 backdrop-filter;登录页与设置向导补 safe-area-inset 内边距(#874)

  • 知识库纯文本/Markdown/CSV 在 UTF-8 失败时回退 GB18030,避免 Windows GBK 文档被替换成乱码后入库

  • Dashboard 保存 Agent 运行参数后立即刷新当前 Agent 上下文,避免重置按钮和聊天页继续使用旧值

  • Dashboard ask_user_question 卡片不再在刷新/切会话后重复弹出:HITL pending 在恢复开始即标记完成,新回合会作废遗留提问,历史重注入按 pending_id 幂等去重 (#782)

  • 远程 OCR 返回「未收到图片 / 请上传图片」等拒绝提示时不再当作正文入库(此前会被向量化、文档仍标记 ready),现按无可提取文本处理

  • 环境变量值含换行(如粘贴的多行密钥)时,保存后再读取会被截断并残留引号;现按引号跨行读回,保证「写入 → 读取」往返保真

  • 定时任务与系统任务(TLS 自动续期、自动备份)此前按宿主系统时区触发,现按 default_timezone 配置时区执行

  • 删除知识库文件夹不再误删名字相近的文件夹:此前用 path LIKE '<目录>/%' 匹配子项,文件夹名里的 _ / % 被当作通配符(删 a_b 会连带删 axb/…),且 SQLite 的 LIKE 不区分大小写(删 Docs 会删 docs/…,与 PostgreSQL 不一致);现改为大小写敏感的前缀比较

  • 修复知识库选择未按专家记忆的问题:对话中选择的知识库此前是全局单一状态,切换专家后既不恢复该专家上次的手动选择、还会把上一个专家的选择带入(或在会话间被默认值覆盖);现与连接器一致,按专家持久化选择(localStorage),切回专家时恢复其上次手动选择(含显式清空),新会话仍按专家默认值初始化;连接器选择同样补上切换专家时的状态重置,消除其跨专家串选(A 专家的连接器带入 B 专家会话)问题

  • Dashboard 在 Chromium 90 等旧版浏览器中因缺少 Object.hasOwn 而无法启动

  • 侧栏切换路由不再因 AuthGuard 重跑校验而整页闪 Spinner;仅右侧内容区切换 (#696)

  • 无网络或后端不可达时,启动页展示明确错误与重试,而不再白屏 (#696)

  • iOS PWA 顶栏/侧栏避让状态栏:env(safe-area-inset-top) 垫高移动端 Header 与抽屉品牌行(#664)

  • 定时任务空状态提示词:workspace 缺省时回退到专家目录模板 / 名称默认,与 welcome 共用解析 (#651)

  • 对话 Ask / Plan / Craft 模式,以及折叠思考与工具过程

  • 生成模型多厂商管理与图片/视频独立路由(火山方舟、百炼、MiniMax)

  • 插件市场;专家团队宿主;Discord 渠道

  • 登录极验行为验 v4;按专家记忆知识库/连接器选择,可隐藏不常用共享专家

修复

  • Windows 自升级:octop.exe 运行中也可完成升级
  • 同一线程回合串行,避免 HITL 与普通回合交错污染会话
  • agent 配置 PATCH 不再丢掉 workspace_dir;cron / 系统任务按时区触发
  • iOS PWA 状态栏与 safe-area;无网络启动错误提示;旧版 Chromium 启动兼容

变更

  • 升级 harness-agent 至 1.0.14;Dashboard 空状态与聊天输入交互微调

  • 连接器 OAuth 回调对重定向 URL 和错误消息安全编码,拒绝外站和控制字符绕过;弹窗仅向同源窗口发送授权通知,并保留回跳路径的查询参数与片段

[1.0.1] - 2026-09-18

新增

  • 飞书 / 钉钉 / 企业微信 OAuth SSO 登录与绑定
  • 可选登录验证码(滑块及多家云验证码),并提供 octop captcha reset
  • 容器工作区默认、专家头像,以及聊天 HITL / 技能选择体验优化
  • 模型列表搜索;ACP 纳入个性化「工具」页签

修复

  • 超长 URL 导致历史消息加载极慢
  • 手动创建渠道默认启用;PostgreSQL 知识库缺列;损坏 config 被清空
  • 若干 Dashboard / 构建相关问题(权限页签、抽屉滚动、Windows 构建等)

变更

  • 升级 harness-agent / harness-browser

[1.0.0] - 2026-09-14

新增

  • GA 版本正式发布
  • 更新检查默认仅查稳定版,可选包含预发布

变更

  • 登录页与浏览器标题 slogan 更新为「懂你、帮你、陪你成长的智能伙伴」

修复

  • 备份列表大归档时不再全量扫描 tar
  • 腾讯云语音探测失败在中文界面本地化

[0.9.35] - 2026-09-13

新增

  • 聊天支持 @ 提及工作区文件
  • STT 探测改为真实识别调用,与 TTS 对称

修复

  • 语音模型探测不再因凭证/网络错误返回 500,直接展示云厂商真实错误原因
  • 浏览器录音上传前转码为 WAV,修复腾讯/Mimo 语音识别不支持 webm 容器导致的识别失败
  • STT 探测改为真实识别调用,与 TTS 探测对称,凭证/网络错误以 ok:false 返回
  • 语音探测按界面语言返回中文/英文错误(含腾讯云 SecretId 等常见鉴权失败)
  • 语音探测失败直接展示错误,不再返回 500;录音上传前转码为 WAV
  • /compact 回复隐藏本机绝对路径
  • octop run 正确应用 OCTOP_PORT / OCTOP_BIND_HOST

[0.9.34] - 2026-09-12

新增

  • 聊天头像改到输入框两侧,失败轮次保留内容和错误
  • 定时任务空状态改用专家任务示例

修复

  • 刷新后消息时间戳不再丢失,用户气泡与头像对齐
  • FnOS 安装向导接管管理员密码,避免默认弱密码导致无法启动

变更

  • README 补齐知识库、插件、PostgreSQL 等说明

[0.9.33] - 2026-09-11

新增

  • 知识库支持下载原文、按原排版预览,聊天内可直接预览引用
  • 技能可在技能包与专家工作区之间复制
  • 记忆树支持手动新建与修正;Token 统计支持日期筛选与 Excel 导出
  • 按用户限制存储根目录与 Token 配额;创建专家可带默认知识库与连接器
  • 聊天支持 @ 子专家、技能斜杠插入,以及 ask_agent 独立对话线程
  • 滴滴连接器;可选分段历史归档;便携运行时升级并支持 SQLite 备份

修复

  • 工作区 zip 导出不再被 backend 根目录同名文件顶替;导入时保留隐藏系统状态
  • 知识库文本文档编辑保存生效;共享专家技能可在聊天中使用
  • 斜杠命令刷新后仍可见;新会话标题即时更新
  • 升级检查失败提示本地化;OpenCode Go 请求携带会话 ID

变更

  • 聊天点技能改为插入 /slug;创建定时任务必须填写名称
  • 依赖 harness-gateway ≥ 0.9.6、orcakit-harness-agent ≥ 1.0.8

新增

  • QQ 私聊默认走官方 stream_messages 替换流式:进站先发不可见换行 hold,再按完整 markdown 块更新同一条气泡;<think> 会剥掉且不 .trim() 掉换行
  • 流式失败、前缀被拒(40007)或只发出 hold 时,回落为一条静态 markdown(msg_type=2,失败再 0)

修复

  • 飞书话题内回复改走话题回复接口并带 reply_in_thread,失败时回退为群内普通发送;话题以 thread_id 作为会话主体

变更

  • QQ 私聊不再使用通用「回复模式」开关,旧键 streaming / response_mode 无效;只有显式 c2c_streaming: false 才退出流式
  • QQ 群聊 / 频道 / 频道私信没有 stream API,仍只发静态消息
  • 控制台保存 QQ 通道时写入 c2c_streaming: true,并提示工具过程会另占每条入站约 4 条被动回复配额
  • 依赖 harness-gateway>=0.9.7(含 QQ C2C 替换流式与飞书话题修复)

[0.9.32] - 2026-09-06

新增

  • 聊天运行轨迹抽屉与回合时间轴;人机确认以可读审批卡片展示
  • 知识库支持更多文档格式与可选 OCR,上传显示进度
  • 定时任务支持名称,计划回合持久化
  • 备份可选择归档内容;连接器支持多实例与共享;插件可按智能体开关
  • OpenSandbox 远程沙箱;工作台浏览器按用户隔离 profile
  • 飞书扫码创建应用;远程手机可自动安装 Docker
  • 桌面端 Windows NSIS 安装包与 macOS DMG;未知路由 404 页

修复

  • 斜杠命令写入 harness 会话 checkpoint,刷新后仍可见,且下一轮模型能读到
  • 桌面客户端打包把 pyproject.toml 版本写入 macOS Info.plist、Windows 文件版本和 NSIS 安装器,不再沿用写死的旧号
  • 用户发布专家卡片展示快照内自定义头像(icon_url + /api/experts/published/{id}/avatar),不再只显示默认 Lucide 图标
  • 用户管理表格(桌面端)横向滚动时固定用户名与操作列(与专家列表一致;移动端不固定)
  • 运行轨迹流式事件在内存聚合、回合边界持久化,避免逐 token 写库和重复存储上下文全文
  • 运行轨迹 Turns / Calls 折叠与耗时投影:历史缺 turn_id / 时长时回退为 USER 边界与内容体量估算,避免开关无效
  • 知识库表格模式宽屏仍出现多余水平滚动条(列宽拖拽手柄越出最后一列)
  • 聊天右侧停靠/弹窗工具栏避开无边框窗口按钮,避免与红绿灯重叠
  • 桌面启动页改为白底卡片和底部进度条;Windows 设置窗加高,避免底边距被裁掉
  • 桌面壳内隐藏「安装为桌面应用」,避免在已原生窗口里再提示 PWA 安装
  • 日志按大小+按日轮转,并采用 logrotate 风格的 compress + delaycompress(最新一份轮转文件暂不 gzip,下一轮再压;用 Python 标准库,Windows 可用)
  • 远程手机自动安装 Docker 后,非 root 时用 sudo -n 写 daemon.json 并重启 dockerd
  • 旧备份在 schema 变更后可恢复;桌面打包版本与应用元数据对齐
  • 主动关怀时区、专家卡片头像、用户表固定列
  • 运行轨迹写库开销、日志轮转、通道二维码轮询与远程 Docker 安装权限

变更

  • 语音与搜索设置迁到模型页;控制台改用 OctopSpinner
  • 默认管理员凭据改为首次运行写入 ~/octop-login.txt

[0.9.31] - 2026-09-01

新增

  • 聊天流式输出时默认展开思考/工具过程,回答完成后收起(历史记录仍收起)
  • 聊天侧栏与 @ 选择仅展示运行中的专家
  • 默认专家与控制台创建的专家一样使用家目录存储;聊天待办按计划顺序展示
  • 工作台浏览器可显式结束本地 Chrome 进程;空闲超时后也会回收(登录态仍保留在磁盘 profile)
  • 桌面端右上角窗口控制(最小化 / 最大化 / 关闭进托盘)

修复

  • 过期 hashed 静态资源返回 404,避免升级后桌面壳加载旧脚本
  • 桌面无边框窗口改为 CSS/JS 拖拽,去掉会挡住右上角按钮的 InvisibleTitleBarHeight
  • macOS 点击程序坞只恢复主窗口,不再同时弹出托盘设置窗
  • 专家详情技能/子智能体卡片:图标在标题左侧,状态或 id 在标题右侧,描述单独一行
  • 桌面端等待本机服务就绪失败时改为中英文说明(跟随桌面语言设置),不再显示 /api/health 英文报错
  • 桌面启动页补齐右上角窗口按钮,并收紧启动/失败状态的展示
  • 桌面托盘设置窗去掉多余空白,右上角只保留关闭;macOS 单击菜单栏图标也会弹出设置

[0.9.30] - 2026-08-31

新增

  • 腾讯云 Token Plan 企业版与 Hy 套餐
  • WeKnora、Dify 连接器,以及自定义 MCP 的 OAuth
  • 备份/恢复、聊天工具栏、SSO 预设与更友好的供应商错误提示
  • 技能展示本地化;知识库可配置文档数量上限;钉钉扫码注册
  • 对话接入 ask-user-question 人机确认流程

修复

  • 专家根目录、连接器排序、飞牛图标及主题确认对话框等界面问题
  • 聊天中文语音识别跟随界面语言
  • MCP OAuth 刷新失败需重新授权;渠道异常 thinking 输出过滤
  • 数据库 v10 迁移遗漏 thread projection 表
  • 飞牛 FPK 无效在线升级与原生版启动加载;长会话相关问题
  • 通道弹框文案统一为「通道」,新建默认实时过程
  • octop acp 启动即崩溃(CLI 注册表属性应对齐 acp_cmd)

[0.9.29] - 2026-08-27

修复

  • 长会话卡死:聊天历史改为独立投影分页加载,并支持后台迁移旧会话(不再同步扫 checkpoint)

变更

  • 依赖:orcakit-harness-agent[all]>=0.9.27、harness-memory>=0.9.7、harness-browser>=0.7.6(自动 full VACUUM 关闭,空闲维护只走 lifecycle GC + incremental nudge_vacuum)

[0.9.28] - 2026-08-26

修复

  • 无更新权限时隐藏检查更新入口
  • /compact 兼容 .octop/conversation_history/ 卸载路径
  • FnOS 镜像改为 Docker Hub jubaoliang/octop

新增

  • 基层医生学习助手增加普通医学问答快路径、国内专业学会/专科分会与国际指南精确路由,并完善受控信源降级和检索预算。

[0.9.27] - 2026-08-26

新增

  • 内置插件随包装分发(默认关闭,卸载后升级不重建)
  • 可配置上传上限(max_upload_mb / OCTOP_MAX_UPLOAD_MB,默认 100MB)
  • Dashboard 推送通知(定时任务与主动关怀 toast)
  • 聊天音视频附件预览播放,并扩展 inbound 附件 MIME
  • 火山方舟 Seedream / Seedance 生成模型配置、测试与结果展示
  • 连接器:Ardot、滴答清单;远程 MCP OAuth 改为 catalog 驱动
  • 单工具开关热更新与插件工具目录
  • ACP 内置 Runner:Kimi Code、Cursor CLI、Pi
  • 知识库文件夹重命名
  • ONNX 模型下载竞速 Hugging Face 与 hf-mirror
  • 远程手机 ADB shell(旋转与分屏布局)
  • FnOS NAS 应用打包(Docker / native .fpk)
  • 专家模板扩充(通用、Karpathy、临床来源策略)
  • 中文子智能体约 49 个(HR / 法务 / 供应链)
  • Dashboard 剪贴板回退与聊天 UI 打磨

修复

  • 知识库文件夹操作按钮误开文件夹
  • 工具预期失败不再误报为 stream_error
  • 连接器 OAuth 公网回调 / HTTPS / 自动保存;npm 不可写时回退用户级 prefix
  • SSO ID token issuer 校验
  • Dashboard:SW 激活后再 reload、Firefox 无限刷新、选择器 popover、文案全球化
  • 浏览器 runtime 目录在 Windows 上可写探测

变更

  • FnOS 打包拆分为 docker/ 与 native/

[0.9.26] - 2026-08-23

新增

  • 远程手机(实验性):安装时探测主机移动能力(capabilities.mobile,物理机 / Redroid / KVM);能力开启后开放 GET /api/settings/capabilities 与 /api/mobile/*。控制台「远程手机」支持 adb H.264/JPEG 推流、触控、画质预设、设备信息与 AI 助手面板;智能体移动工具绑定当前远程手机会话
  • 控制台布局支持经典 / 极简模式,聊天记录统一承载;用户可选填邮箱(邀请 / 登录);知识库支持应用内编辑 markdown / txt;远程桌面与远程手机合并为统一控制入口

修复

  • 邀请链接统一为 /invite?code=,修复邀请页居中与移动端在 overflow-hidden 壳下的滚动;启动前显示 logo 加载动画;设置页邮箱输入图标对齐;移除聊天坞中的远程手机入口
  • 加固 dashboard 鉴权与请求层(setup 锁定 503、401 刷新)、登录页与 AuthGuard 体验;按服务器能力门控移动端功能;远程控制中枢页签文案缩短为「服务器 / 手机」

[0.9.25] - 2026-08-21

新增

  • Token 计量新增缓存命中支持:按模型调用累计未缓存输入、缓存读取、缓存写入、推理 Token 与模型调用次数;用量页和消息气泡展示缓存命中数据。
  • 编辑专家抽屉可修改标题语(欢迎语),与创建时同一字段,写入智能体实例而非仅页面配置
  • 专家支持上传自定义头像,写入工作区 .octop/avatar.png(或 jpg/webp/gif)并通过 agents.icon_url 展示;发布快照会带上头像,安装后自动绑定。未设置时仍用配色 + Lucide 图标
  • 实例化专家的欢迎语改为单一 welcome_message 字段(用户自填,不再分中英);专家模板仍保留双语欢迎词
  • 智能体状态接口返回 memory_maintenance(queued / pruning / compacting)。聊天页显示阶段进度条,整理本库时暂停发送;专家卡片显示「整理记忆」标签。
  • 聊天页:文件工具卡片显示「编辑了 N 个文件」(不含截图);文件面板标题改为「文件变更」。会话 artifacts 由 Octop 工具中间件在写文件 / 发文件 / 桌面截图成功后写入,切换会话后仍可在文件变更中查看。路径优先取工具 args,仅在 args 没有 path 时才扫结果文本。专家选择器「共享」标记与名称同一行。右侧增加工作区入口;工作区目录树支持将文件拖到其他文件夹。
  • 知识库、技能包、已发布专家改为整数自增 id + 对外字符串 ID(knowledge_base_id / skill_package_id / published_expert_id;文档用 kb_id 关联)。agents 仍用字符串引用技能包与已发布专家。知识库文档支持文件夹路径;分片大小等仍存实例 settings。删除未使用的 knowledge_base_members。上述库变更与专家资料列、会话 artifacts、实例欢迎语单字段一并作为 schema v7。
  • 对话检索结果附带知识库引用标记;聊天页在回答下方展示可点击的来源文档(跳转知识库页)

修复

  • 技能:修复编辑已导入技能并保存后,技能内其余文件与文件夹(README.md、references/ 等)被整体清除的问题——内容编辑(仅 SKILL.md)现原地覆盖清单文件、保留全部同级文件;携带完整 files 载荷的更新仍整目录替换(与覆盖重装语义一致)
  • Harness usage 事件按稳定调用 ID 去重,避免流重放重复计费;上下文环保留路由模型的真实窗口上限,并将构成拆分明确显示为近似估算。
  • Admin 环境变量未进入正在运行的 Agent:本地 shell 默认不继承进程 env,Docker exec 也不传 env,工作区 .env 只落盘不注入。现本地 shell 每次 execute 继承当前进程环境(含 ~/.octop/env)并 overlay 工作区 .env;Docker 热读全局文件 + 工作区 .env + 最小 PATH(不含完整宿主机环境)。保存 Admin 列表会从进程环境删除已去掉的键;仅搜索类 key 变化时后台 reload Agent。MCP stdio 只注入 SDK 安全子集 + 全局/连接器 env,不再灌入整份 os.environ。
  • Token 用量账本每轮只记下最后一次模型调用,工具循环中前面若干次调用被丢弃,页面合计会远低于聊天里看到的用量;现按该轮全部 AI 调用的 usage_metadata 累加,以 state_snapshot 为权威终值(snapshot 之后的增量不再相加),畸形 usage 字段跳过以免打断对话
  • 插件工具使用中文等非 ASCII 名称时 LLM 调用失败:主流 API 要求工具名匹配 ^[a-zA-Z0-9_-]{1,64}$,现自动将非法名称转写为合法拼音名(pypinyin 缺失时退回下划线替换),冲突追加 _2/_3 后缀,并在工具描述前缀 [原名: …] 保留原名映射;config_json.plugins 配置键与插件内部仍使用原始名称,路由不受影响
  • 修复聊天页在"生成中"时于输入框持续打字导致消息列表上下轻微抖动的问题:输入框高度测量改为在离屏克隆节点上进行,不再瞬态改变页面布局
  • 工作区读写在 harness 后台重建窗口(DB 仍为 running)回退到 workspace_for_agent,避免误报 AGENT_NOT_RUNNING
  • 聊天页上下文占用环:旧会话没有分段快照时,从消息上已有的 usage_metadata / response_metadata.token_usage 回填已用量;相对 1M 级窗口不再把真实占用四舍五入成 0%
  • 专家抽屉保存页面配置时合并写入 manifest.json:保留其它字段与另一语言欢迎语;加载未完成或未改动时不写文件
  • 修复个性化「通道」面板在页面放大后不出现纵向滚动条、被挤出的通道卡片无法查看的问题:工具栏固定、卡片网格改为内部滚动区(与技能面板一致),移动端仍整页滚动

[0.9.24] - 2026-08-15

新增

  • 知识库:新增知识库与对话检索,支持本地 ONNX 向量嵌入模型运行
  • 认证:新增 OpenID Connect(OIDC)单点登录
  • 权限:新增按用户模块权限(RBAC)及管理员绕过
  • 专家:支持将工作区快照发布为可安装模板(专家市场)
  • 智能体:支持将智能体共享给其他用户
  • 技能:新增对话式技能管理器(SkillHub),并兼容 Windows
  • 备份:新增自动定时系统备份
  • 频道:新增 final-only 仅终稿回复模式
  • 线程:支持从 AI 回复处分叉会话(fork)
  • 体验:HITL 工具选择器、运行时按需安装、KB/技能 UX 优化;对话与镜像等界面打磨;知识嵌入初始化流程加固

修复

  • 媒体/预览白名单补充音频 MIME 类型
  • 修正 ONNX 下载检测在未安装 fastembed 时的误判
  • 加固更新状态缓存与存储处理
  • 预提交门控:修复 staged 变更检测,避免 testmon 门控误报为绿

变更

  • 升级 harness-browser 依赖至 0.7.5
  • 数据库 schema 收敛为 v5
  • 备份恢复面板图标更新为 CalendarClock;对话/镜像等界面打磨

[0.9.23] - 2026-08-13

修复

  • 取消首次引导时删除 octop-login.txt 引导密码文件的逻辑,避免引导密码意外丢失
  • 修复安装脚本版本显示问题,并将安装输出调整为英文

新增

  • Octop-owned built-in skill-manager for conversational Skill lifecycle management from uploaded files, archives, Git/GitHub or web URLs, and SkillHub. It is seeded into every agent instance without modifying harness-agent and installs user Skills only under that agent's skills/.

[0.9.22] - 2026-08-11

新增

  • 专家工作区支持 .docx 在线编辑:以 Markdown 在 Monaco 中打开/保存,保存时转回 docx 覆盖原文件(标题/加粗/斜体/列表/表格保留,复杂格式简化);工作区新建的 .docx 即初始化为合法文档包,预览/编辑立即可用。基于可扩展注册表,新增可编辑后缀只需注册一个后端转换器类 + 前端注册表一行

变更

  • 依赖新增 python-docx==1.2.0(含 lxml),用于工作区 .docx 的 Markdown 往返转换

修复

  • 仪表盘发版后或长时间未打开时白屏:Service Worker 不再 Cache-First 钉死旧 index.html;hashed 资源改为 CacheFirst;入口脚本失败时清除 SW 缓存并自动刷新一次 (#236)

安全

  • 仪表盘 SPA 静态回退路由加固:在拼接路径前显式拒绝绝对路径与 .. 父目录引用,并保留最终 relative_to 校验,杜绝路径穿越读取 dashboard 目录之外的文件(修复 CodeQL 标记的 Uncontrolled data used in path expression)

[0.9.21] - 2026-08-11

新增

  • 插件管理页支持从本地 ZIP 上传安装插件,可选覆盖已安装的同名插件,无需先把插件托管到 HTTP 直链
  • Docker 沙箱 backend(agent config.backend.type=docker 或存储 kind=docker);Admin Docker 卡片、本机 Docker 探测/安装;详见 docs/agent-backend-file-io.md §13
  • 强制密码策略并优化账户与子代理(subagent)使用体验
  • 浏览器 HITL 流式交互与网关抢占能力
  • 新增每用户模型与推理(reasoning)偏好设置

变更

  • 依赖 orcakit-harness-agent[all]>=0.9.20;FilesystemGuard / ModelSettings 由 harness 自动挂载(Octop 仅保留 BinaryReadGuard 与 runtime_limits)
  • 专家 workspace_dir:创建时写入 config_json.workspace_dir(默认 {OCTOP_HOME}/agents/<id>/),所有 backend 共用;Docker 在容器内镜像同名路径为专家工作区,宿主同路径放 sessions/memory/checkpoints
  • Docker:sandbox_scope(agent/user/fixed)+ sandbox_prefix(默认 octop_sandbox);删专家不删容器;专家工作区在 running 时可预览;Admin 存储 previewable 仅控制浏览(默认仅 fixed);探测用 test 沙箱做真实读写
  • 删除被专家 named 引用的存储后端时返回 STORAGE_BACKEND_REFERENCED 并列出引用专家
  • 将 IM 频道定时任务从 ACE 迁移至 Octop cron

修复

  • 超大图片不再降级为附件路径提示:超过视觉嵌入上限(2 MB)的图片由 Pillow 压缩缩放至最长边 1568px 后仍以内联图片嵌入请求(保留 EXIF 方向与透明通道,仅当压缩失败时才回退为路径提示),视觉模型自动升级随之生效 (#219)
  • 保留技能 ZIP 导入时的空目录与根级技能的子文件夹
  • 修复移动端个人设置抽屉,并恢复玫瑰色主题配色

[0.9.20] - 2026-08-09

新增

  • QQ 频道二维码扫码绑定,支持群聊上下文(仪表盘频道抽屉 + octop channel CLI)(#160)
  • 语音接入小米 MiMo STT / TTS 供应商(mimo-v2.5-asr / mimo-v2.5-tts),设置页可选择计费端点与 9 种预置音色,TTS 标注限免 (#186)
  • 仪表盘自定义品牌配色:8 套调色板(玫瑰 / 科技 / 靛蓝 / 青绿 / 紫罗兰 / 翠绿 / 琥珀 / 石墨),与浅色 / 深色模式正交且本地持久化

修复

  • Windows 下新建 agent 时,本地后端 root_dir:"/" 被解析为当前盘根目录,导致读取工作区(通常位于另一盘符)时抛 Path ... outside root directory;现在后端规格解析会在 Windows 上将主机根 / 的 root_dir 改写为工作区路径(保留原 type 等字段)
  • 删除专家时同步清理 ~/.octop/agents/<id>/ 工作区目录(rmtree 移出事件循环执行);清理失败不阻断数据库删除;仪表盘与 CLI 删除确认提示工作区将永久删除且不可恢复
  • 乐享连接器 MCP URL 补充 preset=meta 参数并简化快捷授权链接 (#213)
  • 专家卡片的编辑 / 删除按钮默认可见,不再仅在悬停时显示 (#187, #193)
  • 登录页滑动验证通过后,提示文案居中显示在滑块左侧的可见区域 (#185)

变更

  • 企业微信客户群二维码与文档有效期更新至 2026-08-16

[0.9.19] - 2026-08-05

新增

  • 登录页滑动验证控件;侧栏与 Agent 资料抽屉 UI 优化 (#170)
  • 聊天历史 API 返回 turn_active,重连客户端可 re-subscribe WebSocket 恢复流式输出 (#168, #157)
  • Workbench 与聊天 Dock 共用同一 terminal 会话;旧式硬切会话标题迁移为带省略号的裁剪标题 (#157)
  • 局部 root_dir 下 Linux bubblewrap execute jail(POST /api/filesystem/ensure-bwrap、仪表盘 root 目录树 mkdir/rename)(#167)
  • 虚拟工作区路径 I/O:host 绝对路径经 file:// 与 BackendWorkspace failback 对齐 (#167)
  • 高级设置「更新」页提供按安装方式升级说明与一键检查升级双栏布局;HTTPS 页优化签发状态与预检展示 (#143)

修复

  • 401 会话过期时通过 React Router 跳转登录,避免整页 reload 导致 lazy chunk 白屏 (#169)

变更

  • make all 先执行前后端 format-all(Ruff + Prettier);pre-commit 在 format 后回写已暂存文件并构建 dashboard (#143)
  • harness runtime 诊断日志写入 ~/.octop/logs(与 octop.log 并排),不再落到各 agent workspace 的 logs/;行内带 [agent=…]
  • 依赖 orcakit-harness-agent>=0.9.19、harness-gateway>=0.9.1(scoped root execute jail)
  • 企业微信客户群二维码与文档有效期更新至 2026-08-08 (#149)

[0.9.18] - 2026-08-02

新增

  • 聊天 Dock 支持可关闭的文件列表 / 预览 / 浏览器标签页,以及 PR 风格路径树与路径去重;账户气泡与侧栏交互打磨 (#130)
  • 内置示例插件(greeting / toolkit / turn-logger)与中英文插件说明文档
  • 搜索设置页显性展示当前搜索源:未配置第三方服务时提示内置搜索,配置后展示实际服务 (#109)

修复

  • 已停止或禁用的专家统一返回 AGENT_NOT_RUNNING(不再误报未找到);管理员 Token Usage 支持按用户筛选;聊天会话频道图标与创建用户角色选择优化 (#137)
  • 强化插件安装错误诊断与自定义 MCP 校验;网关流式错误支持本地化
  • 聊天流式错误在界面可见;Token Usage / Memory 图表与空状态展示优化;弹层 Dock 几何与全屏行为修正

变更

  • 设置、连接器、插件管理与管理用户等页面统一到共用仪表盘布局语言
  • Docker / 安装文档中的国内加速镜像示例改为腾讯云镜像 (#116)
  • 依赖抬升:orcakit-harness-agent ≥0.9.18、harness-memory ≥0.9.5;对齐 Python 3.12 目标与依赖刷新 (#118)

[0.9.17] - 2026-07-31

新增

  • 全局技能包:实例级可复用技能集合,支持挂载到专家、从 SkillHub 导入技能集,以及本地 ZIP / URL 导入技能
  • 个性化页整合技能 / 子专家 / 频道 / MBTI / 记忆;技能包管理页支持移动端列表详情切换
  • 搜索设置页显性展示当前搜索源:未配置第三方服务时提示使用内置搜索(免 API Key,不保证稳定),配置后展示实际使用的服务 (#109)

变更

  • 技能相关域逻辑迁至 infra/skills/;数据库迁移合并为 schema v2(cron MCP + skill_packages 含图标)(#108)
  • 备份/恢复纳入 skill-packages/ 目录,恢复前清空避免残留 (#108)
  • 统一聊天生成中 / 滚动辅助逻辑;antd message 经 App.useApp 绑定,支持主题感知 toast (#119)

修复

  • Memory 原始事件列表的时间戳按服务器时区展示,与其余 Memory 页保持一致 (#110)

修复

  • 记忆提取 / 提升等 harness 内部辅助 LLM 默认跟随全局偏好模型(此前切换全局模型后仍回退到首个可用模型)(#110)

[0.9.16] - 2026-07-29

新增

  • 统一自定义 / 预设 / 配置提供商弹窗的模型编辑流程,支持拉取 OpenAI 兼容远程模型列表,并仅在显式保存时落库 (#91)
  • 支持从 LightClaw 迁移导入(备份快照与系统归档兼容,含外键约束处理)(#58)

修复

  • 修复自定义提供商弹窗 TypeScript 错误(未使用导入 / 可选 input),恢复 release 构建
  • 从 GitHub URL 导入技能时保留完整技能目录(含引用文件与脚本),并加固归档下载的分支名、文件数与体积限制 (#92)
  • 浏览器配置不再对系统路径执行 chmod,改为使用共享目录 ~/.octop/browser-profiles (#87)
  • 部署后静态资源哈希不匹配导致白屏时,自动软刷新一次并防止重载死循环 (#88)
  • 修正网易邮箱 IMAP 主机解析,并在登录前发送 IMAP ID;同时加固 QQ / 网易 / Gmail 邮件主机预设与探测 (#89)

变更

  • 最低依赖 orcakit-harness-agent 提升至 ≥0.9.16
  • README 补充中长期 Roadmap / 规划说明
  • 新增可选 .githooks 提交前检查(make install-hooks)

[0.9.15] - 2026-07-27

修复

  • 加固聊天导航:切换专家时避免残留旧会话 URL,并稳定流式 Markdown 渲染
  • 优化 Memory / Token Usage 页面布局,消除嵌套滚动并改善信息密度
  • 补充企业微信客户群二维码相关文档说明

[0.9.14] - 2026-07-25

新增

  • 控制平面支持 PostgreSQL 双后端(统一 DatabasePool、并行 PG 迁移、安装向导选择/绑定、pg_dump 备份;PostgreSQL 下记忆默认复用控制平面 DSN)(#60)
  • SkillHub 改为走 HTTP API,支持来源中立的技能包安装与搜索 (#55)
  • 远程浏览器/桌面支持真实拖拽(转发 CDP 指针事件),并共享推流连接中指示 (#50)
  • 聊天界面布局与交互打磨:历史侧栏、消息队列、自动滚动与欢迎页等体验优化 (#66, #69, #70)

修复

  • 修复 macOS/Linux 上 Agent 上下文历史写入主机根目录的问题:依赖 harness-agent≥0.9.12 将 deepagents artifacts 落到 Agent 工作区 (#57)
  • Provider catalog 的 context_window 映射为 harness max_input_tokens,修复 Auto/摘要阈值与 UI 上下文环按错误上限计算的问题
  • 元宝扫码绑定后保存官方 API 与 WebSocket 地址,并升级网关至 0.8.7 以支持完整媒体收发 (#56)
  • ChatGPT/Codex OAuth 改为 device code 流程,修复非 localhost 部署下授权失败 (#54)
  • 技能 CLI 安装不再根据用户输入的 slug 推导路径,避免装错包 (#63)
  • 删除会话时同步清理 harness checkpoint,避免「删除」后消息历史仍残留 (#60)
  • 修正 PostgreSQL 记忆可移植导出的误导性 pg_dump 提示(共享 schema 下按 namespace 隔离,不可整库导出单 agent)(#60)
  • 技能启用/禁用与 SkillHub 安装不再触发整机 Agent rebuild,避免切到技能列表时短暂「未找到 Agent」
  • 修复聊天向上滚动加载更早消息失效,并在列表未溢出时提供可点击回退
  • 工作区路径语义澄清(from_workspace),并加固 Windows 下 file URL / 主机路径校验

变更

  • /compact 改为在当前话题强制触发一次 Summarization(总结较早消息并 offload 到 conversation_history/),不再新建线程;新建空话题请用 /new
  • /compact 成功提示明确:聊天界面仍保留完整历史,压缩的是下一轮模型可见上下文
  • 文档与发布流程改为 develop 日常集成、先合入 main 再打 tag (#48)

[0.9.13] - 2026-07-23

新增

  • SkillHub 改为走 HTTP API,支持来源中立的技能包安装与搜索 (#55)
  • 远程浏览器/桌面支持真实拖拽(转发 CDP 指针事件),并共享推流连接中指示 (#50)

修复

  • 修复 macOS/Linux 上 Agent 上下文历史写入主机根目录的问题:依赖 harness-agent≥0.9.12 将 deepagents artifacts 落到 Agent 工作区 (#49, #57)
  • Provider catalog 的 context_window 映射为 harness max_input_tokens,修复 Auto/摘要阈值与 UI 上下文环按错误上限(如 128k)计算的问题
  • 修复取消聊天任务后再次提问会一直停留在思考状态的问题 (#42, #43)
  • 技能启用/禁用与 SkillHub 安装不再触发整机 Agent rebuild,避免切到技能列表时短暂「未找到 Agent」
  • 内置专家卡片标题与图标水平对齐
  • SkillHub / 专家市场在 Python SSL 失败时给出可操作提示,并修正技能市场错误态「Retry」未本地化为「刷新」(#44, #46)
  • 元宝扫码绑定后保存官方 API 与 WebSocket 地址,并升级网关至 0.8.7 以支持完整媒体收发 (#56)
  • ChatGPT/Codex OAuth 改为 device code 流程,修复非 localhost 部署下授权失败 (#54)
  • 远程桌面安装拒绝不支持的 EL10 环境 (#41)
  • 聊天上下文占用图例在空会话时对齐 (#40)
  • 修复聊天向上滚动加载更早消息失效,并在列表未溢出时提供可点击回退
  • 工作区路径语义澄清(from_workspace),并加固 Windows 下 file URL / 主机路径校验

变更

  • /compact 改为在当前话题强制触发一次 Summarization(总结较早消息并 offload 到 conversation_history/),不再新建线程;新建空话题请用 /new
  • /compact 成功提示明确:聊天界面仍保留完整历史,压缩的是下一轮模型可见上下文
  • 文档与发布流程改为 develop 日常集成、先合入 main 再打 tag (#48)

[0.9.12] - 2026-07-21

新增

  • 备份恢复后可在进程内同步 providers 并重载 agent;提供商变更后仅重载受影响的 agent
  • 新增服务端时区 API(default_timezone / GET /api/settings/timezone),控制台时间展示对齐服务端时区
  • 记忆提炼支持为每个 agent 单独指定提取模型,并在整理记录中展示每次 extract_run 结果

修复

  • 修复记忆提取模型无法 fallback 导致提炼失效的问题
  • 修复语音输入 STT 回退处理
  • 修复内部 MCP gateway 在事件循环上阻塞的问题
  • 修复高级搜索探测接口缺失、表格分页卡在 10 条、新建会话图标提示,并加固安装脚本
  • 改进 Notion OAuth HTTPS 错误提示

变更

  • Memory 页签「全部」更名为「记忆沉淀」

[0.9.11] - 2026-07-19

新增

  • 新增 SkillHub 专家市场:支持浏览、安装与管理专家,并完善安装安全校验与欢迎页快捷卡片体验
  • 新增自定义 MCP 连接器管理,支持探测、工具缓存与连接器配置

[0.9.10] - 2026-07-18

新增

  • 新增工作区文件预览与浏览器工作区支持,并完善相关工具链
  • 新增聊天面板停靠式文件预览、HTML 预览与历史下拉刷新

修复

  • 修复连接器 Notion OAuth 弹窗阻塞的问题 (#19)

变更

  • 重构聊天界面,将浏览器面板与文件面板统一为 ChatDock
  • 调整工作区路径透传逻辑,不再重写 BackendWorkspace 路径
  • 将上下文使用统计委托给 harness-agent 0.9.10

移除

  • 移除内置的临床医生专家 (#20)

[0.9.9] - 2026-07-16

新增

  • 新增远程桌面安装与连接器探测能力增强 (#16)

[0.9.8] - 2026-07-15

新增

  • 远程浏览器/远程桌面安装日志面板新增「复制日志」按钮,并在安装失败时提示可将日志交给 Octop 协助排查
  • 新增前端 copyText 工具,在非安全上下文(如 plain-http 管理页)下通过临时 textarea + execCommand 回退,保证剪贴板复制可用
  • 桌面安装脚本新增 A-F4(关闭窗口)与 C-A-D(显示桌面)openbox 快捷键,对应桌面快捷键

修复

  • 修复桌面安装脚本的 Python 构建依赖检测:改用 venv Python(而非系统 python3)解析 pythonX.Y-dev,避免 evdev 编译时找不到 Python.h;setup.py 安装构建依赖时显式传入 --python 指向当前 venv Python
  • 修复连接器类型漂移导致聊天弹窗 logo 解析失败的问题

变更

  • Docker 构建与 make build-frontend 的 NODE_OPTIONS --max-old-space-size 由 4096 调低为 2048,降低构建内存占用
  • 新增 docker-publish.yml 工作流,构建并推送镜像到 Docker Hub
  • 移除 release.yml 中多余的 id-token: write 权限
  • 删除已与现行 Docker Hub 发版流程脱节的离线部署脚本 docker_deploy.sh,并清理 docker/README.md、README_CN.md 中的相关章节
  • 修正 docker/README.md 标题笔误(ODocker → Octop)

[0.9.7] - 2026-07-14

新增

  • 新增多款连接器网关适配器:百度地图、携程问道、飞猪、美团旅游助手、QQ 音乐、元典 (#14)
  • 重构连接器网关目录与注册机制,支持更灵活的连接器安装 (#14)

修复

  • 修复 Linux 远程桌面安装脚本在 EL7(TigerVNC 1.8)下的兼容性,避免 xfdesktop 阻塞安装

[0.9.6] - 2026-07-13

新增

  • 新增远程桌面(Remote Desktop)功能,支持跨 Linux、Windows、macOS 的桌面串流 (#7)

修复

  • 从 .dockerignore 中移除 uv.lock,修正 Docker 构建无法 COPY 锁文件的问题 (#9)
  • 修复远程桌面、浏览器、终端及安装向导的本地化(i18n)问题 (#11)

[0.9.5] - 2026-07-12

新增

  • 新增 Linux、Windows、macOS 三端的远程桌面串流能力
  • 完善远程桌面的安装/卸载交互,并打包 Linux 端安装脚本

修复

  • 修复 Windows 与 Linux CI 下桌面配置/捕获/输入相关单测与 mypy 报错
  • 修复 Mac 端远程桌面安装时误导性的提示文案
  • 加固桌面安装 SSE 流式推送并清理 dashboard 端 lint 问题

[0.9.4] - 2026-07-11

新增

  • 新增 agent backend 的主机 root_dir 浏览器与权限探测能力
  • 改进聊天流式滚动行为与思考计时器

修复

  • 修复 Windows 下 sqlite 路径测试、媒体路径与 POSIX 专属测试导致的 CI 失败
  • 修复 Windows 测试收集问题(惰性导入 pwd 模块)
  • 修复 harness-memory Bridge 导入路径
  • 修复 CI 流水线并让测试套件通过,项目重命名为 Octop

变更

  • Windows 兼容:默认 agent backend 限定到 workspace,并集中 POSIX 专属 stdlib 调用以适配 Windows mypy CI

[0.9.1] - 2026-07-08

新增

  • 远程浏览器控制页面与浏览器 AI 面板,支持远程浏览器自动化操作
  • 附件下载的 Content-Disposition 头(RFC 5987,兼容非 ASCII 文件名)
  • 前端 UI 语言偏好持久化(自动检测浏览器语言并记忆)
  • 专家目录欢迎语(默认欢迎内容 / 工作区清单读取 / 专家目录播种)
  • 附件相关国际化域(i18n/domains/attachment.py)
  • 聊天欢迎语支持

变更

  • 重构聊天附件与上传处理链路,精简接口与实现
  • 重构网关媒体层:附件提示、入站存储、工具媒体展示重写
  • 重构 harness 请求构造与消息处理器
  • 调整上下文拆分、专家目录、provider 存储与 agent 管理器
  • 重构前端聊天界面:输入框、消息气泡、工具媒体条、上下文窗口环等组件大量更新
  • 更新登录、初始化向导、终端 AI 面板等前端页面

修复

  • 修复附件路径解析与内容分发相关问题

移除

  • 移除模型配置提示弹窗、旧聊天流模块、slash 上下文与附件签名测试

Octop Banner

A smarter, self-hosted AI assistant — multi-user, multi-agent.

TencentCloud/Octop | Trendshift

Python 3.12+ License: MIT Version PyPI Code Style: Ruff GitHub stars GitHub forks Discord

Highlights · Overview · Core Technology · Features · Roadmap · Quick Start · Contents

English · 中文


Octop is an open-source, self-hosted AI assistant. It's not just a tool — it's a digital life form that can operate in parallel. Through its multi-agent architecture, it builds an intelligent environment that is both independent and collaborative for teams, families, and individuals. Best of all, it runs entirely on your machine — the fully self-hosted design means privacy is never a compromise, while single-process startup makes the powerful web console, CLI, and IM integrations readily accessible.

Chat through the Web Dashboard, Feishu, DingTalk, QQ, WeChat, Telegram, Discord, WeCom, or programmatic HTTP/SSE/WebSocket. Extend capabilities with the expert library, Connectors (OAuth + MCP), and ACP integration for IDE workflows.

✨ Highlights

Feature Description
👥 Multi-user expert team One admin, shared household; built-in expert library and expert market — switch specialists per scenario
🤝 Cloud collaboration Link this Octop to another instance to browse peer experts and chat across instances; history stays on the expert's side
🎭 MBTI personas 16 personality templates plus an interactive quiz — give each agent a distinct character
🎯 AgentTeams (Beta) A coordinator schedules multiple experts on multi-step work; details
🔒 Security built-in JWT multi-user isolation, tool approval, shell command guardrails, and PII redaction — data stays local
🔌 Connector ecosystem Tencent suite (Docs, Meeting, News, …); OAuth and MCP gateway extend resource boundaries — supported connectors
💾 Pluggable workspace backends Local disk, Docker sandbox, PostgreSQL, or COS/S3 for agent files — separate from the control-plane DB
🧠 Portable memory Powered by Octop Memory; memory migrates with the workspace
📚 Knowledge base RAG over your documents; share corpora within a deployment and ground answers in your private data
🧩 Plugins Extend Octop with third-party plugins; bundled plugins are seeded and toggled on demand
↔️ ACP bidirectional octop acp for IDE/terminal AI; delegate to OpenCode / Claude Code with permission gates
💻 Terminal AI+ Interactive shell in the browser — AI-assisted command execution and troubleshooting
🌐 Browser AI+ Headless Chromium sessions for web automation, screenshots, and remote browsing
🖥️ Remote desktop Live screen and input from the dashboard on Linux, Windows, and macOS — remote office work and GUI apps; one-click isolated desktop on headless Linux
🪟 Desktop client Native Windows / macOS / Linux apps (and FnOS packages) alongside the web dashboard
🏠 Self-hosted Dashboard, CLI, IM channels, and cron in one octop run — all data under ~/.octop/

📌 Overview

Octop is a self-hosted AI assistant platform for households and small teams. It runs a single process that serves a web dashboard, a CLI, IM channels (Feishu, DingTalk, QQ, WeChat, Telegram, Discord, WeCom, and more), and cron automation — all sharing one control-plane database under ~/.octop/ (SQLite by default; PostgreSQL optional).

Octop's design goal: keep every conversation, workspace, and credential on your own machine, while giving each user a personal team of specialized agents they can switch between per task.

🐾 What can you do with Octop
  • Personal assistant — let a dedicated agent write weekly reports, organize notes, and manage your schedule; memory persists with the workspace.
  • Family sharing — one admin account, the whole household; assign different agents and experts per member; share experts and knowledge bases when useful.
  • Team helper — AgentTeams or parallel agents, bridging Feishu / DingTalk / WeCom / WeChat to route tasks into group chats.
  • Developer boost — delegate coding tasks to OpenCode / Claude Code via ACP, or troubleshoot from the terminal with AI assistance.
  • Web automation — use Browser AI+ and remote desktop for forms, screenshots, and GUI apps.
  • Scheduled tasks — configure cron in natural language so the agent pushes or runs jobs on time every day.

🧠 Core Technology

Layer Technology
Language Python 3.12+
Web framework FastAPI + uvicorn
Agent runtime Octop Harness
Gateway Octop Gateway
Control plane DB SQLite (WAL, default) or PostgreSQL (optional)
Frontend React 18 + TypeScript + Vite + Ant Design
Scheduling APScheduler
ACP agent-client-protocol
Build / quality hatchling · ruff · mypy · pytest

Octop is built on the Octop Harness stack — a set of focused runtimes that Octop composes into one process:

  • Octop Harness — Agent runtime: model routing, tools, skills, and conversation checkpointing.
  • Octop Gateway — multi-platform IM channel bridge that normalizes incoming messages into a single processing pipeline.
  • Octop Memory — hierarchical recall with full-text search, so an agent's memory travels with its workspace.
  • Octop Browser — CDP-based browser automation with persistent profiles for web tasks.

Instead of an external queue or message broker, Octop routes every surface — Web UI, IM, and cron — through one in-process HarnessProcessor. The result is a single, restart-safe process whose entire state is rebuilt from the control-plane database on boot (local SQLite by default; PostgreSQL optional).

🤔 Features

Server & auth

  • Multi-user JWT authentication with admin role
  • First-run setup wizard (octop init)
  • Interactive API docs at /api/docs (off by default — set "enable_api_docs": true in config.json to enable)

Experts

  • Multiple experts per user; each has its own workspace, providers, channels, and cron
  • 16 MBTI persona templates + custom system prompt
  • Expert library scanned at boot (infra/agents/experts/library/); expert market and in-deployment expert sharing
  • AgentTeams (Beta) — coordinator + member experts for multi-step tasks (docs/expert-teams.md)
  • Workspace backends (expert files): local disk, Docker sandbox, PostgreSQL, COS/S3, and other remote stores — distinct from the control-plane database

Channels & automation

  • IM channels: Feishu, DingTalk, QQ, WeChat, Telegram, Discord, WeCom, and more
  • Proactive cron jobs with natural-language and slash-command triggers
  • Unified message processing across Web UI, IM, and cron surfaces

Surfaces

  • Web dashboard — chat, experts / teams, connectors, channels, cron, knowledge, plugins, settings
  • Desktop client — native apps for Windows / macOS / Linux; FnOS packages for NAS
  • CLI — octop run, octop chats, octop acp, admin commands
  • HTTP/SSE/WebSocket API — full programmatic access
  • Remote desktop — dashboard control of the host desktop session

Knowledge & plugins

  • Knowledge base — RAG over your documents; optional sharing within the same deployment
  • Plugins — install and manage third-party plugins (octop plugin); bundled plugins are seeded and toggled on demand from the dashboard

ACP (Agent Client Protocol)

Octop supports ACP in two directions:

  1. Inbound — external tools use your Octop agent

    octop acp --agent main   # stdio ACP server for Zed, OpenCode, …
    
  2. Outbound — Octop delegates to external coding agents

    • Dashboard → ACP (/acp): configure runners (global per user)
    • Enable acp_runner per agent, then delegate in chat

Built-in outbound runners include OpenCode, CodeBuddy, Claude Code, and Codex.

Full setup: docs/acp.md.

🧭 Roadmap

Here are our mid-to-long term plans:

Shipped

  • Shared resource pool — a central pool of skills and sub-agents that any user can drop into a new expert without rebuilding from scratch.
  • Expert sharing — publish your experts to other users in the same deployment, so good configurations are reused instead of recreated.
  • PC client — native desktop apps for Windows / macOS / Linux alongside the web dashboard and IM channels.

In progress

  • AgentTeams (Beta) — let one coordinator autonomously schedule and orchestrate multiple experts to tackle multi-step tasks.
  • Mobile client (closed beta) — native mobile apps currently in internal testing.

Planned

  • Browser & terminal polishing — browser skill recording (capture a workflow and replay it as a skill) and a more capable terminal AI assistant.
  • Self-evolution — automatically distill everyday conversations into reusable skills, so the assistant grows with you.
  • Managed Agents — platform-hosted agent lifecycle (provision, scale, and operate agents without managing the full self-hosted stack yourself).
  • Project — project-scoped workspaces that group agents, files, and conversations around a shared goal.
  • Cloud–edge continuum — run Octop locally while offloading selected tasks to the cloud, so light work stays on-device and heavier jobs use remote capacity when you need it.
  • Plugin marketplace — a curated market to discover, install, and update third-party plugins without leaving Octop.
  • Conversational control plane — deepen Octop’s own skills so chat can cover the full dashboard surface: create experts, wire channels, manage knowledge bases, and scaffold plugins end-to-end.

This roadmap may shift as the community grows; treat it as indicative only.

🚀 Quick Start

Prerequisites

  • macOS / Linux / Windows
  • No pre-installed Python required — the installer uses uv to provision Python 3.12 in an isolated venv under ~/.octop/
  • A modern multi-core CPU with a few GB of RAM for the process plus model/embedding caches; enough disk for the database, agent workspaces, and document corpora

1. Install

macOS / Linux — one-line installer (recommended):

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash

Windows (PowerShell):

irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex

Windows (cmd) — download and run, or from a cloned repo:

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.bat -o install.bat
install.bat

After installation, open a new terminal or reload your shell:

source ~/.zshrc   # Zsh
# or
source ~/.bashrc  # Bash

The installer places octop on your PATH via ~/.octop/bin. Optional extras:

# Download Playwright Chromium for browser automation (skipped if a system Chrome/Chromium is already present)
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash -s -- --extras browser

See scripts/README.md for all install options (--version, --from-source, --mirror, Windows flags).

Desktop app (GUI, no terminal) — grab the artifact for your platform from GitHub Releases:

Platform Artifact
Windows Octop-desktop-windows-amd64-<version>.exe (64-bit) / Octop-desktop-windows-arm64-<version>.exe (ARM64) — NSIS installer
macOS Octop-desktop-darwin-arm64-<version>.dmg (Apple Silicon) / Octop-desktop-darwin-amd64-<version>.dmg (Intel)
Linux Octop-desktop-linux-amd64-<version>.tar.gz / Octop-desktop-linux-arm64-<version>.tar.gz
FnOS NAS Octop-fnos-docker-<version>.fpk (recommended on ARM; amd64/arm64 image) / Octop-fnos-native-<version>.fpk (x86_64, no Docker) / Octop-fnos-native-arm64-<version>.fpk (ARM64 fallback if no Docker) — install via App Center

See desktop/README.md for the desktop shell and fnos/README.md for the FnOS packaging guide.

Alternative — PyPI (if you already manage Python yourself):

pip install octop
# optional local ONNX embedding model cache (Models → Local): pip install "octop[local-embedding]"
# Downloads catalog weights under ~/.octop/embedding_models; not chat, not Memory.
# Browser automation uses the bundled Playwright package; install Chromium via the installer --extras browser,
# the dashboard, or: python -m playwright install chromium

From a source checkout with uv:

uv sync --extra local-embedding

2. Initialize

octop init

The interactive wizard creates the SQLite database, JWT secret, and first admin account under ~/.octop/.

3. Run

# Foreground (API + Web dashboard)
octop run

# Custom host / port
octop run --host 0.0.0.0 --port 8088

# Register as a system service (systemd / launchd / Windows service)
octop service start

Open http://127.0.0.1:8088. With Docker, a valid OCTOP_DEFAULT_PASSWORD creates the admin on first boot (credentials in /data/.octop/credential.txt); if it is unset or rejected, open the setup wizard (unlock password in /data/.octop/octop-login.txt). Interactive octop init / the setup wizard asks you to choose a password (≥8 characters, letters and digits).

# Build and start
docker compose -f docker/docker-compose.yml up -d

# China mirror when ghcr.io is unreachable (no local build)
docker compose -f docker/docker-compose.cn.yml up -d

# Or build manually
bash docker/docker_build.sh
docker run -d \
  -p 8088:8088 \
  -v octop-data:/data/.octop \
  -e HOME=/data \
  -e OCTOP_DEFAULT_PASSWORD="<strong-password-or-omit-for-setup-wizard>" \
  octop:latest

Open http://localhost:8088. A valid OCTOP_DEFAULT_PASSWORD creates the admin on first boot and writes credentials to /data/.octop/credential.txt. If it is unset or rejected by the password policy, no admin is created — complete the setup wizard (unlock password in /data/.octop/octop-login.txt). Override the username via OCTOP_ADMIN_USERNAME.

Password policy: at least 8 characters with letters and digits.

Variable Default Description
OCTOP_PORT 8088 HTTP listen port
OCTOP_DEFAULT_PASSWORD (unset) First-run admin password (Docker bootstrap). Valid → create admin; unset or rejected → setup wizard
OCTOP_ADMIN_USERNAME admin First-run admin username
OCTOP_DATA ~/.octop Host data directory (compose bind mount)

See .env.example for the full list.

To serve the dashboard under a reverse-proxy subpath (for example https://example.com/octop/), rebuild the frontend with VITE_BASE_PATH=/octop/ and strip that prefix in the proxy (nginx proxy_pass …/;). The default build assumes the domain root.

Deploy with Cloud

Deploy on Lighthouse
Deploy on CVM
Deploy with Zenith

📑 Contents

📦 Install options

Method Platform Description
Remote one-liner macOS / Linux curl …/octop/install.sh | bash
Remote one-liner Windows irm …/octop/install.ps1 | iex or install.bat
Local script macOS / Linux bash scripts/install.sh
Local script Windows scripts\install.bat or install.ps1
PyPI Any pip install octop (optional extras such as local-embedding)
Docker Any docker/docker-compose.yml; China mirror: docker/docker-compose.cn.yml

All install scripts provision an isolated environment at ~/.octop/venv and a ~/.octop/bin/octop wrapper — they do not touch system Python.

Upgrade

octop update replaces only the wheel/binary — your ~/.octop/ database, workspaces, secrets, and config.json are preserved:

octop update          # fetch and install the latest octop, then restart the service if one is registered

The schema migrates automatically on next boot; run octop init only if the setup wizard prompts for a migration. Always back up first (octop backup) before a cross-version upgrade.

⚙️ Configuration

All runtime state lives in ~/.octop/. Manage it via CLI or edit files directly.

# LLM providers and models
octop models
octop provider list

# IM channels
octop channel list
octop channel install

# Skills (per agent)
octop skills list --agent main

# Cron jobs
octop cron list
octop cron create --help

# Users (admin)
octop user list

Supported LLM providers

OpenAI-compatible APIs, DashScope (Qwen), Ollama, and other presets — configure per agent in the dashboard or via octop provider.

Supported channels

Channel Credentials
Feishu App ID, App Secret
DingTalk App Key, App Secret
QQ Bot AppID, Token
WeChat QR bind / account credentials; CLI
Telegram Bot Token
Discord Bot Token; all accessible channels allowed by default, optional channel/DM allowlists; setup and testing
WeCom Corp ID, Agent Secret
Web Dashboard Enabled by default

Other kinds (e.g. Yuanbao, Xiaoyi, MQTT) are available via the gateway — see channel setup in the dashboard or CLI.

Supported connectors

Built-in OAuth / MCP connectors include Tencent Docs, Tencent Meeting, Notion, TickTick, OpenAlex, Feishu CLI, WeCom CLI, Agent Mail, Obsidian, WeKnora, Dify, and more. Names and descriptions are localized (en / zh).

Full catalog, auth kinds, and MCP modes: docs/connectors.md. Custom MCP servers can be added in the dashboard.

📖 CLI reference

Command Description
octop init Bootstrap ~/.octop/ (DB, admin, JWT secret)
octop run Start Octop in the foreground
octop service start Install and start as a system service
octop service stop Stop the system service
octop agent Create, list, start/stop agents
octop channel Install and manage IM channels
octop chats REPL and session management
octop acp Stdio ACP server for IDE integration
octop cron Manage scheduled tasks
octop models Provider presets and model resolution
octop skills Enable/disable per-agent skills
octop plugin Install and manage third-party plugins
octop backup Export / restore backups
octop clean Remove CLI state or wipe ~/.octop/
octop memory list List running agents eligible for memory maintenance; no database changes.
octop memory slim [--agent ID] Back up and slim SQLite memory through the running host; uses the selected agent or prompts by number. Shows terminal and dashboard progress. Details
octop memory slim --all Sequentially maintain all eligible running agents, with per-agent progress; stops on the first failure.
octop update Check for and install updates

In signed-in dashboard or local CLI chat, /memory slim explains maintenance for the current agent; /memory slim --all lists your eligible agents. Add --confirm to start after reviewing the impact. Use /memory status for progress/results. Chat stays available until maintenance is confirmed and begins. External IM maintenance requires verified sender permissions and is not enabled yet.

Full reference: docs/cli.md.

🖥️ Web dashboard

After octop run, open http://127.0.0.1:8088.

Octop Web Dashboard

  • Chat — real-time conversation with experts and teams
  • Experts — create experts, pick templates / MBTI personas, share or publish experts, configure providers
  • AgentTeams (Beta) — coordinator + member experts for multi-step work
  • Connectors — OAuth apps and MCP gateways
  • Channels — IM platform setup
  • Cron — visual cron job management
  • Knowledge base — manage document corpora, semantic retrieval, and in-deployment sharing
  • Plugins — install, enable, and configure plugins
  • Remote desktop — live screen and input from the dashboard
  • ACP — configure outbound coding-agent runners
  • Settings — users, security, TLS, system

Interactive API docs: http://127.0.0.1:8088/api/docs (disabled by default — enable by setting "enable_api_docs": true in config.json)

📁 Data directory

~/.octop/                          ← install & data root
├── config.json                    # process config (optional database section)
├── octop.db                       # SQLite — users, agents, channels, cron, …
├── secrets/                       # JWT secret, channel tokens
├── agents/<agent_id>/             # per-agent workspace (SOUL.md, skills, …)
├── security/tool_guard/           # shell command allow/deny rules
├── logs/                          # runtime logs
├── venv/                          # uv-managed Python (installer layout)
└── bin/octop                      # PATH wrapper → venv/bin/octop

The control plane can also use PostgreSQL — set database in config.json, or OCTOP_DATABASE_* / the first-run wizard. With PostgreSQL, agent memory reuses the same DSN by default (per-agent schema); to keep file-based memory, set "memory": { "backend": { "type": "sqlite" } } in the agent config. See docs/configuration.md and docs/adr/002-database-backends.md.

See docs/configuration.md for env vars and config.json.

🏗️ Architecture

OctopServer
 ├─ DatabasePool            SQLite (WAL) or PostgreSQL
 ├─ SharedServices       DI root — every repo + config
 ├─ ExpertCatalog        scans agents/experts/library/ at boot
 ├─ UserManager
 │   └─ HarnessAgentManager (per user)
 │       └─ AgentRuntime (per agent)
 │           ├─ HarnessAgent      Agent runtime (octop-harness)
 │           ├─ HarnessProcessor  IM / UI / cron entry point
 │           ├─ ChannelManager    IM connections (octop-gateway)
 │           └─ CronManager       APScheduler
 └─ FastAPI app (uvicorn)

Single process. Restart rebuilds state from the control-plane database (local SQLite by default; PostgreSQL optional).

See docs/architecture.md, docs/adr/001-single-process-model.md, and docs/adr/002-database-backends.md.

📁 Project layout

src/octop/
  config.py    env-var config
  launch.py    OctopServer boot + uvicorn
  infra/       business core (agents, gateway, cron, db, users, …)
  api/         HTTP layer — FastAPI app, routers, JWT, SSE
  cli/         CLI layer — Click commands
  dashboard/   built React SPA (wheel artifact)

dashboard/     frontend source (Vite) — edit here, run make build-frontend

docker/        Docker Compose, entrypoint, build & deploy scripts
tests/         unit/ + integration/

🛠️ Development

Prerequisites: Python 3.12+, Node 18+, uv

# Backend
make install          # pip install -e ".[dev]"
make all              # format-all + lint + typecheck + test (ship bar)

# Frontend (separate terminal)
make dev-frontend     # Vite dev server on :5173 (override with VITE_DEV_PORT)
make build-frontend   # production build → src/octop/dashboard/
cd dashboard && npx tsc -b

Individual targets: make test, make lint, make typecheck, make format.

🔒 Security & privacy

  • Local-first: Config, chats, workspaces, and credentials live under ~/.octop/ on your machine.
  • Multi-user isolation: JWT auth with per-user agents and workspaces.
  • PII redaction & tool approval: sensitive data is redacted before it leaves the workspace, and risky tools or shell commands require explicit approval under the guardrail rules.
  • Tool guardrails: User-editable shell command rules under ~/.octop/security/tool_guard/.
  • No vendor lock-in: Swap LLM providers, storage backends, and channels without rewriting agents.

🤝 Contributing

Contributions are welcome:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Run make all (backend) or make check-all (full stack) before submitting
  4. Open a Pull Request

See CONTRIBUTING.md for the full guide. Security issues: SECURITY.md.

Module boundaries and coding conventions: AGENTS.md.

📋 Changelog

See CHANGELOG.md for release history.

Project Description
Octop Harness Agent runtime — model routing, tools, skills, checkpointing
Octop Gateway Multi-platform IM channel bridge
Octop Memory Hierarchical recall and FTS search
Octop Browser CDP browser automation with persistent profiles
Octop Pet A desktop pet for Octop

💬 Community

WeCom Customer Group (CN)

For the customer WeCom support group, scan:

WeCom customer group QR code

Please scan the QR code to join the group. For any questions or assistance, please contact the group admin directly.

📄 License

This project is licensed under the MIT License.

✨ Contributors

Thanks to all contributors:

Metadata

Release files for octop 1.0.3b1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for octop 1.0.3b1
File Size Uploaded Provenance Actions
octop-1.0.3b1.tar.gz 17.7 MB Without provenance Details for octop-1.0.3b1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for octop 1.0.3b1
File Interpreter ABI Platform Actions
octop-1.0.3b1-py3-none-any.whl Python 3 none any Details for octop-1.0.3b1-py3-none-any.whl

Total release size: 36.7 MB

Release files / octop-1.0.3b1.tar.gz

Download URL octop-1.0.3b1.tar.gz
Size 17.7 MB
Tags Source
SHA-256 checksum
How to use checksums
e13b8ad311c2d1db2db74112387cb8cfc62da60abd91a4fc629db57f6790e2b2
BLAKE2b-256 checksum
How to use checksums
825fb0fe4b98c81e4a75d091ec30ea25e59fb6777bbe156d4d918bd98987e4fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / octop-1.0.3b1-py3-none-any.whl

Download URL octop-1.0.3b1-py3-none-any.whl
Size 19.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
3801d38b586ff6e3c9aae48f95d3adf8042c8df9d514b3caa7005366aff2f454
BLAKE2b-256 checksum
How to use checksums
998b9281426b2e3d88c14f096ce5daaba764aced99b77e67f888710da94c3bd3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for octop 1.0.3b1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page