# 特殊标签使用说明

OMate 支持多种特殊标签来增强聊天体验,这些标签可以用于折叠内容、隐藏思维过程等功能。

# Details 和 Summary 标签

# 基本用法

<details><summary> 标签用于创建可折叠的内容区域,让您可以隐藏详细信息,只在需要时展开查看。

基本语法:

<details>
<summary>点击展开详情</summary>
这里是折叠的内容,只有点击上面的标题才会显示。
可以包含多行文本、代码块等任何内容。
</details>

效果:

  • 默认情况下,只显示 <summary> 中的标题文本
  • 点击标题可以展开或收起详细内容
  • 展开时会显示一个向下的箭头图标,收起时显示向右的箭头图标

# 使用场景

  1. 隐藏详细说明

    <details>
    <summary>使用方法</summary>
    1. 首先打开设置页面
    2. 找到相关选项
    3. 点击保存
    </details>
  2. 折叠长文本

    <details>
    <summary>完整故事</summary>
    很久很久以前,在一个遥远的王国里...
    (这里可以是很长的故事内容)
    </details>
  3. 隐藏技术细节

    <details>
    <summary>技术实现</summary>
    ```python
    def process_data(data):
        # 复杂的处理逻辑
        return result
    ```

# 注意事项

  • 如果没有提供 <summary> 标签,系统会自动使用「详情」作为默认标题
  • 支持嵌套使用,但不建议过度嵌套,可能会影响性能
  • 折叠内容的最大高度被限制为屏幕高度的 50%,超出部分可以滚动查看
  • 系统会自动修复不完整的标签(如缺少结束标签)

# Fakecot 标签

# 基本用法

<fakecot/> 标签用于标记伪思维链内容。当 <details> 标签包含 <fakecot/> 标签时,整个 details 块的内容将不会参与上下文处理,也不会被语音朗读。

语法:

<details>
<summary>思考过程</summary>
<fakecot/>
让我想想这个问题...
首先需要分析...
然后考虑...
最终得出结论...
</details>

# 功能特点

  1. 上下文隔离:包含 <fakecot/> 的 details 内容不会影响后续对话的上下文
  2. 语音过滤:这些内容在语音朗读时会被自动跳过
  3. 思维展示:可以向用户展示 AI 的思考过程,但不影响实际对话流程

# 使用场景

  1. 展示推理过程

    根据您的问题,答案是 42。
    
    <details>
    <summary>推理过程</summary>
    <fakecot/>
    这个问题需要考虑多个因素:
    1. 首先分析题目条件
    2. 然后应用相关公式
    3. 最后验证结果的合理性
    </details>
  2. 调试信息

    <details>
    <summary>调试信息</summary>
    <fakecot/>
    当前状态:正在处理用户请求
    参数检查:通过
    逻辑验证:通过
    </details>

# 注意事项

  • <fakecot/> 标签必须放在 <details> 标签内部才能生效
  • 只有包含 <fakecot/> 的整个 details 块才会被过滤
  • 这个功能主要用于开发和调试,普通用户通常不需要使用

# 标签组合使用

您可以灵活组合使用这些标签来创建丰富的内容结构:

这是主要内容。

<details>
<summary>补充说明</summary>
这里是一些补充信息,用户可以选择查看。
</details>

<details>
<summary>思考过程</summary>
<fakecot/>
这里是 AI 的内部思考,不会影响对话上下文。
</details>

继续主要内容...

# 最佳实践

  1. 合理使用折叠:只对真正需要隐藏的内容使用 details 标签
  2. 清晰的标题:summary 中使用描述性的标题,让用户知道折叠内容的性质
  3. 避免过度嵌套:虽然支持嵌套,但建议保持结构简单清晰
  4. 内容长度控制:折叠内容不宜过长,以免影响用户体验
  5. fakecot 谨慎使用:只在确实需要隔离上下文时使用 fakecot 标签

通过合理使用这些特殊标签,您可以创建更加丰富和用户友好的聊天体验。