syncfusion-blazor-smart-pdf-viewer

Syncfusion Blazor Smart PDF Viewer – UI 示例生成器

NuGet： Syncfusion.Blazor.SfSmartPdfViewer + Syncfusion.Blazor.Themes
命名空间： Syncfusion.Blazor.SmartPdfViewer

为用户的项目生成 C# 代码 （默认）

触发关键词： “how to”、“add smart pdfviewer”、“code sample”、“show me”、“example”、“snippet”、“integrate”、“component”、“create sample”、“document summarization”、“smart redaction”、“smart fill”。

用途： 生成精简、可直接复制粘贴的 C# 和 Razor 代码，供用户直接集成到其 Blazor 项目中。

工作流：

⚠️ 关键——功能支持策略（严格模式）：

基本规则： 只能使用参考文件中明确列出的 API 和属性生成代码。任何偏离都属于违规。

• 生成任何代码前必须执行的检查：

  1. 在参考文件中搜索确切的 API／属性名称
  2. 确认其出现在方法参考、属性或事件表中
  3. 如果任何参考文件中都未找到，立即停止
  4. 在任何情况下都不得生成或建议未记录的 API

• 严格执行——零容忍：

  • 不得使用自定义属性——只能使用参考文件表中的属性
  • 不得编造方法——只能使用参考文件表中的方法
  • 不得使用未定义 API 作为变通方案——禁止
  • 不得假设未记录的行为——禁止
  • 不得使用猜测实现替代方案——禁止
  • 不得假装支持某项功能——禁止

• 对不支持的功能必须作出的回应：

  • 如果请求的场景／功能／API 未在任何参考文件中列出，必须回复：

    "This feature is not supported in the current Syncfusion Blazor Smart PDF Viewer implementation."
    

  • 然后列出相应参考文件中支持的内容
  • 除非参考文件中有明确记录，否则不得建议替代方案

• 参考文件层级：

  • 每个参考文件都包含其领域完整、权威的文档
  • 表格（方法参考、属性、事件）是唯一事实来源
  • 参考文件中这些表格以外的内容仅用于说明
  • 不得超出参考文件表格中的内容

• 审核生成内容：

  • 提供任何代码前，确认所用的每个 API 都出现在参考文件的表格中
  • 记录每个 API 所属的参考文件
  • 如果无法引用某个表格条目，删除相应代码

• 这是关键要求。 违反要求会损害此技能的完整性和可靠性。

步骤 1 — 检测应用类型 （必需——不得跳过）

• 使用 file_search 和 read_file 工具检查工作区项目文件：
  • .csproj 文件（项目配置）
  • Program.cs（启动配置）
  • _Imports.razor（命名空间导入）
  • App.razor（根组件）
  • Components/Pages 中任何现有的 .razor 文件
• 输出： 在继续之前，确认检测到的应用类型（例如，“Blazor WebApp”或“Blazor Server”）。

步骤 2 — 仅根据参考文件生成代码 （必需）

• 生成前： 确认已完成步骤 1
• 阅读与所请求功能相关的 references/*.md 文件
• 对照这些表格核验每个 API、属性和方法
• 仅限声明式方法（强制 — 不得使用生命周期方法）：
  • 仅在 Razor 标记中使用属性绑定，类似生命周期方法。
  • 将所有 Smart PDF Viewer 属性直接配置为组件特性
• 强制要求： 生成任何代码前，验证参考文件存在且可访问
• 阅读合适的参考文件：
  • 使用 read_file 工具读取相关的 references/*.md 文件
  • 确认文件包含 Methods/Properties/Events 表格
  • 验证表格完整且可读
• 如果参考文件缺失或无法读取：
  • 停止生成代码
  • 回复：“此功能的参考文件不可用。请确保 references/ 目录中包含所有参考文件。”
  • 列出缺失的参考文件名称
• 此步骤是阻断条件： 未验证参考文件前不得继续
• 如果某个 API/属性未出现在参考文件表格中，请勿使用
• 不要发明、猜测或建议参考文件中未明确列出的任何 API、方法、属性、类或命名空间

代码参考

所有模板和操作代码片段均位于 references/*.md 中。每个文件都包含一个专用代码片段或模板，Agent 会在生成示例时组合使用。

文件	用途
getting-started.md	基础设置和最简 Smart PDF Viewer 组件。包括 NuGet 包安装、服务注册、Azure OpenAI 配置和完整的设置前提条件。
smart-redaction.md	AI 驱动的智能涂黑配置。介绍启用/禁用涂黑、自定义涂黑模式（人名、电子邮件地址、电话号码、信用卡号等）以及默认模式定义。
smart-fill.md	智能表单填写配置。介绍用于 AI 驱动的 PDF 表单字段自动填充的 SmartFillSettings 类、启用/禁用控制以及集成指南。
document-summarizer.md	文档摘要和 AI 助手配置。包括 AssistViewSettings 参数，例如 ShowPromptSuggestions、Prompt 绑定、PromptChanged 回调、Placeholder、MinLength，以及用于实时 AI 响应的 StreamResponse。
custom-ai-service.md	自定义 AI 服务集成指南。介绍 IChatInferenceService 接口实现、在 Program.cs 中注册服务、使用 ErrorDialogService 处理错误，以及自定义聊天客户端集成模式。

快速开始示例

@rendermode InteractiveServer

添加组件：

<SfSmartPdfViewer Height="100%" Width="100%" DocumentPath="@DocumentPath">
</SfSmartPdfViewer>

---