@windypro-rourou/dsh-logcat 0.4.1 → 0.5.0-preview.0

package/README.md

@@ -43,6 +43,24 @@ DSH Web GUI 的安卓实机调试面板（类似 Android Studio 的 Logcat 视
 # 方式一（推荐，npm 安装）：
 dsh plugin --profile web add @windypro-rourou/dsh-logcat
 
+# 更新到最新版（不会自动更新；装旧版时面板/agent 通告会提示有新版本）：
+dsh plugin --profile web update                # 升到当前 major 内最新
+# 或强制最新：dsh plugin --profile web add @windypro-rourou/dsh-logcat@latest
+# 更新后重启 GUI（dsh web）生效
+
+# 尝鲜 preview 版（日常迭代高频更新，可能不稳定）：
+dsh plugin --profile web add @windypro-rourou/dsh-logcat@preview
+```
+
+## 发布策略（main / preview 双通道）
+
+- **`main` 分支 + npm `latest` 标签**：稳定正式版，**低频发布**，每次至少凑够 3-4 个功能再发，
+  避免频繁更新提醒打扰用户。
+- **`preview` 分支 + npm `preview` 标签**：日常迭代，有啥更啥（高频），供尝鲜用户测试；
+  凑够足够功能后合并回 `main` 批量发布正式版。
+- 版本自检会按安装通道提示（正式版用户只看 `latest`，preview 用户只看 `preview`，互不打扰）。
+
+```bash
 # 方式二（源码本地链接，实时生效无需重启）：把插件链进 web profile，
 # 并在 ~/.dsh/profiles/web/cordis.patch.yml 增加一行：
 pnpm --dir "%USERPROFILE%\.dsh\profiles\web" add link:F:\dsh-logcat

package/lib/client.js

@@ -114,6 +114,11 @@ window.__ModuleLoader__.load({
 			const [currentPackage, setCurrentPackage] = useState("");
 			const [pkgInput, setPkgInput] = useState("");
 			const [installingAdb, setInstallingAdb] = useState(false);
+			const [currentVersion, setCurrentVersion] = useState("");
+			const [latestVersion, setLatestVersion] = useState("");
+			const [updateAvailable, setUpdateAvailable] = useState(false);
+			const [updateKind, setUpdateKind] = useState("");
+			const [updateHint, setUpdateHint] = useState("");
 			const [level, setLevel] = useState("");
 			const [keyword, setKeyword] = useState("");
 			const [autoScroll, setAutoScroll] = useState(true);
@@ -249,6 +254,11 @@ window.__ModuleLoader__.load({
 						setDevices(body.devices ?? []);
 						setStreaming(body.streaming ?? []);
 						setCurrentPackage(body.currentPackage ?? "");
+						setCurrentVersion(body.currentVersion ?? "");
+						setLatestVersion(body.latestVersion ?? "");
+						setUpdateAvailable(body.updateAvailable === true);
+						setUpdateKind(body.updateKind ?? "");
+						setUpdateHint(body.updateHint ?? "");
 						devicesRef.current = body.devices ?? [];
 						if (serialRef.current === "" || !(body.devices ?? []).some((d) => d.serial === serialRef.current)) {
 							const first = (body.devices ?? []).find((d) => d.state === "device");
@@ -449,6 +459,12 @@ window.__ModuleLoader__.load({
 							: null),
 					h("span", null, "设备 " + devices.length + " · 在线 " + devices.filter((d) => d.state === "device").length),
 					h("span", null, "显示 " + filtered.length + " / 缓冲 " + entries.length + " 行"),
+					h("span", { title: "插件版本" }, "v" + (currentVersion || "?")),
+					updateAvailable === true
+						? h("span", { style: { color: updateKind === "preview" ? "#4fc3f7" : "#fbc02d" } },
+							h("b", null, updateHint || "有新版本"),
+							updateKind === "preview" ? "（preview 尝鲜版）" : "（dsh plugin --profile web update 后重启 GUI）")
+						: null,
 					currentPackage !== ""
 						? h("span", { title: "当前测试应用包名（agent 通过 logcat_set_package 设置）" }, "测试: " + currentPackage)
 						: null,

package/lib/index.js

@@ -15,13 +15,75 @@
  */
 
 import { spawn, execFile } from 'node:child_process'
-import { existsSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
 import { createInterface } from 'node:readline'
 import { WebSocket, WebSocketServer } from 'ws'
 import { defineTool } from '@deepseek-ai/dsh-tools'
 
+/** This package's manifest (name + version), read from the installed location. */
+const OWN_MANIFEST = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+
+/** Latest published versions per dist-tag (cached 1h; null until first check). */
+let latestVersion = null   // dist-tags.latest (stable)
+let previewVersion = null  // dist-tags.preview (experimental)
+let lastVersionCheck = 0
+
+/** Simple semver compare: 1 when a > b, -1 when a < b, 0 equal. Prerelease < release. */
+function semverCompare(a, b) {
+  const parse = (v) => {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(v ?? '')
+    return m ? { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]), pre: m[4] ?? null } : null
+  }
+  const pa = parse(a)
+  const pb = parse(b)
+  if (pa === null || pb === null) return 0
+  for (const key of ['major', 'minor', 'patch']) {
+    if (pa[key] !== pb[key]) return pa[key] > pb[key] ? 1 : -1
+  }
+  if (pa.pre === pb.pre) return 0
+  if (pa.pre === null) return 1 // release > prerelease
+  if (pb.pre === null) return -1
+  return pa.pre > pb.pre ? 1 : -1
+}
+
+/** Refresh the cached npm dist-tags of this package (offline-safe). */
+async function ensureVersionCheck() {
+  if ((latestVersion !== null || previewVersion !== null) && Date.now() - lastVersionCheck < 3600_000) return
+  lastVersionCheck = Date.now()
+  try {
+    const res = await fetch(`https://registry.npmjs.org/-/package/${encodeURIComponent(OWN_MANIFEST.name)}/dist-tags`, {
+      signal: AbortSignal.timeout(8000),
+    })
+    if (res.ok) {
+      const tags = await res.json()
+      latestVersion = tags.latest ?? null
+      previewVersion = tags.preview ?? null
+    }
+  } catch { /* offline / registry unreachable — keep whatever we had */ }
+}
+
+/** Whether this install is a prerelease (preview line). */
+const IS_PREVIEW = OWN_MANIFEST.version.includes('-')
+
+/** The update hint for the current install, or null when up to date. */
+function updateHint() {
+  if (IS_PREVIEW) {
+    if (previewVersion !== null && semverCompare(previewVersion, OWN_MANIFEST.version) > 0) {
+      return { kind: 'preview', version: previewVersion, text: `新 preview 版本 ${previewVersion} 可更新（npm 标签 preview；正式版 ${latestVersion ?? '?'} 未受影响）` }
+    }
+    if (previewVersion === null && latestVersion !== null && semverCompare(latestVersion, OWN_MANIFEST.version) > 0) {
+      return { kind: 'stable', version: latestVersion, text: `正式版 ${latestVersion} 已发布，可切回稳定版` }
+    }
+    return null
+  }
+  if (latestVersion !== null && semverCompare(latestVersion, OWN_MANIFEST.version) > 0) {
+    return { kind: 'stable', version: latestVersion, text: `新版本 ${latestVersion} 可更新` }
+  }
+  return null
+}
+
 /** Stable cordis plugin name. */
 export const name = 'logcat'
 
@@ -48,7 +110,7 @@ export const LOGCAT_GUIDANCE =
   'adb 命令消耗真实设备资源，破坏性操作（卸载/重启/清数据/杀进程）先向用户确认再执行。' +
   '用户提到「Logcat / 安卓日志 / 实机调试 / adb 日志 / 逆向 / 读内存 / 抓包定位」时即指本插件，请据此主动协作。'
 
-/** Dynamic model-facing announcement: base guidance plus currently attached devices. */
+/** Dynamic model-facing announcement: base guidance plus live device/package/version facts. */
 function logcatGuidance(engine) {
   return () => {
     const devices = engine.deviceList()
@@ -59,7 +121,13 @@ function logcatGuidance(engine) {
     const pkgLine = engine.currentPackage !== ''
       ? `当前测试应用包名：${engine.currentPackage}（logcat_recent 默认按它过滤日志）。`
       : ''
-    return `${LOGCAT_GUIDANCE}\n${deviceLine}${pkgLine !== '' ? `\n${pkgLine}` : ''}`
+    const versionLine = (() => {
+      const hint = updateHint()
+      if (hint === null) return ''
+      const tag = IS_PREVIEW ? 'preview' : 'stable'
+      return `dsh-logcat 更新提醒（${tag} 通道）：${hint.text}（升级：dsh plugin --profile web update 或 add @windypro-rourou/dsh-logcat@${hint.kind === 'preview' ? 'preview' : 'latest'}，然后重启 GUI）。`
+    })()
+    return `${LOGCAT_GUIDANCE}\n${deviceLine}${pkgLine !== '' ? `\n${pkgLine}` : ''}${versionLine !== '' ? `\n${versionLine}` : ''}`
   }
 }
 
@@ -484,6 +552,8 @@ function makeRoutes(engine) {
       handler: async (req, res) => {
         if (!isLoopbackRequest(req)) { writeJson(res, 403, { error: 'forbidden: loopback-only' }); return }
         if ((req.method ?? 'GET') !== 'GET') { writeJson(res, 405, { error: 'method not allowed' }); return }
+        await ensureVersionCheck()
+        const hint = updateHint()
         writeJson(res, 200, {
           adbPath: engine.adb,
           adbVersion: engine.adbVersion,
@@ -491,6 +561,13 @@ function makeRoutes(engine) {
           devices: engine.deviceList(),
           streaming: [...engine.streams.keys()],
           currentPackage: engine.currentPackage,
+          currentVersion: OWN_MANIFEST.version,
+          latestVersion,
+          previewVersion,
+          updateAvailable: hint !== null,
+          updateKind: hint?.kind ?? null,
+          updateTarget: hint?.version ?? null,
+          updateHint: hint?.text ?? null,
         })
       },
     },
@@ -1830,6 +1907,7 @@ export function apply(ctx, config) {
   const initOnce = () => {
     if (inited) return
     inited = true
+    void ensureVersionCheck()
     void engine.init().then((ok) => {
       if (ok) engine.startPolling()
     })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@windypro-rourou/dsh-logcat",
   "description": "Android Logcat viewer for the dsh web GUI: auto-connects to any adb device in debug mode, live logcat stream with level/keyword filters, pause/clear/export, plus agent tools (logcat_recent). Hot-pluggable — mounted via ~/.dsh/cordis.patch.yml + a profile node_modules copy, no dsh source changes.",
-  "version": "0.4.1",
+  "version": "0.5.0-preview.0",
   "type": "module",
   "packageManager": "pnpm@11.22.0",
   "engines": {