@windypro-rourou/dsh-logcat 0.7.0 → 0.8.0

package/README.en.md

@@ -37,6 +37,7 @@ An Android real-device debugging workbench for the DSH Web GUI (an Android Studi
   - Reverse engineering / memory: `proc_list` (process list), `proc_maps` (memory maps + module bases), `proc_status` (process state / memory summary), `proc_smaps` (top Pss regions), `mem_dump` (read memory at an address as hex), `mem_search` (search memory for hex/string patterns), `frida_server` (deploy/start/stop frida-server), `frida_script` (generate hook/trace/scan/bypass/dump script templates)
 - **Real-device debugging workflow**: while building an Android app, the agent's announcement dynamically lists connected devices (serial + model) and the current test package. After confirming with the user: `adb_install` to deploy → `adb_exec`/`app_launch` to start → `logcat_set_package` to lock → `logcat_recent` / `logcat_crash` for crashes → `ui_dump` + `input_*` for UI automation → `adb_pull` for artifacts. A closed loop on real hardware.
 - **Reverse-engineering workflow**: `proc_list` to find the process → `proc_maps` for module bases → `mem_dump` at a target address / `mem_search` for signatures → `proc_smaps` for memory detail → `frida_script` + `frida_server` for dynamic instrumentation. Reading another app's memory/maps needs root or a debuggable app (run-as); tools return clear errors otherwise.
+- **Native integration (DSH 0.2)**: mounts through the official slots as a central `main` panel with its own `sidebar.panellist` row — the same docking, theming and layout behaviour as built-in panels; `dsh.client.inject` is aligned with the 0.2 manifest. Older clients (0.1.x) fall back to the right-hand drawer automatically, so one install serves both. Icons are a bundled SVG set (no icon dependency) and colours prefer the host's `--dsw-*` design tokens.
 - **Extra routes**: `POST /api/dsh-logcat/exec` (shell), `POST /api/dsh-logcat/package` (set package), `GET /api/dsh-logcat/screenshot`, `POST /api/dsh-logcat/install-adb`, `GET /api/dsh-logcat/history`, `GET /api/dsh-logcat/crashes` + `GET /api/dsh-logcat/crash-file`, `POST /api/dsh-logcat/install-apk`, `POST /api/dsh-logcat/keyevent`, `POST /api/dsh-logcat/wifi-connect` / `wifi-disconnect`, `GET /api/dsh-logcat/processes`, `POST /api/dsh-logcat/mem-search`, `GET /api/dsh-logcat/mem-dump`.
 - **On-disk data**: logs are written per device per day to `~/.dsh/logcat/logs/<serial>/logcat-MM-DD.log` (raw threadtime lines); crash snapshots live in `~/.dsh/logcat/crashes/<serial>/<timestamp>-<FATAL|ANR>/` (`screenshot.png` + `crash.log` + `meta.json`).
 

package/README.md

@@ -59,6 +59,9 @@ DSH Web GUI 的安卓实机调试面板（类似 Android Studio 的 Logcat 视
 - **逆向工作流**：`proc_list` 定位进程 → `proc_maps` 拿模块基址 → `mem_dump` 读目标地址 / `mem_search` 搜特征模式 →
   `proc_smaps` 看内存占用明细 → `frida_script` 生成脚本 + `frida_server` 起 frida 做动态插桩。
   读其他应用内存/maps 需要 root 或 debuggable 应用（run-as），工具会给出明确提示。
+- **原生集成（DSH 0.2）**：通过官方槽位挂载为「中央面板 + 左侧栏 Logcat 图标」（`main` + `sidebar.panellist`），
+  与内置面板同样的停靠/主题/布局体验；`dsh.client.inject` 已按 0.2 清单修正。旧版客户端（0.1.x）自动退回右侧抽屉，
+  一份安装通用。图标为内置 SVG 图标集（不依赖图标包），配色优先取宿主 `--dsw-*` 设计 token。
 - **附加能力**：`POST /api/dsh-logcat/exec` 执行 shell、`POST /api/dsh-logcat/package` 设置包名、
   `GET /api/dsh-logcat/screenshot` 截屏、`POST /api/dsh-logcat/install-adb` 一键装 adb、
   `GET /api/dsh-logcat/history` 历史回溯、`GET /api/dsh-logcat/crashes` + `GET /api/dsh-logcat/crash-file` 崩溃快照读取、

package/lib/client.js

@@ -238,6 +238,53 @@ window.__ModuleLoader__.load({
 .lc-pausedbar .lc-btn { padding: 2px 10px; }
 .lc-fab { position: absolute; right: 14px; bottom: 14px; z-index: 4; border: 1px solid rgba(66,133,244,.45); background: light-dark(rgba(66,133,244,.14), rgba(66,133,244,.24)); color: #4285f4; font: inherit; font-size: 12px; font-weight: 700; padding: 8px 14px; border-radius: 999px; cursor: pointer; box-shadow: 0 4px 14px rgba(0,0,0,.22); }
 .lc-fab:hover { background: light-dark(rgba(66,133,244,.22), rgba(66,133,244,.34)); }
+/* ---- design pass: token layer + refinements ------------------------------
+   Colours resolve from the DSH design tokens when the host exposes them and
+   fall back to a hand-tuned pair otherwise, so the panel reads native on 0.2
+   and still looks right on older clients. One accent (blue); severity hues are
+   data encoding, not decoration. */
+.lc-panel {
+  --lc-accent: var(--dsw-alias-brand-primary, #3b82f6);
+  --lc-accent-soft: light-dark(rgba(59,130,246,.10), rgba(59,130,246,.20));
+  --lc-raised: var(--dsw-alias-bg-layer-2, light-dark(#f7f8fa, #1c1f26));
+  --lc-fg: var(--dsw-alias-label-primary, light-dark(#16181d, #e6e9ef));
+  --lc-fg-2: var(--dsw-alias-label-secondary, light-dark(#4a4f57, #a8afba));
+  --lc-dim: var(--dsw-alias-label-caption, light-dark(#6b7078, #8b93a0));
+  --lc-border: var(--dsw-alias-border-l2, light-dark(rgba(0,0,0,.10), rgba(255,255,255,.12)));
+  --lc-border-strong: var(--dsw-alias-border-l4, light-dark(rgba(0,0,0,.20), rgba(255,255,255,.22)));
+  --lc-hover: var(--dsw-alias-interactive-bg-hover, light-dark(rgba(0,0,0,.045), rgba(255,255,255,.07)));
+  background: var(--dsw-alias-bg-layer-1, light-dark(#ffffff, #16181d));
+  color: var(--lc-fg);
+  font-family: system-ui, -apple-system, "Segoe UI Variable Text", "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
+}
+.lc-header { padding: 11px 14px; gap: 9px; border-bottom-color: var(--lc-border); }
+.lc-title { font-size: 14px; font-weight: 650; letter-spacing: -.01em; }
+.lc-tabs { gap: 2px; padding: 0 10px; border-bottom-color: var(--lc-border); }
+.lc-tab { font-size: 13px; font-weight: 500; padding: 8px 12px; border-radius: 0; box-shadow: none; opacity: .62; transition: opacity .12s ease, color .12s ease; }
+.lc-tab:hover { opacity: .95; background: transparent; }
+.lc-tab[data-on] { opacity: 1; background: transparent; color: var(--lc-accent); box-shadow: inset 0 -2px 0 var(--lc-accent); }
+.lc-chip { background: light-dark(rgba(0,0,0,.035), rgba(255,255,255,.05)); font-variant-numeric: tabular-nums; }
+.lc-icobtn { width: 28px; height: 26px; border-radius: 8px; border-color: transparent; color: var(--lc-fg-2); transition: background .12s ease, color .12s ease, border-color .12s ease; }
+.lc-icobtn:hover { background: var(--lc-hover); color: var(--lc-fg); }
+.lc-icobtn[data-on] { background: var(--lc-accent-soft); border-color: var(--lc-accent); color: var(--lc-accent); }
+.lc-btn { border-color: transparent; border-radius: 8px; color: var(--lc-fg-2); transition: background .12s ease, color .12s ease; }
+.lc-btn:hover { background: var(--lc-hover); color: var(--lc-fg); }
+.lc-btn[data-on] { background: var(--lc-accent-soft); color: var(--lc-accent); }
+.lc-icobtn:focus-visible, .lc-btn:focus-visible, .lc-key:focus-visible, .lc-tab:focus-visible { outline: 2px solid var(--lc-accent); outline-offset: 1px; }
+.lc-key { display: inline-flex; align-items: center; gap: 4px; border-radius: 7px; border-color: transparent; background: light-dark(rgba(0,0,0,.035), rgba(255,255,255,.05)); }
+.lc-key:hover { background: var(--lc-hover); }
+.lc-search, .lc-select { border-radius: 8px; border-color: var(--lc-border); background: var(--lc-raised); transition: border-color .12s ease, background .12s ease; }
+.lc-search:focus, .lc-select:focus { border-color: var(--lc-accent); background: light-dark(#ffffff, #16181d); outline: none; }
+.lc-line { font-family: ui-monospace, "Cascadia Mono", "JetBrains Mono", Consolas, monospace; font-size: 12px; font-variant-numeric: tabular-nums; }
+.lc-line:hover { background: var(--lc-hover); }
+.lc-log.compact .lc-line { font-size: 11px; }
+.lc-status { background: light-dark(rgba(0,0,0,.015), rgba(255,255,255,.022)); font-variant-numeric: tabular-nums; border-top-color: var(--lc-border); }
+.lc-empty { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 10px; color: var(--lc-dim); font-size: 12.5px; text-align: center; }
+.lc-empty-icon { color: light-dark(rgba(0,0,0,.20), rgba(255,255,255,.22)); }
+.lc-overlay { background: light-dark(rgba(15,23,42,.28), rgba(0,0,0,.48)); backdrop-filter: blur(2px); }
+.lc-modal { border-radius: 14px; border-color: var(--lc-border-strong); box-shadow: 0 24px 64px light-dark(rgba(15,23,42,.20), rgba(0,0,0,.55)); }
+.lc-hit { background: var(--lc-accent-soft); }
+.lc-re-head { text-transform: none; letter-spacing: 0; }
 `;
 		//#endregion
 
@@ -275,7 +322,7 @@ window.__ModuleLoader__.load({
 		const VIDEO_TIERS = { "360x800": 1200000, "540x1200": 2500000, "720x1600": 4000000, "1080x2400": 6000000 };
 
 		/** The Logcat panel view. */
-		function LogcatPanel({ controller }) {
+		function LogcatPanel({ controller, embedded }) {
 			const [adbPath, setAdbPath] = useState("");
 			const [adbReady, setAdbReady] = useState(false);
 			const [devices, setDevices] = useState([]);
@@ -1341,7 +1388,7 @@ window.__ModuleLoader__.load({
 							: devices.map((d) =>
 								h("option", { key: d.serial, value: d.serial },
 									(d.model !== "" ? d.model + " · " : "") + d.serial + " [" + d.state + "]"))),
-					h("button", { type: "button", className: "lc-close", onClick: () => controller.close(), title: "关闭面板" }, "✕"),
+					embedded === true ? null : h("button", { type: "button", className: "lc-close", onClick: () => controller.close(), title: "关闭面板" }, h(Icon, { name: "close", size: 14 })),
 				),
 				h("div", { className: "lc-stats" },
 					stats?.model
@@ -1420,11 +1467,11 @@ window.__ModuleLoader__.load({
 							style: { maxWidth: 180 },
 						}),
 						h("button", { type: "button", className: "lc-btn", onClick: () => setPackageFilter(pkgInput), title: "按包名过滤日志（agent 侧 logcat_recent 同步生效）" }, "包名"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: takeScreenshot, title: "截取真机屏幕并下载 PNG" }, "📷"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: loadHistory, title: "从磁盘加载历史日志（重启不丢）" }, "🕘"),
-						h("button", { type: "button", className: "lc-icobtn", "data-on": eventsOn ? "" : undefined, onClick: toggleEvents, title: "logcat -b events 事件缓冲（应用启动/崩溃/生命周期）" }, "📑"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: openCrashModal, title: "崩溃自动快照历史（截图+上下文）" }, "💥"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: () => setWifiOpen(true), title: "WiFi 无线调试（adb pair + connect）" }, "📶"),
+						h("button", { type: "button", className: "lc-icobtn", onClick: takeScreenshot, title: "截取真机屏幕并下载 PNG" }, h(Icon, { name: "camera" })),
+						h("button", { type: "button", className: "lc-icobtn", onClick: loadHistory, title: "从磁盘加载历史日志（重启不丢）" }, h(Icon, { name: "history" })),
+						h("button", { type: "button", className: "lc-icobtn", "data-on": eventsOn ? "" : undefined, onClick: toggleEvents, title: "logcat -b events 事件缓冲（应用启动/崩溃/生命周期）" }, h(Icon, { name: "events" })),
+						h("button", { type: "button", className: "lc-icobtn", onClick: openCrashModal, title: "崩溃自动快照历史（截图+上下文）" }, h(Icon, { name: "crash" })),
+						h("button", { type: "button", className: "lc-icobtn", onClick: () => setWifiOpen(true), title: "WiFi 无线调试（adb pair + connect）" }, h(Icon, { name: "wifi" })),
 						h("input", {
 							ref: fileInputRef,
 							type: "file",
@@ -1432,25 +1479,25 @@ window.__ModuleLoader__.load({
 							style: { display: "none" },
 							onChange: (e) => { installApkFile(e.target.files?.[0] ?? null); e.target.value = ""; },
 						}),
-						h("button", { type: "button", className: "lc-icobtn", onClick: () => fileInputRef.current?.click(), title: "选择本地 APK 安装到当前设备", disabled: installingApk ? true : undefined }, "📦"),
+						h("button", { type: "button", className: "lc-icobtn", onClick: () => fileInputRef.current?.click(), title: "选择本地 APK 安装到当前设备", disabled: installingApk ? true : undefined }, h(Icon, { name: "package" })),
 						h("button", { type: "button", className: "lc-icobtn", "data-on": paused ? "" : undefined, onClick: togglePause, title: "暂停冻结视图（新日志缓冲） / 继续回放" },
-							paused ? "▶" : "⏸"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: clearLog, title: "清空当前视图" }, "🗑"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: copyLog, title: "复制过滤后日志" }, "📋"),
-						h("button", { type: "button", className: "lc-icobtn", onClick: exportLog, title: "导出过滤后日志 .txt" }, "⬇"),
+							paused ? h(Icon, { name: "play" }) : h(Icon, { name: "pause" })),
+						h("button", { type: "button", className: "lc-icobtn", onClick: clearLog, title: "清空当前视图" }, h(Icon, { name: "trash" })),
+						h("button", { type: "button", className: "lc-icobtn", onClick: copyLog, title: "复制过滤后日志" }, h(Icon, { name: "copy" })),
+						h("button", { type: "button", className: "lc-icobtn", onClick: exportLog, title: "导出过滤后日志 .txt" }, h(Icon, { name: "download" })),
 						h("button", {
 							type: "button",
 							className: "lc-icobtn",
 							"data-on": autoScroll ? "" : undefined,
 							title: "新日志自动滚到底部",
 							onClick: () => setAutoScroll(!autoScroll),
-						}, "📌"),
+						}, h(Icon, { name: "pin" })),
 					)
 					: null,
 				tab === "log" || tab === "screen"
 					? h("div", { className: "lc-keys" },
-						[["home", "⌂ Home"], ["back", "← 返回"], ["recents", "▦ 最近"], ["wakeup", "☀ 唤醒"], ["power", "⏻ 电源"], ["volume_up", "🔊+"], ["volume_down", "🔉−"]].map(([key, label]) =>
-							h("button", { key, type: "button", className: "lc-key", title: "发送按键 " + key, onClick: () => sendKey(key) }, label)))
+						[["home", "home", "Home"], ["back", "back", "返回"], ["recents", "grid", "最近"], ["wakeup", "sun", "唤醒"], ["power", "power", "电源"], ["volume_up", "volumeUp", ""], ["volume_down", "volumeDown", ""]].map(([key, icon, label]) =>
+							h("button", { key, type: "button", className: "lc-key", title: "发送按键 " + key, onClick: () => sendKey(key) }, h(Icon, { name: icon, size: 14 }), label)))
 					: null,
 				lastCrash !== null
 					? h("div", { className: "lc-crashbar" },
@@ -1469,7 +1516,7 @@ window.__ModuleLoader__.load({
 					: null,
 				paused && tab === "log" && !eventsOn
 					? h("div", { className: "lc-pausedbar" },
-						h("span", { style: { flex: 1 } }, "⏸ 已暂停 — 新日志缓冲中（" + pendingCount + " 条），列表已冻结"),
+						h("span", { style: { flex: 1 } }, h(Icon, { name: "pause", size: 14 }), "已暂停 — 新日志缓冲中（" + pendingCount + " 条），列表已冻结"),
 						h("button", { type: "button", className: "lc-btn", onClick: togglePause, title: "恢复实时，回放缓冲日志" }, "继续"),
 					)
 					: null,
@@ -1551,11 +1598,11 @@ window.__ModuleLoader__.load({
 									h("input", { placeholder: "输入文字后回车发送…", value: screenText, onChange: (e) => setScreenText(e.target.value), onKeyDown: (e) => { if (e.key === "Enter") sendScreenText(); }, style: { flex: 1, minWidth: 120 } }),
 									h("button", { type: "button", className: "lc-btn", onClick: () => sendKey("wakeup"), title: "唤醒设备屏幕（等效按电源键点亮）" }, "唤醒"),
 									h("button", { type: "button", className: "lc-btn", onClick: downloadScreen, title: "下载当前帧 PNG" }, "下载"),
-									h("button", { type: "button", className: "lc-btn", onClick: toggleScreenFullscreen, title: "全屏查看（Esc 退出）" }, "⛶"),
+									h("button", { type: "button", className: "lc-btn", onClick: toggleScreenFullscreen, title: "全屏查看（Esc 退出）" }, h(Icon, { name: "expand", size: 14 })),
 								),
 								hostVideoCapable === false
 									? h("div", { className: "lc-empty" },
-										h("span", { className: "lc-empty-icon" }, "⚠"),
+										h("span", { className: "lc-empty-icon" }, h(Icon, { name: "crash", size: 26 })),
 										h("span", null, "运行中的 GUI 宿主版本过旧 —— 重启 GUI（dsh web）后刷新，投屏才会生效"))
 									: h("div", {
 										className: "lc-screen-img",
@@ -1575,7 +1622,7 @@ window.__ModuleLoader__.load({
 										ripples.map((r) => h("span", { key: r.id, className: "lc-tap-ripple", style: { left: r.x, top: r.y } })),
 										!screenHasFrame
 											? h("div", { className: "lc-empty" },
-												h("span", { className: "lc-empty-icon" }, "📱"),
+												h("span", { className: "lc-empty-icon" }, h(Icon, { name: "plug", size: 26 })),
 												h("span", null, devices.length === 0 ? "连接设备并开启 USB 调试后自动开始投屏" : "正在建立投屏流…"))
 											: null,
 									),
@@ -1586,11 +1633,11 @@ window.__ModuleLoader__.load({
 								: h(VirtualLog, { entries: filteredEvents, scrollTop, onScrollTop: setScrollTop, bodyRef, keyword, onTagClick: addKeyword, onLineDblClick: copyLine, rowDensity }))
 							: (filtered.length === 0
 								? h("div", { className: "lc-empty" },
-									h("span", { className: "lc-empty-icon" }, paused ? "⏸" : devices.length === 0 ? "🔌" : "📄"),
+									h("span", { className: "lc-empty-icon" }, h(Icon, { name: paused ? "pause" : devices.length === 0 ? "plug" : "file", size: 26 })),
 									h("span", null, paused ? "已暂停（" + entries.length + " 条已缓冲）" : (devices.length === 0 ? "连接设备并开启 USB 调试后自动开始…" : "暂无日志")))
 								: h(VirtualLog, { entries: filtered, scrollTop, onScrollTop: setScrollTop, bodyRef, keyword, onTagClick: addKeyword, onLineDblClick: copyLine, rowDensity })),
 					tab === "log" && !eventsOn && live && !paused
-						? h("button", { type: "button", className: "lc-fab", onClick: togglePause, title: "暂停：冻结当前视图（新日志进入缓冲）" }, "⏸ 暂停")
+						? h("button", { type: "button", className: "lc-fab", onClick: togglePause, title: "暂停：冻结当前视图（新日志进入缓冲）" }, h(Icon, { name: "pause", size: 14 }), "暂停")
 						: null,
 				),
 				crashModal
@@ -1606,7 +1653,7 @@ window.__ModuleLoader__.load({
 									? h("span", null, "暂无崩溃快照")
 									: crashList.map((c) =>
 										h("div", { key: c.id, className: "lc-crash-item", onClick: () => toggleCrashDetail(c.id) },
-											h("div", { className: "t" }, c.ts + "  [" + c.kind + "]" + (c.hasScreenshot ? "  📷" : "")),
+											h("div", { className: "t" }, c.ts + "  [" + c.kind + "]", c.hasScreenshot ? h(Icon, { name: "camera", size: 12 }) : null),
 											h("div", { className: "s" }, c.summary),
 											crashOpenId === c.id && crashDetail !== null
 												? h("div", { className: "lc-crash-detail" },
@@ -1983,6 +2030,91 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		//#region entry
+		//#region icons
+		/**
+		 * Minimal geometric glyphs on one 24px grid, stroked with currentColor —
+		 * deliberately dependency-free (the client bundle may only require shell
+		 * seeds), so the panel ships its own small, consistent icon set instead of
+		 * emoji or an external icon package.
+		 */
+		const ICONS = {
+			camera: '<path d="M4 8.8h3.2L8.7 6.4h6.6l1.5 2.4H20v9.2H4z"/><circle cx="12" cy="13" r="3.1"/>',
+			history: '<path d="M4.4 12a7.6 7.6 0 1 1 2.2 5.4"/><path d="M4 4.6v3.2h3.2"/><path d="M12 8.4V12l2.6 1.8"/>',
+			events: '<path d="M4 6.5h16M4 12h16M4 17.5h10"/>',
+			crash: '<path d="M12 4 20.5 19H3.5z"/><path d="M12 9.5v4.2"/><path d="M12 16.6h.01"/>',
+			wifi: '<path d="M4 9.2a12 12 0 0 1 16 0"/><path d="M7 12.6a8 8 0 0 1 10 0"/><path d="M10 16a4 4 0 0 1 4 0"/><path d="M12 19h.01"/>',
+			package: '<path d="M12 3.4 20 7.8v8.4L12 20.6 4 16.2V7.8z"/><path d="M4 7.8 12 12l8-4.2"/><path d="M12 12v8.6"/>',
+			pause: '<path d="M9.2 6v12M14.8 6v12"/>',
+			play: '<path d="M8.4 5.4 18.6 12 8.4 18.6z"/>',
+			trash: '<path d="M5 7h14"/><path d="M10 7V5h4v2"/><path d="M6.6 7l1 13h8.8l1-13"/><path d="M10.5 10.5v6M13.5 10.5v6"/>',
+			copy: '<rect x="9" y="9" width="11" height="11" rx="2"/><path d="M15 5.5H5.5V15"/>',
+			download: '<path d="M12 4v11"/><path d="M7.6 10.8 12 15.2l4.4-4.4"/><path d="M5 19h14"/>',
+			pin: '<path d="M12 3.6c2.9 0 4.8 2 4.8 4.4 0 2.9-2.4 4.8-3.4 7.6h-2.8C9.6 12.8 7.2 10.9 7.2 8 7.2 5.6 9.1 3.6 12 3.6z"/><path d="M12 15.6V20.4"/>',
+			expand: '<path d="M9.5 4.5H4.5v5"/><path d="M14.5 4.5h5v5"/><path d="M14.5 19.5h5v-5"/><path d="M9.5 19.5h-5v-5"/>',
+			home: '<path d="M4.5 11 12 4.6 19.5 11v8.4h-15z"/><path d="M10 19.4v-4.6h4v4.6"/>',
+			back: '<path d="M14.6 5.6 8.2 12l6.4 6.4"/>',
+			grid: '<rect x="4.5" y="4.5" width="6" height="6" rx="1.4"/><rect x="13.5" y="4.5" width="6" height="6" rx="1.4"/><rect x="4.5" y="13.5" width="6" height="6" rx="1.4"/><rect x="13.5" y="13.5" width="6" height="6" rx="1.4"/>',
+			sun: '<circle cx="12" cy="12" r="4"/><path d="M12 3.4v2.2M12 18.4v2.2M4.6 12H6.8M17.2 12h2.2M6.8 6.8l1.6 1.6M15.6 15.6l1.6 1.6M17.2 6.8l-1.6 1.6M8.4 15.6l-1.6 1.6"/>',
+			power: '<path d="M12 4v8"/><path d="M7.6 7.2a7 7 0 1 0 8.8 0"/>',
+			volumeUp: '<path d="M4.5 9.8h3l4-3v10.4l-4-3h-3z"/><path d="M15 9.6a3.6 3.6 0 0 1 0 4.8"/><path d="M17.6 7.6a6.8 6.8 0 0 1 0 8.8"/>',
+			volumeDown: '<path d="M4.5 9.8h3l4-3v10.4l-4-3h-3z"/><path d="M15 10.4a3 3 0 0 1 0 3.2"/>',
+			plug: '<path d="M9.5 3.6v4.8M14.5 3.6v4.8"/><path d="M6.4 8.4h11.2v2.6a5.6 5.6 0 0 1-11.2 0z"/><path d="M12 16.6v3.8"/>',
+			file: '<path d="M6.6 3.6h7.2l4 4v12.8H6.6z"/><path d="M13.8 3.6v4h4"/><path d="M9.4 12.4h5.2M9.4 15.6h5.2"/>',
+			close: '<path d="M6.4 6.4 17.6 17.6M17.6 6.4 6.4 17.6"/>',
+			search: '<circle cx="11" cy="11" r="5.6"/><path d="M15.2 15.2 19.4 19.4"/>',
+		};
+
+		/** One glyph from the set above, at the requested square edge. */
+		function Icon({ name, size = 16 }) {
+			const body = ICONS[name];
+			if (body === undefined) return null;
+			return h("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 24 24",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 1.7,
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": true,
+				dangerouslySetInnerHTML: { __html: body },
+			});
+		}
+		//#endregion
+
+		//#region dsh 0.2 native integration
+		/** The glyph the left sidebar shows for this panel. */
+		function SidebarLogcatIcon({ size = 16 }) {
+			return h(Icon, { name: "file", size: size ?? 16 });
+		}
+
+		/**
+		 * Register the panel as a first-class 0.2 surface: the central `main` panel
+		 * (selected by the sidebar entry id) plus its `sidebar.panellist` row.
+		 * @returns whether the host accepted the native seats synchronously — when
+		 * it did, the legacy drawer is not mounted at all.
+		 */
+		function registerNative(ctx, makePanel) {
+			if (ctx?.slots === undefined || typeof ctx.slots.inject !== "function") return false;
+			let active = false;
+			try {
+				ctx.slots.inject("main", () => {
+					active = true;
+					return ctx.slots.register({ name: "main", key: "logcat" }, makePanel);
+				});
+				ctx.slots.inject("sidebar.panellist", () => ctx.slots.register(
+					{ name: "sidebar.panellist", id: "logcat", order: 100, label: "Logcat" },
+					SidebarLogcatIcon,
+				));
+			} catch (error) {
+				console.warn("[dsh-logcat] native slot registration unavailable:", error);
+				return false;
+			}
+			return active;
+		}
+		//#endregion
+
 		/** Required services (fiber inject waiting — the runtime must be up first). */
 		const inject = ["slots"];
 
@@ -2003,16 +2135,23 @@ window.__ModuleLoader__.load({
 			styleGuard.observe(document.head, { childList: true });
 
 			const controller = new PanelController();
-			const disposers = [];
-			try {
-				disposers.push(mountSidebarEntry(controller));
-				disposers.push(mountPanel(controller));
-			} catch (error) {
-				console.warn("[dsh-logcat] mount failed:", error);
-			}
+			const legacy = [];
+			const mountLegacy = () => {
+				try {
+					legacy.push(mountSidebarEntry(controller));
+					legacy.push(mountPanel(controller));
+				} catch (error) {
+					console.warn("[dsh-logcat] legacy mount failed:", error);
+				}
+			};
+			// dsh 0.2 exposes `main` + `sidebar.panellist`: the panel becomes a native
+			// central surface with its own sidebar row. Clients that do not offer those
+			// seats keep the self-healing sidebar entry and the right-hand drawer.
+			const native = registerNative(ctx, () => h(LogcatPanel, { controller, embedded: true }));
+			if (!native) mountLegacy();
 			ctx.effect(() => () => {
 				styleGuard.disconnect();
-				for (const dispose of disposers.splice(0)) dispose();
+				for (const dispose of legacy.splice(0)) dispose();
 				style.remove();
 			}, "dsh-logcat: ui mounts");
 		}

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.7.0",
+  "version": "0.8.0",
   "type": "module",
   "packageManager": "pnpm@11.22.0",
   "engines": {
@@ -22,9 +22,7 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime"
-      ],
+      "inject": [],
       "platform": "web"
     }
   },