本目录用于说明插件是什么、为什么这样设计、当前做到什么程度，以及后续准备往哪里走。
overview.md: 项目定位、能力边界、核心特性architecture.md: 架构全景、设计理由、核心模块关系domain-model.md: 领域值、枚举语义、配置模型与常量归属application.md: 应用层入口、命令边界、AI tools、用户配置与推送历史语义polling.md: Feed 轮询、去重、增量识别与 dispatch 输入构造dispatch.md: 推送分发、history 语义、失败重试与 sender 入口platforms.md: 平台发送差异、媒体预下载、代理、缓存与常量放置规则commands.md: 订阅命令链、测试推送与完整入口分支web_api.md: Dashboard 的 HTTP 数据面、筛选和管理接口repositories.md: 仓储层、ORM 适配和查询/幂等细节sender.md: NotificationService、sender adapter 与媒体 fingerprinthandlers.md: handler registry、继承、AI filter/transform 行为formatting.md: 文本格式化、媒体组件排序与平台兼容策略knowledge.md: RSSHub Routes 知识库同步、manifest diff 与任务状态roadmap.md: 当前版本状态与后续演进方向
overview.md解释“为什么是这个插件形态”，不承载细节规则。architecture.md解释“模块如何连接”，不复制各模块算法。domain-model.md维护跨模块稳定值和配置模型归属。application.md维护入口语义和应用层行为边界。polling.md、dispatch.md、handlers.md、formatting.md、sender.md、platforms.md、web_api.md、repositories.md、knowledge.md分别维护各自模块流程。roadmap.md只记录当前阶段和演进方向，不作为行为契约。
- 第一次接手这个插件的维护者
- 需要了解当前实现边界的协作者
- 准备规划新功能或排查架构问题的人
overview.mdarchitecture.md- 按需阅读各模块深挖文档