@qic-9821/dsh-plugin-sync 0.1.0 → 0.1.2

package/README.md

@@ -40,6 +40,8 @@ dsh plugin --profile <profile> add @qic-9821/dsh-plugin-sync
 | 允许对端改动本机 | `capRemoteApply` | 关掉后对端连读都读不到 |
 | 同步密钥字段 | `capSecrets` | 默认关；`appSecret` / `token` / `*key*` 一律写成 `[redacted]` |
 
+默认只开「插件清单与启停」和「允许对端改动本机」；配置、安装、复制二进制、密钥四项要自己在设置页打开，打开后下一次自动同步就会真的落地对应操作。
+
 安装、升级、卸载、启停全部走宿主的 `pluginManager` 服务（`installBundle` / `updateBundle` / `removeBundle` / `setBundleEnabled` / `setPluginEnabled`），不自己拼 pnpm 命令行、不手写 profile 的 `package.json`，失败由宿主回滚它自己的改动。
 
 ## 怎么连
@@ -55,9 +57,11 @@ dsh plugin --profile <profile> add @qic-9821/dsh-plugin-sync
 
 - `autoStart`：DSH 启动后约 25 秒跑一轮（等宿主把插件挂完）。
 - `autoRestart`：进程重启后再补一轮（约 2 分钟），处理对端还在启动的情况；服务器重启后的同步就是这条。
-- `intervalMinutes`：固定间隔（0 = 关）。
+- `intervalMinutes`：固定间隔（0 = 关）。只在 DSH 运行期间生效，每 N 分钟跑一轮完整同步；和「启动时」「重启后」两轮互不影响。
 - 手动：面板/设置页按钮，或工具 `plugin_sync` `action="run"`。
 
+总开关 `enabled` 关掉后，以上任何自动同步与手动同步都不执行（仍可在面板上「只看计划」）。
+
 ## 冲突策略
 
 - `local`：以发起方为准（默认）

package/client.js

@@ -94,6 +94,9 @@ window.__ModuleLoader__.load({
           }),
           h('span', { key: 'text' }, [
             h('b', { key: 'name' }, props.label),
+            props.dirty
+              ? h('span', { key: 'dirty', style: { marginLeft: 6, fontSize: 11, color: 'var(--dsh-accent, #3b82f6)' } }, '未保存')
+              : null,
             props.desc ? h('div', { key: 'desc', style: MUTED }, props.desc) : null,
           ]),
         ],
@@ -125,8 +128,18 @@ window.__ModuleLoader__.load({
       }, [load])
 
       const config = state?.config || {}
-      const value = useCallback((key) => (draft[key] !== undefined ? draft[key] : config[key]), [draft, config])
+      const caps = config.capabilities || {}
+      // draft wins, then the nested capabilities map, then the flat key
+      const value = useCallback(
+        (key) => (draft[key] !== undefined ? draft[key] : caps[key] !== undefined ? caps[key] : config[key]),
+        [draft, caps, config],
+      )
+      const dirty = useCallback((key) => draft[key] !== undefined, [draft])
       const setValue = useCallback((key, next) => setDraft((current) => ({ ...current, [key]: next })), [])
+      const capsOn = useMemo(
+        () => (state?.capabilityCatalog || []).filter((cap) => Boolean(value(cap.key))).length,
+        [state, value],
+      )
 
       const save = useCallback(async () => {
         if (Object.keys(draft).length === 0) return
@@ -182,6 +195,7 @@ window.__ModuleLoader__.load({
               : status.localError || '读取失败',
           ],
           ['profile 目录', status.profileDir || '?'],
+          ['版本', status.package ? `${status.package.name} ${status.package.version || ''}`.trim() : '?'],
           ['对端', status.peer?.describe || '?'],
           [
             '上次同步',
@@ -189,9 +203,10 @@ window.__ModuleLoader__.load({
               ? `${formatTime(status.lastRun.at)} · ${status.lastRun.ok ? '成功' : `失败：${status.lastRun.error || ''}`}`
               : '还没跑过',
           ],
+          ['设置保存于', state?.updatedAt ? formatTime(state.updatedAt) : '还没保存过'],
           ['当前', status.running ? '同步中…' : '空闲'],
         ]
-      }, [status])
+      }, [status, state?.updatedAt])
 
       if (!state) {
         return h('div', { style: { padding: 16, fontSize: 13 } }, error ? `读取失败：${error}` : '读取中…')
@@ -259,7 +274,8 @@ window.__ModuleLoader__.load({
               h(Toggle, {
                 key: 'enable',
                 label: '总开关',
-                desc: '关掉后「启动时同步」和手动同步都不动作',
+                desc: '关掉后任何自动与手动同步都不执行（仍可「只看计划」）',
+                dirty: dirty('enabled'),
                 checked: Boolean(value('enabled')),
                 onChange: (next) => setValue('enabled', next),
               }),
@@ -267,6 +283,7 @@ window.__ModuleLoader__.load({
                 key: 'startup',
                 label: '软件启动时同步',
                 desc: 'DSH 启动后约 25 秒跑一轮（等宿主把插件都挂上）',
+                dirty: dirty('autoStart'),
                 checked: Boolean(value('autoStart')),
                 onChange: (next) => setValue('autoStart', next),
               }),
@@ -274,22 +291,38 @@ window.__ModuleLoader__.load({
                 key: 'restart',
                 label: '服务器重启后同步',
                 desc: '进程重启之后再补一轮，处理对端还在启动的情况',
+                dirty: dirty('autoRestart'),
                 checked: Boolean(value('autoRestart')),
                 onChange: (next) => setValue('autoRestart', next),
               }),
-              h(Field, { key: 'interval', label: '每隔多少分钟同步（0 = 不按间隔）' },
-                input(value('intervalMinutes'), '0', (next) => setValue('intervalMinutes', Number(next) || 0))),
-              h(Field, { key: 'delay', label: '启动后延迟秒数' },
+              h(Toggle, {
+                key: 'interval',
+                label: '定时同步',
+                desc: 'DSH 运行期间每 N 分钟跑一轮；关掉就是「不按间隔」，和上面两轮互不影响',
+                dirty: dirty('intervalMinutes'),
+                checked: Number(value('intervalMinutes')) > 0,
+                onChange: (next) =>
+                  setValue('intervalMinutes', next ? Number(value('intervalMinutes')) || 15 : 0),
+              }),
+              Number(value('intervalMinutes')) > 0
+                ? h(
+                    Field,
+                    { key: 'intervalValue', label: '间隔分钟数（1–1440）' },
+                    input(value('intervalMinutes'), '15', (next) => setValue('intervalMinutes', Math.max(0, Number(next) || 0))),
+                  )
+                : null,
+              h(Field, { key: 'delay', label: '启动后延迟秒数（只影响「软件启动时同步」）' },
                 input(value('startupDelaySec'), '25', (next) => setValue('startupDelaySec', Number(next) || 0))),
             ]),
           ]),
 
-          h(Card, { key: 'caps', title: '权限（每一项可以单独关）' },
+          h(Card, { key: 'caps', title: `权限（已开启 ${capsOn} / ${(state.capabilityCatalog || []).length}，每一项可以单独关）` },
             (state.capabilityCatalog || []).map((cap) =>
               h(Toggle, {
                 key: cap.key,
                 label: cap.label,
                 desc: cap.desc,
+                dirty: dirty(cap.key),
                 checked: Boolean(value(cap.key)),
                 onChange: (next) => setValue(cap.key, next),
               }),
@@ -298,7 +331,13 @@ window.__ModuleLoader__.load({
 
           h('div', { key: 'save', style: { display: 'flex', gap: 8, alignItems: 'center' } }, [
             h('button', { key: 'save', style: BUTTON_PRIMARY, disabled: Boolean(busy) || Object.keys(draft).length === 0, onClick: () => void save() }, '保存设置'),
-            h('span', { key: 'hint', style: MUTED }, Object.keys(draft).length === 0 ? '没有未保存的改动' : `${Object.keys(draft).length} 项待保存`),
+            h(
+              'span',
+              { key: 'hint', style: MUTED },
+              Object.keys(draft).length === 0
+                ? `已保存 · ${state?.updatedAt ? formatTime(state.updatedAt) : '（本次打开后还没改过）'}`
+                : `${Object.keys(draft).length} 项待保存`,
+            ),
           ]),
 
           out ? h('pre', { key: 'out', style: { marginTop: 12, whiteSpace: 'pre-wrap', fontSize: 11.5, maxHeight: 260, overflow: 'auto', background: 'rgba(127,127,127,.1)', padding: 10, borderRadius: 8 } }, out) : null,

package/lib/engine.js

@@ -90,6 +90,7 @@ export class Engine {
       },
       direction: cfg.direction,
       conflict: cfg.conflict,
+      package: { name: PACKAGE_NAME, version: this.version || null },
       capabilities: Object.fromEntries(CAPABILITY_KEYS.map((key) => [key, Boolean(cfg[key])])),
       local,
       localError,

package/lib/http.js

@@ -148,6 +148,8 @@ export async function statePayload(engine, cfg) {
       capabilities: Object.fromEntries(
         Object.keys(CAPABILITY_LABELS).map((key) => [key, Boolean(cfg[key])]),
       ),
+      // flat mirror of the capabilities, so consumers can read `capPlugins` directly
+      ...Object.fromEntries(Object.keys(CAPABILITY_LABELS).map((key) => [key, Boolean(cfg[key])])),
       include: cfg.include,
       exclude: cfg.exclude,
     },
@@ -319,6 +321,7 @@ function render() {
   const s = state.status
   $('status').innerHTML = [
     ['本机', s.local ? (s.local.node || '?') + ' · ' + (s.local.profile || '') + ' · ' + s.local.bundles + ' 包 / ' + s.local.plugins + ' 条目' : '读取失败'],
+    ['版本', s.package ? s.package.name + ' ' + (s.package.version || '') : '?'],
     ['profile', s.profileDir || '?'],
     ['对端', s.peer.describe],
     ['上次同步', s.lastRun ? (s.lastRun.at + ' · ' + (s.lastRun.ok ? '成功' : '失败：' + (s.lastRun.error || ''))) : '还没跑过'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qic-9821/dsh-plugin-sync",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Keep the DSH plugin set (inventory, configs, enable state, package installs, local bundle binaries) in sync between two machines, with per-capability switches, schedule controls and a settings/panel UI.",
   "license": "MIT",
   "author": "QIC-9821",