章鱼哥AI助手：多触手高效协作

用户616340376023
32 阅读7分钟

​

8efe08fd7ec166aa7a865b2a4c9ed15e (1).png

Octopus

AI Agent 桌面框架 · 多触手高效协作

章鱼哥智能助手

传送门-GITHUB

b50bdb0f7d6b84c66c936679ddb6f50d.png    bb2f6b2ced37fcbddf73f8d090ae2d49.png

1f167dac44e8928d0c6737fccff5b50a.png

🌟 像章鱼一样，同时处理多件事 🌟

✨ 核心特性

🚀 一键部署 无需服务器、无需 YAML⚡ 双击安装运行 🐍 内置 Python 环境 💾 U 盘便携模式 🔒 数据本地保存💰 成本透明 每一分花费都心中有数📊 实时 Token 计数 📈 可视化费用图表 ⚠️ 超支自动预警 🔄 模型成本对比🧩 Markdown 扩展 不写代码也能扩展📝 写 SKILL.md 🔗 MCP 协议支持 📦 Git 直接安装 ♻️ 热更新支持
🤖 可视化 SubAgent 创建专属 AI 助手🎨 图形界面创建 📁 工作区隔离 🎯 自动任务分发 🧠 独立配置记忆⏰ 智能定时任务 任务真正被执行▶️ SubAgent 真干活 📅 多种调度方式 💪 重启任务不丢 💬 访问上下文🗂️ 项目隔离 每个项目独立空间⚙️ 独立配置记忆 🔄 一键切换项目 👥 导出团队共享 💬 历史永不丢失

🔌 扩展生态

技能扩展（Markdown 即可）

写一个 SKILL.md 就能让 AI 学会新能力：

---
name: "代码审查"
emoji: "🔍"
---

审查代码时检查：
1. 安全问题（SQL 注入、XSS）
2. 性能瓶颈
3. 命名规范

转存失败，建议直接上传图片文件

放入 workspace/extensions/my-skill/SKILL.md，重启即生效。

MCP 协议支持

  • 连接任意 MCP 服务器（stdio / WebSocket / SSE）
  • 自动发现工具，无需手动配置
  • 可视化权限管理

⚙️ 可视化配置

所有配置都有图形界面，不用写 YAML：

配置项说明
模型提供商添加 OpenAI/Anthropic/DeepSeek 等，支持多提供商切换
工具开关一键启用/禁用工具，设置超时时间
工作目录独立工作区，配置和记忆完全隔离
预算上限设置月度 Token 上限，超支提醒

💰 Token 消耗可视化

实时监控每一次对话的成本：

  • 📊 实时统计：输入/输出 Token、费用明细
  • 📈 历史趋势：按天/周/月查看消耗走势
  • ⚠️ 预算告警：设置上限，超支自动提醒
  • 🔄 模型对比：不同模型的成本效率一目了然

⏰ 智能定时任务

不只是定时发通知，而是真干活：

  • SubAgent 执行：任务在独立 Agent 中运行，真正执行操作
  • 灵活调度：支持 ISO 时间、间隔秒数、Cron 表达式
  • 上下文继承：任务可以访问创建时的会话记忆
  • 持久化存储：任务保存在 SQLite，重启不丢失

🗂️ 工作目录管理

每个项目一个工作区，互不干扰：

workspace/
├── project-a/          # 项目 A
│   ├── extensions/     # 专属扩展
│   ├── memory/         # 长期记忆
│   └── history/        # 聊天记录
├── project-b/          # 项目 B
│   └── ...

转存失败，建议直接上传图片文件

  • 切换工作区 = 切换完整的配置和记忆
  • 支持导出/导入工作区
  • 团队共享：导出工作区，同事导入即用

💬 聊天历史记录

  • 所有对话保存在本地 SQLite
  • 按会话组织，支持搜索
  • 可随时回到任意历史会话
  • 支持多会话并行

🤖 可视化 SubAgent

通过界面创建和管理专用 Agent：

  • 可视化编辑：修改 SOUL.md 配置角色、工具、模型
  • 一键创建：填写名称自动生成模板配置
  • 独立工作区：每个 SubAgent 有自己的配置和记忆
  • 主从调度：主 Agent 自动调用合适的 SubAgent 处理任务

🛠️ 内置工具

类别工具说明
📁 文件系统read, write, edit, list文件读写操作
🖥️ 系统shell, spawn命令行执行
🌐 网络web_fetch网页内容抓取
🖼️ 图像image_understand, image_generateAI 图像处理
⏰ 定时cron_add, cron_list, cron_remove定时任务管理
💬 消息send_message多通道消息发送
⚡ 动作action执行扩展动作

🚀 快速开始

环境要求

  • Node.js >= 18
  • Python >= 3.10

安装启动

# 1. 克隆项目
git clone <repository-url>
cd octopus

# 2. 安装依赖
npm install

# 3. 配置 Python 环境
python setup_portable_python.py

# 4. 启动开发模式
npm run dev

转存失败，建议直接上传图片文件

💡 npm run dev 会同时启动：

📦 构建发布

开发命令

命令说明
npm run dev开发模式（前端 + Electron）
npm run dev:frontend仅启动前端开发服务器
npm run dev:electron仅启动 Electron

构建命令

命令说明
npm run build:frontend构建 React 前端
npm run build:python打包 Python 后端
npm run build完整构建（前端 + Electron）

打包发布

命令说明输出格式
npm run dist当前平台打包根据平台自动选择
npm run dist:macmacOS 打包DMG + ZIP (x64/arm64)
npm run dist:winWindows 打包NSIS 安装包 + 便携版

📂 输出目录：dist-electron/
📖 详细构建指南：README_BUILD.md

🏗️ 项目架构

octopus/
├── agents/                 🧠 AI Agent 工作区
│   ├── code-reviewer/      代码审查 Agent
│   ├── common/             通用 Agent 模板
│   └── system/             系统 Agent 配置
│       └── avatars/        Agent 头像资源
├── backend/                ⚡ Python 后端
│   ├── agent/              Agent 核心逻辑
│   ├── api/                FastAPI 服务接口
│   ├── channels/           多通道支持（桌面/飞书）
│   ├── core/               核心模块（配置/事件/模型）
│   ├── data/               数据存储（SQLite）
│   ├── extensions/         插件系统
│   ├── mcp/                MCP 协议集成
│   ├── services/           服务层（定时任务/图像）
│   ├── tools/              内置工具集
│   │   ├── filesystem.py   文件系统工具
│   │   ├── shell.py        命令行工具
│   │   ├── web_fetch.py    网络抓取工具
│   │   ├── image.py        图像处理工具
│   │   ├── cron.py         定时任务工具
│   │   └── message.py      消息发送工具
│   └── utils/              工具函数
├── electron/               🖥️ Electron 主进程
│   ├── main.js             主进程入口
│   └── preload.js          预加载脚本
├── frontend/               🎨 React 前端
│   ├── src/
│   │   ├── components/     UI 组件
│   │   │   ├── config/     配置组件
│   │   │   ├── forms/      表单组件
│   │   │   ├── modals/     弹窗组件
│   │   │   └── panels/     功能面板
│   │   ├── utils/          工具函数
│   │   ├── App.jsx         应用入口
│   │   └── pixel-theme.css 像素主题样式
│   └── package.json
├── workspace/              📂 工作区数据
│   └── memory/             Agent 记忆存储
├── package.json            项目配置和脚本
├── setup_portable_python.py Python 环境配置脚本
└── README.md               项目说明

转存失败，建议直接上传图片文件

技术栈

层级技术说明
前端React 18 + Vite现代化 UI 框架
Ant Design组件库
Monaco Editor代码编辑器
ECharts数据可视化
后端Python 3.10+ + FastAPI高性能异步 Web 服务
SQLite本地轻量数据库
桌面Electron 28跨平台桌面应用框架
electron-builder应用打包工具

🔧 模型配置

在应用设置面板中添加 API 密钥即可使用：

支持的提供商

提供商代表模型
OpenAIGPT-4o, GPT-4 Turbo, GPT-3.5 Turbo
AnthropicClaude 3 Opus, Claude 3 Sonnet, Claude 3 Haiku
GoogleGemini Pro, Gemini Ultra
DeepSeekDeepSeek Chat, DeepSeek Coder
阿里云通义千问系列
百度文心一言系列

配置步骤

  1. 打开应用 → 设置 → 模型提供商
  2. 添加提供商（选择或自定义）
  3. 输入 API Key
  4. 选择要使用的模型
  5. 保存并开始使用

🔌 MCP 协议

Octopus 完整支持 Model Context Protocol (MCP) ：

  • 🔗 连接任意 MCP 服务器
  • 🛠️ 使用 MCP 提供的工具
  • 🔐 安全的权限管理
  • 🔄 实时连接状态监控

支持的传输协议

  • stdio：本地进程通信
  • WebSocket：远程实时连接
  • SSE：Server-Sent Events

🤖 Agent 工作区

Agent 系统支持持续记忆和个性化配置：

配置文件

文件用途
SOUL.mdAgent 灵魂 - 核心准则和性格定义
IDENTITY.mdAgent 身份 - 自我介绍
AGENTS.md工作区指南 - 使用说明
MEMORY.md长期记忆 - 重要信息持久化
memory/YYYY-MM-DD.md每日笔记 - 当天事件记录

创建自定义 Agent

在 agents/ 目录下创建新文件夹，添加配置文件即可创建专属 Agent。

📖 文档导航

🤝 参与贡献

欢迎提交 Issue 和 Pull Request：

  • 🐛 报告 Bug
  • ✨ 提交新功能
  • 📝 改进文档
  • 🎨 优化 UI/UX

🐙 章鱼哥，让你的工作更高效 🐙

Built with ❤️ and 🐙 tentacles

avatar
文章
阅读
粉丝