🚀 GitHub Copilot Memory Tool
GitHub Copilot Memory Tool 为 GitHub Copilot 赋予持久记忆能力，让它在各种对话场景中都能记住你的偏好和上下文信息，极大提升使用效率和代码生成质量。
🚀 快速开始
如果你还没有安装 python，需要先从 python.org/downloads 进行安装。
1. 从 PyPI 安装 pipx
pip install pipx
2. 点击对应 VS Code 的徽章进行安装
.. 或者手动添加到你的 VS Code
将以下内容添加到你的 VS Code MCP 设置 (mcp.json) 中：
{
"servers": {
"mode-manager": {
"command": "pipx",
"args": [
"run",
"mode-manager-mcp"
]
}
}
}
完成以上步骤后，就可以开始与 Copilot 聊天并使用 "Remember that..." 指令了。
额外福利
为了方便使用，你可以在 VS Code 中运行以下提示来开启最佳使用体验：
/mcp.mode-manager.onboarding
这将引导你完成入门流程，设置持久记忆，并确保 Copilot 从一开始就了解你的偏好。
给等不及下一个版本的勇敢者
如果你将以下内容添加到 mcp.json 中，pipx 每次都会直接从 GitHub 下载并安装最新版本：
{
"servers": {
"mode-manager": {
"command": "pipx",
"args": [
"run",
"--no-cache",
"--system-site-packages",
"--spec",
"git+https://github.com/NiclasOlofsson/mode-manager-mcp.git",
"mode-manager-mcp"
]
}
}
}
✨ 主要特性
2025 年的变革性工具
该工具专为 VS Code 的新特性打造，每次聊天消息都会加载自定义指令，使得持久记忆功能变得极其强大，无论讨论何种话题，记忆始终有效。
- 记忆始终活跃：在每一次对话、每一轮交流中，你的记忆信息都能发挥作用。
- 无需重复上下文：开启新聊天时，无需再次重复之前的上下文信息。
- 跨会话、话题和项目了解你：Copilot 能够在不同会话、话题和项目中真正了解你的需求。
- 时机恰到好处：专为新的指令加载行为而设计。
简单易用
只需一个命令即可完成所有操作：
Ask Copilot: "Remember that I prefer detailed docstrings and use pytest for testing"
这样，Copilot 就会永远记住这些信息，并在未来的所有对话中应用。
记忆内容丰富
- 工作上下文：你的角色、所在公司、当前项目等。
- 编码偏好：编程语言、框架、风格指南等。
- 项目细节：架构决策、命名约定等。
- 个人工作流程：你喜欢的工作方式、调试和测试方法等。
幕后工作原理
- 自动设置：首次使用时，会在 VS Code 提示目录中创建
memory.instructions.md文件。 - 智能存储：每条记忆都会添加时间戳并进行组织。
- 始终加载：VS Code 2025 年的新特性确保你的记忆会包含在每个聊天请求中。
- 跨会话持久化：即使重启 VS Code 或开启新对话，你的记忆依然存在。
额外功能
除了记忆功能，该工具还能管理你的 VS Code 提示生态系统：
- 精选库：提供 20 多种专业聊天模式和指令。
- 文件管理：可以创建、编辑和组织
.chatmode.md和.instructions.md文件。 - 保持更新：从源更新文件的同时保留你的自定义设置。
💻 使用示例
基础用法
在使用该工具之前：
你: "Hey Copilot, write me a Python function..."
Copilot: 给出通用的 Python 代码
使用 remember 之后：
你: "Remember I'm a senior data architect at Oatly, prefer type hints, and use Black formatting"
下一次对话: "Write me a Python function..."
Copilot: 生成带有类型提示、符合你精确偏好的完美风格代码
高级用法
你可以让 Copilot 记住更多详细信息，例如：
Ask Copilot: "Remember that I prefer detailed docstrings and use pytest for testing"
这样，Copilot 就会在后续的对话中始终遵循这些偏好。
🔧 技术细节
该工具在首次使用时会自动在 VS Code 提示目录中创建 memory.instructions.md 文件，用于存储记忆信息。每条记忆都会添加时间戳并进行组织，以确保信息的有序性和可追溯性。VS Code 2025 年的新特性使得这些记忆信息会包含在每个聊天请求中，从而实现跨会话的持久化。此外，该工具还提供了文件管理和更新功能，方便用户管理和维护自己的提示生态系统。
📄 许可证
本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。
贡献代码
如果你想帮助改进这个工具，请查看 CONTRIBUTING.md 了解开发设置和指南。