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

Rvelamen

629人浏览 · 2026-03-19 23:51:03

Rvelamen · 2026-03-19 23:51:03 发布

Octopus

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

传送门-GITHUB

章鱼哥智能助手

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

✨ 核心特性

🚀 一键部署
无需服务器、无需 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_generate`	AI 图像处理
⏰ 定时	`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 会同时启动：

前端开发服务器 (http://localhost:3000)

Electron 桌面应用窗口

📦 构建发布

开发命令

命令	说明
`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:mac`	macOS 打包	DMG + ZIP (x64/arm64)
`npm run dist:win`	Windows 打包	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 密钥即可使用：

支持的提供商

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

配置步骤

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

🔌 MCP 协议

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

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

支持的传输协议

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

🤖 Agent 工作区

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

配置文件

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