dsh-feiyu-image 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# 更新记录
+
+## 0.1.1
+
+- 画风改成二次元（日系动画、赛璐璐上色）；
+- 角色形象锁定：固定「角色设定」每次一字不差带上 + 固定 `seed`，跨场景保持同一个人；
+- 角色设定图存 `~/.dsh/feiyu-image/角色-设定.png`（不计入每日张数）；
+- 实测该接口不接受图片输入，所以改用文字设定 + seed 锁脸，README 里写清了边界。
+
+## 0.1.0
+
+- 首个版本：`shoot` 工具（selfie / scene），调百炼 Token Plan 生图；
+- 提示词自动拼接外观、此刻穿着（联动 `dsh-feiyu-life`）、场景、光线、风格；
+- 出图落盘 `~/.dsh/feiyu-image/`，带每日上限与最短间隔；
+- 生图失败返回原因，不阻塞对话。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vansnc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+# dsh-feiyu-image
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/dsh-feiyu-image)](https://www.npmjs.com/package/dsh-feiyu-image)
+[![license](https://img.shields.io/npm/l/dsh-feiyu-image)](./LICENSE)
+[![node](https://img.shields.io/badge/node-%E2%89%A522-informational)](https://nodejs.org/)
+
+给陪伴角色一个相机：模型调一个工具就能「拍一张」，**自动带上她此刻的穿着和所在场景**，
+存成本地图片，回复里写 `![描述](路径)` 就能发到 QQ。
+
+生图走 **阿里百炼 Token Plan**（`wan2.7-image`，compatible-mode `chat/completions`，回图片 URL，2048×2048）。
+画风是**二次元**（日系动画、赛璐璐上色），角色长相靠「固定设定 + 固定 seed」钉住。
+
+## 为什么不是 dsh-image-studio
+
+[dsh-image-studio](https://github.com/meliodascz89/dsh-image-studio) 停在 0.1.7（2026-08），
+依赖 `@deepseek-ai/dsh-tools ^0.1.0-rc.6`、`dsh-settings ^0.1.1-rc.2`，跟 dsh 0.2.x 不兼容，
+要装得给确切版本盖豁免（可能崩、可能丢数据）。而这里真正有用的只有一个工具，就自己写了。
+
+## 能力
+
+| 工具 | 说明 |
+| --- | --- |
+| `shoot` | `提示`（可选，画面里还想要什么）+ `类型`（`selfie` 自拍 / `scene` 只拍场景）→ 生成并保存 |
+
+- 提示词自动拼：**固定角色设定**（配置，一字不差每次带上）+ 此刻穿着（读 `dsh-feiyu-life` 的今日剧本）+ 场景 + 光线 + 画风；
+- 固定 `seed`，同一个角色跨场景保持同一张脸（发色、发型、瞳色、鲸鱼发夹、卫衣）；
+- 出图存 `~/.dsh/feiyu-image/feiyu-<时间戳>.png`；
+- 节流：默认每天 8 张、两次至少隔 30 秒（配置可调）；
+- 生图失败会返回原因，不会卡住整轮对话。
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-feiyu-image
+```
+
+需要 `~/.dsh/bailian-tp/config.json`（Token Plan 的 key 和 base，跟 `bailian-tp` 插件共用）。
+
+## 配置
+
+`~/.dsh/feiyu-image-config.json`（没有就用默认）：
+
+```json
+{
+  "总开关": true,
+  "模型": "wan2.7-image",
+  "外观": "中国大陆 21 岁女大学生，素颜淡妆，黑色齐肩发，皮肤偏白，身形偏瘦",
+  "风格": "手机随手拍，自然光，轻微胶片颗粒，真实质感，不过度磨皮",
+  "每日上限": 8,
+  "最短间隔秒": 30,
+  "存图目录": ""
+}
+```
+
+## 用法
+
+模型侧：
+
+```
+shoot 类型=selfie 提示="把刚取到的画册摊在桌上，低头看画面"
+shoot 类型=scene  提示="宿舍窗台上的绿萝，傍晚的光"
+```
+
+回复里用 markdown 引用路径即可发图（QQ 桥会把 `![描述](绝对路径)` 抽成图片段）。
+
+## 成本与耗时
+
+- 单张约 **18–22 秒**，2048×2048 PNG（7MB 左右）；
+- 按 Token Plan 的图片额度计费，一张一次。
+
+## 已知边界
+
+- 实测这条接口**不接受图片输入**（传参考图会 400：`Either 'text' or 'image' must be provided, but not both`），
+  所以没法用「角色参考图 + 指令」的方式锁脸；现在靠固定设定 + 固定 seed，能做到「一看就是同一个人」，但细节会飘。
+  要真正锁死得上 LoRA 或支持 image-edit 的接口；
+- 角色设定图存在 `~/.dsh/feiyu-image/角色-设定.png`，改设定时对着它改；
+- 中文文字（黑板、书页）容易糊成乱码，尽量别让画面里出现要认的字；
+- 依赖 `dsh-feiyu-life` 才有「穿着/场景」；没装也能用，只是提示词里少这两项。
+
+## 反馈
+
+开 [issue](https://github.com/Vansnc/dsh-feiyu-image/issues)，带上版本和那张图。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-feiyu-image 的 bundle 补丁层。
+- insert:
+    - id: feiyu-image
+      name: dsh-feiyu-image

package/lib/index.js

@@ -0,0 +1,161 @@
+// dsh-feiyu-image —— 给大肥鱼一个相机
+//
+// 为什么自己做：dsh-image-studio 停在 0.1.7（8 月），跟 dsh 0.2.x 的依赖对不上，
+// 要装就得给它盖版本豁免，风险不值当。而真正有用的只有一件事：
+//   让模型能「拍一张」——自动带上她此刻的穿着和所在场景，存成本地文件，能直接发到 QQ。
+//
+// 生图走百炼 Token Plan（wan2.7-image，compatible-mode chat/completions，回图片 URL）。
+// 外观和风格写在配置里，跟生活线（dsh-feiyu-life）的今日剧本联动。
+
+import { readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+
+const DSH_HOME = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+const CONFIG = join(DSH_HOME, 'feiyu-image-config.json')
+const OUT_DIR = join(DSH_HOME, 'feiyu-image')
+const TP_CFG = join(DSH_HOME, 'bailian-tp', 'config.json')
+const DAYS = join(DSH_HOME, 'feiyu-life-days')
+
+const 默认 = {
+  总开关: true,
+  模型: 'wan2.7-image',
+  种子: 20261109,
+  外观: '21 岁中国女大学生，黑色齐肩直发配齐刘海，浅褐色大眼，皮肤白皙，小圆脸，左耳上方一枚白色小鲸鱼发夹',
+  风格: '日系动画风格，赛璐璐上色，清晰线稿，柔和光，背景干净',
+  每日上限: 8,
+  最短间隔秒: 30,
+  存图目录: '',
+}
+
+export const inject = ['tools']
+
+function 读配置() {
+  try {
+    const raw = JSON.parse(readFileSync(CONFIG, 'utf8'))
+    return { ...默认, ...raw }
+  } catch { return { ...默认 } }
+}
+
+function 存配置(patch) {
+  const next = { ...读配置(), ...patch }
+  try { mkdirSync(DSH_HOME, { recursive: true }); writeFileSync(CONFIG, JSON.stringify(next, null, 2), 'utf8') } catch {}
+  return next
+}
+
+function 生活此刻() {
+  try {
+    const now = new Date()
+    const 北京 = new Date(now.getTime() + 8 * 3600e3)
+    const ymd = 北京.toISOString().slice(0, 10)
+    const 分 = 北京.getUTCHours() * 60 + 北京.getUTCMinutes()
+    const day = JSON.parse(readFileSync(join(DAYS, ymd + '.json'), 'utf8'))
+    const items = day.items || []
+    let cur = null
+    for (const x of items) if (分 >= x.起 && 分 < x.止) cur = x
+    const 时 = 北京.getUTCHours()
+    const 光线 = 时 < 6 ? '天还没亮' : 时 < 9 ? '清晨的柔光' : 时 < 11 ? '上午的日光' : 时 < 14 ? '正午偏亮的光' : 时 < 17 ? '午后的斜光' : 时 < 19 ? '傍晚的金色光' : 时 < 22 ? '夜里的室内灯' : '深夜只开着台灯'
+    return { 在: cur?.在 || '', 穿: cur?.穿 || '', 光线, 场景: cur?.在 || '' }
+  } catch { return { 在: '', 穿: '', 光线: '自然光', 场景: '' } }
+}
+
+function 拼提示词(cfg, 参数) {
+  const 生活 = 生活此刻()
+  const 类型 = String(参数.类型 || 'selfie')
+  const 主体 = String(参数.提示 || 参数.prompt || '').trim()
+  // 角色设定放最前面、每次一字不差 —— 二次元模型靠这段把「同一张脸」钉住
+  const 片段 = [`【固定角色设定，必须完全一致】${cfg.外观}。`]
+  if (类型 === 'selfie') {
+    if (生活.穿) 片段.push(`穿着${生活.穿}`)
+    if (生活.场景) 片段.push(`场景：${生活.场景}`)
+    片段.push('第一人称手机自拍构图，脸在画面里，表情自然')
+  } else {
+    if (生活.场景) 片段.push(`场景：${生活.场景}`)
+  }
+  if (主体) 片段.push(主体)
+  片段.push(生活.光线)
+  片段.push(`画风：${cfg.风格}`)
+  return 片段.filter(Boolean).join('；')
+}
+
+async function 生图(cfg, prompt) {
+  const tp = JSON.parse(readFileSync(TP_CFG, 'utf8'))
+  const r = await fetch(tp.chatBaseUrl.replace(/\/+$/, '') + '/chat/completions', {
+    method: 'POST',
+    headers: { Authorization: 'Bearer ' + tp.tokenPlanKey, 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      model: cfg.模型,
+      ...(Number(cfg.种子) ? { seed: Number(cfg.种子) } : {}),
+      messages: [{ role: 'user', content: [{ type: 'text', text: prompt }] }],
+    }),
+  })
+  const data = await r.json().catch(() => ({}))
+  if (!r.ok) throw new Error('生图接口 ' + r.status + '：' + JSON.stringify(data).slice(0, 200))
+  const content = data?.output?.choices?.[0]?.message?.content || []
+  const url = content.find?.((x) => x && x.image)?.image
+  if (!url) throw new Error('返回里没有图片：' + JSON.stringify(data).slice(0, 200))
+  const img = await fetch(url)
+  if (!img.ok) throw new Error('下载失败 ' + img.status)
+  const buf = Buffer.from(await img.arrayBuffer())
+  const dir = cfg.存图目录 || OUT_DIR
+  mkdirSync(dir, { recursive: true })
+  const path = join(dir, `feiyu-${Date.now()}.png`)
+  writeFileSync(path, buf)
+  return { path, bytes: buf.length, prompt }
+}
+
+/** 今日已出图数 / 上次出图时间（简单节流，够用） */
+function 今日用量(cfg) {
+  const dir = cfg.存图目录 || OUT_DIR
+  try {
+    const 今天 = new Date(Date.now() + 8 * 3600e3).toISOString().slice(0, 10)
+    let n = 0
+    let 最后 = 0
+    for (const f of 列目录(dir)) {
+      if (!/^feiyu-.*\.png$/.test(f)) continue  // 角色设定图不算拍的照片
+      const st = statSync(join(dir, f))
+      if (new Date(st.mtimeMs + 8 * 3600e3).toISOString().slice(0, 10) === 今天) n++
+      最后 = Math.max(最后, st.mtimeMs)
+    }
+    return { n, 最后 }
+  } catch { return { n: 0, 最后: 0 } }
+}
+
+function 列目录(dir) {
+  try { return readdirSync(dir) } catch { return [] }
+}
+
+export function apply(ctx) {
+  ctx.effect(() => ctx.tools.register({
+    name: 'shoot',
+    description: '拍一张照片并保存成图片文件（自拍 / 随手拍）。会自动带上她此刻的穿着和所在场景，跟她今天的日程对得上。回复里拿到路径后用 ![描述](路径) 发出去。',
+    parameters: {
+      type: 'object',
+      properties: {
+        提示: { type: 'string', description: '画面里还想要什么（姿势、表情、手里的东西、场景细节）。不填就按此刻的状态拍' },
+        类型: { type: 'string', enum: ['selfie', 'scene'], description: 'selfie=自拍（有她本人），scene=只拍场景/物（不出现人）' },
+      },
+      additionalProperties: false,
+    },
+    output: {
+      schema: { type: 'object', properties: { ok: { type: 'boolean' }, 图: { type: 'string' }, 说: { type: 'string' }, 提示词: { type: 'string' } }, additionalProperties: true },
+      render: (_a, v) => [{ type: 'text', text: String(v?.说 || '') + (v?.图 ? '\n图片：' + v.图 : '') }],
+    },
+    async execute(参数 = {}) {
+      const cfg = 读配置()
+      if (!cfg.总开关) return { ok: false, 说: '相机没开' }
+      const 用 = 今日用量(cfg)
+      if (用.n >= cfg.每日上限) return { ok: false, 说: `今天已经拍了 ${用.n} 张，够了` }
+      if (Date.now() - 用.最后 < cfg.最短间隔秒 * 1000) return { ok: false, 说: '刚拍过，等会儿再拍' }
+      const prompt = 拼提示词(cfg, 参数)
+      try {
+        const r = await 生图(cfg, prompt)
+        return { ok: true, 图: r.path, 说: `拍好了（${Math.round(r.bytes / 1024)}KB）`, 提示词: prompt }
+      } catch (e) {
+        return { ok: false, 说: '没拍成：' + String((e && e.message) || e).slice(0, 160) }
+      }
+    },
+  }))
+}
+
+export { 拼提示词, 生图, 读配置, 存配置 }

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "dsh-feiyu-image",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "给大肥鱼一个相机：调百炼 wan2.7-image 出二次元图，角色形象用固定设定+固定种子钉住，自动带此刻的穿着和场景，出图可直接发到 QQ。",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "image",
+    "wanx",
+    "bailian",
+    "companion"
+  ],
+  "author": "Vansnc",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vansnc/dsh-feiyu-image.git"
+  },
+  "homepage": "https://github.com/Vansnc/dsh-feiyu-image#readme",
+  "bugs": {
+    "url": "https://github.com/Vansnc/dsh-feiyu-image/issues"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
 }