dsh-mattpocock-skills-deck 1.7.49 → 1.7.50

package/README.md

@@ -1,4 +1,4 @@
-<!-- AUTO-GENERATED by scripts/build.mjs — DO NOT EDIT. Source: ../README.md @ v1.7.49 -->
+<!-- AUTO-GENERATED by scripts/build.mjs — DO NOT EDIT. Source: ../README.md @ v1.7.50 -->
 
 <h1 align="center">dsh-mattpocock-skills-deck</h1>
 
@@ -34,10 +34,10 @@ npm install -g @deepseek-ai/dsh
 dsh plugin --profile web add dsh-mattpocock-skills-deck     # 用自启 web 服务（dsh web）
 #     或者
 dsh plugin --profile desktop add dsh-mattpocock-skills-deck   # 用 DSH Desktop 桌面应用
-# 锁定最新版更稳（当前 1.7.49）：
-dsh plugin --profile web add dsh-mattpocock-skills-deck@1.7.49 --registry https://registry.npmjs.org
+# 锁定最新版更稳（当前 1.7.50）：
+dsh plugin --profile web add dsh-mattpocock-skills-deck@1.7.50 --registry https://registry.npmjs.org
 #     或者
-dsh plugin --profile desktop add dsh-mattpocock-skills-deck@1.7.49 --registry https://registry.npmjs.org
+dsh plugin --profile desktop add dsh-mattpocock-skills-deck@1.7.50 --registry https://registry.npmjs.org
 ```
 
 <div align="center">

package/lib/client.js

@@ -208,7 +208,7 @@ const PortalOverlay = function (props, children) {
   return portalTop(h('div', props || {}, children))
 }
     // v1.3.3：面板版本号（tabs 行最右侧显示，便于核对已更新）
-    const DSW_VERSION = 'v1.7.49'
+    const DSW_VERSION = 'v1.7.50'
     // #repo-link：版本号可点，新窗打开插件仓库主页；URL 构建期从 package/package.json 的 repository 字段
     // 注入（客户端源码零 URL 字面量，过硬编码门禁 F2；产物字面量已在门禁 RE_LICENSED 登记）。
     const DSW_REPO_URL = 'https://github.com/FeatherHunter/dsh-mattpocock-skills-deck'

package/lib/index.js

@@ -90,7 +90,7 @@ export default {
     async function getRepoKey() { const h = await _repo(); return h.getRepoKey.apply(h, arguments) }
     // #723（T19）：刷新机制在宿主里真的装起来（闸+账本+写事件订阅+视野模型+会话↔票处理链，实现整段在 ./refresh/wiring.js）。这个句柄是那套东西的唯一出口：_detectChain 从它取闸（3g），wf.chain 从它取界面读数。
     let _refreshWiringP = null, refreshGate = null
-    try { _boot().catch(function(){}); _dispatchMeta().catch(function(){}); _refreshWiringP = import('./refresh/wiring.js').then(function (m) { return m.makeRefreshLoader({ ctx: ctx, logCtx: logCtx, canonicalKey: function () { return canonicalKey.apply(null, arguments) }, getCacheDir: function () { return getCacheDir.apply(null, arguments) }, getTrackerRegistry: function () { return getTrackerRegistry.apply(null, arguments) }, getDetectionService: function () { return getDetectionService.apply(null, arguments) }, getPlatform: function () { return getPlatform.apply(null, arguments) }, detectionExec: function () { return detectionExec.apply(null, arguments) }, setCache: setCache, getCache: getCache, readDiskCache: function () { return readDiskCache.apply(null, arguments) }, writeDiskCache: function () { return writeDiskCache.apply(null, arguments) }, runGh: function () { return runGh.apply(null, arguments) }, getRepoKey: function () { return getRepoKey.apply(null, arguments) }, fetchIssueIndex: function () { return fetchIssueIndex.apply(null, arguments) }, issueIndexFromSnapshot: function () { return issueIndexFromSnapshot.apply(null, arguments) }, getNaming: function () { return _naming() } })() }).then(function (w) { refreshGate = (w && w.gate) || null; return w }) } catch (e0) {}
+    try { _boot().catch(function(){}); _dispatchMeta().catch(function(){}); _refreshWiringP = import('./refresh/wiring.js').then(function (m) { return m.makeRefreshLoader({ ctx: ctx, logCtx: logCtx, getChoiceStore: function () { return getChoiceStore.apply(null, arguments) }, canonicalKey: function () { return canonicalKey.apply(null, arguments) }, getCacheDir: function () { return getCacheDir.apply(null, arguments) }, getTrackerRegistry: function () { return getTrackerRegistry.apply(null, arguments) }, getDetectionService: function () { return getDetectionService.apply(null, arguments) }, getPlatform: function () { return getPlatform.apply(null, arguments) }, detectionExec: function () { return detectionExec.apply(null, arguments) }, setCache: setCache, getCache: getCache, readDiskCache: function () { return readDiskCache.apply(null, arguments) }, writeDiskCache: function () { return writeDiskCache.apply(null, arguments) }, runGh: function () { return runGh.apply(null, arguments) }, getRepoKey: function () { return getRepoKey.apply(null, arguments) }, fetchIssueIndex: function () { return fetchIssueIndex.apply(null, arguments) }, issueIndexFromSnapshot: function () { return issueIndexFromSnapshot.apply(null, arguments) }, getNaming: function () { return _naming() } })() }).then(function (w) { refreshGate = (w && w.gate) || null; return w }) } catch (e0) {}
     try { _plat().then(function(pl){ try { pl.getTrackerRegistry().catch(function(){}) } catch (e1) {} }).catch(function(){}) } catch (e2) {}
     // ---- H2 #446 接线：3 新文件动态 import 加载（D7 禁止静态 import），依赖全显式传入；新文件之间不互引用 ---- 留守（行为零变化优先；调用方在 H4/H5/H6 的同步上下文里，动态加载给不出同步函数）：computeLevels/groupTickets（H4 三处同步分组）、isRateLimitError（H5 三处同步判别）、issueIndexFromSnapshot/issueIndexChanged/rememberIssueIndex（H6 探测同步取值与同刻写表）。 这一组的拆分缘由见账本 §3。
     let _mapBodyP = null

package/lib/refresh/wiring.js

@@ -35,6 +35,7 @@ import * as toolCost from '../../shared/refresh/tool-cost.js'
 // #724：闸那一侧的工作区钥匙（短散列）只有一份实现，住在共享层（宿主层文件之间不许互引，而链求值那侧也要用
 // 同一把钥匙）。本文件把它转出来，「活跃集合、写事件白名单、七个 deck_* 工具、行级增量、检查链记账」五处同源。
 import { hash8, workspaceKeyOf } from '../../shared/refresh-workspace-key.js'
+import { parseWorkspaceFile, WORKSPACE_FILE_REL } from '../../shared/deck-tools/workspace-file.js'
 export { workspaceKeyOf } from '../../shared/refresh-workspace-key.js'
 
 /** 把一堆依赖包装成「取一次、以后复用」的惰性实例（模块加载失败不许把整个插件带崩）。 */
@@ -328,6 +329,10 @@ export function createRefreshWiring(deps) {
           handleFor: function (s) { try { const list = (typeof registry.allBindings === 'function') ? registry.allBindings() : []; const want = String((s && s.cwd) || ''); const wash = (p) => String(p || '').replace(/\\/g, '/').replace(/\/+$/, ''); const wantW = wash(want); for (let i = 0; i < list.length; i++) { const c = (list[i] && (list[i].cwd || (list[i].handle && list[i].handle.cwd))) || ''; if (String(c) === want || wash(c) === wantW) return list[i].handle || { cwd: want } } } catch (e) {} return { cwd: (s && s.cwd) || '' } },
           // 934：会话目录洗加锚根的宿主唯一异步出口（与绑定侧同一把钥匙）；缺席时壳沿用原始目录。
           canonicalKey: (typeof d.canonicalKey === 'function') ? function (raw) { return d.canonicalKey(raw) } : undefined,
+          // 947 显式后两层读口：查不到一律 null（缺席即跳过，不猜）。
+          readChoice: function (rootCwd) { try { return (typeof d.getChoiceStore === 'function') ? d.getChoiceStore().then(function (cs) { return (cs && typeof cs.getWorkspace === 'function') ? cs.getWorkspace(rootCwd) : null }, function () { return null }).then(function (got) { return (got && got.found === true && got.backendId) ? { backendId: got.backendId, rev: got.rev || 0 } : null }) : Promise.resolve(null) } catch (e) { return Promise.resolve(null) } },
+          readWorkspaceFileText: function (rootCwd) { try { const fsSvc = backendObj && backendObj.fs; if (!fsSvc || typeof fsSvc.resolve !== 'function' || typeof fsSvc.readText !== 'function') return Promise.resolve(null); return Promise.resolve(fsSvc.resolve(WORKSPACE_FILE_REL, { cwd: rootCwd })).then(function (t) { return fsSvc.readText(t) }, function () { return null }).then(function (txt) { return (typeof txt === 'string' && txt) ? txt : null }, function () { return null }) } catch (e) { return Promise.resolve(null) } },
+          parseWorkspaceFile: parseWorkspaceFile,
           sandboxPolicyFor: createSandboxPolicyFor(d.ctx),
           backendCtx: function () { return backendObj },
           invalidate: function (info) { try { const root = (info && info.workspace && info.workspace.root) || (info && info.cwd); if (typeof d.setCache === 'function' && root) d.setCache({ ts: 0, snapshot: null, error: null, cwd: String(root) }) } catch (e) {} },

package/lib/tracker/detection/explicitDetector.js

@@ -3,7 +3,7 @@
  *
  * 第一性原理（#150 Q4 + #149 9→契约映射 + #113 平台层）：
  *  - 唯一显式写路径 = `wf.bind(handle, backendId|null) → registry.bind`（Q4 不回写 issue-tracker.md）
- *  - 本模块为「文件显式」：读 `docs/agents/issue-tracker.md` 经 `platform.fs`（零 OS 直碰），
+ *  - 本模块为「文件显式」：读内存绑定、`docs/agents/workspace.json`、再读 `docs/agents/issue-tracker.md`，经 `platform.fs`（零 OS 直碰），
  *    产内存 `Selection(explicit)`；不写 `byHandle`，避免文件监听竞态（handoff-150 Q4 *不自动 bind* 推荐）
  *  - 若解析出 `explicitBackendId` 且已注册 → 直接回 `Selection`，跳过 `registry.select` 的 matches 并行；
  *    否则返回 null 由调用方落到 `registry.select`（含 bound-explicit > matches > fallback + pending/multiHit）
@@ -11,6 +11,7 @@
  */
 
 import { parseIssueTracker, normalizeTrackerText } from './parseIssueTracker.js'
+import { parseWorkspaceFile, WORKSPACE_FILE_REL } from '../../../shared/deck-tools/workspace-file.js'
 
 /**
  * 尝试显式分支：读主锚 → 结构化解析 → 已注册则产 Selection
@@ -21,11 +22,34 @@ import { parseIssueTracker, normalizeTrackerText } from './parseIssueTracker.js'
  */
 export async function detectExplicit(handle, ctx, registry) {
   const cwd = (handle && handle.cwd) || (ctx && ctx.cwd) || ''
+  // #947：内存绑定优先（与工具壳同一条：绑过即显式，不读文件）。空串是显式无后端逃生舱，如实透传不落锚文件。
+  try {
+    if (registry && typeof registry.bound === 'function') {
+      const boundId = registry.bound(handle)
+      if (boundId === null) return { selection: { backendId: null, source: 'explicit' }, raw: null, parsed: { explicitBackendId: null, rawHint: '', confidence: 'high', reason: 'memory-none' } }
+      if (typeof boundId === 'string' && boundId && typeof registry.has === 'function' && registry.has(boundId)) {
+        let ref = null
+        try { ref = registry.describe(handle, boundId) } catch (eD) { ref = { backend: boundId, refId: (handle && (handle.refId || handle.cwd)) || '', name: (handle && handle.cwd) || boundId, url: '' } }
+        return { selection: { backendId: boundId, source: 'explicit', ref: ref }, raw: null, parsed: { explicitBackendId: boundId, rawHint: '', confidence: 'high', reason: 'memory-bound' } }
+      }
+    }
+  } catch (eB) {}
   const platform = ctx && ctx.platform ? ctx.platform : null
   // 无平台则无法安全读（零 OS 直碰红线），回退 null
   if (!platform || !platform.fs || typeof platform.fs.resolve !== 'function' || typeof platform.fs.readText !== 'function') {
     return { selection: null, raw: null, parsed: { explicitBackendId: null, rawHint: '', confidence: 'none', reason: 'no-platform' } }
   }
+  // #947：工作区配置文件（人亲手选的默认值）。胜锚文件，输内存绑定与选择记忆 H（H 在检测主流程后判）。
+  try {
+    const target = await platform.fs.resolve(WORKSPACE_FILE_REL, { cwd })
+    const txt = await platform.fs.readText(target)
+    const parsed = parseWorkspaceFile(txt)
+    if (parsed && registry && typeof registry.has === 'function' && registry.has(parsed.backendId)) {
+      let ref = null
+      try { ref = registry.describe(handle, parsed.backendId) } catch (eD) { ref = { backend: parsed.backendId, refId: (handle && (handle.refId || handle.cwd)) || '', name: (handle && handle.cwd) || parsed.backendId, url: '' } }
+      return { selection: { backendId: parsed.backendId, source: 'explicit', ref: ref }, raw: txt, parsed: { explicitBackendId: parsed.backendId, rawHint: '', confidence: 'high', reason: 'workspace-file' } }
+    }
+  } catch (eF) {}
   let raw = null
   try {
     const target = await platform.fs.resolve('docs/agents/issue-tracker.md', { cwd })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mattpocock-skills-deck",
-  "version": "1.7.49",
+  "version": "1.7.50",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/FeatherHunter/dsh-mattpocock-skills-deck.git"

package/shared/deck-tools/shell.js

@@ -64,38 +64,7 @@ export function limitsFromBudget(b) {
   }
 }
 
-/**
- * 从会话上下文里取工作区。只认「会话里带着的那个目录」，不接受调用方传进来的路径
- * （那样等于允许跨工作区写）。真实运行时的首选位置是 exec.agent.session.cwd；
- * 别的几个位置一起认，是因为会话对象在宿主不同版本里的形状不完全一样，
- * 认不出来时返回 ok:false，让工具如实说做不到，而不是猜一个进程目录。
- */
-export function sessionContextOf(exec, deps) {
-  const e = exec || {}
-  const d = deps || {}
-  const agent = e.agent || {}
-  const session = agent.session || e.session || null
-  const cands = [
-    { where: 'exec.agent.session.cwd', value: session && session.cwd },
-    { where: 'exec.agent.session.workspaceRoot', value: session && session.workspaceRoot },
-    { where: 'exec.agent.session.workspace.cwd', value: session && session.workspace && session.workspace.cwd },
-    { where: 'exec.agent.cwd', value: agent.cwd },
-    { where: 'exec.session.cwd', value: e.session && e.session.cwd },
-    { where: 'exec.cwd', value: e.cwd },
-  ]
-  let cwd = ''
-  let source = ''
-  for (const c of cands) {
-    if (typeof c.value === 'string' && c.value.trim()) { cwd = c.value.trim(); source = c.where; break }
-  }
-  const sessionId = str(session && (session.id || session.sessionId)) || str(agent.sessionId)
-  if (!cwd) {
-    return { ok: false, reason: REFUSAL_REASONS.NO_SESSION, sessionId: sessionId, text: '这次没拿到当前会话的工作区目录（会话上下文里没有可用的路径），所以我不动任何票。请换一个会话再来，或让维护者看一看会话对象的形状。' }
-  }
-  const key = typeof d.workspaceKeyOf === 'function' ? String(d.workspaceKeyOf(cwd)) : ('ws-' + hash8(cwd))
-  return { ok: true, cwd: cwd, workspaceKey: key, sessionId: sessionId, source: source, text: '' }
-}
-
+// 会话目录取法只有 session-resolve.js 一份（九个工具全走它的 Async 版）；本文件曾有的同步复件已删，免得两份分叉。
 // 边的落点判定与逐项证据（landingOf / classifyEdgeLanding / childrenOf / statusOfItems）住在同目录的
 // edges.js：同层的文件不许互相 import，所以那边自带一份最小的字符串工具函数，拆开的理由见 edges.js 文件头。
 // 「一批里有的成、有的没成 → partial」这条总结论也在那边（statusOfItems），这里不再留第二份。
@@ -112,6 +81,9 @@ export function sessionContextOf(exec, deps) {
  *   invalidate 可选，写后失效缓存该票条目：invalidate({ repo, keys, backendId })
  *   ensureReading 可选，动手前保剩余额度读数：ensureReading(cwd, workspaceKey)，缺席时跳过
  *   resolveTimeoutMs 可选，仓库标识补全等待上限毫秒数（缺席 8000，测试可调小）
+ *   readChoice 可选，读本机记忆H：(规范根) => {backendId, rev} | null（缺席跳过H层）
+ *   readWorkspaceFileText 可选，读工作区文件原文：(规范根) => string | null（缺席跳过文件层）
+ *   parseWorkspaceFile 可选，解析文件文本（与 readWorkspaceFileText 同给同缺）
  */
 export function createDeckShell(deps) {
   const d = deps || {}
@@ -137,8 +109,6 @@ export function createDeckShell(deps) {
     try { if (typeof d.noteGate === 'function') d.noteGate({ phase: phase, verdict: verdict, reason: reason }) } catch (eN) {}
   }
 
-  function context(exec) { return sessionContextOf(exec, { workspaceKeyOf: d.workspaceKeyOf }) }
-
   /** 后端 ctx（platform / fs / exec 那一套）：可以给对象，也可以给一个现取的函数（多工作区共用一个壳时后者更顺手）。 */
   function backendCtxNow() {
     const b = d.backendCtx
@@ -200,9 +170,37 @@ export function createDeckShell(deps) {
     let sent = null
     const t0 = now()
     try { if (typeof d.ensureReading === 'function') await d.ensureReading(s.cwd, s.workspaceKey) } catch (eR) {}
+    // 显式三层（947：内存绑定 > 本机记忆H > 工作区文件）。缺席的口子跳过，未注册 id 忽略，
+    // 显式无后端（null）落到 select 由注册表诚实判。判定收在闸内：每笔照旧过闸记账，不断 758 口径。
+    const explicitId = async function () {
+      try {
+        const mem = (registry && typeof registry.bound === 'function') ? registry.bound(handle) : undefined
+        if (typeof mem === 'string' && mem && typeof registry.has === 'function' && registry.has(mem)) return mem
+      } catch (eM) {}
+      try {
+        if (typeof d.readChoice === 'function') {
+          const h = await d.readChoice(s.cwd)
+          if (h && typeof h.backendId === 'string' && h.backendId && typeof registry.has === 'function' && registry.has(h.backendId)) return h.backendId
+        }
+      } catch (eH) {}
+      try {
+        if (typeof d.readWorkspaceFileText === 'function' && typeof d.parseWorkspaceFile === 'function') {
+          const parsed = d.parseWorkspaceFile(await d.readWorkspaceFileText(s.cwd))
+          if (parsed && typeof parsed.backendId === 'string' && parsed.backendId && typeof registry.has === 'function' && registry.has(parsed.backendId)) return parsed.backendId
+        }
+      } catch (eF) {}
+      return null
+    }
     try {
       sent = await gate.send({ source: 'tool.call', kind: 'probe', bucket: 'rest', workspaceKey: s.workspaceKey, plan: [{ phase: 'select' }] }, async () => {
-        picked = await registry.select(handle, Object.assign({}, backendCtxNow(), { cwd: s.cwd, caller: DECK_TOOL_KIND }))
+        const ex = await explicitId()
+        if (ex) {
+          let ref = null
+          try { ref = registry.describe(handle, ex) } catch (eD) { ref = null }
+          picked = { backendId: ex, source: 'explicit', ref: ref, pending: false }
+        } else {
+          picked = await registry.select(handle, Object.assign({}, backendCtxNow(), { cwd: s.cwd, caller: DECK_TOOL_KIND }))
+        }
         return { requests: 1, points: 0 }
       })
     } catch (e) { failure = e }
@@ -358,7 +356,6 @@ export function createDeckShell(deps) {
 
   return {
     limits: limits,
-    context: context,
     estimateFor: estimateFor,
     pickBackend: pickBackend,
     repoOf: repoOf,

package/shared/deck-tools/workspace-file.js

@@ -0,0 +1,33 @@
+// src/shared/deck-tools/workspace-file.js —— 工作区配置文件的纯半（#947 规格）
+//
+// 住共享层：探测（host 直接引用）与工具壳（shared，经接线注入）共用同一套解析，
+// 不各写一份。调用方（host）引用本文件是允许的方向；shared 文件之间不互引，所以本文件零导入。
+// 本文件只做字符串与 JSON：不碰 fs / 平台 / 注册表；读文件与「后端认不认得」由调用方做。
+// 只认人亲手选的：source 不是 'user' 的一律不认（派生结论不许钉成意图，与选择记忆 H 同一条铁律）。
+export const WORKSPACE_FILE_REL = 'docs/agents/workspace.json'
+export const WORKSPACE_FILE_VERSION = 1
+export const WORKSPACE_FILE_SOURCE = 'user'
+
+function finiteNumber(v) { return (typeof v === 'number' && Number.isFinite(v)) }
+
+// 工作区文件文本 → 人选后端候选。形状不对一律 null（调用方按「没有这层」继续往下走，不报错）。
+// 已知性（注册表认不认得这个 id）不在这里判：调用方手里有注册表，各自按既有形状核验。
+export function parseWorkspaceFile(text) {
+  let obj = null
+  try { obj = JSON.parse(String(text == null ? '' : text).replace(/^\uFEFF/, '')) } catch (e) { return null }
+  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) return null
+  if (obj.version !== WORKSPACE_FILE_VERSION) return null
+  const backendId = (typeof obj.backendId === 'string') ? obj.backendId.trim() : ''
+  if (!backendId) return null
+  if (obj.source !== WORKSPACE_FILE_SOURCE) return null
+  if (!finiteNumber(obj.pickedAt)) return null
+  return { backendId: backendId, pickedAt: obj.pickedAt, source: WORKSPACE_FILE_SOURCE }
+}
+
+// 人选 → 落盘文本。只装四项：版本、后端、档案时间、来源；不装路径、令牌、登录态。
+export function stringifyWorkspaceFile(input) {
+  const src = (input && typeof input === 'object') ? input : {}
+  const backendId = (typeof src.backendId === 'string') ? src.backendId.trim() : ''
+  const pickedAt = finiteNumber(src.pickedAt) ? src.pickedAt : 0
+  return JSON.stringify({ version: WORKSPACE_FILE_VERSION, backendId: backendId, pickedAt: pickedAt, source: WORKSPACE_FILE_SOURCE }, null, 2) + '\n'
+}