# Octopus
**Repository Path**: shifeipython/Octopus
## Basic Information
- **Project Name**: Octopus
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
https://github.com/user-attachments/assets/29a64b38-3f98-4cbc-99d4-662f55cbec74
### 文本转语音演示
https://github.com/user-attachments/assets/ef0af274-e988-436f-a7da-a007e1a814ee
### 微信通道演示
https://github.com/user-attachments/assets/1de4e3d3-3397-46f8-a6b5-8f9dfef2b580
***
## ✨ 核心特性
|
**🚀 一键部署**
*无需服务器、无需 YAML*
⚡ 双击安装运行
🐍 内置 Python 环境
💾 U 盘便携模式
🔒 数据本地保存
|
**💰 成本透明**
*每一分花费都心中有数*
📊 实时 Token 计数
📈 可视化费用图表
⚠️ 超支自动预警
🔄 模型成本对比
|
**🧩 Markdown 扩展**
*不写代码也能扩展*
📝 写 `SKILL.md`
🔗 MCP 协议支持
📦 Git 直接安装
♻️ 热更新支持
|
**🔄 可视化工作流**
*搭建 AI 流水线*
🎨 拖拽式编辑器
🧩 24 种节点类型
📋 版本管理
🔍 运行追踪调试
|
|
**🤖 可视化 SubAgent**
*创建专属 AI 助手*
🎨 图形界面创建
📁 工作区隔离
🎯 自动任务分发
🧠 独立配置记忆
|
**📚 知识库**
*你的第二大脑*
📄 多格式文档
📝 Markdown 笔记
💬 Notes Chat(限定范围 AI)
🧠 AI 智能蒸馏
|
**📡 多通道**
*随时随地聊天*
💬 桌面端 / 微信
🐦 Slack / Discord
✈️ Telegram / 钉钉
📧 邮件 / Webhook
|
**⏰ 智能定时任务**
*任务真正被执行*
▶️ SubAgent 真干活
📅 多种调度方式
💪 重启任务不丢
💬 访问上下文
|
|
**🗂️ 项目隔离**
*每个项目独立空间*
⚙️ 独立配置记忆
🔄 一键切换项目
👥 导出团队共享
💬 历史永不丢失
|
**🔊 文本转语音**
*让 AI 开口说话*
🗣️ 多种 TTS 引擎
🎵 自然语音输出
⚙️ 可自定义设置
📱 实时播放支持
|
**🧠 观察与记忆**
*从经验中学习*
🔍 9 种观察类型
📝 自动提取洞察
💾 提升为记忆
👤 用户画像追踪
|
**📄 多格式文件**
*读取任意文档*
📑 PDF / DOCX / XLSX
📊 PPTX 预览
🖼️ 图像理解
🧠 PDF 思维导图渲染
|
***
## 🔄 可视化工作流
基于 ReactFlow 的拖拽式编辑器,轻松构建复杂 AI 流水线:
### 节点类型(24 种)
| 分类 | 节点 |
| :------- | :----------------------------------------------------------- |
| **流程** | 工作流开始、回答节点、工作流结束 |
| **AI** | LLM、问题分类器、内容提取器 |
| **工具** | HTTP 请求、代码执行、读取文件、JSON 序列化/反序列化、文本编辑器 |
| **逻辑** | 条件分支、变量更新、循环、并行执行 |
| **交互** | 用户选择、表单输入、输入节点、插件输出 |
| **Agent** | Agent 节点、子工作流 |
### 核心能力
- **可视化编辑器**:拖拽画布,自动布局
- **节点测试**:独立测试单个节点,运行前验证
- **版本管理**:保存、对比、恢复工作流版本
- **运行追踪**:逐步执行追踪,变量检查
- **循环支持**:嵌套循环节点,独立内部画布
- **模板**:预置常用模板(简单对话、条件分支)
- **自动保存**:5 秒防抖,脏状态指示器
***
## 📚 知识库
完整的知识管理系统,AI 驱动:
### 文档管理
- **多格式上传**:PDF、DOCX、XLSX、PPTX、图片等
- **分块上传**:>2MB 文件自动按 2MB 分块(最大 500MB)
- **AI 蒸馏**:使用 AI 从文档中提取关键洞察
- **批量操作**:批量蒸馏、移动、管理文档
- **预览**:应用内预览所有支持格式
- **导入/导出**:ZIP 导入/导出,Obsidian vault 导入
### 笔记
- **Markdown 编辑器**:全功能编辑器,支持 wiki-link 导航
- **Vault 系统**:创建和管理多个知识库
- **Obsidian 兼容**:导入已有 Obsidian vault
### Notes Chat
用专属 AI 代理与你的知识库对话:
- **限定范围**:可按路径或 vault 限定 Agent 访问范围,让对话更聚焦
- **会话持久化**:按 scope 维度保存历史,可随时继续
- **可配置 Agent**:复用任意已注册的 SubAgent 配置(模型、工具、系统提示)
- **内置知识库工具**:全文检索、笔记读取、链接列表、时间线遍历
- **记忆联动**:可选写入长期记忆与时间线观察
- **WebSocket 流式**:实时 token 流式输出,可见工具调用过程
### Library Chat Drawer
知识库内可调宽度的聊天侧拉面板,原地问答不打断阅读:
- **拖拽调宽**:抽屉宽度可自由调整
- **会话列表**:快速切换历史会话
- **Markdown + KaTeX**:回复中支持公式与代码高亮
- **流式体验**:实时输出,附一键复制
### 知识图谱
- **可视化探索**:基于 PixiJS 的 WebGL 图谱渲染
- **力导向布局**:交互式节点定位
- **关系映射**:发现知识节点之间的关联
### PDF 思维导图
把任意 PDF 一键变可导航的思维导图:
- **大纲抽取**:解析 PDF 书签/标题为树形结构
- **交互渲染**:支持平移、缩放、折叠/展开
- **独立窗口**:可在 Electron 中单独打开 PDF 阅读器
- **内联批注**:阅读时高亮、下划线标注
- **PDF AI 问答**:基于当前文档内容回答问题
***
## 📡 多通道支持
将 Octopus 连接到你常用的平台:
| 通道 | 功能 |
| :------- | :---------------------------------- |
| 🖥️ 桌面端 | 全功能原生应用,WebSocket 实时通信 |
| 💬 微信 | 扫码登录、收发消息、自动回复 |
| 🐦 Slack | Bolt SDK 集成、频道和私信支持 |
| 🎮 Discord | Bot 集成、服务器和频道消息 |
| ✈️ Telegram | Bot API、聊天和群组支持 |
| 📱 钉钉 | Stream 协议、会话消息 |
| 📧 邮件 | SMTP/IMAP 集成 |
| 🔗 Webhook | 通用 HTTP Webhook,自定义集成 |
| 🐦 飞书 | Lark SDK、事件订阅 |
***
## 🔌 扩展生态
### 技能扩展(Markdown 即可)
写一个 `SKILL.md` 就能让 AI 学会新能力:
```markdown
---
name: "代码审查"
emoji: "🔍"
---
审查代码时检查:
1. 安全问题(SQL 注入、XSS)
2. 性能瓶颈
3. 命名规范
```
放入 `workspace/extensions/my-skill/SKILL.md`,重启即生效。
### 扩展市场
- 浏览和安装社区扩展
- 三种扩展类型:**Skill**、**Plugin**、**Worker**
- 搜索、按类型筛选、按热度排序
- 一键安装,支持环境变量配置
### MCP 协议支持
- 连接任意 MCP 服务器(stdio / HTTP SSE)
- 自动发现工具,无需手动配置
- 可视化权限管理,按工具启用/禁用
- 实时连接状态监控
***
## 🛠️ 内置工具
| 类别 | 工具 | 说明 |
| :------- | :----------------------------------------------- | :------------ |
| 📁 文件系统 | `read`, `write`, `edit`, `list` | 文件读写操作 |
| 🖥️ 系统 | `shell`, `spawn` | 命令行执行 |
| 🌐 网络 | `web_fetch` | 网页内容抓取 |
| 🖥️ 浏览器 | `browser_navigate`, `browser_click`, `browser_screenshot`, ... | Playwright 浏览器自动化 |
| 🖼️ 图像 | `image_understand`, `image_generate` | AI 图像处理 |
| ⏰ 定时 | `cron_add`, `cron_list`, `cron_remove` | 定时任务管理 |
| 💬 消息 | `send_message` | 多通道消息发送 |
| 🧠 记忆 | `memory_read`, `memory_write` | Agent 记忆操作 |
| 📚 知识库 | `knowledge_search`, `knowledge_query` | 知识库检索 |
| ⚡ 动作 | `action` | 执行扩展动作 |
***
## 🧠 观察与记忆
Octopus 自动从对话中提取洞察:
### 观察类型
| 类型 | 说明 |
| :------------- | :-------------- |
| 🎯 关键发现 | 重要的发现和顿悟时刻 |
| 🔧 问题-方案 | 问题和解决方案配对 |
| ⚙️ 工作原理 | 某事物如何运作的解释 |
| 📝 变更记录 | 变更追踪 |
| 🔍 新发现 | 新的发现 |
| ❓ 存在原因 | 设计理由和原因 |
| 📋 决策 | 设计决策 |
| ⚖️ 权衡分析 | 权衡分析 |
| 💡 通用观察 | 通用观察记录 |
### 记忆功能
- **自动提取**:AI 自动识别和提取对话中的观察
- **提升为记忆**:将重要观察提升为长期记忆
- **用户画像**:追踪用户偏好和行为模式
- **上下文深度**:查看观察及其周围对话上下文
***
## ⚙️ 可视化配置
所有配置都有图形界面,不用写 YAML:
| 配置项 | 说明 |
| :-------- | :------------------------------------------- |
| **模型提供商** | 添加 OpenAI/Anthropic/DeepSeek 等,支持多提供商切换 |
| **Agent 设置** | 模型、最大 Token、温度、最大迭代、压缩配置 |
| **通道配置** | 微信扫码登录、Telegram Bot、Slack App、钉钉等 |
| **工具开关** | 一键启用/禁用工具,设置超时时间 |
| **工作目录** | 独立工作区,配置和记忆完全隔离 |
| **预算上限** | 设置月度 Token 上限,超支提醒 |
| **多模态** | 图像理解、TTS 等多模态设置 |
***
## 💰 Token 消耗可视化
实时监控每一次对话的成本:
- 📊 **实时统计**:输入/输出 Token、缓存命中、补全 Token、子 Agent 用量
- 📈 **历史趋势**:按天查看消耗走势(7/14/30 天)
- 📋 **分类明细**:按提供商和模型分析成本
- ⚠️ **预算告警**:设置上限,超支自动提醒
***
## ⏰ 智能定时任务
不只是定时发通知,而是真干活:
- **SubAgent 执行**:任务在独立 Agent 中运行,真正执行操作
- **灵活调度**:支持 ISO 时间、间隔秒数、Cron 表达式
- **上下文继承**:任务可以访问创建时的会话记忆
- **持久化存储**:任务保存在 SQLite,重启不丢失
- **通道投递**:将任务结果发送到指定通道
***
## 🗂️ 工作目录管理
每个项目一个工作区,互不干扰:
```
workspace/
├── project-a/ # 项目 A
│ ├── extensions/ # 专属扩展
│ ├── memory/ # 长期记忆
│ └── history/ # 聊天记录
├── project-b/ # 项目 B
│ └── ...
```
- 切换工作区 = 切换完整的配置和记忆
- 支持导出/导入工作区
- 团队共享:导出工作区,同事导入即用
- 内置文件浏览器,集成 Monaco Editor
- 多格式预览:PDF、DOCX、XLSX、PPTX、图片、Markdown
***
## 💬 聊天历史记录
- 所有对话保存在本地 SQLite
- 三级组织结构:通道 → 会话 → 实例
- 按消息类型筛选,跨历史搜索
- 可随时回到任意历史会话
- 支持多会话并行
***
## 🤖 可视化 SubAgent
通过界面创建和管理专用 Agent:
- **可视化编辑**:修改 `SOUL.md` 配置角色、工具、模型
- **一键创建**:填写名称自动生成模板配置
- **独立工作区**:每个 SubAgent 有自己的配置和记忆
- **主从调度**:主 Agent 自动调用合适的 SubAgent 处理任务
- **工具与扩展绑定**:为每个 Agent 分配特定工具和扩展
***
## 🚀 快速开始
### 环境要求
- **Node.js** >= 18
- **Python** >= 3.10
### 安装启动
```bash
# 1. 克隆项目
git clone