@lancc/cmark 1.1.0 → 1.2.1

package/preload/git-panel.js

@@ -42,8 +42,7 @@ module.exports = function installGitPanel(win, WS) {
     --zgp-hunk:#ddf4ff; --zgp-hunk-fg:#0969da;
     --zgp-shadow:0 8px 32px rgba(31,35,40,.14),0 2px 8px rgba(31,35,40,.08);
   }
-  @media (prefers-color-scheme:dark){
-    :root{
+  :root[data-theme='dark']{
       --zgp-bg:#161b22; --zgp-bg2:#1c2128; --zgp-bg3:#22272e;
       --zgp-fg:#e6edf3; --zgp-fg2:#9aa4b2; --zgp-fg3:#6e7681;
       --zgp-bd:#30363d; --zgp-bd2:#3d444d;
@@ -53,7 +52,6 @@ module.exports = function installGitPanel(win, WS) {
       --zgp-del:#2d1214; --zgp-del-fg:#f85149;
       --zgp-hunk:#0c2d4a; --zgp-hunk-fg:#58a6ff;
       --zgp-shadow:0 8px 32px rgba(0,0,0,.6),0 2px 8px rgba(0,0,0,.4);
-    }
   }
   #zgp-btn{display:inline-flex;align-items:center;gap:5px;font-size:12px;font-weight:500;padding:3px 10px;
     border:1px solid var(--zgp-bd2);border-radius:6px;background:var(--zgp-bg);color:var(--zgp-fg2);
@@ -128,7 +126,7 @@ module.exports = function installGitPanel(win, WS) {
   .zgp-st.D{background:var(--zgp-del);color:var(--zgp-del-fg);}
   .zgp-st.Q{background:var(--zgp-bg3);color:var(--zgp-fg3);}
   .zgp-st.U{background:var(--zgp-del);color:var(--zgp-del-fg);}
-  @media (prefers-color-scheme:dark){.zgp-st.M{background:#3a2d00;color:#d29922;}}
+  :root[data-theme='dark'] .zgp-st.M{background:#3a2d00;color:#d29922;}
   .zgp-fp{flex:1;min-width:0;font-size:12.5px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
     font-family:Consolas,Menlo,monospace;}
   .zgp-fp span{unicode-bidi:normal;}
@@ -219,7 +217,8 @@ module.exports = function installGitPanel(win, WS) {
   .zgp-jumpbar button{padding:3px 10px;font-size:11.5px;border-radius:6px;cursor:pointer;
     border:1px solid var(--zgp-bd2);background:var(--zgp-bg);color:var(--zgp-fg2);}
   .zgp-jumpbar button:hover{background:var(--zgp-acc-bg);border-color:var(--zgp-acc);color:var(--zgp-acc);}
-  .zgp-dl.zgp-flash{outline:2px solid var(--zgp-acc);outline-offset:-2px;}
+  .zgp-dl.zgp-flash{outline:none !important;border:none !important;background:rgba(9,105,218,.16) !important;}
+  :root[data-theme='dark'] .zgp-dl.zgp-flash{background:rgba(88,166,255,.30) !important;}
 
   .zgp-cf-ov{position:absolute;inset:0;background:rgba(0,0,0,.38);display:flex;align-items:center;
     justify-content:center;z-index:20;padding:20px;}
@@ -458,6 +457,38 @@ module.exports = function installGitPanel(win, WS) {
     })
   }
 
+  /** 找到元素最近的可滚动祖先（弹窗是 vbody 自己滚，内嵌是面板 body 滚） */
+  function scrollHostOf (el) {
+    var n = el
+    while (n && n !== doc.body) {
+      var cs = win.getComputedStyle(n)
+      if (/(auto|scroll)/.test(cs.overflowY) && n.scrollHeight > n.clientHeight + 4) return n
+      n = n.parentElement
+    }
+    return el
+  }
+
+  /**
+   * diff 打开后默认落到第一处改动：把第一行 add/del 滚到视口约 1/3 高度并闪一下，
+   * 免得长文件每次都要自己往下翻。
+   */
+  function focusFirstChange (body) {
+    if (!body) return
+    var first = body.querySelector('.zgp-dl.add, .zgp-dl.del')
+    if (!first) return
+    var host = scrollHostOf(body)
+    try {
+      var hr = host.getBoundingClientRect()
+      var er = first.getBoundingClientRect()
+      var delta = er.top - hr.top
+      host.scrollTop = Math.max(0, host.scrollTop + delta - Math.round(host.clientHeight / 3))
+    } catch (e) {
+      try { first.scrollIntoView({ block: 'center' }) } catch (e2) {}
+    }
+    first.classList.add('zgp-flash')
+    win.setTimeout(function () { first.classList.remove('zgp-flash') }, 1200)
+  }
+
   // diff 渲染：带行号
   function renderDiffLines (lines) {
     let oldNo = 0, newNo = 0
@@ -512,7 +543,12 @@ module.exports = function installGitPanel(win, WS) {
       body.innerHTML = '<span class="zgp-dl">' + esc(content || '(空)') + '</span>'
     }
     view.classList.add('on')
-    body.scrollTop = 0
+    if (isDiff) {
+      // 必须先让弹窗可见再算位置，隐藏时 rect 全是 0
+      focusFirstChange(body)
+    } else {
+      body.scrollTop = 0
+    }
   }
 
   // ============ 当前笔记 ============
@@ -531,7 +567,12 @@ module.exports = function installGitPanel(win, WS) {
     ensureStatusContainers()
     const box = $('zgp-status')
     if (!st || !st.isRepo) {
-      box.innerHTML = '<span class="zgp-chip warn">尚未初始化 git 仓库</span>'
+      // 只换 chips 的内容，绝不整体覆盖 .zgp-status：
+      // 整体覆盖会把 chips/acts/fileact 三个容器一起删掉，之后自愈重建时
+      // 散落在状态条里的旧节点会留下来，表现为「工作区变更记录」里混着
+      // 单个文档的 chip（两套状态条叠在一起）
+      const chipsBox0 = box.querySelector('#zgp-chips')
+      if (chipsBox0) chipsBox0.innerHTML = '<span class="zgp-chip warn">尚未初始化 git 仓库</span>'
       const foot0 = doc.querySelector('.zgp-acts')
       const oldE = doc.getElementById('zgp-foot-extra')
       if (oldE) oldE.remove()
@@ -574,7 +615,7 @@ module.exports = function installGitPanel(win, WS) {
           if (!ok) return
           const r = await G.abortInProgress()
           toast(r.ok ? ('已中止 ' + st.inProgress) : ('中止失败：' + r.message), r.ok ? 'ok' : 'err')
-          refresh()
+          refreshAfterAction()
         }
         wrap.appendChild(b)
       }
@@ -585,7 +626,7 @@ module.exports = function installGitPanel(win, WS) {
         b2.onclick = async () => {
           const r = await G.clearStaleLock()
           toast(r.ok ? '已清理陈旧 index.lock' : ('清理失败：' + r.message), r.ok ? 'ok' : 'err')
-          refresh()
+          refreshAfterAction()
         }
         wrap.appendChild(b2)
       }
@@ -664,7 +705,7 @@ module.exports = function installGitPanel(win, WS) {
     if (!rel) {
       const chips0 = box.querySelector('#zgp-chips')
       if (chips0) chips0.innerHTML = '<span class="zgp-chip warn">没有打开的笔记</span>'
-      else box.innerHTML = '<span class="zgp-chip warn">没有打开的笔记</span>'
+      else ensureStatusContainers()
       const pane = $('zgp-pane-changes')
       if (pane) pane.innerHTML = '<div class="zgp-empty"><b>没有打开的笔记</b>打开一篇笔记后，这里显示它的改动与历史</div>'
       const hp = $('zgp-pane-history')
@@ -677,10 +718,11 @@ module.exports = function installGitPanel(win, WS) {
     const chipsHtml = '<span class="zgp-chip acc">' + esc(displayPath(rel)) + '</span>'
       + (file ? '<span class="zgp-chip warn">有未提交改动</span>' : '<span class="zgp-chip ok">与最近提交一致</span>')
       + (readErr ? '<span class="zgp-chip err">' + esc(readErr.slice(0, 40)) + '</span>' : '')
-    // 只更新 chips，不要覆盖整个状态条（否则会删掉右侧操作区与容器）
+    // 只更新 chips，不要覆盖整个状态条（否则会删掉右侧操作区与容器）。
+    // 容器缺失时先自愈重建，而不是退回「直接写 .zgp-status」那种会留残骸的兜底。
+    ensureStatusContainers()
     const chipsBoxF = box.querySelector('#zgp-chips')
     if (chipsBoxF) chipsBoxF.innerHTML = chipsHtml
-    else box.innerHTML = chipsHtml
     renderFileChanges(rel, file)
     if (activeTab === 'history') renderHistory(true)
   }
@@ -720,7 +762,7 @@ module.exports = function installGitPanel(win, WS) {
         if (r.ok) {
           toast('已推送：' + (r.data.steps.join(' · ') || '无改动'), 'ok')
           logCache = null
-          refresh()
+          refreshAfterAction()
         } else toast('推送失败：' + hintOf(r), 'err')
       }
     }
@@ -732,7 +774,7 @@ module.exports = function installGitPanel(win, WS) {
           toast('已还原到最近一次提交', 'ok')
           logCache = null
           try { if (win.__znotesReloadNote) win.__znotesReloadNote(rel) } catch (e) {}
-          refresh()
+          refreshAfterAction()
         } else if (rr.kind !== 'cancelled') {
           toast('还原失败：' + hintOf(rr), 'err')
         }
@@ -758,6 +800,8 @@ module.exports = function installGitPanel(win, WS) {
     const lines = stripDiffHeader(diff)
     body.innerHTML = renderDiffLines(lines)
     mountJumpBar(body)
+    // 首次渲染才跳；后续轮询刷新（内容没变）不打断用户当前阅读位置
+    if (!existedBody) focusFirstChange(body)
   }
 
   function renderChanges(st) {
@@ -806,7 +850,7 @@ module.exports = function installGitPanel(win, WS) {
             // 编辑器内部可能残留旧内容并触发自动保存，把还原结果又写回磁盘；
             // 整页刷新是唯一可靠的做法（还原属低频操作）
             try { if (win.__znotesReloadNote) win.__znotesReloadNote(f.path) } catch (err) {}
-            refresh()
+            refreshAfterAction()
           } else if (r.kind !== 'cancelled') {
             toast('还原失败：' + hintOf(r), 'err')
           }
@@ -938,7 +982,7 @@ module.exports = function installGitPanel(win, WS) {
           + '<button class="zgp-ic" data-cmpprev="' + i + '" title="与提交前比对：这一次提交本身对这篇笔记做了什么改动">' + ICON.cmpPrev + '</button>'
           + '<button class="zgp-ic" data-view="' + i + '" title="查看该版本：显示这次提交时这篇笔记的完整内容">' + ICON.eye + '</button>'
           + '<span style="flex:1"></span>'
-          + '<button class="zgp-ic danger" data-back="' + i + '" title="回溯到此版本：把这篇笔记恢复成这个版本的内容（改动前自动备份）">' + ICON.undo + '</button>'
+          + '<button class="zgp-ic danger" data-back="' + i + '" title="回溯到此版本：把这篇笔记恢复成这个版本的内容">' + ICON.undo + '</button>'
           + '</div>'
         : ''
       return '<div class="zgp-cm" data-c="' + i + '">'
@@ -987,7 +1031,7 @@ module.exports = function installGitPanel(win, WS) {
             toast('已回溯到 ' + c.short, 'ok')
             logCache = null
             try { if (win.__znotesReloadNote) win.__znotesReloadNote(onlyFile) } catch (e) {}
-            refresh()
+            refreshAfterAction()
           } else if (r.kind !== 'cancelled') {
             toast('回溯失败：' + hintOf(r), 'err')
           }
@@ -1019,7 +1063,7 @@ module.exports = function installGitPanel(win, WS) {
               + '<span class="zgp-fs ' + (f.status || '').charAt(0) + '">' + (f.status || '').charAt(0) + '</span>'
               + '<span style="flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap" title="' + esc(f.path) + '">' + esc(f.path) + '</span>'
               + '<button class="zgp-ic" title="查看该次改动">' + ICON.diff + '</button>'
-              + '<button class="zgp-ic danger" data-restore="1" title="回溯到该版本（先备份）">' + ICON.undo + '</button>'
+              + '<button class="zgp-ic danger" data-restore="1" title="回溯到该版本">' + ICON.undo + '</button>'
               + '</div>'
           }).join('')
         }
@@ -1042,7 +1086,7 @@ module.exports = function installGitPanel(win, WS) {
               toast('已回溯到 ' + hash.slice(0, 7), 'ok')
               logCache = null
               try { if (win.__znotesReloadNote) win.__znotesReloadNote(p) } catch (err) {}
-              refresh()
+              refreshAfterAction()
             } else if (r3.kind !== 'cancelled') {
               toast('回溯失败：' + hintOf(r3), 'err')
             }
@@ -1101,6 +1145,23 @@ module.exports = function installGitPanel(win, WS) {
     }
   }
 
+  /**
+   * 操作（提交/推送/拉取/还原/中止）完成后的刷新。
+   *
+   * 不能只调 refresh()：① 它带签名去重，读到和上次一样的中间状态会直接返回；
+   * ② git 命令返回时工作区/索引可能还没完全落稳，第一次读到的往往还是旧状态。
+   * 所以先强制刷一次，再补几次重试，同时把历史页和顶部分支条一起拉新。
+   */
+  function refreshAfterAction() {
+    try { refresh(true) } catch (e) {}
+    ;[120, 400, 1000, 2200].forEach(function (ms) {
+      setTimeout(function () { try { refresh(true) } catch (e) {} }, ms)
+    })
+    try { logCache = null } catch (e) {}
+    try { if (activeTab === 'history') renderHistory(true) } catch (e) {}
+    try { if (win.__zbbRefresh) win.__zbbRefresh() } catch (e) {}
+  }
+
   // ============ 事件 ============
   let activeTab = 'changes'
   let panelMode = 'global'   // global：全部改动/历史；file：只看当前笔记
@@ -1131,6 +1192,10 @@ module.exports = function installGitPanel(win, WS) {
     const fAct = root.querySelector('#zgp-fileact')
     if (fAct) fAct.style.display = isFile ? 'flex' : 'none'
     if (!isFile && fAct) fAct.innerHTML = ''
+    // 切模式时先清一遍 chips：refresh 有签名去重，命中时会直接 return，
+    // 上一模式的 chip（全局的「分支 main/工作区干净」或单文件的「路径」）就会留在新面板里
+    const chipsEl = doc.getElementById('zgp-chips')
+    if (chipsEl) chipsEl.innerHTML = ''
   }
 
   doc.querySelectorAll('.zgp-tab').forEach((t) => {
@@ -1212,7 +1277,7 @@ module.exports = function installGitPanel(win, WS) {
       } else {
         toast('同步失败：' + hintOf(r), 'err')
       }
-      refresh()
+      refreshAfterAction()
     }
 
     const pushBtn = $('zgp-push')
@@ -1221,7 +1286,7 @@ module.exports = function installGitPanel(win, WS) {
       const r = await G.push()
       busyUI(false)
       toast(r.ok ? '已推送' : ('推送失败：' + hintOf(r)), r.ok ? 'ok' : 'err')
-      refresh()
+      refreshAfterAction()
     }
 
     const pullBtn = $('zgp-pull')
@@ -1231,7 +1296,7 @@ module.exports = function installGitPanel(win, WS) {
       busyUI(false)
       toast(r.ok ? '已拉取' : ('拉取失败：' + hintOf(r)), r.ok ? 'ok' : 'err')
       logCache = null
-      refresh()
+      refreshAfterAction()
     }
   }
   bindStatusButtons()
@@ -1241,6 +1306,15 @@ module.exports = function installGitPanel(win, WS) {
     const status = $('zgp-status')
     if (!status) return
     let changed = false
+    // 先清掉不属于三个容器的散落节点：历史上 renderStatus/renderFileMode 都走过
+    // 「直接给 .zgp-status 写 innerHTML」的兜底，留下的裸 chip 会和重建的容器
+    // 并排显示（全局 chip + 单文件 chip 同时出现），必须一次性清干净
+    const kids = Array.prototype.slice.call(status.children)
+    for (const el of kids) {
+      if (el.id === 'zgp-chips' || el.id === 'zgp-fileact') continue
+      if (el.classList && el.classList.contains('zgp-acts')) continue
+      try { status.removeChild(el); changed = true } catch (e) {}
+    }
     if (!$('zgp-chips')) {
       const d = doc.createElement('div')
       d.className = 'zgp-chips'
@@ -1297,7 +1371,12 @@ module.exports = function installGitPanel(win, WS) {
       refresh()
     }
   }
-  win.__zgpOpen = function (mode) { if (!root.classList.contains('open')) win.__zgpToggle(mode || 'global') }
+  win.__zgpOpen = function (mode) {
+    const m = mode === 'file' ? 'file' : 'global'
+    // 面板已经打开时也要切模式：否则从「文档变更记录」再点侧边栏的
+    // 「工作区变更记录」会被静默忽略，标题与内容停在上一层，看起来就是错乱
+    if (!root.classList.contains('open') || m !== panelMode) win.__zgpToggle(m)
+  }
   win.__zgpIsOpen = function () { return root.classList.contains('open') }
 
   // 面板打开时定时刷新（3 秒）；历史页不做轮询，避免反复重绘导致闪烁

package/preload/git-service.js

@@ -20,6 +20,7 @@ const fs = require('fs')
 const path = require('path')
 const os = require('os')
 const crypto = require('crypto')
+const wsPrefs = require('./ws-prefs.js')
 
 const DEFAULTS = {
   autoSync: false,
@@ -30,7 +31,8 @@ const DEFAULTS = {
   pullBeforePush: true,
   pushEnabled: true,
   commitScope: 'notes',
-  commitMessage: 'notes: 同步 {{datetime}}',
+  // 提交信息固定，不开放给用户配置（少一个配置项，也避免有人把模板改坏导致历史不可读）
+  commitMessage: 'cmark sync:{{datetime}}',
   lastRunAt: 0,
   failCount: 0
 }
@@ -201,7 +203,7 @@ module.exports = function installGitService(win, argvPath) {
     { kind: 'detached', re: /detached HEAD|not currently on a branch/i },
     { kind: 'norepo', re: /not a git repository/i },
     { kind: 'noUpstream', re: /no upstream configured|has no upstream branch|couldn't find remote ref/i },
-    { kind: 'auth', re: /(Authentication failed|Permission denied \(publickey|invalid username or password|could not read Username|could not read Password|No such identity)/i },
+    { kind: 'auth', re: /(Authentication failed|Permission denied \(publickey|invalid username or password|could not read Username|could not read Password|No such identity|token username invalid|Incorrect username or password|returned error:\s*40[13]|HTTP 40[13])/i },
     { kind: 'network', re: /could not resolve host|Unable to access|Connection (refused|reset|timed out)|Failed to connect|network is unreachable|Operation timed out/i },
     { kind: 'perm', re: /Permission denied|EACCES|Read-only file system|No space left/i },
     { kind: 'dirty', re: /local changes would be lost|Your local changes|uncommitted changes/i }
@@ -209,7 +211,7 @@ module.exports = function installGitService(win, argvPath) {
 
   const ERR_TEXT = {
     network: '网络不通或远端不可达',
-    auth: '认证失败（检查 SSH key 或凭据）',
+    auth: '认证失败：令牌无效或用户名不匹配（Gitee/自建服务重新授权一次即可）',
     conflict: '存在冲突，需要先解决',
     lock: 'git 被其他进程占用（index.lock）',
     detached: 'HEAD 处于游离状态，请先切回分支',
@@ -241,10 +243,73 @@ module.exports = function installGitService(win, argvPath) {
   // git 会弹出「选择凭据助手」的 GUI 窗口，在插件里就是卡死。
   const BASE_ARGS = ['-c', 'core.quotepath=false', '-c', 'credential.helper=', '-c', 'credential.helper=manager']
 
+  // ---- 远端凭据（一键建仓用）----
+  // token 存在 ~/.cmark-config.json 的 remoteToken 里，网络命令用内联 credential helper
+  // 从环境变量读取：不写进 .git/config，也不出现在 git 的命令行参数里。
+  const NET_CFG_FILE = path.join(os.homedir(), '.cmark-config.json')
+  let netCfgCache = { t: -1, data: null }
+  function readNetCfg () {
+    try {
+      const st = fs.statSync(NET_CFG_FILE)
+      if (netCfgCache.data && netCfgCache.t === st.mtimeMs) return netCfgCache.data
+      const d = JSON.parse(fs.readFileSync(NET_CFG_FILE, 'utf8'))
+      netCfgCache = { t: st.mtimeMs, data: d }
+      return d
+    } catch (e) { return null }
+  }
+  const NET_CMDS = { push: 1, pull: 1, fetch: 1, 'ls-remote': 1, clone: 1 }
+
+  // Gitee 对 HTTPS 的用户名是**强校验**的：用户名必须与令牌所有者一致，否则直接回
+  // 403「The token username invalid」（实测：用 x-access-token 当用户名，Gitee 连
+  // 假令牌都明确回 username 相关错误）。x-access-token 这种占位用户名只有 GitHub 认。
+  // 所以按远端决定用户名：
+  //   https://gitee.com/<owner>/<repo>.git → owner（个人仓库的 owner 就是令牌所有者）
+  //   其它（GitHub 等接受任意用户名）      → x-access-token
+  const SAFE_USER = /^[A-Za-z0-9._-]{1,64}$/
+  function userForUrl (url) {
+    const m = /^https?:\/\/(?:[^@/]+@)?([^/:]+)(?::\d+)?\/([^/]+)\//.exec(String(url || ''))
+    if (m && /(^|\.)gitee\.com$/i.test(m[1]) && SAFE_USER.test(m[2])) return m[2]
+    return 'x-access-token'
+  }
+  // 从 .git/config 里同步取 origin 的地址（exec 是同步拼参数的场合，不能等 git 命令）
+  function originUrl () {
+    try {
+      const txt = fs.readFileSync(path.join(repoRoot || WS, '.git', 'config'), 'utf8')
+      const tail = txt.split(/\[remote "origin"\]/)[1] || ''
+      const m = /^[ \t]*url[ \t]*=[ \t]*(.+)$/m.exec(tail)
+      return m ? m[1].trim() : ''
+    } catch (e) { return '' }
+  }
+  function tokenHelper (username) {
+    const u = SAFE_USER.test(String(username || '')) ? String(username) : 'x-access-token'
+    return '!f() { echo username=' + u + '; echo password=$CMARK_GIT_TOKEN; }; f'
+  }
+  function netCred (args) {
+    if (!args.some(function (a) { return NET_CMDS[a] })) return null
+    // 先取本工作区的凭据，再回退到旧版全局配置（迁移兼容）
+    let rec = null
+    try { rec = wsPrefs.read(WS).remoteToken || null } catch (e) {}
+    if (!(rec && rec.token)) {
+      const c = readNetCfg()
+      rec = (c && c.remoteToken) || null
+    }
+    if (!rec || !rec.token) return null
+    // 用户名以配置为准；老配置没有 username 字段就用远端地址推断，
+    // 这样已经用旧版本绑过 Gitee 的用户升级后不用重新授权
+    return { token: rec.token, username: rec.username || userForUrl(rec.url || originUrl()) }
+  }
+
   function exec(args, opt) {
     const o = opt || {}
+    const cred = o.token
+      ? { token: o.token, username: o.username || userForUrl(o.url || originUrl()) }
+      : netCred(args)
+    const token = cred && cred.token
+    const pre = token
+      ? ['-c', 'core.quotepath=false', '-c', 'credential.helper=', '-c', 'credential.helper=' + tokenHelper(cred.username)]
+      : BASE_ARGS
     return new Promise((resolve) => {
-      execFile('git', BASE_ARGS.concat(args), {
+      execFile('git', pre.concat(args), {
         cwd: repoRoot || WS,
         encoding: o.buffer ? 'buffer' : 'utf8',
         maxBuffer: 32 * 1024 * 1024,
@@ -254,7 +319,8 @@ module.exports = function installGitService(win, argvPath) {
           GCM_INTERACTIVE: 'never',
           GIT_TERMINAL_PROMPT: '0',
           GIT_LITERAL_PATHSPECS: '1',
-          LC_ALL: 'C'
+          LC_ALL: 'C',
+          CMARK_GIT_TOKEN: token || ''
         })
       }, (err, stdout, stderr) => {
         if (err) {
@@ -688,7 +754,8 @@ module.exports = function installGitService(win, argvPath) {
     const names = staged.data.split('\0').filter(Boolean)
     if (!names.length) return { ok: false, kind: 'nothing', message: ERR_TEXT.nothing }
 
-    const msg = formatMessage(message || cfg.commitMessage, { count: names.length })
+    // 固定使用内置模板：cmark sync:YYYY-MM-DD HH:mm:ss
+    const msg = formatMessage(DEFAULTS.commitMessage, { count: names.length })
     const r = await runGit(['commit', '-m', msg], { label: 'commit', timeout: 90000 })
     if (!r.ok) return r
     return { ok: true, data: { message: msg, files: names.length } }
@@ -1280,6 +1347,31 @@ module.exports = function installGitService(win, argvPath) {
     }
   }
 
+  // ---- 手填远程地址的支持 ----
+  // 远程地址可能是需要授权的私有仓库（GitHub/Gitee/自建 GitLab 等）。
+  // 这里给两个能力：先探测（看能不能免授权访问），再用显式 token 探测/绑定。
+  async function probeRemote (url, token) {
+    const u = String(url || '').trim()
+    if (!u) return { ok: false, kind: 'badrev', message: '请填写远程仓库地址' }
+    if (!/^(https?:\/\/|git@|ssh:\/\/|file:\/\/|[A-Za-z]:[\\/]|\\\\|\/)/.test(u)) {
+      return { ok: false, kind: 'badrev', message: '远程地址格式不正确：' + u }
+    }
+    const r = await runGit(['ls-remote', '--heads', u], { label: 'probe', timeout: 60000, token: token || undefined, url: u })
+    if (r.ok) return { ok: true, data: { hasRefs: !!String(r.data || '').trim() } }
+    return { ok: false, kind: r.kind, message: r.message }
+  }
+
+  /** 保存手填地址用的访问令牌（按工作区存，记录地址用于展示） */
+  function setRemoteToken (token, url) {
+    const t = String(token || '').trim()
+    if (!t) return { ok: false, message: '令牌为空' }
+    const u = String(url || '').trim()
+    // 记下按远端推断出的用户名：Gitee 要求它与令牌所有者一致，见 userForUrl
+    const res = wsPrefs.patch(WS, { remoteToken: { provider: 'custom', token: t, url: u, username: userForUrl(u) } })
+    if (res && res.ok === false) return res
+    return { ok: true }
+  }
+
   async function setRemote(url) {
     const pre = precheck()
     if (!pre.ok) return pre
@@ -1357,6 +1449,7 @@ module.exports = function installGitService(win, argvPath) {
     stage, unstage, discard, restoreTo,
     commitAll, push, pull, sync,
     remoteInfo: getRemoteInfo, setRemote,
+    probeRemote, setRemoteToken,
     identity: getIdentity, setIdentity,
     abortInProgress,
     clearStaleLock,

package/preload/host.js

@@ -0,0 +1,130 @@
+/**
+ * 宿主适配：uTools / ZTools / 浏览器
+ *
+ * 两个宿主的 API 名字一致，但注入的全局对象不同：
+ *   uTools  注入 window.utools
+ *   ZTools  注入 window.ztools
+ *
+ * 两个坑必须一起处理：
+ *  1) preload 可能在宿主注入全局对象「之前」执行（uTools 尤其如此），
+ *     这时候直接读 window.utools 是 undefined，若把 undefined 当结论，
+ *     后面所有 window.ztools.xxx 都会炸，preload 直接中断 —— 表现就是
+ *     设置面板、Git 面板全都打不开。
+ *  2) 两个宿主的 API 并非完全同集，缺某个方法时不能让调用方 TypeError。
+ *
+ * 所以这里不写死别名，而是装一个惰性代理：读取时才去 window.utools /
+ * window.ztools 找真实对象，找不到就返回 no-op 并记一笔，等宿主注入后
+ * 同一个代理立刻恢复正常。
+ */
+
+const RAW_U = (typeof window !== 'undefined' && window.utools) || null
+const RAW_Z = (typeof window !== 'undefined' && window.ztools) || null
+const PROXY_TAG = '__cmark_host_proxy__'
+
+/** 真实的宿主对象（排除我们自己的代理） */
+function target() {
+  try {
+    const u = window.utools
+    const z = window.ztools
+    if (u && !u[PROXY_TAG]) return u
+    if (z && !z[PROXY_TAG]) return z
+    return null
+  } catch (e) {
+    return null
+  }
+}
+
+function makeProxy() {
+  const missing = new Set()
+  const p = new Proxy(
+    {},
+    {
+      get(_, prop) {
+        if (prop === PROXY_TAG) return true
+        const t = target() || RAW_U || RAW_Z
+        if (!t) {
+          // 宿主还没注入：函数类先给 no-op，避免 preload 在早期就崩掉
+          return function () { return undefined }
+        }
+        const v = t[prop]
+        if (typeof v === 'function') return v.bind(t)
+        if (v === undefined) {
+          missing.add(String(prop))
+          return function () { return undefined }
+        }
+        return v
+      },
+      has(_, prop) {
+        const t = target() || RAW_U || RAW_Z
+        return !!t && prop in t
+      },
+    }
+  )
+  try {
+    Object.defineProperty(p, '__missing', { value: missing, enumerable: false })
+  } catch (e) {}
+  return p
+}
+
+let proxy = null
+
+/**
+ * 装 shim：缺哪个补哪个（只在缺失时补，不覆盖宿主原对象）。
+ * 返回值就是当前识别到的宿主名。
+ */
+function applyHostShim() {
+  try {
+    if (typeof window === 'undefined') return 'node'
+    if (!window.utools && !window.ztools) {
+      proxy = makeProxy()
+      window.ztools = proxy
+      window.utools = proxy
+    } else {
+      if (!window.utools) window.utools = window.ztools
+      if (!window.ztools) window.ztools = window.utools
+    }
+    // 每次读取时重新判断，宿主晚注入也能正确反映
+    try {
+      Object.defineProperty(window, '__CMARK_HOST', {
+        configurable: true,
+        get() { return detect() },
+      })
+    } catch (e) {
+      window.__CMARK_HOST = detect()
+    }
+    return detect()
+  } catch (e) {
+    return 'browser'
+  }
+}
+
+function detect() {
+  // 关键：shim 之后 window.utools 与 window.ztools 是同一个对象，
+  // 不能拿「是谁」判断，必须用 shim 之前的快照 RAW_U / RAW_Z。
+  if (RAW_U && !RAW_Z) return 'utools'
+  if (RAW_Z && !RAW_U) return 'ztools'
+  // 宿主晚注入的情形：看实时注入的对象里哪个是真实的（非我们的代理）
+  const u = window.utools
+  const z = window.ztools
+  const realU = u && !u[PROXY_TAG]
+  const realZ = z && !z[PROXY_TAG]
+  if (realU && !realZ) return 'utools'
+  if (realZ && !realU) return 'ztools'
+  return 'browser'
+}
+
+function hostApi() {
+  return target() || RAW_U || RAW_Z || null
+}
+
+function isInHost() {
+  return !!hostApi()
+}
+
+/** 哪些方法宿主没提供过（用于排查，不抛错） */
+function missingMethods() {
+  if (proxy && proxy.__missing) return Array.from(proxy.__missing)
+  return []
+}
+
+module.exports = { detect, applyHostShim, hostApi, isInHost, missingMethods, target }