# memcell 中文文档

规范地址：https://npmcn.com/package/memcell/

版本：2\.2\.1
npm 元数据更新时间：2026-11-04T03:08:22.056Z
中文译文更新时间：2026-11-04T04:01:48.604Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/memcell
原文对照：https://npmcn.com/package/memcell/?lang=original
项目主页：https://memcell.ai/
源码仓库：https://github.com/memcell-ai/devkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.8 MB，360 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2026-07-31T04:07:57.627Z
- 最新版本发布：2026-11-04T03:08:21.694Z
- 已发布版本数：52（近 12 个月 52 个）

## 中文简介

任何AI代理共享的持久内存。代理在行动之前会回忆您的工作空间所建立的内容——指令、决策、事实、偏好、活动的工作线程和基础的PDF/DOCX/CSV/web文档，然后报告结果，这样就有信心了

## 安装

```sh
npm install memcell
```

也可以使用：`pnpm add memcell`、`yarn add memcell`、`bun add memcell`

## README

![MemCell Logo](https://memcell.ai/icon.svg)

# memcell

**用于人工智能代理的持久、自适应记忆引擎。**  
阻止代理在不同的会话中重复同样的错误。

[![npm version](https://img.shields.io/npm/v/memcell.svg?style=flat)](https://www.npmjs.com/package/memcell) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/memcell-ai/devkit/blob/main/LICENSE) [![Node.js >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/) [![Documentation](https://img.shields.io/badge/docs-memcell.ai-blue)](https://memcell.ai/docs)

```sh
# Install globally
npm install -g memcell

# In any project:
memcell connect
```

在任何项目中运行它。 `memcell connect` 自动:

-   **一键审批**：打开浏览器审批（不需要预先帐户；登录时无缝地保留客人的记忆）。
-   **检测代理**:电线 **Claude Code, Cursor, Copilot CLI, Gemini CLI, OpenAI Codex, OpenCode, Cline, Windsurf**，以及更多非破坏性生命周期钩子和本地工作室MCP服务器(`memcell mcp`）.
-   **获得证书**：将范围代理密钥直接存储在您的操作系统密钥环（Keychain / Secret Service / Credential Manager）中。
-   **创建 `.memcell`**：在你的repo根目录中添加一个干净的、git安全的项目描述符。

随时验证:

```sh
memcell status
```

* * *

## 为什么MemCell ?

每次你与AI代理开始一个新的会话时，它都会以完全失忆开始。它会陷入同样的陷阱，重复过时的假设，重现你昨天已经解决的问题。

静态指令文件和单片系统提示不能解决这个问题：

-   **上下文膨胀**：堆叠数十个指令在每回合都浪费令牌，并稀释模型的注意力。
-   **零适应性**过时的指令即使在需求改变时也会继续生效。
-   **人工开销**你仍然是唯一的反馈回路，不断手工编辑降价文件。

**MemCell为您的代理提供闭环记忆：**

1.  **Pre-Action回忆** 在采取行动之前，代理会收到与当前任务相关的经过验证的记忆。
2.  **执行与反馈** -当行动成功或失败时，将报告实际结果。
3.  **获得信心** -工作记忆获得信心；失败的记忆会衰退。无需人工及时维护。

* * *

## 它是如何工作的

MemCell对两个轻量级层，使代理保持对齐，而不会妨碍你的方式：

-   **确定性挂钩（零接触）**：在会话开始、提示提交和回合结束时自动触发。在操作开始之前检查相关内存、活动会话线程和指令，而不依赖于模型记住调用工具。 _钩子在50毫秒内打开失败，所以离线或慢速网络永远不会阻塞编辑器。_
-   **MCP工具桥架(`memcell mcp`）**：提供互动工具(`recall`， `remember`， `report`)，当代理人需要搜索记忆或记录发现时。

* * *

## 日常的使用

一旦连接，代理会自动召回并报告内存。你也可以直接从你的终端与内存交互：

### 1\. 执行前召回已验证的上下文

```sh
memcell recall "how do we handle multi-tenant database sessions?"
```

### 2\. 记录一个决定或指令

```sh
# Record a workspace instruction
memcell remember "Always use pnpm for package operations; never invoke npm directly" --type instruction

# Record an architectural decision
memcell remember "Use Next.js for both backend and frontend with shadcn for UI" --type decision

# Bind an instruction to a specific lifecycle trigger
memcell remember "Check database migrations for column locks before altering tables" --type instruction --at change
```

### 3\. 报告发生的事情

当被告知所发生的事情时，记忆会变得清晰。当方法成功或失败时，报告结果：

```sh
memcell report mem_019a4b2c worked --note "CI suite passed cleanly"
memcell report mem_019a4b2c failed --note "broke Next.js 15 async cookies"
```

### 4\. 摄取规格和现有指引

```sh
# Index workspace docs and project manifests for grounded RAG and graph extraction
memcell ingest

# Scan and import existing guideline files (CLAUDE.md, etc.)
memcell import
```

### 5\. 检查属性令牌节省

```sh
memcell stats
```

显示跟踪的记忆，避免的错误，从防止的错误循环中保存的估计标记，以及30天的活动火花线。

* * *

## 支持的代理和ide

| 代理/线束 | 集成 | 它是如何运行的 |
| :-- | :-- | :-- |
| **克劳德代码** | 钩子+ MCP +插件 | 自动生命周期挂钩或市场插件(`/plugin marketplace add memcell-ai/mcp`） |
| **光标** | 钩子+ MCP桥 | 本地生命周期挂钩 `.cursor/hooks.json` 还有演播室桥 `.cursor/mcp.json` |
| **双子座CLI** | 钩子+ MCP | 会话和提示钩子通过本地CLI控制 |
| **GitHub Copilot CLI** | 生命周期的钩子 | 预命令验证挂钩 |
| **OpenAI Codex / OpenCode** | 钩子+ MCP | 工作区描述符挂钩和工作室工具 |
| **克莱恩和风帆冲浪** | MCP桥 | 本机编辑器MCP客户端配置 |
| **工厂机器人，德文，基罗，鹅** | 钩子+ MCP | 工作区适配器和工具线束 |

* * *

## 命令小抄

| 命令 | 描述 |
| :-- | :-- |
| `memcell start [--daemon]` | 运行本地MemCell服务器与嵌入式PGlite矢量引擎 |
| `memcell stop` | 停止本地后台服务器守护进程 |
| `memcell connect` | 将此目录连接到MemCell，安装hooks，并配置MCP |
| `memcell status` | 检查身份验证状态、活动工作区和连接运行状况 |
| `memcell stats` | 显示内存遵循，避免错误，并节省标记 |
| `memcell recall <intent>` | 查询已验证的内存、线程和文档 |
| `memcell remember <text>` | 将指示、决定、事实或偏好归档 |
| `memcell report <id> <outcome>` | 报告 `worked`， `failed`,或 `avoided` 更新信心 |
| `memcell thread` | 列出、检查、恢复或完成工作会话线程 |
| `memcell ingest [paths...]` | 索引工作区文档和清单到接地RAG和内存图 |
| `memcell document` | 列出、搜索或删除已索引的工作空间文档 |
| `memcell import [files...]` | 导入现有指引文件(`CLAUDE.md`等)。 |
| `memcell export` | 将工作空间记忆体导出为可携式文件(`--format json|md`） |
| `memcell orgs` | 列出或切换活动组织(`memcell orgs switch <slug>`） |
| `memcell workspaces` | 列出或切换活动工作区(`memcell workspaces use <slug>`） |
| `memcell hook remove` | 干净地从该目录中删除所有MemCell挂钩 |
| `memcell reset` | 清除这台计算机上所有缓存的凭据、密钥和令牌 |

运行 `memcell --help` 或 `memcell <command> --help` 有关旗帜的详细信息。

* * *

## 干净卸载

从存储库中删除MemCell钩子而不触及代码：

```sh
memcell hook remove
rm .memcell
```

要从本地计算机中删除所有存储的密钥和凭据：

```sh
memcell reset
```

* * *

## 链接

-   **文档**： [https://memcell.ai/docs](https://memcell.ai/docs)
-   **网站**： [https://memcell.ai](https://memcell.ai/)
-   **问题**： [https://github.com/memcell-ai/devkit/issues](https://github.com/memcell-ai/devkit/issues)

Apache License 2.0·©2026 Memcell, Inc

## 常见问题

### memcell 是什么？

任何AI代理共享的持久内存。代理在行动之前会回忆您的工作空间所建立的内容——指令、决策、事实、偏好、活动的工作线程和基础的PDF/DOCX/CSV/web文档，然后报告结果，这样就有信心了

### 如何安装 memcell？

在项目目录运行 npm install memcell，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mem、memcell，可以用 npx mem 直接运行。

### memcell 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/memcell 是否存在。

### memcell 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### memcell 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### memcell 可以商用吗？

memcell 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### memcell 还在维护吗？

最新版本 2\.2\.1 发布于 2026/11/04（今天）；至今共发布 52 个版本，其中过去 12 个月发布了 52 个；首次发布于 2026/07/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。