当前源码结构

结构记录更新于 2026 年 10 月 17 日。当前 go.mod 固定 Go 1.27.2 和 MyGo v0.5.5；早期验证记录使用 MyGo v0.4.8。根目录 main.go 调用 internal/app.Run，原生应用组合代码保持在单一包中，业务逻辑保留现有边界。

rivu/
├── main.go
├── mygo.json
├── Makefile
├── internal/
│   ├── app/
│   ├── config/
│   ├── desktop/
│   ├── files/
│   ├── problem/
│   ├── session/
│   ├── storage/
│   ├── torrent/
│   ├── updater/
│   ├── watchfolder/
│   └── windowtask/
├── resources/
│   ├── embed.go
│   └── ...
├── locales/
├── tools/genicon/
└── docs/
    ├── guide/
    ├── development/
    ├── history/
    ├── design/
    ├── images/
    ├── public/
    ├── zh/
    └── .vitepress/

下表应用文件名相对于 internal/app/，会话与种子适配器文件名相对于各自包目录。

区域	文件与职责
启动	根目录 main.go：薄入口；应用包 run.go、cli.go、application.go：进程、唯一会话、应用生命周期
窗口	window_base.go：原生生命周期和可取消工作；window.go：主窗口状态；window_actions.go：主窗口操作；settings_window.go：设置草稿；add_window.go：导入草稿
主界面	view.go、view_sidebar.go、view_toolbar.go、view_task_list.go、view_statusbar.go、view_inspector.go、view_palette.go
对话框与输入	add_view.go、remove_window.go、recovery_actions.go、file_tree.go
设置	settings.go：渲染；settings_inputs.go：单位、策略与自动化；settings_save.go：验证和保存；settings_updates.go：更新器
桌面组合	menu.go、tray.go、capture.go、localization.go、presentation.go、theme.go；icons.go：SVG 解析与缓存；controls.go：UI 控件
会话	manager.go：生命周期与串行化；model.go、types.go：数据契约；validation.go、commands.go：验证修改；import.go、removal.go、persistence.go、recovery.go、observation.go、snapshot.go、scheduler.go、space.go
种子适配器	engine.go、source.go、storage.go、preview.go、diagnostics.go
自动化	internal/config/schedule.go、internal/watchfolder/watcher.go、internal/app/watch_folder.go
支撑包	internal/problem、config、files、storage、desktop、updater；internal/windowtask 管理可取消的窗口作业，与传输任务分离
资源与本地化	resources/embed.go：资源嵌入和相对路径读取；locales：MyGo 词条和生成函数

测试与实现同目录，应用测试位于 internal/app/。resources 放置应用资源，tools/genicon 生成图标，snapshots 与 build 存放生成输出。原生应用不使用 Web 运行时；docs 下的 VitePress 站点独立使用 pnpm 构建。

go run . 和 MyGo 开发、构建命令继续使用根入口。make snapshots 针对 internal/app 运行，发布工作流更新 internal/app/run.go 中的版本号。

状态归属与持久化契约见架构，功能行为见验证报告，发布前阅读桌面验收。10 月 12 日目录规划保留为历史设计，不代表当前文件布局。