dsh-annotator 0.5.4 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/overlay.js CHANGED
@@ -17,7 +17,7 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
17
17
  // document (new-document preload + evaluate on the open page), so a newer build
18
18
  // must be able to take over an older instance instead of leaving its listeners
19
19
  // in charge for the rest of the page's life.
20
- var REV = 12;
20
+ var REV = 19;
21
21
  var HOST_ID = '__dsh-vp-root';
22
22
  if (W.__DSH_VP__ && W.__DSH_VP__.rev === REV) { try { W.__DSH_VP__.reattach(); } catch (e) {} return; }
23
23
  if (W.__DSH_VP__) { try { if (W.__DSH_VP__.dispose) W.__DSH_VP__.dispose(); } catch (e) {} }
@@ -25,12 +25,20 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
25
25
  if (stale && stale.parentNode) { try { stale.parentNode.removeChild(stale); } catch (e) {} }
26
26
 
27
27
  var BINDING = '${BINDING_NAME}';
28
- var state = { version: 3, rev: REV, mode: 'off', seq: 0, count: null, locked: false, target: null, anchor: null, clicks: 0, moves: 0, guarded: 0, restored: 0 };
28
+ // role/refLabel/specs 由 host 推送。role 现在是「落点」——下一处标注会进哪一栏——
29
+ // 而不是页面身份:同一页既可以是改动对象,也可以是参照来源,所以 HUD 只按落点换口径,
30
+ // 否则用户在参照落点上说「怎么改」,agent 会去改只读的那一页。
31
+ var state = { version: 4, rev: REV, mode: 'off', seq: 0, count: null, locked: false, target: null, anchor: null, clicks: 0, moves: 0, guarded: 0, restored: 0, role: 'target', landing: '', refLabel: '', specs: [], spec: [], hinted: false, targetCount: 0, referenceCount: 0, prompt: '' };
29
32
  var nodes = {};
30
33
  // macOS 的 Option 是组合键:按 Option+A 产出的是 å 而非 a,快捷键判定要按物理键
31
34
  // code=KeyA,提示文案也要按平台区分(⌥Option+A / Alt+A)。
32
35
  var MAC = /Mac|iPhone|iPad/i.test(navigator.platform || navigator.userAgent || '');
33
- var HOTKEY = MAC ? '⌥ A' : 'Alt A';
36
+ var HOTKEY = MAC ? '⌥ A' : 'Alt+A';
37
+ // 落点开关的键位:⌥A 管「标不标」,⌥R 管「这一处进哪一栏」——两个动作分开按,
38
+ // 不用回面板再点一次按钮。
39
+ var HOTKEY_R = MAC ? '⌥ R' : 'Alt+R';
40
+ // 复制提示词:把整份「改动↔参照」提示词放进剪贴板,粘到别的 agent 里就能用。
41
+ var HOTKEY_C = MAC ? '⌥ C' : 'Alt+C';
34
42
  var bound = [];
35
43
  var lastFocused = null;
36
44
  var hlTimer = 0;
@@ -161,6 +169,13 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
161
169
  host.setAttribute('data-dsh-visual-annotator', '1');
162
170
  host.style.cssText = 'position:fixed;left:0;top:0;width:0;height:0;z-index:2147483647;pointer-events:none;';
163
171
  var shadow = host.attachShadow({ mode: 'open' });
172
+ // 展开的控制台与折叠的胶囊各要一份落点开关:两边语义完全一致(同一组 data-slot、
173
+ // 同一个 title),复制两份迟早漏改一边,合成一段标记两次复用。
174
+ var segMarkup =
175
+ '<span class="seg" role="group" aria-label="下一处标注进哪一栏">' +
176
+ '<button class="seg-b t" type="button" data-slot="target" title="下一处标进「改动」栏(' + HOTKEY_R + ' 切换)">改动</button>' +
177
+ '<button class="seg-b r" type="button" data-slot="reference" title="下一处标进「参照」栏(' + HOTKEY_R + ' 切换)">参照</button>' +
178
+ '</span>';
164
179
  shadow.innerHTML = [
165
180
  '<style>',
166
181
  ':host{--vp-acc:#ff7a45;--vp-acc-warm:#ffb08a;--vp-fg:#f6efe7;--vp-line:rgba(255,196,160,.16);--vp-ease:cubic-bezier(.16,1,.3,1);--vp-sans:ui-sans-serif,-apple-system,"Segoe UI Variable Text","Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;--vp-mono:ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace}',
@@ -172,27 +187,53 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
172
187
  // 标注中保持高亮:hover 框会被 render() 清掉,用户打字时就看不见自己点的是哪个元素了。
173
188
  '.mark{position:fixed;pointer-events:none;display:none;box-sizing:border-box;border:1.5px solid var(--vp-acc);border-radius:7px;background:rgba(255,122,69,.1);box-shadow:0 0 0 4px rgba(255,122,69,.1)}',
174
189
  '.lbl{position:fixed;pointer-events:none;display:none;max-width:64vw;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font:600 12px/1.35 var(--vp-mono);letter-spacing:.01em;padding:5px 9px;border-radius:8px;color:#ffc9b4;background:#1b1210;border:1px solid rgba(255,122,69,.42);box-shadow:0 8px 20px -8px rgba(0,0,0,.6)}',
175
- '.hud{position:fixed;right:16px;bottom:16px;display:none;font:13px/1.35 var(--vp-sans);color:var(--vp-fg);-webkit-font-smoothing:antialiased}',
176
- '.cluster,.pill{pointer-events:auto;white-space:nowrap;border:1px solid var(--vp-line);background:linear-gradient(180deg,rgba(38,29,24,.94),rgba(22,16,14,.96));-webkit-backdrop-filter:blur(18px) saturate(150%);backdrop-filter:blur(18px) saturate(150%);box-shadow:0 20px 48px -18px rgba(0,0,0,.8),0 1px 0 rgba(255,255,255,.06) inset}',
177
- '.cluster{display:none;align-items:center;gap:9px;padding:7px 7px 7px 14px;border-radius:15px}',
178
- '.cluster .met{display:flex;align-items:center;gap:7px;font-size:12px;color:#c2b5a8;letter-spacing:.01em}',
179
- '.cluster .dot{width:7px;height:7px;border-radius:50%;background:var(--vp-acc);box-shadow:0 0 0 3px rgba(255,122,69,.16)}',
180
- '.cluster .cnt{color:var(--vp-fg);font-weight:650;font-variant-numeric:tabular-nums}',
181
- '.pill{display:none;align-items:center;gap:9px;padding:9px 13px;border-radius:13px;cursor:pointer;transition:transform .16s var(--vp-ease),border-color .16s var(--vp-ease)}',
182
- '.pill:hover{transform:translateY(-1px);border-color:rgba(255,122,69,.5)}',
183
- '.pill .go{font-weight:600;color:var(--vp-fg)}',
184
- '.pill .go::before{content:"";display:inline-block;width:7px;height:7px;margin-right:8px;border-radius:50%;background:var(--vp-acc);box-shadow:0 0 0 3px rgba(255,122,69,.16);vertical-align:1px}',
185
- '.pill .c{margin-left:2px;padding-left:11px;border-left:1px solid rgba(255,255,255,.11);color:#8e8378;font-size:11.5px}',
186
- '.hud .k{font:600 10.5px/1 var(--vp-mono);letter-spacing:.04em;color:#c2b5a8;padding:3px 6px;border-radius:6px;background:rgba(255,255,255,.05);border:1px solid rgba(255,255,255,.14)}',
187
- '.hud button{font:inherit;font-size:12px;font-weight:550;color:#ede3d9;padding:7px 11px;border-radius:9px;background:rgba(255,255,255,.055);border:1px solid rgba(255,255,255,.1);cursor:pointer;transition:background .14s,border-color .14s,transform .14s}',
188
- '.hud button .k{margin-left:6px;background:rgba(0,0,0,.22);border-color:rgba(255,255,255,.12);color:#ffc9b4}',
189
- '.hud button:hover:not(:disabled){background:rgba(255,255,255,.11);border-color:rgba(255,255,255,.2)}',
190
- '.hud button:active:not(:disabled){transform:translateY(1px)}',
191
- '.hud button.pri{color:#1b1108;font-weight:650;background:var(--vp-acc);border-color:transparent;box-shadow:0 8px 18px -10px rgba(255,122,69,.9)}',
192
- '.hud button.pri:hover:not(:disabled){background:#ff8f5f}',
193
- '.hud button.pri .k{background:rgba(0,0,0,.16);border-color:rgba(0,0,0,.14);color:#3a1c0e}',
194
- '.hud button:disabled{opacity:.4;cursor:default}',
195
- '.hud button:focus-visible,.pill:focus-visible{outline:2px solid var(--vp-acc-warm);outline-offset:2px}',
190
+ '.hud{position:fixed;right:16px;bottom:16px;display:none;font:12px/1.4 var(--vp-sans);color:var(--vp-fg);-webkit-font-smoothing:antialiased}',
191
+ '.cluster,.pill{pointer-events:auto;white-space:nowrap;border:1px solid var(--vp-line);background:linear-gradient(180deg,rgba(38,29,24,.94),rgba(22,16,14,.96));-webkit-backdrop-filter:blur(18px) saturate(150%);backdrop-filter:blur(18px) saturate(150%);box-shadow:0 20px 48px -18px rgba(0,0,0,.8),0 1px 0 rgba(255,255,255,.06) inset}',
192
+ // 一排控件共用同一套几何:高 28、圆角 8、左右内距 11。此前 seg 23.5、按钮 29、胶囊件 25~33
193
+ // 三种高度混排,中线对齐后上下各差 2~4px,看起来就是「没对齐」;左内距 14 配右内距 7 也不对称。
194
+ '.cluster{display:none;align-items:center;gap:6px;box-sizing:border-box;height:40px;padding:0 8px 0 6px;border-radius:14px}',
195
+ '.cluster .sep,.pill .sep{flex:none;width:1px;height:16px;margin:0 2px;background:rgba(255,255,255,.1)}',
196
+ // 计数整段当一个基线组:「已标注 / 0 / 处」原来是三个 flex 项,gap 把「0」和「处」拆开,读着像两句话。
197
+ '.cluster .met{display:inline-flex;align-items:center;gap:7px;height:28px;padding:0 2px;font-size:12px;color:#b3a698;letter-spacing:.01em;cursor:default}',
198
+ '.cluster .met .mbody{display:inline-flex;align-items:baseline;gap:4px}',
199
+ '.cluster .dot{flex:none;width:7px;height:7px;border-radius:50%;background:var(--vp-acc);box-shadow:0 0 0 3px rgba(255,122,69,.16)}',
200
+ '.cluster .cnt{color:var(--vp-fg);font-size:12.5px;font-weight:650;font-variant-numeric:tabular-nums}',
201
+ // 落点开关:HUD 里唯一能改变「下一处进哪一栏」的控件。两段式而不是下拉——
202
+ // 只有两个值,一个键位就能翻,多一层菜单只会多一次点击。
203
+ '.seg{display:inline-flex;align-items:center;gap:2px;box-sizing:border-box;height:28px;padding:2px;border-radius:8px;background:rgba(0,0,0,.34);border:1px solid rgba(255,255,255,.1)}',
204
+ '.seg-b{display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box;height:22px;padding:0 9px;font:650 11.5px/1 var(--vp-sans);color:#a99c90;border-radius:6px;background:transparent;border:0;cursor:pointer;transition:background .14s,color .14s}',
205
+ '.seg-b:hover{color:#ede3d9;background:rgba(255,255,255,.08)}',
206
+ '.seg-b.on{color:#1b1108;background:var(--vp-acc)}',
207
+ '.seg-b.on.r{color:#08152b;background:var(--vp-ref)}',
208
+ '.pill{display:none;align-items:center;gap:8px;box-sizing:border-box;height:42px;padding:0 8px 0 6px;border-radius:14px;cursor:default;transition:border-color .16s var(--vp-ease)}',
209
+ // 悬停只提亮描边:整条胶囊跟着上浮时,鼠标停在复制按钮上也像在拖整块 HUD。
210
+ '.pill:hover{border-color:rgba(255,122,69,.38)}',
211
+ '.pill-main{display:inline-flex;align-items:center;gap:8px;height:30px;padding:0 8px 0 6px;border-radius:8px;cursor:pointer;transition:background .14s}',
212
+ '.pill-main:hover{background:rgba(255,255,255,.05)}',
213
+ '.pill .go{font-size:12.5px;font-weight:600;color:var(--vp-fg)}',
214
+ '.pill .go::before{content:"";display:inline-block;width:7px;height:7px;margin-right:7px;border-radius:50%;background:var(--vp-acc);box-shadow:0 0 0 3px rgba(255,122,69,.16);vertical-align:1px}',
215
+ '.pill .c{color:#a99c90;font-size:11.5px;line-height:1;font-variant-numeric:tabular-nums}',
216
+ // 复制提示词:整份「改动 + 参照 + 对照关系」进剪贴板,可以粘到别的 Agent 里执行。
217
+ // 折叠胶囊里也放一个——普通模式下用户不展开 HUD,也要能把已有标注直接拿走。
218
+ '.pill .cp{height:26px;padding:0 9px;font-size:11.5px}',
219
+ // 折叠胶囊也要能换落点:普通模式下不展开 HUD 时,这里就是唯一的开关。
220
+ '.pill .seg{height:26px;padding:2px;border-radius:7px}',
221
+ '.pill .seg-b{height:20px;padding:0 8px;font-size:11px;border-radius:5px}',
222
+ '.hud .k{display:inline-flex;align-items:center;height:18px;padding:0 5px;font:650 10.5px/1 var(--vp-mono);letter-spacing:.04em;color:#c9bcae;border-radius:5px;background:rgba(255,255,255,.06);border:1px solid rgba(255,255,255,.14)}',
223
+ '.hud .cluster>button,.hud .pill>button{display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box;height:28px;padding:0 11px;font:inherit;font-size:12px;font-weight:550;color:#ede3d9;border-radius:8px;background:rgba(255,255,255,.055);border:1px solid rgba(255,255,255,.1);cursor:pointer;transition:background .14s,border-color .14s,transform .14s}',
224
+ '.hud .cluster>button .k,.hud .pill>button .k{margin-left:6px;background:rgba(0,0,0,.22);border-color:rgba(255,255,255,.12);color:#ffc9b4}',
225
+ '.hud .cluster>button:hover:not(:disabled),.hud .pill>button:hover:not(:disabled){background:rgba(255,255,255,.11);border-color:rgba(255,255,255,.2)}',
226
+ '.hud .cluster>button:active:not(:disabled),.hud .pill>button:active:not(:disabled){transform:translateY(1px)}',
227
+ // 次级动作(复制提示词)用透明底:同排只有一个主色,导出入口要能找到但不抢「完成并插入」。
228
+ '.hud .cluster>button.cp,.hud .pill>button.cp{background:transparent;border-color:rgba(255,255,255,.09);color:#c9bcae}',
229
+ '.hud .cluster>button.cp:hover:not(:disabled),.hud .pill>button.cp:hover:not(:disabled){background:rgba(255,255,255,.07);border-color:rgba(255,255,255,.17);color:#f3ebe3}',
230
+ '.hud .cluster>button.pri{padding:0 13px;color:#1b1108;font-weight:650;background:var(--vp-acc);border-color:transparent;box-shadow:0 8px 18px -10px rgba(255,122,69,.9)}',
231
+ '.hud .cluster>button.pri:hover:not(:disabled){background:#ff8f5f}',
232
+ '.hud .cluster>button.pri .k{background:rgba(0,0,0,.16);border-color:rgba(0,0,0,.14);color:#3a1c0e}',
233
+ '.hud .cluster>button:disabled,.hud .pill>button:disabled{opacity:1;cursor:default;color:#8a7f74;background:rgba(255,255,255,.03);border-color:rgba(255,255,255,.06)}',
234
+ // 主按钮禁用时不能靠整体降透明度:橙底乘 0.4 会变成一团发褐的脏色,深色字压在上面也读不出来。
235
+ '.hud .cluster>button.pri:disabled{color:#f0b193;background:rgba(255,122,69,.2);border-color:rgba(255,122,69,.34);box-shadow:none}',
236
+ '.hud .cluster>button:focus-visible,.hud .pill>button:focus-visible,.pill-main:focus-visible,.seg-b:focus-visible{outline:2px solid var(--vp-acc-warm);outline-offset:2px}',
196
237
  // 标注卡固定一套暖墨切面:跟随页面明暗会在深色站点糊成一片,也让卡片失去自己的身份。
197
238
  '.card{position:fixed;pointer-events:auto;display:none;box-sizing:border-box;width:min(364px,calc(100vw - 24px));padding:16px;border-radius:16px;color:var(--vp-fg);font:13.5px/1.55 var(--vp-sans);background:linear-gradient(180deg,#261d18 0%,#191210 100%);border:1px solid var(--vp-line);box-shadow:0 30px 68px -20px rgba(0,0,0,.85),0 2px 10px rgba(0,0,0,.35),0 1px 0 rgba(255,255,255,.07) inset;animation:vpCardIn .18s var(--vp-ease);-webkit-font-smoothing:antialiased}',
198
239
  '@keyframes vpCardIn{from{opacity:0;transform:translateY(7px) scale(.985)}to{opacity:1;transform:none}}',
@@ -224,6 +265,21 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
224
265
  '.card button.cancel:hover{color:var(--vp-fg);background:rgba(255,255,255,.08);border-color:rgba(255,255,255,.16)}',
225
266
  '.card button.pri{padding:0 15px;color:#1b1108;font-weight:650;background:var(--vp-acc);border-color:transparent;box-shadow:0 10px 22px -12px rgba(255,122,69,.95)}',
226
267
  '.card button.pri:hover{background:#ff8f5f}',
268
+ // 参考模式:同一套几何、另一套语义色。蓝色不是装饰——它一眼告诉用户
269
+ // 「这块不会被我改」,和暖橙色的目标标注区分开。
270
+ ':host{--vp-ref:#4b8cf7;--vp-ref-fg:#e8f1ff}',
271
+ '.pill .go.ref::before{background:var(--vp-ref);box-shadow:0 0 0 3px rgba(75,140,247,.18)}',
272
+ '.pill.ref:hover{border-color:rgba(75,140,247,.5)}',
273
+ '.card.ref .idx{color:#cfe1ff;background:rgba(75,140,247,.16);border-color:rgba(75,140,247,.36)}',
274
+ '.card.ref .quote::before{color:rgba(75,140,247,.78)}',
275
+ '.card.ref textarea:focus{border-color:rgba(75,140,247,.55);box-shadow:0 0 0 3px rgba(75,140,247,.15)}',
276
+ '.card.ref button.pri{background:var(--vp-ref);color:#08152b;box-shadow:0 10px 22px -12px rgba(75,140,247,.95)}',
277
+ '.card.ref button.pri:hover{background:#6aa0f9}',
278
+ '.card .dims{display:none;flex-wrap:wrap;gap:6px;margin:0 0 10px}',
279
+ '.card .dims.on{display:flex}',
280
+ '.card .dim-chip{font:12px/1 var(--vp-sans);color:#bccbd8;padding:6px 9px;border-radius:8px;background:rgba(255,255,255,.05);border:1px solid rgba(255,255,255,.1);cursor:pointer;transition:background .14s,color .14s,border-color .14s}',
281
+ '.card .dim-chip:hover{background:rgba(255,255,255,.1)}',
282
+ '.card .dim-chip[aria-pressed="true"]{color:#eaf2ff;background:rgba(75,140,247,.22);border-color:rgba(75,140,247,.5)}',
227
283
  '.card .keys{display:inline-flex;align-items:center;gap:4px;margin-left:9px}',
228
284
  '.card button .k{display:inline-flex;align-items:center;height:20px;padding:0 7px;font:650 12px/1 var(--vp-mono);border-radius:6px;background:rgba(0,0,0,.3);border:1px solid rgba(0,0,0,.22);color:#ffeadd}',
229
285
  '.card button .k.sym{font:600 13px/1 var(--vp-sans);padding:0 6px;letter-spacing:0}',
@@ -236,23 +292,35 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
236
292
  '<div class="mark"></div>',
237
293
  '<div class="lbl"></div>',
238
294
  '<div class="hud">',
239
- '<div class="cluster" role="toolbar" aria-label="标注控制台">',
240
- '<span class="met"><span class="dot"></span>已标注 <b class="cnt">0</b> 处</span>',
241
- '<button class="pause" type="button" title="暂停标注(Esc)">暂停<span class="k">Esc</span></button>',
242
- '<button class="undo" type="button" title="撤销最近一条标注">撤销</button>',
243
- '<button class="pri done" type="button" title="把全部标注插入 DSH 对话">完成并插入</button>',
244
- '</div>',
245
- '<div class="pill" role="button" tabindex="0" aria-label="开启标注模式" title="开启标注模式:点击页面元素即可标注(快捷键 ' + HOTKEY + ')">',
246
- '<span class="go">开启标注</span>',
247
- '<span class="k">' + HOTKEY + '</span>',
248
- '<span class="c">已标注 <b class="pcnt">0</b> 处</span>',
249
- '</div>',
295
+ '<div class="cluster" role="toolbar" aria-label="标注控制台">',
296
+ segMarkup,
297
+ '<span class="met"><span class="dot"></span><span class="mbody"><span class="mtxt">本页标注</span> <b class="cnt">0</b> 处</span></span>',
298
+ '<span class="sep" aria-hidden="true"></span>',
299
+ '<button class="undo" type="button" title="撤销最近一条标注">撤销</button>',
300
+ '<button class="cp" type="button" title="复制全部标注的提示词(' + HOTKEY_C + '),可粘贴到其它 Agent">复制提示词</button>',
301
+ '<span class="sep" aria-hidden="true"></span>',
302
+ '<button class="pause" type="button" title="暂停标注(Esc)">暂停<span class="k">Esc</span></button>',
303
+ '<button class="pri done" type="button" title="把全部标注插入 DSH 对话">完成并插入</button>',
304
+ '</div>',
305
+ // 折叠胶囊不再是单个按钮:里面既有「开启标注」,也有「复制提示词」——
306
+ // 普通模式下用户不展开 HUD 时,这两件事都得能直接做。
307
+ '<div class="pill">',
308
+ '<span class="pill-main" role="button" tabindex="0" aria-label="开启标注模式" title="开启标注模式:点击页面元素即可标注(快捷键 ' + HOTKEY + ')">',
309
+ '<span class="go">开启标注</span>',
310
+ '<span class="k">' + HOTKEY + '</span>',
311
+ '<span class="c"><span class="ctxt">本页标注</span> <b class="pcnt">0</b> 处</span>',
312
+ '</span>',
313
+ '<span class="sep" aria-hidden="true"></span>',
314
+ segMarkup,
315
+ '<button class="cp" type="button" title="复制全部标注的提示词(' + HOTKEY_C + '),可粘贴到其它 Agent">复制提示词</button>',
316
+ '</div>',
250
317
  '</div>',
251
318
  '<div class="note"></div>',
252
319
  '<div class="card" role="dialog" aria-label="页面元素标注">',
253
320
  '<div class="hd"><span class="idx">01</span><span class="tag"></span><span class="dim"></span><button class="copy" type="button" title="复制选择器">复制</button></div>',
254
321
  '<div class="sel"></div>',
255
322
  '<div class="quote"></div>',
323
+ '<div class="dims" role="group" aria-label="参考维度"></div>',
256
324
  '<textarea autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" placeholder="说明怎么改:字号 / 间距 / 颜色 / 文案 / 布局…"></textarea>',
257
325
  '<div class="row"><span class="hint" title="按 Esc 取消这次标注"><span class="k">Esc</span></span><button class="cancel" type="button">取消</button><button class="pri" type="button">添加标注<span class="keys"></span></button></div>',
258
326
  '</div>',
@@ -267,6 +335,15 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
267
335
  nodes.cnt = shadow.querySelector('.cnt');
268
336
  nodes.pill = shadow.querySelector('.pill');
269
337
  nodes.pcnt = shadow.querySelector('.pcnt');
338
+ nodes.met = shadow.querySelector('.cluster .met');
339
+ nodes.mtxt = shadow.querySelector('.mtxt');
340
+ nodes.ctxt = shadow.querySelector('.ctxt');
341
+ nodes.dims = shadow.querySelector('.dims');
342
+ nodes.segB = shadow.querySelectorAll('.seg-b');
343
+ nodes.pillMain = shadow.querySelector('.pill-main');
344
+ nodes.cpBtns = shadow.querySelectorAll('button.cp');
345
+ nodes.pillGo = shadow.querySelector('.pill .go');
346
+ nodes.dot = shadow.querySelector('.cluster .dot');
270
347
  nodes.pauseBtn = shadow.querySelector('button.pause');
271
348
  nodes.undoBtn = shadow.querySelector('button.undo');
272
349
  nodes.doneBtn = shadow.querySelector('button.done');
@@ -288,6 +365,14 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
288
365
  shadow.querySelector('.card button.pri').title = '提交这张标注(' + (MAC ? '⌘ Enter' : 'Ctrl Enter') + ')';
289
366
  on(shadow.querySelector('.cancel'), 'click', function (e) { e.preventDefault(); cancel(); }, false);
290
367
  on(nodes.copyBtn, 'click', function (e) { e.preventDefault(); e.stopPropagation(); copySelector(); }, false);
368
+ // 维度 chip 用事件委托:renderCard() 每次重建 innerHTML,逐个绑定会漏。
369
+ on(nodes.dims, 'click', function (e) {
370
+ var btn = e.target && e.target.closest ? e.target.closest('.dim-chip') : null;
371
+ if (!btn) return;
372
+ e.preventDefault();
373
+ e.stopPropagation();
374
+ toggleSpec(btn.getAttribute('data-dim') || '');
375
+ }, false);
291
376
  on(nodes.text, 'input', autosizeText, false);
292
377
  // 必须限定 .card:HUD 的完成按钮也带 .pri 且排在卡片按钮之前,
293
378
  // 裸的 '.pri' 会把提交事件绑到完成按钮上,「添加标注」就没了反应。
@@ -306,13 +391,24 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
306
391
  on(nodes.pauseBtn, 'click', function (e) { e.preventDefault(); e.stopPropagation(); setMode('off'); }, false);
307
392
  on(nodes.undoBtn, 'click', function (e) { e.preventDefault(); e.stopPropagation(); send({ kind: 'undo' }); }, false);
308
393
  on(nodes.doneBtn, 'click', function (e) { e.preventDefault(); e.stopPropagation(); send({ kind: 'consume' }); }, false);
309
- on(nodes.pill, 'click', function (e) { e.preventDefault(); e.stopPropagation(); setMode('pick'); }, false);
310
- on(nodes.pill, 'keydown', function (e) {
394
+ // 落点开关用事件委托:两个按钮,重建时也不用逐个绑。
395
+ on(nodes.hud, 'click', function (e) {
396
+ var btn = e.target && e.target.closest ? e.target.closest('.seg-b') : null;
397
+ if (!btn) return;
398
+ e.preventDefault();
399
+ e.stopPropagation();
400
+ setLanding(btn.getAttribute('data-slot') || '');
401
+ }, false);
402
+ on(nodes.pillMain, 'click', function (e) { e.preventDefault(); e.stopPropagation(); setMode('pick'); }, false);
403
+ on(nodes.pillMain, 'keydown', function (e) {
311
404
  if (e.key !== 'Enter' && e.key !== ' ') return;
312
405
  e.preventDefault();
313
406
  e.stopPropagation();
314
407
  setMode('pick');
315
408
  }, false);
409
+ for (var ci = 0; ci < nodes.cpBtns.length; ci++) {
410
+ on(nodes.cpBtns[ci], 'click', function (e) { e.preventDefault(); e.stopPropagation(); copyPrompt(); }, false);
411
+ }
316
412
  var keepHud = function (e) { e.stopPropagation(); };
317
413
  on(nodes.hud, 'mousedown', keepHud, false);
318
414
  on(nodes.hud, 'mouseup', keepHud, false);
@@ -501,6 +597,118 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
501
597
  fail();
502
598
  }
503
599
 
600
+ /**
601
+ * 复制整份提示词:与面板「复制 Markdown」、agent 工具输出同一份 markdown
602
+ * (host 通过 sync 下发),所以粘到别的 Agent 里也带着「参照:」对照关系。
603
+ */
604
+ function copyPrompt() {
605
+ var text = state.prompt || '';
606
+ if (!text) { flash('还没有标注:先点一个元素,再复制提示词'); return; }
607
+ var done = function () { flash('提示词已复制,可直接粘贴给任意 Agent'); };
608
+ var fail = function () { flash('复制失败:浏览器未授权剪贴板'); };
609
+ try {
610
+ if (navigator.clipboard && navigator.clipboard.writeText) {
611
+ navigator.clipboard.writeText(text).then(done, function () { if (legacyCopy(text)) done(); else fail(); });
612
+ return;
613
+ }
614
+ } catch (e) {}
615
+ if (legacyCopy(text)) done();
616
+ else fail();
617
+ }
618
+
619
+ /** http 页面上 navigator.clipboard 不可用:退回选中隐藏 textarea + execCommand。 */
620
+ function legacyCopy(text) {
621
+ try {
622
+ var ta = document.createElement('textarea');
623
+ ta.value = text;
624
+ ta.setAttribute('readonly', '');
625
+ ta.style.position = 'fixed';
626
+ ta.style.top = '-9999px';
627
+ ta.style.opacity = '0';
628
+ document.body.appendChild(ta);
629
+ ta.select();
630
+ var ok = document.execCommand && document.execCommand('copy');
631
+ document.body.removeChild(ta);
632
+ return !!ok;
633
+ } catch (e) { return false; }
634
+ }
635
+
636
+ /** 页面内提示条(复制成功、换了落点…):唯一实现,对外 API 也委托它。 */
637
+ function flash(message) {
638
+ if (!nodes.note) return;
639
+ nodes.note.textContent = String(message || '');
640
+ nodes.note.style.display = 'block';
641
+ if (noteTimer) clearTimeout(noteTimer);
642
+ noteTimer = setTimeout(function () { nodes.note.style.display = 'none'; }, 2000);
643
+ }
644
+
645
+ function isReference() { return state.role === 'reference'; }
646
+
647
+ /**
648
+ * 参考模式的措辞与配色。同一套控件必须换一套话:如果参考页的 HUD 仍写
649
+ * 「想怎么改」,用户会顺手写下「改成 X」,agent 就会去改参考页——这正好是
650
+ * 这个功能要杜绝的错。
651
+ */
652
+ function renderRole() {
653
+ var ref = isReference();
654
+ // 计数不再随落点换词(原先写成「参考已标 / 已标注」两套):落点已经由 seg 的
655
+ // 选中态和圆点颜色说清,同一行再换一次措辞只会让人读成「这里统计的是别的东西」。
656
+ var tip =
657
+ '本页已标 ' + state.targetCount + ' 处改动、' + state.referenceCount + ' 处参照;当前落点:' + (ref ? '参照' : '改动');
658
+ if (nodes.met) nodes.met.title = tip;
659
+ if (nodes.pillGo) {
660
+ nodes.pillGo.textContent = ref ? '标注参考' : '开启标注';
661
+ nodes.pillGo.classList.toggle('ref', ref);
662
+ }
663
+ if (nodes.dot) nodes.dot.classList.toggle('ref', ref);
664
+ if (nodes.doneBtn) nodes.doneBtn.textContent = ref ? '完成·加入参考' : '完成并插入';
665
+ if (nodes.text)
666
+ nodes.text.placeholder = ref
667
+ ? '要参考这里的什么?例如:间距 16px、卡片圆角、按钮配色…'
668
+ : '说明怎么改:字号 / 间距 / 颜色 / 文案 / 布局…';
669
+ if (nodes.card) nodes.card.classList.toggle('ref', ref);
670
+ // 落点开关跟着亮:这是 HUD 上唯一能改「下一处进哪一栏」的地方,按钮自己必须
671
+ // 说清现在是哪一栏,而不是让用户从颜色去猜。
672
+ var slot = state.landing === 'reference' ? 'reference' : 'target';
673
+ for (var s = 0; nodes.segB && s < nodes.segB.length; s++) {
674
+ var on = nodes.segB[s].getAttribute('data-slot') === slot;
675
+ nodes.segB[s].classList.toggle('on', on);
676
+ nodes.segB[s].setAttribute('aria-pressed', on ? 'true' : 'false');
677
+ }
678
+ }
679
+
680
+ function renderDims() {
681
+ if (!nodes.dims) return;
682
+ var ref = isReference();
683
+ nodes.dims.classList.toggle('on', ref);
684
+ if (!ref) {
685
+ nodes.dims.innerHTML = '';
686
+ return;
687
+ }
688
+ var html = '';
689
+ for (var i = 0; i < state.specs.length; i++) {
690
+ var dim = String(state.specs[i]);
691
+ html +=
692
+ '<button type="button" class="dim-chip" data-dim="' +
693
+ dim +
694
+ '" aria-pressed="' +
695
+ (state.spec.indexOf(dim) >= 0) +
696
+ '">' +
697
+ dim +
698
+ '</button>';
699
+ }
700
+ nodes.dims.innerHTML = html;
701
+ }
702
+
703
+ /** 维度是「这一处参考什么」的快捷标注,最终随 pick 一起交给 agent。 */
704
+ function toggleSpec(dim) {
705
+ if (!dim) return;
706
+ var index = state.spec.indexOf(dim);
707
+ if (index >= 0) state.spec.splice(index, 1);
708
+ else state.spec.push(dim);
709
+ renderDims();
710
+ }
711
+
504
712
  function render() {
505
713
  if (!nodes.host) return;
506
714
  var on = state.mode === 'pick';
@@ -517,6 +725,7 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
517
725
  nodes.cnt.textContent = String(n);
518
726
  nodes.pcnt.textContent = String(n);
519
727
  nodes.undoBtn.disabled = nodes.doneBtn.disabled = n === 0;
728
+ renderRole();
520
729
  if (!on) hideCard();
521
730
  }
522
731
 
@@ -572,7 +781,10 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
572
781
  if (!state.target) return hideCard();
573
782
  var payload = state.target;
574
783
  payload.comment = (nodes.text && nodes.text.value || '').trim();
784
+ // 参考页的维度跟着标注一起上交:缺了它 agent 只能猜「参考哪里」。
785
+ if (isReference() && state.spec.length) payload.spec = state.spec.slice();
575
786
  payload.seq = ++state.seq;
787
+ state.spec = [];
576
788
  state.locked = false;
577
789
  state.target = null;
578
790
  state.targetEl = null;
@@ -753,6 +965,14 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
753
965
  nodes.quote.style.display = snippet ? 'block' : 'none';
754
966
  nodes.text.value = '';
755
967
  nodes.text.style.height = '';
968
+ state.spec = [];
969
+ renderDims();
970
+ // 参考模式的第一次拾取明确说一句「这里不会改」:蓝色徽标不够,用户第一次
971
+ // 用还不知道蓝色是什么意思。
972
+ if (isReference() && !state.hinted) {
973
+ state.hinted = true;
974
+ W.__DSH_VP__.flash('参考模式:这里只取规范,不会修改此页');
975
+ }
756
976
  // 记下点击位置:目标很大时靠它决定卡片往哪边躲。
757
977
  placeCard(state.target.rect, { x: e.clientX, y: e.clientY });
758
978
  render();
@@ -764,8 +984,12 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
764
984
  }
765
985
 
766
986
  function onKey(e) {
987
+ // 输入法组合中(Windows 的 Alt 组合、中文输入法的 Alt 键位)不抢键:
988
+ // 此时 e.key 不是用户想按的字母,抢下来会打断上屏。
989
+ if (e.isComposing || e.keyCode === 229) return;
767
990
  // 页面里直接 Alt+A 切换标注模式:经 binding 上报 host,面板与其它标签页同步。
768
- // macOS 的 Option+A 会把 e.key 组合成 å,必须按物理键 e.code === 'KeyA' 判定。
991
+ // macOS 的 Option+A 会把 e.key 组合成 å(Alt+R 同理是 ®),所以两处都按物理键
992
+ // e.code 判定——Windows 的 Alt+A / Alt+R 也走同一条分支,键位不用分平台维护。
769
993
  if (e.altKey && !e.ctrlKey && !e.metaKey && (e.code === 'KeyA' || e.key === 'a' || e.key === 'A')) {
770
994
  if (state.locked) return;
771
995
  e.preventDefault();
@@ -773,11 +997,52 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
773
997
  setMode(state.mode === 'pick' ? 'off' : 'pick');
774
998
  return;
775
999
  }
1000
+ // ⌥R 一键换落点:正在写批注时(locked)让位给输入,别把字吃掉。
1001
+ if (e.altKey && !e.ctrlKey && !e.metaKey && (e.code === 'KeyR' || e.key === 'r' || e.key === 'R')) {
1002
+ if (state.locked) return;
1003
+ e.preventDefault();
1004
+ e.stopPropagation();
1005
+ var next = state.landing === 'reference' ? 'target' : 'reference';
1006
+ var wasOff = state.mode !== 'pick';
1007
+ // 落点没变(例如本来就是参照)时 setLanding 不发消息,但「从关闭态一键进参照」
1008
+ // 仍要 host 收到落点,所以这里补一条。重复下发是幂等的。
1009
+ if (wasOff) send({ kind: 'landing', slot: next });
1010
+ setLanding(next);
1011
+ if (wasOff) setMode('pick');
1012
+ return;
1013
+ }
1014
+ // ⌥C 复制整份提示词:不展开 HUD 也能把已有标注拿去别的 Agent 用。
1015
+ // 正在写批注时让位给输入,和 ⌥R 同一条规矩。
1016
+ if (e.altKey && !e.ctrlKey && !e.metaKey && (e.code === 'KeyC' || e.key === 'c' || e.key === 'C')) {
1017
+ if (state.locked) return;
1018
+ e.preventDefault();
1019
+ e.stopPropagation();
1020
+ copyPrompt();
1021
+ return;
1022
+ }
776
1023
  if (e.key !== 'Escape') return;
777
1024
  if (state.locked) { e.preventDefault(); e.stopPropagation(); cancel(); return; }
778
1025
  if (state.mode === 'pick') { e.preventDefault(); e.stopPropagation(); setMode('off'); }
779
1026
  }
780
1027
 
1028
+ /**
1029
+ * 换落点:下一处标注进「改动」还是「参照」。与面板上的「+ 新增改动 / + 添加参照」
1030
+ * 是同一条契约(binding kind=landing),面板会通过 /state 看到并跟着切到参照模式。
1031
+ */
1032
+ function setLanding(slot) {
1033
+ slot = slot === 'reference' ? 'reference' : 'target';
1034
+ var changed = state.landing !== slot;
1035
+ // 乐观置位:HUD 必须在这一帧就换颜色,等 host 回推会有一段可见的延迟。
1036
+ state.landing = slot;
1037
+ state.role = slot;
1038
+ renderRole();
1039
+ if (changed) {
1040
+ send({ kind: 'landing', slot: slot });
1041
+ flash(slot === 'reference' ? '下一处标注进「参照」栏' : '下一处标注进「改动」栏');
1042
+ }
1043
+ if (state.mode === 'pick') flush();
1044
+ }
1045
+
781
1046
  function setMode(mode, fromHost) {
782
1047
  mode = mode === 'pick' ? 'pick' : 'off';
783
1048
  var changed = state.mode !== mode;
@@ -802,7 +1067,7 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
802
1067
  }
803
1068
 
804
1069
  W.__DSH_VP__ = {
805
- version: 3,
1070
+ version: 4,
806
1071
  rev: REV,
807
1072
  setMode: setMode,
808
1073
  dispose: dispose,
@@ -815,16 +1080,23 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
815
1080
  sync: function (info) {
816
1081
  info = info || {};
817
1082
  if (typeof info.count === 'number') state.count = info.count;
1083
+ // role 由 host 按「落点」判定(没有落点就是改动):切按钮后 HUD 必须立刻换口径。
1084
+ if (info.role === 'reference' || info.role === 'target') {
1085
+ if (info.role !== state.role) state.hinted = false;
1086
+ state.role = info.role;
1087
+ }
1088
+ if (info.landing === 'reference' || info.landing === 'target') state.landing = info.landing;
1089
+ else state.landing = '';
1090
+ if (typeof info.targetCount === 'number') state.targetCount = info.targetCount;
1091
+ if (typeof info.referenceCount === 'number') state.referenceCount = info.referenceCount;
1092
+ if (typeof info.refLabel === 'string') state.refLabel = info.refLabel;
1093
+ if (Array.isArray(info.specs)) state.specs = info.specs.map(function (item) { return String(item); });
1094
+ // 提示词由 host 生成(与面板复制、工具输出同一份):页面不自己拼,避免第三份会漂移的实现。
1095
+ if (typeof info.prompt === 'string') state.prompt = info.prompt;
818
1096
  if (info.mode === 'pick' || info.mode === 'off') setMode(info.mode, true);
819
1097
  else if (nodes.host) render();
820
1098
  },
821
- flash: function (message) {
822
- if (!nodes.note) return;
823
- nodes.note.textContent = String(message || '');
824
- nodes.note.style.display = 'block';
825
- if (noteTimer) clearTimeout(noteTimer);
826
- noteTimer = setTimeout(function () { nodes.note.style.display = 'none'; }, 2000);
827
- }
1099
+ flash: flash
828
1100
  };
829
1101
 
830
1102
  W.__DSH_VP_DEBUG__ = function () {
@@ -834,6 +1106,9 @@ export const OVERLAY_SCRIPT = String.raw`(() => {
834
1106
  locked: state.locked,
835
1107
  seq: state.seq,
836
1108
  count: state.count,
1109
+ landing: state.landing,
1110
+ role: state.role,
1111
+ prompt: state.prompt ? state.prompt.length : 0,
837
1112
  clicks: state.clicks,
838
1113
  guarded: state.guarded,
839
1114
  restored: state.restored,