HDC Shell

鸿蒙设备 Web / 桌面调试工具 · 基于 hdc 的实时日志、命令终端与设备管理

功能特性 · 快速开始 · 桌面客户端 · 配置 HDC · 脚本命令

---

预览

应用图标 · assets/app-icon-final.png

Windows 打包图标 · assets/app-icon.ico

将实际界面截图保存为 docs/preview.png 后，可在本段下方增加：
![界面预览](docs/preview.png)

---

功能特性

模块	说明
设备列表	hdc list targets 轮询，多设备时以当前选中设备为准
实时日志	WebSocket 拉取 hilog，支持筛选、导出、规则化「筛选日志」视图
命令终端	通过 WS 执行 hdc 子命令，支持历史记录
快捷操作	设备信息、前台包名、系统版本、HAP 安装等
文件配置	自定义 hdc.exe 路径；包内默认 hdc-bundle；支持导出 hdc + libusb_shared.dll zip
桌面客户端	Electron 免安装包，固定 http://localhost:9999，配置写入用户数据目录

---

快速开始

环境要求

• Node.js 18+（推荐 LTS）
• Windows 下需可用的 HarmonyOS hdc（或放入 hdc-bundle 目录）

安装与启动

git clone <你的仓库地址> hdc_shell
cd hdc_shell
npm install
npm start

浏览器访问：**http://localhost:9999**（端口见 server.js 中 PORT，默认 9999）。

开发热重载：

npm run dev

---

桌面客户端（Windows）

构建免安装可执行文件：

npm run build:client:portable

产物示例：dist-client/HdcShellClient 1.0.4.exe（版本以 package.json 为准）。

详细说明见仓库内 客户端使用说明.md。

---

配置 HDC

1. 将 hdc.exe 与 libusb_shared.dll 放入项目 hdc-bundle/（与打包资源一致）。
2. 或在页面 「文件配置」 中填写自定义 hdc 绝对路径并保存。
3. 未填写配置时：优先使用 hdc-bundle\hdc.exe，否则回退到系统 PATH 中的 hdc。

---

脚本命令

命令	说明
npm start	启动 Web 服务
npm run dev	nodemon 开发模式
npm run build:exe	使用 pkg 打包 Node 单文件 exe
npm run client:dev	本地运行 Electron 壳
npm run build:client	Windows NSIS 安装包
npm run build:client:portable	Windows 便携版 exe

---

项目结构（简要）

hdc_shell/
├── server.js              # Express + WebSocket + hdc 调用
├── electron.main.js       # Electron 入口（桌面版）
├── public/                # 前端静态资源
├── hdc-bundle/            # 默认 hdc 与 libusb（需自行放入或导出）
├── assets/                # 图标等资源
├── 客户端使用说明.md
└── README.md

---

许可证

请在本仓库根目录自行添加 LICENSE 并在此处更新说明（如 MIT / Apache-2.0 等）。

---

HDC Shell — 让鸿蒙设备调试更简单