feat(git): 凭据/署名三端共用 + 写操作据退出码如实上报

凭据注入从「UI 按钮 -c http.extraHeader 按命令注入」改为 git 原生
credential.helper=store：App 把 Room 凭据落盘到容器持久挂载
(/root/.aicode/git-credentials)，buildContainerEnv 设 GIT_CONFIG_GLOBAL
指向持久 .gitconfig、provision 脚本写入 helper=store 并升 PROVISION_VERSION
到 v3 让老用户重 provision 自动补配。终端裸 git / AI ExecuteCommand /
UI 按钮三端读同一份凭据，无需各自注入。

署名删 GitUserSettingsRepository(DataStore)，以 git config 读写为唯一真源；
读 getUserName/Email 去 --global 按 local→global 自然解析（优先项目级、
无则退全局），写 setUserIdentity 优先 local、无则 global，UI 与命令行同源。

git 写操作(commit/stage/pull/push 等)改 gitChecked 据退出码判成败，非零
抛 GitCommandFailureException 携输出文本，runAction 据此如实显示「失败+
原因」而非误报成功；无署名时提交按钮置灰并提示先配置 user.name。

GitScreen 接 CredentialPromptDialog 弹窗:pull/push 缺凭据时弹登录框，
填完存 Room + syncAll 落盘 + 自动重试。versionName 1.1.0 -> 1.2.0。

Author: jieapi

app/build.gradle.kts

@@ -57,7 +57,7 @@ android {
         // 数据目录里的文件，PRoot 二进制将无法运行（同 Termux 的取舍）。代价：不能上 Google Play。
         targetSdk = 28
         versionCode = gitCommitCount()
-        versionName = "1.1.0"
+        versionName = "1.2.0"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
         vectorDrawables {

app/src/main/java/com/aicode/AIEditorApp.kt

@@ -7,6 +7,7 @@ import android.os.Build
 import com.aicode.core.util.AILogger
 import com.aicode.core.util.FileLogger
 import com.aicode.feature.agent.domain.container.ContainerInstaller
+import com.aicode.feature.credentials.data.GitCredentialsFileSync
 import com.aicode.feature.agent.domain.mcp.McpManager
 import com.aicode.feature.settings.data.repository.KeepaliveSettingsRepository
 import com.aicode.feature.settings.data.repository.LogSettingsRepository
@@ -35,6 +36,11 @@ class AIEditorApp : Application() {
     @Inject
     lateinit var mcpManager: McpManager
 
+    /** git 凭据/署名落盘同步器：启动即把 Room 凭据 + DataStore 署名写到容器持久挂载目录，
+     *  供终端/AI/UI 三端 git 经 credential.helper=store 共用，兜底 rootfs 升级或文件被删。 */
+    @Inject
+    lateinit var gitCredentialsFileSync: GitCredentialsFileSync
+
     /** 长驻作用域：持续把持久化的日志等级同步到 FileLogger。 */
     private val appScope = CoroutineScope(SupervisorJob() + Dispatchers.Default)
 
@@ -48,6 +54,11 @@ class AIEditorApp : Application() {
         appScope.launch {
             ContainerInstaller.extractDocs(this@AIEditorApp)
         }
+        // 启动即把 Room 凭据 + DataStore 署名落盘到容器持久挂载（/root/.aicode），
+        // 让终端裸 git / AI 工具 / UI 三端共用同一份凭据与署名配置。
+        appScope.launch {
+            gitCredentialsFileSync.syncAll()
+        }
         // 启动即加载持久化等级，并随设置页改动实时生效（唯一同步点）。
         appScope.launch {
             logSettings.levelFlow.collectLatest { FileLogger.setMinLevel(it) }

app/src/main/java/com/aicode/feature/agent/domain/container/LinuxContainerEngine.kt

@@ -103,7 +103,7 @@ class LinuxContainerEngine @Inject constructor(
          * 独立于 [ContainerInstaller] 的 rootfs INSTALL_VERSION：rootfs 版本升级会删 rootfs
          * （连带清掉本标记），故新 rootfs 必然重跑配置；同 rootfs 下改包清单则靠本版本号触发。
          */
-        private const val PROVISION_VERSION = "py3.12-pip-node-bash-curl-rg-v2"
+        private const val PROVISION_VERSION = "py3.12-pip-node-bash-curl-rg-gitcredhelper-v3"
 
         /** `apk add` 下载基础包的超时（毫秒）：首次配置需联网拉包，给足时间。 */
         private const val PROVISION_TIMEOUT_MS = 600_000L
@@ -209,6 +209,20 @@ class LinuxContainerEngine @Inject constructor(
         execCaptured(command, projectPath, timeoutMs).output
     }
 
+    /**
+     * 同 [runCommandSync]，但一并返回退出码（超时/异常时为 null）。供需要据退出码判成败的调用方
+     * 使用——如 git 写操作：git 非零退出码并非进程崩溃，[runCommandSync] 仅返回文本会让上层误报成功。
+     */
+    suspend fun runCommandSyncWithExit(
+        command: String,
+        projectPath: String? = null,
+        timeoutMs: Long = DEFAULT_TIMEOUT_MS
+    ): CommandResult = withContext(Dispatchers.IO) {
+        ensureInstalled()
+        val r = execCaptured(command, projectPath, timeoutMs)
+        CommandResult(r.output, r.exitCode)
+    }
+
     /** 一次容器内执行的结果：限幅后的完整输出 + 退出码（超时/异常时为 null）。 */
     data class CommandResult(val output: String, val exitCode: Int?)
 
@@ -325,6 +339,9 @@ class LinuxContainerEngine @Inject constructor(
             append("EOF\n")
             append("apk update\n")
             append("apk add --no-cache $PROVISION_PACKAGES\n")
+            // 装好 git 后配置全局 credential.helper，指向持久挂载的凭据文件，让终端/AI/UI 三端裸 git
+            // 自动带凭据（GIT_CONFIG_GLOBAL 已指 /root/.aicode/.gitconfig，写入不随升级丢失）。
+            append("git config --global credential.helper 'store --file=/root/.aicode/git-credentials'\n")
         }
 
         var exitCode: Int? = null
@@ -554,6 +571,10 @@ class LinuxContainerEngine @Inject constructor(
             // (PROOT_NO_SECCOMP=1) 反而在本设备触发过 ptrace(PEEKDATA) I/O error。
             "PATH" to "/usr/bin:/bin:/usr/sbin:/sbin",
             "HOME" to "/root",
+            // git 全局配置指向持久挂载里的 .gitconfig（/root/.aicode 绑定到宿主 filesDir/aicode，
+            // 跨 rootfs 升级不丢）。git-credentials 同放该目录，credential.helper=store 经此读。
+            // 让终端/AI/UI 三端 git 都读同一份配置与凭据，详见 GitCredentialsFileSync。
+            "GIT_CONFIG_GLOBAL" to "/root/.aicode/.gitconfig",
             "TERM" to "xterm-256color",
             "LANG" to "C.UTF-8"
         )

app/src/main/java/com/aicode/feature/credentials/data/GitCredentialsFileSync.kt

@@ -0,0 +1,83 @@
+package com.aicode.feature.credentials.data
+
+import android.content.Context
+import com.aicode.core.util.FileLogger
+import com.aicode.feature.credentials.domain.model.GitCredential
+import com.aicode.feature.credentials.domain.repository.CredentialRepository
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.first
+import java.io.File
+import java.net.URLEncoder
+import javax.inject.Inject
+import javax.inject.Singleton
+
+/**
+ * 把 Room 凭据落盘到容器持久挂载目录，让 UI / 终端 / AI 三端 git 经 `credential.helper=store` 共用同一份凭据。
+ *
+ * 宿主目录 `filesDir/aicode` 即容器内 `/root/.aicode`（[LinuxContainerEngine] 的 `-b` 绑定，跨 rootfs 升级不丢）。
+ * 容器 [buildContainerEnv] 已设 `GIT_CONFIG_GLOBAL=/root/.aicode/.gitconfig`，`.gitconfig` 里的
+ * `[credential] helper = store --file=/root/.aicode/git-credentials` 由 [provisionIfNeeded] 装容器时
+ * 跑一次 `git config --global` 写入（git 自身增量维护 ini）。
+ *
+ * 本类只负责**凭据文件** `git-credentials`（每 host 默认条一行），直接宿主侧写盘，不进容器、不跑 git 命令。
+ * `.gitconfig` 不由本类写——它由 git 命令维护：`[credential]` 段在容器初始化时写、`[user]` 署名段由用户经
+ * UI `git config --global user.name/email` 增量写。这样署名真源就是 `.gitconfig` 本身，UI 与命令行共用同一份，
+ * 不存在两套写入路径竞争。
+ *
+ * 调用方：[AIEditorApp] 启动兜底、[CredentialViewModel] 增删改后、[GitViewModel] 弹窗保存后。
+ */
+@Singleton
+class GitCredentialsFileSync @Inject constructor(
+    @param:ApplicationContext private val context: Context,
+    private val credentialRepository: CredentialRepository
+) {
+    private companion object {
+        const val TAG = "GitCredentialsFileSync"
+        /** 容器内 `.aicode` 挂载点对应的宿主目录（即文件实际落盘处）。 */
+        const val AICODE_DIR_NAME = "aicode"
+        const val CREDENTIALS_NAME = "git-credentials"
+    }
+
+    /** 目标宿主目录（容器内 /root/.aicode 的物理后端）。懒建。 */
+    private val aicodeDir: File get() = File(context.filesDir, AICODE_DIR_NAME).apply { mkdirs() }
+
+    /** 全量重建凭据文件。幂等、可重复调用。凭据为空时写空文件（不删文件，让 git 知无凭据）。 */
+    suspend fun syncAll() {
+        runCatching {
+            val creds = credentialRepository.getAll().first()
+            writeCredentials(creds)
+        }.onFailure { FileLogger.e(TAG, "同步 git 凭据落盘失败", it) }
+    }
+
+    /** 写 `git-credentials`：每 host 默认条一行，按 git-credential-store 格式；空凭据写空文件。 */
+    private fun writeCredentials(creds: List<GitCredential>) {
+        // 每 host 取默认条（isDefault 优先），无默认回退该 host 首条——与 findForHost 同语义。
+        val byHost: Map<String, GitCredential> = creds
+            .filter { it.host.isNotBlank() && it.username.isNotBlank() }
+            .sortedWith(compareByDescending<GitCredential> { it.isDefault }.thenBy { it.host })
+            .associateBy { it.host.trim().lowercase() }
+
+        val sb = StringBuilder()
+        byHost.values.sortedBy { it.host }.forEach { c ->
+            sb.append("https://")
+                .append(enc(c.username)).append(':').append(enc(c.token))
+                .append('@').append(c.host.trim().lowercase())
+                .append('\n')
+        }
+        writeAtomically(File(aicodeDir, CREDENTIALS_NAME), sb.toString())
+    }
+
+    /** 先写 `.tmp` 再 rename，避免容器侧/git 读到半截文件。 */
+    private fun writeAtomically(target: File, content: String) {
+        val tmp = File(target.parentFile, "${target.name}.tmp")
+        tmp.writeText(content)
+        if (target.exists()) target.delete()
+        if (!tmp.renameTo(target)) {
+            // 兜底：rename 失败（某些 FS 跨 inode）则直接写目标。
+            target.writeText(content)
+            tmp.delete()
+        }
+    }
+
+    private fun enc(part: String): String = URLEncoder.encode(part, "UTF-8")
+}

app/src/main/java/com/aicode/feature/credentials/data/GitUserSettingsRepository.kt

@@ -1,5 +1,7 @@
 package com.aicode.feature.credentials.domain.model
 
+import kotlin.random.Random
+
 /** 一条 Git 远程仓库凭据的领域模型。无 Android 依赖。 */
 data class GitCredential(
     val id: String,
@@ -11,3 +13,7 @@ data class GitCredential(
     val createdAt: Long = 0,
     val updatedAt: Long = 0
 )
+
+/** 生成新凭据 id：时间戳 + 随机后缀（避免同毫秒冲突），供凭据编辑页与 git 拉取/推送缺凭据弹窗共用。 */
+fun newCredentialId(): String = "${System.currentTimeMillis()}${Random.nextInt(1000, 9999)}"
+

app/src/main/java/com/aicode/feature/credentials/domain/model/GitCredential.kt

@@ -3,85 +3,92 @@ package com.aicode.feature.credentials.presentation
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.aicode.core.util.FileLogger
-import com.aicode.feature.credentials.data.GitUserSettingsRepository
+import com.aicode.feature.credentials.data.GitCredentialsFileSync
 import com.aicode.feature.credentials.domain.model.GitCredential
 import com.aicode.feature.credentials.domain.repository.CredentialRepository
 import com.aicode.feature.git.domain.GitRepository
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.SharingStarted
 import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.asStateFlow
 import kotlinx.coroutines.flow.combine
-import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.flow.update
 import kotlinx.coroutines.launch
 import javax.inject.Inject
-import kotlin.random.Random
 
 /**
  * 凭据页 UI 编排：凭据 CRUD + 提交署名(user.name/email) 配置。
  *
- * 提交署名以 [GitUserSettingsRepository](DataStore) 为真源；用户保存后同步落 `git config --global`
- * （[GitRepository.setUserGlobal]）。进页 init 时若 DataStore 有值则补一次同步，保证 rootfs 升级丢
- * `.gitconfig` 后能自动恢复——单向「DataStore → git」，DataStore 空时不动容器既有配置。
+ * 提交署名读写走 `git config`（[GitRepository.setUserIdentity] / [getUserName] / [getUserEmail]）：
+ * **优先项目级**（当前工作区 /workspace/.git/config），无则退全局（持久挂载 /root/.aicode/.gitconfig）。
+ * UI 与终端敲 `git config user.name` 读到的是同一份署名——优先项目级、无则退全局，无两套源头竞争。
  */
 @HiltViewModel
 class CredentialViewModel @Inject constructor(
     private val credentialRepository: CredentialRepository,
-    private val userSettings: GitUserSettingsRepository,
-    private val gitRepository: GitRepository
+    private val gitRepository: GitRepository,
+    private val fileSync: GitCredentialsFileSync
 ) : ViewModel() {
 
     private companion object { const val TAG = "CredentialViewModel" }
 
     data class UiState(
         val credentials: List<GitCredential> = emptyList(),
+        /** 容器 git config 当前 user.name，作编辑框初值。 */
         val userName: String = "",
+        /** 容器 git config 当前 user.email，作编辑框初值。 */
         val userEmail: String = "",
-        /** 容器内 `git config --global` 实际的 user.name，用于回显「git 实际值」。 */
+        /** 容器 `git config --global` 实际 user.name，回显「git 实际值」（与 userName 同源）。 */
         val globalUserName: String = "",
         val toast: String? = null
     )
 
-    // combine 持久流外，单独用一个 MutableStateFlow 承载「全局实际值」与 toast 这类非 DataStore 来源的状态。
+    // 非反应式来源的状态：git config 读出的署名、toast。credentials 走 Room Flow。
     private val _extra = MutableStateFlow(Extra())
-    private data class Extra(val globalUserName: String = "", val toast: String? = null)
+    private data class Extra(
+        val userName: String = "",
+        val userEmail: String = "",
+        val globalUserName: String = "",
+        val toast: String? = null
+    )
 
-    val state: StateFlow<UiState> = combine(
-        credentialRepository.getAll(),
-        userSettings.userNameFlow,
-        userSettings.userEmailFlow,
-        _extra
-    ) { creds, name, email, extra ->
+    val state: StateFlow<UiState> = combine(credentialRepository.getAll(), _extra) { creds, extra ->
         UiState(
             credentials = creds,
-            userName = name,
-            userEmail = email,
+            userName = extra.userName,
+            userEmail = extra.userEmail,
             globalUserName = extra.globalUserName,
             toast = extra.toast
         )
     }.stateIn(viewModelScope, SharingStarted.Eagerly, UiState())
 
-    init { syncGlobalIdentity() }
+    init {
+        refreshIdentity()
+        // 兜底：把 Room 凭据落盘到容器持久挂载，保证升级后或文件被删时仍就位（详见 GitCredentialsFileSync）。
+        viewModelScope.launch { fileSync.syncAll() }
+    }
 
-    /** 把 DataStore 的署名（若非空）同步进容器 git 全局配置，并刷新实际值回显。 */
-    private fun syncGlobalIdentity() {
+    /** 从容器 git config 读取当前署名刷新 UI（编辑框初值 + 实际值回显）。可重入，进凭据页时调一次兜住终端改动。 */
+    fun refreshIdentity() {
         viewModelScope.launch {
             runCatching {
-                val name = userSettings.userNameFlow.first()
-                val email = userSettings.userEmailFlow.first()
-                if (name.isNotBlank() || email.isNotBlank()) gitRepository.setUserGlobal(name, email)
-                _extra.update { it.copy(globalUserName = gitRepository.getGlobalUserName()) }
-            }.onFailure { FileLogger.w(TAG, "同步全局署名失败: ${it.message}") }
+                _extra.update {
+                    it.copy(
+                        userName = gitRepository.getUserName(),
+                        userEmail = gitRepository.getUserEmail(),
+                        globalUserName = gitRepository.getUserName()
+                    )
+                }
+            }.onFailure { FileLogger.w(TAG, "读取 git 全局署名失败: ${it.message}") }
         }
     }
 
     fun saveCredential(credential: GitCredential) {
         viewModelScope.launch {
             try {
                 credentialRepository.save(credential)
+                fileSync.syncAll() // 落盘到容器持久挂载，UI/终端/AI 三端共用
                 toast("凭据已保存")
             } catch (e: Exception) {
                 FileLogger.e(TAG, "保存凭据失败", e)
@@ -93,21 +100,24 @@ class CredentialViewModel @Inject constructor(
     fun deleteCredential(id: String) {
         viewModelScope.launch {
             credentialRepository.delete(id)
+            fileSync.syncAll() // 删凭据后从落盘文件移除，否则终端/AI 仍能用旧凭据
             toast("凭据已删除")
         }
     }
 
     fun setDefault(id: String, isDefault: Boolean) {
-        viewModelScope.launch { credentialRepository.setDefault(id, isDefault) }
+        viewModelScope.launch {
+            credentialRepository.setDefault(id, isDefault)
+            fileSync.syncAll() // 切默认后落盘文件随之更新，三端按新默认条带凭据
+        }
     }
 
-    /** 保存提交署名：写 DataStore 真源 + 同步落 git 全局配置 + 刷新实际值回显。 */
+    /** 保存提交署名：跑 `git config --global` 写入 .gitconfig 真源 + 刷新回显。UI 与命令行同一文件。 */
     fun saveUserIdentity(name: String, email: String) {
         viewModelScope.launch {
             try {
-                userSettings.setUserIdentity(name, email)
-                gitRepository.setUserGlobal(name, email)
-                _extra.update { it.copy(globalUserName = gitRepository.getGlobalUserName()) }
+                gitRepository.setUserIdentity(name, email)
+                refreshIdentity()
                 toast("署名已保存到 git 全局配置")
             } catch (e: Exception) {
                 FileLogger.e(TAG, "保存署名失败", e)
@@ -120,6 +130,3 @@ class CredentialViewModel @Inject constructor(
 
     private fun toast(msg: String) = _extra.update { it.copy(toast = msg) }
 }
-
-/** 生成新凭据 id：时间戳 + 随机后缀（避免同毫秒冲突），仿现有 entity 主键风格。 */
-internal fun newCredentialId(): String = "${System.currentTimeMillis()}${Random.nextInt(1000, 9999)}"