dsh-config-manager 0.2.1 → 0.2.3

package/lib/core/messages-core.js

@@ -53,7 +53,7 @@ export const zh = {
     'core.journal.notTerminal': 'moveToCompleted 仅接受 terminal journal: {opId} state={state}',
     // ---------- run-registry ----------
     'core.run.autosyncBusy': '自动同步已在进行中',
-    'core.run.syncApplyBusy': '一键同步已在进行中',
+    'core.run.syncApplyBusy': '正在从远端合并',
     'core.run.backupScheduleBusy': '定时备份已在进行中',
     'core.run.restoreBusy': '快照恢复已在进行中（请等待当前恢复完成）',
     'core.run.recoveryBusy': '恢复/回滚已在进行中（请等待当前恢复完成）',
@@ -349,7 +349,7 @@ export const en = {
     'core.journal.notTerminal': 'moveToCompleted only accepts a terminal journal: {opId} state={state}',
     // ---------- run-registry ----------
     'core.run.autosyncBusy': 'Automatic sync is already in progress',
-    'core.run.syncApplyBusy': 'One-click sync is already in progress',
+    'core.run.syncApplyBusy': 'Merge from remote is already in progress',
     'core.run.backupScheduleBusy': 'Scheduled backup is already in progress',
     'core.run.restoreBusy': 'Snapshot restore is already in progress (wait for the current restore to finish)',
     'core.run.recoveryBusy': 'Recovery/rollback is already in progress (wait for the current recovery to finish)',

package/lib/core/messages.d.ts

@@ -409,6 +409,7 @@ export declare const zh: {
     readonly 'sync.git.cmdFailed': 'git {args} 失败 (exit {code}): {err}';
     readonly 'sync.git.pushTokenRequired': '推送需要访问令牌：远端是 http(s) 仓库，但本机没有可用的令牌（拉取公开仓库可以匿名完成，推送必须认证）。请在「同步 → 通道配置」里登录 GitHub 或填入访问令牌后重试。';
     readonly 'sync.git.pushAuthFailed': '推送认证失败：{err}。请确认令牌有效且对该仓库有写权限（账号密码推送已被远端禁用）；拉取成功不代表令牌可用 —— 公开仓库匿名即可拉取。可在「同步 → 通道配置」里重新登录或更换令牌。';
+    readonly 'sync.git.credentialHelperBlocked': 'git 在本机无法执行 credential helper（它需要 shell，而当前平台不允许从应用目录执行脚本/二进制），改用 HTTP 认证头重试也没成功。请确认 git 版本不低于 2.31（环境变量注入配置需要），或把仓库地址换成 ssh。原始错误：{err}';
     readonly 'sync.git.repoUrlInvalid': '无法解析 repoUrl（http(s) 仓库必须为合法 URL）: {url}';
     readonly 'sync.git.invalidSnapshotId': '非法快照 id: {id}（仅允许字母数字开头，字符限 . _ -）';
     readonly 'sync.webdav.baseUrlRequired': 'baseUrl 必须是非空字符串';

package/lib/core/messages.js

@@ -408,6 +408,9 @@ export const zh = {
     // 推送认证（真机：公开仓库拉取可匿名成功、推送必失败，git 原文只说「Invalid username or token」）
     'sync.git.pushTokenRequired': '推送需要访问令牌：远端是 http(s) 仓库，但本机没有可用的令牌（拉取公开仓库可以匿名完成，推送必须认证）。请在「同步 → 通道配置」里登录 GitHub 或填入访问令牌后重试。',
     'sync.git.pushAuthFailed': '推送认证失败：{err}。请确认令牌有效且对该仓库有写权限（账号密码推送已被远端禁用）；拉取成功不代表令牌可用 —— 公开仓库匿名即可拉取。可在「同步 → 通道配置」里重新登录或更换令牌。',
+    // issue #120：credential helper 必须经 shell 执行，Android 上 git 的 shell 路径不存在（askpass 又要 exec
+    // 权限，Android 10+ 禁执行应用目录文件）→ 已改用 HTTP 认证头重试；仍失败只能点名平台原因，别引向「令牌坏了」。
+    'sync.git.credentialHelperBlocked': 'git 在本机无法执行 credential helper（它需要 shell，而当前平台不允许从应用目录执行脚本/二进制），改用 HTTP 认证头重试也没成功。请确认 git 版本不低于 2.31（环境变量注入配置需要），或把仓库地址换成 ssh。原始错误：{err}',
     'sync.git.repoUrlInvalid': '无法解析 repoUrl（http(s) 仓库必须为合法 URL）: {url}',
     'sync.git.invalidSnapshotId': '非法快照 id: {id}（仅允许字母数字开头，字符限 . _ -）',
     'sync.webdav.baseUrlRequired': 'baseUrl 必须是非空字符串',
@@ -896,6 +899,7 @@ export const en = {
     'sync.git.cmdFailed': 'git {args} failed (exit {code}): {err}',
     'sync.git.pushTokenRequired': 'Push requires an access token, but none is available on this machine (public repositories can be fetched anonymously; pushing always needs authentication). Sign in to GitHub or paste an access token under Sync → Channel configuration, then retry.',
     'sync.git.pushAuthFailed': 'Push authentication failed: {err}. Check that the token is valid and has write access to this repository (password authentication is disabled by the remote); a successful pull does not prove the token works — public repositories can be fetched anonymously. Sign in again or replace the token under Sync → Channel configuration.',
+    'sync.git.credentialHelperBlocked': 'git cannot run the credential helper on this machine (it needs a shell, and this platform does not allow executing scripts/binaries from the app directory), and retrying with an HTTP authorization header did not work either. Make sure git is 2.31 or newer (injecting config through environment variables needs it) or switch the repository address to ssh. Original error: {err}',
     'sync.git.repoUrlInvalid': 'Cannot parse repoUrl (http(s) repositories must be valid URLs): {url}',
     'sync.git.invalidSnapshotId': 'Invalid snapshot id: {id} (must start with an alphanumeric; only . _ - allowed)',
     'sync.webdav.baseUrlRequired': 'baseUrl must be a non-empty string',

package/lib/index.d.ts

@@ -77,7 +77,7 @@ export declare const name = "config-manager";
 /** Services required before the engine can mount (present in every profile). */
 export declare const inject: string[];
 /** Plugin version, kept in sync with package.json ("version"). */
-export declare const PLUGIN_VERSION = "0.2.1";
+export declare const PLUGIN_VERSION = "0.2.3";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照

package/lib/index.js

@@ -136,7 +136,7 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.2.1';
+export const PLUGIN_VERSION = '0.2.3';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**

package/lib/market/git-file-writer.js

@@ -28,6 +28,7 @@ import { quoteGitValue } from '../utils/git-quote.js';
 import { withWorkdirLock, WorkdirLockError } from '../utils/workdir-lock.js';
 import { fastForwardFetchArgs, fastForwardMergeArgs, isMissingRemoteRefError, parseCurrentBranch } from '../utils/git-fast-forward.js';
 import { marketMsg } from './messages-market.js';
+import { clearDirContents, credentialHeaderEnv, isEmptyDir, isCredentialExecFailure } from '../sync/git/credential-auth.js';
 const execFileAsync = promisify(execFile);
 const DEFAULT_TIMEOUT_MS = 60_000;
 const DEFAULT_AUTHOR = { name: 'DSH Config Manager', email: 'publish@dsh.local' };
@@ -46,6 +47,8 @@ const defaultExec = async (cmd, args, opts) => {
             maxBuffer: 16 * 1024 * 1024,
             windowsHide: true,
             encoding: 'utf8',
+            // issue #120：credential helper 走不了 shell 时改用 env 注入认证头重试（追加在继承的 process.env 上）
+            env: opts.env === undefined ? undefined : { ...process.env, ...opts.env },
         });
         return { stdout: String(stdout), stderr: String(stderr), code: 0 };
     }
@@ -169,7 +172,7 @@ export class GitFileWriterClient {
         const pushArgs = branch !== ''
             ? ['push', '-u', 'origin', branch, ...(call.force === true ? ['--force-with-lease'] : [])]
             : ['push', '-u', 'origin', 'HEAD'];
-        const push = await this.runGit(pushArgs, { cwd: call.workDir, withCredential: true, token, mask });
+        const push = await this.runGit(pushArgs, { cwd: call.workDir, withCredential: true, token, mask, repoUrl: call.repoUrl });
         if (push.code !== 0) {
             throw new GitFileWriterError(mask(marketMsg('market.gitWriter.pushFailed', { stderr: push.stderr })));
         }
@@ -189,8 +192,21 @@ export class GitFileWriterClient {
             extra = cred.extraArgs;
             cleanup = cred.cleanup;
         }
+        // issue #120：只有「命令开跑前目录是空的」才敢在重试前清空 —— 绝不删用户文件。
+        const cloneTargetWasEmpty = args[0] === 'clone' ? await isEmptyDir(cwd) : false;
         try {
-            const result = await this.exec(this.gitBin, [...extra, ...args], { cwd, timeoutMs: this.timeoutMs });
+            let result = await this.exec(this.gitBin, [...extra, ...args], { cwd, timeoutMs: this.timeoutMs });
+            // issue #120：同 GitTransport —— credential helper 必须经 shell 执行，Android 上 git 的 shell 路径
+            // 不存在（askpass 又要 exec 权限）→ 改用 env 注入 HTTP 认证头重试一次（不需要 shell）。
+            if (result.code !== 0 && opts.withCredential === true && opts.token !== ''
+                && isCredentialExecFailure(result.stderr + ' ' + result.stdout)) {
+                const headerEnv = credentialHeaderEnv(opts.repoUrl ?? '', this.credentialUsername, opts.token);
+                if (Object.keys(headerEnv).length > 0 && (args[0] !== 'clone' || cloneTargetWasEmpty)) {
+                    if (args[0] === 'clone')
+                        await clearDirContents(cwd);
+                    result = await this.exec(this.gitBin, args, { cwd, timeoutMs: this.timeoutMs, env: headerEnv });
+                }
+            }
             if (result.code !== 0 && !opts.allowNonZero) {
                 throw new GitFileWriterError(opts.mask(marketMsg('market.gitWriter.commandFailed', { args: args.join(' '), stderr: result.stderr })));
             }
@@ -241,7 +257,7 @@ export class GitFileWriterClient {
             if (entries.length > 0) {
                 throw new GitFileWriterError(marketMsg('market.gitWriter.workDirNotEmpty', { workDir }));
             }
-            const clone = await this.runGit(['clone', repoUrl, '.'], { cwd: workDir, withCredential: true, token, mask });
+            const clone = await this.runGit(['clone', repoUrl, '.'], { cwd: workDir, withCredential: true, token, mask, repoUrl });
             if (clone.code !== 0) {
                 throw new GitFileWriterError(mask(marketMsg('market.gitWriter.cloneFailed', { stderr: clone.stderr })));
             }
@@ -265,7 +281,7 @@ export class GitFileWriterClient {
             return;
         // 不再用 git pull --ff-only：并发下 FETCH_HEAD 会被写成多行 for-merge、pull 自己 fatal；
         // 显式 refspec fetch + 显式远端跟踪分支 merge 完全不读 FETCH_HEAD（参数见 utils/git-fast-forward.ts）。
-        const fetched = await this.runGit(fastForwardFetchArgs(branch), { cwd: workDir, withCredential: true, allowNonZero: true, token, mask });
+        const fetched = await this.runGit(fastForwardFetchArgs(branch), { cwd: workDir, withCredential: true, allowNonZero: true, token, mask, repoUrl });
         if (fetched.code !== 0) {
             const combined = fetched.stderr + ' ' + fetched.stdout;
             // 无 upstream / 远端还没有这个分支 → 静默跳过（内容可能已是最新）

package/lib/routes/messages.d.ts

@@ -21,13 +21,13 @@ export declare const zh: {
     readonly 'route.syncPreviewFailed': '同步预览失败';
     readonly 'route.syncSessionExpired': '同步会话不存在或已过期，请重新拉取预览';
     readonly 'route.syncConflictResolutionRequired': '冲突项 {id} 必须提供 resolution（useRemote/keepLocal/skip）';
-    readonly 'route.syncApplySummary': '一键同步应用：{count} 项{status}{ineffective}';
+    readonly 'route.syncApplySummary': '从远端合并：{count} 项{status}{ineffective}';
     readonly 'route.syncRollbackIncomplete': '（回滚未完成）';
     readonly 'route.syncRolledBack': '（已回滚）';
     readonly 'route.syncIneffectiveSuffix': '（{count} 项未生效）';
     readonly 'route.syncApplyPartial': '同步应用部分成功：有项未生效（见告警明细）';
     readonly 'route.syncApplyFailed': '同步应用未完全成功';
-    readonly 'route.syncRollbackSummary': '一键同步回滚（{id}）';
+    readonly 'route.syncRollbackSummary': '从远端合并回滚（{id}）';
     readonly 'route.recoverySessionRepairRollback': '会话修复回滚';
     readonly 'route.recoverySessionRepairDropped': '会话修复（丢弃重放重复行 {count} 行）';
     readonly 'route.recoverySessionRepairRejected': '会话修复被拒绝：{reason}';

package/lib/routes/messages.js

@@ -39,13 +39,13 @@ export const zh = {
     'route.syncPreviewFailed': '同步预览失败',
     'route.syncSessionExpired': '同步会话不存在或已过期，请重新拉取预览',
     'route.syncConflictResolutionRequired': '冲突项 {id} 必须提供 resolution（useRemote/keepLocal/skip）',
-    'route.syncApplySummary': '一键同步应用：{count} 项{status}{ineffective}',
+    'route.syncApplySummary': '从远端合并：{count} 项{status}{ineffective}',
     'route.syncRollbackIncomplete': '（回滚未完成）',
     'route.syncRolledBack': '（已回滚）',
     'route.syncIneffectiveSuffix': '（{count} 项未生效）',
     'route.syncApplyPartial': '同步应用部分成功：有项未生效（见告警明细）',
     'route.syncApplyFailed': '同步应用未完全成功',
-    'route.syncRollbackSummary': '一键同步回滚（{id}）',
+    'route.syncRollbackSummary': '从远端合并回滚（{id}）',
     // ---------- 事故恢复 ----------
     'route.recoverySessionRepairRollback': '会话修复回滚',
     'route.recoverySessionRepairDropped': '会话修复（丢弃重放重复行 {count} 行）',
@@ -79,13 +79,13 @@ export const en = {
     'route.syncPreviewFailed': 'Sync preview failed',
     'route.syncSessionExpired': 'The sync session does not exist or has expired; pull a fresh preview',
     'route.syncConflictResolutionRequired': 'Conflict item {id} must provide a resolution (useRemote/keepLocal/skip)',
-    'route.syncApplySummary': 'One-click sync apply: {count} item(s){status}{ineffective}',
+    'route.syncApplySummary': 'Merge from remote: {count} item(s){status}{ineffective}',
     'route.syncRollbackIncomplete': ' (rollback incomplete)',
     'route.syncRolledBack': ' (rolled back)',
     'route.syncIneffectiveSuffix': ' ({count} item(s) had no effect)',
     'route.syncApplyPartial': 'Sync apply partially succeeded: some items had no effect (see the warning details)',
     'route.syncApplyFailed': 'Sync apply did not fully succeed',
-    'route.syncRollbackSummary': 'One-click sync rollback ({id})',
+    'route.syncRollbackSummary': 'Merge from remote rollback ({id})',
     'route.recoverySessionRepairRollback': 'Session repair rollback',
     'route.recoverySessionRepairDropped': 'Session repair (dropped {count} replayed duplicate row(s))',
     'route.recoverySessionRepairRejected': 'Session repair was rejected: {reason}',

package/lib/sync/git/credential-auth.d.ts

@@ -0,0 +1,14 @@
+/** 这条 git 失败是不是「credential helper 根本没能执行」（→ 值得改用 HTTP 认证头重试）。 */
+export declare function isCredentialExecFailure(text: string): boolean;
+/** 目录是否为空（读不到 = 非空：拿不准时绝不删东西，见 runGit 的 clone 重试）。 */
+export declare function isEmptyDir(dir: string): Promise<boolean>;
+/** 清空目录内容但保留目录本身（只用于「命令开跑前确认为空」的 clone 重试路径）。 */
+export declare function clearDirContents(dir: string): Promise<void>;
+/**
+ * 构造「用 HTTP 认证头代替 credential helper」的子进程环境变量。
+ *
+ * - 顺带把 `credential.helper` 置空：否则全局 `.gitconfig` 里配的 helper 仍会被调用并再次 cannot exec。
+ * - 明文 http 常被远端重定向到 https，而 git 是按**每条请求的 URL** 匹配配置的 → 两个前缀都挂一份。
+ * - 返回空对象 = 注入不了（repoUrl 不是合法 URL，或令牌为空），调用方保持原有失败路径。
+ */
+export declare function credentialHeaderEnv(repoUrl: string, username: string, token: string): Record<string, string>;

package/lib/sync/git/credential-auth.js

@@ -0,0 +1,84 @@
+import { readdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * issue #120：**不依赖 shell、不依赖可执行文件**的 git 认证兜底。
+ *
+ * 真机现场（Android，App 内嵌 `dsh web`）：git 二进制编译期把 GIT_SHELL_PATH 钉成
+ * Termux 的 `/data/data/com.termux/files/usr/bin/sh`，该路径在 App 沙箱里不存在，而 git 执行
+ * credential helper 的方式是把 helper 值拼成 `sh -c 'git <helper> ...'` —— **没有**「值里不含空格
+ * 就不经 shell」这种写法（本机 git trace 实测：`run_command: 'git credential-store get'` 之后紧接
+ * `start_command: '<git>/usr/bin/sh.exe' -c 'git credential-store get'`；裸 `credential.helper=store`
+ * 也一样）。于是 helper 恒定失败：
+ * `fatal: cannot exec 'git credential-store --file=... credential get': No such file or directory`
+ * → 无 tty 时退化成 `fatal: could not read Password for 'https://oauth2@github.com': terminal prompts disabled`。
+ *
+ * 换成 `core.askpass` 躲不开：askpass 是一个**要被 exec 的脚本**，而 Android 10 起 targetSdk ≥ 29
+ * 的应用不允许执行自己数据目录里的文件（SELinux untrusted_app_29+ 对 app_data_file 无 execute 权限）。
+ *
+ * 唯一不需要 exec 的通道是 git 自己从环境变量读配置（git ≥ 2.31 的 GIT_CONFIG_COUNT 协议）：
+ * 把 `http.<scope>.extraheader = AUTHORIZATION: basic <base64(user:token)>` 挂进 git 子进程的 env，
+ * 凭据既不进 argv、也不落临时文件、更不需要 sh —— token 只出现在 git 子进程的环境里
+ * （Android 上 /proc/<pid>/environ 也只有同 uid 可读，比临时凭据文件更窄）。
+ *
+ * 用法：helper 路线先跑；失败且命中 isCredentialExecFailure() 时换这份 env 重试一次。
+ */
+/**
+ * credential helper 无法被执行时的 git 原文特征：
+ * - `cannot exec ...: No such file or directory`：shell 或 helper 二进制不存在；
+ * - `could not read Password ...` / `terminal prompts disabled`：helper 没跑成，退化成读终端口令。
+ */
+const CREDENTIAL_EXEC_FAILURE_RE = /cannot exec|could not read Password|terminal prompts disabled/i;
+/** 这条 git 失败是不是「credential helper 根本没能执行」（→ 值得改用 HTTP 认证头重试）。 */
+export function isCredentialExecFailure(text) {
+    return CREDENTIAL_EXEC_FAILURE_RE.test(text);
+}
+/** 目录是否为空（读不到 = 非空：拿不准时绝不删东西，见 runGit 的 clone 重试）。 */
+export async function isEmptyDir(dir) {
+    try {
+        return (await readdir(dir)).length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** 清空目录内容但保留目录本身（只用于「命令开跑前确认为空」的 clone 重试路径）。 */
+export async function clearDirContents(dir) {
+    const entries = await readdir(dir).catch(() => []);
+    for (const entry of entries) {
+        await rm(join(dir, entry), { recursive: true, force: true });
+    }
+}
+/**
+ * 构造「用 HTTP 认证头代替 credential helper」的子进程环境变量。
+ *
+ * - 顺带把 `credential.helper` 置空：否则全局 `.gitconfig` 里配的 helper 仍会被调用并再次 cannot exec。
+ * - 明文 http 常被远端重定向到 https，而 git 是按**每条请求的 URL** 匹配配置的 → 两个前缀都挂一份。
+ * - 返回空对象 = 注入不了（repoUrl 不是合法 URL，或令牌为空），调用方保持原有失败路径。
+ */
+export function credentialHeaderEnv(repoUrl, username, token) {
+    if (token === '')
+        return {};
+    let origin;
+    try {
+        const u = new URL(repoUrl);
+        // 只取 scheme://host[:port]/ 作作用域：路径无关（同主机全部仓库都用这份令牌）
+        origin = `${u.protocol}//${u.host}/`;
+    }
+    catch {
+        return {};
+    }
+    const scopes = [origin];
+    if (origin.startsWith('http://'))
+        scopes.push(`https://${origin.slice('http://'.length)}`);
+    const authorization = `AUTHORIZATION: basic ${Buffer.from(`${username}:${token}`, 'utf8').toString('base64')}`;
+    const pairs = [['credential.helper', '']];
+    for (const scope of scopes)
+        pairs.push([`http.${scope}.extraheader`, authorization]);
+    const env = { GIT_CONFIG_COUNT: String(pairs.length) };
+    pairs.forEach(([key, value], index) => {
+        env[`GIT_CONFIG_KEY_${String(index)}`] = key;
+        env[`GIT_CONFIG_VALUE_${String(index)}`] = value;
+    });
+    return env;
+}
+//# sourceMappingURL=credential-auth.js.map

package/lib/sync/git/git-transport.d.ts

@@ -11,6 +11,7 @@ export interface GitExecResult {
 export type GitExecFn = (cmd: string, args: string[], opts: {
     cwd?: string;
     timeoutMs?: number;
+    env?: Record<string, string>;
 }) => Promise<GitExecResult>;
 /** 工作副本自检事实（issue #79）：origin 是否已跟随配置地址、有无未上行的本地提交。 */
 export interface GitWorkDirFacts {

package/lib/sync/git/git-transport.js

@@ -30,6 +30,7 @@ import { classifyNetworkErrorText, computeSnapshotMeta, DEFAULT_SYNC_TIMEOUT_MS,
 import { parseJsonSafe } from '../../utils/json.js';
 import { atomicWriteFile } from '../../utils/atomic-write.js';
 import { quoteGitValue } from '../../utils/git-quote.js';
+import { clearDirContents, credentialHeaderEnv, isEmptyDir, isCredentialExecFailure } from './credential-auth.js';
 import { SECTION_FILE_PREFIXES } from '../../schema/config.js';
 import { zhMsg } from '../../core/messages.js';
 import { withWorkdirLock, WorkdirLockError } from '../../utils/workdir-lock.js';
@@ -119,6 +120,9 @@ const defaultExec = async (cmd, args, opts) => {
             maxBuffer: 16 * 1024 * 1024,
             windowsHide: true,
             encoding: 'utf8',
+            // issue #120：credential helper 走 shell 且本机没有可用 shell 时，改用 env 注入认证头重试 ——
+            // 追加在继承的 process.env 上（env 缺省 = 完全继承，不改变既有行为）
+            env: opts.env === undefined ? undefined : { ...process.env, ...opts.env },
         });
         return { stdout: String(stdout), stderr: String(stderr), code: 0 };
     }
@@ -823,8 +827,24 @@ export class GitTransport {
                 await cleanup();
             throw new GitTransportError(this.msg('sync.git.pushTokenRequired'), { kind: 'auth', retryable: false });
         }
+        // issue #120：只有「命令开跑前目录是空的」才敢在重试前清空 —— clone 失败可能留下半成品，
+        // 而目录里原本就有别的内容时宁可放弃重试，也绝不删用户文件。
+        const cloneTargetWasEmpty = args[0] === 'clone' ? await isEmptyDir(cwd) : false;
         try {
-            const result = await this.o.exec(this.o.gitBin, [...extra, ...args], { cwd, timeoutMs: this.o.timeoutMs });
+            let result = await this.o.exec(this.o.gitBin, [...extra, ...args], { cwd, timeoutMs: this.o.timeoutMs });
+            // issue #120：credential helper 必须经 shell 执行（值里不含空格也一样，git 统一拼成
+            // `sh -c 'git <helper> ...'`），而 Android 上 git 二进制的 GIT_SHELL_PATH 指向 App 沙箱里
+            // 不存在的 Termux sh；`core.askpass` 又要 exec 权限（Android 10+ 对 targetSdk ≥ 29 禁执行应用
+            // 目录里的文件）。两条路都走不通时，改用 env 注入 HTTP 认证头重试一次（不需要 shell）。
+            if (result.code !== 0 && token !== null && token !== ''
+                && isCredentialExecFailure(result.stderr + ' ' + result.stdout)) {
+                const headerEnv = credentialHeaderEnv(this.o.repoUrl, this.o.credentialUsername, token);
+                if (Object.keys(headerEnv).length > 0 && (args[0] !== 'clone' || cloneTargetWasEmpty)) {
+                    if (args[0] === 'clone')
+                        await clearDirContents(cwd);
+                    result = await this.o.exec(this.o.gitBin, args, { cwd, timeoutMs: this.o.timeoutMs, env: headerEnv });
+                }
+            }
             if (result.code !== 0 && !opts.allowNonZero) {
                 const combined = result.stderr + ' ' + result.stdout;
                 // 统一分类（超时 / 网络 / 鉴权 / 5xx…）：上层可据 kind / retryable 分流，不必解析 message
@@ -836,12 +856,19 @@ export class GitTransport {
                 // 推送 + 鉴权失败：git 原文只说「认证失败」——换成能照做的说明（令牌失效 / 无写权限 / 远端禁用了密码推送）
                 // issue #115：clone 的鉴权失败原文（remote: Write access to repository not granted / 403）读不出「缺哪种权限」，
                 // 换成点名 Contents: Read and write 的说明 —— 否则用户只会以为令牌坏了（细粒度 PAT 常只勾了 Administration）
-                const message = opts.requirePushToken === true && classified.kind === 'auth'
-                    ? this.msg('sync.git.pushAuthFailed', { err: this.mask(result.stderr, token) })
-                    : args[0] === 'clone' && classified.kind === 'auth'
-                        ? this.msg('sync.git.cloneAuthFailed', { err: this.mask(result.stderr, token) })
-                        : this.msg('sync.git.cmdFailed', { args: args.join(' '), code: String(result.code), err: this.mask(result.stderr, token) });
-                throw new GitTransportError(message, classified);
+                // issue #120：helper 根本没能执行时，「请确认令牌有效」是错误指引（令牌可能是好的）——
+                // 这类失败必须点名平台原因，排在 push/clone 的鉴权文案之前。
+                const credentialBlocked = isCredentialExecFailure(combined);
+                const message = credentialBlocked
+                    ? this.msg('sync.git.credentialHelperBlocked', { err: this.mask(result.stderr, token) })
+                    : opts.requirePushToken === true && classified.kind === 'auth'
+                        ? this.msg('sync.git.pushAuthFailed', { err: this.mask(result.stderr, token) })
+                        : args[0] === 'clone' && classified.kind === 'auth'
+                            ? this.msg('sync.git.cloneAuthFailed', { err: this.mask(result.stderr, token) })
+                            : this.msg('sync.git.cmdFailed', { args: args.join(' '), code: String(result.code), err: this.mask(result.stderr, token) });
+                // 归类同样不能交给原文：`cannot exec ...: No such file or directory` 里的 ENOENT 会被判成
+                // notfound（「仓库不存在」），而真实原因是凭据通道不可用 → 钉成 auth（非瞬时、别重试）。
+                throw new GitTransportError(message, credentialBlocked ? { kind: 'auth', retryable: false } : classified);
             }
             return result;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-config-manager",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "license": "MIT",
   "description": "Backup, restore, export, import, migrate and sync your DeepSeek Harness (DSH) configuration: settings, plugins, MCP servers, skills, agent presets and workspaces. One-click migration to another machine. DSH 配置一键备份、恢复、导出、导入、迁移与同步插件。",
   "icon": "./icon.svg",

package/src/client/history/history-locales.ts

@@ -71,7 +71,7 @@ export const zh = {
   'history.kind.profile-rename': '档案重命名',
   'history.kind.profile-save': '档案保存',
   'history.kind.profile-import': '档案导入',
-  'history.kind.sync-apply': '一键同步应用',
+  'history.kind.sync-apply': '从远端合并',
   'history.kind.autosync': '自动同步',
   'history.kind.recovery': '恢复/回滚编排',
   'history.kind.backup': '定时备份',
@@ -118,7 +118,7 @@ export const en = {
   'history.kind.profile-rename': 'Profile rename',
   'history.kind.profile-save': 'Profile save',
   'history.kind.profile-import': 'Profile import',
-  'history.kind.sync-apply': 'Sync apply',
+  'history.kind.sync-apply': 'Merge from remote',
   'history.kind.autosync': 'Autosync',
   'history.kind.recovery': 'Recovery/rollback',
   'history.kind.backup': 'Scheduled backup',

package/src/client/locales.ts

@@ -123,7 +123,7 @@ export const zh = {
   'overview.kind.other': '其他操作',
   // 状态横幅
   // —— 导出 ——
-  'export.hint': '默认导出推荐分区（可迁移、不含设备专属数据）。点「选择要导出的内容」可按分区、逐条目调整（技能、插件、工作区、会话等）。',
+  'export.hint': '默认导出推荐分区（可迁移、不含设备专属数据）。',
   'export.encrypt': '加密备份',
   'export.encryptHint': '用密码加密整个备份文件（AES-256-GCM）。密码仅用于本次加密，不会写入备份或任何配置文件；导入时必须输入该密码才能解锁。',
   'export.password': '备份加密密码',
@@ -640,7 +640,7 @@ export const zh = {
   'runs.kind.export': '导出',
   'runs.kind.import': '导入',
   'runs.kind.autosync': '自动同步',
-  'runs.kind.sync-apply': '一键同步',
+  'runs.kind.sync-apply': '从远端合并',
   'runs.kind.backup-schedule': '定时备份',
   'runs.kind.restore': '快照恢复',
   'runs.kind.profile-switch': '档案切换',
@@ -1013,7 +1013,7 @@ export const en: Record<keyof typeof zh, string> = {
   'overview.kind.snapshot-delete': 'Snapshot delete',
   'overview.kind.snapshot-prune': 'Snapshot prune',
   'overview.kind.other': 'Other operation',
-  'export.hint': 'Exports the recommended sections by default (portable, no device-specific data). Click "Choose what to export" to adjust per section and per item (skills, plugins, workspaces, sessions, …).',
+  'export.hint': 'Exports the recommended sections by default (portable, no device-specific data).',
   'export.encrypt': 'Encrypt backup',
   'export.encryptHint': 'Encrypt the entire backup file with a password (AES-256-GCM). The password is used once and never written into the backup or any config file; it is required to unlock the backup on import.',
   'export.password': 'Backup encryption password',
@@ -1518,7 +1518,7 @@ export const en: Record<keyof typeof zh, string> = {
   'runs.kind.export': 'Export',
   'runs.kind.import': 'Import',
   'runs.kind.autosync': 'Auto sync',
-  'runs.kind.sync-apply': 'One-click sync',
+  'runs.kind.sync-apply': 'Merge from remote',
   'runs.kind.backup-schedule': 'Scheduled backup',
   'runs.kind.restore': 'Snapshot restore',
   'runs.kind.profile-switch': 'Profile switch',

package/src/client/market/MyConfigsView.tsx

@@ -35,7 +35,6 @@ import type { MyConfigsApi, MyItemEntry } from './my-configs-api.ts'
 import type { ListingStatusResponse } from '../../market/my-repo.ts'
 import type { SyncApi, GithubPollResponse } from '../sync/sync-api.ts'
 import { Button, Card, SectionTitle } from '../common/ui.tsx'
-import { InfoHint } from '../common/InfoHint.tsx'
 import { ConfirmDialog } from '../common/ConfirmDialog.tsx'
 import { toast } from '../common/toast-store.ts'
 import { redact } from '../../security/redaction.ts'
@@ -773,10 +772,11 @@ export function MyConfigsView({
         <>
           {/* 一键上传入口：点按钮 → 免责（首次）→ 弹窗向导 */}
           <Card>
-            {/* 卡片里只有一个动作：按钮本身已经写明「一键上传」，不再重复一个同名标题；ⓘ 跟着动作走 */}
+            {/* 卡片里只有一个动作：按钮本身已写明作用对象（上传配置包），不再重复标题。
+                此处不再放 ⓘ：它的「先在导出页生成 zip / 含密钥的备份会被拒绝」已在点开后的
+                向导头（MyConfigsWizard 的 Modal.Header trailing）逐字出现，入口再放一遍是同一条信息两次。 */}
             <div className={css.actionRow}>
               <Button variant="primary" onClick={openUpload}>{t('myconfigs.upload.run')}</Button>
-              <InfoHint text={t('myconfigs.upload.selectHint')} label={t('common.infoHint')} />
             </div>
           </Card>
           {renderList()}

package/src/client/market/market-locales.ts

@@ -145,11 +145,11 @@ export const zh = {
   'myconfigs.upload.mode.migrate': '迁移（保留全部内容）',
   'myconfigs.upload.mode.share': '分享（自动排除敏感内容）',
   'myconfigs.upload.mode.shareHint': '分享模式将自动排除设备/平台相关分区（凭据状态 / 会话 / MCP / 工作区等），并对隐私内容强制拦截——发现任何敏感痕迹将拒绝发布，而不是仅警告。',
-  'myconfigs.upload.run': '一键上传',
+  'myconfigs.upload.run': '上传配置包',
   'myconfigs.update.title': '更新配置',
   'myconfigs.update.hint': '版本自动 +1',
   'myconfigs.update.run': '一键更新',
-  'myconfigs.update.zipHint': '更新需要新的配置包：选择新 zip 后自动校验，通过后即可一键更新。',
+  'myconfigs.update.zipHint': '选择新 zip 后自动校验，通过才能更新。',
   'myconfigs.update.selectZip': '选择新 ZIP…',
   // 上传/更新结果卡
   'myconfigs.result.title': '上传/更新完成',
@@ -324,11 +324,11 @@ export const en: Record<keyof typeof zh, string> = {
   'myconfigs.upload.mode.migrate': 'Migrate (keep everything)',
   'myconfigs.upload.mode.share': 'Share (auto-exclude sensitive content)',
   'myconfigs.upload.mode.shareHint': 'Share mode auto-excludes device/platform-specific sections (credentials status / sessions / MCP / workspaces, etc.) and enforces privacy scanning — any sensitive trace blocks publishing instead of just warning.',
-  'myconfigs.upload.run': 'Upload',
+  'myconfigs.upload.run': 'Upload bundle',
   'myconfigs.update.title': 'Update config',
   'myconfigs.update.hint': 'version +1 automatically',
   'myconfigs.update.run': 'Update',
-  'myconfigs.update.zipHint': 'Updating needs a new config zip: pick one and it will be validated automatically, then you can update.',
+  'myconfigs.update.zipHint': 'Pick a new zip and it will be validated automatically; only a passing zip can be installed.',
   'myconfigs.update.selectZip': 'Choose new ZIP…',
   'myconfigs.result.title': 'Upload/update complete',
   'myconfigs.result.version': 'version {version}',

package/src/client/sync/SyncPanel.tsx

@@ -1260,8 +1260,8 @@ export function SyncPanel({ api, t, cmT }: SyncPanelProps) {
         )}
         {ready && (
           <Card>
-            {/* 动作行（方案 A 定案）：用户只面对两个方向 —— 下行「一键同步」/ 上行「推送到远端」。
-                合并裁决并入一键同步（有基线走三方裁决视图、无基线走老导入确认）；并排两个按钮看不出该按哪个（issue 115）⇒ 按已确证远端事实只让一个落在 primary。 */}
+            {/* 动作行（方案 A 定案）：用户只面对两个方向 —— 下行「从远端合并到本机」/ 上行「推送到远端」。
+                合并裁决并入下行按钮（有基线走三方裁决视图、无基线走老导入确认）；并排两个按钮看不出该按哪个（issue 115）⇒ 按已确证远端事实只让一个落在 primary。 */}
             <div className={css.actionRow}>
               <Button
                 variant={pickSyncPrimary(state.statusInfo, channel) === 'sync' ? 'primary' : 'ghost'}

package/src/client/sync/SyncProbeRow.tsx

@@ -111,9 +111,10 @@ export function SyncProbeRow({ api, t, body, remoteReady, busy, presentation = '
 
   return (
     <>
-      {/* action 形态：直接摊进调用方自己的动作行（不再套一层 .actionRow），结果走 toast */}
+      {/* action 形态：直接摊进调用方自己的动作行（不再套一层 .actionRow），结果走 toast。
+          动作行里只留按钮：与同排其它按钮并排时，ⓘ 会被读成该按钮的开关（issue 121 用户要求移除）。 */}
       {actionMode
-        ? <>{button}{hintNode}</>
+        ? <>{button}</>
         : <div className={css.actionRow}>{button}{hintNode}</div>}
       {!actionMode && error !== null && (
         <ErrorBanner