v0.6.1

v0.6.1 — 鸿蒙开发面板 + 设备记忆 + Tier-1 扩容

DSH 社区鸿蒙开发助手：面板升级为「鸿蒙开发面板」——展示整个插件而非仅是 hdc；设备跨工具记忆；离线知识层扩至 23 篇。

新增 / Highlights

• 设备会话抽象：工具默认使用本会话上次使用的设备（显式 target 或面板点选即切换默认；掉线静默回退首台连接设备）；hdc_list_targets 暴露 preferred/preferredActive
• 鸿蒙开发面板（原 hdc 设备面板更名升级）：
  • 「本地工具链」徽章行：DevEco Studio 版本 / SDK API / devecocli 有无 / 离线知识篇数——插件自身状态一目了然
  • 设备详情（每台）：名称/品牌/型号/API 版本/电池（电量、温度、充电状态）/OS 版本
  • 系统区：内存可用 / 存储使用率 / 分辨率 / OS 版本
  • 每设备独立「截图」按钮（截哪台标哪台：截图 @ 设备id），顶部截图按钮=截默认设备
  • 日志区：设备端限行（hilog -x | tail -n 60，修复真机 1.2MB 全量日志冲爆缓冲导致面板无日志的问题）
  • 交互：标题栏拖动 / 八向缩放 / 截图 × 关闭 / 设备行点选设默认（高亮 + 默认徽章）
• Tier-1 知识层扩容（20 → 23 篇）：新增 UIAbilityContext（全文）、sensor（461KB→35KB 节选）、file-fs（267KB→104KB 节选）；构建器新增通用按节选入机制（sections.include，= 前缀精确匹配），节选文件附文件内节选声明（CC-BY 修改声明合规），index 记录 excerpted/originalBytes/keptSections
• 官方测试框架指路：harmonyos-knowledge 技能新增 hypium（gitee.com/openharmony/testfwk_arkxtest，@ohos/hypium）与 hamock（同仓库 hamock/ 子目录，@ohos/hamock）指路——canonical 在 ohpm/Gitee，不在 GitHub

实测 / Verified

• 全新进程回归：19 工具 + 3 技能注册、设备记忆五场景（回退→显式→记忆→掉线回退→字段）、知识层 catalog 23/read 节导航/search，全 PASS
• 真机+模拟器双设备宿主集成测试：工具链徽章（Studio 6.1.1.290/SDK 24/知识 23）、设备详情（含电池 27% 充电中/100%）、系统区（内存/存储/分辨率 2800×1840）、hilog 12 行、定向截图（target 正确）、select/preferred 持久、非法 target 400，全 PASS
• live 服务器端到端：panel-state/select/截图 JPEG/list_targets 字段/日志恢复，全 PASS
• license-check PASS（含逐文件 sha256 完整性）；npm pack 41 文件

环境要求 / Requirements

同 v0.6.0（面板仅 web 宿主生效；headless/TUI 不变）。

安装 / Install

dsh plugin --profile <name> add dsh-hdc-bridge

v0.6.0

v0.6.0 — 设备面板（右上角浮动面板 + 挂载 toast）

DSH 社区鸿蒙开发助手：右上角常驻设备面板——挂载即见，免问模型。

新增 / Highlights

• 双面插件形态：包内新增浏览器半边（dsh.client manifest + ./client 导出，手写 __ModuleLoader__ 工厂格式，零构建步骤、零注入依赖），host 半边注册 /api2/hdc-bridge/* 只读 REST（/api 通道为 Typert 专属，沿用 dsh-web-plugin-manager 的 /api2 社区约定）
• 浮动设备面板：已连接设备列表（id/状态/型号/API 版本徽章）、一键截图缩略（真机 snapshot_display，可 × 关闭）、hilog 尾部、连接指引与错误行
• 窗口化交互：标题栏任意拖动；八向缩放（四条边 + 四个角，对应方向光标，最小 240×160，西/北向联动平移）；日志区在手动调高后自动充满剩余空间；面板可收起
• 挂载 toast：client 半边装载时右上角提示「dsh-hdc-bridge 设备面板已挂载」
• 健壮的数据通道：面板直接 spawn 本机 hdc（固定只读命令集、无用户输入，对齐 dsh-web-plugin-manager 直接跑 pnpm 的社区惯例），每条命令硬超时 + 45s 看门狗 + 全程 try/catch——任何情况下路由必答，绝不挂住浏览器；设备信息 30s / 状态 8s TTL + 单飞刷新；截图请求不再并入普通刷新
• 零打扰降级：headless/CLI 宿主无 webServer 服务，ctx.inject(['webServer']) 永不触发，面板整条链路自动跳过（19 工具行为不变）
• 顺带修复：hvigor 回退构建此前在会话工作区执行（项目不在会话工作区时 hvigor-config 找不到）→ 显式进入 projectPath 再构建；.hvigor 构建残留加入 .gitignore

实测 / Verified

• 冒烟（全新 node 进程，fake ctx）：无 webServer → 面板跳过且 19 工具不变；有 webServer → 3 路由注册、panel-state 返回设备/型号/API/hilog，全部 PASS
• scratch web 实例端到端：boot manifest 收录 client 条目、/plugins/dsh-hdc-bridge/client.js 伺服、/api2 路由结构化响应
• 真机场景（模拟器实测）：设备列表/型号/API 23/hilog/截图 113KB JPEG 全通；并发截图场景 PASS；构建→装包→启动→UI 验证闭环（含 9568332 错误码诊断）
• license-check PASS（8 notices 含 sha256 完整性）；npm pack 38 文件 221KB 压缩 / 1.4MB 解压

环境要求 / Requirements

• 面板仅在 web 宿主生效；headless/TUI 不变
• 其余要求同 v0.5.0

安装 / Install

dsh plugin --profile <name> add dsh-hdc-bridge

v0.5.0

v0.5.0 — Tier-1 离线随包官方知识层 hms_knowledge

DSH 社区鸿蒙开发助手：新增离线随包的官方知识节选层——无 SDK、无 CLI、无网络，也能秒查高频 API 的人读官方文档。

新增 / Highlights

• hms_knowledge 工具（共 19 个工具：12 个 hdc 设备工具 + 7 个 hms_ 工具）*
  • catalog：列出 20 个内置主题（模块/指南分类、起始 API 版本、标签、逐文件溯源 URL）
  • read：先目录后小节——按 ## 标题导航，按小节名或序号读指定小节（每节 24K 字符封顶，防爆上下文）
  • search：关键词同时匹配主题与章节标题，返回得分与命中标题
  • 离线可用：无需 DevEco Studio / SDK / devecocli / 网络；每次结果都带 CC-BY-4.0 署名
• Tier-1 知识数据（约 1.2MB 随包内置）
  • 20 个高频主题逐字节选：16 个 API 模块（promptAction / router / notificationManager / vibrator / batteryInfo / deviceInfo / http / webSocket / preferences / emitter / process / url / util / UIAbility / abilityAccessCtrl / Context）+ 4 个应用模型与 ArkTS 指南（UIAbility 生命周期与用法、状态管理概述、创建自定义组件）
  • 来源：gitee.com/openharmony/docs master（commit b8477987，CC-BY-4.0）；knowledge/index.json 记录逐文件 sourceUrl / sha256 / since / tags，可审计可重放
• 许可合规闭环
  • notices.json + THIRD_PARTY_NOTICES.md 新增 openharmony-docs-tier1 条目（现 8 notices）
  • license-check 门禁扩展：knowledge/ 的 meta.json 校验 + 逐文件 sha256 完整性校验 + 版权行搜索覆盖 lib/ 全域
  • scripts/build-knowledge.mjs 维护者工具：一键重新拉取并刷新知识层（记录上游 commit）
• 技能升级：harmonyos-knowledge 技能新增查询速查——人读文档先 hms_knowledge（离线秒回）→ 机读版本判定 hms_api → 全量库 hms_docs

实测 / Verified

• 冒烟：19 工具 + 3 技能注册；catalog / read（目录→小节）/ search 全动作离线 PASS
• 真实 E2E（dsh --profile hdctest 无头实例，会话日志逐条核验 tool/call 与 tool/result）：
  • catalog 任务：模型正确汇报 20 主题，并推出最早起始 API 6 主题（batteryInfo / deviceInfo / http，并列 webSocket）
  • read/search 任务：目录 → 按小节读 showToast / ShowToastOptions → 搜索“振动”命中 vibrator；模型正确回答起始 API 9、message 必填，并主动带出 showToast 自 API 18 废弃 + 逐字引用与 CC-BY 署名
• license-check PASS（8 notices，含 sha256 完整性）；npm pack 36 文件，压缩 212KB / 解压 1.4MB

环境要求 / Requirements

• hms_knowledge 零环境依赖（离线随包）
• 其余 hdc / hms_* 工具环境要求同 v0.4.0（本机 hdc；@deveco/deveco-cli 作为 optionalDependency 随装，失败容忍）

安装 / Install

dsh plugin --profile <name> add dsh-hdc-bridge

v0.4.0 官方工具链 + 版本化知识层

v0.4.0 — 官方工具链通道 + 官方优先版本化知识层

DSH 社区鸿蒙开发助手大版本：把华为官方 DevEco CLI 接为构建/签名/lint/文档通道，并用本机 SDK .d.ts 建立按 API 版本分类的知识层。

新增 / Highlights

• 18 个工具（12 个 hdc 设备工具 + 6 个 hms_* 工具）
  • hms_setup：环境体检 —— hdc / DevEco Studio / SDK / devecocli / 设备五项 + 目标 API 版本三源解析（项目→设备→SDK）与不一致告警
  • hms_build：官方构建/签名/运行通道（devecocli，含 auth 引导）；CLI 缺失时自动回退本机 hvigorw + hdc 装包启动闭环
  • hms_api：官方优先版本化 API 知识 —— 解析本机 SDK .d.ts（@since/@deprecated/@syscap），按目标 API 版本分类可用/已废弃/不可用
  • hms_docs：官方本地文档检索（开发指南 / API参考 / 最佳实践 / FAQ / 版本说明 / 变更预告）
  • hms_api_change：官方跨版本破坏性 API 变更扫描（devecocli check compat）
  • hms_lint：官方 lint —— 57+ 条本机 codelinter 规则速查 + devecocli check lint
• 3 个运行时技能：hdc-bridge（设备闭环）、deveco-cli（官方 SKILL.md 改写，MIT 声明保留）、harmonyos-knowledge（官方优先 / 版本纪律 / 许可纪律）
• 依赖随装：@deveco/deveco-cli（MIT）作为 optionalDependency 随插件自动安装，失败容忍
• 许可合规：THIRD_PARTY_NOTICES.md + license-check 门禁；SDK .d.ts 与 codelinter 规则仅本机读取、零再分发

实测 / Verified

真实 dsh plugin 安装 + 无头 DSH 实例逐工具 E2E：

• 设备闭环（真机 API 24 + 模拟器 API 23）回归通过
• 官方 lint 实测 62 文件 178 条检查
• 真实 devecocli 构建 BUILD SUCCESSFUL（含签名）
• 测试中发现并修复 4 个实际问题：PowerShell 调用符、Studio 路径注入、技能 source 字段、devecocli 退出码不可靠

环境要求 / Requirements

• 设备工具：本机 hdc（DevEco Studio 自带，或 PATH 可用）
• devecocli 构建/签名/lint：DevEco Studio ≥ 6.1.0（macOS/Windows、Node ≥ 18）；签名需一次人工 devecocli auth login（浏览器 OAuth）
• hms_api_change（check compat）需更高版本 DevEco Studio（实测 ≥ 26.0.0），版本不足时工具返回官方错误与升级指引
• build/run/sign 官方标注 [Outside sandbox]，受限沙箱会话需放宽策略或人工执行

安装 / Install

dsh plugin --profile <name> add dsh-hdc-bridge

v0.3.0

Full Changelog: v0.2.0...v0.3.0

v0.2.0

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Full Changelog: https://github.com/1na-ko/dsh-hdc-bridge/commits/v0.1.0