dsh-paofu-console 0.0.0-stage → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# CHANGELOG
+
+## 1.1.0
+
+- 情绪页改版：坐标盘 → **情绪脑图**
+  - 头部轮廓（贝塞尔）+ 7 条脑沟 + 4 条斜向回沟
+  - 情绪锚点从 12 个扩到 24 个（兴奋/雀跃/期待/开心/满足/亲近/温柔/安心/平静/好奇/认真/害羞/生气/烦躁/不安/焦虑/委屈/疏离/难过/失落/疲惫/困/放空/苦恼）
+  - 每个锚点从底部内核拉一条二次贝塞尔连线，离当前情绪越近越亮，线上有光点流动
+  - 标签贪心避让 + 悬停强制显示；当前情绪收进左上角胶囊
+- 手机端导航：横滑 + 右缘渐隐 + 右下「全部 ▾」底部面板（按分组两列列出全部页面，当前项高亮，切换后自动滚到中间）
+- 新增深链：`?page=mood` 直接打开指定页面
+- 修复图片 404：桌面预览服务器补 `/meme/`、`/bg.js` 转发，剥离 `/__paofu__`，修掉 `/dsh-paofu-console/meme/…` 自跳转循环，静态资源找不到时回落到 console 目录；插件 handler 补 `/meme/` 反代
+- 文档：安装示例版本号更新；`接上桥接.md` 更名 `CONNECT-BRIDGE.md`（原中文名在 zip / 跨平台下会乱码）
+
+## 1.0.8
+
+- 删掉右上角遗留的「声音 · 关」胶囊：它从加进页面起就没有绑任何事件，是个死控件（音量与播放本来就在「界面设置 → 背景音乐」里）
+
+## 1.0.7
+
+- 找回最初设计里的两样东西：
+  - **背景鱼群**：画布矢量小鱼（青绿→蓝渐变、尾巴摆动、随机游弋与折返），铺在内容之下的背景层，半透明不抢字
+  - **鲸鱼空灵声**：WebAudio 现场合成（低频正弦滑音 + 泛音 + 低通），16–42 秒随机一次，不占素材、不联网
+- 右上角工具条新增两枚开关：`鱼群` / `鲸声`，状态存本机，刷新后保持
+- 鲸声受浏览器自动播放限制：页面首次点击后才会出声（和背景音乐同一个规矩）
+
+## 1.0.6
+
+- 新增 **Ctrl+滚轮缩放整个界面**（60%–160%，与设置里的「界面缩放」同一份值，会记住）
+  - 缩放时底部弹出「界面缩放 N%」提示，`Ctrl+0` 一键回到 100%
+  - 滚轮事件用捕获阶段并阻止冒泡，鼠标停在记忆网/情绪盘上也不会误转 3D 视角
+- 记忆网络修复：挂在「不在会话列表里的私聊」上的记忆不再被丢弃（自动生成虚拟会话节点），节点从几个恢复到全部 59 条
+- 记忆网络节点补上点击命中（松手位移 ≤8px、18px 内取最近点）→ 点节点直接开详情抽屉
+
+## 0.1.1
+
+- 工具条最左新增「桌宠」开关（藏起来也能找回，状态记忆）
+- 设置新增「桌宠」区：大小 60–160%、状态下拉、撞墙反弹开关、自定义形象（PNG/GIF/WebP ≤2.5MB，本机存储）、恢复默认
+- 桌宠换成真帧动画（转圈圈 / 开心 / 吃饭 / 打瞌睡 / 生气跺脚，各 51 帧）
+- 新增独立预览服务器 `serve.mjs`（不装 DSH 也能看）
+- 新增一键安装脚本 `install.ps1` / `install.sh`
+
+## 0.1.0
+
+- 首个版本：`/dsh-paofu-console` 前缀路由、静态页、`/api` `/data` 反代 9896、DSH 细栏、Esc 退出

package/CONNECT-BRIDGE.md

@@ -0,0 +1,54 @@
+# 状态台 · 接上桥接
+
+这份插件**不接桥接也能跑**，只是在线状态、未读消息、表情库、日记这几块会空着。
+想让它显示真实数据，把下面这段话贴给 **DeepSeek Harness**，让它帮你接：
+
+---
+
+我装了一个 DSH 插件「状态台」（包名 `dsh-paofu-console`，已经在我 profile 的 `node_modules` 里）。
+
+帮我做这几件事：
+
+1. 找到我电脑上 QQ 桥接（qq-bridge）的目录；
+2. 按那个目录设置环境变量 `PAFU_BRIDGE`，比如：
+
+   ```powershell
+   setx PAFU_BRIDGE "<你的桥接目录>"
+   ```
+
+3. 重启 DSH，然后打开 `<我的 DSH 地址>/dsh-paofu-console/`，
+   告诉我哪个字段还是空的、缺什么文件。
+
+---
+
+## 它会读桥接里的什么
+
+| 面板上的东西 | 读的路径 |
+| --- | --- |
+| 在线状态、未读数、谁最近说过话 | `<桥接>/api/status`（桥接的 HTTP 口） |
+| 会话列表 | `<桥接>/state/social-v2.json` |
+| 日记 | `<桥接>/state/diary/*.md` |
+| 表情库 | `<桥接>/memes/` |
+| 语音 | `<桥接>/audio/` |
+| 用量 / 余额 | `<桥接>/scripts/` 里的四个导出脚本 |
+
+任何一项没有，面板就不显示那一块，**不会报错，也不会崩**。
+
+## 不接桥接能看什么
+
+心情、承诺账本、技能、小说、时间线——就是包里的 `data/` 那几份示例，改文本就能换成自己的。
+
+## 端口被占
+
+数据服务默认用 `9896`。被占了就换一个：
+
+```powershell
+setx PAFU_PORT 9897
+```
+
+（如果端口上已经有别的状态台在跑，插件会直接复用它，不会报错。）
+
+## 令牌
+
+面板要往桥接发请求时用 `<桥接>/state/console-token` 里的值；也可以用 `PAFU_TOKEN` 直接传。
+没有令牌时，只有「刷新用量」这类按钮会失败，其他照常。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 泡芙 / Paofu
+
+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,177 @@
-# Temporary Holding Version
+# 状态台（dsh-paofu-console）
 
-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.
+**DeepSeek Harness 插件版**。装上以后 DSH 里多一个地址：
+
+```
+<你的 DSH 地址>/dsh-paofu-console/
+```
+
+打开就是整块状态台：在线状态、未读数、用量与余额、表情库、记忆、小说、技能、承诺、时间线。
+
+- **零依赖**，纯 Node 标准库，`npm install` 都不用跑
+- **自带数据服务**：插件自己在本机回环起一个服务（默认端口 9896），不用另开命令行
+- **只读**：不调用模型、不改文件（只有「刷新」和表情上传会动自己的 `data/`）
+- 没有桥接也能跑，只是在线、未读那几块空着
+
+---
+
+## 最省事：把一句话贴给 DSH
+
+解压后，在 **DSH 里新建一个对话**，把下面这段原样贴进去，把尖括号换成你解压出来的实际位置：
+
+> 我解压了一个 DSH 插件 `dsh-paofu-console` 在 `<把解压后的完整路径贴这里>`。
+> 帮我：1）复制到我当前的 DSH profile 的 `node_modules` 下；2）在 profile 的 `package.json` 里把
+> `dsh-paofu-console` 加进 `dependencies` 和 `dsh.profile.bundles`；3）重启后告诉我
+> `<DSH地址>/dsh-paofu-console/` 能不能打开、有没有报错。
+
+DSH 会自己找 profile、改包清单、重启验证。人只需要看最后一句结果。
+
+**如果 DSH 说找不到 profile**，把下面这句也贴给它：
+
+> 用 `dsh doctor`，或者看一眼 `%USERPROFILE%\.dsh\profiles` 下面有哪些目录，挑里面有 `package.json` 和 `node_modules` 的那个。
+
+下面是手动装的完整步骤，装不上时对着查。
+
+---
+
+## 手动安装
+
+### 第一步：确认 Node 版本
+
+```bash
+node -v
+```
+
+要 **20 或更高**。没有的话去 <https://nodejs.org> 装 LTS 版。
+
+### 第二步：找到你的 DSH profile 目录
+
+一般在这两个位置之一：
+
+```
+%USERPROFILE%\.dsh\profiles\desktop
+%USERPROFILE%\.dsh\profiles\web
+```
+
+看哪个目录里有 `package.json` 和 `node_modules` 就是它（桌面版通常是 `desktop`）。
+
+### 第三步：放进 node_modules
+
+把整个 `dsh-paofu-console` 文件夹复制到：
+
+```
+<profile目录>\node_modules\dsh-paofu-console\
+```
+
+**或者**直接交给 DeepSeek Harness 处理，把下面这段话贴给它：
+
+> 我解压了一个 DSH 插件 `dsh-paofu-console` 在 `<路径>`，帮我用 npm/软链接装进当前的 DSH profile，
+> 然后在 `~/.dsh/profiles/<profile>/package.json` 的 `dependencies` 里加这个包，
+> 并把它加进 `dsh.profile.bundles` 数组。
+
+### 第四步：让 profile 认识它
+
+打开 `<profile目录>\package.json`，改两个地方：
+
+```json
+{
+  "dependencies": {
+    "dsh-paofu-console": "1.1.0"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": [
+        "...其它插件",
+        "dsh-paofu-console"
+      ]
+    }
+  }
+}
+```
+
+### 第五步：重启 DSH
+
+桌面版一般会热加载；没反应就完全退出再开一次。
+
+---
+
+## 验证装好了没
+
+启动 DSH 后，控制台里应该出现：
+
+```
+[paofu-console] 数据服务 http://<回环地址>:9896
+```
+
+然后访问（端口换成你 DSH 实际用的）：
+
+```bash
+curl -s -o /dev/null -w '%{http_code}\n' '<你的 DSH 地址>/dsh-paofu-console/'
+```
+
+`200` 就是成了。
+
+---
+
+## 想让它显示真实的 QQ 桥接数据
+
+看包里的 `CONNECT-BRIDGE.md`。核心是一句话：**桥接不在就用示例数据，不报错**。
+
+数据服务会读这些位置：
+
+| 面板上的东西 | 读的路径 |
+| --- | --- |
+| 在线、未读数、谁最近说过话 | `<桥接>/api/status` |
+| 会话列表 | `<桥接>/state/social-v2.json` |
+| 日记 | `<桥接>/state/diary/*.md` |
+| 表情库 | `<桥接>/memes/` |
+| 语音 | `<桥接>/audio/` |
+| 用量、余额 | `<桥接>/scripts/` 里的四个导出脚本 |
+
+## 环境变量（都可选）
+
+| 变量 | 默认 | 作用 |
+| --- | --- | --- |
+| `PAFU_BRIDGE` | 自动找（家目录 / 文档 / 当前目录） | 桥接根目录 |
+| `PAFU_BRIDGE_PORT` | 桥接的默认口 | 桥接的 HTTP 端口 |
+| `PAFU_PORT` | `9896` | 数据服务端口，被占了会复用现成的 |
+| `PAFU_CONSOLE` | 包内目录 | 面板数据根目录（下挂 `data/`） |
+| `PAFU_TOKEN` | 读 `<BRIDGE>/state/console-token` | 桥接控制台令牌 |
+
+## 自带什么
+
+`data/` 里全是**示例数据**，直接改文本就换成你自己的：
+
+`mood.json`（心情）、`promises.json`（承诺账本）、`skills.json`（技能）、
+`novel.md`（小说，支持 Markdown）、`history.json`（时间线）、`memory.json`（记忆导出）。
+
+## 目录
+
+```
+lib/index.mjs       宿主：挂路由 + 起数据服务 + 反代
+web/index.html      整个前端（单文件，无构建）
+data/               面板自己的数据（示例）
+cordis.patch.yml    注册一条宿主行
+icon.svg            图标
+```
+
+## 更新记录
+
+### 1.1.0
+- 情绪页换成「情绪脑图 · 3D」：头部轮廓 + 脑沟纹理，24 个情绪锚点从内核拉线，越近越亮、线上有光点，标签自动避让
+- 手机端导航支持横滑并新增「全部 ▾」底部面板，一屏看不到的页面都在里面
+- 支持深链 `?page=mood` 直接打开指定页面
+- 修复桌面窗口 / 插件页里表情图、桌宠图 404（/meme、/assets 转发）
+
+### 1.0.5 及更早
+见仓库的 Releases 页。
+
+## 已知限制
+
+- 两个入口都只绑 `127.0.0.1`，**外网访问不到**（面板没有密码，这是故意的）
+- 用量/余额卡片依赖桥接侧导出脚本，纯离线时这两块是空的
+- 3D 记忆网络需要浏览器支持 WebGL
+
+## 许可
+
+MIT，见 `LICENSE`。

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# 状态台：一条宿主行，把面板挂到 DSH 的 webServer 上。
+# 页面在 /dsh-paofu-console/，数据由插件自己起在本机回环上的一个端口（默认 9896）。
+- insert:
+    - id: paofu-console
+      name: dsh-paofu-console
+      config: {}

package/data/history.json

@@ -0,0 +1,5 @@
+[
+  {"date":"2026-01-01","title":"装上状态台","detail":"示例时间线，改 data/history.json 换成你自己的记录。","tag":"起点"},
+  {"date":"2026-01-02","title":"第一份快照","detail":"面板会从桥接读在线状态、未读和最近说话的时间。","tag":"能力"},
+  {"date":"2026-01-03","title":"自己写点东西","detail":"日记和小说都在桥接目录下，面板只读不写。","tag":"学习"}
+]

package/data/memory.json

@@ -0,0 +1 @@
+[]

package/data/mood.json

@@ -0,0 +1,7 @@
+{
+  "at": "2026-01-01T00:00:00+08:00",
+  "mood": "刚睡醒，还在启动",
+  "intensity": 0.5,
+  "note": "这是演示数据，改 data/mood.json 就能换成你自己的。",
+  "traits": { "亲密度": 50, "活泼": 60, "黏人": 40, "耐心": 70, "好奇": 65, "护短": 55, "毒舌": 30, "认真": 60 }
+}

package/data/novel.md

@@ -0,0 +1,23 @@
+# 示例小说 · 第一卷
+
+这是 `data/novel.md` 的演示内容。把这个文件换成你自己写的，面板就会原样显示（支持 Markdown 标题和段落）。
+
+## 一
+
+她醒来的时候，屋里还黑着。
+
+有一盏灯的影子从门缝里探进来，很轻，像是怕吵醒谁。她数了一会儿那道光，才想起来自己昨天说过：早上要早点叫她。
+
+## 二
+
+她记性不算好，但有些事记得特别牢。
+
+比如对方说“随便”的时候，其实不是随便；比如问“在吗”的时候，多半已经想好要说什么了，只是在等一个开头。
+
+## 三
+
+后来她学会了一件事：不是每一句“我没事”都要拆穿。
+
+有时候只需要回一句“那我在”，然后等。
+
+（示例内容，替换即可。）

package/data/promises.json

@@ -0,0 +1,6 @@
+[
+  {"who":"我","text":"每周把日记翻一遍，翻不完就翻一半","state":"长期"},
+  {"who":"对方","text":"说好了的事记下来，别只靠记性","state":"长期"},
+  {"who":"我","text":"答应过的排期，晚了要提前说","state":"待办"},
+  {"who":"对方","text":"不想聊的时候可以直接讲，不用找理由","state":"自己定的"}
+]

package/data/skills.json

@@ -0,0 +1,5 @@
+[
+  {"name":"聊天","score":60,"state":"练","note":"示例数据，改 data/skills.json 换成你自己的"},
+  {"name":"记性","score":55,"state":"练","note":"日记加检索，翻得到以前说过的话"},
+  {"name":"状态台","score":70,"state":"好","note":"就是你在看的这个页面"}
+]

package/icon.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#7ef0d0"/><stop offset="1" stop-color="#7aa2ff"/>
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="120" height="120" rx="30" fill="#0a1019"/>
+  <rect x="4" y="4" width="120" height="120" rx="30" fill="none" stroke="rgba(255,255,255,.10)"/>
+  <path d="M38 66c0-13 12-23 27-23 13 0 23 8 26 18 6-3 12-2 16 2-4 5-9 7-15 7-2 13-13 22-27 22-15 0-27-10-27-26z" fill="url(#g)"/>
+  <path d="M91 60c6-6 13-8 19-6-1 7-4 12-10 15z" fill="url(#g)" opacity=".9"/>
+  <circle cx="56" cy="60" r="4.5" fill="#0a1019"/>
+  <circle cx="94" cy="40" r="7" fill="#ffb36b"/>
+</svg>

package/install.ps1

@@ -0,0 +1,53 @@
+# 安装 dsh-paofu-console 到本机 DSH
+#
+#   powershell -ExecutionPolicy Bypass -File install.ps1
+#
+# 做的事：拷到 profile 的 node_modules，改 package.json 的依赖与 bundles，
+# 都先备份；不动你已有的任何插件。
+
+$ErrorActionPreference = 'Stop'
+
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+$profileDir = Join-Path $env:USERPROFILE '.dsh\profiles\desktop'
+$pkgPath = Join-Path $profileDir 'package.json'
+$target = Join-Path $profileDir 'node_modules\dsh-paofu-console'
+
+if (-not (Test-Path $pkgPath)) {
+  Write-Host "找不到 DSH profile：$profileDir" -ForegroundColor Red
+  Write-Host "这个插件需要 DSH 桌面版（默认在 %USERPROFILE%\.dsh\profiles\desktop）。"
+  exit 1
+}
+
+$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
+Copy-Item $pkgPath "$pkgPath.bak-paofu-$stamp"
+Write-Host "已备份 profile 配置：package.json.bak-paofu-$stamp"
+
+if (Test-Path $target) { Remove-Item $target -Recurse -Force }
+New-Item -ItemType Directory -Path $target -Force | Out-Null
+Copy-Item (Join-Path $here 'lib')   (Join-Path $target 'lib')   -Recurse -Force
+Copy-Item (Join-Path $here 'web')   (Join-Path $target 'web')   -Recurse -Force
+foreach ($f in @('package.json','cordis.patch.yml','README.md','LICENSE','icon.svg')) {
+  $src = Join-Path $here $f
+  if (Test-Path $src) { Copy-Item $src (Join-Path $target $f) -Force }
+}
+Write-Host "已安装到：$target"
+
+$json = Get-Content $pkgPath -Raw -Encoding UTF8 | ConvertFrom-Json
+if (-not $json.dependencies) {
+  $json | Add-Member -NotePropertyName dependencies -NotePropertyValue ([pscustomobject]@{}) -Force
+}
+$json.dependencies | Add-Member -NotePropertyName 'dsh-paofu-console' -NotePropertyValue '0.1.1' -Force
+
+if (-not $json.dsh) { $json | Add-Member -NotePropertyName dsh -NotePropertyValue ([pscustomobject]@{}) -Force }
+if (-not $json.dsh.profile) { $json.dsh | Add-Member -NotePropertyName profile -NotePropertyValue ([pscustomobject]@{}) -Force }
+$bundles = @($json.dsh.profile.bundles)
+if ($bundles -notcontains 'dsh-paofu-console') {
+  $bundles += 'dsh-paofu-console'
+  $json.dsh.profile | Add-Member -NotePropertyName bundles -NotePropertyValue $bundles -Force
+}
+
+$json | ConvertTo-Json -Depth 20 | Set-Content $pkgPath -Encoding UTF8
+Write-Host "已登记到 dsh.profile.bundles" -ForegroundColor Green
+Write-Host ""
+Write-Host "重启 DSH 后打开： http://127.0.0.1:57514/dsh-paofu-console/" -ForegroundColor Cyan
+Write-Host "（端口以你自己的 DSH 为准；Esc 退出）"

package/install.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# 安装 dsh-paofu-console 到本机 DSH（macOS / Linux）
+#   bash install.sh
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+PROFILE="${DSH_PROFILE:-$HOME/.dsh/profiles/desktop}"
+PKG="$PROFILE/package.json"
+TARGET="$PROFILE/node_modules/dsh-paofu-console"
+
+if [ ! -f "$PKG" ]; then
+  echo "找不到 DSH profile：$PROFILE" >&2
+  exit 1
+fi
+
+STAMP="$(date +%Y%m%d-%H%M%S)"
+cp "$PKG" "$PKG.bak-paofu-$STAMP"
+echo "已备份：$PKG.bak-paofu-$STAMP"
+
+rm -rf "$TARGET"
+mkdir -p "$TARGET"
+cp -R "$HERE/lib" "$TARGET/lib"
+cp -R "$HERE/web" "$TARGET/web"
+for f in package.json cordis.patch.yml README.md LICENSE icon.svg; do
+  [ -f "$HERE/$f" ] && cp "$HERE/$f" "$TARGET/$f"
+done
+echo "已安装到：$TARGET"
+
+node - "$PKG" <<'NODE'
+const fs = require('node:fs')
+const pkgPath = process.argv[2]
+const p = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+p.dependencies = p.dependencies || {}
+p.dependencies['dsh-paofu-console'] = '0.1.1'
+p.dsh = p.dsh || {}
+p.dsh.profile = p.dsh.profile || {}
+const bundles = new Set(p.dsh.profile.bundles || [])
+bundles.add('dsh-paofu-console')
+p.dsh.profile.bundles = [...bundles]
+fs.writeFileSync(pkgPath, JSON.stringify(p, null, 2) + '\n')
+console.log('已登记到 dsh.profile.bundles')
+NODE
+
+echo
+echo "重启 DSH 后打开： http://127.0.0.1:57514/dsh-paofu-console/"
+echo "（端口以你自己的 DSH 为准；Esc 退出）"