dsh-api-runner 0.2.0 → 0.2.1

package/README.md

@@ -44,7 +44,7 @@ DSH 插件：把「后端接口清单」「本地服务启停」「日志增量
 dsh plugin --profile web add dsh-api-runner
 ```
 
-npm 上已发布 `dsh-api-runner@0.2.0`，这条是推荐路径，也是 DSH「插件中心」里一键安装的形式。
+npm 上已发布 `dsh-api-runner@0.2.1`，这条是推荐路径，也是 DSH「插件中心」里一键安装的形式。
 
 ### 从 GitHub 源码安装
 
@@ -67,6 +67,16 @@ DSH 会把仓库 clone 到 profile 的 `node_modules` 下。写成带包名的
 
 配置文件、面板数据、已保存的服务配方、日志目录都沿用原路径，升级不需要迁移。
 
+### 从 0.2.0 升级
+
+0.2.1 修了三个面板数据问题，**同样需要硬刷新页面**：
+
+1. **示例参数能回显了**。以前填完保存，再点「编辑」输入框一定是空的（面板只存了解析后的对象，没存原文，回显时又只读原文）。
+2. **保存不再丢 query**。以前面板接口按 id 整体覆盖，只要点一次「保存」，YAML 里配的 `query` 就被抹掉。现在表单里没有的字段会沿用原值。
+3. **新增 query 编辑栏**。以前只能把 `?a=b` 塞进「路径」输入框，但没人会想到这么做。现在有独立的 query（JSON）栏，支持 `{占位}`，清空即删除。
+
+数据本身不用迁移：之前被抹掉的 `query` 需要你重新填一次（或从 YAML 恢复）。
+
 ### 本地开发：link 安装
 
 ```bash
@@ -245,7 +255,9 @@ flowchart LR
 - 每条接口显示方法徽章、名称、地址（host 弱化、路径强化）、来源徽章（`YAML` = 来自配置文件，无徽章 = 面板新建）、占位参数列表。
 - 行内操作：「测试」（用示例参数调用一次）、「登录并保存」（仅登录接口）、复制地址、清除 token、编辑、删除（只允许删面板自己建的）。
 - 调用结果是一张卡片：状态码、耗时、响应大小，可在「响应 / 响应头 / 请求」之间切换，带复制与关闭。
-- **编辑表单**：id / 名称 / 方法 / URL / baseUrl / 说明 / 请求头（JSON）/ body（JSON）/ 示例参数（JSON）/ 用哪个 token；勾「是登录接口」后展开 tokenPath（如 `data.token`）、注入头（默认 `Authorization`）、前缀（默认 `Bearer `）。
+- **编辑表单**：id / 名称 / 方法 / 路径 / baseUrl / 说明 / **query（JSON）** / 请求头（JSON）/ body（JSON）/ 示例参数（JSON）/ 用哪个 token；勾「是登录接口」后展开 tokenPath（如 `data.token`）、注入头（默认 `Authorization`）、前缀（默认 `Bearer `）。
+  - **query 单独一栏**，别把 `?a=b` 塞进「路径」。query 支持 `{占位}`，如 `{"matterCd":"{matterCd}"}`，调用时按参数展开；只写在 query 里的占位符也会出现在下方的「占位参数」提示行。
+  - 面板保存时，表单里没有的字段（如 YAML 里的 `query`）会沿用原值，不会被抹掉。
 
 **服务页签**
 - 每 5 秒刷新。服务页顶部还有一排**二级页签**（**已接管** / **运行中** / **已保存** / **已忽略**）。这一排样式和顶部「接口 / 服务 / 设置」不同：没有灰底容器，选中项是品牌色实心块，用来区分"页面级"和"分组级"两层导航。一次只看一组，不再纵向堆四块。

package/client/client.js

@@ -326,7 +326,7 @@ window.__ModuleLoader__.load({
         function emptyForm(baseUrl) {
             return {
                 id: '', name: '', method: 'GET', url: '', baseUrl: baseUrl || '', description: '',
-                headersText: '', bodyText: '', sampleText: '', useToken: '',
+                headersText: '', queryText: '', bodyText: '', sampleText: '', useToken: '',
                 isLogin: false, tokenPath: 'token', authHeader: 'Authorization', prefix: 'Bearer ',
                 timeoutMs: 30000,
             };
@@ -341,6 +341,7 @@ window.__ModuleLoader__.load({
                 baseUrl: api.baseUrl || '',
                 description: api.description || '',
                 headersText: api.headersText || '',
+                queryText: api.queryText || '',
                 bodyText: api.bodyText || '',
                 sampleText: api.sampleText || '',
                 useToken: api.useToken || '',
@@ -372,6 +373,9 @@ window.__ModuleLoader__.load({
                 else if (value && typeof value === 'object') Object.values(value).forEach(scan);
             };
             scan(api.url);
+            // query 里的占位符也要算：只写在 query 里的键，提示行不显示的话用户会以为漏了
+            scan(api.queryText);
+            if (api.query && typeof api.query === 'object') scan(api.query);
             scan(api.bodyText);
             return [...out];
         }
@@ -471,9 +475,15 @@ window.__ModuleLoader__.load({
                 h(Field, { label: '名称' }, h('input', { className: 'ar-in', value: value.name, placeholder: '显示名，留空则用 id', onChange: (e) => set('name', e.target.value) })),
                 h(Field, { label: '方法' }, h('select', { className: 'ar-sel', value: value.method, onChange: (e) => set('method', e.target.value) },
                     METHODS.map((m) => h('option', { key: m, value: m }, m)))),
-                h(Field, { label: '路径' }, h('input', { className: 'ar-in', value: value.url, placeholder: '/auth/login 或完整地址，支持 {id}', onChange: (e) => set('url', e.target.value) })),
+                h(Field, { label: '路径' }, h('input', { className: 'ar-in', value: value.url, placeholder: '/system/library/matter/billList，支持 {id}', onChange: (e) => set('url', e.target.value) })),
                 h(Field, { label: 'baseUrl' }, h('input', { className: 'ar-in', value: value.baseUrl, placeholder: '留空则用「设置」里的 baseUrl', onChange: (e) => set('baseUrl', e.target.value) })),
                 h(Field, { label: '说明' }, h('input', { className: 'ar-in', value: value.description, onChange: (e) => set('description', e.target.value) })),
+                h(Field, { label: 'query', top: true }, h('textarea', {
+                    className: 'ar-ta',
+                    value: value.queryText,
+                    placeholder: '查询参数（JSON），如 {"matterCd":"{matterCd}"}；不用把 ?a=b 写进「路径」',
+                    onChange: (e) => set('queryText', e.target.value),
+                })),
                 h(Field, { label: '请求头', top: true }, h('textarea', { className: 'ar-ta', value: value.headersText, placeholder: '{"X-Token":"${DEMO_TOKEN}"}', onChange: (e) => set('headersText', e.target.value) })),
                 h(Field, { label: 'body', top: true }, h('textarea', { className: 'ar-ta', value: value.bodyText, placeholder: '{"username":"{user}","password":"{pwd}"}', onChange: (e) => set('bodyText', e.target.value) })),
                 h(Field, { label: '示例参数', top: true }, h('textarea', { className: 'ar-ta', value: value.sampleText, placeholder: '「测试」按钮用它填 {占位}，如 {"user":"alice"}', onChange: (e) => set('sampleText', e.target.value) })),
@@ -1003,6 +1013,12 @@ window.__ModuleLoader__.load({
                         baseUrl: value.baseUrl.trim(),
                         description: value.description.trim(),
                         headers: parseJsonField(value.headersText, '请求头') || {},
+                        /**
+                         * query / sampleParams 用 `|| {}` 兜底：表单里清空时 parseJsonField 返回
+                         * undefined，这里显式给 {}，表示「用户明确清空了」，后端才会覆盖旧值；
+                         * 若传 undefined 会被当成「本次没提交」，旧值又会被沿用回来。
+                         */
+                        query: parseJsonField(value.queryText, 'query') || {},
                         body: parseJsonField(value.bodyText, 'body'),
                         sampleParams: parseJsonField(value.sampleText, '示例参数') || {},
                         useToken: value.useToken,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-api-runner",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "DSH 插件：按配置调用后端 HTTP 接口、启停/重启本地开发服务、增量读取日志并等待日志特征，让模型能\"改完自己验\"。",
   "type": "module",
   "license": "MIT",