dsh-my-guardian 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.2] - 2026-08-28
+
+### 变更
+
+- feat(ui): dsh-my-guardian 插件治理面板翻新——开关/图标/日志层级（issue #54）
+- refactor(shared): 抽取 dsh-shared 共享工具包，10 个插件迁移消除重复实现（issue #45）
+- chore(deps): 升级 react 19 兼容性——13 个插件 peer 声明 ^18.2.0 || ^19.2.0（issue #49）
+- style(format): 全仓 prettier 格式化（issue #44）
+- fix(ci): 并行化后的两个失败——Syntax check 对无 lib 的插件（dsh-plugin-dev-mode）用 if 结构；guardian waitFor 超时 3s→10s（并行环境更稳）
+
 ## [0.3.1] - 2026-08-27
 
 ### 变更

package/README.md

@@ -31,7 +31,6 @@ cordis.staged.json（候选区）
 
 > 💡 **npm 安装（普通用户推荐）**：`dsh plugin --profile web add dsh-my-guardian`——无需克隆本仓库；以下 link 方式供本仓库开发者使用。
 
-
 ### 方式一：dsh plugin（推荐）
 
 ```sh
@@ -64,9 +63,7 @@ dsh plugin --profile web add link:<仓库路径>/plugins/dsh-my-guardian
 新建 `~/.dsh/profiles/web/cordis.staged.json`（与 `cordis.patch.yml` 同目录）：
 
 ```json
-[
-  { "id": "my-plugin", "name": "dsh-my-plugin", "config": { "option": 1 } }
-]
+[{ "id": "my-plugin", "name": "dsh-my-plugin", "config": { "option": 1 } }]
 ```
 
 - `id`：唯一标识（不能与现有插件行 id 冲突）
@@ -79,12 +76,12 @@ dsh plugin --profile web add link:<仓库路径>/plugins/dsh-my-guardian
 
 侧边栏 → "插件守护"页签：
 
-| 状态 | 含义 | 操作 |
-|------|------|------|
-| 运行中 | 已挂载 | 移除 |
-| 待加载 | 尚未处理（安全模式等） | — |
-| 失败 ×N | 挂载失败 N 次 | 重试 / 移除 |
-| 冻结 | 连续失败 3 次 | 重试（解除冻结）/ 移除 |
+| 状态    | 含义                   | 操作                   |
+| ------- | ---------------------- | ---------------------- |
+| 运行中  | 已挂载                 | 移除                   |
+| 待加载  | 尚未处理（安全模式等） | —                      |
+| 失败 ×N | 挂载失败 N 次          | 重试 / 移除            |
+| 冻结    | 连续失败 3 次          | 重试（解除冻结）/ 移除 |
 
 ### 效果截图（真实 DSH 实例验证）
 
@@ -110,12 +107,12 @@ dsh plugin --profile web add link:<仓库路径>/plugins/dsh-my-guardian
 
 ## 依赖
 
-| 依赖 | 用途 | 可选 |
-|---|---|---|
-| `cordis` | 插件运行时 | 是（宿主提供） |
+| 依赖                 | 用途                                                                                                           | 可选           |
+| -------------------- | -------------------------------------------------------------------------------------------------------------- | -------------- |
+| `cordis`             | 插件运行时                                                                                                     | 是（宿主提供） |
 | `dsh-better-sidebar` | 侧边栏「插件守护」诊断面板（**可选增强，不参与依赖声明**：未安装时自动跳过面板注册，API / 候选区治理不受影响） | 否（可选增强） |
-| `react` | client 端组件 | 是（宿主提供） |
-| `dsh-my-notify` | 失败 / 冻结事件浏览器通知 | 是 |
+| `react`              | client 端组件                                                                                                  | 是（宿主提供） |
+| `dsh-my-notify`      | 失败 / 冻结事件浏览器通知                                                                                      | 是             |
 
 ## 相关文档
 

package/lib/api.js

@@ -4,23 +4,7 @@
  * appears), trust fence, method dispatch and the panel snapshot.
  */
 import { readStagedFile, writeStagedFile } from './state.js'
-import { isTrustedApiRequest } from './fence.js'
-
-function writeJson(response, status, value) {
-  const payload = JSON.stringify(value)
-  response.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-cache' })
-  response.end(payload)
-}
-
-async function readJsonBody(request) {
-  let body = ''
-  for await (const chunk of request) {
-    body += chunk
-    if (body.length > 1_000_000) throw new Error('request body too large')
-  }
-  if (body === '') return {}
-  return JSON.parse(body)
-}
+import { isTrustedApiRequest, readJsonBody, writeJson } from 'dsh-shared'
 
 /** Bind the API entry points to one guardian instance's shared state. */
 export function createApi(ctx, shared) {
@@ -41,15 +25,21 @@ function ensureApi(ctx, shared) {
   const webRuntime = ctx.get('webRuntime')
   shared.apiRegistered = true
   try {
-    ctx.effect(() => webServer.register({
-      kind: 'prefix',
-      path: '/guardian/api',
-      handler: (request, response) => handleApiRequest(ctx, shared, webRuntime, request, response),
-    }), 'dsh-my-guardian: /guardian/api routes')
+    ctx.effect(
+      () =>
+        webServer.register({
+          kind: 'prefix',
+          path: '/guardian/api',
+          handler: (request, response) => handleApiRequest(ctx, shared, webRuntime, request, response),
+        }),
+      'dsh-my-guardian: /guardian/api routes',
+    )
   } catch (error) {
     // registration failed: allow a later poll tick to retry
     shared.apiRegistered = false
-    ctx.logger?.warn(`[dsh-my-guardian] api registration failed: ${error instanceof Error ? error.message : String(error)}`)
+    ctx.logger?.warn(
+      `[dsh-my-guardian] api registration failed: ${error instanceof Error ? error.message : String(error)}`,
+    )
   }
 }
 
@@ -64,7 +54,10 @@ async function handleApiRequest(ctx, shared, webRuntime, request, response) {
   try {
     await dispatchApiMethod(ctx, shared, method, request, response)
   } catch (error) {
-    writeJson(response, 400, { ok: false, error: { message: error instanceof Error ? error.message : String(error) } })
+    writeJson(response, 400, {
+      ok: false,
+      error: { message: error instanceof Error ? error.message : String(error) },
+    })
   }
 }
 
@@ -112,7 +105,10 @@ async function handleStagedPost(ctx, shared, request, response) {
   }
   const entries = await readStagedFile(shared.stagedFile)
   if (entries.some((item) => item?.id === id)) {
-    writeJson(response, 409, { ok: false, error: { message: `"${id}" already in the staged file` } })
+    writeJson(response, 409, {
+      ok: false,
+      error: { message: `"${id}" already in the staged file` },
+    })
     return
   }
   entries.push({ id, name, ...(payload.config !== undefined ? { config: payload.config } : {}) })
@@ -170,7 +166,13 @@ function snapshot(shared) {
       frozen: record.frozen,
       lastError: record.lastError,
       lastFailedAt: record.lastFailedAt,
-      status: shared.mounted.has(id) ? 'running' : record.frozen ? 'frozen' : record.attempts > 0 ? 'failed' : 'pending',
+      status: shared.mounted.has(id)
+        ? 'running'
+        : record.frozen
+          ? 'frozen'
+          : record.attempts > 0
+            ? 'failed'
+            : 'pending',
     })
   }
   const promotedList = []
@@ -183,8 +185,19 @@ function snapshot(shared) {
       lastError: record.lastError,
       lastFailedAt: record.lastFailedAt,
       promotedAt: record.promotedAt,
-      status: shared.mounted.has(id) ? 'running' : record.frozen ? 'frozen' : record.attempts > 0 ? 'failed' : 'pending',
+      status: shared.mounted.has(id)
+        ? 'running'
+        : record.frozen
+          ? 'frozen'
+          : record.attempts > 0
+            ? 'failed'
+            : 'pending',
     })
   }
-  return { safeMode: shared.state.safeMode, staged: stagedList, promoted: promotedList, events: shared.state.events.slice(-10) }
+  return {
+    safeMode: shared.state.safeMode,
+    staged: stagedList,
+    promoted: promotedList,
+    events: shared.state.events.slice(-10),
+  }
 }