附录 A:源码导航表
入口与组装
| 关注点 |
路径 |
| Rust 进程入口 |
src-tauri/src/main.rs |
| Tauri builder、commands、plugins |
src-tauri/src/lib.rs |
| Rust 模块树 |
src-tauri/src/core/mod.rs |
| Web boot |
web-app/src/main.tsx |
| 根布局与全局 Provider |
web-app/src/routes/__root.tsx |
| ServiceHub |
web-app/src/services/index.ts |
Core 与领域类型
| 关注点 |
路径 |
| Core exports |
core/src/index.ts、core/src/browser/index.ts |
| Extension base |
core/src/browser/extension.ts |
| Engine registry |
core/src/browser/extensions/engines/EngineManager.ts |
| AI engine contracts |
core/src/browser/extensions/engines/AIEngine.ts |
| Thread / message |
core/src/types/thread/*、core/src/types/message/* |
| Model |
core/src/types/model/* |
聊天主线
| 关注点 |
路径 |
| Thread route |
web-app/src/routes/threads/$threadId.tsx |
| Chat wrapper |
web-app/src/hooks/use-chat.ts |
| Transport |
web-app/src/lib/custom-chat-transport.ts |
| Provider factory |
web-app/src/lib/model-factory.ts |
| Context manager |
web-app/src/lib/context-manager.ts |
| Message conversion |
web-app/src/lib/messages.ts |
| Branching |
web-app/src/lib/message-branching.ts |
Rust 后端
| 关注点 |
路径 |
| Shared state |
src-tauri/src/core/state.rs |
| Threads commands |
src-tauri/src/core/threads/commands.rs |
| Thread file helpers |
src-tauri/src/core/threads/helpers.rs |
| Mobile SQLite |
src-tauri/src/core/threads/db.rs |
| HTTP server |
src-tauri/src/core/server/commands.rs、proxy.rs |
| Provider translation |
src-tauri/src/core/server/converters.rs |
| MCP client manager |
src-tauri/src/core/mcp/helpers.rs、commands.rs |
| Downloads |
src-tauri/src/core/downloads/commands.rs、models.rs |
| App data/config |
src-tauri/src/core/app/commands.rs、setup.rs |
扩展与插件
| 能力 |
TypeScript |
Rust plugin |
| Assistant |
extensions/assistant-extension |
filesystem commands |
| Conversations |
extensions/conversational-extension |
threads module |
| llama.cpp |
extensions/llamacpp-extension |
src-tauri/plugins/tauri-plugin-llamacpp |
| MLX |
extensions/mlx-extension |
src-tauri/plugins/tauri-plugin-mlx |
| RAG |
extensions/rag-extension |
tauri-plugin-rag |
| Vector DB |
extensions/vector-db-extension |
tauri-plugin-vector-db |
| Hardware |
extensions/llamacpp-extension / hooks |
tauri-plugin-hardware |
| Web search |
Web tools |
tauri-plugin-websearch |
上游导航
源码路径可在 Jan 上游仓库中对应查阅:https://github.com/janhq/jan。由于上游 main 会继续变化,链接用于导航;本文结论以本地 jan-main 快照为准。