# 文件命名规范重构方案 ## 命名规范（最终版） - **base-core 层接口**：`IShareService` → `IShare`、`IPushService` → `IPush`（去掉 Service，保持 I 前缀） - **capability 层接口**（能力暴露给外部）：`ShareService` → `IShare`、`PushService` → `IPush`、`BLEService` → `IBLE`、`NFCService` → `INFC`、`SocketIOService` → `ISocketIO` - **实现类**：`*ServiceImpl` → `*Impl`（例如 `ShareServiceImpl` → `ShareImpl`） - **能力入口 / Kit**：`ShareServiceFactory` → `ShareKit`、`PushServiceFactory` → `PushKit`、`BLEServiceFactory` → `BLEKit`、`SocketIOServiceFactory` → `SocketIOKit`（统一用 `*Kit` 做对外入口） - **回调实现**：`*CallbackImpl` → `*Callback`（去掉 Impl，例如 `ShareCallbackImpl` → `ShareCallback`） ## 完整文件树形结构图 ``` xdz_android/ ├── app/src/main/java/com/narutohuo/xindazhou/ │ ├── auth/ │ │ ├── AuthManager.kt ✅ 保持 │ │ ├── datasource/ │ │ │ ├── local/ │ │ │ │ ├── AuthLocalDataSource.kt ✅ 保持 │ │ │ │ └── AuthLocalDataSourceImpl.kt ✅ 保持 │ │ │ └── remote/ │ │ │ ├── AuthApi.kt ✅ 保持 │ │ │ └── AuthRemoteDataSource.kt ✅ 保持 │ │ ├── model/ │ │ │ ├── LoginRequest.kt ✅ 保持 │ │ │ ├── LoginResponse.kt ✅ 保持 │ │ │ └── RegisterRequest.kt ✅ 保持 │ │ ├── repository/ │ │ │ └── AuthRepository.kt ✅ 保持 │ │ ├── storage/ │ │ │ └── TokenStore.kt ✅ 保持 │ │ └── ui/ │ │ ├── login/ │ │ │ └── LoginActivity.kt ✅ 保持 │ │ ├── register/ │ │ │ └── RegisterActivity.kt ✅ 保持 │ │ └── viewmodel/ │ │ ├── LoginState.kt ✅ 保持 │ │ ├── LoginViewModel.kt ✅ 保持 │ │ ├── LoginViewModelFactory.kt ✅ 保持 │ │ ├── RegisterState.kt ✅ 保持 │ │ ├── RegisterViewModel.kt ✅ 保持 │ │ └── RegisterViewModelFactory.kt ✅ 保持 │ ├── community/ ✅ 保持 │ ├── launch/ │ │ └── AppInitializer.kt ✅ 保持 │ ├── MainActivity.kt ✅ 保持 │ ├── MainFragment.kt ✅ 保持 │ ├── service/ ✅ 保持 │ ├── shop/ ✅ 保持 │ ├── user/ │ │ └── ui/ │ │ ├── UserActivity.kt ✅ 保持 │ │ └── viewmodel/ │ │ ├── UserViewModel.kt ✅ 保持 │ │ └── UserViewModelFactory.kt ✅ 保持 │ ├── vehicle/ ✅ 保持 │ └── XinDaZhouApplication.kt ✅ 保持 │ ├── base-common/src/main/java/com/narutohuo/xindazhou/common/ │ ├── config/ │ │ ├── ConfigManager.kt ✅ 保持 │ │ └── ServerConfigManager.kt ✅ 保持 │ ├── crash/ │ │ └── CrashHelper.kt ✅ 保持 │ ├── dialog/ │ │ ├── CascadePickerDialog.kt ✅ 保持 │ │ ├── DialogHelper.kt ✅ 保持 │ │ └── ServerConfigDialog.kt ✅ 保持 │ ├── executor/ │ │ └── ExecutorManager.kt ✅ 保持 │ ├── image/ │ │ └── ImageLoadHelper.kt ✅ 保持 │ ├── launch/ │ │ ├── AppLaunchManager.kt ✅ 保持 │ │ ├── model/ │ │ │ └── OnboardingItem.kt ✅ 保持 │ │ ├── NavigationCallback.kt ✅ 保持 │ │ ├── OnboardingManager.kt ✅ 保持 │ │ └── ui/ │ │ └── OnboardingFragment.kt ✅ 保持 │ ├── network/ │ │ ├── adapter/ │ │ │ └── ApiResponseCallAdapterFactory.kt ✅ 保持 │ │ ├── ApiBaseRemoteDataSource.kt ✅ 保持 │ │ ├── ApiBaseRepository.kt ✅ 保持 │ │ ├── ApiManager.kt ✅ 保持 │ │ ├── ApiResponseParser.kt ✅ 保持 │ │ ├── exception/ │ │ │ ├── ApiException.kt ✅ 保持 │ │ │ └── ExceptionHandle.kt ✅ 保持 │ │ ├── interceptor/ │ │ │ ├── HeaderInterceptor.kt ✅ 保持 │ │ │ └── TokenRefreshInterceptor.kt ✅ 保持 │ │ ├── NetworkManager.kt ✅ 保持 │ │ ├── operator/ │ │ │ ├── ApiResponseOperator.kt ✅ 保持 │ │ │ ├── GlobalApiOperator.kt ✅ 保持 │ │ │ └── RetryOperator.kt ✅ 保持 │ │ ├── response/ │ │ │ ├── ApiResponse.kt ✅ 保持 │ │ │ └── ApiResponseExtensions.kt ✅ 保持 │ │ └── SANDWICH_COMPARISON_CORRECTED.md ✅ 保持 │ ├── networkrx/ │ │ ├── ApiDisposableObserver.kt ✅ 保持 │ │ ├── cookie/ │ │ │ ├── CookieJarImpl.kt ✅ 保持 │ │ │ ├── CookieStore.kt ✅ 保持 │ │ │ ├── MemoryCookieStore.kt ✅ 保持 │ │ │ └── SPCookieStore.kt ✅ 保持 │ │ ├── download/ │ │ │ └── DownloadManager.kt ✅ 保持 │ │ ├── interceptor/ │ │ │ ├── HeaderInterceptor.kt ✅ 保持 │ │ │ └── TokenRefreshInterceptor.kt ✅ 保持 │ │ ├── NetworkManager.kt ✅ 保持 │ │ ├── NetworkUtil.kt ✅ 保持 │ │ ├── ResponseThrowable.kt ✅ 保持 │ │ ├── RxApiResponse.kt ✅ 保持 │ │ ├── RxApiResponseTransformer.kt ✅ 保持 │ │ └── RxExceptionHandler.kt ✅ 保持 │ ├── router/ │ │ └── RouterHelper.kt ✅ 保持 │ ├── storage/ │ │ └── StorageManager.kt ✅ 保持 │ ├── ui/ │ │ ├── ActivityExtensions.kt ✅ 保持 │ │ ├── ActivityManager.kt ✅ 保持 │ │ ├── BaseActivity.kt ✅ 保持 │ │ ├── BaseFragment.kt ✅ 保持 │ │ ├── BaseViewModel.kt ✅ 保持 │ │ ├── FragmentExtensions.kt ✅ 保持 │ │ ├── MessageHelper.kt ✅ 保持 │ │ ├── StatusBarHelper.kt ✅ 保持 │ │ └── UI层封装方案.md ✅ 保持 │ └── version/ │ ├── datasource/ │ │ └── remote/ │ │ ├── VersionApi.kt ✅ 保持 │ │ └── VersionRemoteDataSource.kt ✅ 保持 │ ├── model/ │ │ └── VersionResponse.kt ✅ 保持 │ ├── repository/ │ │ └── VersionRepository.kt ✅ 保持 │ ├── ui/ │ │ └── UpdateDialogFragment.kt ✅ 保持 │ └── VersionUpdateManager.kt ✅ 保持 │ ├── base-core/src/main/java/com/narutohuo/xindazhou/core/ │ ├── log/ │ │ ├── FloatingLogButton.kt ✅ 保持 │ │ ├── ILog.kt ✅ 保持 │ │ └── impl/ │ │ ├── LogcatViewerLog.kt ✅ 保持 │ │ └── NoOpLog.kt ✅ 保持 │ ├── network/ │ │ └── interceptor/ ✅ 保持 │ ├── permission/ │ │ └── PermissionHelper.kt ✅ 保持 │ ├── share/ │ │ ├── IShareCallback.kt ✅ 保持 │ │ └── IShareService.kt ⚠️ → IShare.kt │ ├── push/ │ │ └── IPushService.kt ⚠️ → IPush.kt │ ├── storage/ │ │ ├── IStorage.kt ✅ 保持 │ │ └── StorageImpl.kt ⚠️ → StorageKit.kt │ └── util/ │ └── IUtil.kt ✅ 保持 │ ├── capability-share/src/main/java/com/narutohuo/xindazhou/share/ │ ├── api/ │ │ └── ShareService.kt ⚠️ → IShare.kt │ ├── impl/ │ │ └── ShareServiceImpl.kt ⚠️ → ShareImpl.kt │ ├── factory/ │ │ └── ShareServiceFactory.kt ⚠️ → ShareKit.kt │ ├── callback/ │ │ └── ShareCallbackImpl.kt ⚠️ → ShareCallback.kt │ ├── model/ │ │ ├── ShareConfig.kt ✅ 保持 │ │ └── ShareResponse.kt ✅ 保持 │ └── ui/ │ ├── ShareDialogFragment.kt ✅ 保持 │ └── ShareProxyActivity.kt ✅ 保持 │ ├── capability-ble/src/main/java/com/narutohuo/xindazhou/ble/ │ ├── api/ │ │ └── BLEService.kt ⚠️ → IBLE.kt │ ├── impl/ │ │ └── BLEServiceImpl.kt ⚠️ → BLEImpl.kt │ ├── factory/ │ │ └── BLEServiceFactory.kt ⚠️ → BLEKit.kt │ ├── callback/ │ │ └── BLECallback.kt ✅ 保持 │ ├── config/ │ │ └── BLEConstants.kt ✅ 保持 │ ├── model/ │ │ ├── BLECommand.kt ✅ 保持 │ │ ├── BLEDevice.kt ✅ 保持 │ │ ├── BLEEncryptedData.kt ✅ 保持 │ │ ├── BLEResponse.kt ✅ 保持 │ │ ├── Command.kt ✅ 保持 │ │ ├── FragmentBuffer.kt ✅ 保持 │ │ └── Packet.kt ✅ 保持 │ └── util/ │ ├── BleConnector.kt ✅ 保持 │ ├── BLECrypto.kt ✅ 保持 │ ├── BLEExtension.kt ✅ 保持 │ ├── BLEPacketBuilder.kt ✅ 保持 │ ├── BLEPacketParser.kt ✅ 保持 │ ├── BlePacketSender.kt ✅ 保持 │ ├── BLEPacketSplitter.kt ✅ 保持 │ └── BleScanner.kt ✅ 保持 │ ├── capability-push/src/main/java/com/narutohuo/xindazhou/push/ │ ├── api/ │ │ └── PushService.kt ⚠️ → IPush.kt │ ├── impl/ │ │ └── PushServiceImpl.kt ⚠️ → PushImpl.kt │ ├── factory/ │ │ └── PushServiceFactory.kt ⚠️ → PushKit.kt │ ├── helper/ │ │ └── TagAliasOperatorHelper.kt ✅ 保持 │ ├── model/ │ │ └── PushResponse.kt ✅ 保持 │ ├── receiver/ │ │ ├── BootReceiver.kt ✅ 保持 │ │ └── JPushReceiver.kt ✅ 保持 │ ├── server/ │ │ ├── PushMessageService.kt ⚠️ → PushMessageKit.kt │ │ └── UserService.kt ⚠️ → UserKit.kt │ ├── service/ │ │ └── UserService.java ✅ 保持 │ └── startup/ │ └── PushInitializer.kt ✅ 保持 │ ├── capability-qrcode/src/main/java/com/narutohuo/xindazhou/qrcode/ │ ├── api/ │ │ └── QRCodeManager.kt ✅ 保持 │ ├── impl/ │ │ └── QRCodeManagerImpl.kt ⚠️ → QRCodeImpl.kt（可选） │ ├── factory/ │ │ └── QRCodeManagerFactory.kt ✅ 保持 │ ├── model/ │ │ └── QRCodeResponse.kt ✅ 保持 │ └── ui/ │ ├── QRCodeScanActivity.kt ✅ 保持 │ └── QRCodeScanFragment.kt ✅ 保持 │ ├── capability-socketio/src/main/java/com/narutohuo/xindazhou/socketio/ │ ├── api/ │ │ └── SocketIOService.kt ⚠️ → ISocketIO.kt │ ├── impl/ │ │ └── SocketIOServiceImpl.kt ⚠️ → SocketIOImpl.kt │ ├── factory/ │ │ ├── SocketIORepositoryFactory.kt ✅ 保持 │ │ └── SocketIOServiceFactory.kt ⚠️ → SocketIOKit.kt │ ├── manager/ │ │ └── SocketIOManager.kt ✅ 保持 │ ├── repository/ │ │ └── SocketIORepository.kt ✅ 保持 │ ├── model/ │ │ ├── SocketIOEvent.kt ✅ 保持 │ │ └── SocketIOResponse.kt ✅ 保持 │ └── SocketIOManager.kt ✅ 保持 │ └── capability-nfc/src/main/java/com/narutohuo/xindazhou/nfc/ ├── api/ │ └── NFCService.kt ⚠️ → INFC.kt ├── impl/ │ └── NFCServiceImpl.kt ⚠️ → NFCImpl.kt └── model/ └── NFCResponse.kt ✅ 保持 ``` ## 改名清单 ### base-core - `core/share/IShareService.kt` → `core/share/IShare.kt` - `core/push/IPushService.kt` → `core/push/IPush.kt` - `core/storage/StorageImpl.kt` → `core/storage/StorageKit.kt` ### capability-share - `share/api/ShareService.kt` → `share/api/IShare.kt` - `share/impl/ShareServiceImpl.kt` → `share/impl/ShareImpl.kt` - `share/factory/ShareServiceFactory.kt` → `share/ShareKit.kt`（或 `share/factory/ShareKit.kt`） - `share/callback/ShareCallbackImpl.kt` → `share/callback/ShareCallback.kt` ### capability-ble - `ble/api/BLEService.kt` → `ble/api/IBLE.kt` - `ble/impl/BLEServiceImpl.kt` → `ble/impl/BLEImpl.kt` - `ble/factory/BLEServiceFactory.kt` → `ble/BLEKit.kt`（或 `ble/factory/BLEKit.kt`） ### capability-push - `push/api/PushService.kt` → `push/api/IPush.kt` - `push/impl/PushServiceImpl.kt` → `push/impl/PushImpl.kt` - `push/factory/PushServiceFactory.kt` → `push/PushKit.kt`（或 `push/factory/PushKit.kt`） - `push/server/PushMessageService.kt` → `push/server/PushMessageKit.kt` - `push/server/UserService.kt` → `push/server/UserKit.kt` ### capability-qrcode - `qrcode/api/QRCodeManager.kt` → `qrcode/api/QRCodeManager.kt`（保持） - `qrcode/impl/QRCodeManagerImpl.kt` → `qrcode/impl/QRCodeImpl.kt`（可选） - `qrcode/factory/QRCodeManagerFactory.kt` → `qrcode/factory/QRCodeManagerFactory.kt`（保持） ### capability-socketio - `socketio/api/SocketIOService.kt` → `socketio/api/ISocketIO.kt` - `socketio/impl/SocketIOServiceImpl.kt` → `socketio/impl/SocketIOImpl.kt` - `socketio/factory/SocketIOServiceFactory.kt` → `socketio/SocketIOKit.kt`（或 `socketio/factory/SocketIOKit.kt`） ### capability-nfc - `nfc/api/NFCService.kt` → `nfc/api/INFC.kt` - `nfc/impl/NFCServiceImpl.kt` → `nfc/impl/NFCImpl.kt` ## 总计 **22 个文件需要改名**