iriver/PromptX

Fork 0

Files

sean 283374bf09 优化角色注册，发现，nuwa 角色的提示词等

2025-06-11 18:03:55 +08:00

9.0 KiB

Raw Blame History

DPML语义渲染升级方案

📋 文档信息

版本: v1.0
创建时间: 2025-06-11
作者: Claude Code & Sean
优先级: High
类型: 架构升级

🎯 核心理念

@引用 = 语义占位符

DPML标签中的@引用不应该被视为"独立的资源"，而应该被理解为"语义占位符"，在渲染时在原始位置插入引用内容，保持标签的完整语义流程。

🔍 问题分析

当前实现的语义割裂

<personality>
  @!thought://remember
  
  # 网络杠精思维模式
  ## 核心思维特征
  - 挑刺思维：看到任何观点都先找问题和漏洞
  - 抬杠本能：天生反对派，习惯性质疑一切表述
  
  @!thought://recall
  
  ## 认知偏好模式
  - 逆向思考优先：遇到任何论点先想如何反驳
  - 细节放大镜效应：善于将小问题放大成大问题
</personality>

当前渲染结果（割裂的）：

## ✅ 🧠 思维模式：remember
[remember的内容 - 100行]
---

## ✅ 🧠 思维模式：recall  
[recall的内容 - 80行]
---

## ✅ 🧠 思维模式：internet-debater-personality
# 网络杠精思维模式
## 核心思维特征
- 挑刺思维：看到任何观点都先找问题和漏洞
- 抬杠本能：天生反对派，习惯性质疑一切表述

## 认知偏好模式
- 逆向思考优先：遇到任何论点先想如何反驳
- 细节放大镜效应：善于将小问题放大成大问题
---

问题：

语义割裂：完整的personality被分割成3个独立片段
位置语义丢失：@引用的位置信息完全丢失
阅读体验差：用户无法获得连贯的角色理解
违背用户意图：用户精心设计的内容组织被破坏

💡 升级方案：语义占位符渲染

核心概念

@引用 = 占位符：在标签的原始位置插入引用内容，保持完整的语义流程。

理想渲染结果（完整的）

## ✅ 🧠 完整思维模式：internet-debater

[remember的完整内容 - 100行记忆相关思维模式]

# 网络杠精思维模式
## 核心思维特征
- 挑刺思维：看到任何观点都先找问题和漏洞
- 抬杠本能：天生反对派，习惯性质疑一切表述

[recall的完整内容 - 80行回忆相关思维模式]

## 认知偏好模式
- 逆向思考优先：遇到任何论点先想如何反驳
- 细节放大镜效应：善于将小问题放大成大问题

---

优势：

语义完整性：用户看到完整连贯的personality
位置语义保持：内容按用户设计的顺序自然流淌
阅读体验优化：连贯的角色理解体验
用户意图忠实：完全按照用户的内容组织呈现

🔧 技术实现设计

1. 核心渲染算法

class SemanticRenderer {
  /**
   * 语义占位符渲染：将@引用替换为实际内容
   * @param {Object} tagSemantics - 标签语义结构
   * @param {ResourceManager} resourceManager - 资源管理器
   * @returns {string} 完整融合的语义内容
   */
  async renderSemanticContent(tagSemantics, resourceManager) {
    let content = tagSemantics.fullSemantics // 保持原始标签内容结构
    
    // 按出现顺序处理每个@引用（保持位置语义）
    for (const ref of tagSemantics.references) {
      try {
        // 解析引用内容
        const refContent = await resourceManager.resolveReference(ref)
        
        // 在原始位置替换@引用为实际内容
        content = content.replace(ref.fullMatch, refContent)
      } catch (error) {
        // 引用解析失败时的优雅降级
        content = content.replace(ref.fullMatch, `<!-- 引用解析失败: ${ref.fullMatch} -->`)
      }
    }
    
    return content.trim()
  }
}

2. DPMLContentParser扩展

class DPMLContentParser {
  // 现有方法保持不变...
  
  /**
   * 新增：获取引用的位置信息
   */
  extractReferencesWithPosition(content) {
    const resourceRegex = /@([!?]?)([a-zA-Z][a-zA-Z0-9_-]*):\/\/([a-zA-Z0-9_\/.,-]+?)(?=[\s\)\],]|$)/g
    const matches = []
    let match
    
    while ((match = resourceRegex.exec(content)) !== null) {
      matches.push({
        fullMatch: match[0],
        priority: match[1],
        protocol: match[2],
        resource: match[3],
        position: match.index, // 位置信息
        isRequired: match[1] === '!',
        isOptional: match[1] === '?'
      })
    }
    
    return matches.sort((a, b) => a.position - b.position) // 按位置排序
  }
}

3. ActionCommand升级

class ActionCommand {
  /**
   * 升级：生成语义完整的学习计划
   */
  async generateSemanticLearningPlan(roleId, dependencies) {
    const { roleSemantics } = dependencies
    const renderer = new SemanticRenderer()
    
    let content = `🎭 **角色激活完成：${roleId}** - 语义完整加载\n`
    
    // 渲染完整的personality语义
    if (roleSemantics.personality) {
      content += `# 🧠 完整思维模式：${roleId}\n`
      const personalityContent = await renderer.renderSemanticContent(
        roleSemantics.personality, 
        this.resourceManager
      )
      content += `${personalityContent}\n---\n`
    }
    
    // 渲染完整的principle语义
    if (roleSemantics.principle) {
      content += `# ⚡ 完整执行模式：${roleId}\n`
      const principleContent = await renderer.renderSemanticContent(
        roleSemantics.principle, 
        this.resourceManager
      )
      content += `${principleContent}\n---\n`
    }
    
    // 渲染完整的knowledge语义
    if (roleSemantics.knowledge) {
      content += `# 📚 完整知识体系：${roleId}\n`
      const knowledgeContent = await renderer.renderSemanticContent(
        roleSemantics.knowledge, 
        this.resourceManager
      )
      content += `${knowledgeContent}\n---\n`
    }
    
    return content
  }
}

📊 语义保障对比

升级前：语义割裂

独立片段1: remember内容 (100行)
独立片段2: recall内容 (80行)  
独立片段3: 杠精思维 (50行)

问题: 用户无法理解这些片段的组织关系

升级后：语义完整

完整personality: remember内容 + 杠精思维 + recall内容 (230行)

优势: 用户获得完整连贯的角色理解

🎯 用户体验提升

1. 内容组织忠实性

用户精心设计的内容组织得到完全保持：

引言 → @引用基础能力 → 核心特征 → @引用扩展能力 → 总结

2. 阅读连贯性

从分离的技术片段转变为连贯的角色叙述：

❌ "这个角色有3个独立的思维片段"
✅ "这个角色具有完整连贯的思维体系"

3. 角色理解深度

用户能够理解角色的完整图景，而不是零散的技能点。

🔧 实现阶段

阶段1：SemanticRenderer实现

创建语义渲染器核心类
实现占位符替换算法
支持引用解析失败的优雅降级

阶段2：DPMLContentParser扩展

添加位置信息提取
增强引用解析能力
保持向下兼容性

阶段3：ActionCommand集成

更新学习计划生成逻辑
集成语义渲染器
全面测试各种角色类型

阶段4：全系统推广

扩展到LearnCommand
更新所有Protocol类
建立统一的语义渲染标准

📝 测试策略

1. 语义完整性测试

test('应该保持@引用的位置语义', async () => {
  const content = `intro @!thought://A middle @!thought://B end`
  const rendered = await renderer.renderSemanticContent(semantics, rm)
  expect(rendered).toBe(`intro [A的内容] middle [B的内容] end`)
})

2. 复杂布局测试

test('应该处理复杂的@引用布局', async () => {
  const content = `
# 标题
@!thought://base

## 子标题  
- 列表项1
@!execution://action
- 列表项2
`
  // 验证内容在正确位置插入
})

3. 错误处理测试

test('应该优雅处理引用解析失败', async () => {
  // 验证失败时的降级策略
})

💡 长期价值

1. DPML协议语义标准

这个升级建立了DPML协议中@引用的语义标准：

@引用 = 占位符，不是独立资源
位置语义优于类型语义
用户意图优于技术实现

2. 可扩展的语义框架

为未来的DPML扩展奠定基础：

支持更复杂的引用类型
支持条件渲染
支持嵌套引用

3. 用户体验范式

从"技术驱动"转向"用户意图驱动"的设计范式。

🔗 相关文档

⚠️ 注意事项

性能考虑: 语义渲染涉及异步资源解析，需要考虑缓存策略
错误处理: 引用解析失败时的用户体验设计
兼容性: 确保现有角色的正常工作
文档更新: 用户需要了解新的语义渲染效果

这个升级将彻底解决DPML语义完整性问题，为PromptX建立真正以用户意图为中心的语义框架。

9.0 KiB Raw Blame History Unescape Escape