@code_tin/dsh-sync 0.1.0 → 0.2.1

package/README.md

@@ -2,8 +2,8 @@
 
 通过 Git 在多个设备之间同步 DeepSeek Harness（DSH）的会话。
 
-- npm：`@code_tin/dsh-sync`；安装：`plugin_manager install_bundle { "target": "@code_tin/dsh-sync@0.1.0" }`
-- 设置页：**设置 → 会话 Git 同步**，填写 Git 仓库地址与分支，查看本地/镜像状态，直接拉取或推送。
+- npm：`@code_tin/dsh-sync`；安装：`plugin_manager install_bundle { "target": "@code_tin/dsh-sync@0.2.0" }`
+- 设置页：**设置 → 会话 Git 同步**，填写 Git 仓库地址与分支，查看本地/镜像状态，直接拉取或推送；可勾选**自动同步**并设置间隔（分钟）。
 - 命令：`/sync`、`/sync pull`、`/sync push`、`/sync test`。
 - 数据：本机会话仍在 `~/.dsh/sessions`；插件在 `~/.dsh/dsh-sync/repo` 维护一个专用 Git 镜像仓库，不往会话目录里写 `.git`。
 
@@ -16,6 +16,7 @@
 
 - **push**：先 flush 活跃会话，把本地 `session.*.jsonl.zstd` 复制进镜像，提交并推送。推送被拒绝（其他设备刚推过）时会自动 fetch 重试一次；同一会话冲突时本地文件优先。
 - **pull**：把镜像快进到远程分支，只复制本地**不存在**的会话文件。本地已有的会话一律保留，并计入“跳过”数量。
+- **自动同步**：勾选后，宿主进程每隔设定的分钟数执行一次 push（首次在保存后一个间隔触发），不需要手动点按钮。开关、间隔改动保存后立即重新计时；关闭后不再调度。
 - 只同步会话日志文件；`session.lock`、`.DS_Store` 等不会进入仓库。
 
 ## 使用
@@ -23,8 +24,9 @@
 1. 在设置页填写仓库地址，例如 `https://github.com/me/dsh-sessions.git` 或 `git@github.com:me/dsh-sessions.git`，保存。
 2. 在设备 A 执行 `/sync push`（或点“推送到远程”）。
 3. 在设备 B 保存同一地址后执行 `/sync pull`，刷新侧边栏（或重新打开窗口）即可看到新会话。
+4. 需要持续同步时勾选“自动同步”，填入间隔分钟数（1–1440，默认 10），保存。状态区会显示下次自动推送时间。
 
-`/sync` 显示状态；`/sync test` 测试连接。Git 认证沿用本机的 SSH agent / credential helper，插件不会保存凭据。若 HTTPS 需要账号密码，请先配置好 credential helper，否则命令会快速失败而不是弹出交互提示。
+`/sync` 显示状态（含自动同步开关、下次时间和上次自动推送结果）；`/sync test` 测试连接。Git 认证沿用本机的 SSH agent / credential helper，插件不会保存凭据。若 HTTPS 需要账号密码，请先配置好 credential helper，否则命令会快速失败而不是弹出交互提示。
 
 ## 安装（开发目录）
 
@@ -41,6 +43,8 @@ plugin_manager install_bundle { "target": "/path/to/dsh-sync" }
 - 同一个会话如果在两台设备上继续写入，pull 不会合并日志：保留本地版本并跳过该文件。需要时请在镜像仓库里手动取出远端版本。
 - 首次 pull 之前远程必须至少有一次 push（远程分支不存在时 pull 会明确报错）。
 - 镜像仓库会保留历史上推送过的会话；本机删除会话不会删除镜像中的副本。
+- 自动同步只做 push，不自动 pull；需要把其他设备的会话取回时仍要手动 pull。
+- 自动同步依赖 DSH 宿主进程持续运行；宿主退出期间不会推送，重启后从新间隔重新计时；系统休眠唤醒后会在计时到期时补触发一次。失败只记录到状态与日志，不会重试。
 - Git 地址保存在 `~/.dsh/dsh-sync/settings.json`（权限 0600）。不要把带 token 的 URL 提交到任何地方。
 
 ## 分发给其他设备
@@ -51,13 +55,13 @@ plugin_manager install_bundle { "target": "/path/to/dsh-sync" }
 
 ```bash
 npm pack
-# 生成 code_tin-dsh-sync-0.1.0.tgz
+# 生成 code_tin-dsh-sync-0.2.0.tgz
 ```
 
 把 tgz 拷到目标机器，在 DSH 里安装：
 
 ```
-plugin_manager install_bundle { "target": "/绝对路径/code_tin-dsh-sync-0.1.0.tgz" }
+plugin_manager install_bundle { "target": "/绝对路径/code_tin-dsh-sync-0.2.0.tgz" }
 ```
 
 Plugin Manager 支持目录、tarball、git 地址和 npm 包名这几类安装 spec。
@@ -74,7 +78,7 @@ npm publish --access public
 发布后其他机器直接安装：
 
 ```
-plugin_manager install_bundle { "target": "@code_tin/dsh-sync@0.1.0" }
+plugin_manager install_bundle { "target": "@code_tin/dsh-sync@0.2.0" }
 ```
 
 注意：发布到 npm 只解决“可安装”，不会自动让插件出现在 DSH 插件市场的 Discover 列表；市场收录通常还需要公开仓库和索引源。

package/client.js

@@ -2,9 +2,10 @@
  * Browser half of `dsh-sync`.
  *
  * Adds one page under Settings → 会话 Git 同步 (Settings → Session Git Sync).
- * The page writes the repository URL and branch, and triggers pull/push through
- * the host Remote service registered by `index.js`. All session bytes and git
- * work stay on the host; this module only renders state and calls endpoints.
+ * The page writes the repository URL, branch, and auto-sync schedule, and
+ * triggers pull/push through the host Remote service registered by `index.js`.
+ * All session bytes and git work stay on the host; this module only renders
+ * state and calls endpoints.
  */
 window.__ModuleLoader__.load({
   id: '@code_tin/dsh-sync',
@@ -17,18 +18,23 @@ window.__ModuleLoader__.load({
     const ZH = {
       nav: '会话 Git 同步',
       title: '会话 Git 同步',
-      subtitle: '把本机的 DSH 会话镜像到一个 Git 仓库，在多个设备之间共享。拉取只新增本地不存在的会话，不会覆盖本地已有会话。',
+      subtitle: '把本机的 DSH 会话镜像到一个 Git 仓库，在多个设备之间共享。拉取只新增本地不存在的会话，不会覆盖本地已有会话；也可以开启定时自动推送。',
       remoteLabel: 'Git 仓库地址',
       remotePlaceholder: 'https://example.com/user/dsh-sessions.git',
       branchLabel: '分支',
       branchPlaceholder: 'main',
+      autoLabel: '自动同步',
+      autoHint: '开启后每隔下面的时间自动把本地会话推送到 Git（等同 /sync push），DSH 宿主进程需要保持运行。',
+      intervalLabel: '自动同步间隔（分钟）',
+      intervalUnit: '分钟',
+      intervalInvalid: '自动同步间隔需要是 1 到 1440 之间的整数分钟。',
       save: '保存',
       test: '测试连接',
       pull: '从远程拉取',
       push: '推送到远程',
       refresh: '刷新状态',
       unsaved: '有未保存的修改；拉取或推送前会自动保存。',
-      saved: '已保存 Git 地址。',
+      saved: '已保存设置。',
       statusTitle: '同步状态',
       commandsTitle: '命令',
       cmdStatus: '查看同步状态',
@@ -39,8 +45,14 @@ window.__ModuleLoader__.load({
       branchStatus: '分支',
       localStatus: '本地会话 / 文件',
       mirrorStatus: '镜像仓库',
+      autoStatus: '自动同步',
+      autoOff: '已关闭',
+      autoOn: '每 {minutes} 分钟',
+      autoNext: '每 {minutes} 分钟，下次 {time}',
+      autoNoRemote: '已开启，尚未配置远程仓库',
       lastPush: '上次推送',
       lastPull: '上次拉取',
+      lastAutoPush: '上次自动推送',
       dataDir: '本地会话目录',
       repoDir: '镜像仓库目录',
       notConfigured: '未配置',
@@ -61,18 +73,23 @@ window.__ModuleLoader__.load({
     const EN = {
       nav: 'Session Git Sync',
       title: 'Session Git Sync',
-      subtitle: 'Mirror this device’s DSH sessions into a git repository and share them across devices. Pull only adds sessions missing locally; it never overwrites an existing local session.',
+      subtitle: 'Mirror this device’s DSH sessions into a git repository and share them across devices. Pull only adds sessions missing locally; it never overwrites an existing local session. Optionally push on a timer.',
       remoteLabel: 'Git repository URL',
       remotePlaceholder: 'https://example.com/user/dsh-sessions.git',
       branchLabel: 'Branch',
       branchPlaceholder: 'main',
+      autoLabel: 'Auto sync',
+      autoHint: 'When enabled, local sessions are pushed to git every interval (same as /sync push). The DSH host process must stay running.',
+      intervalLabel: 'Auto sync interval (minutes)',
+      intervalUnit: 'min',
+      intervalInvalid: 'The auto sync interval must be a whole number between 1 and 1440 minutes.',
       save: 'Save',
       test: 'Test connection',
       pull: 'Pull from remote',
       push: 'Push to remote',
       refresh: 'Refresh status',
       unsaved: 'Unsaved changes; pull or push saves them first.',
-      saved: 'Git URL saved.',
+      saved: 'Settings saved.',
       statusTitle: 'Sync status',
       commandsTitle: 'Commands',
       cmdStatus: 'show sync status',
@@ -83,8 +100,14 @@ window.__ModuleLoader__.load({
       branchStatus: 'Branch',
       localStatus: 'Local sessions / files',
       mirrorStatus: 'Mirror',
+      autoStatus: 'Auto sync',
+      autoOff: 'Off',
+      autoOn: 'Every {minutes} min',
+      autoNext: 'Every {minutes} min, next {time}',
+      autoNoRemote: 'On, but no remote repository is configured',
       lastPush: 'Last push',
       lastPull: 'Last pull',
+      lastAutoPush: 'Last auto push',
       dataDir: 'Local session directory',
       repoDir: 'Mirror directory',
       notConfigured: 'Not configured',
@@ -112,6 +135,12 @@ window.__ModuleLoader__.load({
 .dshsync-row { display: flex; gap: 10px; }
 .dshsync-grow { flex: 1 1 auto; min-width: 0; }
 .dshsync-branch { width: 170px; flex: 0 0 auto; }
+.dshsync-check { display: flex; align-items: center; gap: 8px; font-size: 13px; color: var(--dsw-alias-label-primary); cursor: pointer; }
+.dshsync-check input { width: 15px; height: 15px; margin: 0; accent-color: var(--dsw-alias-brand-primary); }
+.dshsync-field-hint { margin: 0; font-size: 12px; line-height: 1.5; color: var(--dsw-alias-label-secondary); }
+.dshsync-interval-row { display: flex; align-items: center; gap: 8px; }
+.dshsync-interval-input { width: 120px; }
+.dshsync-unit { font-size: 12px; color: var(--dsw-alias-label-secondary); }
 .dshsync-label { font-size: 12px; font-weight: 500; color: var(--dsw-alias-label-secondary); }
 .dshsync-input { box-sizing: border-box; width: 100%; height: 34px; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-base); color: var(--dsw-alias-label-primary); font-size: 13px; outline: none; }
 .dshsync-input::placeholder { color: var(--dsw-alias-state-idle-primary); }
@@ -184,7 +213,12 @@ window.__ModuleLoader__.load({
       }
       return {
         status: () => call('status'),
-        save: (remote, branch) => call('save', { remote, branch }),
+        save: (remote, branch, autoPush, autoPushIntervalMinutes) => call('save', {
+          remote,
+          branch,
+          autoPush,
+          autoPushIntervalMinutes,
+        }),
         test: (remote) => call('test', { remote }),
         pull: () => call('pull'),
         push: () => call('push'),
@@ -196,6 +230,8 @@ window.__ModuleLoader__.load({
       const [snapshot, setSnapshot] = React.useState(null)
       const [remote, setRemote] = React.useState('')
       const [branch, setBranch] = React.useState('main')
+      const [autoPush, setAutoPush] = React.useState(false)
+      const [intervalText, setIntervalText] = React.useState('10')
       const [dirty, setDirty] = React.useState(false)
       const [busy, setBusy] = React.useState('')
       const [notice, setNotice] = React.useState(null)
@@ -212,6 +248,8 @@ window.__ModuleLoader__.load({
             setSnapshot(value)
             setRemote(value.remote || '')
             setBranch(value.branch || 'main')
+            setAutoPush(value.autoPush === true)
+            setIntervalText(String(value.autoPushIntervalMinutes ?? 10))
           })
           .catch((error) => {
             if (alive) setNotice({ kind: 'error', text: `${t('loadFailed')}: ${errorText(error)}` })
@@ -241,19 +279,38 @@ window.__ModuleLoader__.load({
         }
       }
 
+      const parseInterval = () => {
+        const value = Number(intervalText)
+        return Number.isInteger(value) && value >= 1 && value <= 1440 ? value : null
+      }
+
+      const applySettings = (settings) => {
+        if (!settings) return
+        if (typeof settings.remote === 'string') setRemote(settings.remote)
+        if (typeof settings.branch === 'string') setBranch(settings.branch)
+        if (typeof settings.autoPush === 'boolean') setAutoPush(settings.autoPush)
+        if (settings.autoPushIntervalMinutes !== undefined) {
+          setIntervalText(String(settings.autoPushIntervalMinutes))
+        }
+      }
+
       const saveFirst = async () => {
         if (!dirty) return true
+        const interval = parseInterval()
+        if (interval === null) {
+          setNotice({ kind: 'error', text: t('intervalInvalid') })
+          return false
+        }
         setBusy('save')
         try {
-          const saved = await rpc.save(remote.trim(), branch.trim())
+          const saved = await rpc.save(remote.trim(), branch.trim(), autoPush, interval)
           if (saved && saved.status) setSnapshot(saved.status)
           if (saved && saved.ok === false) {
             setNotice({ kind: 'error', text: saved.message || t('failed') })
             return false
           }
           setDirty(false)
-          setRemote(saved && saved.settings ? saved.settings.remote : remote.trim())
-          setBranch(saved && saved.settings ? saved.settings.branch : branch.trim())
+          applySettings(saved && saved.settings)
           return true
         } catch (error) {
           setNotice({ kind: 'error', text: errorText(error) })
@@ -264,13 +321,15 @@ window.__ModuleLoader__.load({
       }
 
       const onSave = async () => {
-        const result = await perform('save', () => rpc.save(remote.trim(), branch.trim()))
+        const interval = parseInterval()
+        if (interval === null) {
+          setNotice({ kind: 'error', text: t('intervalInvalid') })
+          return
+        }
+        const result = await perform('save', () => rpc.save(remote.trim(), branch.trim(), autoPush, interval))
         if (!result || result.ok === false) return
         setDirty(false)
-        if (result.settings) {
-          setRemote(result.settings.remote)
-          setBranch(result.settings.branch)
-        }
+        applySettings(result.settings)
         setNotice({ kind: 'ok', text: t('saved') })
       }
 
@@ -321,6 +380,8 @@ window.__ModuleLoader__.load({
           if (!dirty) {
             setRemote(value.remote || '')
             setBranch(value.branch || 'main')
+            setAutoPush(value.autoPush === true)
+            setIntervalText(String(value.autoPushIntervalMinutes ?? 10))
           }
           setNotice({ kind: 'info', text: t('refreshed') })
         } catch (error) {
@@ -334,6 +395,14 @@ window.__ModuleLoader__.load({
       const state = snapshot && snapshot.state ? snapshot.state : {}
       const local = snapshot && snapshot.local ? snapshot.local : { sessions: 0, files: 0 }
       const mirror = snapshot && snapshot.mirror ? snapshot.mirror : { initialized: false, sessions: 0, files: 0 }
+      const autoText = (() => {
+        if (!snapshot || snapshot.autoPush !== true) return t('autoOff')
+        if (!snapshot.remote) return t('autoNoRemote')
+        const minutes = snapshot.autoPushIntervalMinutes ?? 10
+        return snapshot.autoPushNextAt
+          ? format(t('autoNext'), { minutes, time: timeText(snapshot.autoPushNextAt) })
+          : format(t('autoOn'), { minutes })
+      })()
 
       const row = (key, label, value, mono) => [
         h('dt', { className: 'dshsync-k', key: `${key}-k` }, label),
@@ -385,6 +454,42 @@ window.__ModuleLoader__.load({
               }),
             ),
           ),
+          h('div', { className: 'dshsync-field' },
+            h('label', { className: 'dshsync-check', htmlFor: 'dshsync-auto' },
+              h('input', {
+                id: 'dshsync-auto',
+                type: 'checkbox',
+                checked: autoPush,
+                disabled: busy === 'save',
+                onChange: (event) => {
+                  setAutoPush(event.target.checked)
+                  setDirty(true)
+                },
+              }),
+              h('span', null, t('autoLabel')),
+            ),
+            h('p', { className: 'dshsync-field-hint' }, t('autoHint')),
+          ),
+          h('div', { className: 'dshsync-field dshsync-interval' },
+            h('label', { className: 'dshsync-label', htmlFor: 'dshsync-interval' }, t('intervalLabel')),
+            h('div', { className: 'dshsync-interval-row' },
+              h('input', {
+                id: 'dshsync-interval',
+                className: 'dshsync-input dshsync-interval-input',
+                type: 'number',
+                min: 1,
+                max: 1440,
+                step: 1,
+                value: intervalText,
+                disabled: busy === 'save',
+                onChange: (event) => {
+                  setIntervalText(event.target.value)
+                  setDirty(true)
+                },
+              }),
+              h('span', { className: 'dshsync-unit' }, t('intervalUnit')),
+            ),
+          ),
           h('div', { className: 'dshsync-actions' },
             h('button', { type: 'button', className: 'dshsync-btn dshsync-btn-primary', onClick: onSave, disabled }, t('save')),
             h('button', { type: 'button', className: 'dshsync-btn', onClick: onTest, disabled }, t('test')),
@@ -406,6 +511,7 @@ window.__ModuleLoader__.load({
             : h('dl', { className: 'dshsync-grid' },
               row('remote', t('remoteStatus'), snapshot.remote || t('notConfigured')),
               row('branch', t('branchStatus'), snapshot.branch),
+              row('auto', t('autoStatus'), autoText),
               row('local', t('localStatus'), `${local.sessions} / ${local.files}`),
               row('mirror', t('mirrorStatus'), mirror.initialized
                 ? `${mirror.sessions} / ${mirror.files}`
@@ -413,6 +519,9 @@ window.__ModuleLoader__.load({
               row('push', t('lastPush'), state.lastPushAt
                 ? `${timeText(state.lastPushAt)}${state.lastPushOk === false ? ' ✕' : ''}`
                 : t('never')),
+              row('autoPush', t('lastAutoPush'), state.lastAutoPushAt
+                ? `${timeText(state.lastAutoPushAt)}${state.lastAutoPushOk === false ? ' ✕' : ''}`
+                : t('never')),
               row('pull', t('lastPull'), state.lastPullAt
                 ? `${timeText(state.lastPullAt)}${state.lastPullOk === false ? ' ✕' : ''}`
                 : t('never')),

package/index.js

@@ -12,6 +12,7 @@
 import os from 'node:os'
 import path from 'node:path'
 import { SessionGitSync, validateBranch } from './lib/sync.js'
+import { AutoPushScheduler } from './lib/auto.js'
 import { registerRemoteService } from './lib/remote.js'
 
 const SERVICE_KEY = 'dshSync'
@@ -37,9 +38,24 @@ function formatStatus(status) {
       ? `${status.mirror.sessions} 个会话 / ${status.mirror.files} 个文件`
       : '尚未初始化（首次 /sync push 时创建）'}`,
   ]
+  if (status.autoPush) {
+    if (!status.remote) {
+      lines.push(`自动同步: 已开启（每 ${status.autoPushIntervalMinutes} 分钟），但尚未配置远程仓库`)
+    } else {
+      const next = status.autoPushNextAt
+        ? `，下次 ${formatTime(new Date(status.autoPushNextAt).toISOString())}`
+        : ''
+      lines.push(`自动同步: 每 ${status.autoPushIntervalMinutes} 分钟推送一次${next}`)
+    }
+  } else {
+    lines.push('自动同步: 已关闭（在设置页开启）')
+  }
   if (status.state.lastPushAt) {
     lines.push(`上次推送: ${formatTime(status.state.lastPushAt)} ${status.state.lastPushOk === false ? '失败' : '成功'}`)
   }
+  if (status.state.lastAutoPushAt) {
+    lines.push(`上次自动推送: ${formatTime(status.state.lastAutoPushAt)} ${status.state.lastAutoPushOk === false ? '失败' : '成功'}`)
+  }
   if (status.state.lastPullAt) {
     lines.push(`上次拉取: ${formatTime(status.state.lastPullAt)} ${status.state.lastPullOk === false ? '失败' : '成功'}`)
   }
@@ -63,6 +79,19 @@ export function apply(ctx) {
     logger: ctx.logger,
     flush: () => ctx.get('sessionPersistence')?.flush(),
   })
+  const scheduler = new AutoPushScheduler({ sync, logger: ctx.logger })
+
+  /** Status plus the live timer state the page and command both display. */
+  const readStatus = async () => ({
+    ...(await sync.status()),
+    autoPushNextAt: scheduler.nextAt,
+    autoPushRunning: scheduler.running,
+  })
+
+  ctx.effect(() => {
+    scheduler.start()
+    return () => scheduler.stop()
+  }, 'dsh-sync: auto push timer')
 
   ctx.effect(() => ctx.commands.register({
     name: 'sync',
@@ -72,7 +101,7 @@ export function apply(ctx) {
       const argument = String(invocation.rawInput ?? '').trim().toLowerCase()
       try {
         if (argument === '' || argument === 'status') {
-          return success(formatStatus(await sync.status()))
+          return success(formatStatus(await readStatus()))
         }
         if (argument === 'help') {
           return success([
@@ -115,7 +144,7 @@ export function apply(ctx) {
   const withStatus = async (result) => {
     let status
     try {
-      status = await sync.status()
+      status = await readStatus()
     } catch {
       status = undefined
     }
@@ -130,14 +159,15 @@ export function apply(ctx) {
       {
         method: 'status',
         implementation: function status() {
-          return sync.status()
+          return readStatus()
         },
       },
       {
         method: 'save',
-        implementation: async function save(remote, branch) {
+        implementation: async function save(remote, branch, autoPush, autoPushIntervalMinutes) {
           const normalizedBranch = validateBranch(branch)
-          const result = await sync.save(remote, normalizedBranch)
+          const result = await sync.save(remote, normalizedBranch, autoPush, autoPushIntervalMinutes)
+          await scheduler.refresh()
           return withStatus(result)
         },
       },

package/lib/auto.js

@@ -0,0 +1,115 @@
+/**
+ * Periodic auto-push for `dsh-sync`.
+ *
+ * The host owns one scheduler; it re-reads settings before every run so the
+ * checkbox and interval in the Settings page take effect without a restart.
+ * Each run is a normal `push`, so it shares the engine's queue and state
+ * recording with manual pushes.
+ */
+import { DEFAULT_AUTO_PUSH_INTERVAL_MINUTES } from './sync.js'
+
+export class AutoPushScheduler {
+  constructor({ sync, logger, setTimer, clearTimer } = {}) {
+    if (!sync) throw new Error('AutoPushScheduler needs a sync engine.')
+    this.sync = sync
+    this.logger = logger
+    this.setTimer = setTimer ?? ((fn, ms) => setTimeout(fn, ms))
+    this.clearTimer = clearTimer ?? ((id) => clearTimeout(id))
+    this.stopped = true
+    this.timer = undefined
+    this.nextAt = null
+    this.running = false
+  }
+
+  /** Begin watching settings; the first run happens one interval from now. */
+  start() {
+    if (!this.stopped) return
+    this.stopped = false
+    void this.arm()
+  }
+
+  stop() {
+    this.stopped = true
+    this.cancel()
+    this.nextAt = null
+  }
+
+  /** Re-arm after settings changed (enable/disable/interval). */
+  refresh() {
+    if (this.stopped) return Promise.resolve()
+    return this.arm()
+  }
+
+  cancel() {
+    if (this.timer !== undefined) {
+      this.clearTimer(this.timer)
+      this.timer = undefined
+    }
+  }
+
+  async arm() {
+    this.cancel()
+    this.nextAt = null
+    if (this.stopped) return
+    let settings
+    try {
+      settings = await this.sync.readSettings()
+    } catch (error) {
+      this.logger?.warn?.(`dsh-sync: cannot read settings for auto-sync: ${describeError(error)}`)
+      return
+    }
+    if (this.stopped) return
+    if (!settings.autoPush || settings.remote === '') return
+    const minutes = settings.autoPushIntervalMinutes || DEFAULT_AUTO_PUSH_INTERVAL_MINUTES
+    const delay = minutes * 60_000
+    this.nextAt = Date.now() + delay
+    this.timer = this.setTimer(() => {
+      void this.tick()
+    }, delay)
+    // A pending auto-push must never keep the host process alive.
+    this.timer?.unref?.()
+  }
+
+  async tick() {
+    this.timer = undefined
+    this.nextAt = null
+    if (this.stopped) return
+    if (this.running) {
+      void this.arm()
+      return
+    }
+    let settings
+    try {
+      settings = await this.sync.readSettings()
+    } catch (error) {
+      this.logger?.warn?.(`dsh-sync: cannot read settings for auto-sync: ${describeError(error)}`)
+      void this.arm()
+      return
+    }
+    if (!settings.autoPush || settings.remote === '') return
+
+    this.running = true
+    let outcome = { ok: false }
+    try {
+      const result = await this.sync.push()
+      outcome = result
+      if (result?.ok === false) {
+        this.logger?.warn?.(`dsh-sync: auto push skipped: ${result.message ?? 'not configured'}`)
+      }
+    } catch (error) {
+      this.logger?.warn?.(`dsh-sync: auto push failed: ${describeError(error)}`)
+    } finally {
+      this.running = false
+      if (!this.stopped) void this.arm()
+    }
+    try {
+      await this.sync.recordAutoPush(outcome)
+    } catch (error) {
+      this.logger?.warn?.(`dsh-sync: cannot record auto push: ${describeError(error)}`)
+    }
+  }
+}
+
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error)
+}

package/lib/sync.js

@@ -24,6 +24,11 @@ const TEST_TIMEOUT_MS = 45_000
 const MAX_BUFFER = 16 * 1024 * 1024
 const BRANCH_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,200}$/
 
+/** Auto-sync defaults and bounds, in minutes. */
+export const DEFAULT_AUTO_PUSH_INTERVAL_MINUTES = 10
+export const MIN_AUTO_PUSH_INTERVAL_MINUTES = 1
+export const MAX_AUTO_PUSH_INTERVAL_MINUTES = 1440
+
 /** A failed operation carrying the raw git result when one exists. */
 export class SyncFailure extends Error {
   constructor(message, details) {
@@ -125,6 +130,37 @@ export function validateBranch(branch) {
   return value
 }
 
+/**
+ * Validate the auto-sync interval (whole minutes).
+ *
+ * @param {unknown} value
+ * @returns {number}
+ */
+export function normalizeAutoPushInterval(value) {
+  if (value === undefined || value === null || value === '') {
+    return DEFAULT_AUTO_PUSH_INTERVAL_MINUTES
+  }
+  const number = Number(value)
+  if (!Number.isInteger(number)
+    || number < MIN_AUTO_PUSH_INTERVAL_MINUTES
+    || number > MAX_AUTO_PUSH_INTERVAL_MINUTES) {
+    throw new SyncFailure(
+      `Auto-sync interval must be a whole number between ${MIN_AUTO_PUSH_INTERVAL_MINUTES} and ${MAX_AUTO_PUSH_INTERVAL_MINUTES} minutes.`,
+    )
+  }
+  return number
+}
+
+/** Interval for an already persisted settings file; bad values fall back. */
+function storedAutoPushInterval(value) {
+  const number = Number(value)
+  return Number.isInteger(number)
+    && number >= MIN_AUTO_PUSH_INTERVAL_MINUTES
+    && number <= MAX_AUTO_PUSH_INTERVAL_MINUTES
+    ? number
+    : DEFAULT_AUTO_PUSH_INTERVAL_MINUTES
+}
+
 async function writeJsonAtomic(file, value) {
   const temporary = `${file}.${process.pid}.${Date.now()}.tmp`
   await fs.writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 })
@@ -180,6 +216,8 @@ export class SessionGitSync {
     return {
       remote: typeof stored?.remote === 'string' ? stored.remote : '',
       branch: typeof stored?.branch === 'string' && stored.branch ? stored.branch : 'main',
+      autoPush: stored?.autoPush === true,
+      autoPushIntervalMinutes: storedAutoPushInterval(stored?.autoPushIntervalMinutes),
     }
   }
 
@@ -192,6 +230,8 @@ export class SessionGitSync {
       lastPullAt: typeof stored?.lastPullAt === 'string' ? stored.lastPullAt : null,
       lastPullOk: typeof stored?.lastPullOk === 'boolean' ? stored.lastPullOk : null,
       lastPullSummary: typeof stored?.lastPullSummary === 'string' ? stored.lastPullSummary : null,
+      lastAutoPushAt: typeof stored?.lastAutoPushAt === 'string' ? stored.lastAutoPushAt : null,
+      lastAutoPushOk: typeof stored?.lastAutoPushOk === 'boolean' ? stored.lastAutoPushOk : null,
       lastError: typeof stored?.lastError === 'string' ? stored.lastError : null,
     }
   }
@@ -202,6 +242,14 @@ export class SessionGitSync {
     await writeJsonAtomic(this.statePath, next)
   }
 
+  /** Mark the outcome of one scheduled auto-sync run. */
+  async recordAutoPush(result) {
+    await this.recordState({
+      lastAutoPushAt: new Date().toISOString(),
+      lastAutoPushOk: result?.ok !== false,
+    })
+  }
+
   async gitVersion() {
     if (this.gitVersionPromise === undefined) {
       this.gitVersionPromise = (async () => {
@@ -274,6 +322,8 @@ export class SessionGitSync {
       configured: settings.remote !== '',
       remote: settings.remote,
       branch: settings.branch,
+      autoPush: settings.autoPush,
+      autoPushIntervalMinutes: settings.autoPushIntervalMinutes,
       repoDir: this.repoDir,
       sessionsRoot: this.sessionsRoot,
       local: summarize(localFiles),
@@ -283,19 +333,33 @@ export class SessionGitSync {
     }
   }
 
-  async save(remote, branch) {
+  async save(remote, branch, autoPush, autoPushIntervalMinutes) {
     const normalizedRemote = typeof remote === 'string' ? remote.trim() : ''
     const normalizedBranch = validateBranch(branch)
+    // Omitted auto-sync fields keep their stored values, so an older client
+    // that only sends remote/branch cannot silently disable a running schedule.
+    const current = await this.readSettings()
+    const normalizedAutoPush = autoPush === undefined ? current.autoPush : autoPush === true
+    const normalizedInterval = autoPushIntervalMinutes === undefined
+      ? current.autoPushIntervalMinutes
+      : normalizeAutoPushInterval(autoPushIntervalMinutes)
     if (normalizedRemote !== '') validateRemote(normalizedRemote)
     return this.enqueue(async () => {
       await fs.mkdir(this.dataDir, { recursive: true })
       await writeJsonAtomic(this.settingsPath, {
         remote: normalizedRemote,
         branch: normalizedBranch,
+        autoPush: normalizedAutoPush,
+        autoPushIntervalMinutes: normalizedInterval,
       })
       return {
         ok: true,
-        settings: { remote: normalizedRemote, branch: normalizedBranch },
+        settings: {
+          remote: normalizedRemote,
+          branch: normalizedBranch,
+          autoPush: normalizedAutoPush,
+          autoPushIntervalMinutes: normalizedInterval,
+        },
       }
     })
   }

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Session Git Sync",
-    "description": "Mirror DSH sessions into a git repository and share them across devices: /sync status, /sync pull and /sync push, plus a Settings page for the repository URL."
+    "description": "Mirror DSH sessions into a git repository and share them across devices: /sync status, /sync pull and /sync push, plus a Settings page for the repository URL and timed auto-push."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "会话 Git 同步",
-    "description": "把 DSH 会话镜像到 Git 仓库，在多个设备之间共享：/sync、/sync pull、/sync push，并在设置页面中配置仓库地址。"
+    "description": "把 DSH 会话镜像到 Git 仓库，在多个设备之间共享：/sync、/sync pull、/sync push，并在设置页面中配置仓库地址与定时自动推送。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@code_tin/dsh-sync",
-  "version": "0.1.0",
-  "description": "Sync DeepSeek Harness sessions across devices through a git repository, with a Settings page and /sync, /sync pull, /sync push commands.",
+  "version": "0.2.1",
+  "description": "Sync DeepSeek Harness sessions across devices through a git repository, with optional timed auto-push, a Settings page, and /sync commands.",
   "license": "MIT",
   "repository": {
     "type": "git",

package/icon.svg

@@ -1,12 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Session Git Sync">
-  <rect width="64" height="64" rx="14" fill="#1f6feb"/>
-  <g fill="none" stroke="#ffffff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round">
-    <path d="M21 16v23a6 6 0 0 0 6 6h14"/>
-    <path d="M43 16v8"/>
-  </g>
-  <circle cx="21" cy="13" r="5" fill="#ffffff"/>
-  <circle cx="43" cy="13" r="5" fill="#ffffff"/>
-  <circle cx="15" cy="47" r="5" fill="#ffffff"/>
-  <path d="M44 36a9 9 0 0 1 6 15" fill="none" stroke="#bcd7ff" stroke-width="3" stroke-linecap="round"/>
-  <path d="M52 44v7h-7" fill="none" stroke="#bcd7ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
-</svg>