PromptX/README.md

PromptX · 领先的AI上下文工程平台

✨ Chat is all you need - 革命性交互设计，让AI Agent秒变行业专家

核心功能模块：提示词结构化协议 | AI状态化协议 | 记忆系统 | 女娲角色工坊 | 鲁班工具工坊

基于MCP协议，一行命令为Claude、Cursor等AI应用注入专业能力

中文 | English | Issues

---

🚀 实力证明 - 真实案例数据

"使用 PromptX，一位开发者仅三天内完成了超过一万一千行的高质量 Java 代码"
—— Legacy Lands 制作组核心开发者

"MCP开发时间从40小时缩短到30分钟"
—— 社区开发者 coso

💬 Chat is All you Need - 看看对话如何改变一切

1. 对话发现专业角色

只需一句话"我要发现可用的角色"，AI就会展示所有可用的专业领域

2. 对话选择专业角色

看到感兴趣的专家后，直接说"激活XX专家"即可瞬间转换AI身份

3. 对话管理智能记忆

说一句"记住这个重要信息"，AI就会自动保存，下次对话时主动运用这些知识

💡 重要：把AI当人，不是软件

看完上面的演示，你可能还在想："具体应该说什么指令？"

❌ 请停止这样想：

"什么指令能激活角色？" | "正确的命令是什么？" | "我说错了会不会失效？"

✅ 正确的使用心态：

"就像和真人专家聊天一样自然" | "想到什么就说什么，AI会理解你的意图" | "听不懂？换个说法再说一遍就行"

🎯 实际例子对比：

❌ 软件思维：请执行 promptx_action java-developer
✅ 人际思维：我需要一个Java开发专家
✅ 人际思维：帮我找个懂Java的专家  
✅ 人际思维：我要和Java大牛聊聊
✅ 人际思维：切换到Java开发模式

💬 Chat is All you Need 的真正含义：

• 🗣️ 自然表达 - 想怎么说就怎么说，就像和朋友聊天
• 🔄 灵活调整 - AI没听懂？换个说法继续说
• 🤖 信任AI - 相信AI能理解你的真实意图，不必拘泥于"标准用法"
• 💬 持续对话 - 把每次交互当成和专家的连续对话，而不是一次性命令

---

🚀 一键启动，30秒完成配置

⚙️ 快速配置

📋 前置要求： 确保已安装 Node.js（建议 v18 及以上版本）

打开配置文件，将下面的 promptx 配置代码复制进去。这是最简单的 零配置模式，PromptX 会自动为您处理一切。

推荐配置（beta公测版）：

{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": [
        "-y",
        "-f",
        "--registry",
        "https://registry.npmjs.org",
        "dpml-prompt@beta",
        "mcp-server"
      ]
    }
  }
}

📦 其他版本配置

Alpha内测版（最新功能）：

{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "-f", "--registry", "https://registry.npmjs.org", "dpml-prompt@alpha", "mcp-server"]
    }
  }
}

Latest正式版（最高稳定性）：

{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "-f", "--registry", "https://registry.npmjs.org", "dpml-prompt@latest", "mcp-server"]
    }
  }
}

📋 发布渠道说明

根据你的使用需求选择合适的版本：

🏷️ 渠道	📊 稳定性	🎯 适用场景	📦 配置
alpha	内测版 ⚡	尝鲜最新功能，参与测试反馈	dpml-prompt@alpha
beta	公测版 🧪	功能相对稳定，适合日常使用	dpml-prompt@beta
latest	正式版 ✅	生产环境，追求最高稳定性	dpml-prompt@latest

配置参数说明：

• command: 指定使用 npx 运行 promptx 服务（npx 随 Node.js 自动安装）
• args: 启动参数配置列表
  • -y: 自动确认
  • -f: 强制刷新缓存
  • --registry: 指定镜像源
  • https://registry.npmjs.org: 使用官方镜像
  • dpml-prompt@beta: 使用稳定测试版
  • mcp-server: 启动服务

🎯 就这么简单！ 保存文件并重启您的AI应用，PromptX 就已成功激活。

💡 提示： 配置中特意指定了官方镜像源 registry.npmjs.org，这可以避免因使用非官方镜像导致的安装问题。如果您发现安装很慢，建议使用代理工具加速，而不是切换到其他镜像源。

✅ 安装成功确认

配置完成并重启AI应用后，当你看到以下MCP工具出现时，即代表PromptX安装成功：

看到这些工具说明PromptX已成功连接！现在就可以开始使用"Chat is All you Need"的体验了。

📖 完整安装配置指南 - 包含各种客户端的详细配置方法和故障排除

不知道MCP是什么？ 点击查看 MCP幼儿园教程 BiliBili

目前所有支持 MCP 协议的 AI 客户端都可以使用 PromptX。主要包括：Claude Desktop、Cursor、Windsurf、Cline、Zed、Continue 等主流 AI 编程工具，以及更多正在接入中的应用。

---

⚠️ 项目状态说明

PromptX 目前处于 初始开发阶段，我们正在积极完善功能和修复问题。在达到正式稳定版本之前，您可能会遇到一些使用上的问题或不稳定情况。

我们诚恳地请求您的理解和支持！ 🙏

📞 遇到问题？获取帮助！

如果您在使用过程中遇到任何问题，请通过以下方式联系我们：

• 🐛 提交 Issue: GitHub Issues - 详细描述问题，我们会尽快回复
• 💬 直接联系: 添加开发者微信 deepracticex 获取即时帮助
• 📧 邮件联系: 发送邮件至 sean@deepracticex.com 获取技术支持
• 📱 技术交流群: 扫描下方二维码加入我们的技术交流群

您的反馈对我们非常宝贵，帮助我们快速改进产品质量！ ✨

---

🎨 女娲创造工坊 - 让每个人都成为AI角色设计师

💫 从想法到现实，只需2分钟

你有没有想过：如果我能为特定工作场景定制一个专业AI助手会怎样？女娲让这个想法变成现实。

"每个想法都值得拥有专属的AI助手，技术的门槛不应该限制创意的飞翔。"

🎯 核心价值转换

• 🚀 零门槛创造: 无需学习复杂技术，用自然语言描述需求即可
• ⚡ 极速交付: 从想法到可用角色，全程2分钟
• 🎭 专业品质: 自动生成符合DPML标准的专业AI角色
• 🔄 即插即用: 创建完成立即可以激活使用
• 💝 掌控感: 从使用者到创造者的华丽转身

✨ 使用场景示例

🎯 用户需求	⚡ 女娲生成	🚀 立即可用
👩‍💼 "我需要一个懂小红书营销的AI助手"	小红书营销专家角色	激活小红书营销专家
👨‍💻 "我想要一个Python异步编程专家"	Python异步编程导师角色	激活Python异步编程导师
🎨 "给我一个UI/UX设计顾问"	UI/UX设计专家角色	激活UI/UX设计专家
📊 "需要一个数据分析师助手"	数据分析专家角色	激活数据分析专家

🎪 体验女娲创造力 - 4步创造专属AI助手

# 1️⃣ 激活女娲角色创造顾问
"我要女娲帮我创建一个角色"

# 2️⃣ 描述你的需求（自然语言即可）
"我需要一个[领域]的专业助手，主要用于[具体场景]"

# 3️⃣ 等待2分钟，女娲为你生成专业角色
# 女娲会创建角色文件、注册到系统、完成质量检查

# 4️⃣ 立即激活使用你的专属AI助手
"激活刚刚创建的角色"

🌟 女娲的设计哲学

• 🎯 无界创造: 让任何有想法的人都能创造AI助手，打破技术壁垒
• ⚡ 即时满足: 满足数字时代对即时性的需求
• 🧠 成长引导: 不只是工具使用，更是引导用户理解AI能力边界
• 🌱 生态共建: 每个用户创造的角色都可能成为他人的灵感源泉

---

⭐ Star增长趋势

---

🌟 Deepractice 深度实践社区

🎯 打造AI原生Life Style社区

"实践 · 协作 · 创新"

💫 社区愿景

AI不仅仅是技术工具，更是重新定义生活方式的革命力量。我们致力于打造AI原生的Life Style社区，汇聚各领域的实践者：

• 🏠 生活 - 分享AI原生的生活方式和日常实践经验
• 📚 学习 - 构建AI时代的知识体系和学习方法论
• 💼 工作 - 探索AI原生的工作模式和协作范式
• 🚀 创业 - 孵化AI原生的商业模式和创新项目

⚖️ 价值观

• 🔓 技术开源 - 代码和技术方案开放共享，让AI能力触手可及
• 📚 内容分享 - 知识和经验无私传播，共建智慧生态
• 🌐 社区开放 - 不设门槛壁垒，欢迎所有AI实践者参与
• 💰 价值交换 - 商业服务基于公平交换，拒绝竭泽而渔

🎁 社区价值

我们构建基于注意力价值交换的社区生态，让每个参与者都能获得价值：

🎯 内容生态供给

开源产品与优质内容，促进社区知识共享：

• 🛠️ 技术产品：PromptX、DPML、PATEOAS等开源工具
• 📚 实践内容：AI工作流、最佳实践、案例分享
• 🎓 学习资源：教程、方法论、技能指南
• 💡 创新思路：前沿探索、商业洞察、未来趋势

👥 注意力价值支持

内容价值 ↔ 流量价值，社区成员的关注为创造者提供基础曝光：

• 🔍 内容发现：优质内容获得社区推荐和传播
• 💬 互动反馈：真实用户的使用体验和改进建议
• 🤝 协作机会：寻找志同道合的合作伙伴
• 🚀 项目孵化：利用社区影响力助力项目起步

💰 商业价值交换

内容价值 ↔ 货币价值，支持优质创造者的可持续发展：

• 📊 付费内容：深度教程、专业咨询、定制方案
• 🎯 服务变现：技术服务、项目合作、专家指导
• 🚀 产品推广：基于价值贡献的商业展示机会
• 💡 创新孵化：优质项目的商业化路径支持

⚖️ 价值交换原则

• 价值优先：内容质量决定获得的注意力和商业资源
• 公平交换：贡献与收获成正比，拒绝割韭菜行为
• 生态共建：每个人既是内容消费者，也是价值创造者
• 可持续发展：支持创造者通过优质内容获得合理收益

🤝 加入我们

---

🏆 社区优质案例分享

📋 企业级应用案例

🎮 Legacy Lands Library - Minecraft开发工具库

项目简介： 面向现代 Minecraft 服务端插件开发的生产级工具库
项目地址： https://github.com/LegacyLands/legacy-lands-library
组织官网： https://www.legacylands.cn/

💡 核心开发者使用心得

"使用 PromptX 的开发体验真的非常不一样。我们团队基于 Claude Code 并结合 PromptX，一位开发者仅三天内就完成了超过一万一千行的高质量 Java 代码。

这套工作流的价值在实际开发中体现得淋漓尽致。PromptX 解决了 AI 使用时的许多痛点，时刻确保代码风格的统一和质量的达标，大大降低了新成员的学习成本。"

"女娲让我使用 AI 角色更加方便、快捷，我只需要用大白话告诉女娲我想要什么，它就能帮我创造出专业的AI助手，效率和专业度都大大提升。"

相关资源： AI集成标准与实践指南

---

🛠️ 社区优秀内容分享

🔧 crawl-mcp-server - 智能内容处理工具，几小时完成从想法到发布

作者： coso | 链接： 开发经验分享 | NPM

🎯 mcp-template - MCP开发模板，将开发时间从40小时缩短到30分钟

作者： coso | 链接： 开发经验分享 | GitHub

🧠 feishu-mcp - 解决跨AI工具记忆丢失问题的零门槛方案

作者： 社区成员 | 链接： 应用分享 | NPM

🎓 AI教育专家团队 - 多角色协作生成高质量系统性教育内容

作者： 社区教育工作者 | 链接： 创新分享

---

🌟 分享你的案例

我们诚挚邀请社区成员分享AI实践经验：

• 📝 提交方式 - 通过 PR 添加你的案例到此处
• 🎯 分享内容 - 项目介绍、使用心得、效果数据、经验总结
• 🏆 展示平台 - 在这里展示你的创新成果，获得社区认可
• 🤝 互相学习 - 与其他实践者交流经验，共同成长

让每个优质案例都成为社区的财富！