@qic-9821/dsh-plugin-sync 0.1.1 → 0.1.3

package/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -4,8 +4,16 @@
 
 npm：[`@qic-9821/dsh-plugin-sync`](https://www.npmjs.com/package/@qic-9821/dsh-plugin-sync) · 仓库：<https://github.com/QIC-9821/dsh-plugin-sync> · MIT
 
+## 演示
+
+独立面板（`http://127.0.0.1:<端口>/plugin-sync`）：状态、对端、同步方式、权限、计划日志一张页面上全有。
+
 ![独立面板](docs/panel.png)
 
+同一套设置在系统设置里也有一页（`设置 → 插件同步`），改完即保存，权限可以一项一项单独关：
+
+![设置页](docs/settings-sync.png)
+
 配套：`设置 → 插件同步`（系统设置菜单栏里的独立一页）、`设置 → 插件 → 同步`（Plugins 段内的一页）、独立面板 `http://127.0.0.1:<端口>/plugin-sync`、两个 Agent 工具 `plugin_sync` / `plugin_sync_config`。
 
 ## 安装
@@ -40,6 +48,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 +65,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
@@ -190,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}` : '读取中…')
@@ -260,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),
               }),
@@ -268,6 +283,7 @@ window.__ModuleLoader__.load({
                 key: 'startup',
                 label: '软件启动时同步',
                 desc: 'DSH 启动后约 25 秒跑一轮（等宿主把插件都挂上）',
+                dirty: dirty('autoStart'),
                 checked: Boolean(value('autoStart')),
                 onChange: (next) => setValue('autoStart', next),
               }),
@@ -275,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),
               }),
@@ -299,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/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,
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qic-9821/dsh-plugin-sync",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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",
@@ -23,6 +23,9 @@
     "cordis.patch.yml",
     "LICENSE"
   ],
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
   "keywords": [
     "dsh",
     "deepseek-harness",
@@ -53,8 +56,5 @@
         "@deepseek-ai/dsh-client-ui-settings"
       ]
     }
-  },
-  "scripts": {
-    "test": "node --test test/*.test.js"
   }
-}
+}