hdwx-dsh-frontend-coms

DSH 前端辅助插件：编写前端页面时优先使用 hdwx-base-coms 组件库。为模型提供一组 hdwx.* 工具，覆盖"组件/配置查询 → 页面/片段生成 → 选型方案 → 合规自检"的前端开发闭环，并默认按"项目已全局注入 WxPlus"的写法输出可运行代码。

功能

| 工具 | 作用 | | --- | --- | | hdwx.catalog | 查询 hdwx-base-coms 组件清单、配置类型(XxxType)、表单项元素(ElementTypes)、接入约定 | | hdwx.page | 按 HDWX 低代码范式生成页面（默认 BaseList 整页：搜索/按钮/表格/分页/详情表单/API 编排一条龙） | | hdwx.snippet | 生成组件片段（表单项 / 按钮组 / 弹窗壳 / 表格列） | | hdwx.scheme | 需求 → 组件选型方案（hdwx 优先，HDWX 未覆盖落 Element Plus 并注释） | | hdwx.review | 代码"hdwx 优先"合规自检，返回 ✅/⚠️/❌ 结论与修改建议 |

说明

• 组件库规格（manifest）内置在 lib/manifest.js，来源于 hdwx-base-coms 官方文档与源码类型。
• 默认生成风格 injectStyle=global：假设业务项目已 app.use(WxPlus, { $request, $download }) 全局注入，模板不重复 import 组件、api 走全局 $request。
• 每次工具调用都会出现在 DSH 会话轨迹卡片中（调用参数 / 结果 / 失败状态）。

安装

任何一台机器上（任意 DSH 环境的主机），在 该环境对应的 web profile 目录 下执行：

cd ~/.dsh/profiles/web
dsh plugin --profile web add hdwx-dsh-frontend-coms

该插件已作为正式 npm 包发布，团队成员无需知道源码路径，直接按包名安装即可。重启 DSH 后生效。

本地开发调试（改动源码时）

在插件仓库目录直接以本地路径 link 安装，便于改源码即生效：

cd ~/.dsh/profiles/web
dsh plugin --profile web add D:\renlin\AI\plugin+tool\plugin\hdwx-dsh-frontend-coms

发布新版本（仅维护者，需 hdwx-dsh-frontend-coms 包名发布权限）

cd hdwx-dsh-frontend-coms
npm login                 # 首次
npm run verify            # 结构验证
npm pack --dry-run        # 确认发布内容仅含 lib / cordis.patch.yml / README.md
npm publish
# 或直接：npm run publish   （脚本会先跑验证并检查登录态）

发布后，团队即可 dsh plugin --profile web add hdwx-dsh-frontend-coms 安装最新版。

验证

cd hdwx-dsh-frontend-coms
node scripts/verify.mjs        # 结构验证
node scripts/verify.mjs --full # 结构 + 功能验证

使用

直接用自然语言对话，例如：

用 hdwx 生成一个用户列表页，搜索条件：姓名、性别；表格列：姓名/年龄/性别/手机号；操作：新增/编辑/删除；接口 /api/user/list（get）、/api/user/add（post）。

模型会自动调用 hdwx.page 生成 BaseList 整页。详见《使用说明》文档。

开发

• lib/ 为可运行 ESM 源码（无需构建步骤）。
• 组件库升级时只更新 lib/manifest.js 的规格数据。
• 工具与 manifest 均可在 scripts/verify.mjs --full 下独立验证。