syncfusion-maui-smart-text-editor

实现 Syncfusion .NET MAUI 智能文本编辑器

SfSmartTextEditor 是一个多行文本输入控件，可通过 AI 驱动的预测建议加快输入速度。它可通过 IChatInferenceService 集成 Azure OpenAI、OpenAI、Ollama 或任何自定义 AI 服务；当 AI 不可用时，则回退到自定义的 UserPhrases 列表。建议会以内联形式显示，或在插入光标附近以弹出窗口形式显示，并可通过 Tab 或 Right Arrow 键接受。

何时使用此技能

• 在 .NET MAUI 应用中添加多行文本输入，并提供 AI 驱动的自动补全
• 配置建议显示方式，包括内联（桌面端）或弹出窗口（触控设备）
• 集成 Azure OpenAI、OpenAI、Ollama、Claude、DeepSeek、Gemini 或 Groq
• 通过 IChatInferenceService 实现自定义 AI 服务
• 自定义文本样式、占位文本、建议颜色、弹出窗口背景或字符限制
• 响应文本更改事件或 MVVM 命令
• 为编辑器应用液态玻璃视觉效果

组件概览

SfSmartTextEditor 控件提供：

• AI 驱动的预测：通过 Azure OpenAI、OpenAI、Ollama 或自定义 IChatInferenceService 集成，提供上下文感知的补全
• 灵活的建议显示方式：内联模式（优先适配桌面端的无缝输入流程）或弹出窗口模式（优先适配触控的浮层），并提供特定于平台的默认设置
• 离线回退：当网络或 API 不可用时，使用自定义 UserPhrases 库提供不依赖 AI 的建议
• 智能上下文引擎：UserRole 属性可根据输入场景调整建议的语气和相关性
• 多种接受方式：通过 Tab/Right Arrow 键盘快捷键（桌面端）以及点按/单击手势（所有平台）接受建议
• 字符限制验证：通过强制执行 MaxLength，防止输入超出指定限制
• 丰富的自定义选项：可自定义 TextStyle、占位文本颜色、建议预览颜色和弹出窗口背景样式
• MVVM 支持：提供双向 Text 绑定、TextChanged 事件和 TextChangedCommand，支持响应式数据流
• 现代效果：支持液态玻璃效果，适用于半透明设计（iOS/macOS 26+、.NET 10）

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装 NuGet 包（Syncfusion.Maui.SmartComponents）
• 在 MauiProgram.cs 中使用 ConfigureSyncfusionCore() 注册处理程序
• 使用 ConfigureSyncfusionAIServices() 注册 AI 服务
• 在 XAML 和 C# 中添加 SfSmartTextEditor
• 配置 UserRole 和 UserPhrases，以提供上下文感知的建议
• AI 不可用时的离线回退行为

建议显示模式

📄 阅读： references/suggestion-display-modes.md

• 内联模式 — 在插入光标后原位呈现建议（优先适配桌面端）
• 弹出窗口模式 — 在插入光标附近显示紧凑浮层（优先适配触控设备，Android/iOS）
• 平台默认设置及何时覆盖这些设置
• 使用 Tab 或 Right Arrow 键接受建议
• 平台限制（Android/iOS 不支持 Tab 键）

自定义

📄 阅读： references/customization.md

• 通过 Text 属性设置编辑器文本并进行数据绑定
• 通过 TextStyle（SmartTextEditorStyle）设置字体和颜色
• 占位文本和 PlaceholderColor
• SuggestionTextColor — 设置建议预览文本的样式
• SuggestionPopupBackground — 设置弹出式建议的背景颜色
• MaxLength — 强制执行字符限制

事件

📄 阅读： references/events.md

• 包含 OldTextValue 和 NewTextValue 的 TextChanged 事件
• XAML 事件订阅和 C# 处理程序模式
• 用于 MVVM/数据绑定场景的 TextChangedCommand
• ViewModel 命令设置示例

AI 服务配置（Azure OpenAI / OpenAI / Ollama）

📄 阅读： references/ai-service-configuration.md

• Azure OpenAI — 所需的 NuGet 包、终结点 / 密钥 / 模型配置
• OpenAI — API 密钥和模型设置
• Ollama — 可自托管的本地模型配置
• 在 MauiProgram.cs 中注册聊天客户端并调用 ConfigureSyncfusionAIServices()
• 为你的场景选择合适的提供方

自定义 AI 服务（Claude / DeepSeek / Gemini / Groq）

📄 阅读： references/custom-ai-services.md

• IChatInferenceService 接口及其适用场景
• Claude AI — 请求 / 响应模型、服务类、注册
• DeepSeek — 聊天补全集成和注册
• Gemini — Google AI Studio 设置、安全设置、注册
• Groq — 低延迟、兼容 OpenAI 的终结点，注册
• 使用自定义服务时无需调用 ConfigureSyncfusionAIServices()
• 没有建议显示时的故障排除

Liquid Glass 效果

📄 阅读： references/liquid-glass-effect.md

• 前提条件：.NET 10、macOS 26+ 或 iOS 26+
• 将 SfSmartTextEditor 包装在 SfGlassEffectView 中
• 通过 EnableLiquidGlassEffect="True" 启用
• 设置 Background="Transparent" 以正确显示玻璃色调
• 完整的 XAML 和 C# 示例