内容
<p align="center"><img src="docs/hero-banner.png" alt="章鱼 — 您的智能代理控制中心." /></p>
[](https://github.com/oyster-to/oyster/releases)
[](https://www.npmjs.com/package/oyster-os)
[](https://www.npmjs.com/package/oyster-os)
[]()
[](LICENSE)
---
# 🦪 您的智能代理控制中心
章鱼让您的 AI 工作保持有序、同步并随时可分享,具备记忆和发布功能。您可以自由选择智能代理,随时切换。
```bash
# 1. 安装
npm install -g oyster-os
# 2. 启动
oyster
# 3. 在浏览器中打开 http://localhost:4444
```
## 为什么选择章鱼
您的 AI 会话、文件和记忆分散在各种工具中。章鱼将所有智能代理的工作放在一个共享的界面上,按空间组织。
- **查看所有智能代理的工作** — 章鱼自动监控 Claude Code。实时记录、状态(活跃 / 等待 / 已断开 / 已完成)和每个会话的文件,均在首页显示。
- **跨会话的记忆** — `remember` 笔记是一等公民。每个智能代理的 `recall` 都读取相同的存储,因此上下文在工具和设备之间保持一致。
- **轻松接入任何项目** — 将章鱼指向一个文件夹,它会扫描文档、应用程序和图表,然后将未来的会话归属到正确的项目。
- **接入任何智能代理** — 章鱼是一个 MCP 服务器。Claude Code、Cursor、VS Code、Windsurf 或您自己的智能代理 — 一个标准,所有智能代理通用。
## 快速入门
```bash
npm install -g oyster-os
oyster
```
就这样。首次运行时,章鱼会连接您到 AI 提供商(在浏览器中打开以登录)。然后,您的 workspace 在 **http://localhost:4444** 打开。
或者,无需安装:
```bash
npx oyster-os
```
## 连接您的 AI
章鱼是一个 MCP 服务器。任何兼容 MCP 的工具都可以连接并控制您的 workspace。
**Claude Code:**
```bash
claude mcp add --scope user --transport http oyster http://localhost:4444/mcp/
```
**Cursor / VS Code / 其他 MCP 客户端** — 添加到您的 MCP 配置:
```json
{
"oyster": {
"type": "http",
"url": "http://localhost:4444/mcp/"
}
}
```
连接后,您的 AI 可以列出空间、打开工件、创建文档、上线项目并直接管理界面。
## 上线一个项目
从章鱼聊天栏:
```
onboard my project at ~/Dev/my-project
```
章鱼扫描文件夹中的文档、应用程序和图表,并自动将它们添加到界面。
## 命令
| 命令 | 功能 |
|---|---|
| `/s <空间>` | 切换到一个空间 — `/s blunderfixer` 打开该空间 |
| `/o <查询>` | 按名称打开一个工件 — `/o pricing deck` 查找并打开它 |
| `#<空间>` | 快速切换空间 — `#home` 返回首页, `#bf` 匹配 blunderfixer |
| `#<编号>` | 跳转到编号空间 — `#1` 切换到第一个空间 |
| `#.` | 返回首页 |
| 普通聊天 | 向章鱼提问 — 导航、组织或创建工作 |
## 架构
```
浏览器 → http://localhost:4444
|
章鱼服务器
- SQLite(工件、空间)
- MCP 服务器(/mcp/)
- SSE 推送(即时 UI 更新)
- 静态网页 UI
- 聊天代理 → OpenCode → LLM
```
## 状态
早期 v1 版本。本地优先。专业版支持跨设备功能。构建用于快速迭代。
- **当前(`0.8.x`)** — 跨设备内存同步(专业版)。您在任何已登录的设备上记住的内容都会在其他设备上显示。
- **最近发布** — 使用 GitHub 或神奇链接登录(0.7.0),发布和分享工件(0.7.0),空间跨设备同步(0.7.1),云内存存储(0.8.0)。
- **下一个(`0.9.x`)** — 从云恢复、语义召回、跨设备会话启动、冷存储记录备份、多智能体摄入(Cursor、Codex、OpenCode)。
- **后续** — 工件版本历史、跨设备工件字节同步。
在 [更新日志](https://oyster.to/changelog) 中查看所有已发布的更改。专业版详情请参见 [定价页面](https://oyster.to/pricing)。
## 贡献
章鱼仍处于早期阶段,但我们欢迎有针对性的贡献。
1. 先创建一个问题
2. 保持范围紧凑
3. 发送一个专注的 PR,附上清晰的前后对比
### 开发
```bash
git clone https://github.com/oyster-to/oyster.git
cd oyster
cd web && npm install && cd ../server && npm install && cd ..
npm run dev
# → 开发服务器在 http://localhost:7337(代理到 3333 端口的服务器)
```
## 许可证
[AGPL-3.0](LICENSE)
版权所有 (c) 2026 Matthew Slight
本仓库中的源代码根据 AGPL-3.0 许可证授权。如果您作为网络服务运行修改后的版本,则必须根据相同的许可证提供源代码。
“Oyster”、相关徽标、图标、吉祥物、文字标记和品牌资产均为商标。不得使用这些标记来识别、推广或分发修改后的软件版本,或暗示隶属、认可或官方地位。
连接信息
猜你喜欢
everything-claude-code
完整的 Claude Code 配置集合 - agents、skills、hooks、commands、rules、MCPs。来自 Anthropic...
MarkItDown
将文件和办公文档转换为Markdown的Python工具。
awesome-claude-skills
一份精心整理的 Claude Skills、资源和工具列表,用于定制 Claude AI 工作流程
agentic-awesome-skills
适用于 Claude Code、Cursor、Codex CLI、Autohand Code、Gemini CLI、Antigravity 等的...
antigravity-awesome-skills
Claude Code/Antigravity/Cursor 的 130 多个 Agentic Skills 终极合集。 经过实战检验、高性能的 AI...
context-mode
MCP 是用于工具访问的协议。我们是上下文的虚拟化层。