proofreader-api

Proofreader API 技能为实现基于浏览器的 AI 写作辅助提供了一个结构化框架。此技能专为 JavaScript 与 TypeScript 网络应用程序设计，使开发人员能够利用内置的机器学习模型，直接在浏览器中集成拼写检查、语法修正与标点符号优化等功能。它适用于构建文本编辑器、内容管理系统或交互式表单的软件工程师与前端开发人员，帮助处理模型可用性检查、安全上下文要求以及浏览器预览版实现中的各种细节问题。

• 支持稳健的可用性检查，以判断 Proofreader API 是否能在当前浏览器环境中初始化。

• 简化模型下载监控流程，允许 UI 组件追踪下载进度，并在获取资产时更新用户界面状态。

• 管理会话生命周期，包括处理创建、Abort 信号以及资源清理，确保应用程序高效运作。

• 支持语言配置以及针对拼写、语法与标点符号等细节的校正类型控制。

• 提供将校正后的文本输出以及结构化元数据（包含校正说明与索引范围）渲染至页面的实现模式。

• 提供封装好的 API 封装器，确保跨浏览器版本与预览旗标的一致性表现。

• 优先使用所提供的辅助脚本来盘点浏览器入口点，并识别工作区内的集成目标。

• 确保所有 Proofreader 操作皆在安全上下文内执行，并在尝试创建会话前检查权限原则限制。

• 对于不支持的浏览器、受限框架或未达最低硬件与存储空间要求的设备，务必实现非 AI 的备援机制。

• 使用提供的会话模板以维护严格的类型定义，并妥善处理如 NotAllowedError 或 NotSupportedError 等错误。

• 注意会话选项是不可变的，若需变更行为应重新创建实例，而非尝试在初始化后修改选项。

• 此技能包含故障排除参考，以解决如存储空间不足导致模型被删除或 iframe 特定限制等边缘情况。