AI Agent Context Platform

PromptX

AI上下文工程平台调研报告

角色体系 · 实现原理 · 技术架构

DeepracticeX 社区

目录

01

Platform Overview

平台概述

02

Role System

核心角色体系

03

Relationships

角色关系分析

04

Implementation

实现原理剖析

05

Architecture

技术架构详解

06

Summary & Outlook

总结与展望

调研目标

深入了解 PromptX 平台的角色体系、实现原理和技术架构,为AI上下文工程实践提供技术参考。

6+
核心角色
84
资源类型
3
核心能力
5203
默认端口
01

平台概述

Platform Overview

什么是 PromptX?

PromptX 是由 Deepractice 社区开发的领先的 AI 智能体上下文平台,基于 MCP(Model Context Protocol)协议构建。

核心理念:"Chat is All You Need" —— 通过自然对话让 AI 从通用工具变身为行业专家。

认知记忆

基于认知心理学的记忆体系,让角色真正拥有灵魂

语义网络 + 扩散激活 + DMN模式

工具生态

通过鲁班制作工具,给角色提供行动能力

Excel · Word · PDF · 文件系统

平台特点

多平台部署
协议化设计
开源开放

三大核心能力

1
角色创造
女娲:AI角色设计师
2
工具集成
鲁班:工具集成大师
3
记忆系统
认知记忆网络
设计理念

"将 AI 视为人,而非软件"

通过自然对话完成一切操作,无需学习复杂的命令语法或参数配置,PromptX 理解你的意图,并瞬间将 AI 转变为你所需的专家。

02

核心角色体系

Core Role System

女娲 (Nuwa)

AI Role Designer

核心定位

AI角色设计师,通过自然语言创建专业AI角色

能力特点
  • • 深度掌握DPML协议
  • • 模板化角色设计
  • • 2-3分钟快速生成
创建流程
ISSUE范式:Initiate → Structure → Socratic → Unify → Execute
示例:"我需要懂代码和产品的专家" → 生成技术产品经理角色

鲁班 (Luban)

Tool Integration Master

核心定位

工具集成大师,3分钟内连接任何API或服务

集成能力
  • • Slack/Teams 通知
  • • PostgreSQL 查询
  • • OpenAI API 链接
安全机制
沙盒验证 + 权限控制 + 安全约束
特点:YAML配置 + 参数验证 + 安全沙盒

Writer

Professional Content Creator

核心定位

专业内容创作者,具备反AI品味和真实性思维

思维模式
  • • 反AI品味思维
  • • 真实性思考
  • • 目的驱动写作
写作能力
迭代优化 · 读者共情 · 价值聚焦
特色:避免AI腔,追求真实感和人文关怀
02

其他重要角色

Other Important Roles

S

Sean

Product Strategist

专业领域

产品战略、决策支持、协作分析

思维模式
认知系统 矛盾分析 问题建模
核心:基于认知心理学的问题解决专家
A

Assistant

General Purpose

角色定位

通用助手角色,基础对话和问题解答

执行能力
  • • 桥接设计模式
  • • 交付标准规范
  • • 集成工作流
用途:默认基础角色,适合日常对话
N

NoFace

Special Agent

特殊定位

特殊任务执行角色,角色创建和修改工作流

核心能力
  • • 自适应学习
  • • 内容保护
  • • 工作流执行
场景:系统级任务和特殊操作
角色资源统计
基于资源包扫描结果
6
角色资源
37
思维模式
15
执行工作流
03

角色关系分析

Role Relationships

三层架构关系

1
女娲创造角色(造物主)
2
鲁班提供工具(赋能者)
3
记忆系统赋予灵魂(认知层)

角色协作模式

  • 用户 → 女娲:描述需求,创建专属角色
  • 用户 → 鲁班:请求工具集成,扩展能力
  • 角色 → 记忆:积累经验,越用越好用

设计哲学

复用人类协作经验,拟人化底层逻辑,让AI自发涌现协作能力

04

实现原理剖析

Implementation Details - MCP Protocol

MCP 协议架构

Model Context Protocol(模型上下文协议)是PromptX的核心通信基础,采用JSON-RPC 2.0标准,实现AI应用与PromptX引擎的标准化交互。

5203
默认端口
HTTP
传输协议
Streamable
会话模式

协议握手阶段

  • 1. 初始化连接(initialize)
  • 2. 能力发现(tools/list)
  • 3. 能力注册(capability registration)

通信阶段

  • 1. 提示词分析与工具选择
  • 2. 权限获取与用户确认
  • 3. 工具执行与结果返回

配置示例

// Claude/Cursor MCP配置
"mcpServers"
: {
"promptx"
: {
"type"
:
"streamable-http"
,
"url"
:
"http://127.0.0.1:5203/mcp"

}
}

6大核心工具

promptx_init
系统初始化
promptx_hello
角色发现
promptx_action
角色激活
04

认知记忆系统

Cognitive Memory System

不是RAG,而是真正的AI记忆

PromptX实现了受人类记忆机制启发的认知记忆系统,通过语义网络、扩散激活和默认模式网络(DMN)实现真正的AI记忆。

语义网络
概念关联
扩散激活
记忆召回
DMN模式
探索思维

记忆存储机制:Engram(印痕)

每个Engram保存完整的记忆痕迹,而非碎片化文本,保留上下文和语义结构。

存储内容
  • • 原始经验数据
  • • 语义结构信息
  • • 上下文环境
网络构建
  • • 概念自动连接
  • • 语义关系权重
  • • 知识图谱形成

扩散激活算法

1
查询触发

用户问题触发网络中的相关节点

2
激活传播

通过网络连接传播激活信号

3
记忆浮现

相关记忆通过权重计算浮出表面

记忆系统优势

跨会话长期记忆,避免灾难性遗忘
语义理解,而非简单的文本匹配
角色越用越好用,个性化成长
网络激活带来类人的直觉联想
04

DPML 协议

Deepractice Prompt Markup Language

什么是 DPML?

DPML 是 PromptX 专用的提示词标记语言,用于定义角色、组织记忆和管理执行框架。

角色定义
记忆组织
执行框架

核心特性

机器可解析

结构化定义,确保系统兼容性

可重用模板

组织化提示词,支持继承和扩展

上下文持久化

跨对话保持状态一致性

DPML 角色定义示例

# 女娲生成的角色示例
role:
name:
"技术产品经理"

description:
"懂技术的产品经理"

expertise:

- "技术架构设计"

- "产品策略规划"

personality:

creative: true

patient: true

协议层次

1
角色层:Persona, Expertise, Personality
2
记忆层:Engrams, Networks, Weights
3
执行层:Tools, Workflows, Actions
05

技术架构详解

Technical Architecture

05

分层架构设计

Layered Architecture Design

1

服务层

• MCP Server
• Protocol Resolver
• API Clients
2

记忆层

• Graph Network
• Engram DB
• Sandbox
3

角色层

• Role Registry
• DPML Parser
• Activation System
4

工具层

• ToolX Runtime
• Sandboxed Execution
• Capability Registry

Monorepo 架构

apps/

桌面客户端、CLI工具

packages/

核心库、MCP服务器、资源配置

features/

E2E测试和步骤定义

技术栈:pnpm workspaces + Turborepo

核心包统计

@promptx/core
核心框架
@promptx/cognition
认知系统
@promptx/toolx
工具运行时
@promptx/mcp-server
MCP服务器
06

总结与展望

Summary & Future Outlook

核心创新点

拟人化设计理念

"将AI视为人,而非软件",通过自然对话完成一切操作

认知记忆系统

基于语义网络的扩散激活,实现真正的AI长期记忆

角色创造生态

女娲+鲁班双角色体系,让每个人都能创建专业AI助手

应用场景

专业顾问咨询
代码开发辅助
文档写作助手
数据分析专家

未来发展方向

1
多模态能力扩展(图像、音频、视频)
2
更多IDE和平台集成支持
3
企业级安全与权限管理
4
云端协作与团队共享功能

学术研究

已提交论文至 WWW Companion '26:

"PromptX: A Cognitive Agent Platform with Long-term Memory"

社区与生态

3.3k
GitHub Stars
281
Forks

参考资料

感谢观看