如何快速上手Byterover Cipher：5分钟搭建你的第一个AI编码记忆系统
如何快速上手Byterover Cipher：5分钟搭建你的第一个AI编码记忆系统
项目地址: https://gitcode.com/gh_mirrors/cipher5/cipher Byterover Cipher是一个专门为AI编码助手设计的开源记忆层系统，它通过MCP协议与主流IDE无缝集成，为您的AI编程助手提供持久化记忆能力。无论您是使用Cursor、Claude Code、Windsurf还是其他AI编程工具，Cipher都能让您的AI助手记住之前的对话历史、代码模式和项目上下文，实现真正的持续学习体验。
为什么需要AI编码记忆系统？🤔
传统的AI编码助手每次对话都是"从零开始"，无法记住之前的讨论和决策。Cipher解决了这个痛点，通过双记忆系统（System 1存储编程概念与业务逻辑，System 2存储AI的推理步骤）为您的AI助手提供长期记忆能力。
5分钟快速安装指南 ⚡
方法一：NPM全局安装（推荐）
# 全局安装Cipher
npm install -g @byterover/cipher
# 或者在项目中本地安装
npm install @byterover/cipher
方法二：Docker部署
如果您更喜欢容器化部署，可以使用Docker快速启动：
# 克隆仓库
git clone https://gitcode.com/gh_mirrors/cipher5/cipher.git
cd cipher
# 配置环境变量
cp .env.example .env
# 编辑.env文件，填入您的API密钥
# 启动服务
docker-compose up --build -d
方法三：从源码构建
pnpm i && pnpm run build && npm link
配置您的第一个AI记忆系统 🛠️
基础配置设置
创建配置文件 memAgent/cipher.yml，这是Cipher的核心配置：
# LLM配置
llm:
provider: openai # 支持openai、anthropic、qwen、ollama等
model: gpt-4-turbo
apiKey: $OPENAI_API_KEY
# 系统提示词
systemPrompt: '您是一个拥有记忆能力的AI编程助手'
# MCP服务器配置（可选）
mcpServers:
filesystem:
type: stdio
command: npx
args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
环境变量配置
创建 .env 文件，填入必要的API密钥：
# 至少需要一个API密钥
OPENAI_API_KEY=sk-your-openai-api-key
ANTHROPIC_API_KEY=sk-ant-your-anthropic-key
GEMINI_API_KEY=your-gemini-api-key
QWEN_API_KEY=your-qwen-api-key
# 向量存储配置（可选）
VECTOR_STORE_TYPE=qdrant
VECTOR_STORE_URL=https://your-cluster.qdrant.io
启动并使用Cipher 🚀
CLI交互模式
最简单的开始方式是使用交互式命令行：
# 启动交互模式
cipher
# 单次命令模式
cipher "将此添加到记忆中：Vite + Express本地开发中的常见CORS错误原因"
# API服务器模式
cipher --mode api
# MCP服务器模式
cipher --mode mcp
# Web UI模式
cipher --mode ui
Cipher Web界面提供了直观的记忆管理界面，支持会话管理、工具集成和实时聊天功能。
MCP集成（与IDE连接）
将Cipher集成到您的IDE中，享受无缝的AI记忆体验：
{
"mcpServers": {
"cipher": {
"type": "stdio",
"command": "cipher",
"args": ["--mode", "mcp"],
"env": {
"MCP_SERVER_MODE": "aggregator",
"OPENAI_API_KEY": "your_openai_api_key"
}
}
}
}
核心功能体验 🎯
1. 记忆存储与检索
Cipher让您的AI助手能够记住重要的编程决策：
通过CLI检索之前的对话历史，让AI助手记住项目架构和关键决策。
2. 代码分析存储
将复杂的代码分析保存到记忆系统中：
存储代码库分析结果，为未来的查询提供上下文支持。
3. 实时事件系统
Cipher的事件系统提供强大的事件处理架构：
与Claude Code集成的实时事件系统，展示Cipher的上下文感知能力。
内置工具一览 🛠️
Cipher提供丰富的内置工具，帮助您更好地管理AI记忆：
- 记忆操作工具：
cipher_extract_and_operate_memory、cipher_memory_search - 推理记忆工具：
cipher_store_reasoning_memory、cipher_search_reasoning_patterns - 工作空间记忆：
cipher_workspace_search、cipher_workspace_store - 知识图谱工具：
cipher_add_node、cipher_search_graph、cipher_extract_entities - 系统工具：
cipher_bash（执行bash命令）
进阶配置指南 📚
向量存储配置
根据您的需求选择合适的向量数据库：
- Qdrant：高性能向量数据库
- Milvus：云原生向量数据库
- In-Memory：轻量级内存存储
- PostgreSQL + pgvector：关系型数据库扩展
详细配置请参考 向量存储配置文档。
LLM提供商支持
Cipher支持多种LLM提供商：
- OpenAI：GPT-4、GPT-3.5
- Anthropic：Claude系列
- AWS Bedrock：Amazon Titan
- Qwen：通义千问
- Ollama：本地LLM部署
- LM Studio：本地模型管理
详细配置请参考 LLM提供商文档。
常见问题解答 ❓
Q：Cipher支持哪些IDE？
A：Cipher通过MCP协议支持Cursor、Claude Code、Windsurf、Cline、VS Code、Warp等主流IDE。
Q：记忆数据存储在哪里？
A：Cipher支持多种存储后端，包括SQLite、PostgreSQL、Redis，以及向量数据库如Qdrant、Milvus等。
Q：如何与团队共享记忆？
A：通过工作空间记忆功能，团队成员可以共享项目上下文和编程模式。
Q：Cipher的开源协议是什么？
A：Cipher采用Elastic License 2.0开源协议。
下一步行动 🎯
现在您已经掌握了Cipher的基本使用方法，可以：
- 探索高级功能：查看 官方文档 了解更多配置选项
- 集成到工作流：将Cipher与您的日常开发工具链集成
- 贡献代码：参与开源社区，改进Cipher的功能
- 分享经验：在Discord社区分享您的使用心得
通过Cipher的AI编码记忆系统，您的编程助手将不再"健忘"，而是成为真正理解您项目历史和上下文的智能伙伴。开始您的AI记忆增强编程之旅吧！
Agent 垂直技术社区，欢迎活跃、内容共建。
更多推荐
7
0- 0
已为社区贡献6条内容
所有评论(0)