fivocell

v8.12.25

Published

2 months ago

FIVO Cell — Permanent Developer Memory. Learns how you think, build, fail, and grow.

0High
0Medium
0Low

fivo cell taste learning ai coding mcp model-context-protocol intelligence developer-tools code-analysis pattern-learning knowledge-graph recommendation-engine

🤔 什么是 FivoCell？

每次你与AI编程工具对话时，它都从零开始。你需要重新解释你的项目、你的技术栈、你的编码风格，以及你昨天做的决定。从Cursor切换到Claude Code？重新开始。新对话？重新开始。新的一天？重新开始。

FivoCell 解决了这个问题。 它作为本地守护进程安静地运行在你的机器上，充当所有AI工具的永久大脑。一旦安装，任何AI工具都能知道：

实际输出示例 — Cell 首次扫描告诉你什么：

✅ 已扫描你的项目
⚠️  98 个文件的异步函数缺少 try/catch
⚠️  43 个文件残留了 console.log
⚠️  核心模块检测到空值安全问题
🧠  你的风格："双语沟通者、战略审计者、快速交付者"
🔮  预测下次会话：auth 模块需要错误处理优化

AI工具负责写代码，FivoCell 记住其余所有事情。

💡 问题 vs 解决方案

  Cursor ──────────┐
  Claude Code ─────┤                 ┌─────────────────────┐
  Codex ───────────┤                 │      FIVO CELL       │
  Antigravity ─────┼────────────────>│      记忆层          │
  Windsurf ────────┤                 │      守护进程 :9876  │
  OpenCode ────────┤                 │      MCP 工具        │
  任意MCP工具 ─────┘                 └──────────┬──────────┘
                                                │
                              ┌──────────────────┴──────────────────┐
                              │                                     │
                              ▼                                     ▼
                    ┌─────────────────┐                  ┌─────────────────┐
                    │  SQLite (本地)  │                  │  IDE中的@cell   │
                    │  永不遗忘       │                  │  完整上下文     │
                    │  永不重置       │                  │  即时响应       │
                    └─────────────────┘                  └─────────────────┘

⚡ 快速开始

# 第1步 — 安装（仅需一次）
npm install -g fivocell

# 第2步 — 进入你的项目并运行
cd your-project
cell run

cell run 一条命令完成所有事情：

[1/7] ✅ 设置完成 — 已创建 .cell/ 文件夹
[2/7] 🔍 正在扫描代码库 — 文件、技术栈、风格、盲点
[3/7] ⚠️  发现盲点 — 空值安全、错误处理、console.log
[4/7] 🧠 氛围引擎已启动 — 正在学习你的模式
[5/7] 📄 AGENTS.md 已创建 — AI工具现在知道你是谁
[6/7] 🚀 守护进程已在 :9876 启动 — MCP工具就绪
[7/7] 👁️  文件监控已启动 — 文件保存将被跟踪

然后打开任意AI工具（Cursor、Claude Code、Windsurf）并输入：

@cell 我该如何给这个应用添加认证功能？

AI会带着完整上下文回复 — 你的技术栈、风格、决定和盲点 — 无需你做任何解释。✨

cell status     # 检查守护进程 + 项目健康状态
cell context    # 查看AI看到的内容
cell vibe       # 查看你的开发者个性

📅 随时间推移的变化

第1天 — 运行 `cell run` 后

| 步骤 | 发生了什么 | |:----:|-----------| | 1 | npm install -g fivocell — 全局安装 | | 2 | cell run — 一条命令完成设置 + 扫描 + 启动守护进程 | | 3 | 代码扫描运行 — 分析文件，发现盲点（空值安全、错误处理、console.log等） | | 4 | .cell/ 文件夹已创建 — 氛围、上下文、INDEX、桥接文件 | | 5 | 项目根目录创建 AGENTS.md — 告诉每个AI工具 @cell 是什么 | | 6 | 守护进程在 :9876 启动 — 所有MCP工具就绪 | | 7 | 文件监控启动 — 从现在起每次保存都会被跟踪 |

你会看到类似这样的输出：

⚠️  98 个文件：异步函数缺少 try/catch
⚠️  43 个文件：未移除 console.log
   null_safety：高优先级
   error_handling：高优先级

前7天 — Cell 学习你

| 事件 | 发生了什么 | |:----:|-----------| | 8 | 在任意编辑器输入 @cell → 即时注入上下文，无需解释 | | 9 | 氛围信号被检测 — "双语沟通者、战略审计者、务实交付者" | | 10 | 监控器记录事件 — 每次文件保存、每次git提交都被跟踪 | | 11 | 智能触发：60秒内5次保存 → 预测自动刷新 | | 12 | 运行 cell scan → 代码分析更新，发现新的盲点 | | 13 | 跨编辑器记忆 — 在Cursor结束会话 → 打开Claude Code → 桥接已就绪 | | 14 | 会话桥接已捕获 — 修改的文件、做出的决定、失败的方法、成功的方法 |

前30天 — Cell 了解你

| 事件 | 发生了什么 | |:----:|-----------| | 15 | 氛围稳定 — 高置信度的个性档案固化 | | 16 | 跨项目档案 — ~/.fivo/cell/projects/ 跟踪你所有仓库的数据 | | 17 | 全局氛围合并 — 所有项目统一身份 | | 18 | 预测变得准确 — "这个文件会被打开"、"这个错误会重现" | | 19 | 模型智能 — 跟踪哪个AI工具对你的代码接受率最高 | | 20 | 记忆压缩 — 超过90天的事件自动归档 | | 21 | 生成 user-profile.md — 你的技能、盲点、成长历程 | | 22 | 神经桥接 — 每次会话结束保存桥接 + 连续性，下次无缝开始 |

🚀 功能与优势

⚙️ 核心命令

多个CLI命令按类别组织。运行 cell help --all 查看全部。

🧠 记忆与上下文

至高上下文 — 3个引擎

🎭 氛围 — 开发者个性

信号维度： 语言偏好 · 回复结构 · 沟通语气 · 代码修改风格 · 工作流程 · 决策方式 · 速度与质量 · AI信任度 · 项目行为 · 情感细微差别 · 提示思维 · 会话节奏

Cell 生成的AI指南示例： "直接沟通 — 先给答案，再做解释。适当使用中英混合。保持修改最小化。先审计再建议。除非被要求，否则不要重写。"

🔍 代码智能

📡 MCP — 多IDE支持

👁️ 文件监控

☁️ 云端同步 — 仅限自愿开启

🩺 健康与安全

🚫 FivoCell 不做什么

诚实清单。使用前请了解。

| # | 缺失 | 原因 | |:-:|------|------| | 1 | 语义代码理解 — "解释为什么这个函数逻辑上有问题" | 需要LLM。Cell完全基于规则和确定性。 | | 2 | 实时云端同步 (cell.fivo.live) | 云端服务器是独立部署的。Cell本身100%离线工作。 | | 3 | 多语言深度解析（Python、Rust、Go） | Tree-sitter已安装但尚未完全接入所有分析器。 |

Cell 是什么： 基于规则的、确定性的、离线优先的记忆层。 Cell 不是什么： LLM、代码解释器或云服务。

🆚 FivoCell vs 竞品对比

🏗️ 架构

┌─────────────────────────────────────────────────────────────────┐
│                     你的机器（100% 本地）                        │
│                                                                 │
│  Cursor ──┐                                                     │
│  Windsurf ┤  MCP 协议                                           │
│  Claude   ├────────────────────────────────────────────────>    │
│  Codex    ┤                    ┌───────────────────────────┐    │
│  Antigrav ┘                    │      FIVO CELL 守护进程    │    │
│                                │   http://localhost:9876   │    │
│                                ├───────────────────────────┤    │
│                                │ 提示构建器 | MCP服务器     │    │
│                                │ 上下文桥接 | CLI路由       │    │
│                                │ 会话跟踪器| 监控器        │    │
│                                └──────────┬────────────────┘    │
│                                           │                     │
│                         ┌─────────────────┼─────────────────┐  │
│                         ▼                 ▼                 ▼  │
│                   ┌──────────┐    ┌──────────┐    ┌──────────┐ │
│                   │  SQLite  │    │  .cell/  │    │   氛围   │ │
│                   │  本地    │    │  INDEX   │    │   引擎   │ │
│                   │  数据库  │    │  bridge  │    │   信号   │ │
│                   └──────────┘    └──────────┘    └──────────┘ │
└─────────────────────────────────────────────────────────────────┘

7层架构

至高上下文引擎流程

  会话开始  ->  [连续性]  加载活跃线程
             ->  [桥接]    加载上次会话摘要
             ->  [预测器]  建议下一步操作
             ->  AI获得完整上下文，无需手动解释

  会话结束  ->  [桥接]    捕获摘要
             ->  [连续性]  更新线程
             ->  [预测器]  更新预测
             ->  保存到 .cell/ — 永不丢失

数据流程

  输入 @cell  ->  MCP请求发送到 :9876
               ->  提示构建器读取：
                   +-- SQLite本地数据库（所有事件、决定、错误）
                   +-- .cell/INDEX.md（快速上下文查找）
                   +-- .cell/vibe/（个性信号）
                   +-- .cell/bridge/latest.json（上次会话）
                   +-- .cell/continuity/（活跃线程）
                   +-- .cell/predictor.json（下一步操作）
               ->  按相关性排序
               ->  压缩到token预算
               ->  按工具格式化
               ->  返回上下文块给AI

🔌 支持的工具

🔒 安全与数据隐私

FivoCell 采用隐私优先、默认本地的架构设计，确保你的敏感知识产权和凭证始终在你的控制之下。

FivoCell 获取什么（100% 本地存储）

💾 本地SQLite数据库：在你的本地机器上存储记忆事件、CLI历史、会话摘要和决定（.cell/ 文件夹）。
⚙️ 开发者氛围信号：学习你的本地编程惯例和风格，构建自定义AI指令。
🔍 代码诊断：本地扫描器检查代码漏洞、结构风险和编码模式。

FivoCell 绝不访问或传输什么

❌ 原始源代码：所有代码诊断在本地运行。你的源文件绝不离开你的机器。
❌ API密钥与凭证：PrivacyRedactor 拦截并脱敏API令牌、AWS密钥、数据库URL和密码模式（15种默认过滤器），在任何网络调用之前。
❌ 个人/系统标识符：绝对路径、邮箱、私有IP和内部主机名全部被清理。

自愿云端同步（细粒度控制）

任何云端功能默认完全关闭，需要明确自愿开启：

社区模式：仅匿名化的氛围和高级风格模式 — 无原始代码、名称或路径。
团队同步：可选的加密共享项目决定和会话交接。

随时验证你的安全状态：

cell doctor

📚 文档

🤝 参与贡献

FivoCell 基于 Apache 2.0 开源。欢迎贡献、提Issue和PR。

git clone https://github.com/itsvinsoni/cell
cd cell
npm install
npm test        # 验证所有测试通过