dsh-wisp 0.6.0

package/lib/index.js

@@ -0,0 +1,19 @@
+// Host half of @local/dsh-wisp.
+//
+// This plugin deliberately does nothing on the host side. Everything the wisp
+// needs is already available in the browser: the client builtins provide React,
+// a package-owned stylesheet inserter, and the live Slot tree. Keeping the host
+// half empty means the plugin needs no peer dependencies at all, so it loads on
+// a stock DSH desktop install whose profile has an empty `dependencies` map.
+//
+// If you later want the wisp to react to host-side facts (model, token usage,
+// job state), add a `host.call` handler here and a matching `host.call(...)`
+// from lib/client.js.
+
+export const name = 'wisp'
+
+export function apply() {
+  // Intentionally empty — see the note above.
+}
+
+export default { name, apply }

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "dsh-wisp",
+  "version": "0.6.0",
+  "description": "DeepSeek娘 — an unofficial floating desktop companion for the DeepSeek Harness UI. Zero dependencies; sprites inlined as data URIs; schedules on the Client timer service instead of the trapped browser timer globals.",
+  "type": "module",
+  "main": "lib/index.js",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis-plugin",
+    "desktop-companion",
+    "desktop-pet",
+    "deepseek-chan"
+  ],
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/client.template.js",
+    "cordis.patch.yml",
+    "build.mjs",
+    "verify-wisp.mjs",
+    "tools/keyout.mjs",
+    "tools/assets.mjs",
+    "tools/CHARACTER-PROMPT.md",
+    "assets/",
+    "README.md",
+    "NOTICE.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node build.mjs",
+    "verify": "node verify-wisp.mjs",
+    "test": "node build.mjs && node verify-wisp.mjs",
+    "prepublishOnly": "node build.mjs && node verify-wisp.mjs"
+  },
+  "dependencies": {},
+  "peerDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/969246694/dsh-wisp.git"
+  },
+  "homepage": "https://github.com/969246694/dsh-wisp#readme",
+  "bugs": {
+    "url": "https://github.com/969246694/dsh-wisp/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "title": {
+        "en": "DeepSeek-chan",
+        "zh": "DeepSeek娘"
+      }
+    }
+  }
+}

package/tools/CHARACTER-PROMPT.md

@@ -0,0 +1,88 @@
+# 角色提示词（可复用母版）
+
+**这是本插件形象的唯一权威来源。** 改形象 = 改这里 + 重跑生成 + `node tools/assets.mjs`。
+每次出图必须**逐字复制**下面的段落，只替换【姿态】那一节 —— 形象靠提示词锚定，不能靠参考图。
+
+---
+
+## 生成参数（每一张都必须一致）
+
+| 参数 | 值 |
+|---|---|
+| `model` | `"gpt"` |
+| `resolution` | `"4K"` |
+| `target_size` | `"2048x3072"` |
+| `aspect_ratio` | `"2:3"` |
+| `quality` | `"high"` |
+| `thinking_level` | `"high"` |
+| `transparent` | **省略（即 false）** ← 见下方「为什么不用透明背景」 |
+| 调用方式 | **一张素材一次调用**，不要在 batch 里混多张 |
+| 参考图 | **绝对不传**（`reference_image` / `reference_images` 都不传） |
+| 一张图里几个角色 | **只有一个**，提示词里必须写明 |
+
+---
+
+## 提示词正文（逐字复制）
+
+```
+一位留着深蓝色超长双马尾的成年女性：两条深蓝色马尾又长又粗、从头顶两侧一直垂到大腿两侧，必须完整画出来；发梢渐变为浅蓝；齐刘海，两侧鬓发垂到肩下。
+
+身后从腰部长出一条蓝色鲸尾，尾鳍自然向下，必须在画面中清楚可见。
+
+宝蓝色大眼睛；头顶戴白色荷叶边女仆发箍，发箍上别一枚蓝色鲸鱼造型发夹，耳侧有鲸鱼鳍造型耳饰；颈部一条细蓝色颈饰。
+
+【体型】成年女性的成熟身型：高挑、长腿、细腰，肩颈与锁骨线条优美，曲线明显但不夸张。
+
+【服装】性感的单薄女仆装：深蓝色一字肩细吊带连衣短裙，单层，低领口露出锁骨与肩线；裙摆极短、单层、自然垂落，露出一整条腿；身前罩一件单层白色半身围裙，围裙的荷叶边是深蓝色，围裙带在腰后系成一个深蓝色蝴蝶结；不穿长袜，直接露出双腿；脚穿白色细带高跟凉鞋。
+
+【画风】高质量的现代二次元插画，商业级插画精度：精细的线稿，高密度分明的发丝刻画，眼睛有多层高光与渐变瞳孔，皮肤与布料用柔和细腻的多层过渡阴影与通透的配色，光影层次丰富。保持二次元的动漫面部与身材比例（大而亮的眼睛、小巧的鼻与嘴）。不要照片写实、不要三维渲染感、不要粗糙平涂、不要塑料感。
+
+【姿态】__按情绪替换，见下表__
+
+【画面完整性】画面中只有一个角色。头发必须是深蓝色超长双马尾，不要画成短发、不要盘发、不要白色头发；鲸尾必须可见且与身体连接；发尾干净完整；手指完整；五官清晰。
+
+【背景】纯绿色背景（绿幕）：整张背景是一整片均匀的纯绿色，没有任何渐变、纹理、阴影或其他物体；角色完全被纯绿色包围，不要在地面投下阴影。
+
+【构图】全身直立、脚底贴住画面底边、角色居中。
+```
+
+## 【姿态】四选一（对应四个 sprite）
+
+| 文件 | 姿态 |
+|---|---|
+| `idle.png` | 一手叉腰、一腿微屈、身体微微侧倾，自信而妩媚地看向镜头，嘴角含笑。 |
+| `happy.png` | 双手举在身体两侧欢呼，闭着眼睛开心大笑，脸颊微红，身体微微后仰。 |
+| `sleepy.png` | 怀里抱着一只蓝色鲸鱼抱枕，抱在胸腹前；半闭着眼睛打盹，困倦地微微低头。 |
+| `work.png` | 一手托着一台打开的笔记本电脑，另一手在键盘上打字，认真专注地看着屏幕。 |
+
+---
+
+## 为什么不用透明背景
+
+服务端的 `transparent: true` **会把不该抠的抠掉**：角色是深蓝/浅蓝/白配色，浅蓝渐变的**发梢**与
+**鲸尾**最接近浅色底，于是被当成背景切掉 —— 表现是「生成结果变成了短发、鲸尾消失」，极易误判成
+模型跑形。实测同一批提示词走服务端透明背景时四张全部丢失发梢与鲸尾。
+
+所以：**出图用绿幕，抠图自己做**（`node tools/assets.mjs`），只有 0.4%–0.7% 的边缘像素需要处理，
+发丝一根不丢。
+
+## 三个踩过的坑
+
+1. **绿幕要求必须写在第一段**，否则模型可能改画黑底 —— 四角实测 `rgb(0,0,0)`，抠图直接失效。
+   若 `assets.mjs` 报「键控几乎无效」，就是这张没听话，重出即可。
+2. **不要写「高质量二次元插画」这种笼统说法**，它会推向韩系半写实（头发变短、体型成熟化），
+   角色设定随之崩掉；必须写成「商业级二次元插画 + 二次元的动漫面部与身材比例 + 不要照片写实/
+   三维渲染感/粗糙平涂」。
+3. **不要把「少女体型」和「性感」写在一起。** 当前设定是**成年女性**；这一点不要在改服装时改掉。
+
+## 全流程
+
+```bash
+# 1. 按上面的参数与提示词，为四个情绪各生成一张绿幕图，存成 <mood>.png
+# 2. 绿幕 -> 抠图 -> 四档素材，一步到位
+node tools/assets.mjs --from <绿幕母版目录>
+# 3. 把素材打进客户端半包
+node build.mjs --tier=hi        # hi 档 = 2048x3072，与母版同尺寸，仅重新编码
+# 4. 预检
+node verify-wisp.mjs
+```

package/tools/assets.mjs

@@ -0,0 +1,139 @@
+/* ============================================================================
+   assets.mjs — 一条命令把"绿幕母版"变成可入包的素材。
+
+   输入：一个目录，里面是四张绿幕母版 <mood>.png（2048x3072，纯绿背景）
+   输出：assets/ 下的四档素材
+           <mood>.webp      1024x1536  默认档
+           <mood>_md.webp    512x768
+           <mood>_sm.webp    256x384
+           <mood>_hi.webp   2048x3072  与母版同尺寸，仅重新编码
+
+   每一步都会报告键控质量；任何一张的键控异常都会让整条命令以非 0 退出，
+   避免"某一张没抠干净"悄悄混进包里 —— 这种错误很难从最终效果反推。
+
+   RUN
+     node tools/assets.mjs --from ./绿幕母版
+     node tools/assets.mjs --from ./绿幕母版 --out ./assets
+   ========================================================================== */
+
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const require = createRequire(import.meta.url)
+
+function loadSharp() {
+  const dir = process.env.DSH_PROFILE_DIR
+  const candidates = [
+    process.env.WISP_SHARP,
+    dir ? join(dir, '..', 'node_modules', 'sharp') : null,
+    'sharp',
+  ].filter(Boolean)
+  for (const c of candidates) {
+    try { return require(c) } catch (e) { /* 试下一个 */ }
+  }
+  throw new Error('找不到 sharp：请设置环境变量 WISP_SHARP 指向 sharp 包目录')
+}
+
+const argv = process.argv.slice(2)
+const flag = (name, fallback) => {
+  const at = argv.indexOf(name)
+  return at >= 0 && argv[at + 1] !== undefined ? argv[at + 1] : fallback
+}
+const MOODS = ['idle', 'happy', 'sleepy', 'work']
+const srcDir = resolve(here, flag('--from', 'masters'))
+const outDir = resolve(here, flag('--out', 'assets'))
+
+const T0 = 14
+const T1 = 96
+const TIERS = [
+  { suffix: '', w: 1024, q: 84 },
+  { suffix: '_md', w: 512, q: 82 },
+  { suffix: '_sm', w: 256, q: 80 },
+  { suffix: '_hi', w: 2048, q: 86 },
+]
+
+if (!existsSync(srcDir)) {
+  console.error(`母版目录不存在: ${srcDir}`)
+  process.exit(1)
+}
+for (const mood of MOODS) {
+  if (!existsSync(join(srcDir, `${mood}.png`))) {
+    console.error(`缺少母版: ${join(srcDir, `${mood}.png`)}`)
+    process.exit(1)
+  }
+}
+mkdirSync(outDir, { recursive: true })
+
+const sharp = loadSharp()
+const kb = (n) => `${(n / 1024).toFixed(0)} KB`
+let failed = 0
+
+/** 绿幕键控：返回 { png, opaque, soft } 或抛错。 */
+async function key(srcPath, outPath) {
+  const { data, info } = await sharp(srcPath).ensureAlpha().raw().toBuffer({ resolveWithObject: true })
+  const { width: W, height: H, channels } = info
+  if (channels !== 4) throw new Error(`期望 4 通道，实得 ${channels}`)
+  const px = Buffer.alloc(W * H * 4)
+  let opaque = 0
+  let soft = 0
+  for (let i = 0, p = 0; i < W * H; i++, p += 4) {
+    const r = data[p]
+    const g = data[p + 1]
+    const b = data[p + 2]
+    let a = 1 - ((g - Math.max(r, b)) - T0) / (T1 - T0)
+    a = a < 0 ? 0 : a > 1 ? 1 : a
+    if (a >= 1) opaque++
+    else if (a > 0) { soft++; data[p + 1] = Math.min(g, Math.max(r, b)) }
+    px[p] = data[p]
+    px[p + 1] = data[p + 1]
+    px[p + 2] = b
+    px[p + 3] = Math.round(a * 255)
+  }
+  const opaqueRatio = opaque / (W * H)
+  const softRatio = soft / (W * H)
+  if (opaqueRatio > 0.9) throw new Error(`键控几乎无效（不透明 ${(opaqueRatio * 100).toFixed(1)}%）—— 这张多半不是绿幕底`)
+  if (softRatio > 0.05) throw new Error(`半透明边缘占比 ${(softRatio * 100).toFixed(1)}% 过高 —— 源图可能不是干净绿幕`)
+  await sharp(px, { raw: { width: W, height: H, channels: 4 } }).png().toFile(outPath)
+  return { opaque: opaqueRatio, soft: softRatio, w: W, h: H }
+}
+
+console.log(`母版: ${srcDir}\n出图: ${outDir}\n`)
+console.log('mood    键控(不透明/边缘)      档位      尺寸         体积')
+for (const mood of MOODS) {
+  const src = join(srcDir, `${mood}.png`)
+  const keyed = join(outDir, `.${mood}.keyed.png`)
+  let meta
+  try {
+    meta = await key(src, keyed)
+  } catch (error) {
+    failed++
+    console.error(`  ${mood.padEnd(7)} 抠图失败: ${error.message}`)
+    continue
+  }
+  for (const tier of TIERS) {
+    const out = join(outDir, `${mood}${tier.suffix}.webp`)
+    await sharp(keyed)
+      .resize(tier.w, Math.round(tier.w * 1.5), { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+      .webp({ quality: tier.q, alphaQuality: 92, effort: 6 })
+      .toFile(out)
+  }
+  console.log(
+    `  ${mood.padEnd(7)} ${(meta.opaque * 100).toFixed(1)}% / ${(meta.soft * 100).toFixed(2)}%`.padEnd(30),
+    (TIERS[0].suffix || '默认').padEnd(8),
+    `${Math.round(meta.w / 2)}x${Math.round(meta.h / 2)}`.padEnd(13),
+    kb(statSync(join(outDir, `${mood}.webp`)).size),
+  )
+  // 中间产物不留：它是全尺寸 PNG，四张能占几十 MB
+  writeFileSync(keyed, '')
+  const { rmSync } = await import('node:fs')
+  rmSync(keyed, { force: true })
+}
+
+if (failed > 0) {
+  console.error(`\n${failed} 张母版抠图失败 —— 素材未更新，请检查这些图是否是干净的纯绿背景。`)
+  process.exit(1)
+}
+console.log('\n完成。接着跑 `node build.mjs`（默认就用 <mood>.webp 那一档，要用 4K 档加 --tier=hi）。')

package/tools/keyout.mjs

@@ -0,0 +1,104 @@
+/* ============================================================================
+   keyout.mjs — 绿幕抠图（单张）。
+
+   为什么不用服务端的透明背景：它会把浅蓝渐变的发梢与鲸尾当成浅色背景切掉，
+   表现成"生成结果变成了短发、鲸尾消失"，极易误判成模型跑形。绿幕不存在这种
+   歧义：角色是深蓝/浅蓝/白配色，与纯绿没有色相重叠，所以可以做得比通用抠图
+   保守得多。
+
+   原理：以"绿色占优量" g - max(r, b) 作为键控信号，线性映射成 alpha，
+   并对半透明像素做绿色溢出抑制（把 g 压到 max(r,b)），避免发丝边缘泛绿。
+
+   RUN
+     node tools/keyout.mjs <绿幕图.png> <输出.png>
+     node tools/keyout.mjs in.png out.png --t0 14 --t1 96     # 调宽容忍度
+   ========================================================================== */
+
+import { createRequire } from 'node:module'
+import { join } from 'node:path'
+
+const require = createRequire(import.meta.url)
+
+/** sharp 不在插件包里（插件本体零依赖），从 DSH profile 的 node_modules 取。 */
+function loadSharp() {
+  const dir = process.env.DSH_PROFILE_DIR
+  const candidates = [
+    process.env.WISP_SHARP,
+    dir ? join(dir, '..', 'node_modules', 'sharp') : null,
+    'sharp',
+  ].filter(Boolean)
+  for (const c of candidates) {
+    try { return require(c) } catch (e) { /* 试下一个 */ }
+  }
+  throw new Error('找不到 sharp：请设置环境变量 WISP_SHARP 指向 sharp 包目录')
+}
+
+const argv = process.argv.slice(2)
+const flag = (name, fallback) => {
+  const at = argv.indexOf(name)
+  return at >= 0 && argv[at + 1] !== undefined ? Number(argv[at + 1]) : fallback
+}
+const paths = argv.filter((a) => !a.startsWith('--') && !/^[\d.]+$/.test(a))
+const [inPath, outPath] = paths
+
+if (!inPath || !outPath) {
+  console.error('用法: node tools/keyout.mjs <绿幕图.png> <输出.png> [--t0 14] [--t1 96]')
+  process.exit(1)
+}
+
+// 判定为「绿」的占优阈值：< T0 完全不透明，> T1 完全透明
+const T0 = flag('--t0', 14)
+const T1 = flag('--t1', 96)
+
+const sharp = loadSharp()
+const { data, info } = await sharp(inPath).ensureAlpha().raw().toBuffer({ resolveWithObject: true })
+const { width: W, height: H, channels } = info
+if (channels !== 4) throw new Error(`期望 4 通道，实得 ${channels}`)
+
+const out = Buffer.alloc(W * H * 4)
+let opaque = 0
+let clear = 0
+let soft = 0
+let minX = W, minY = H, maxX = -1, maxY = -1
+
+for (let i = 0, p = 0; i < W * H; i++, p += 4) {
+  const r = data[p]
+  const g = data[p + 1]
+  const b = data[p + 2]
+  const dom = g - Math.max(r, b)
+  let a = 1 - (dom - T0) / (T1 - T0)
+  a = a < 0 ? 0 : a > 1 ? 1 : a
+  if (a >= 1) opaque++
+  else if (a <= 0) clear++
+  else {
+    soft++
+    data[p + 1] = Math.min(g, Math.max(r, b))   // 去绿边
+  }
+  out[p] = data[p]
+  out[p + 1] = data[p + 1]
+  out[p + 2] = b
+  out[p + 3] = Math.round(a * 255)
+  if (a > 0.5) {
+    const x = i % W
+    const y = (i - x) / W
+    if (x < minX) minX = x
+    if (x > maxX) maxX = x
+    if (y < minY) minY = y
+    if (y > maxY) maxY = y
+  }
+}
+
+await sharp(out, { raw: { width: W, height: H, channels: 4 } }).png().toFile(outPath)
+
+const pct = (n) => `${(n / (W * H) * 100).toFixed(2)}%`
+console.log(`${inPath.split(/[\\/]/).pop()} -> ${outPath.split(/[\\/]/).pop()}`)
+console.log(`  不透明 ${pct(opaque)}  半透明边缘 ${pct(soft)}  全透明 ${pct(clear)}`)
+if (maxX < 0) {
+  console.error('  警告：整张图都被判成背景，输出是全透明的 —— 多半是这张图不是绿幕底')
+  process.exit(2)
+}
+console.log(`  角色范围 x ${minX}..${maxX} (${((maxX - minX + 1) / W * 100).toFixed(1)}% 宽)  y ${minY}..${maxY} (${((maxY - minY + 1) / H * 100).toFixed(1)}% 高)`)
+if (soft / (W * H) > 0.05) {
+  console.error('  警告：半透明边缘占比过高，源图可能不是干净的绿幕')
+  process.exit(2)
+}