* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* Develop (#66)

* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* fix: 统一Pouch命令路径获取机制,解决Issue #69记忆持久化问题

修复多实例MCP环境下的路径不一致问题:
- RememberCommand: 使用ResourceManager替代DirectoryService直接调用
- RecallCommand: 使用ResourceManager替代DirectoryService直接调用
- RegisterCommand: 使用ResourceManager+DirectoryService统一路径获取

核心改进:
1. 所有命令现在使用相同的getGlobalResourceManager()初始化
2. 通过resourceManager.initializeWithNewArchitecture()确保路径一致性
3. 实现"要对一起对,要错一起错"的一致性原则

测试验证:
- 记忆写入和读取使用相同项目路径
- 多实例环境下路径解析行为完全一致
- 向后兼容,无破坏性变更

Fixes #69

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Develop (#70)

* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* fix: 统一Pouch命令路径获取机制,解决Issue #69记忆持久化问题

修复多实例MCP环境下的路径不一致问题:
- RememberCommand: 使用ResourceManager替代DirectoryService直接调用
- RecallCommand: 使用ResourceManager替代DirectoryService直接调用
- RegisterCommand: 使用ResourceManager+DirectoryService统一路径获取

核心改进:
1. 所有命令现在使用相同的getGlobalResourceManager()初始化
2. 通过resourceManager.initializeWithNewArchitecture()确保路径一致性
3. 实现"要对一起对,要错一起错"的一致性原则

测试验证:
- 记忆写入和读取使用相同项目路径
- 多实例环境下路径解析行为完全一致
- 向后兼容,无破坏性变更

Fixes #69

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

* doc: 新增“女娲”使用心得 (#73)

* feat:添加女娲的使用心得
refactor:readme最新版本同步到英文版

* docs: 添加社区教程与案例部分,包含基于PromptX架构的MCP工具开发实践经验

* Staging (#71)

* Develop (#66)

* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* Develop (#70)

* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* fix: 统一Pouch命令路径获取机制,解决Issue #69记忆持久化问题

修复多实例MCP环境下的路径不一致问题:
- RememberCommand: 使用ResourceManager替代DirectoryService直接调用
- RecallCommand: 使用ResourceManager替代DirectoryService直接调用
- RegisterCommand: 使用ResourceManager+DirectoryService统一路径获取

核心改进:
1. 所有命令现在使用相同的getGlobalResourceManager()初始化
2. 通过resourceManager.initializeWithNewArchitecture()确保路径一致性
3. 实现"要对一起对,要错一起错"的一致性原则

测试验证:
- 记忆写入和读取使用相同项目路径
- 多实例环境下路径解析行为完全一致
- 向后兼容,无破坏性变更

Fixes #69

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

* 更新README文件,替换女娲创造工坊的logo图片,添加社区教程与案例部分,展示基于PromptX架构的MCP工具开发经验,提升内容的可读性和用户体验。

* 更新README文件,优化“女娲”功能的描述,强调其无需编程知识即可使用的便利性,并介绍其创建“小红书营销”专家的能力,提升内容的清晰度和用户体验。

---------

Co-authored-by: Sean <sean@deepracticex.com>
Co-authored-by: coso <wutongci@example.com>
Co-authored-by: Claude <noreply@anthropic.com>

* refactor: 优化DACP工具提示词,去除诱导性描述

- 将DACP工具描述从功能介绍改为使用条件
- 强调需要专业知识才能正确使用
- 避免AI在不了解服务配置时盲目尝试
- 符合"先学会使用工具再做事"的设计理念

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Optimize:优化女娲提示词,为 Sean 添加 Github Issues 矛盾分析方法论

* fix: 修复 这几个命令使用了废弃的项目路径定位方案

* Optimize: 优化 sean 提示词

* Optimize: 优化 sean 提示词

* 删除产品子项目文件

* 🚀 feat: 记忆系统架构升级 + declarative.dpml命名重构 + MCP边界条件Bug修复

## 📊 变更概览
- declarative.dpml架构升级:memory.xml → declarative.dpml (认知科学语义精准)
- MCP环境边界条件Bug修复:解决空文件导致的记忆保存失败问题
- 跨项目角色发现Bug修复:优化环境检测顺序,MCP环境角色发现从1个→9个
- XML转义处理增强:完整的存储-显示分离架构,数据安全+用户友好

## 🎯 核心成就
 declarative.dpml升级:100%测试验证通过
 边界条件修复:三重保护机制,文件状态自动检测修复
 角色发现修复:环境检测顺序优化,跨项目使用稳定
 存储分离架构:XML转义安全存储 + AI友好显示

## 📁 主要文件变更
- RememberCommand.js/RecallCommand.js: declarative.dpml升级 + 边界条件修复
- PackageDiscovery.js: 环境检测顺序优化
- 新增思维模式文件: recall-xml.thought.md, remember-xml.thought.md
- 新增测试: memory-dpml-integration.test.js
- 完整文档: PR文档 + Bug报告 + 修复总结

🎉 架构升级验证:MCP重启测试100%通过,零中断平滑切换

* fix: 修复记忆时的问题处理合并的问题

* fix: 系统化优化角色输出显示,解决角色名称混淆问题

- 优化WelcomeCommand输出格式,角色列表显示为 `id` - name 格式
- 优化ActionCommand输出格式,激活成功时显示 `id` (name) 格式
- 更新package.registry.json中7个角色的name和description:
  * nuwa: "Nuwa 角色" → "女娲",描述更新为专业的角色创造能力
  * sean: "Sean 角色" → "Sean",描述更新为CEO身份
  * product-manager: 更新为"产品经理",描述强调价值平衡能力
  * java-backend-developer: 更新为"Java后端开发工程师",描述强调架构能力
  * frontend-developer: 更新为"前端开发工程师",描述强调用户体验
  * xiaohongshu-marketer: 更新为"小红书营销专家",描述强调平台运营
  * assistant: 更新为"总经理秘书",描述强调执行和协调能力
- 解决角色名称显示不一致和描述过于通用的问题
- 提升用户体验,避免角色身份混淆

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: noface角色重命名及file://协议路径转换优化

## 主要变更
- **角色重命名**: wumian → noface,更符合英文命名规范
- **file://协议优化**: 新增FileProtocol.js支持本地文件访问
- **路径转换修复**: 智能处理Shell反斜杠转义问题
- **ResourceManager增强**: 支持基础协议直接处理

## 技术改进
- 修复复杂路径格式兼容性(如WeChat路径、中文字符、特殊符号)
- 自动清理反斜杠转义符(Application\ Support → Application Support)
- 完善错误处理机制和用户提示

## 文件变更
- 新增: noface角色完整文件结构(role + 2个execution文件)
- 新增: FileProtocol.js协议处理器
- 更新: ResourceManager.js基础协议支持
- 更新: package.registry.json角色注册信息

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: 重新定位产品价值主张,强化AI上下文工程概念

核心改进:
- 🎯 主标题改为「领先的AI上下文工程平台」蹭技术热点
-  引入「Chat is all you need」革命性交互理念
- 🚀 前置强力案例数据(11000行代码、40小时→30分钟)
- 🎭 重新包装核心能力,突出专业价值

产品战略价值:
- 结合AI上下文工程趋势,提升技术定位
- 通过真实数据建立社会证明
- 降低技术理解门槛,扩大目标用户群

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 重构社区章节和案例展示

核心改进:
- 🌟 新增「Deepractice深度实践社区」愿景展示
- 🎯 突出「AI时代Life Style」定位和「君子和而不同」价值观
- 🏗️ 重新设计社区资源架构:开源产品+开发者舞台+商业共建
- 📋 移动案例到最后,重命名为「社区优质案例分享」
- 🤝 简化「加入我们」为纯二维码展示

产品战略价值:
- 从工具项目升华为AI时代生活方式社区
- 建立开放包容的商业合作模式(内容换价值)
- 为社区可持续发展和商业化提供健康路径

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: 全面优化社区价值体系和README结构

## 主要变更
- **社区定位升级**:从"AI时代Life Style"优化为"AI原生Life Style社区"
- **价值观体系重构**:技术开源·内容分享·社区开放·价值交换四维度
- **社区价值机制**:构建注意力价值交换+商业价值交换双重生态
- **内容展示优化**:社区案例分享格式精简,提升阅读体验
- **精神内核明确**:突出"实践·协作·创新"的社区精神

## 技术改进
- 移除冗余的传统企业级展示模式
- 优化信息架构,突出价值交换核心理念
- 精简社区案例展示,提升信息密度
- 强化AI原生社区的独特定位

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: 添加安装成功示意图

- 新增 assets/install-success.jpg 用于展示MCP工具安装成功效果
- 完善README中的安装成功确认章节视觉展示

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: AgustD <100462005+lsh2002@users.noreply.github.com>
Co-authored-by: coso <wutongci@example.com>
Co-authored-by: Cen-Yaozu <80613496+Cen-Yaozu@users.noreply.github.com>
This commit is contained in:
Sean
2025-06-28 12:00:31 +08:00
committed by GitHub
parent 2954cd5354
commit 5ae13c566a
35 changed files with 4274 additions and 764 deletions

335
README.md
View File

@ -1,7 +1,9 @@
<div align="center">
<img src="assets/logo/Creative PromptX Duck Logo 4.svg" alt="PromptX Logo" width="120" height="120"/>
<h1>PromptX · AI应用原生专业能力增强系统</h1>
<p>通过MCP协议为AI应用提供专业角色、记忆管理和知识体系一行命令让任何 AI 客户端秒变专业选手。</p>
<h1>PromptX · 领先的AI上下文工程平台</h1>
<h2>✨ Chat is all you need - 革命性交互设计让AI Agent秒变行业专家</h2>
<p><strong>核心功能模块:</strong><a href="https://github.com/Deepractice/dpml">提示词结构化协议</a> | <a href="https://github.com/Deepractice/PATEOAS">AI状态化协议</a> | 记忆系统 | 女娲角色工坊 | 鲁班工具工坊</p>
<p>基于MCP协议一行命令为Claude、Cursor等AI应用注入专业能力</p>
<!-- Badges -->
<p>
@ -20,52 +22,66 @@
---
### **一眼看懂 PromptX**
### 🚀 **实力证明 - 真实案例数据**
PromptX 能做什么?简单来说,它让你的 AI 助手拥有了"大脑"和"记忆"更让你成为AI能力的创造者。
> **"使用 PromptX一位开发者仅三天内完成了超过一万一千行的高质量 Java 代码"**
> —— Legacy Lands 制作组核心开发者
- **🎭 专业角色扮演**: 提供覆盖不同领域的专家角色,让 AI 的回答更专业、更深入。
- **🧠 长期记忆与知识库**: AI能够记住关键信息和你的偏好在持续的对话和工作中提供连贯、个性化的支持。
- **✨ AI角色创造工坊**: **2分钟内**将你的想法变成专业AI助手从使用者到创造者的华丽转身。
- **🔌 轻松集成**: 只需一行命令,即可为数十种主流 AI 应用(如 Claude、Cursor无缝启用这些强大功能。
> **"MCP开发时间从40小时缩短到30分钟"**
> —— 社区开发者 coso
<br/>
### 📸 **配置成功后的使用效果**
### 💬 **Chat is All you Need - 看看对话如何改变一切**
#### **1. 发现并激活专业角色**
*使用 `promptx_welcome` 发现可用角色,再用 `promptx_action` 激活AI即刻变身领域专家。*
<img src="assets/role-discovery.png" alt="角色发现与激活" width="80%">
#### **1. 对话发现专业角色**
*只需一句话"我要发现可用角色"AI就会展示所有可用的专业领域*
<img src="assets/role-discovery.png" alt="Chat方式发现角色" width="80%">
#### **2. 拥有智能记忆**
*使用 `promptx_remember` 保存关键信息AI将在后续的交流中主动运用这些知识。*
<img src="assets/remember.png" alt="记忆功能" width="80%">
#### **2. 对话选择专业角色**
*看到感兴趣的专家后,直接说"激活XX专家"即可瞬间转换AI身份*
<img src="assets/role-select.png" alt="Chat方式选择激活角色" width="80%">
---
#### **3. 对话管理智能记忆**
*说一句"记住这个重要信息"AI就会自动保存下次对话时主动运用这些知识*
<img src="assets/remember.png" alt="Chat方式管理记忆" width="80%">
## ⚠️ **项目状态说明**
#### **💡 重要把AI当人不是软件**
PromptX 目前处于 **初始开发阶段**,我们正在积极完善功能和修复问题。在达到正式稳定版本之前,您可能会遇到一些使用上的问题或不稳定情况。
看完上面的演示,你可能还在想:"具体应该说什么指令?"
**我们诚恳地请求您的理解和支持!** 🙏
**❌ 请停止这样想:**
> "什么指令能激活角色?" | "正确的命令是什么?" | "我说错了会不会失效?"
### 📞 **遇到问题?获取帮助!**
**✅ 正确的使用心态:**
> "就像和真人专家聊天一样自然" | "想到什么就说什么AI会理解你的意图" | "听不懂?换个说法再说一遍就行"
如果您在使用过程中遇到任何问题,请通过以下方式联系我们:
**🎯 实际例子对比:**
```
❌ 软件思维:请执行 promptx_action java-developer
✅ 人际思维我需要一个Java开发专家
✅ 人际思维帮我找个懂Java的专家
✅ 人际思维我要和Java大牛聊聊
✅ 人际思维切换到Java开发模式
```
- 🐛 **提交 Issue**: [GitHub Issues](https://github.com/Deepractice/PromptX/issues) - 详细描述问题,我们会尽快回复
- 💬 **直接联系**: 添加开发者微信 `deepracticex` 获取即时帮助
- 📧 **邮件联系**: 发送邮件至 `sean@deepracticex.com` 获取技术支持
- 📱 **技术交流群**: 扫描下方二维码加入我们的技术交流群
您的反馈对我们非常宝贵,帮助我们快速改进产品质量! ✨
**💬 Chat is All you Need 的真正含义:**
- 🗣️ **自然表达** - 想怎么说就怎么说,就像和朋友聊天
- 🔄 **灵活调整** - AI没听懂换个说法继续说
- 🤖 **信任AI** - 相信AI能理解你的真实意图不必拘泥于"标准用法"
- 💬 **持续对话** - 把每次交互当成和专家的连续对话,而不是一次性命令
---
## 🚀 **一键启动30秒完成配置**
### ⚙️ **快速配置**
**📋 前置要求:** 确保已安装 [Node.js](https://nodejs.org/zh-cn)(建议 v18 及以上版本)
打开配置文件,将下面的 `promptx` 配置代码复制进去。这是最简单的 **零配置模式**PromptX 会自动为您处理一切。
**推荐配置beta公测版**
```json
{
"mcpServers": {
@ -84,8 +100,47 @@ PromptX 目前处于 **初始开发阶段**,我们正在积极完善功能和
}
```
<details>
<summary>📦 <strong>其他版本配置</strong></summary>
**Alpha内测版最新功能**
```json
{
"mcpServers": {
"promptx": {
"command": "npx",
"args": ["-y", "-f", "--registry", "https://registry.npmjs.org", "dpml-prompt@alpha", "mcp-server"]
}
}
}
```
**Latest正式版最高稳定性**
```json
{
"mcpServers": {
"promptx": {
"command": "npx",
"args": ["-y", "-f", "--registry", "https://registry.npmjs.org", "dpml-prompt@latest", "mcp-server"]
}
}
}
```
</details>
### 📋 **发布渠道说明**
根据你的使用需求选择合适的版本:
| 🏷️ **渠道** | 📊 **稳定性** | 🎯 **适用场景** | 📦 **配置** |
|---------|---------|------------|---------|
| **alpha** | 内测版 ⚡ | 尝鲜最新功能,参与测试反馈 | `dpml-prompt@alpha` |
| **beta** | 公测版 🧪 | 功能相对稳定,适合日常使用 | `dpml-prompt@beta` |
| **latest** | 正式版 ✅ | 生产环境,追求最高稳定性 | `dpml-prompt@latest` |
**配置参数说明:**
- `command`: 指定使用 npx 运行 promptx 服务
- `command`: 指定使用 npx 运行 promptx 服务npx 随 Node.js 自动安装)
- `args`: 启动参数配置列表
- `-y`: 自动确认
- `-f`: 强制刷新缓存
@ -98,55 +153,38 @@ PromptX 目前处于 **初始开发阶段**,我们正在积极完善功能和
> **💡 提示:** 配置中特意指定了官方镜像源 `registry.npmjs.org`,这可以避免因使用非官方镜像导致的安装问题。如果您发现安装很慢,建议使用代理工具加速,而不是切换到其他镜像源。
### ✅ **安装成功确认**
配置完成并重启AI应用后当你看到以下MCP工具出现时即代表PromptX安装成功
<img src="assets/install-success.jpg" alt="PromptX MCP工具安装成功示意图" width="80%">
看到这些工具说明PromptX已成功连接现在就可以开始使用"Chat is All you Need"的体验了。
📖 **[完整安装配置指南](https://github.com/Deepractice/PromptX/wiki/PromptX-MCP-Install)** - 包含各种客户端的详细配置方法和故障排除
### 不知道MCP是怎么 [点击查看 MCP幼儿园教程 BiliBili](https://www.bilibili.com/video/BV1HFd6YhErb)
### 不知道MCP是什么 [点击查看 MCP幼儿园教程 BiliBili](https://www.bilibili.com/video/BV1HFd6YhErb)
目前所有支持 MCP 协议的 AI 客户端都可以使用 PromptX。主要包括**Claude Desktop**、**Cursor**、**Windsurf**、**Cline**、**Zed**、**Continue** 等主流 AI 编程工具,以及更多正在接入中的应用。
---
### ⚙ **工作原理**
## **项目状态说明**
PromptX 作为您和AI应用之间的"专业能力中间件",通过标准的 [MCP协议](https://github.com/metacontroller/mcp) 进行通信
PromptX 目前处于 **初始开发阶段**,我们正在积极完善功能和修复问题。在达到正式稳定版本之前,您可能会遇到一些使用上的问题或不稳定情况
```mermaid
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
```
- 🐛 **提交 Issue**: [GitHub Issues](https://github.com/Deepractice/PromptX/issues) - 详细描述问题,我们会尽快回复
- 💬 **直接联系**: 添加开发者微信 `deepracticex` 获取即时帮助
- 📧 **邮件联系**: 发送邮件至 `sean@deepracticex.com` 获取技术支持
- 📱 **技术交流群**: 扫描下方二维码加入我们的技术交流群
当您调用 `promptx_...` 系列工具时AI应用会将请求通过MCP协议发送给 PromptX。PromptX 引擎会加载相应的专业角色、检索相关记忆然后返回一个经过专业能力增强的结果给AI应用最终呈现给您。
---
**🎯 配置完成后您的AI应用将自动获得6个专业工具**
- `promptx_init`: 🏗️ **系统初始化** - 自动准备工作环境。
- `promptx_hello`: 👋 **角色发现** - 浏览所有可用的专家角色。
- `promptx_action`: ⚡ **角色激活** - 一键变身指定领域的专家。**(含女娲🎨角色创造顾问)**
- `promptx_learn`: 📚 **知识学习** - 让AI学习特定的知识或技能。
- `promptx_recall`: 🔍 **记忆检索** - 从记忆库中查找历史信息。
- `promptx_remember`: 💾 **经验保存** - 将重要信息存入长期记忆。
📖 **[查看完整MCP集成指南](docs/mcp-integration-guide.md)**
您的反馈对我们非常宝贵,帮助我们快速改进产品质量! ✨
---
@ -217,72 +255,129 @@ graph TD
---
## 📋 **实践案例: Legacy Lands Library**
<div align="center">
<img src="https://raw.githubusercontent.com/LegacyLands/legacy-lands-library/main/logo.png" alt="Legacy Lands Library Logo" width="120" style="border-radius: 10px; margin: 15px 0 25px 0;">
</div>
#### 📖 项目概述
**项目名称:** Legacy Lands Library
**项目地址:** https://github.com/LegacyLands/legacy-lands-library
**项目简介:** legacy-lands-library 是一个面向现代 Minecraft 服务端插件开发的开发工具库。它旨在为开发者提供一个跨平台、生产就绪的基础设施。
#### 🏢 组织信息
**组织名称:** 遗迹之地制作组 (Legacy Lands)
**官方网站:** https://www.legacylands.cn/
**组织简介:** 遗迹之地 (Legacy Lands) 是一个专注于构建大型 Minecraft 文明模拟体验的创新团队。参与开源社区,为 Minecraft 服务端插件等领域开发提供优雅、高效且可靠的解决方案。
> #### **💡 核心开发者使用心得**
> "使用 PromptX 的开发体验真的非常不一样。我们团队基于 Claude Code 并结合 PromptX**一位开发者仅三天内就完成了超过一万一千行的高质量 Java 代码。**
>
> 这套工作流的价值在实际开发中体现得淋漓尽致。PromptX 解决了 AI 使用时的许多痛点,时刻确保代码风格的统一和质量的达标,大大降低了新成员的学习成本。过去那些需要反复沟通、依靠文档传承的最佳实践,现在能够自然而然地融入到每一次代码生成中。"
#### **📚 相关资源**
- **AI集成标准与实践指南** https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md
---
## 📚 **社区教程与案例**
社区成员 **coso** 基于 PromptX 架构开发了 MCP 工具,并分享了完整的开发经验:
#### 🔧 **使用 PromptX 架构开发 crawl-mcp 工具**
- **文章**[从想法到产品我如何用Cursor Agent开发出智能内容处理MCP工具](https://mp.weixin.qq.com/s/x23Ap3t9LBDVNcr_7dcMHQ)
- **成果**[crawl-mcp-server](https://www.npmjs.com/package/crawl-mcp-server) - NPM包 | [GitHub](https://github.com/wutongci/crawl-mcp)
- **亮点**:以 PromptX 为架构参考,实现零代码开发,几小时完成从想法到发布
#### 🛠️ **MCP 开发模板化实践**
- **文章**[从零代码到开源我如何用模板革命MCP开发](https://mp.weixin.qq.com/s/aQ9Io2KFoQt8k779L5kuuA)
- **成果**[mcp-template](https://github.com/wutongci/mcp-template) - 通用MCP开发模板
- **价值**:将 MCP 开发时间从 40 小时缩短到 30 分钟
> 💡 欢迎社区成员分享基于 PromptX 的实践经验,提交 PR 添加到此处。
---
## ⭐ **Star增长趋势**
[![Star History Chart](https://api.star-history.com/svg?repos=Deepractice/PromptX&type=Date)](https://star-history.com/#Deepractice/PromptX&Date)
---
### **🤝 贡献与交流**
我们欢迎任何形式的贡献和反馈!
## 🌟 **Deepractice 深度实践社区**
- 🌿 **[分支策略](docs/BRANCHING.md)** - 分支管理和发布流程
- 🚀 **[发布流程](docs/RELEASE.md)** - 版本管理和发布文档
<div align="center">
<h3>🎯 打造AI原生Life Style社区</h3>
<p><em>"实践 · 协作 · 创新"</em></p>
</div>
扫码加入技术交流群:
### 💫 **社区愿景**
<img src="assets/qrcode.jpg" alt="技术交流群" width="200">
AI不仅仅是技术工具更是重新定义生活方式的革命力量。我们致力于打造AI原生的Life Style社区汇聚各领域的实践者
- **🏠 生活** - 分享AI原生的生活方式和日常实践经验
- **📚 学习** - 构建AI时代的知识体系和学习方法论
- **💼 工作** - 探索AI原生的工作模式和协作范式
- **🚀 创业** - 孵化AI原生的商业模式和创新项目
### ⚖️ **价值观**
- 🔓 **技术开源** - 代码和技术方案开放共享让AI能力触手可及
- 📚 **内容分享** - 知识和经验无私传播,共建智慧生态
- 🌐 **社区开放** - 不设门槛壁垒欢迎所有AI实践者参与
- 💰 **价值交换** - 商业服务基于公平交换,拒绝竭泽而渔
### 🎁 **社区价值**
我们构建基于**注意力价值交换**的社区生态,让每个参与者都能获得价值:
#### 🎯 **内容生态供给**
**开源产品与优质内容**,促进社区知识共享:
- 🛠️ **技术产品**PromptX、DPML、PATEOAS等开源工具
- 📚 **实践内容**AI工作流、最佳实践、案例分享
- 🎓 **学习资源**:教程、方法论、技能指南
- 💡 **创新思路**:前沿探索、商业洞察、未来趋势
#### 👥 **注意力价值支持**
**内容价值 ↔ 流量价值**,社区成员的关注为创造者提供基础曝光:
- 🔍 **内容发现**:优质内容获得社区推荐和传播
- 💬 **互动反馈**:真实用户的使用体验和改进建议
- 🤝 **协作机会**:寻找志同道合的合作伙伴
- 🚀 **项目孵化**:利用社区影响力助力项目起步
#### 💰 **商业价值交换**
**内容价值 ↔ 货币价值**,支持优质创造者的可持续发展:
- 📊 **付费内容**:深度教程、专业咨询、定制方案
- 🎯 **服务变现**:技术服务、项目合作、专家指导
- 🚀 **产品推广**:基于价值贡献的商业展示机会
- 💡 **创新孵化**:优质项目的商业化路径支持
#### ⚖️ **价值交换原则**
- **价值优先**:内容质量决定获得的注意力和商业资源
- **公平交换**:贡献与收获成正比,拒绝割韭菜行为
- **生态共建**:每个人既是内容消费者,也是价值创造者
- **可持续发展**:支持创造者通过优质内容获得合理收益
### 🤝 **加入我们**
<div align="center">
<img src="assets/qrcode.jpg" alt="Deepractice深度实践社区" width="200">
</div>
---
## 📄 **许可证**
## 🏆 **社区优质案例分享**
### 📋 **企业级应用案例**
#### **🎮 Legacy Lands Library - Minecraft开发工具库**
<div align="center">
<img src="https://raw.githubusercontent.com/LegacyLands/legacy-lands-library/main/logo.png" alt="Legacy Lands Library Logo" width="120" style="border-radius: 10px; margin: 15px 0 25px 0;">
</div>
**项目简介:** 面向现代 Minecraft 服务端插件开发的生产级工具库
**项目地址:** https://github.com/LegacyLands/legacy-lands-library
**组织官网:** https://www.legacylands.cn/
> **💡 核心开发者使用心得**
>
> "使用 PromptX 的开发体验真的非常不一样。我们团队基于 Claude Code 并结合 PromptX**一位开发者仅三天内就完成了超过一万一千行的高质量 Java 代码。**
>
> 这套工作流的价值在实际开发中体现得淋漓尽致。PromptX 解决了 AI 使用时的许多痛点,时刻确保代码风格的统一和质量的达标,大大降低了新成员的学习成本。"
>
> "女娲让我使用 AI 角色更加方便、快捷我只需要用大白话告诉女娲我想要什么它就能帮我创造出专业的AI助手效率和专业度都大大提升。"
**相关资源:** [AI集成标准与实践指南](https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md)
---
### 🛠️ **社区优秀内容分享**
#### **🔧 crawl-mcp-server** - 智能内容处理工具,几小时完成从想法到发布
**作者:** coso | **链接:** [开发经验分享](https://mp.weixin.qq.com/s/x23Ap3t9LBDVNcr_7dcMHQ) | [NPM](https://www.npmjs.com/package/crawl-mcp-server)
#### **🎯 mcp-template** - MCP开发模板将开发时间从40小时缩短到30分钟
**作者:** coso | **链接:** [开发经验分享](https://mp.weixin.qq.com/s/aQ9Io2KFoQt8k779L5kuuA) | [GitHub](https://github.com/wutongci/mcp-template)
#### **🧠 feishu-mcp** - 解决跨AI工具记忆丢失问题的零门槛方案
**作者:** 社区成员 | **链接:** [应用分享](https://mp.weixin.qq.com/s/TTl3joJYR2iZU9_NSI2Hbg) | [NPM](https://www.npmjs.com/package/@larksuiteoapi/lark-mcp)
#### **🎓 AI教育专家团队** - 多角色协作生成高质量系统性教育内容
**作者:** 社区教育工作者 | **链接:** [创新分享](https://mp.weixin.qq.com/s/8mAq1r5kqAOJM1bmIWlYbQ)
---
### 🌟 **分享你的案例**
我们诚挚邀请社区成员分享AI实践经验
- 📝 **提交方式** - 通过 PR 添加你的案例到此处
- 🎯 **分享内容** - 项目介绍、使用心得、效果数据、经验总结
- 🏆 **展示平台** - 在这里展示你的创新成果,获得社区认可
- 🤝 **互相学习** - 与其他实践者交流经验,共同成长
> **让每个优质案例都成为社区的财富!**
[MIT License](LICENSE) - 让AI专业能力触手可及