3.5.0 版本更新

一、技能系统重构：来源分层与调用优先级

1.1 技能来源三分类

1.2 技能调用优先级

1.3 技能兼容性增强

• 技能格式兼容 NousResearch/hermes-agent 项目的设计思路

• 同时兼容 openclaw 的 skill 结构，方便后续扩展和迁移

1.4 技能页面新增功能

• "安装技能"右侧新增 "程序小店" 按钮，打开 https://shop.sanrenjz.com/codebot

• "批量处理"右侧新增 "skill 文件" 按钮，点击后直接打开 自动生成 skill 的存放目录

二、记忆、技能与定时任务沉淀优化

• 记忆、技能、定时任务不再依赖单一触发词，而是从聊天结果、重复任务、稳定行为中持续提炼

• 自动整理时会额外扫描新增聊天记录，联动补充记忆、定时任务与可复用技能沉淀

• "记忆 → 配置 → 自动整理"在设定时间会真正触发整理并补漏，而不只是设置项

• 目标是让系统"越用越懂你"，降低用户手动操作门槛

三、自动升级与 GitHub CI/CD 发布流水线

3.1 GitHub Actions 自动打包

• 参考 sanrenjz-tools 项目，配置了 .github/workflows/release.yml

• 推送 main 分支后自动触发三平台（Windows / macOS / Linux）构建

• 版本号自动按 minor 规则递增：1.1.0 → 1.2.0，1.9.0 → 2.0.0

• 构建产物自动发布到 GitHub Releases

3.2 更新下载修复

• 修复非会员或未登录用户从 GitHub Releases 下载时因资产命名不一致导致的 404 错误

• 统一 Windows 安装包命名规则，确保自动更新链路可靠

• 非会员或未登录用户默认从 GitHub 拉取更新

3.3 对象存储更新（会员专属）

1. 客户端读取 latest.json 获取最新版本号

2. 对比本地版本，若有新版本则提示用户下载

3. 客户端从对应版本目录下载安装包并执行安装

四、会员登录与程序小店联动

4.1 右上角头像登录

• 增加登录功能，站点为 https://shop.sanrenjz.com/

• 应用内登录状态与程序小店会员状态保持联动：在应用内登录 = 在程序小店登录，反之亦然

• 修复登录时出现"An object could not be cloned."的错误

4.2 程序小店内置浏览器

• 在技能页"安装技能"右侧新增入口，打开 https://shop.sanrenjz.com/codebot

• 程序小店在内置浏览器中打开，支持刷新按钮重新加载页面

• 修复用户登录后打开程序小店导致远端站点崩溃的 bug（权限范围已收缩至会员权限）

4.3 会员技能下载

• 会员选择产品后可直接下载，不再弹出保存路径对话框

• 下载的 ZIP 文件自动解压到 自动生成 skill 存放位置

• 下载的技能作为 自动生成 来源被 Codebot 调用

五、UI 与体验优化

5.1 菜单栏精简

• 将"文档"从菜单栏移至"设置"页面的"沙箱配置"右侧，释放菜单空间

5.2 聊天输入框增强

• 支持粘贴截图：用户截图后可直接 Ctrl+V 粘贴图片到对话框

5.3 对话分享修复

• 修复分享链接在浏览器中无法打开对话内容的问题

• 分享链接改为基于局域网 IP，而非 localhost，便于分享给他人访问

5.4 归档对话查看

• 归档的对话统一存放至"日志"页，用户可在日志页查看和恢复归档内容

六、多 Agent 群聊功能

6.1 功能定位

• "多 Agent 群聊"置顶于对话列表，与普通对话区分

• 普通对话有"删除"；群聊对话替换为"清空"，仅清空内容，不删除会话

• "开始群聊"点击后变为"取消群聊"，支持用户随时取消

6.2 多 Agent 协作机制

• 支持串行执行：上一个 Agent 完成后，将结果转交给下一个 Agent

• 支持并行执行：多个 Agent 同时处理各自任务

• 支持终止：用户点击"终止"后，所有参与群聊的对话均停止

6.3 任务过程可见

• 用户发送任务后，"多 Agent 群聊"对话实时回显任务分配流程和各 Agent 的执行状态

• 用户可以清楚看到任务如何被分配、每个 Agent 的处理结果，不再是黑盒

• 内置多 Agent 协作调度技能（skills/multi-agent-collaboration/SKILL.md）

2.8.0 版本更新

一、代码修改与功能新增

1. 对话命名优化
• 修改对话命名规则，使用 AI 总结对话内容进行命名（20 字以内）。
• 优化生成时间：AI 回复后立即生成对话名称，仅截取回复内容的前 300-500 字以减少 Token 消耗。
• 修复显示刷新延迟：对话名称生成后即时刷新显示，无需切换界面才可见。

2. 本地模型网关/代理层调整
• 测试“本地模型网关/代理层”架构，成功后提供 Python 调用教程（中文版）。
• 增强模型调用逻辑：
• 默认情况下，若用户未指定模型，自动调用当前 CodeBot 聊天默认模型。
• 若模型参数为空值时，使用“记忆->自动整理->整理使用模型”作为模型来源。
• 修复接口调用问题：解决示例代码中模型为空时不调用默认模型的 Bug。

3. 文档功能完善
• 在菜单栏“设置”右侧新增“文档”入口。
• 文档内容加载：解决“文档没有内容，加载失败（HTTP 404）”问题，确保文档路径正确。
• 优化 Markdown 渲染：修复文档中网络图片无法显示、代码块渲染不良等相关问题。

4. 技能沉淀与沙箱检查
• 技能沉淀功能：检查技能沉淀逻辑是否正常，确保当日聊天内容可以被记忆、定时任务处理和复杂重复性内容可自动生成技能。
• 沙箱与性能检查：检查沙箱功能是否存在问题，分析高 CPU/内存占用是否由异常进程或重复运行的程序引起，修复潜在卡顿问题。

二、Bug 修复与优化

1. 修复 CodeBot 启动冲突：解决 Opencode 桌面端无法打开 CodeBot 并报错“Network service crashed”的问题。

2. 提升 CodeBot 启动速度：检查 npm start 启动缓慢问题，优化界面加载顺序，优先显示界面以增强用户体验。

3. 优化文档与对话展示：修复对话名称延迟刷新及文档渲染错误，提升系统响应速度与稳定性。

项目

一、项目概述

• 与 OpenCode 服务无缝集成，支持多模型切换与自主决策

• 实现对用户信息、习惯、偏好的自动提取与记忆提示

• 完备的定时任务、通知、日志、技能、MCP 集成与管理

• 安全隔离的沙箱执行环境，大幅提升代码生成和运行的灵活性与安全性

• 跨平台兼容（支持 Windows、Linux、macOS，及 Electron 桌面端）

二、功能结构与主流程

2.1 主模块启动流程

• 应用初始化 → 数据/技能/日志/备份目录校验与创建 → 内置技能复制

• 依赖检查与自动安装（OpenCode）

• 连接数据库并初始化表结构

• 各全局核心组件实例化（内存管理、通知、WS 机器人、沙箱等）

• API 路由加载（chat/memory/scheduler/skills/config/mcp/etc.）

• 沙箱环境启动与端口自适应检测

• 异步启动 OpenCode Server 并接管后端与技能调度

• 前端静态资源挂载、SPA 路由回退

• 应用关闭时 graceful shutdown，停止后台任务、断开连接

2.2 Codebot 作为第三方的工作方式

三、核心功能详解

3.1 OpenCode 会话系统

• 对话管理: 创建和管理多个对话，支持重命名、置顶、归档、删除

• OpenCode 主控: 所有消息统一交给 OpenCode 处理，Codebot 只负责提供第三方能力和结果展示

• 历史查看: 进入"聊天"自动打开最近对话，支持多对话并行处理

• 分组聊天: 支持将多个对话合并为群组模式

• 对话分享: 生成分享链接（share_id），可供他人只读查看

• 意图分类: 消息自动分类为"定时任务/保存记忆/普通对话"，避免误判

• Agent 模式: 支持 plan（结构化规划）和 build（直接执行）两种模式

• 文件附件: 支持文件附件上传；多模态模型支持图片分析

• 流式响应: 流式展示 OpenCode 步骤事件（如 step-start / step-finish）与回复增量

• 会话复用: 同一对话默认复用 OpenCode 会话，减少上下文丢失，提升连续追问一致性

• 后台执行: 切换到"技能/设置"等页面时，任务继续在后台执行，返回聊天页自动恢复状态并回放工具调用事件

3.2 记忆系统

• 上下文记忆: 自动保存对话历史

• 长期记忆: 保存用户习惯、偏好、事实信息（用于之后对话检索问答）

• 自动提取: 每次对话后，后台自动进行规则+AI双通道提取，识别重要信息并保存，无需依赖"记住"关键词

• 记忆类别: habit（习惯）、preference（偏好）、profile（个人信息）、note（笔记）、contact（联系人）、address（地址）

• 记忆提示: 聊天输入时自动检索相关记忆并在输入框上方显示提示气泡，AI 回复时也会注明"根据我的记忆"

• 记忆搜索: 语义搜索相关记忆

• 记忆归档: 自动或手动归档旧记忆，支持按类别过滤查看

• 备份恢复: 导出记忆为 ZIP 文件（保存至 data/backups/），或上传备份文件恢复

• 记忆整理: 每日在配置时间点（默认 03:00）自动用 AI 对活跃记忆进行优化（合并重复、补全描述、标准化格式、修正矛盾），也可手动触发

• 聊天整理联动: 自动整理时会扫描新增聊天记录，从聊天中补充记忆，并尝试沉淀相关定时任务与可复用技能

3.3 定时任务系统

• Cron 表达式: 完整的 Cron 语法支持

• 智能时间解析: 自动从用户消息中区分"时间部分"和"任务内容"。例如"5分钟后，写首春天的诗保存到D盘"会解析为：调度时间=5分钟后，任务=写首春天的诗保存到D盘

• 意图识别: 本地规则优先分流"定时任务/记忆/普通对话"，避免"保存到D盘"这类任务被误判为记忆

• 生日提醒特例: 对"记住我的生日，10月20日，我生日时提醒我"这类复合句，会同时保存生日记忆并创建每年生日提醒任务

• AI 辅助: 自然语言生成 Cron 表达式（OpenCode 不可用时降级为本地规则解析）

• 通知渠道: 飞书/邮箱/应用内通知

• 执行日志: 详细的任务执行记录

• 提醒任务: 带 __REMINDER__ 标志的纯提醒任务不依赖 OpenCode 也能按计划触发通知；AI 类任务（生成内容/写文件等）需要 OpenCode 在线执行

• 像聊天一样执行: 定时任务到达执行时间时，系统会像聊天一样通过 OpenCode CLI 处理任务内容，充分利用 AI 的代码生成与文件写入能力

• 一次性任务: 未强调重复性的任务（如"5分钟后"、"明天"）自动标记为一次性，执行完成后不再重复触发

3.4 技能系统

• 内置技能: web_search（网页搜索）、web_fetch（抓取网页）、news（新闻获取）、file_reader（文件读取）、pdf（PDF 处理）、docx（Word 文档）、pptx（PowerPoint）、xlsx（Excel）、ai-company（AI 专家团队决策）、expert-agents（14位专家人设）、code-review（代码审查）、writing-plans（写作计划）、subagent-driven-development（子代理驱动开发）、arxiv-research（论文研究）、blogwatcher（博客监控）、obsidian-notes（Obsidian 笔记）、self-improving（自我改进）、systematic-debugging（系统化调试）、test-driven-development（测试驱动开发）

• 技能定义: Markdown 文件（SKILL.md）带 YAML front-matter（name、description），自动匹配用户提示

• 自动调度: tool_dispatcher.py 通过关键词 + 语义匹配，将 SKILL.md 内容注入到对应请求的提示词中

• 低干扰注入: 仅在高相关度下启用技能上下文，降低无关技能误触发

• 自动沉淀技能: 对高复用的已完成任务，自动生成可复用技能元数据，便于后续任务快速命中

• OpenCode 本地技能: 自动读取 ~/.agents/skills，可在技能页卸载

• 自定义目录技能: 支持配置多个外部文件夹路径，自动扫描其中包含 SKILL.md 的子目录并加载为只读技能

3.5 MCP 服务器管理

• 支持 stdio 和 SSE 两种传输模式的 MCP 服务器配置

• SSE 模式的 MCP 工具由 tool_dispatcher.py 自动调用：当用户提示词匹配到工具描述时，后端自动发起工具调用并将结果注入上下文

• 完整 CRUD 管理界面（/mcp 页面）及 REST API（/api/mcp）

• 魔搭 ModelScope MCP 集成：Codebot 统一代理外部 MCP 服务器，OpenCode 只需要连接 codebot 这一个第三方 MCP

3.6 沙箱执行环境

• 工作目录隔离执行环境，AI 生成的代码在独立 data/sandbox_workspace/ 目录中运行

• 无需安装额外软件：移除 QEMU/Docker 依赖，开箱即用

• 基于 asyncio.create_subprocess_shell 执行命令，支持超时控制

• 完整输出捕获：stdout、stderr、exit_code

• 执行模式：local（工作目录隔离）

• 可配置执行超时（秒，默认 300）

3.7 通知系统

• 应用内通知: 默认启用，在右上角查看

• 系统桌面通知: 推送至操作系统通知中心（Windows/macOS/Linux）

• 飞书通知: 配置 Webhook URL，支持长连接订阅模式（无需公网 IP）

• 邮箱通知: 配置 SMTP 服务器，支持一键发送测试邮件验证配置

4.1 目录结构自动管理

4.2 沙箱隔离环境（sandbox_manager）

• 隔离执行：防止异常/恶意代码危害主系统

• 支持 stdout/stderr/exit_code 管理与实时反馈

4.3 Memory 及知识库管理

4.4 技能与 MCP 工具自动发现与调度

• ol生成技能沉淀

• 各技能支持内链调用

4.5 网络端口、多实例检测和优雅降级

五、核心代码流程图（Mermaid）

六、主要依赖与技术栈

• Python 3.11+，FastAPI，asyncio，SQLite，ChromaDB，loguru

• Electron, Node.js (前端打包/桌面)，Vue 3, Pinia

• 依赖自动检测（OpenCode CLI），跨平台兼容

七、局限与改进建议

局限：

• 依赖 Electron+Python 环境，首次安装环境配置复杂

• 需保证 OpenCode Server 正常运行方可使用绝大部分 AI 驱动功能

• 技能文件的自动沉淀仅依赖本地规则，用户自行管理自定义目录时须注意格式兼容

改进建议：

• 增强多模型 AI 后端兼容性（如深度集成 OpenAI API）

• 前端适配移动端用户体验进一步优化

• 技能市场与一键安装功能完善，降低维护门槛

• 增加云端备份及远程协作能力