# liulpigeon617/labs-archiveassistant-ios architecture

> Architecture diagram of the GitHub repository liulpigeon617/labs-archiveassistant-ios, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/liulpigeon617/labs-archiveassistant-ios
- Repository: https://github.com/liulpigeon617/labs-archiveassistant-ios

## Overview

聚合拾遗是一个 Android 个人资料归档与知识整理应用。用户从首页或拖入/粘贴网页、文档等资料，经状态层处理输入、抓取网页或提取文档内容，再手动归档或调用远程/本地 AI 生成归纳，最后将条目和设置持久化并在分类详情中浏览。应用还提供固定六部分类、AI 配置与模型管理，以及奏折式阅读/审阅界面。边主要依据摘录、SOURCE INDEX 引用和 README；未摘录实现的连接仅在有依据时保留。

Main entry points: [`app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt) (业务状态与动作), [`app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt) (应用组装), [`app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt`](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt) (Android 入口), [`app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt`](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt) (本地推理服务)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["界面与入口"]
  node_activity["Android 入口<br/>[MainActivity.kt]"]
  node_app["应用组装"]
  node_home["首页与分类<br/>[HomePane.kt]"]
  node_detail["分类详情<br/>[DetailPane.kt]"]
  node_settings["设置页<br/>[SettingsPane.kt]"]
  node_archive_dialog["归档弹窗<br/>[ArchiveDialog.kt]"]
  node_memorial["奏折阅读审阅"]
end

subgraph group_workflow["归档工作流"]
  node_state["业务状态与动作"]
  node_state_model["应用状态模型"]
  node_domain["条目与主题模型<br/>[Models.kt]"]
  node_web_fetch["网页抓取"]
  node_document_extract["文档提取"]
  node_uri_import["URI 导入<br/>[UriImportHelper.kt]"]
end

subgraph group_intelligence["AI 能力"]
  node_remote_ai["远程智能归纳"]
  node_summarizer["归纳接口与结果<br/>[SmartSummarizer.kt]"]
  node_local_summarizer["本地智能归纳"]
  node_local_engine["本地推理引擎接口<br/>[LocalLlmEngine.kt]"]
  node_inference_connection["推理服务连接"]
  node_inference_service["本地推理服务"]
  node_litert["LiteRT LM 适配"]
  node_model_download["模型下载管理"]
end

subgraph group_persistence["设置与存储"]
  node_app_data_repo["归档数据仓库"]
  node_app_data_store[("归档偏好存储")]
  node_ai_settings_repo["AI 设置仓库"]
  node_ai_settings_store[("AI 设置偏好")]
  node_preset_repo["引擎预设仓库"]
  node_preset_store[("引擎预设偏好")]
end

node_user(("用户"))

node_user -->|"opens and imports"| node_activity
node_activity -->|"renders"| node_app
node_activity -->|"constructs"| node_state
node_app -->|"dispatches actions"| node_state
node_app -->|"renders"| node_home
node_app -->|"renders"| node_detail
node_app -->|"renders"| node_settings
node_app -->|"renders"| node_memorial
node_app -->|"renders"| node_archive_dialog
node_state -->|"updates"| node_state_model
node_state -->|"manages entries"| node_domain
node_state -->|"fetches pages"| node_web_fetch
node_state -->|"extracts text"| node_document_extract
node_activity -->|"parses dropped input"| node_uri_import
node_state -->|"requests summaries"| node_remote_ai
node_state -->|"controls local model"| node_inference_connection
node_state -->|"manages downloads"| node_model_download
node_remote_ai -.->|"implements"| node_summarizer
node_local_summarizer -->|"implements"| node_summarizer
node_local_summarizer -->|"generates with"| node_local_engine
node_inference_connection -->|"binds service"| node_inference_service
node_inference_service -->|"summarizes via"| node_local_summarizer
node_inference_service -->|"creates adapter"| node_litert
node_litert -->|"implements"| node_local_engine
node_state -->|"loads and saves"| node_app_data_repo
node_app_data_repo -->|"reads and writes"| node_app_data_store
node_state -->|"loads and saves"| node_ai_settings_repo
node_ai_settings_repo -->|"reads and writes"| node_ai_settings_store
node_app -->|"provides presets"| node_preset_repo
node_preset_repo -->|"reads and writes"| node_preset_store

click node_activity "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt"
click node_app "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt"
click node_home "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/HomePane.kt"
click node_detail "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/DetailPane.kt"
click node_settings "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/SettingsPane.kt"
click node_archive_dialog "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/components/ArchiveDialog.kt"
click node_memorial "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/MemorialBriefingPane.kt"
click node_state "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt"
click node_state_model "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantState.kt"
click node_domain "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/Models.kt"
click node_web_fetch "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/WebPageContentFetcher.kt"
click node_document_extract "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/DocumentContentExtractor.kt"
click node_uri_import "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/UriImportHelper.kt"
click node_remote_ai "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/RemoteApiSmartSummarizer.kt"
click node_summarizer "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/SmartSummarizer.kt"
click node_local_summarizer "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmSmartSummarizer.kt"
click node_local_engine "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmEngine.kt"
click node_inference_connection "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceConnection.kt"
click node_inference_service "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt"
click node_litert "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/LiteRtLmEngineAdapter.kt"
click node_model_download "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/ModelDownloadManager.kt"
click node_app_data_repo "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AppDataRepository.kt"
click node_app_data_store "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AppDataPreferences.kt"
click node_ai_settings_repo "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsRepository.kt"
click node_ai_settings_store "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsPreferences.kt"
click node_preset_repo "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetRepository.kt"
click node_preset_store "https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetPreferences.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_app,node_home,node_detail,node_settings,node_archive_dialog,node_memorial toneBlue
class node_state,node_state_model,node_domain,node_web_fetch,node_document_extract,node_uri_import toneAmber
class node_remote_ai,node_summarizer,node_local_summarizer,node_local_engine,node_inference_connection,node_inference_service,node_litert,node_model_download toneMint
class node_app_data_repo,node_app_data_store,node_ai_settings_repo,node_ai_settings_store,node_preset_repo,node_preset_store toneRose
class node_user toneIndigo
```

## Components

### 界面与入口

- [Android 入口](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt): `app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt`
- [应用组装](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt): `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`
- [首页与分类](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/HomePane.kt): `app/src/main/java/com/lyihub/archiveassistant/ui/screens/HomePane.kt`
- [分类详情](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/DetailPane.kt): `app/src/main/java/com/lyihub/archiveassistant/ui/screens/DetailPane.kt`
- [设置页](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/SettingsPane.kt): `app/src/main/java/com/lyihub/archiveassistant/ui/screens/SettingsPane.kt`
- [归档弹窗](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/components/ArchiveDialog.kt): `app/src/main/java/com/lyihub/archiveassistant/ui/components/ArchiveDialog.kt`
- [奏折阅读审阅](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/ui/screens/MemorialBriefingPane.kt): `app/src/main/java/com/lyihub/archiveassistant/ui/screens/MemorialBriefingPane.kt`

### 归档工作流

- [业务状态与动作](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt): `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`
- [应用状态模型](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantState.kt): `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantState.kt`
- [条目与主题模型](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/Models.kt): `app/src/main/java/com/lyihub/archiveassistant/domain/Models.kt`
- [网页抓取](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/WebPageContentFetcher.kt): `app/src/main/java/com/lyihub/archiveassistant/data/WebPageContentFetcher.kt`
- [文档提取](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/DocumentContentExtractor.kt): `app/src/main/java/com/lyihub/archiveassistant/data/DocumentContentExtractor.kt`
- [URI 导入](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/UriImportHelper.kt): `app/src/main/java/com/lyihub/archiveassistant/data/UriImportHelper.kt`

### AI 能力

- [远程智能归纳](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/RemoteApiSmartSummarizer.kt): `app/src/main/java/com/lyihub/archiveassistant/data/RemoteApiSmartSummarizer.kt`
- [归纳接口与结果](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/SmartSummarizer.kt): `app/src/main/java/com/lyihub/archiveassistant/domain/SmartSummarizer.kt`
- [本地智能归纳](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmSmartSummarizer.kt): `app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmSmartSummarizer.kt`
- [本地推理引擎接口](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmEngine.kt): `app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmEngine.kt`
- [推理服务连接](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceConnection.kt): `app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceConnection.kt`
- [本地推理服务](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt): `app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt`
- [LiteRT LM 适配](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/LiteRtLmEngineAdapter.kt): `app/src/main/java/com/lyihub/archiveassistant/data/LiteRtLmEngineAdapter.kt`
- [模型下载管理](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/ModelDownloadManager.kt): `app/src/main/java/com/lyihub/archiveassistant/data/ModelDownloadManager.kt`

### 设置与存储

- [归档数据仓库](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AppDataRepository.kt): `app/src/main/java/com/lyihub/archiveassistant/data/AppDataRepository.kt`
- [归档偏好存储](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AppDataPreferences.kt): `app/src/main/java/com/lyihub/archiveassistant/data/AppDataPreferences.kt`
- [AI 设置仓库](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsRepository.kt): `app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsRepository.kt`
- [AI 设置偏好](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsPreferences.kt): `app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsPreferences.kt`
- [引擎预设仓库](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetRepository.kt): `app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetRepository.kt`
- [引擎预设偏好](https://github.com/liulpigeon617/labs-archiveassistant-ios/blob/main/app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetPreferences.kt): `app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetPreferences.kt`

### Other components

- **用户**

## Connections

- 用户 → Android 入口: opens and imports (evidence: `app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt`)
- Android 入口 → 应用组装: renders (evidence: `app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt`)
- Android 入口 → 业务状态与动作: constructs (evidence: `app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt`)
- 应用组装 → 业务状态与动作: dispatches actions (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 应用组装 → 首页与分类: renders (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 应用组装 → 分类详情: renders (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 应用组装 → 设置页: renders (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 应用组装 → 奏折阅读审阅: renders (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 应用组装 → 归档弹窗: renders (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 业务状态与动作 → 应用状态模型: updates (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 业务状态与动作 → 条目与主题模型: manages entries (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 业务状态与动作 → 网页抓取: fetches pages (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 业务状态与动作 → 文档提取: extracts text (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- Android 入口 → URI 导入: parses dropped input (evidence: `app/src/main/java/com/lyihub/archiveassistant/MainActivity.kt`)
- 业务状态与动作 → 远程智能归纳: requests summaries (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 业务状态与动作 → 推理服务连接: controls local model (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 业务状态与动作 → 模型下载管理: manages downloads (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 远程智能归纳 → 归纳接口与结果: implements (evidence: `app/src/main/java/com/lyihub/archiveassistant/data/RemoteApiSmartSummarizer.kt`)
- 本地智能归纳 → 归纳接口与结果: implements (evidence: `app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmSmartSummarizer.kt`)
- 本地智能归纳 → 本地推理引擎接口: generates with (evidence: `app/src/main/java/com/lyihub/archiveassistant/domain/LocalLlmSmartSummarizer.kt`)
- 推理服务连接 → 本地推理服务: binds service (evidence: `app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceConnection.kt`)
- 本地推理服务 → 本地智能归纳: summarizes via (evidence: `app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt`)
- 本地推理服务 → LiteRT LM 适配: creates adapter (evidence: `app/src/main/java/com/lyihub/archiveassistant/service/LocalInferenceService.kt`)
- LiteRT LM 适配 → 本地推理引擎接口: implements (evidence: `app/src/main/java/com/lyihub/archiveassistant/data/LiteRtLmEngineAdapter.kt`)
- 业务状态与动作 → 归档数据仓库: loads and saves (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- 归档数据仓库 → 归档偏好存储: reads and writes (evidence: `app/src/main/java/com/lyihub/archiveassistant/data/AppDataRepository.kt`)
- 业务状态与动作 → AI 设置仓库: loads and saves (evidence: `app/src/main/java/com/lyihub/archiveassistant/state/ArchiveAssistantStateStore.kt`)
- AI 设置仓库 → AI 设置偏好: reads and writes (evidence: `app/src/main/java/com/lyihub/archiveassistant/data/AiEngineSettingsRepository.kt`)
- 应用组装 → 引擎预设仓库: provides presets (evidence: `app/src/main/java/com/lyihub/archiveassistant/app/ArchiveAssistantApp.kt`)
- 引擎预设仓库 → 引擎预设偏好: reads and writes (evidence: `app/src/main/java/com/lyihub/archiveassistant/data/AiEnginePresetRepository.kt`)
