@windypro-rourou/dsh-logcat 0.4.0 → 0.4.2

package/README.md

@@ -43,6 +43,11 @@ 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）生效
+
 # 方式二（源码本地链接，实时生效无需重启）：把插件链进 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,9 @@ 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 [level, setLevel] = useState("");
 			const [keyword, setKeyword] = useState("");
 			const [autoScroll, setAutoScroll] = useState(true);
@@ -249,6 +252,9 @@ window.__ModuleLoader__.load({
 						setDevices(body.devices ?? []);
 						setStreaming(body.streaming ?? []);
 						setCurrentPackage(body.currentPackage ?? "");
+						setCurrentVersion(body.currentVersion ?? "");
+						setLatestVersion(body.latestVersion ?? "");
+						setUpdateAvailable(body.updateAvailable === true);
 						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 +455,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: "#fbc02d" } },
+							h("b", null, "新版本 " + latestVersion + " 可更新"),
+							"（dsh plugin --profile web update 后重启 GUI）")
+						: null,
 					currentPackage !== ""
 						? h("span", { title: "当前测试应用包名（agent 通过 logcat_set_package 设置）" }, "测试: " + currentPackage)
 						: null,

package/lib/index.js

@@ -15,13 +15,32 @@
  */
 
 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 version on npm (cached 1h; null until first check). */
+let latestVersion = null
+let lastVersionCheck = 0
+
+/** Refresh the cached latest npm version of this package (offline-safe). */
+async function ensureVersionCheck() {
+  if (latestVersion !== null && Date.now() - lastVersionCheck < 3600_000) return
+  lastVersionCheck = Date.now()
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(OWN_MANIFEST.name)}/latest`, {
+      signal: AbortSignal.timeout(8000),
+    })
+    if (res.ok) latestVersion = (await res.json()).version ?? null
+  } catch { /* offline / registry unreachable — keep whatever we had */ }
+}
+
 /** Stable cordis plugin name. */
 export const name = 'logcat'
 
@@ -41,14 +60,14 @@ export const LOGCAT_GUIDANCE =
   '设备与状态：logcat_devices（列出设备）、device_info（型号/版本/SDK/分辨率/内存/电量）、device_stats（CPU/内存/电量采样）；' +
   '部署与执行：adb_install（本地 APK 装真机）、adb_exec（任意 adb shell 命令）、adb_pull（拉文件）、input_tap/input_swipe/input_text（模拟点击/滑动/输入）、ui_dump（界面层级 XML）；' +
   '日志与崩溃：logcat_recent（按级别/关键词/包名读日志）、logcat_crash（崩溃/ANR 捕获+上下文）、logcat_set_package（锁定当前测试包名）；' +
-  '逆向与内存：proc_list（进程列表）、proc_maps（内存映射+so 模块基址）、proc_status（进程状态/内存摘要）、mem_dump（指定地址读内存 hex）、frida_server（frida-server 部署/启停）。' +
+  '逆向与内存：proc_list（进程列表）、proc_maps（内存映射+so 模块基址）、proc_status（进程状态/内存摘要）、proc_smaps（内存占用明细 Top 区域）、mem_dump（指定地址读内存 hex）、mem_search（内存搜 hex 模式/字符串）、frida_server（frida-server 部署/启停）、frida_script（hook/trace/scan/bypass/dump 常用脚本模板）。' +
   '工作流建议：构建安卓应用 → 确认设备在线后 adb_install 部署、adb_exec 启动、logcat_set_package 锁包、logcat_recent/logcat_crash 看崩溃、ui_dump+input_* 做界面自动化；' +
   '逆向分析 → proc_list 找进程、proc_maps 拿模块基址、mem_dump 读内存、frida_server 起 frida。' +
   '限制：需设备开启 USB 调试并授权本机；读其他应用内存/maps 需要 root 或 debuggable 应用（run-as）；logcat 输出可能含敏感信息；' +
   '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 +78,10 @@ function logcatGuidance(engine) {
     const pkgLine = engine.currentPackage !== ''
       ? `当前测试应用包名：${engine.currentPackage}（logcat_recent 默认按它过滤日志）。`
       : ''
-    return `${LOGCAT_GUIDANCE}\n${deviceLine}${pkgLine !== '' ? `\n${pkgLine}` : ''}`
+    const versionLine = latestVersion !== null && latestVersion !== OWN_MANIFEST.version
+      ? `dsh-logcat 有新版本：已装 ${OWN_MANIFEST.version}，最新 ${latestVersion}（用户可执行 dsh plugin --profile web update 后重启 GUI 升级）。`
+      : ''
+    return `${LOGCAT_GUIDANCE}\n${deviceLine}${pkgLine !== '' ? `\n${pkgLine}` : ''}${versionLine !== '' ? `\n${versionLine}` : ''}`
   }
 }
 
@@ -484,6 +506,7 @@ 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()
         writeJson(res, 200, {
           adbPath: engine.adb,
           adbVersion: engine.adbVersion,
@@ -491,6 +514,9 @@ function makeRoutes(engine) {
           devices: engine.deviceList(),
           streaming: [...engine.streams.keys()],
           currentPackage: engine.currentPackage,
+          currentVersion: OWN_MANIFEST.version,
+          latestVersion,
+          updateAvailable: latestVersion !== null && latestVersion !== OWN_MANIFEST.version,
         })
       },
     },
@@ -1830,6 +1856,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.0",
+  "version": "0.4.2",
   "type": "module",
   "packageManager": "pnpm@11.22.0",
   "engines": {