蓝鱼工作站 Moningxuan-bot/blue-fish-station

蓝色大肥鱼工作站

DSH 单独应用 · 界面美化 · 集成 GPT 绘图工作站

把 DeepSeek Harness 变成双击就能用的桌面程序，顺手把界面换成自己的样子，再塞进一个能直接出图的绘图工作站。
不改 DSH 一行源码：桌面部分是一个 WebView2 外壳，界面部分是一个宿主插件。

| 组成 | 是什么 | 目录 |
| 桌面应用 | BlueFishStation.exe：自己拉起 DSH 服务、开一个没有浏览器界面的窗口 | desktop/ |
| 界面美化 | 宿主插件：品牌标 / 思考文案 / 背景毛玻璃 / 推理强度滑块 | dsh-plugin-aurora/ · aurora.css · aurora.js |
| 绘图工作站 | 独立插件：中文描述 → 扩写提示词 → 出图，带规范自检与计费 | dsh-plugin-imagestation/ |

目录

快速开始 · 功能一览 · 仓库结构 · 它是怎么工作的 ·换素材调参 · 排错 · 卸载与回滚 · 升级 DSH 之后 ·踩坑记录 · 已知限制

快速开始

前置：Windows 10/11 + 系统自带的 Windows PowerShell 5.1（不需要 PowerShell 7）、装好的 DSH（web profile 初始化过一次即可）。

① 桌面应用（日常用这个）

powershell -File .\desktop\install-desktop.ps1

编译 desktop\BlueFishStation.cs → 部署到 %LOCALAPPDATA%\BlueFishStation\ → 在桌面创建「蓝色大肥鱼工作站」快捷方式。
双击即用。改了代码之后，双击 desktop\redeploy.cmd 重新部署。

② 界面美化插件（随 DSH 升级存活）

powershell -File .\install-plugin.ps1

装完重启一次 dsh web（bundle 列表是启动时读的）。之后改 aurora.css / aurora.js 只要 F5 ——插件每次请求都从工作区读盘，不用同步、不用重启。

③ 绘图工作站

powershell -File .\install-imagestation.ps1

重启后侧栏出现「绘图工作站」入口。提示规范写在 dsh-plugin-imagestation/specs/.md，改规范＝改文件 + F5，不用改代码。详细用法见它自己的 README。

④ 备用：文件注入（会被升级覆盖）

powershell -File .\install.ps1 # 备份 index.html + 注入 / + 同步资源到 dist powershell -File .\sync.ps1 # 只改了 CSS/JS 时

sync.ps1 会把 .png/.jpg 包进内嵌 base64 的 SVG（DSH 静态服务的 MIME 表只认 .html/.js/.css/.svg/.json/.map/.webmanifest，raster 图会被发成 application/octet-stream），再复制进 dist 并给引用打 ?v= 防缓存。每次升级 dsh-web-frontend 后都要重跑 —— 所以它只是备用路径。

功能一览

桌面应用

| | 说明 |
| 一键启动 | 双击快捷方式：拉起 dsh web --port 0 --no-open → 解析带 token 的地址 → 载入窗口 |
| 无浏览器界面 | WinForms + WebView2，没有地址栏/标签页；标题与图标都是「蓝色大肥鱼工作站」 |
| 高 DPI | 挂 app.manifest（PerMonitorV2）+ app.config，150% 缩放下按 144 DPI 原生渲染，窗口任意缩放都锐利 |
| 干净退出 | 关窗时 taskkill /pid /T /F 收掉整个服务进程树 |
| 单实例 | 命名互斥体，重复双击只提示「已经在运行」 |
| 参数 | --url= 连已有实例；--userdata= 换 WebView2 数据目录；--selftest 无头自检 |
| 日志 | %LOCALAPPDATA%\BlueFishStation\station.log（含服务 stdout/stderr） |

界面美化

| 位置 | 改动 |
| 侧边栏 / 折叠态 / 空白会话 Hero 的品牌标 | 换成自定义图片 |
| 浏览器标签图标 | 换成自定义图片 |
| 品牌字标（logo 右侧） | 换成「蓝色大肥鱼」+「工作站」双色文字 |
| 思考状态行 | 「深度求索中，用时12秒」→「大肥鱼正在吃你的 TOKEN，用时12秒」（保留计时） |
| 整站背景 | 换成自定义背景图（+ 柔光罩），替掉刺眼的纯白 |
| 侧边栏 | 毛玻璃（半透明 + 背景虚化） |
| 模型菜单 → 思考强度 | 自绘滑块：渐变胶囊轨道 + 星星圆点 + 百分比胶囊刻度 + 中文档位名 |
| 思考强度面板 | 档位立绘：四个档位各一张角色图，当前档全亮、其余压暗 |
| 拖动滑块时 | 角色跑动：12 帧跑动图骑在圆点上跟着手跑；流光从轨道左→右扫过 |
| 松手定档 | 跑动角色退场，档位立绘重新出现并停在当前档 |

绘图工作站

- 中文描述 → 扩写提示词（实时流式）→ 出图，每张 18–30 秒、固定 $0.03
- 提示规范文件化（specs/.md），出厂三个预设，支持 base 继承与 config 内联覆盖
- 规范自检（lib/lint.js）：查质量词、danbooru 计数标签、Markdown、Negative Prompt 区块等，只报告不改写
- 参考图（图生图）：拖入或选文件；>2MB 会在浏览器里自动压到长边 1536
- 中转站脾气适配：提交前剥离已知无效参数（background / output_format），拿到图后校验真实字节（尺寸/alpha/格式），请求与实得任何不一致都挂在面板上；size、n、/v1/images/edits、mask 实测有效
- 图片写到 $DSH_HOME/image-station/images（相对路径按 $DSH_HOME 解析，不按 cwd）

仓库结构

desktop/ 桌面应用（WebView2 外壳） BlueFishStation.cs 唯一源文件（C# 5，纯 ASCII，中文用 \u 转义） BlueFishStation.exe 编译产物（已提交，方便直接部署） app.manifest PerMonitorV2 高 DPI 清单（编译时 /win32manifest 挂上） app.config 部署为 BlueFishStation.exe.config（WinForms 的 DpiAwareness 键） install-desktop.ps1 编译 + 部署 + 建桌面快捷方式 redeploy.cmd 双击重新部署 make-icons.ps1 源图 → 6 尺寸 app-icon.ico + app-icon-256.png extract-webview2.ps1 从 nupkg 里取 WebView2 SDK 三个文件 gen-social-preview.ps1 生成 1280x640 社交预览图 Microsoft.Web.WebView2.* 运行时依赖（随 exe 部署）

dsh-plugin-aurora/ 界面美化插件（宿主半侧） lib/index.js 8 条资源路由 + tapIndex 注入 cordis.patch.yml 往 profile 插件树插入一行

aurora.css 样式：1) LOGO 2) 思考行图标 3) 品牌字标 4) 背景+毛玻璃 aurora.js 行为：思考文案替换 + 推理强度滑块 logo.jpg fish.png fish-flat.png bg.jpg moods.png run.png 源素材 tools/mkbg.cs 背景图转换：居中裁剪 + 重采样 + 锐化

dsh-plugin-imagestation/ 绘图工作站（独立插件，见其自家 README） install.ps1 / sync.ps1 备用：文件注入模式 install-plugin.ps1 / uninstall-plugin.ps1 美化插件的装/卸 docs/station-intro.png 本仓库介绍图

它是怎么工作的

桌面外壳：怎么拿到「不用登录」的窗口

0.1.7 起 DSH 的首页与 /api 都要过一道浏览器信任闸门：进程启动时生成 launch token，把 http://127.0.0.1:/?token=... 打印到终端，浏览器访问它才换到签名 cookie。所以外壳的做法是：

cmd /c dsh web --port 0 --no-open
↓ stdout: "dsh web: http://127.0.0.1:63183/?token=..."
↓ 正则抓出地址 → web.Source = new Uri(url)

--port 0 让 OS 挑一个空闲端口，所以它不会和你终端里那个实例抢端口。

高 DPI：「窗口一变尺寸就糊」的真凶

exe 默认没有 DPI 感知声明，Windows 于是按 96 DPI 渲染整个窗口、再位图拉伸到实际分辨率。
本机实测：物理 2560×1600 / 虚拟 1707×1067 = 150% 缩放，旧 build 的进程感知级别是 UNAWARE → 糊。
修法是编译时挂 app.manifest（dpiAware=true/pm + dpiAwareness=PerMonitorV2）并部署 app.config（DpiAwareness=PerMonitorV2）。修好后同一查询返回 PER_MONITOR_AWARE，页面内 window.devicePixelRatio = 1.5，内容按原生 144 DPI 渲染。

覆盖层：为什么能活过 DSH 升级

DSH 的前端由 dsh-host-frontend-static 提供，它每个请求都重新读取 dist/index.html 并跑一遍 index taps。
宿主插件正好有这两个钩子：

| 钩子 | 作用 |
| webServer.register({ kind:"exact", path:"/aurora.css", ... }) | 8 条精确路由，每次请求读工作区文件 + no-store |
| webServer.tapIndex(html => ...) | 每个 index 响应注入 /（版本号取资源 mtime） |

于是「改文件 → F5」就是最新，而 dsh-web-frontend 升级覆盖 dist 也伤不到它。

安装不用 pnpm：在 $DSH_HOME/profiles/node_modules/ 建一个目录 junction 指向本仓库的插件目录，再往 profile 的 dependencies（link: 形式，将来跑 pnpm 也不会被清掉）和 dsh.profile.bundles 各写一条。
装之前可以先干跑一次预检：dsh --profile web --dump-config，能看到 - id: aurora-overlay 就说明 bundle 解析与 patch 合成都没问题。

思考状态文案：三层兜底 + 语义匹配

新版的文案不再硬编码，而是本地化 key：chat.deepDiving =「深度求索中」/Deep diving...，
message.turnProcess.deepDivingFor =「深度求索中，用时{duration}」。而且它挂在一个回合结束后仍然存在的
里（跑完文案变「已完成工作」），所以替换必须带语义判断：

1. 容器钩子按优先级试：[data-turn-process] → [data-chat-running] → [class="_turnStatus"] → [class="_runningText"] → [class="_running"] （首次插入时 MutationObserver 给的往往是更外层节点，所以祖先找不到时会再往子树内部找一遍）
2. 只换容器内第一个「像运行文案」的文本节点，并保留「，用时12秒」尾巴，计时器继续走
3. 全局兜底：整篇文档里像运行文案的文本也换，但绝不碰 PROTECTED（我们自己的浮层、菜单、按钮、表单、role=status 无障碍节点）

三层都没命中时 selfCheck 会在控制台 warn 一次 —— 升级后一眼就能定位。

推理强度滑块：内部 RPC 的真实契约

DSH 浏览器端用的是自研 RPC。0.1.7-rc.2 换了命名与信封（以下都是打真服务端验证过的）：

POST /api// content-type: application/json
body { type:'client-request', rpcId:, method:'/',
payload: { args: } }
resp { type:'server-response', rpcId, result: { ok:true, value } | { ok:false, error } }

| 调用 | 端点（斜杠） | payload |
| 读档位 | session/modelCatalog（无参数） | { args: {} } |
| 写档位 | session/selectModel | { args: { request: { sessionId, provider, model, reasoningEffort } } } |
| 会话列表 | session/list | { args: { _request: {} } } |

目录返回的结构（旧版字段叫 current，新版叫 default，两个都读）：

{ "default": { "provider": "...", "model": "deepseek-flash", "reasoningEffort": "high" },
"groups": [ { "id": "deepseek-official", "models": [ { "id": "deepseek-flash",
"reasoning": { "defaultEffort": "high", "efforts": [ {"id":"off","name":"Off"} / low/high/max / ] } } ] } ] }

aurora.js 不硬编码这些名字：它 hook window.fetch，从 App 自己的请求里学端点名与信封样式，候选列表只用于「App 还没发过这个请求」时兜底。顺带也这样学到 sessionId（它藏在 payload.args.request.sessionId 里）。

滑块是怎么长进菜单里的

| 环节 | 做法 |
| 找到原生档位行 | [role="menuitemradio"] 四重校验：无 title、文字以档位名开头、数量与档位数 1:1、有实际矩形 |
| 藏掉原生行 | opacity: 0（不是 visibility: hidden）+ pointer-events: none |
| 摆浮层 | 覆盖在原生行那块矩形上，宽度取 max(行宽, 344)，垂直居中 |
| 不被菜单关掉 | mousedown/click 捕获阶段屏蔽 + focusout 屏蔽（焦点落进浮层时吞掉） |
| 拖动 | 轨道连续 0..1000，生效值取最近的档位；松手没跨档位就弹回、不提交 |
| 定位驱动 | 输入事件（rAF，抢在绘制前）+ 250ms 轮询兜底；自激熔断 >60 次/秒则停用浮层 |

尺寸都在文件顶部：TRACK=24 THUMB=40 PANEL_MIN_W=344 MOOD_H=52 RUN_MS=1600 RUN_FRAMES=12。

为什么 opacity 不能换成 visibility：0.1.7 的菜单新增了 onBlur 关闭，切到档位面板时应用会 focus() 那一行「已选中」的档位按钮；visibility:hidden 的元素不可聚焦 → 焦点落回 body → 菜单判定焦点跑出去 → close()，表现就是「滑块刚出现就被关掉」。opacity:0 的元素依然可聚焦，所以两件事都能满足。

主题令牌与毛玻璃

--dsw-alias-bg-base = --dsw-static-neutral-bluish-00 (纯白) --dsw-specific-sidebar-fill = --dsw-static-neutral-bluish-50 (#f9fafb) --dsw-static-deepseek-500 = #4176e6 (主色) --dsw-alias-label-primary = #0f1115 (浅色) / #f9fafb (深色)

关键认识：--dsw-alias-bg-base 不只用在对话卡片 —— AppFrame 自己就 background: var(...)，是全局调暗器； ConversationRoot 又叠了一层。算透明度时必须按真实层数叠乘，否则背景图会被叠没。
这些 alias 令牌是行内样式写在 body 上的，所以覆盖要 !important 且作用域落在 body。

绘图工作站（两半结构）

| 文件 | 作用 |
| lib/index.js | 宿主半侧接线：配置、令牌、Index 注入 |
| lib/presets.js | 预设加载：读 specs/.md，支持 base 继承与 config 覆盖 |
| lib/expand.js | 扩写核心，只依赖 ctx.llm，可脱离服务器单独测 |
| lib/lint.js | 规范自检：把「模型该守规矩」变成代码能判定的事 |
| lib/generate.js | 出图核心：调中转站、剥离无效参数、校验返回字节、算账 |
| lib/routes.js | 传输层：HTTP + NDJSON 流 + 令牌鉴权 + 图片读取 |
| lib/client.js | 浏览器半侧（手写 bundle，无构建步骤） |
| specs/.md | 提示规范（知识）。改这里就是改行为 |

换素材 / 调参

| 文件 | 用途 | 说明 |
| logo.jpg | 品牌标（侧边栏/折叠态/Hero）+ favicon | 方形效果最好，960×960 |
| fish.png | 思考状态行前的图标（已抠白底） | 127×126 |
| fish-flat.png | 同上但保留白底 | 备选 |
| bg.jpg | 整站背景图 | 当前 2560×1600（= 本机 150% 缩放下的物理分辨率，1:1 不放大）。换图用 tools\mkbg.cs：mkbg.exe bg.jpg 2560 1600 0.55 |
| moods.png | 四档角色立绘 | 4 格雪碧图，160×128/格 |
| run.png | 拖动时的跑动循环 | 12 格雪碧图，96×77/格 |

换完直接 F5（插件模式）；只有文件注入模式才需要跑一次 sync.ps1。

样式调参全在 aurora.css 第 4 节：

| 想要的效果 | 改什么 |
| 背景图更清晰 | 最上层白纱 rgba(255,255,255,.10) 调小；--dsw-alias-bg-base 调小 |
| 文字发花 | 白纱调大（最安全的全局提亮），或反着调各层 alpha |
| 侧边栏玻璃更明显 | --dsw-specific-sidebar-fill 调小，blur(14px) 调大 |
| 侧边栏不想要虚化 | 删掉 [class="_sidebarCol"]::before 整段 |
| 滑块尺寸/跑动速度 | aurora.js 顶部的 TRACK/THUMB/MOOD_H/RUN_MS |

排错

| 现象 | 看哪里 |
| 桌面应用起不来 | %LOCALAPPDATA%\BlueFishStation\station.log（含服务 stdout/stderr） |
| 想不动窗口验证一遍 | & "$env:LOCALAPPDATA\BlueFishStation\BlueFishStation.exe" --selftest → 退出码 0 = WebView2 起来了且覆盖层生效 |
| 美化不生效 | 浏览器控制台 [aurora] armed: ...（脚本起来了）/ 终端里 [aurora] overlay plugin active（插件生效） |
| 思考文案没被替换 | 控制台 [aurora] 运行状态容器钩子全都没匹配上… → 上游改结构了 |
| 滑块不出来 | 控制台 [aurora] radios=… matched=… efforts=… 这行会说明是「菜单没了」「匹配失败」还是「目录读取失败」 |
| 改完 CSS/JS 没变化 | 确认走的是插件模式（终端应有 [aurora] overlay plugin active），然后 F5 |

卸载与回滚

美化插件 powershell -File .\uninstall-plugin.ps1 # 移除 junction + 清掉 bundles/dependencies，然后重启 dsh web

桌面应用：删掉桌面快捷方式 + %LOCALAPPDATA%\BlueFishStation\ 即可（不在系统里注册任何东西）

文件注入模式 $d = Join-Path $env:DSH_HOME 'profiles\node_modules\@deepseek-ai\dsh-web-frontend\dist' Copy-Item "$d\index.html.aurora-bak" "$d\index.html" -Force Remove-Item "$d\aurora.css","$d\aurora.js","$d\aurora-logo.svg","$d\aurora-fish.svg","$d\aurora-bg.svg","$d\aurora-moods.svg","$d\aurora-run.svg" -Force -ErrorAction SilentlyContinue

升级 DSH 之后

1. 插件模式：什么都不用做，最多 F5；
2. 桌面应用：不用动（每次启动都会重新解析地址与 token）；
3. 文件注入模式：重跑 install.ps1。
上游变化对照表（0.1.7-rc.2 实测）

| 我们依赖的东西 | 新版状态 |
| 思考状态行 [class="_turnStatus"] | ❌ rc.2 产物里没有 data-chat-running（那是 master 源码里的，比 rc.2 新）；✅ 真实结构是 + 内部 ，已作为首选钩子 |
| 文案 Deep diving... | ❌ 变成本地化 key（chat.deepDiving / message.turnProcess.deepDivingFor）；✅ 已改成语义匹配 + 保留计时尾巴 |
| 模型菜单 role="menuitemradio" + effortChoices | ✅ 原样（但菜单新增了 onBlur 关闭，见上文） |
| RPC 读档位 session.models | ❌ 改名 session/modelCatalog（斜杠、无参数），current → default |
| RPC 信封 | ❌ 多了一层 payload.args（按描述符 wire 名嵌套） |
| 品牌标 _brandMark / Hero _fishHitbox / 轨迹 _thinkingToggle | ✅ 都还在 |
| frontend-static MIME 表 | ✅ 一模一样（图片仍需包进 SVG） |

踩坑记录

1. MutationObserver 自激 = 页面卡死。回调里写自己观察范围内的 DOM，微任务里再生产微任务，浏览器永远轮不到绘制。
修法不是打补丁而是换驱动：定位改由输入事件 + 定时器驱动，Observer 只做文案替换。
2. 菜单的 onBlur 会吃掉滑块：焦点离开菜单就 close()。用 focusout 捕获屏蔽 + 让浮层自己接住焦点解决。
3. opacity vs visibility：前者可聚焦、后者不可。在这套菜单里这一条决定了「滑块能不能活过一帧」。
4. backdrop-filter 会给 position: fixed 当包含块，isolation: isolate 会创建层叠上下文 ——都不能加在「别人的全屏 fixed 层挂在我 DOM 子树里」的容器上（侧边栏就是这种容器）。
5. DPI 不感知 = 整窗位图拉伸：csc 默认清单里没有 DPI 声明，150% 缩放下全窗口发糊。
6. .NET 的 Icon 类读不了 PNG 压缩条目的 ICO（ToBitmap() 抛异常），而 Explorer 能读；所以窗口图标是运行时 GetHicon() 从 PNG 加载的。
7. .ps1 不要写非 ASCII：Windows PowerShell 5.1 按 ANSI 读脚本，中文字节可能吞掉引号导致语法错误。
所有脚本保持纯 ASCII，中文名用码点拼（如桌面快捷方式名）。
8. GitHub 仓库名只允许 ASCII，而且 API 对非法字符是「静默裁剪」不报错 —— 别拿线上仓库做实验。
9. git add -A 会扫到并行会话的在制品。本仓库曾因此误提交（已撤回并 force-push）。只用显式路径 add。
10. 绘图站：相对 outputDir 按 $DSH_HOME 解析，不按 cwd —— 按 cwd 时图被写进了 DSH 安装目录（找不到、还可能被升级删掉）。

已知限制

- 只支持浅色主题（所有覆盖都在 body:not([data-ds-dark-theme]) 作用域内，深色主题保持原样）。
- 美化插件与 DSH 的具体版本强相关（钩子是 data- 属性 + _ 后缀），跨大版本升级后建议核对控制台告警。
- /api// 是 DSH 内部协议，没有稳定性承诺；端点或信封再变时，滑块需要同步调整。
- 滑块会实时改写当前会话的推理强度（与界面里选 effort 是同一个操作）。
- 绘图站：切回对话后看不到实时进度（出图不会中断，跑完自动出现在记录里）；蒙版涂刷界面尚未实现。
- 桌面应用只在 Windows 上验证过（WebView2 运行时随 Edge 安装，Win10/11 一般都在）。

License

MIT —— 见 LICENSE。代码可自由使用。

素材（logo.jpg / fish.png / fish-flat.png / bg.jpg / moods.png / run.png / desktop/app-icon*.png / docs/station-intro.png）是仓库作者的个人素材（角色立绘与跑动图取自作者自己的设计稿），替换成你自己的即可。