How ayuilos/miffan works
Miffan is a native Android AI workspace. A user configures an assistant and provider, sends a chat message, and receives a streamed, tool-aware response; tools can involve search, device capabilities, or local/remote workspace files and commands. Conversations and workspace metadata are persisted, while the README also documents translation, document extraction, and browser access. Edges cite README-documented behavior or indexed source references; several UI and storage connections are documented rather than verified from excerpts.
Main entry points: ChatService.kt Chat orchestration · WorkspaceRepository.kt Workspace management · ChatInput.kt Chat interface · ProviderManager.kt Provider dispatch
Components 23
Assistant experience
- Chat interface
app/src/main/java/me/ayuilos/miffan/ui/components/ai/ChatInput.kt - Message display
app/src/main/java/me/ayuilos/miffan/ui/components/message/ChatMessage.kt - Assistant settings
app/src/main/java/me/ayuilos/miffan/data/model/Assistant.kt
AI runtime
- Chat orchestration
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Generation handling
app/src/main/java/me/ayuilos/miffan/data/ai/GenerationHandler.kt - Provider dispatch
ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt - Provider services
ai/src/main/java/me/rerere/ai/provider/providers - Tool contracts
ai/src/main/java/me/rerere/ai/core/Tool.kt - Prompt transformers
app/src/main/java/me/ayuilos/miffan/data/ai/transformers
Workspaces and tools
- Workspace interface
app/src/main/java/me/ayuilos/miffan/ui/components/ai/WorkspaceSelectSheet.kt - Workspace management
app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt - Local workspace engine
workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt - SSH workspaces
app/src/main/java/me/ayuilos/miffan/data/repository/RemoteWorkspaceConnectionPool.kt
Local data
- Conversation history
app/src/main/java/me/ayuilos/miffan/data/repository/ConversationRepository.kt - App database
app/src/main/java/me/ayuilos/miffan/data/db/AppDatabase.kt
External capabilities
- Web search
search/src/main/java/me/rerere/search/SearchService.kt - Device tools
app/src/main/java/me/ayuilos/miffan/data/ai/tools/local/LocalTools.kt - Document extraction
document/src/main/java/me/rerere/document/DocxParser.kt - Text translation
app/src/main/java/me/ayuilos/miffan/data/ai/TranslationHandler.kt - Browser access
app/src/main/java/me/ayuilos/miffan/web/routes/ConversationRoutes.kt
Other components
- Android user
- Model APIs
- Search services
Connections 24
- Android user → Chat interface: sends message
README.md - Chat interface → Chat orchestration: submits chat
- Assistant settings → Chat orchestration: configures assistant
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Chat orchestration → Generation handling: delegates generation
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Chat orchestration → Provider dispatch: selects provider
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Provider dispatch → Provider services: dispatches requests
ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt - Provider services → Model APIs: sends requests
- Chat orchestration → Tool contracts: uses tools
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Chat orchestration → Prompt transformers: transforms messages
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Chat orchestration → Conversation history: manages history
app/src/main/java/me/ayuilos/miffan/service/ChatService.kt - Conversation history → App database: persists messages
- Chat orchestration → Message display: streams response
- Chat orchestration → Web search: invokes search
README.md - Web search → Search services: queries providers
- Chat orchestration → Device tools: invokes device tools
README.md - Android user → Workspace interface: chooses workspace
README.md - Workspace interface → Workspace management: manages workspace
- Workspace management → Local workspace engine: uses local engine
app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt - Workspace management → SSH workspaces: manages SSH
README.md - Chat orchestration → Local workspace engine: uses workspace tools
README.md - Chat orchestration → SSH workspaces: targets remote files
README.md - Chat orchestration → Document extraction: extracts attachments
README.md - Android user → Text translation: requests translation
README.md - Android user → Browser access: opens conversations
README.md