feat: 浏览器 UA 设置、WebDAV 备份同步、待办增强与多项 Bug 修复

.github/workflows/docs-deploy.yml

@@ -4,13 +4,10 @@ name: Deploy Docs
 # Vercel 的 Git 自动部署已在 docs-site/vercel.json 用 git.deploymentEnabled=false 关闭，
 # 生产部署统一由本工作流用 Vercel CLI 完成。
 # 前置配置（GitHub 仓库 Secret）：VERCEL_TOKEN、VERCEL_ORG_ID、VERCEL_PROJECT_ID
-# Vercel 项目需设置 Root Directory = docs-site。CLI 必须从仓库根运行（官方 monorepo 指南）：
-# 在子目录里跑 vercel 会读不到 docs-site/vercel.json，退回 VitePress preset 默认命令而报 vitepress not found。
 on:
   push:
     tags:
       - 'v*'
-  workflow_dispatch:
 
 jobs:
   deploy:
@@ -19,6 +16,10 @@ jobs:
     env:
       VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
       VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+    # vercel.json / package-lock.json 都在 docs-site，项目根即此处。
+    defaults:
+      run:
+        working-directory: docs-site
     steps:
       - name: Checkout
         uses: actions/checkout@v4

app/src/main/assets/prompts/60-tools-and-paths.md

@@ -23,7 +23,9 @@
 - AI 配置目录为 `~/.aicode`；工具完整输出日志在 `~/.aicode/tool-output/...`。
 
 ## 子代理
-- 用 `task` 创建子代理并行工作，适用于可独立完成、不依赖当前对话细节的子任务（大范围调研、批量定位、跑验证、查资料）。通常开 1–2 个，最多同时运行 5 个。
+- **优先考虑用子代理**：只要存在可独立完成、不依赖当前对话细节的子任务（大范围调研、批量定位、并行探索多个方向、跑验证、查资料、独立实现），就主动开子代理去做，而不是自己在主会话里串行完成。宁可多开几个也不要因为“自己也能做”而全部亲历亲为。
+- 子代理适合：探索/调研代码、并行对比多个方案、跑构建/测试、独立的小改动；主会话保留决策、跨子任务综合与最终收口。
+- 用 `task` 创建子代理并行工作。通常开 2–3 个，最多同时运行 5 个。
 - 子代理看不到本会话的任何上下文，`prompt` 必须自带：目标与完成标准、已知上下文（文件路径、已核实结论、已排除方向、用户约束）、边界（不该动什么）、期望产出。
 - 只能读到子代理的最后一条回复；子代理完成后系统会通知，不要轮询。可用 `task(action="send", ...)` 追加指令；子代理也可用 `messageParent` 主动汇报。
 - 子代理继承当前模式（PLAN 下同样只读），不能嵌套创建子代理。

app/src/main/java/com/aicode/feature/agent/domain/session/MessagePersistenceUseCase.kt

@@ -9,6 +9,8 @@ import com.aicode.feature.agent.domain.model.CONTEXT_SUMMARY_LEGACY_PREFIX
 import com.aicode.feature.agent.domain.tool.ToolCall
 import com.aicode.feature.agent.presentation.AgentAttachment
 import com.aicode.feature.agent.presentation.MessageRole
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
 import kotlinx.serialization.decodeFromString
 import kotlinx.serialization.encodeToString
 import kotlinx.serialization.json.Json
@@ -165,6 +167,12 @@ class MessagePersistenceUseCase @Inject constructor(
         /** 内嵌 base64 图片 data URL（`data:image/...;base64,...`）。 */
         private val INLINE_BASE64_IMAGE = Regex("""data:image/[a-zA-Z0-9.+-]+;base64,[A-Za-z0-9+/=\r\n]+""")
 
+        internal fun orderHistoryEntities(entities: List<AgentMessageEntity>): List<AgentMessageEntity> {
+            // 聊天按压缩触发时间展示；模型必须先读摘要，再读保留历史。
+            val (compaction, retained) = entities.partition { it.isCompactionMarker || it.isContextSummary }
+            return compaction + retained
+        }
+
         /** UTF-8 单字符最多占 3 字节，故 [String.length] 的三倍不超上限时无需实际编码即可放行。 */
         private fun definitelyFits(raw: String, maxBytes: Int): Boolean =
             raw.length.toLong() * 3 <= maxBytes
@@ -228,7 +236,9 @@ class MessagePersistenceUseCase @Inject constructor(
                 }
             }
         }
-        val messages = buildHistoryUncached(sessionId, pendingToolMarker)
+        val messages = withContext(Dispatchers.IO) {
+            buildHistoryUncached(sessionId, pendingToolMarker)
+        }
         synchronized(historyCache) {
             historyCache[sessionId] = HistoryEntry(version, pendingToolMarker, messages)
         }
@@ -238,6 +248,7 @@ class MessagePersistenceUseCase @Inject constructor(
     private suspend fun buildHistoryUncached(sessionId: String, pendingToolMarker: String): List<AgentMessage> {
         val entities = agentMessageDao.getMessagesBySessionOnce(sessionId)
             .filter { !it.isCompacted && !it.isContextExcluded }
+            .let { orderHistoryEntities(it) }
 
         // 第一遍：求 assistant 声明的 toolCallId 与 tool 结果 toolCallId 的交集。
         val declaredIds = mutableSetOf<String>()

app/src/main/java/com/aicode/feature/agent/domain/tool/browser/BrowserManager.kt

@@ -23,6 +23,7 @@ import android.webkit.WebResourceRequest
 import android.webkit.WebView
 import android.webkit.WebViewClient
 import android.widget.FrameLayout
+import androidx.webkit.UserAgentMetadata
 import androidx.webkit.WebSettingsCompat
 import androidx.webkit.WebViewFeature
 import com.aicode.R
@@ -115,6 +116,35 @@ class BrowserManager @Inject constructor(
         private const val DIALOG_TIMEOUT_MS = 30_000L
         const val MAX_TABS = 10
 
+        /**
+         * 自动化特征遮蔽脚本：在 UA 非默认时于页面开始加载时注入，
+         * 让站点看到的 navigator.webdriver / chrome 等与真实浏览器一致。
+         */
+        private val AUTOMATION_MASK_JS = """
+            (function(){
+                try {
+                    Object.defineProperty(Navigator.prototype, 'webdriver', { get: function(){ return false; }, configurable: true });
+                } catch(e){}
+                try {
+                    if (window.chrome === undefined) { window.chrome = { runtime: {} }; }
+                } catch(e){}
+                try {
+                    var origQuery = window.navigator.permissions && window.navigator.permissions.query;
+                    if (origQuery) {
+                        window.navigator.permissions.query = function(params){
+                            if (params && params.name === 'notifications') {
+                                return Promise.resolve({ state: Notification.permission });
+                            }
+                            return origQuery.apply(this, arguments);
+                        };
+                    }
+                } catch(e){}
+                try {
+                    Object.defineProperty(navigator, 'languages', { get: function(){ return ['zh-CN','zh','en']; }, configurable: true });
+                } catch(e){}
+            })();
+        """.trimIndent()
+
         /** 地址栏输入不像网址时，作为关键词交给该搜索引擎（Bing）。 */
         private const val SEARCH_ENGINE_URL = "https://www.bing.com/search?q="
 
@@ -168,7 +198,17 @@ class BrowserManager @Inject constructor(
 
     private val nightMode: Boolean get() = nightModeOverride ?: appDarkTheme
 
+    /** 当前生效的 UA 预设（由设置页推送；默认系统默认）。 */
+    @Volatile
+    private var userAgent: BrowserUserAgent = BrowserUserAgent.DEFAULT
+
     private val _state = MutableStateFlow(BrowserState())
+
+    /** 由设置页推送 UA 预设，并立即应用到所有标签页。 */
+    fun setUserAgent(userAgent: BrowserUserAgent) {
+        this.userAgent = userAgent
+        tabs.forEach { tab -> applyUserAgent(tab.webView) }
+    }
     val state: StateFlow<BrowserState> = _state.asStateFlow()
 
     /** 选择器辅助函数，prepend 到所有需要选择器的 JS 中。支持 ref= / text= / text*= / role= / xpath= / CSS。 */
@@ -273,6 +313,10 @@ class BrowserManager @Inject constructor(
                 tab.error = null
                 view?.setBackgroundColor(if (nightMode) NIGHT_BG_COLOR else Color.WHITE)
                 if (view != null && nightMode) applyNightModeTo(view)
+                // 非系统默认 UA 时，页面开始加载即注入自动化特征遮蔽（尽早生效）。
+                if (view != null && userAgent != BrowserUserAgent.DEFAULT) {
+                    runCatching { view.evaluateJavascript(AUTOMATION_MASK_JS, null) }
+                }
                 publishState()
             }
 
@@ -372,6 +416,7 @@ class BrowserManager @Inject constructor(
         wv.setLayerType(View.LAYER_TYPE_HARDWARE, null)
         wv.setBackgroundColor(if (nightMode) NIGHT_BG_COLOR else Color.WHITE)
         applyDarkThemeToSettings(wv)
+        applyUserAgent(wv)
         wv.addJavascriptInterface(BrowserJsBridge(tabId), "__browserBridge__")
 
         // 设置 Headless 默认尺寸，保证后台与离屏测试可用
@@ -466,6 +511,47 @@ class BrowserManager @Inject constructor(
     private fun webViewThemeRes(night: Boolean): Int =
         if (night) R.style.Theme_AICode_WebView_Dark else R.style.Theme_AICode_WebView
 
+    // ================= User-Agent =================
+
+    /**
+     * 应用当前 UA 预设。
+     *
+     * [BrowserUserAgent.DEFAULT]：还原系统默认 UA（清空自定义 UA，并清空客户端提示覆盖）。
+     * 其余预设：套用对应 UA 字符串与 sec-ch-ua 客户端提示平台信息；
+     * 自动化特征遮蔽由 [AUTOMATION_MASK_JS] 在页面开始时注入。
+     */
+    private fun applyUserAgent(wv: WebView) {
+        val ua = userAgent
+        val uaString = ua.userAgent
+        if (uaString == null) {
+            wv.settings.userAgentString = null
+            runCatching {
+                WebSettingsCompat.setUserAgentMetadata(
+                    wv.settings,
+                    UserAgentMetadata.Builder().build()
+                )
+            }
+            return
+        }
+        wv.settings.userAgentString = uaString
+        runCatching {
+            val builder = UserAgentMetadata.Builder()
+                .setBrandVersionList(
+                    listOf(
+                        UserAgentMetadata.BrandVersion.Builder().setBrand("Google Chrome").setMajorVersion("131").build(),
+                        UserAgentMetadata.BrandVersion.Builder().setBrand("Chromium").setMajorVersion("131").build(),
+                        UserAgentMetadata.BrandVersion.Builder().setBrand("Not_A Brand").setMajorVersion("24").build()
+                    )
+                )
+                .setMobile(ua.mobile)
+                .setBitness(ua.bitness)
+            ua.platform?.let { builder.setPlatform(it) }
+            ua.platformVersion?.let { builder.setPlatformVersion(it) }
+            ua.architecture?.let { builder.setArchitecture(it) }
+            WebSettingsCompat.setUserAgentMetadata(wv.settings, builder.build())
+        }
+    }
+
     /**
      * 内核级暗色设置。prefers-color-scheme 实际由 WebView 主题的 isLightTheme 决定（见 [webViewThemeRes]），
      * 这里设置算法调暗并借此触发 WebView 重读偏好——夜间模式切换后需要一次 settings 变更才会下发新偏好。

app/src/main/java/com/aicode/feature/agent/domain/tool/browser/BrowserTool.kt

@@ -20,7 +20,8 @@ import javax.inject.Inject
 
 class BrowserTool @Inject constructor(
     private val browserManager: BrowserManager,
-    private val fileAccess: FileAccessProvider
+    private val fileAccess: FileAccessProvider,
+    private val browserSettingsRepository: com.aicode.feature.settings.data.repository.BrowserSettingsRepository
 ) : AgentTool() {
 
     private companion object {
@@ -101,6 +102,14 @@ class BrowserTool @Inject constructor(
             ?: return ToolResult.Error("缺少必需参数：action", "MISSING_ACTION")
         val tabId = args["tabId"]?.jsonPrimitive?.contentOrNull?.trim()
 
+        // AI 控制浏览器权限：用户在设置页逐 action 关闭的项，执行前直接拒绝。
+        if (!browserSettingsRepository.isActionEnabled(action)) {
+            return ToolResult.Error(
+                "浏览器操作「$action」已被用户在设置中禁用",
+                "ACTION_DISABLED_BY_USER"
+            )
+        }
+
         return try {
             executeAction(action, tabId, args)
         } catch (e: IllegalStateException) {

app/src/main/java/com/aicode/feature/agent/domain/tool/browser/BrowserUserAgent.kt

@@ -0,0 +1,109 @@
+package com.aicode.feature.agent.domain.tool.browser
+
+/**
+ * 浏览器 User-Agent 预设。
+ *
+ * 用户在「设置 → 运行环境 → 浏览器 → UA 设置」中选择，浏览器新建标签时套用对应的
+ * User-Agent 字符串与客户端提示（client hints）平台信息。
+ *
+ * [DEFAULT] 表示不覆盖，使用系统 WebView 的默认 UA；其余为常见设备/系统 UA。
+ * [WINDOWS_10] 与 [WINDOWS_11] 的 UA 字符串一致（Windows 11 的 UA 仍报 Windows NT 10.0），
+ * 区别体现在客户端提示的 platform-version。
+ */
+enum class BrowserUserAgent(
+    val id: String,
+    /** Android 手机 UA。 */
+    val userAgent: String?,
+    /** 客户端提示 sec-ch-ua-platform（含引号按原样传入），null 表示不设置。 */
+    val platform: String? = null,
+    val platformVersion: String? = null,
+    val architecture: String? = null,
+    val bitness: Int = 64,
+    val mobile: Boolean = false
+) {
+    /** 系统默认，不覆盖 UA。 */
+    DEFAULT("default", null),
+
+    /** 安卓手机。 */
+    ANDROID_PHONE(
+        id = "android_phone",
+        userAgent = "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 " +
+            "(KHTML, like Gecko) Chrome/131.0.0.0 Mobile Safari/537.36",
+        platform = "Android",
+        platformVersion = "14.0.0",
+        mobile = true
+    ),
+
+    /** 安卓平板。 */
+    ANDROID_TABLET(
+        id = "android_tablet",
+        userAgent = "Mozilla/5.0 (Linux; Android 14; Pixel Tablet) AppleWebKit/537.36 " +
+            "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        platform = "Android",
+        platformVersion = "14.0.0",
+        mobile = false
+    ),
+
+    /** Windows 10 电脑。 */
+    WINDOWS_10(
+        id = "windows_10",
+        userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " +
+            "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        platform = "Windows",
+        platformVersion = "10.0.0",
+        architecture = "x86"
+    ),
+
+    /** Windows 11 电脑（UA 同 Win10，客户端提示版本不同）。 */
+    WINDOWS_11(
+        id = "windows_11",
+        userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " +
+            "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        platform = "Windows",
+        platformVersion = "13.0.0",
+        architecture = "x86"
+    ),
+
+    /** Mac 电脑（Intel 芯片）。 */
+    MAC_INTEL(
+        id = "mac_intel",
+        userAgent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " +
+            "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        platform = "macOS",
+        platformVersion = "15.0.0",
+        architecture = "x86"
+    ),
+
+    /** Mac 电脑（Apple 芯片）。 */
+    MAC_APPLE_SILICON(
+        id = "mac_apple_silicon",
+        userAgent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " +
+            "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        platform = "macOS",
+        platformVersion = "15.0.0",
+        architecture = "arm"
+    );
+
+    companion object {
+        fun fromId(id: String?): BrowserUserAgent =
+            entries.firstOrNull { it.id == id } ?: DEFAULT
+    }
+}
+
+/**
+ * 浏览器工具可被 AI 调用的全部 action（与 [com.aicode.feature.agent.domain.tool.browser.BrowserTool] 的 actionEnum 一致）。
+ *
+ * 作为「AI 控制浏览器权限」开关的唯一事实源：设置页按此顺序逐项渲染开关，
+ * 权限默认全开；用户关闭某项后，BrowserTool 执行时直接拒绝该 action。
+ */
+object BrowserActionCatalog {
+    /** action 名，顺序即设置页展示顺序。 */
+    val ALL: List<String> = listOf(
+        "navigate", "evaluate",
+        "click", "fill", "select", "hover", "press",
+        "getText", "getHtml", "getBackbone", "screenshot", "console", "wait",
+        "scroll", "dialog",
+        "back", "forward", "reload",
+        "newTab", "closeTab", "selectTab", "listTabs"
+    )
+}