add-home-widget-selector

What problem does it solve?

Flutter 插件常常缺少可在首页直接访问的数据入口，开发者需要重复实现数据选择、渲染与导航逻辑。本 Skill 提供一个可配置的 HomeWidget 方案，帮助插件快速暴露可定制的小组件。

Core Features & Use Cases

• 数据选择与持久化：通过 dataSelector 提取并保存必要字段（如 item id），避免冗余数据。
• 动态渲染与最新数据：通过 dataRenderer 使用插件控制器按 ID 获取最新数据，确保 UI 一致性。
• 导航与详情页：内置 navigationhook，点击小组件可跳转到相应的详情屏幕，提升用户体验。
• Use Case: 为一个待办插件添加“今日待办入口”小组件，自动显示选中的任务标题与状态，并可进入任务详情页。

Quick Start

按照以下步骤快速将一个插件转变为可配置的 HomeWidget：

1. 在插件初始化阶段注册数据选择器（dataSelector），并创建 home_widgets.dart 注册小组件。
2. 实现 dataSelector，确保返回一个包含至少 id 的 Map<String, dynamic>。
3. 实现 dataRenderer，通过插件控制器的 getItemById(id) 获取最新数据并渲染 UI。
4. 实现 navigationHandler，点击小组件时跳转到该数据的详情页。
5. 在插件主注册流程中注册该 HomeWidget。
6. 在路由配置中添加详情页路由，以便导航。
7. 为插件添加国际化字符串，确保 UI 文案可本地化。