9.6 KiB
✨ 一眼看懂 PromptX
PromptX 能做什么？简单来说，它让你的 AI 助手拥有了"大脑"和"记忆"。
- 🎭 专业角色扮演: 提供覆盖不同领域的专家角色，让 AI 的回答更专业、更深入。
- 🧠 长期记忆与知识库: AI能够记住关键信息和你的偏好，在持续的对话和工作中提供连贯、个性化的支持。
- 🔌 轻松集成: 只需一行命令，即可为数十种主流 AI 应用（如 Claude、Cursor）无缝启用这些强大功能。
📸 配置成功后的使用效果
1. 发现并激活专业角色
使用 promptx_hello 发现可用角色，再用 promptx_action 激活，AI即刻变身领域专家。
2. 拥有智能记忆
使用 promptx_remember 保存关键信息，AI将在后续的交流中主动运用这些知识。
🚀 一键启动，30秒完成配置
第 1 步：找到AI应用的MCP配置文件
首先，找到您AI应用的配置文件。不知道在哪？没关系，我们为您准备了速查表：
👉 **点击这里，查看主流AI应用的配置文件位置**
| AI应用 | 状态 | 配置文件位置 |
|---|---|---|
| Claude Desktop | ✅ 官方支持 | Windows: %APPDATA%\Claude\claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | ✅ 支持 | 通过MCP设置面板配置 |
| Zed | ✅ 支持 | 配置文件：~/.config/zed/settings.json |
| Continue | ✅ 支持 | VS Code插件配置 |
| ...以及更多应用 | 请参考下方的完整列表 |
第 2 步：添加 PromptX 配置
打开配置文件，将下面的 promptx 配置代码复制进去。这是最简单的 零配置模式，PromptX 会自动为您处理一切。
{
"mcpServers": {
"promptx": {
// 指定使用 npx 运行 promptx 服务
"command": "npx",
// '-y' 自动确认, '-f' 强制刷新缓存, 'dpml-prompt@snapshot' 使用最新版, 'mcp-server' 启动服务
"args": ["-y", "-f", "dpml-prompt@snapshot", "mcp-server"]
}
}
}
🎯 就这么简单！ 保存文件并重启您的AI应用，PromptX 就已成功激活。
🔧 需要自定义工作目录？点击查看高级配置
如果您想指定一个特定的文件夹作为 PromptX 的工作区，可以添加 env 环境变量。
{
"mcpServers": {
"promptx": {
"command": "npx",
"args": ["-y", "-f", "dpml-prompt@snapshot", "mcp-server"],
"env": {
// PROMPTX_WORKSPACE: 自定义工作空间路径 (可选，系统会自动识别)
// Windows: "D:\\path\\to\\your\\project" (注意使用双反斜杠)
// macOS/Linux: "/Users/username/path/your/project"
"PROMPTX_WORKSPACE": "/your/custom/workspace/path"
}
}
}
}
⚙️ 工作原理
PromptX 作为您和AI应用之间的"专业能力中间件"，通过标准的 MCP协议 进行通信。
graph TD
subgraph Your AI App(Claude, Cursor, etc.)
A[👨💻 User Interaction]
end
subgraph PromptX MCP Server
C{PromptX Engine}
D[🎭 Role Library]
E[🧠 Memory & Knowledge]
end
A -- "Calls 'promptx_...' tools" --> B(MCP Protocol)
B --> C
C -- "Accesses" --> D
C -- "Accesses" --> E
subgraph Enhanced Response
F[✨ Professional Output]
end
C --> F
当您调用 promptx_... 系列工具时，AI应用会将请求通过MCP协议发送给 PromptX。PromptX 引擎会加载相应的专业角色、检索相关记忆，然后返回一个经过专业能力增强的结果给AI应用，最终呈现给您。
不知道MCP怎么使用？ 点击查看 MCP幼儿园教程 BiliBili
支持MCP的AI应用
| AI应用 | 状态 | 配置文件位置 | 特性 |
|---|---|---|---|
| Claude Desktop | ✅ 官方支持 | Windows: %APPDATA%\Claude\claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json |
Anthropic官方客户端，MCP原生支持 |
| Cursor | ✅ 支持 | 通过MCP设置面板配置 | 智能代码编辑器，开发者友好 |
| Claude Code | ✅ 支持 | /home/user/.claude.json 或者 ~/.claude.json |
Anthropic官方CLI工具，MCP原生支持，命令行AI编程助手 |
| Windsurf | ✅ 支持 | IDE内MCP配置面板 | Codeium推出的AI原生IDE |
| Cline | ✅ 支持 | VS Code插件配置 | 强大的AI编程助手 |
| Augment | ✅ 支持 | 桌面应用配置 | AI原生代码编辑器 |
| Trae | ✅ 支持 | IDE插件配置 | AI驱动的代码生成和重构工具 |
| 通义灵码 | 🟡 计划支持 | 阿里云IDE插件 | 阿里云推出的AI编程助手 |
| Zed | ✅ 支持 | 配置文件：~/.config/zed/settings.json |
高性能代码编辑器 |
| Continue | ✅ 支持 | VS Code插件配置 | VS Code AI助手插件 |
| Replit Agent | 🟡 实验支持 | Replit平台内置 | 在线编程环境 |
| Jan | 🟡 开发中 | 本地AI客户端 | 隐私优先的本地AI助手 |
| Ollama WebUI | 🟡 社区支持 | 第三方MCP适配器 | 本地大模型界面 |
| Open WebUI | 🟡 社区支持 | 插件系统 | 开源AI界面 |
| 百度 Comate | 🟡 计划支持 | 百度IDE插件 | 百度推出的AI编程助手 |
| 腾讯 CodeWhisperer | 🟡 计划支持 | 腾讯云IDE | 腾讯云AI编程工具 |
图例说明：
- ✅ 官方支持：原生或通过官方插件支持MCP协议。
- 🟡 实验/社区/计划支持：通过社区插件、实验性功能或已列入开发计划。
- 更多AI应用正在接入...
🎯 配置完成后，您的AI应用将自动获得6个专业工具：
promptx_init: 🏗️ 系统初始化 - 自动准备工作环境。promptx_hello: 👋 角色发现 - 浏览所有可用的专家角色。promptx_action: ⚡ 角色激活 - 一键变身指定领域的专家。promptx_learn: 📚 知识学习 - 让AI学习特定的知识或技能。promptx_recall: 🔍 记忆检索 - 从记忆库中查找历史信息。promptx_remember: 💾 经验保存 - 将重要信息存入长期记忆。
📋 实践案例: Legacy Lands Library
项目简介： legacy-lands-library 是一个面向现代 Minecraft 服务端插件开发的工具库，由"遗迹之地制作组"开发并应用于实际生产。
💡 核心开发者使用心得
"使用 PromptX 的开发体验真的非常不一样。我们团队基于 Claude Code 并结合 PromptX，一位开发者仅三天内就完成了超过一万一千行的高质量 Java 代码。
这套工作流的价值在实际开发中体现得淋漓尽致。PromptX 解决了 AI 使用时的许多痛点，时刻确保代码风格的统一和质量的达标，大大降低了新成员的学习成本。过去那些需要反复沟通、依靠文档传承的最佳实践，现在能够自然而然地融入到每一次代码生成中。"
📚 相关资源
- 项目地址： https://github.com/LegacyLands/legacy-lands-library
- AI集成标准与实践指南： https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md
⭐ Star增长趋势
🤝 贡献与交流
我们欢迎任何形式的贡献和反馈！
扫码加入技术交流群：
📄 许可证
MIT License - 让AI专业能力触手可及