dsh-pictor 0.2.0 → 0.2.2

package/NOTICE.md

@@ -0,0 +1,18 @@
+# NOTICE — 第三方内容声明
+
+本仓库包含以下源自第三方的内容，请在分发或再使用时留意相应许可：
+
+## references/paper/
+
+- `2601.23265v1.md`：arXiv 预印本 2601.23265v1 的正文提取（仅文本，不含 PDF），
+  作为研究背景资料随源码仓库分发。
+- `paperbanana-prompts.md`：同一 arXiv 预印本附录 G、H 中提示词原文的忠实提取与中文翻译。
+
+两者均**不随发布包分发**（package.json 的 files 仅含 `references/domain`），
+只存在于源码仓库。再分发请以 arXiv 原文及其作者声明的许可为准。
+
+## 免责声明
+
+除上述文件外，本仓库其余内容（agents/ 蓝图、references/domain/ 模板与规范、
+src/、fixtures/ 示例文档）均为作者原创。样式与布局模板的早期版本
+曾参考 PaperBanana（arXiv:2601.23265v1）的设计思路，但经重写已不包含其原文。

package/README.md

@@ -20,6 +20,10 @@ Replace `<profile>` with the target profile name (e.g. `desktop`, `web`) and sta
 
 > Install the Pictor plugin from the npm package `dsh-pictor` into the current profile, restart if needed, and confirm when a Pictor button appears at the bottom left.
 
+## Supported dsh version
+
+Pictor is built and tested against **DSH Desktop 0.7.2** (bundled Harness **0.1.2-alpha.1**). The DeepSeek Harness client API moves quickly — the workspace/session services it exposes keep changing — so this plugin intentionally tracks one harness generation. Other versions (older or newer) may work or may break without notice, and are outside our support scope. If something stops working after a DSH update, update dsh to the version above rather than debugging the mismatch.
+
 ## Usage
 
 1. Open the workbench via the **Pictor** footer button and click **New project**: upload a file (`md` / `txt` / `docx` / `pdf` / image) or paste content (from Word or the web; formatting is kept, stored as sanitised HTML).
@@ -47,10 +51,15 @@ Replace `<profile>` with the target profile name (e.g. `desktop`, `web`) and sta
 ```bash
 npm run build                # esbuild build of host + bundled client
 npm run verify               # L1 unit + L2 host integration (mock ctx, 15 items)
-npm run verify:integration   # L3 transport smoke against a real dsh web
+npm run verify:integration   # L3 transport smoke against a real dsh web (hermetic temp home)
+npm run test:pack            # package integrity: tarball carries lib/, agents/, references/, assets/
+npm run test:install         # L5: README install path (dsh plugin add) → real dsh web boot
 npm run test:e2e             # L4a browser e2e (fixture data, deterministic)
+npm run hooks:install        # one-time: enable the pre-push hook (git config core.hooksPath .githooks)
 ```
 
+The pre-push hook runs `npm run verify` + `npm run test:install` before every push; all smoke layers are hermetic (temp `DSH_HOME`, never the live `~/.dsh`).
+
 Test-layer definitions and rationale: [docs/DESIGN.zh.md](docs/DESIGN.zh.md) §7.
 
 ### Layout

package/README.zh-cn.md

@@ -20,6 +20,10 @@ dsh plugin --profile <profile> add dsh-pictor
 
 > 帮我把 Pictor 插件装上，从 npm 包 dsh-pictor 装到当前 profile，需要的话重启，装好告诉我左下角有没有 Pictor 入口。
 
+## 适配的 DSH 版本
+
+Pictor 以 **DSH Desktop 0.7.2**（内置 Harness **0.1.2-alpha.1**）为适配与测试基准。DeepSeek Harness 的客户端 API（工作区/会话服务）演进很快，本月两个版本之间可能就面目全非，所以本插件只跟住一个 harness 世代。其他版本——无论更旧更新——可能能跑、也可能无预告地坏掉，都不在我们的支持范围内。DSH 升级后插件不工作，请先回到上面这个版本，而不是去排查版本差异。
+
 ## 使用
 
 1. 打开工作台，点「新建项目」：上传文件（md/txt/docx/pdf/图片）或粘贴内容（从 Word/网页粘贴，格式保留，落盘为消毒 HTML）。
@@ -47,10 +51,15 @@ dsh plugin --profile <profile> add dsh-pictor
 ```bash
 npm run build         # esbuild 构建 host + 拼接 client
 npm run verify        # L1 单元 + L2 host 集成（mock ctx，15 项）
-npm run verify:integration   # L3 transport 冒烟（真实 dsh web）
+npm run verify:integration   # L3 transport 冒烟（真实 dsh web，封闭临时 DSH_HOME）
+npm run test:pack     # 打包完整性：tarball 必带 lib/、agents/、references/、assets/
+npm run test:install  # L5：README 安装路径（dsh plugin add）→ 真实 dsh web 启动
 npm run test:e2e      # L4a 浏览器 e2e（fixture 数据，确定性）
+npm run hooks:install # 一次性启用 pre-push 钩子（git config core.hooksPath .githooks）
 ```
 
+pre-push 钩子在每次 push 前依次跑 `npm run verify` 与 `npm run test:install`；所有冒烟层都是封闭式（临时 `DSH_HOME`，不碰真实 `~/.dsh`）。
+
 测试分层的定义与理由见 [docs/DESIGN.zh.md](docs/DESIGN.zh.md) 第 7 节。
 
 ## 目录

package/lib/client.js

@@ -53,11 +53,11 @@ const STYLE = `
   background: var(--dsw-alias-bg-layer-1, #fbfbfa); display: flex; flex-direction: column; overflow-y: auto; }
 .pt-nav-head { padding: 18px 16px 12px; display: flex; align-items: center; justify-content: space-between; gap: 8px; }
 .pt-nav-titles { flex: 1; min-width: 0; }
-.pt-nav-title { font-size: 18px; font-weight: 700; letter-spacing: -0.01em; margin: 0; }
+.pt-nav-title { font-size: 15px; font-weight: 650; letter-spacing: -0.15px; margin: 0; }
 .pt-nav-sub { font-size: 13px; color: var(--dsw-alias-label-caption, #8a8a8a); margin: 2px 0 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.pt-nav-new { border: 0; background: var(--dsw-alias-state-business-primary, #4f7cff); color: #fff;
-  border-radius: 10px; padding: 7px 12px; font-size: 13px; font-weight: 600; cursor: pointer; white-space: nowrap; flex: none; }
-.pt-nav-new:hover { filter: brightness(.95); }
+.pt-root .pt-nav-new { border: 1px solid transparent; background: var(--dsw-alias-button-primary-fill, #4f7cff); color: var(--dsw-alias-label-primary-foreground, #fff);
+  border-radius: 8px; padding: 5px 12px; font-size: 13.5px; font-weight: 550; cursor: pointer; white-space: nowrap; flex: none; box-shadow: 0 1px 2px rgba(0,0,0,0.12); transition: background 140ms ease; }
+.pt-root .pt-nav-new:hover { background: var(--dsw-alias-button-primary-hover, #3a6ae0); }
 .pt-nav-list { flex: 1; overflow-y: auto; padding: 4px 8px 12px; min-height: 0; }
 .pt-nav-item { display: flex; align-items: center; gap: 10px; width: 100%; text-align: left;
   padding: 9px 10px; border-radius: 10px; border: 0; background: transparent; cursor: pointer;
@@ -78,13 +78,6 @@ const STYLE = `
 .pt-nav-settings:hover { border-color: var(--dsw-alias-border-l1, #b0b0b0); filter: brightness(.98); }
     .pt-nav-settings .glyph { color: var(--dsw-alias-state-business-primary, #4f7cff); font-size: 16px; }
 .pt-nav-settings:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,.05)); }
-.pt-lang { display: flex; align-items: center; gap: 8px; padding: 8px 10px 0; font-size: 13px;
-  color: var(--dsw-alias-label-caption, #888); }
-.pt-lang-opts { display: inline-flex; border: 1px solid var(--dsw-alias-border-l2, #d8d8d8);
-  border-radius: 999px; overflow: hidden; }
-.pt-lang-opt { border: 0; background: transparent; padding: 2px 10px; font-size: 12.5px; cursor: pointer;
-  color: var(--dsw-alias-label-secondary, #777); }
-.pt-lang-opt.on { background: var(--dsw-alias-state-business-primary, #4f7cff); color: #fff; font-weight: 600; }
 
 /* ---- 主区 ---- */
 .pt-main { flex: 1; min-width: 0; overflow-y: auto; padding: 22px 28px 40px; }
@@ -92,12 +85,16 @@ const STYLE = `
 .pt-title { font-size: 28px; font-weight: 700; letter-spacing: -0.01em; margin: 0 0 4px; }
 .pt-subtitle { margin: 0 0 24px; font-size: 15px; color: var(--dsw-alias-label-secondary, #666); }
 .pt-btn { border: 1px solid var(--dsw-alias-border-l2, #d8d8d8); background: var(--dsw-alias-bg-layer-2, #fff);
-  color: var(--dsw-alias-label-primary, #1a1a1a); border-radius: 12px; padding: 9px 18px; font-size: 15px;
-  font-weight: 550; cursor: pointer; transition: filter 150ms, background 150ms; white-space: nowrap; }
-.pt-btn:hover { filter: brightness(0.96); }
-.pt-btn:disabled { opacity: 0.45; cursor: not-allowed; }
-.pt-btn-primary { background: var(--dsw-alias-accent, #4f7cff); border-color: var(--dsw-alias-accent, #4f7cff); color: #fff; }
-.pt-btn-ghost { background: transparent; border-color: transparent; color: var(--dsw-alias-label-secondary, #666); }
+  color: var(--dsw-alias-label-primary, #1a1a1a); border-radius: 8px; padding: 7px 14px; font-size: 14px;
+  font-weight: 500; cursor: pointer; transition: background 140ms ease, border-color 140ms ease, color 140ms ease, box-shadow 140ms ease; user-select: none; white-space: nowrap; }
+.pt-btn:hover:not(:disabled) { background: var(--dsw-alias-bg-layer-3, var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,0.05))); border-color: var(--dsw-alias-border-l3, #ccc); }
+.pt-btn:active { transform: translateY(0.5px); }
+.pt-btn:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary, #4f7cff); outline-offset: 2px; }
+.pt-btn:disabled { opacity: 0.45; cursor: not-allowed; box-shadow: none; }
+.pt-btn-primary { background: var(--dsw-alias-button-primary-fill, #4f7cff); border-color: transparent; color: var(--dsw-alias-label-primary-foreground, #fff); font-weight: 550; box-shadow: 0 1px 2px rgba(0,0,0,0.12); }
+.pt-btn-primary:hover:not(:disabled) { background: var(--dsw-alias-button-primary-hover, #3a6ae0); }
+.pt-btn-ghost { background: transparent; border-color: transparent; color: var(--dsw-alias-label-dimmed, #777); }
+.pt-btn-ghost:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover, rgba(0,0,0,0.05)); color: var(--dsw-alias-label-primary, #1a1a1a); border-color: transparent; }
 .pt-card { background: var(--dsw-alias-bg-layer-1, #fff); border: 1px solid var(--dsw-alias-border-l2, #e2e2e2);
   border-radius: 16px; padding: 18px 20px; }
 .pt-card-row { display: flex; align-items: center; gap: 14px; justify-content: space-between; }
@@ -120,10 +117,12 @@ const STYLE = `
 .pt-badge-gated { color: #2563eb; }
 .pt-badge-done { color: #15803d; }
 .pt-badge-idle { color: var(--dsw-alias-label-secondary, #777); }
-.pt-input { width: 100%; border: 1px solid var(--dsw-alias-border-l2, #d8d8d8); border-radius: 12px;
+.pt-input { width: 100%; border: 1px solid var(--dsw-alias-border-l2, #d8d8d8); border-radius: 8px;
   background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #1a1a1a);
-  padding: 10px 14px; font-size: 15px; outline: none; }
-.pt-input:focus, .pt-rich:focus { border-color: var(--dsw-alias-accent, #4f7cff); }
+  padding: 8px 12px; font-size: 14px; outline: none; transition: border-color 140ms ease, box-shadow 140ms ease; }
+.pt-input::placeholder { color: var(--dsw-alias-label-caption, #888); }
+.pt-input:hover { border-color: var(--dsw-alias-border-l3, #c5c5c5); }
+.pt-input:focus, .pt-rich:focus { border-color: var(--dsw-alias-brand-primary, #4f7cff); box-shadow: 0 0 0 3px color-mix(in srgb, var(--dsw-alias-brand-primary, #4f7cff) 18%, transparent); }
 .pt-textarea { min-height: 90px; resize: vertical; }
 .pt-rich { min-height: 180px; max-height: 320px; overflow-y: auto; padding: 12px 14px; }
 .pt-rich:empty::before { content: attr(data-placeholder); color: var(--dsw-alias-label-caption, #999); }
@@ -206,7 +205,7 @@ const STYLE = `
 .pt-tab.active { background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #1a1a1a);
   border-color: var(--dsw-alias-accent, #4f7cff); }
 .pt-field { margin-bottom: 14px; }
-.pt-field-label { display: block; font-size: 13.5px; font-weight: 550; color: var(--dsw-alias-label-secondary, #666);
+.pt-field-label { display: block; font-size: 13.5px; font-weight: 500; color: var(--dsw-alias-label-primary, #1a1a1a);
   margin-bottom: 6px; }
 .pt-modal-backdrop { position: fixed; inset: 0; z-index: 60; background: rgba(0,0,0,.38);
   display: flex; align-items: center; justify-content: center; padding: 24px; }
@@ -368,13 +367,22 @@ const I18N = {
     send: 'Send', langLabel: 'Language', loading: 'Loading…',
   },
 }
-let savedLang = 'zh'
-try { savedLang = typeof localStorage !== 'undefined' ? localStorage.getItem('pictor-lang') : null } catch { /* 沙箱可能没有 storage */ }
+function readBandungLang() {
+  try {
+    if (typeof window !== 'undefined' && window.__dshAppDock__ && window.__dshAppDock__.lang) return window.__dshAppDock__.lang.get()
+    return typeof localStorage !== 'undefined' ? (localStorage.getItem('bandung-lang') === 'en' ? 'en' : 'zh') : 'zh'
+  } catch { return 'zh' }
+}
 const langStore = {
-  val: savedLang === 'en' ? 'en' : 'zh',
+  val: readBandungLang(),
   subs: new Set(),
   emit() { for (const f of this.subs) f() },
-  set(v) { this.val = v === 'en' ? 'en' : 'zh'; try { localStorage.setItem('pictor-lang', this.val) } catch { /* ignore */ } this.emit() },
+  set(v) {
+    this.val = v === 'en' ? 'en' : 'zh'
+    try { localStorage.setItem('bandung-lang', this.val) } catch { /* ignore */ }
+    if (typeof window !== 'undefined' && window.__dshAppDock__ && window.__dshAppDock__.lang) window.__dshAppDock__.lang.set(this.val)
+    this.emit()
+  },
   subscribe(f) { this.subs.add(f); return () => { this.subs.delete(f) } },
 }
 function useLang() {
@@ -387,16 +395,6 @@ function t(key, vars) {
   if (vars) { for (const k of Object.keys(vars)) text = text.replace('{' + k + '}', String(vars[k])) }
   return text
 }
-function LangSwitch() {
-  const lang = useLang()
-  const opt = (code, label) => h('button', {
-    className: 'pt-lang-opt' + (lang === code ? ' on' : ''),
-    onClick: () => langStore.set(code),
-  }, label)
-  return h('div', { className: 'pt-lang' },
-    h('span', { className: 'pt-lang-label' }, t('langLabel')),
-    h('div', { className: 'pt-lang-opts' }, opt('zh', '中文'), opt('en', 'English')))
-}
 
 // ---------- 工具 ----------
 
@@ -487,10 +485,23 @@ function sanitizePaste(html) {
 // 会话创建与驱动走 dsh 的 workspace 流程（照 pomasa 的 driveSession）：
 // 宿主只出 prompt，客户端经 workspaces.connectWorkspace 建会话（自然归入
 // 「Pictor」工作区、继承 profile 默认模型），再经 sessions.prompt 驱动。
+// dsh ≥ 0.1.2-alpha.1（DSH Desktop 0.7.2）把 connectWorkspace 从
+// `workspaces` 服务移到了 `uiWorkspace` 服务上：这里两个形态都尝试，哪个
+// 在就调哪个，老版本前端不受影响。
+function sessionConnectFn(ctx, ws) {
+  let uiWs = null
+  try { uiWs = ctx.uiWorkspace || ((ctx.get && ctx.get('uiWorkspace')) || null) } catch { /* ignore */ }
+  return (uiWs && typeof uiWs.connectWorkspace === 'function')
+    ? uiWs.connectWorkspace.bind(uiWs)
+    : (ws && typeof ws.connectWorkspace === 'function') ? ws.connectWorkspace.bind(ws) : null
+}
+
 async function pictorWorkspace(ctx) {
   const ws = ctx.workspaces || (ctx.get && ctx.get('workspaces'))
   const base = await rpc(ctx, 'config.get').then((c) => (c && c.dataRoot) || '')
-  if (!ws || typeof ws.connectWorkspace !== 'function') throw new Error('会话服务不可用（workspaces）')
+  // 这里只用 list/create/delete/rename，新旧 services 都有；connectWorkspace
+  // 的可用性由 driveProjectSession 检查。
+  if (!ws) throw new Error('会话服务不可用（workspaces）')
   const items = () => {
     try {
       const snap = ws.list && typeof ws.list.getSnapshot === 'function' ? ws.list.getSnapshot() : null
@@ -531,14 +542,29 @@ async function pictorWorkspace(ctx) {
 async function driveProjectSession(ctx, prompt) {
   const ws = ctx.workspaces || (ctx.get && ctx.get('workspaces'))
   const sessionsSvc = ctx.sessions || (ctx.get && ctx.get('sessions'))
+  const connect = sessionConnectFn(ctx, ws)
+  const canCreate = !!(sessionsSvc && typeof sessionsSvc.create === 'function')
+  if (!(connect || canCreate) || !(sessionsSvc && typeof sessionsSvc.binding === 'function')) {
+    let uiWs = null
+    try { uiWs = ctx.uiWorkspace || ((ctx.get && ctx.get('uiWorkspace')) || null) } catch { /* ignore */ }
+    const diag = { ws: !!ws, ses: !!sessionsSvc && typeof sessionsSvc.binding === 'function', uiws: !!uiWs, conn: !!connect, create: canCreate }
+    console.warn('[pictor] session services unavailable', diag)
+    try { window.__pictor_diag = diag } catch { /* ignore */ }
+    try { pictorDiag(ctx, 'drive:fail') } catch { /* ignore */ }
+    throw new Error(`会话服务不可用（workspaces） [ws:${diag.ws},ses:${diag.ses},uiws:${diag.uiws},conn:${diag.conn},create:${diag.create}]`)
+  }
   const wid = await pictorWorkspace(ctx)
   let sessionId
-  try { sessionId = await ws.connectWorkspace(wid) }
+  try {
+    const created = connect ? await connect(wid) : await sessionsSvc.create({ workspaceId: wid })
+    sessionId = created && typeof created === 'object' && created.id ? created.id : created
+  }
   catch (e) { throw new Error('创建会话失败：' + String((e && e.message) || e)) }
   const bound = sessionsSvc && typeof sessionsSvc.binding === 'function' ? sessionsSvc.binding(sessionId) : null
   const sess = bound && bound.session
   if (!sess || typeof sess.prompt !== 'function') throw new Error('会话无 prompt 通道')
   await sess.prompt([{ type: 'text', text: String(prompt || '') }], 'queue')
+  try { pictorDiag(ctx, 'drive:ok') } catch { /* ignore */ }
   return sessionId
 }
 
@@ -945,7 +971,17 @@ function fileSlug(s) {
   return String(s || '').toLowerCase().trim().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40) || 'infographic'
 }
 
-function ResultsPanel({ outputs, images, renderErrors, proposals, lay, renderBatches }) {
+// 结果图直出走同源 HTTP（data URL 在新版 DSH Desktop WebView 可能被拦），
+// 失败时回退到 RPC 返回的 data URL。
+const imgUrlFor = (projectId, name) => {
+  const base = '/pictor/asset/project/' + encodeURIComponent(projectId) + '/' + encodeURIComponent(name)
+  try {
+    const tok = new URLSearchParams(window.location.search || '').get('token')
+    return tok ? base + '?token=' + encodeURIComponent(tok) : base
+  } catch { return base }
+}
+
+function ResultsPanel({ projectId, outputs, images, renderErrors, proposals, lay, renderBatches }) {
   const [big, setBig] = React.useState(null)
   const [collapsed, setCollapsed] = React.useState({})
   if (!outputs.length && !renderErrors.length) {
@@ -967,7 +1003,7 @@ function ResultsPanel({ outputs, images, renderErrors, proposals, lay, renderBat
         h('div', null, h('h3', { className: 'pt-option-title', style: { margin: 0 } }, bigInfo.title)),
         h('button', { className: 'pt-modal-close', onClick: () => setBig(null), title: t('close'), 'aria-label': t('close') }, '×')),
       h('div', { className: 'pt-modal-body', style: { textAlign: 'center' } },
-        h('img', { src: images[big], alt: bigInfo.title, style: { maxWidth: '100%', maxHeight: '70vh', borderRadius: 10 } }),
+        h('img', { src: imgUrlFor(projectId, big), alt: bigInfo.title, style: { maxWidth: '100%', maxHeight: '70vh', borderRadius: 10 }, onError: (e) => { if (e && e.currentTarget) e.currentTarget.src = images[big] } }),
         bigInfo.actualLayout ? h('p', { className: 'pt-meta', style: { marginTop: 10 } }, t('layoutLabel') + ': ' + layoutLabel(bigInfo.actualLayout)) : null)))
     : null
 
@@ -991,7 +1027,7 @@ function ResultsPanel({ outputs, images, renderErrors, proposals, lay, renderBat
     const dlName = info.prop ? (fileSlug(info.prop.title || layoutLabel(info.actualLayout || info.prop.suggested_layout)) + '-' + info.pid + '.png') : name
     return h('figure', { key: name, className: 'pt-img-card' },
       images[name]
-        ? h('img', { className: 'pt-img', src: images[name], alt: info.title, style: { cursor: 'zoom-in' }, onClick: () => setBig(name) })
+        ? h('img', { className: 'pt-img', src: imgUrlFor(projectId, name), alt: info.title, style: { cursor: 'zoom-in' }, onClick: () => setBig(name), onError: (e) => { if (e && e.currentTarget) e.currentTarget.src = images[name] } })
         : h('div', { className: 'thumb', style: { width: '100%', height: 140 } }),
       h('figcaption', null,
         h('div', { className: 'pt-fig-title' }, info.title),
@@ -1405,7 +1441,7 @@ function DetailPane(props) {
       ratios, setRatio, onRender: renderSelected, renderBusy,
       hasImageKey: Boolean(imageCfg && imageCfg.hasKey), running: Boolean(data.running),
       renderState: data.renderState, renderRunning: Boolean(data.renderRunning) }),
-    render: h(ResultsPanel, { outputs: data.outputs, images, renderErrors, proposals, lay: layOv, renderBatches: data.renderBatches }),
+    render: h(ResultsPanel, { projectId, outputs: data.outputs, images, renderErrors, proposals, lay: layOv, renderBatches: data.renderBatches }),
   }[step]
 
   return h('div', null,
@@ -1628,7 +1664,7 @@ function Workbench(props) {
       h('button', { className: 'pt-nav-settings', onClick: () => setView('settings') },
         h('span', { className: 'glyph' }, '⚙'),
         t('navSettings')),
-      h(LangSwitch, null)))
+      ))
 
   return h('div', { className: 'pt-root pt-workbench' },
     nav,
@@ -1670,7 +1706,30 @@ function selectedLabel(ids) {
   return ids.join('、')
 }
 
+// 最佳努力诊断：上报此 ctx 上工作区/会话服务的暴露情况（DSH Desktop 0.7.2
+// 调整了客户端 API），host 落盘 ~/.pictor/diag.jsonl，无需 DevTools 即可排查。
+function pictorDiag(ctx, phase) {
+  let ws = null, ses = null, ui = null
+  try { ws = ctx && (ctx.workspaces || (ctx.get && ctx.get('workspaces'))) } catch { /* ignore */ }
+  try { ses = ctx && (ctx.sessions || (ctx.get && ctx.get('sessions'))) } catch { /* ignore */ }
+  try { ui = ctx && (ctx.uiWorkspace || (ctx.get && ctx.get('uiWorkspace'))) } catch { /* ignore */ }
+  const body = {
+    phase,
+    ws: !!ws, ses: !!ses, ui: !!ui,
+    wsMethods: ws ? Object.keys(ws).slice(0, 40) : null,
+    sesMethods: ses ? Object.keys(ses).slice(0, 40) : null,
+    uiMethods: ui ? Object.keys(ui).slice(0, 40) : null,
+    connectWs: !!(ws && typeof ws.connectWorkspace === 'function'),
+    connectUi: !!(ui && typeof ui.connectWorkspace === 'function'),
+    bind: !!(ses && typeof ses.binding === 'function'),
+    href: typeof location !== 'undefined' ? location.href.slice(0, 80) : '',
+  }
+  try { fetch('/pictor/diag', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) }).catch(() => {}) } catch { /* ignore */ }
+  console.warn('[pictor] diag', body)
+}
+
 function apply(ctx) {
+  try { pictorDiag(ctx, 'apply') } catch { /* ignore */ }
   console.info('[dsh-pictor] apply 被调用', { hasSlots: Boolean(ctx && ctx.slots) })
   if (typeof document !== 'undefined') {
     const styleId = 'dsh-pictor-style'
@@ -1690,12 +1749,12 @@ function apply(ctx) {
   panel.close = () => { if (panel.open) { panel.open = false; panel.emit() } }
   panel.subscribe = (fn) => { panel.subs.add(fn); return () => { panel.subs.delete(fn) } }
   // 点选 dsh 左侧会话（或面板外任意处）自动收起工作台：
-  // 只排除面板本身与 Pictor 启动按钮；侧栏会话此刻在面板左侧始终可点。
+  // 只排除面板本身；侧栏会话此刻在面板左侧始终可点（入口已交给应用坞）。
   if (typeof document !== 'undefined') {
     document.addEventListener('mousedown', (e) => {
       if (!panel.open) return
       const t = e.target
-      if (t && typeof t.closest === 'function' && (t.closest('.pt-shell-panel') || t.closest('.pt-footer-action'))) return
+      if (t && typeof t.closest === 'function' && t.closest('.pt-shell-panel')) return
       panel.close()
     })
   }
@@ -1737,24 +1796,22 @@ function apply(ctx) {
         h(Workbench, { ctx, key: 'shell' })))
   }
 
-  function FooterAction() {
-    useLang() // footer 文案随语言刷新
-    const open = usePanelOpen()
-    return h('div', {
-      className: 'pt-footer-action' + (open ? ' on' : ''),
-      role: 'button',
-      tabIndex: 0,
-      onClick: () => panel.toggle(),
-      onKeyDown: (e) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); panel.toggle() } },
-      title: open ? t('close') : t('open'),
-      'aria-expanded': open ? 'true' : 'false',
-    }, h('span', { className: 'glyph' }, '◈'), 'Pictor')
+  // 入坞：dsh-app-dock 是依赖，入口交给坞（含 ready 延迟注册），自占 footer 槽移除。
+  const registerWithDock = () => {
+    if (typeof window === 'undefined' || !window.__dshAppDock__) return
+    window.__dshAppDock__.register({ id: 'dsh-pictor', label: 'Pictor', icon: '◈', order: 20, onToggle: () => panel.toggle() })
+    if (window.__dshAppDock__.lang) {
+      window.__dshAppDock__.lang.subscribe(() => {
+        const v = window.__dshAppDock__.lang.get()
+        if (langStore.val !== v) { langStore.val = v; langStore.emit() }
+      })
+    }
   }
+  if (typeof window !== 'undefined' && !window.__dshAppDock__) {
+    window.addEventListener('dsh-app-dock:ready', registerWithDock, { once: true })
+  }
+  registerWithDock()
 
-  slots.inject('sidebar.footer.action', () => slots.register(
-    { name: 'sidebar.footer.action', id: 'dsh-pictor', order: 20, label: 'Pictor' },
-    () => h(FooterAction, null),
-  ))
   slots.inject('shell.overlay', () => slots.register(
     { name: 'shell.overlay', id: 'dsh-pictor', order: 10, label: 'Pictor' },
     () => h(WorkbenchPanel, null),

package/lib/index.js

@@ -702,6 +702,52 @@ function apply(ctx, config = {}) {
         } });
       }
     }
+    const PREFIX = "/pictor/asset/project";
+    wsA.register({ kind: "prefix", path: PREFIX, handler: (req, res) => {
+      try {
+        const pathname = new URL(req.url || "/", "http://x").pathname;
+        const rest = pathname.slice(PREFIX.length + 1);
+        const slash = rest.indexOf("/");
+        if (slash <= 0) {
+          res.writeHead(404);
+          res.end("not found");
+          return;
+        }
+        const id = rest.slice(0, slash);
+        const file = rest.slice(slash + 1);
+        if (id.includes("..") || /[\\/]/.test(id) || !/^[0-9a-zA-Z_.-]+$/.test(file) || !file.endsWith(".png")) {
+          res.writeHead(400);
+          res.end("bad request");
+          return;
+        }
+        const buf = readFileSync(join(projectDir(id), "output", file));
+        res.writeHead(200, { "content-type": "image/png", "cache-control": "public, max-age=300" });
+        res.end(buf);
+      } catch {
+        res.writeHead(404);
+        res.end("not found");
+      }
+    } });
+    wsA.register({ kind: "exact", path: "/pictor/diag", handler: (req, res) => {
+      let body = "";
+      try {
+        req.on("data", (c) => {
+          body += c;
+        });
+        req.on("end", () => {
+          try {
+            mkdirSync(base, { recursive: true });
+            appendFileSync(join(base, "diag.jsonl"), JSON.stringify({ t: Date.now(), ...JSON.parse(body || "{}") }) + "\n");
+          } catch {
+          }
+          res.writeHead(204);
+          res.end();
+        });
+      } catch {
+        res.writeHead(204);
+        res.end();
+      }
+    } });
   }
   return { dataRoot: base };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pictor",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Pictor：文档转信息图工作台。每项目一个连贯 dsh 会话，GUI 为 shell.overlay 工作台（左栏项目、右栏三步：提取/方案/渲染），行为全部交给 DSH 智能运行时。",
   "type": "module",
   "repository": {
@@ -46,17 +46,24 @@
     "docs",
     "README.md",
     "LICENSE",
-    "assets"
+    "assets",
+    "NOTICE.md"
   ],
   "scripts": {
     "build": "node scripts/build.mjs",
     "verify": "node scripts/build.mjs && node verify.mjs",
     "verify:integration": "bash scripts/transport-smoke.sh",
+    "test:pack": "bash scripts/package-integrity.sh",
+    "test:install": "bash scripts/install-smoke.sh",
+    "hooks:install": "git config core.hooksPath .githooks",
     "test:e2e": "playwright test --config e2e/playwright.config.ts --project chromium",
     "verify:live": "playwright test --config e2e/playwright.config.ts --project live",
     "prepare": "node scripts/build.mjs"
   },
   "license": "MIT",
+  "dependencies": {
+    "dsh-app-dock": "^0.1.2"
+  },
   "peerDependencies": {
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",