dsh-paofu-console 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +195 -177
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # CHANGELOG
2
2
 
3
+ ## 1.1.1 — 2026-10-30
4
+
5
+ **只改文档**，代码与 1.1.0 一致。
6
+
7
+ - README 顶部改成对外简介：卖点、安装命令、三个渠道入口（GitHub / npm / Gitee）
8
+ - 修掉 README 里残留的旧文件名引用（`接上桥接.md` → `CONNECT-BRIDGE.md`）
9
+
3
10
  ## 1.1.0
4
11
 
5
12
  - 情绪页改版：坐标盘 → **情绪脑图**
package/README.md CHANGED
@@ -1,177 +1,195 @@
1
- # 状态台（dsh-paofu-console）
2
-
3
- **DeepSeek Harness 插件版**。装上以后 DSH 里多一个地址：
4
-
5
- ```
6
- <你的 DSH 地址>/dsh-paofu-console/
7
- ```
8
-
9
- 打开就是整块状态台：在线状态、未读数、用量与余额、表情库、记忆、小说、技能、承诺、时间线。
10
-
11
- - **零依赖**，纯 Node 标准库，`npm install` 都不用跑
12
- - **自带数据服务**：插件自己在本机回环起一个服务（默认端口 9896），不用另开命令行
13
- - **只读**：不调用模型、不改文件（只有「刷新」和表情上传会动自己的 `data/`）
14
- - 没有桥接也能跑，只是在线、未读那几块空着
15
-
16
- ---
17
-
18
- ## 最省事：把一句话贴给 DSH
19
-
20
- 解压后，在 **DSH 里新建一个对话**，把下面这段原样贴进去，把尖括号换成你解压出来的实际位置：
21
-
22
- > 我解压了一个 DSH 插件 `dsh-paofu-console` 在 `<把解压后的完整路径贴这里>`。
23
- > 帮我：1）复制到我当前的 DSH profile 的 `node_modules` 下；2）在 profile 的 `package.json` 里把
24
- > `dsh-paofu-console` 加进 `dependencies` 和 `dsh.profile.bundles`；3）重启后告诉我
25
- > `<DSH地址>/dsh-paofu-console/` 能不能打开、有没有报错。
26
-
27
- DSH 会自己找 profile、改包清单、重启验证。人只需要看最后一句结果。
28
-
29
- **如果 DSH 说找不到 profile**，把下面这句也贴给它：
30
-
31
- > 用 `dsh doctor`，或者看一眼 `%USERPROFILE%\.dsh\profiles` 下面有哪些目录，挑里面有 `package.json` 和 `node_modules` 的那个。
32
-
33
- 下面是手动装的完整步骤，装不上时对着查。
34
-
35
- ---
36
-
37
- ## 手动安装
38
-
39
- ### 第一步：确认 Node 版本
40
-
41
- ```bash
42
- node -v
43
- ```
44
-
45
- 要 **20 或更高**。没有的话去 <https://nodejs.org> 装 LTS 版。
46
-
47
- ### 第二步：找到你的 DSH profile 目录
48
-
49
- 一般在这两个位置之一：
50
-
51
- ```
52
- %USERPROFILE%\.dsh\profiles\desktop
53
- %USERPROFILE%\.dsh\profiles\web
54
- ```
55
-
56
- 看哪个目录里有 `package.json` 和 `node_modules` 就是它（桌面版通常是 `desktop`）。
57
-
58
- ### 第三步：放进 node_modules
59
-
60
- 把整个 `dsh-paofu-console` 文件夹复制到：
61
-
62
- ```
63
- <profile目录>\node_modules\dsh-paofu-console\
64
- ```
65
-
66
- **或者**直接交给 DeepSeek Harness 处理，把下面这段话贴给它：
67
-
68
- > 我解压了一个 DSH 插件 `dsh-paofu-console` 在 `<路径>`，帮我用 npm/软链接装进当前的 DSH profile，
69
- > 然后在 `~/.dsh/profiles/<profile>/package.json` 的 `dependencies` 里加这个包，
70
- > 并把它加进 `dsh.profile.bundles` 数组。
71
-
72
- ### 第四步：让 profile 认识它
73
-
74
- 打开 `<profile目录>\package.json`，改两个地方：
75
-
76
- ```json
77
- {
78
- "dependencies": {
79
- "dsh-paofu-console": "1.1.0"
80
- },
81
- "dsh": {
82
- "profile": {
83
- "bundles": [
84
- "...其它插件",
85
- "dsh-paofu-console"
86
- ]
87
- }
88
- }
89
- }
90
- ```
91
-
92
- ### 第五步：重启 DSH
93
-
94
- 桌面版一般会热加载；没反应就完全退出再开一次。
95
-
96
- ---
97
-
98
- ## 验证装好了没
99
-
100
- 启动 DSH 后，控制台里应该出现：
101
-
102
- ```
103
- [paofu-console] 数据服务 http://<回环地址>:9896
104
- ```
105
-
106
- 然后访问（端口换成你 DSH 实际用的）：
107
-
108
- ```bash
109
- curl -s -o /dev/null -w '%{http_code}\n' '<你的 DSH 地址>/dsh-paofu-console/'
110
- ```
111
-
112
- `200` 就是成了。
113
-
114
- ---
115
-
116
- ## 想让它显示真实的 QQ 桥接数据
117
-
118
- 看包里的 `CONNECT-BRIDGE.md`。核心是一句话：**桥接不在就用示例数据，不报错**。
119
-
120
- 数据服务会读这些位置：
121
-
122
- | 面板上的东西 | 读的路径 |
123
- | --- | --- |
124
- | 在线、未读数、谁最近说过话 | `<桥接>/api/status` |
125
- | 会话列表 | `<桥接>/state/social-v2.json` |
126
- | 日记 | `<桥接>/state/diary/*.md` |
127
- | 表情库 | `<桥接>/memes/` |
128
- | 语音 | `<桥接>/audio/` |
129
- | 用量、余额 | `<桥接>/scripts/` 里的四个导出脚本 |
130
-
131
- ## 环境变量（都可选）
132
-
133
- | 变量 | 默认 | 作用 |
134
- | --- | --- | --- |
135
- | `PAFU_BRIDGE` | 自动找（家目录 / 文档 / 当前目录） | 桥接根目录 |
136
- | `PAFU_BRIDGE_PORT` | 桥接的默认口 | 桥接的 HTTP 端口 |
137
- | `PAFU_PORT` | `9896` | 数据服务端口，被占了会复用现成的 |
138
- | `PAFU_CONSOLE` | 包内目录 | 面板数据根目录（下挂 `data/`） |
139
- | `PAFU_TOKEN` | 读 `<BRIDGE>/state/console-token` | 桥接控制台令牌 |
140
-
141
- ## 自带什么
142
-
143
- `data/` 里全是**示例数据**，直接改文本就换成你自己的：
144
-
145
- `mood.json`（心情）、`promises.json`（承诺账本）、`skills.json`（技能）、
146
- `novel.md`（小说，支持 Markdown）、`history.json`（时间线）、`memory.json`（记忆导出）。
147
-
148
- ## 目录
149
-
150
- ```
151
- lib/index.mjs 宿主：挂路由 + 起数据服务 + 反代
152
- web/index.html 整个前端（单文件，无构建）
153
- data/ 面板自己的数据（示例）
154
- cordis.patch.yml 注册一条宿主行
155
- icon.svg 图标
156
- ```
157
-
158
- ## 更新记录
159
-
160
- ### 1.1.0
161
- - 情绪页换成「情绪脑图 · 3D」：头部轮廓 + 脑沟纹理，24 个情绪锚点从内核拉线，越近越亮、线上有光点，标签自动避让
162
- - 手机端导航支持横滑并新增「全部 ▾」底部面板，一屏看不到的页面都在里面
163
- - 支持深链 `?page=mood` 直接打开指定页面
164
- - 修复桌面窗口 / 插件页里表情图、桌宠图 404（/meme、/assets 转发）
165
-
166
- ### 1.0.5 及更早
167
- 见仓库的 Releases 页。
168
-
169
- ## 已知限制
170
-
171
- - 两个入口都只绑 `127.0.0.1`，**外网访问不到**（面板没有密码，这是故意的）
172
- - 用量/余额卡片依赖桥接侧导出脚本，纯离线时这两块是空的
173
- - 3D 记忆网络需要浏览器支持 WebGL
174
-
175
- ## 许可
176
-
177
- MIT，见 `LICENSE`。
1
+ # 大肥鱼状态台（dsh-paofu-console）
2
+
3
+ 给 DeepSeek Harness 配的一块本地面板：装成插件、跟 DSH 共用地址，打开就能看。自定义主题、BGM、主题色会随音乐律动渐变；同步适配手机界面，布局和玩法都能自己调。
4
+
5
+ 在线状态、未读数、用量余额、日记、记忆、承诺账本、小说、系统拓扑、运行状况，全都摊平在一页里，一眼扫完——不用翻会话、翻日志、翻表格。
6
+
7
+ ```bash
8
+ dsh plugin install dsh-paofu-console
9
+ ```
10
+
11
+ 本地运行、零依赖、不调模型，数据不外传。
12
+
13
+ | 渠道 | 地址 |
14
+ | --- | --- |
15
+ | GitHub | https://github.com/pennyliu68-wq/ds-big-fish-status-panel |
16
+ | npm | https://www.npmjs.com/package/dsh-paofu-console |
17
+ | Gitee | https://gitee.com/the-concept-of-esuns-world/ds-big-fish-status-panel |
18
+
19
+ ---
20
+
21
+ **DeepSeek Harness 插件版**。装上以后 DSH 里多一个地址：
22
+
23
+ ```
24
+ <你的 DSH 地址>/dsh-paofu-console/
25
+ ```
26
+
27
+ 打开就是整块状态台：在线状态、未读数、用量与余额、表情库、记忆、小说、技能、承诺、时间线。
28
+
29
+ - **零依赖**，纯 Node 标准库，`npm install` 都不用跑
30
+ - **自带数据服务**：插件自己在本机回环起一个服务（默认端口 9896），不用另开命令行
31
+ - **只读**：不调用模型、不改文件（只有「刷新」和表情上传会动自己的 `data/`）
32
+ - 没有桥接也能跑，只是在线、未读那几块空着
33
+
34
+ ---
35
+
36
+ ## 最省事：把一句话贴给 DSH
37
+
38
+ 解压后，在 **DSH 里新建一个对话**，把下面这段原样贴进去，把尖括号换成你解压出来的实际位置：
39
+
40
+ > 我解压了一个 DSH 插件 `dsh-paofu-console` 在 `<把解压后的完整路径贴这里>`。
41
+ > 帮我：1）复制到我当前的 DSH profile 的 `node_modules` 下；2）在 profile 的 `package.json` 里把
42
+ > `dsh-paofu-console` 加进 `dependencies` 和 `dsh.profile.bundles`；3）重启后告诉我
43
+ > `<DSH地址>/dsh-paofu-console/` 能不能打开、有没有报错。
44
+
45
+ DSH 会自己找 profile、改包清单、重启验证。人只需要看最后一句结果。
46
+
47
+ **如果 DSH 说找不到 profile**，把下面这句也贴给它：
48
+
49
+ > 用 `dsh doctor`，或者看一眼 `%USERPROFILE%\.dsh\profiles` 下面有哪些目录，挑里面有 `package.json` 和 `node_modules` 的那个。
50
+
51
+ 下面是手动装的完整步骤，装不上时对着查。
52
+
53
+ ---
54
+
55
+ ## 手动安装
56
+
57
+ ### 第一步：确认 Node 版本
58
+
59
+ ```bash
60
+ node -v
61
+ ```
62
+
63
+ 要 **20 或更高**。没有的话去 <https://nodejs.org> 装 LTS 版。
64
+
65
+ ### 第二步：找到你的 DSH profile 目录
66
+
67
+ 一般在这两个位置之一：
68
+
69
+ ```
70
+ %USERPROFILE%\.dsh\profiles\desktop
71
+ %USERPROFILE%\.dsh\profiles\web
72
+ ```
73
+
74
+ 看哪个目录里有 `package.json` 和 `node_modules` 就是它（桌面版通常是 `desktop`）。
75
+
76
+ ### 第三步：放进 node_modules
77
+
78
+ 把整个 `dsh-paofu-console` 文件夹复制到：
79
+
80
+ ```
81
+ <profile目录>\node_modules\dsh-paofu-console\
82
+ ```
83
+
84
+ **或者**直接交给 DeepSeek Harness 处理，把下面这段话贴给它：
85
+
86
+ > 我解压了一个 DSH 插件 `dsh-paofu-console` 在 `<路径>`，帮我用 npm/软链接装进当前的 DSH profile，
87
+ > 然后在 `~/.dsh/profiles/<profile>/package.json` 的 `dependencies` 里加这个包，
88
+ > 并把它加进 `dsh.profile.bundles` 数组。
89
+
90
+ ### 第四步：让 profile 认识它
91
+
92
+ 打开 `<profile目录>\package.json`，改两个地方：
93
+
94
+ ```json
95
+ {
96
+ "dependencies": {
97
+ "dsh-paofu-console": "1.1.0"
98
+ },
99
+ "dsh": {
100
+ "profile": {
101
+ "bundles": [
102
+ "...其它插件",
103
+ "dsh-paofu-console"
104
+ ]
105
+ }
106
+ }
107
+ }
108
+ ```
109
+
110
+ ### 第五步：重启 DSH
111
+
112
+ 桌面版一般会热加载；没反应就完全退出再开一次。
113
+
114
+ ---
115
+
116
+ ## 验证装好了没
117
+
118
+ 启动 DSH 后，控制台里应该出现：
119
+
120
+ ```
121
+ [paofu-console] 数据服务 http://<回环地址>:9896
122
+ ```
123
+
124
+ 然后访问（端口换成你 DSH 实际用的）：
125
+
126
+ ```bash
127
+ curl -s -o /dev/null -w '%{http_code}\n' '<你的 DSH 地址>/dsh-paofu-console/'
128
+ ```
129
+
130
+ `200` 就是成了。
131
+
132
+ ---
133
+
134
+ ## 想让它显示真实的 QQ 桥接数据
135
+
136
+ 看包里的 `CONNECT-BRIDGE.md`。核心是一句话：**桥接不在就用示例数据，不报错**。
137
+
138
+ 数据服务会读这些位置：
139
+
140
+ | 面板上的东西 | 读的路径 |
141
+ | --- | --- |
142
+ | 在线、未读数、谁最近说过话 | `<桥接>/api/status` |
143
+ | 会话列表 | `<桥接>/state/social-v2.json` |
144
+ | 日记 | `<桥接>/state/diary/*.md` |
145
+ | 表情库 | `<桥接>/memes/` |
146
+ | 语音 | `<桥接>/audio/` |
147
+ | 用量、余额 | `<桥接>/scripts/` 里的四个导出脚本 |
148
+
149
+ ## 环境变量（都可选）
150
+
151
+ | 变量 | 默认 | 作用 |
152
+ | --- | --- | --- |
153
+ | `PAFU_BRIDGE` | 自动找（家目录 / 文档 / 当前目录） | 桥接根目录 |
154
+ | `PAFU_BRIDGE_PORT` | 桥接的默认口 | 桥接的 HTTP 端口 |
155
+ | `PAFU_PORT` | `9896` | 数据服务端口，被占了会复用现成的 |
156
+ | `PAFU_CONSOLE` | 包内目录 | 面板数据根目录（下挂 `data/`） |
157
+ | `PAFU_TOKEN` | 读 `<BRIDGE>/state/console-token` | 桥接控制台令牌 |
158
+
159
+ ## 自带什么
160
+
161
+ `data/` 里全是**示例数据**，直接改文本就换成你自己的：
162
+
163
+ `mood.json`（心情）、`promises.json`（承诺账本）、`skills.json`（技能）、
164
+ `novel.md`（小说，支持 Markdown）、`history.json`（时间线）、`memory.json`（记忆导出）。
165
+
166
+ ## 目录
167
+
168
+ ```
169
+ lib/index.mjs 宿主：挂路由 + 起数据服务 + 反代
170
+ web/index.html 整个前端（单文件，无构建）
171
+ data/ 面板自己的数据（示例）
172
+ cordis.patch.yml 注册一条宿主行
173
+ icon.svg 图标
174
+ ```
175
+
176
+ ## 更新记录
177
+
178
+ ### 1.1.0
179
+ - 情绪页换成「情绪脑图 · 3D」：头部轮廓 + 脑沟纹理，24 个情绪锚点从内核拉线，越近越亮、线上有光点，标签自动避让
180
+ - 手机端导航支持横滑并新增「全部 ▾」底部面板，一屏看不到的页面都在里面
181
+ - 支持深链 `?page=mood` 直接打开指定页面
182
+ - 修复桌面窗口 / 插件页里表情图、桌宠图 404（/meme、/assets 转发）
183
+
184
+ ### 1.0.5 及更早
185
+ 见仓库的 Releases 页。
186
+
187
+ ## 已知限制
188
+
189
+ - 两个入口都只绑 `127.0.0.1`，**外网访问不到**（面板没有密码，这是故意的）
190
+ - 用量/余额卡片依赖桥接侧导出脚本，纯离线时这两块是空的
191
+ - 3D 记忆网络需要浏览器支持 WebGL
192
+
193
+ ## 许可
194
+
195
+ MIT，见 `LICENSE`。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-paofu-console",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "private": false,
5
5
  "description": "状态台：给 DeepSeek Harness 配的本地状态面板（单页，自带数据服务，零依赖，不调用模型）",
6
6
  "license": "MIT",