Translate code comments to English

Author: HarveySang

AGENTS.md

@@ -9,3 +9,5 @@ Rules:
 - Repository-level architecture notes, public-release boundaries, allowed change scope, and validation requirements are defined by `CLAUDE.md`.
 - If `README`, old comments, historical docs, or this file conflict with `CLAUDE.md`, follow `CLAUDE.md`.
 - If a subdirectory adds its own `CLAUDE.md` later, it may only add implementation details for that subtree; repository-level rules still come from the root `CLAUDE.md`.
+- For source-available public-release work, keep code comments, KDoc/JSDoc, and test `describe` / `it` names in English.
+- Chinese and other localized text may remain in localized docs, user-visible product copy, real-app UI matching strings, mock/sample data, and other runtime content where the language is part of the behavior.

client/automation/src/main/java/com/coremate/opengui/automation/AMServiceManager.kt

@@ -26,38 +26,38 @@ import com.coremate.opengui.automation.biz.permission.AMPermissionDialog
 class AMServiceManager {
 
     companion object {
-        ///全局上下文
+        ///Global Context
         lateinit var applicationContext: Context
         val instance by lazy(LazyThreadSafetyMode.SYNCHRONIZED) {
             AMServiceManager()
         }
     }
 
-    //是否开启前台服务
+    //Whether foreground service is enabled
     private var isStartService = false
 
-    //前台服务图标
+    //Foreground service icon
     var notificationImg: Int? = null
 
 //    var cozeAIManager: CozeAIManager? = null
 
     /**
-     * 初始化
-     * @param context 必须是ApplicationContext
+ * Initialize
+ * @param context must be Application Context
      */
     fun init(context: Context) {
         applicationContext = context
     }
 
     /**
-     * 获取无障碍服务
+ * Get Accessibility service
      */
     fun accessibilityService(): AccessibilityService? {
         return SelectToSpeakService.service
     }
 
     /**
-     * 检测权限
+ * Check Permission
      * */
     fun checkPermission(
         context: Activity,
@@ -77,12 +77,12 @@ class AMServiceManager {
     }
 
     /**
-     * 开启前台服务
-     * @param notificationImg 图标
+ * Start foreground service
+ * @param notification Img icon
      */
     fun startForegroundService(context: Activity, requestCode: Int, notificationImg: Int? = null) {
         this.notificationImg = notificationImg
-        //请求通知权限
+        //Request notification permission
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
             if (context.checkSelfPermission(Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
                 context.requestPermissions(
@@ -99,7 +99,7 @@ class AMServiceManager {
 
     private fun startForeground(context: Activity) {
         isStartService = true
-        //再次启动Service
+        //Start Service again
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
             val intentFive = Intent(context, AMForegroundService::class.java)
             context.startForegroundService(intentFive)
@@ -110,10 +110,10 @@ class AMServiceManager {
     }
 
     /**
-     * 关闭前台服务
+ * Stop foreground service
      */
     fun stopForegroundService(context: Context?) {
-        //停止Service
+        //Stop Service
         if (context != null) {
             if (isStartService) {
                 isStartService = false
@@ -131,7 +131,7 @@ class AMServiceManager {
     }
 
     /**
-     * 开启自启动权限
+ * Open autostart permission settings
      */
     fun gotoOppoAutoStartSettings(context: Context) {
         AlertDialog.Builder(context)
@@ -156,7 +156,7 @@ class AMServiceManager {
                         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
                         context.startActivity(intent)
                     } catch (e: Exception) {
-                        // fallback：跳转到应用详情页
+                        // fallback: navigate to the app details page
                         val fallbackIntent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
                         fallbackIntent.data = Uri.parse("package:${context.packageName}")
                         fallbackIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
@@ -172,9 +172,9 @@ class AMServiceManager {
     }
 
     /**
-     * 执行任务
-     * @param context 当前调用的actviity
-     * @param param - bizType 和 对应的bean(参数)
+ * Execute task
+ * @param context current calling activity
+ * @param param biz Type and the corresponding parameter bean
      */
     fun processTask(context: Activity, param: AMDataContainer) {
         AMCore.instance.context = context
@@ -190,21 +190,21 @@ class AMServiceManager {
     }
 
     /**
-     * 添加任务监听
+ * Add task listener
      * */
     fun addObserver(listener: IAMProcessListener) {
         AMCore.instance.addObserver(listener)
     }
 
     /**
-     * 移除任务监听
+ * Remove task listener
      * */
     fun removeObserver(listener: IAMProcessListener) {
         AMCore.instance.removeObserver(listener)
     }
 
     /**
-     * 移除所有监听
+ * Remove all listeners
      * */
     fun removeAllObserver() {
         AMCore.instance.removeAllObserver()

client/automation/src/main/java/com/coremate/opengui/automation/base/AMCore.kt

@@ -27,7 +27,7 @@ import kotlin.reflect.KClass
 internal class AMCore : IAMProcessListener {
 
     companion object {
-        //跳转到权限页面之前的activity
+        //Activity before navigating to the permission page
         @JvmStatic
         @SuppressLint("StaticFieldLeak")
         var activityByOp: Activity? = null
@@ -44,11 +44,11 @@ internal class AMCore : IAMProcessListener {
 
     private val mainHandler = Handler(Looper.getMainLooper())
 
-    ///待执行的（目前只存自动回复的任务）
+    ///Pending tasks; currently only auto-reply tasks are stored
     var waitTasks = mutableListOf<AMDataContainer>()
 
     /**
-     * 添加任务监听
+ * Add task listener
      * */
     fun addObserver(listener: IAMProcessListener) {
         synchronized(this) {
@@ -57,7 +57,7 @@ internal class AMCore : IAMProcessListener {
     }
 
     /**
-     * 移除任务监听
+ * Remove task listener
      * */
     fun removeObserver(listener: IAMProcessListener) {
         synchronized(this) {
@@ -66,7 +66,7 @@ internal class AMCore : IAMProcessListener {
     }
 
     /**
-     * 移除所有监听
+ * Remove all listeners
      * */
     fun removeAllObserver() {
         synchronized(this) {
@@ -76,19 +76,19 @@ internal class AMCore : IAMProcessListener {
 
     /////////////////////////////////////////////////////////////////////////////////
     //
-    //                      核心调度
+    // Core scheduler
     //
     /////////////////////////////////////////////////////////////////////////////////
 
-    ///消费
+    ///Consume
     fun consume() {
         if (amContext?.taskManager?.isStartTool == true) {
             return
         }
         if (waitTasks.isNotEmpty()) {
             val param = waitTasks.first()
             waitTasks.removeAt(0)
-            ///前置consume()操作
+            ///Pre-consume operation
             when (param.bizType) {
                 AMTaskBizType.TK_PUBLISH_VIDEO_MIX -> {
                     val clipboard =
@@ -138,7 +138,7 @@ internal class AMCore : IAMProcessListener {
     }
 
     /**
-     * 开始调度
+ * Start scheduling
      * */
     @JvmOverloads
     fun executes(
@@ -148,9 +148,9 @@ internal class AMCore : IAMProcessListener {
         threadFactory: ThreadFactory,
         data: AMDataContainer? = null,
     ) {
-        //先释放，防止之前的任务相关还存在
+        //Release first to clear any leftover task state
         destroyAll()
-        //设置上下文执行操作
+        //Set up context execution operations
         amContext = AMContext(
             activity = context,
             targetApps = targetApps,
@@ -162,20 +162,20 @@ internal class AMCore : IAMProcessListener {
         }.apply {
             taskManager.isStartTool = true
         }
-        //判断是否在app内
+        //Check whether inside the app
         if (AMContext.isInTargetApp) {
             Handler(Looper.getMainLooper()).post {
                 targetApps.first().openThirdApp()
-                //执行任务
+                //Execute task
                 AMLog.onEDebugLog("开始执行任务")
                 amContext?.taskManager?.onExecute(taskCls, data)
             }
         } else {
             targetApps.first().openThirdApp()
             Handler(Looper.getMainLooper()).postDelayed({
-                //强制在目标app内
+                //Force execution inside the target app
                 AMContext.isInTargetApp = true
-                //执行任务
+                //Execute task
                 AMLog.onEDebugLog("进入目标app后,开始执行任务")
                 amContext?.taskManager?.onExecute(taskCls, data)
             }, 850)
@@ -184,34 +184,34 @@ internal class AMCore : IAMProcessListener {
 
     /////////////////////////////////////////////////////////////////////////////////
     //
-    //                      服务检测
+    // Service check
     //
     /////////////////////////////////////////////////////////////////////////////////
 
     /**
-     * 辅助监测
+ * Helper monitoring
      * */
     fun onAccessibilityEvent(event: AccessibilityEvent) {
-        //过滤当前app的包名
+        //Filter the current app package name
         val packageName = AMServiceManager.applicationContext.packageName ?: ""
         if (event.packageName == packageName) {
             AMContext.isInTargetApp = false
             return
         }
-        //开始检测执行
+        //Start check execution
         amContext?.checkTargetAndDispatchTaskManager(event)
     }
 
     /**
-     * 服务中断
+ * Service interruption
      * */
     fun onAccessibilityInterrupt() {
         if (amContext?.taskManager?.taskState == AMTaskState.STOP) {
             AMLog.onEDebugLog(
                 "无障碍服务中断，但是任务已经结束",
             )
         } else {
-            //打印记录
+            //Print records
             AMLog.onEDebugLog(
                 "无障碍服务中断",
             )
@@ -223,12 +223,12 @@ internal class AMCore : IAMProcessListener {
 
     /////////////////////////////////////////////////////////////////////////////////
     //
-    //                      整体流程状态回调 IAMProcessListener
+    // Overall process status callback IAM Process Listener
     //
     /////////////////////////////////////////////////////////////////////////////////
 
     /**
-     * 任务开始
+ * Task started
      * */
     override fun onProcessTaskStart() {
         amContext?.taskManager?.setTaskResume = true
@@ -241,7 +241,7 @@ internal class AMCore : IAMProcessListener {
     }
 
     /**
-     * 任务暂停
+ * Task paused
      * */
     override fun onProcessTaskPause(isActive: Boolean) {
         amContext?.taskManager?.setTaskState(AMTaskState.PAUSE)
@@ -253,7 +253,7 @@ internal class AMCore : IAMProcessListener {
     }
 
     /**
-     * 任务恢复
+ * Task resumed
      * */
     override fun onProcessTaskResume() {
         amContext?.taskManager?.setTaskState(AMTaskState.RESUME)
@@ -265,11 +265,11 @@ internal class AMCore : IAMProcessListener {
     }
 
     /**
-     * 任务成功完成
-     * @param isSuccess 是否成功
-     * @param elapsedTime 耗时
-     * @param data 完成后的数据
-     * @param exception 异常
+ * Task completed successfully
+ * @param is Success whether execution succeeded
+ * @param elapsed Time elapsed time
+ * @param data data after completion
+ * @param exception exception
      * */
     override fun onProcessTaskFinish(
         isSuccess: Boolean,
@@ -279,12 +279,12 @@ internal class AMCore : IAMProcessListener {
     ) {
         synchronized(this) {
             AMLog.onEDebugLog("onProcessTaskFinish")
-            //任务结束 (完成之后，不用在抛出停止异常)
+            //Task ended; after completion, no need to throw a stop exception
             amContext?.taskManager?.setTaskState(AMTaskState.STOP)
             mainHandler.post {
-                //关闭核心功能
+                //Close core functionality
                 amContext?.taskManager?.isStartTool = false
-                //任务释放
+                //Release task resources
                 amContext?.destroyCompsAndTask()
                 listeners.forEach {
                     it.onProcessTaskFinish(isSuccess, elapsedTime, exception, sucData)
@@ -297,7 +297,7 @@ internal class AMCore : IAMProcessListener {
 
     /////////////////////////////////////////////////////////////////////////////////
     //
-    //                      释放所有
+    // Release all resources
     //
     /////////////////////////////////////////////////////////////////////////////////
 
@@ -308,7 +308,7 @@ internal class AMCore : IAMProcessListener {
         }
     }
 
-    //异常监听
+    //Exception listener
     private inner class ATThreadFactory :
         ThreadFactory {
         override fun newThread(r: Runnable?): Thread {
@@ -318,7 +318,7 @@ internal class AMCore : IAMProcessListener {
                     if (e is AMTaskException) {
                         when (e.reason) {
                             AMTaskErrorReason.PAUSE -> {
-                                //... 暂停不处理
+                                //... Pause is not handled
                             }
 
                             AMTaskErrorReason.STOP -> {