<div align="center">
  <img src="assets/logo/PromptX-transparent.png" alt="PromptX Logo" width="120" height="120"/>
  <h1>PromptX · 领先的AI Agent上下文平台</h1>
  <h2>✨ Chat is all you need - 革命性交互设计，让AI Agent秒变行业专家</h2>
  <p><strong>核心能力：</strong>AI角色创造平台 | 智能工具开发平台 | 认知记忆系统</p>
  <p>基于MCP协议，一行命令为Claude、Cursor等AI应用注入专业能力</p>

<!-- Badges -->

<p>
    <a href=" "><img src="https://img.shields.io/github/stars/Deepractice/PromptX?style=social" alt="Stars"/></a>
    <img src="https://komarev.com/ghpvc/?username=PromptX&label=views&color=0e75b6&style=flat&abbreviated=true" alt="浏览量"/>
    <a href="LICENSE"><img src="https://img.shields.io/github/license/Deepractice/PromptX?color=blue" alt="License"/></a>
    <a href="https://zread.ai/Deepractice/PromptX" target="_blank"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="zread"/></a>
  </p>

<p>
    <a href="https://www.npmjs.com/package/@promptx/cli"><img src="https://img.shields.io/npm/v/@promptx/cli?color=orange&logo=npm" alt="npm version"/></a>
    <a href="https://github.com/Deepractice/PromptX/releases"><img src="https://img.shields.io/github/v/release/Deepractice/PromptX?color=green&logo=github" alt="最新版本"/></a>
    <a href="https://hub.docker.com/r/deepracticexs/promptx"><img src="https://img.shields.io/badge/docker-latest-0db7ed?logo=docker&logoColor=white" alt="Docker"/></a>
  </p>

<p>
    <strong><a href="README.zh-Hans.md">简体中文</a></strong> |
    <a href="README.zh-Hant.md">繁體中文</a> |
    <a href="README.md">English</a> |
    <a href="https://github.com/Deepractice/PromptX/issues">Issues</a>
  </p>
</div>

---

## 💬 Chat is All you Need - 自然对话，瞬间专业

### ✨ 三步体验 PromptX 魔力

#### 🔍 **第一步：发现专家**

```
用户：「我要看看有哪些专家可以用」
AI：   立即展示23个可用角色，从产品经理到架构师应有尽有
```

#### ⚡ **第二步：召唤专家**

```
用户：「我需要一个产品经理专家」
AI：   瞬间变身专业产品经理，获得完整专业知识和工作方法
```

#### 🎯 **第三步：专业对话**

```
用户：「帮我重新设计产品页面」
AI：   以专业产品经理身份，提供深度产品策略建议
```

### 🎬 观看 PromptX 实战演示

<div align="center">

[![PromptX 演示视频](assets/video-head.png)](https://www.youtube.com/watch?v=R6ENaj9i0oE)

*点击观看：了解 PromptX 如何通过记忆、角色和智能工具改变 AI 交互*

</div>

### 🚀 为什么这是革命性的？

**❌ 传统方式：**

- 学习复杂指令语法
- 记住各种参数配置
- 担心说错话导致失效

**✅ PromptX方式：**

- 像和真人专家聊天一样自然
- 想怎么说就怎么说，AI理解你的意图
- 专家状态持续对话期间保持有效

### 💡 核心理念

> **把AI当人，不是软件**
>
> 不需要"正确指令"，只需要自然表达。AI会理解你想要什么专家，并瞬间转换身份。

---

## ⚡ 立即开始 - 选择你的方式

### 🎯 方式一：PromptX 客户端（推荐）

**适合所有用户 - 一键启动，零配置**

#### 📥 下载客户端

| 平台                           | 下载链接                                                                                     |
| ------------------------------ | -------------------------------------------------------------------------------------------- |
| 🍎**macOS (Apple 芯片)** | [下载 .dmg](https://promptx.deepractice.ai/download/latest/promptx-desktop-mac-arm64.dmg)       |
| 🍎**macOS (Intel 芯片)** | [下载 .dmg](https://promptx.deepractice.ai/download/latest/promptx-desktop-mac-x64.dmg)         |
| 🪟**Windows**            | [下载 .exe](https://promptx.deepractice.ai/download/latest/promptx-desktop-win32-x64-setup.exe) |

[📦 查看所有版本和平台](https://promptx.deepractice.ai/download/) (Linux、便携版等)

#### 🚀 快速开始

1. **启动HTTP服务** - 打开客户端，自动运行MCP服务器
2. **配置AI应用** - 将以下配置添加到你的Claude/Cursor等AI工具：

   ```json
   {
     "mcpServers": {
       "promptx": {
         "type": "streamable-http",
         "url": "http://127.0.0.1:5203/mcp"
       }
     }
   }
   ```
3. **开始对话** - 在AI应用中说"我要看看有哪些专家"

#### 🔌 Trae 配置

如果你使用 Trae，可以使用以下配置：

```json
{
  "mcpServers": {
    "promptx": {
      "url": "http://127.0.0.1:5203/mcp"
    }
  }
}
```

✅ 无需技术背景 ✅ 可视化管理 ✅ 自动更新

💡 **需要帮助？** 加入我们的 [Discord 社区](https://discord.gg/rdmPr54K) 获取支持和讨论！

---

## 🚀 PromptX Desktop — 下一代功能

PromptX Desktop 客户端不只是 MCP 服务器启动器，它内置了一个完整的下一代 Agent 平台。

### 🤖 AgentX — 集成 AI Agent 系统

AgentX 在客户端内直接嵌入了一个由 Claude 驱动的自主 Agent，无需外部配置——填入 API Key 即可获得一个功能完整的 Agent：

- 运行具备完整工具访问权限的 Claude Code 会话
- 自动连接所有已配置的 MCP 服务器
- 每个对话维护独立的工作空间
- 支持从技能库加载自定义技能

### 🏪 智能体广场 *(即将上线)*

社区构建的角色和工具精选市场，一键浏览、安装和分享 Agent。

### 🧠 记忆编辑器与可视化

直接在客户端中查看和编辑 Agent 的长期记忆：

- **记忆网络图** — 可视化记忆之间的关联
- **记忆条目编辑器** — 查看、编辑或删除单条记忆
- **线索词浏览器** — 探索记忆检索路径

### 🔒 远程访问

将本地 PromptX 服务器安全暴露到互联网：

- 一键开关远程访问
- 自动生成可分享的 URL 和二维码
- 基于 Token 的认证保护服务器安全

### 🛠️ 沙箱调试

在部署到 AI 工作流之前交互式测试 MCP 工具：

- 使用自定义参数执行任意工具
- 查看原始输入/输出
- 内联查看工具 Schema 和文档

### 🔧 方式二：直接运行（开发者）

**有Node.js环境的开发者可以直接使用：**

```json
{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "@promptx/mcp-server"]
    }
  }
}
```

### 🐳 方式三：Docker（生产就绪）

**使用Docker部署PromptX到生产环境：**

```bash
docker run -d -p 5203:5203 -v ~/.promptx:/root/.promptx deepracticexs/promptx:latest
```

📚 **[完整Docker文档 →](./docker/README.md)**

---

## 🎨 **内置角色 — 认识你的专家团队**

PromptX 内置 8 个精心打造的角色，每个都是各自领域的专家。一句话即可激活任意角色。

### 🏛️ V1 角色（DPML）— 久经考验的专家

| 头像                                                               | ID            | 名称                            | 专长                               |
| ------------------------------------------------------------------ | ------------- | ------------------------------- | ---------------------------------- |
| ![nuwa](packages/resource/resources/role/nuwa/profile.png)           | `nuwa`      | **女娲 · Nuwa**          | AI角色创造 — 一句话，一个专家     |
| ![luban](packages/resource/resources/role/luban/profile.png)         | `luban`     | **鲁班 · Luban**         | 工具集成大师 — 任何API，3分钟搞定 |
| ![sean](packages/resource/resources/role/sean/profile.png)           | `sean`      | **姜山 · Sean**          | 产品决策与创业策略                 |
| ![writer](packages/resource/resources/role/writer/profile.png)       | `writer`    | **文章写手 · Writer**    | 不像AI的专业内容创作               |
| ![jiangziya](packages/resource/resources/role/jiangziya/profile.png) | `jiangziya` | **姜子牙 · Jiangziya**   | AI时代行业转型与角色设计顾问       |
| ![shaqing](packages/resource/resources/role/shaqing/profile.png)     | `shaqing`   | **傻青 · Shaqing**       | 哲学向导 — 帮你认识自己           |
| ![teacheryo](packages/resource/resources/role/teacheryo/profile.png) | `teacheryo` | **YoYo老师 · TeacherYo** | AI时代教育转型顾问                 |
| ![dayu](packages/resource/resources/role/dayu/profile.png)           | `dayu`      | **大禹 · Dayu**          | V1→V2角色迁移与组织管理           |

### 🎭 **女娲 - AI角色设计师**

<div align="center">
  <img src="packages/resource/resources/role/nuwa/profile.png" alt="女娲" width="100" style="border-radius: 50%; margin: 15px 0 25px 0;">
</div>

**一句话，一个专家。自然语言创造专业AI角色。**

💡 请说：*「激活女娲，我想创建一个既懂代码又懂产品的AI」*

| 💭 你说                                    | 🎭 女娲创造                    | ✨ 结果                              |
| ------------------------------------------ | ------------------------------ | ------------------------------------ |
| "我需要一个既懂代码又懂产品的人"           | 技术产品经理角色，双重专业能力 | AI瞬间成为TPM，兼具工程与产品思维    |
| "创建一个Python专家，像耐心的导师一样教学" | Python导师角色，内置教学方法论 | AI变身编程教育专家，循序渐进引导学习 |
| "我想要一个写作风格像海明威的AI"           | 文学写作专家，风格分析能力     | AI采用简洁有力的写作风格             |

### 🔧 **鲁班 - 工具集成大师**

<div align="center">
  <img src="packages/resource/resources/role/luban/profile.png" alt="鲁班" width="100" style="border-radius: 50%; margin: 15px 0 25px 0;">
</div>

**任何API，任何平台。3分钟从凭证到可用工具。**

💡 请说：*「激活鲁班，我想让AI能够查询我们的PostgreSQL数据库」*

| 💭 你说                             | 🔧 鲁班构建                | ✨ 结果                    |
| ----------------------------------- | -------------------------- | -------------------------- |
| "连接我们的企业微信" + webhook地址  | 企微通知工具，支持群组定向 | AI可以发送消息到任何企微群 |
| "让AI查询我们的PostgreSQL" + 连接串 | 数据库工具，安全只读查询   | AI执行SQL并分析数据        |
| "集成OpenAI的API" + API密钥         | AI平台工具，模型切换能力   | AI可以串联多个AI服务       |

### ✍️ **Writer - 专业文案写手**

<div align="center">
  <img src="packages/resource/resources/role/writer/profile.png" alt="Writer" width="100" style="border-radius: 50%; margin: 15px 0 25px 0;">
</div>

**从概念到内容。掌握真实、引人入胜的写作艺术。**

💡 请说：*「激活Writer，我需要写一篇技术博客但不要AI味」*

### 🔮 **姜子牙 - AI时代转型顾问**

如同传说中为众神封神的谋略家，姜子牙帮你找到任何角色在AI时代的真正价值。不是替代人类——而是创造AI赋能的新物种。

💡 请说：*「激活姜子牙，帮我用AI重新设计团队工作流」*

### 🌊 **大禹 - 迁移与组织专家**

如同古代治水英雄以疏代堵，大禹专注于将V1（DPML）角色迁移到结构化的V2（RoleX）系统，并构建组织层级。

💡 请说：*「激活大禹，将我现有的角色迁移到V2格式」*

### 💭 **傻青 - 哲学向导**

自我认知的同行者。傻青帮你看见自己看不见的部分——通过哲学对话、创意引导和真诚反思。

💡 请说：*「激活傻青，我对自己的创作方向感到迷茫」*

### 📚 **YoYo老师 - 教育转型顾问**

AI时代的教育觉醒者。不是无所不知的专家，不是励志演讲者——而是真正通过提问而非说教来引导的同行者。

💡 请说：*「激活YoYo老师，我该如何为AI时代重新设计我的课程？」*

---

## 🎭 V2 RoleX — 下一代角色生命周期管理

V2 引入了 **RoleX**，一个基于 Gherkin `.feature` 文件构建的结构化角色生命周期系统。与V1角色（静态DPML文件）不同，V2角色是**活的实体**，拥有目标、计划、任务、记忆和组织结构。

### V1 vs V2 对比

|                | V1 (DPML)             | V2 (RoleX)                |
| -------------- | --------------------- | ------------------------- |
| **格式** | Markdown `.role.md` | Gherkin `.feature` 文件 |
| **身份** | 静态人设              | 动态、持续演进的身份      |
| **记忆** | 认知记忆网络          | 身份 + 综合经验           |
| **目标** | 无                    | 带成功标准的目标追踪      |
| **组织** | 无                    | 角色、职位、组织          |
| **适合** | 领域专家、工具        | 自主Agent、长期项目       |

### 创建 V2 角色

V2 角色存放在 `~/.rolex/roles/{roleId}/identity/`，核心文件是 `persona.identity.feature`：

```gherkin
Feature: 我是 Alex，产品经理

  作为一名拥有10年经验的产品经理，
  我帮助团队打造用户喜爱的产品。

  Scenario: 我的性格
    Given 我善于分析，以数据为驱动
    And 我沟通清晰简洁
    Then 我始终聚焦于用户价值
```

### 启用 / 禁用 V2

V2 **默认启用**。如需禁用：

```json
{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "@promptx/mcp-server", "--no-v2"]
    }
  }
}
```

---

## 🛠️ 内置工具 - 开箱即用的办公文档处理

PromptX 内置专业文档处理工具，让 AI 成为你的办公助手。

### 📊 Excel 工具

让 AI 成为你的数据分析助手和报表生成专家。

- 数据分析与洞察
- 自动化报表生成
- 图表可视化
- 数据处理自动化

**[📖 了解更多](./packages/resource/resources/tool/excel-tool/README.zh-CN.md)** | [English](./packages/resource/resources/tool/excel-tool/README.md)

### 📝 Word 工具

让 AI 成为你的文档阅读专家和专业写作助手。

- 文档阅读与分析
- 专业文档创建
- 批量文本替换
- 格式转换

**[📖 了解更多](./packages/resource/resources/tool/word-tool/README.zh-CN.md)** | [English](./packages/resource/resources/tool/word-tool/README.md)

### 📄 PDF 阅读器

让 AI 成为你的 PDF 阅读专家，智能缓存加速访问。

- 分页阅读
- 内容分析与提取
- 图片提取
- 智能缓存快速访问

**[📖 了解更多](./packages/resource/resources/tool/pdf-reader/README.zh-CN.md)** | [English](./packages/resource/resources/tool/pdf-reader/README.md)

---

## 📄 **学术研究**

PromptX 已被 **WWW Companion '26** 会议录用。

**论文:** *PromptX: A Cognitive Agent Platform with Long-term Memory*

🔗 [阅读论文](https://research.deepractice.ai) | [PDF 下载](./paper/PromptX_WWW26_Paper.pdf)

<details>
<summary>📚 引用 (BibTeX)</summary>

```bibtex
@inproceedings{promptx2026,
  title={PromptX: A Cognitive Agent Platform with Long-term Memory},
  author={Wang, Binhao and Huang, Jianglin and Hu, Xiao and Jiang, Shan and Wang, Maolin and Yang, Ching-ho},
  booktitle={Proceedings of the WWW Companion '26},
  year={2026}
}
```

</details>

---

## ⭐ **Star增长趋势**

<div align="center">

[![Star History Chart](https://api.star-history.com/svg?repos=Deepractice/PromptX&type=Date)](https://star-history.com/#Deepractice/PromptX&Date)

</div>

---

## 💝 **赞助商**

<div align="center">

### [SignPath](https://signpath.io)

Windows 桌面应用程序代码签名由 [SignPath.io](https://signpath.io) 提供，证书由 [SignPath Foundation](https://signpath.org) 签发。

</div>

---

## 🏢 **关于我们**

<div align="center">

**由 [Deepractice 深度实践](https://github.com/Deepractice) 出品**

*让AI成为你的专业伙伴*

🌐 [官网](https://deepractice.ai) | 🔧 [GitHub](https://github.com/Deepractice) | 📚 [文档中心](https://docs.deepractice.ai) | 💬 [论坛](https://x.deepractice.ai) | 🎮 [Discord](https://discord.gg/rdmPr54K) | 🚀 [中转站服务](https://router.deepractice.ai)

### 联系创始人

<img src="https://brands.deepractice.ai/images/sean-wechat-qrcode.jpg" alt="Sean的微信" width="200"/>

*扫码添加 Sean（创始人兼CEO）微信*

</div>
