dsh-zoo 0.0.0-stage → 1.3.0
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.
- package/README.md +502 -2
- package/cordis.patch.yml +10 -0
- package/desktop/README.md +435 -0
- package/desktop/farm-preload.js +75 -0
- package/desktop/farm-view.js +578 -0
- package/desktop/farm.html +1983 -0
- package/desktop/farm.js +2091 -0
- package/desktop/gift-path.js +72 -0
- package/desktop/gift-preload.js +62 -0
- package/desktop/gift.html +618 -0
- package/desktop/gift.js +273 -0
- package/desktop/index.html +777 -0
- package/desktop/main.js +2771 -0
- package/desktop/package.json +8 -0
- package/desktop/preload.js +120 -0
- package/desktop/rename-preload.js +47 -0
- package/desktop/rename.html +106 -0
- package/desktop/rename.js +76 -0
- package/desktop/renderer.js +3027 -0
- package/desktop/shared.js +3234 -0
- package/index.js +41 -0
- package/package.json +54 -4
- package/scripts/desktop-smoke.mjs +3214 -0
- package/scripts/fake-peer.mjs +295 -0
- package/scripts/install.mjs +109 -0
- package/scripts/lib/pet.mjs +269 -0
- package/scripts/smoke.mjs +80 -0
- package/scripts/stop-helper.mjs +163 -0
- package/scripts/two-pets.mjs +247 -0
- package/scripts/uninstall.mjs +62 -0
- package/scripts/win32-sendinput.ps1 +102 -0
- package/src/backpack.js +561 -0
- package/src/contracts-rules.js +200 -0
- package/src/contracts.js +733 -0
- package/src/desktop-advisory.js +26 -0
- package/src/desktop-launch.js +231 -0
- package/src/desktop-pets.js +315 -0
- package/src/desktop.js +823 -0
- package/src/discovery.js +397 -0
- package/src/dsh-pet-pets.js +162 -0
- package/src/farm-fetch.js +390 -0
- package/src/farm-open.js +103 -0
- package/src/farm-rules.js +369 -0
- package/src/farm-text.js +105 -0
- package/src/farm.js +1721 -0
- package/src/gift-fetch.js +201 -0
- package/src/gift-limits.js +96 -0
- package/src/gift-text.js +147 -0
- package/src/gifts.js +770 -0
- package/src/helper-processes.js +75 -0
- package/src/identity.js +151 -0
- package/src/json-text.js +28 -0
- package/src/lan-routes.js +40 -0
- package/src/lan-server.js +507 -0
- package/src/market.js +854 -0
- package/src/menu.js +213 -0
- package/src/paths.js +62 -0
- package/src/peers.js +224 -0
- package/src/pet-assets.js +105 -0
- package/src/pet-bridge.js +375 -0
- package/src/pet-name-write.js +188 -0
- package/src/protocol.js +1474 -0
- package/src/room.js +1920 -0
- package/src/service.js +5738 -0
- package/src/settings.js +188 -0
- package/src/skin-fetch.js +263 -0
- package/src/skin-sources.js +385 -0
- package/src/street.js +141 -0
- package/src/visit-copy.js +79 -0
- package/src/visit-policy.js +183 -0
- package/src/visit-record.js +55 -0
- package/src/visits.js +164 -0
package/README.md
CHANGED
|
@@ -1,3 +1,503 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="assets/logo.png" alt="dsh-zoo" width="220">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
# dsh-zoo
|
|
6
|
+
|
|
7
|
+
[](https://github.com/Diomchen/dsh-zoo/actions/workflows/ci.yml)
|
|
8
|
+
[](https://github.com/Diomchen/dsh-zoo/releases/latest)
|
|
9
|
+
|
|
10
|
+
把同一局域网里的 DSH 宠物连起来:自己的宠物活在桌面上,邻居的宠物会来串门,你的宠物也会出门。
|
|
11
|
+
|
|
12
|
+
dsh-zoo 负责**发现、放行、串门、桌面画布、礼物、记录和农场**;宠物的名字、动作和外观来自 `dsh-pet`。
|
|
13
|
+
|
|
14
|
+
> **v1.1**:农场是新的一层——种、收、偷、帮忙、雇工和本机交易所。
|
|
15
|
+
> 旧版本的邻居照常串门、送礼、留记录,只是看不到农场;偷菜/帮忙/雇佣需要双方都是 v1.1。
|
|
16
|
+
|
|
17
|
+
> **v1.2**:地块可用硬币解锁,4 块起步、最多 50 块;旧存档保持 4 块。
|
|
18
|
+
> v1.1 邻居仍能串门/偷/帮,但只看得到前 4 块地。
|
|
19
|
+
|
|
20
|
+
> **v1.3**:农场对局域网公开。在家右键邻居小街上的那户就能看田,不用先放行;看田窗里点
|
|
21
|
+
> 「派它去偷」,宠物自己跑一趟,偷完回家。农场窗顶部的邻居切换器也能直接看别家。
|
|
22
|
+
> 老版本邻居照常串门和偷菜(走串门那条老路),只是没有看田和行程。
|
|
23
|
+
|
|
24
|
+
> 桌面层支持 **macOS / Windows**。Linux 或 web profile 没有桌面宠物,但发现、放行、串门照常工作。
|
|
25
|
+
|
|
26
|
+
## 快速开始
|
|
27
|
+
|
|
28
|
+
**要求**
|
|
29
|
+
|
|
30
|
+
- DSH Desktop(web profile 也可以,只是没有桌面层)
|
|
31
|
+
- `dsh-pet`(提供宠物、动作和素材;不装也能跑,只是显示通用小人)
|
|
32
|
+
- Node.js ≥ 22.12
|
|
33
|
+
- Electron 运行时(装过 `dsh-pet` 后通常已有;没有则不会显示桌面宠物)
|
|
34
|
+
|
|
35
|
+
**安装**
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
git clone https://github.com/Diomchen/dsh-zoo.git
|
|
39
|
+
cd dsh-zoo
|
|
40
|
+
node scripts/install.mjs # 装进 ~/.dsh/profiles/desktop
|
|
41
|
+
node scripts/install.mjs --dry-run # 先看会改什么
|
|
42
|
+
node scripts/install.mjs --profile web
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
装完**重启 DSH**。确认接口是否正常:
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
curl -s http://127.0.0.1:<DSH端口>/dsh-zoo/state | jq '.neighbors'
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
`<DSH端口>` 是 DSH GUI 地址里的那个本地端口。
|
|
52
|
+
|
|
53
|
+
**卸载**
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
node scripts/uninstall.mjs
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
用户数据在 `~/.dsh/dsh-zoo/`,卸载不会删除。
|
|
60
|
+
|
|
61
|
+
## 它能做什么
|
|
62
|
+
|
|
63
|
+
| 能力 | 说明 |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| 桌面宠物 | 全屏透明、置顶、默认点击穿透;有重力,可拖拽,松手按轨迹投掷。 |
|
|
66
|
+
| 邻居发现 | 同一网段 UDP 广播,自动找到邻居;第一次见面先放行。 |
|
|
67
|
+
| 串门 | 手动或自动去邻居家;访客常驻,支持送客、召回和 30 分钟上限。 |
|
|
68
|
+
| 邻居面板 | 点「串门」先看到一条小街:谁在线、在干嘛、能不能去。 |
|
|
69
|
+
| 右键菜单 | 打开软件、带派、农场、回到初始位置、重载配置、扫描外观、动作、外观。 |
|
|
70
|
+
| 带派(捎东西) | 出门前捎一张字条或一个文件;背包、送达回执、礼物卡都已落地。 |
|
|
71
|
+
| 串门记录 | 双方各留一条记录,保留最近 200 条。 |
|
|
72
|
+
| 农场 | 4 块起步、最多 50 块;3 种作物;离线也长,待机攒露水。 |
|
|
73
|
+
| 交易所 | 本机做市,买种子、卖作物;邻居行情汇总成局域网指数。 |
|
|
74
|
+
| 偷菜与帮忙 | 去邻居家偷成熟作物,或给生长中的地浇水;守卫与每日上限随农场规模放大。 |
|
|
75
|
+
| 看田与偷菜行程 | 在家只读地看邻居的地块与守卫,不用放行;点「派它去偷」让它自己跑一趟,回来作物已在仓库。 |
|
|
76
|
+
| 雇工 | 挂牌出租宠物看家;合同 2–8 小时,预付工资,按实际时长结算。 |
|
|
77
|
+
| 多外观 | 用 `skin.json` 注册素材源;换皮不动名字、身份和记录。 |
|
|
78
|
+
|
|
79
|
+
## 桌面上的操作
|
|
80
|
+
|
|
81
|
+
| 操作 | 结果 |
|
|
82
|
+
| --- | --- |
|
|
83
|
+
| 悬停自己 | 弹出「串门 / 召回 / 改名」 |
|
|
84
|
+
| 右键自己 | 打开软件 / 回到初始位置 / 重载配置 / 扫描外观 / 动作 / 外观 |
|
|
85
|
+
| 点「串门」 | 打开邻居小街,点哪户就去哪家;去不了的会说明原因 |
|
|
86
|
+
| 右键邻居小街上的那户 | 打开只读的看田窗(不用放行);窗底「派它去偷」是派出去偷一趟,不是手动点地偷 |
|
|
87
|
+
| 点访客 | 送客 |
|
|
88
|
+
| 拖拽宠物 | 抓起来,松手投掷 |
|
|
89
|
+
| 点礼物卡 | 打开 / 在文件夹里显示 / 复制(字条)/ 扔掉 |
|
|
90
|
+
| 右键「农场」 | 打开卡片农场小窗(农场 / 交易所 / 雇工 / 记录);再点一次关闭,窗口的 × / Esc 也关闭 |
|
|
91
|
+
|
|
92
|
+
右键菜单里的「重载配置」会重读 `settings.json` 和 `skin.json`,并重建桌面,不会占用崩溃退避次数。
|
|
93
|
+
菜单只挂自己的宠物:访客和空白桌面都不会弹。
|
|
94
|
+
|
|
95
|
+
## 配置
|
|
96
|
+
|
|
97
|
+
### 数据目录
|
|
98
|
+
|
|
99
|
+
默认是 `~/.dsh/dsh-zoo/`(跟随 `DSH_HOME`):
|
|
100
|
+
|
|
101
|
+
| 路径 | 内容 |
|
|
102
|
+
| --- | --- |
|
|
103
|
+
| `identity.json` | 本机 `deviceId` 和昵称镜像 |
|
|
104
|
+
| `peers.json` | 放行 / 拒绝名单,只按 `deviceId` 认 |
|
|
105
|
+
| `settings.json` | 入站串门、自动出门两个开关 |
|
|
106
|
+
| `visits.json` | 串门记录,最多 200 条 |
|
|
107
|
+
| `farm.json` | 农场:地块、仓库、硬币、露水、挂牌和农场日志 |
|
|
108
|
+
| `market.json` | 本机交易所:价格、成交历史、局域网指数 |
|
|
109
|
+
| `contracts.json` | 雇佣合同(`outgoing` 我是雇主 / `incoming` 我是雇工) |
|
|
110
|
+
| `backpack.json` | 待捎礼物,最多 2 件 |
|
|
111
|
+
| `gifts/` | 收到的礼物,每件一个目录 |
|
|
112
|
+
| `skin.json` | 本机素材源注册表 |
|
|
113
|
+
| `skin-cache/` | 远端素材缓存,上限 200 MiB |
|
|
114
|
+
|
|
115
|
+
文件都可以手改。`settings.json` / `skin.json` 改完点「重载配置」生效;`identity.json` /
|
|
116
|
+
`peers.json` 需要重启 DSH。
|
|
117
|
+
|
|
118
|
+
### 两个开关
|
|
119
|
+
|
|
120
|
+
`settings.json`:
|
|
121
|
+
|
|
122
|
+
```json
|
|
123
|
+
{ "version": 1, "acceptVisits": true, "autoVisits": false }
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
- `acceptVisits`:默认开。关掉后只拒绝入站串门,发现、心跳和手动串门不受影响。
|
|
127
|
+
- `autoVisits`:默认关。打开后还要同时满足:最近 10 分钟有活动、距上次出门 ≥15 分钟、
|
|
128
|
+
存在在线且互相放行的邻居;满足才随机挑一位出门。
|
|
129
|
+
- 也可以用 HTTP `accept-visits` / `auto-visits` 改,立即生效并落盘。
|
|
130
|
+
|
|
131
|
+
### 外观(skin.json)
|
|
132
|
+
|
|
133
|
+
想用其他宠物包的外观,把它的动作目录写进来:
|
|
134
|
+
|
|
135
|
+
```json
|
|
136
|
+
{
|
|
137
|
+
"sources": [
|
|
138
|
+
{
|
|
139
|
+
"id": "maodie-pet",
|
|
140
|
+
"dirs": ["C:\\Users\\me\\.dsh\\dsh-pet\\pet\\maodie-animation"],
|
|
141
|
+
"size": 693,
|
|
142
|
+
"idle": "待机",
|
|
143
|
+
"once": ["喷火"]
|
|
144
|
+
}
|
|
145
|
+
]
|
|
146
|
+
}
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
- `id` 是这张皮的身份证,也是邻居看到的 `skinId`;`dirs` 是动作目录,每个动作一段 WebM。
|
|
150
|
+
- `size` 是相对 462 的比例(默认 1.0,范围 0.5–2);`idle` 和 `once` 可选。
|
|
151
|
+
- 文件一旦存在,就**取代**自动注册的 `dsh-pet` 源;两张以上皮时右键菜单会出现「外观」。
|
|
152
|
+
- 改完点「重载配置」生效;文件带 UTF-8 BOM 也认。
|
|
153
|
+
|
|
154
|
+
### 端口与环境变量
|
|
155
|
+
|
|
156
|
+
| 变量 | 默认 | 说明 |
|
|
157
|
+
| --- | --- | --- |
|
|
158
|
+
| `DSH_ZOO_PORT` | `45871/udp` | 发现、心跳、串门共用同一条 socket |
|
|
159
|
+
| `DSH_ZOO_SKIN_PORT` | `45873/tcp` | 素材源和文件礼物共用 |
|
|
160
|
+
| `DSH_ZOO_DESKTOP` | 开启 | 设为 `0` / `false` / `off` 关闭桌面层 |
|
|
161
|
+
| `DSH_ZOO_ELECTRON` | 自动查找 | 指定 Electron 可执行文件 |
|
|
162
|
+
|
|
163
|
+
同一网段的所有机器要用同一个 UDP 端口。macOS 首次监听会问“允许传入连接”;Windows 首次会弹
|
|
164
|
+
Defender 防火墙,需要给**专用网络**放行。文件礼物还要求对方的 TCP 素材端口可达。
|
|
165
|
+
|
|
166
|
+
## 本机 HTTP API
|
|
167
|
+
|
|
168
|
+
所有路由都挂在 DSH 自己的本地端口上:
|
|
169
|
+
|
|
170
|
+
| 方法与路径 | 用途 |
|
|
171
|
+
| --- | --- |
|
|
172
|
+
| `GET /dsh-zoo/state` | 邻居、访客、开关、背包、礼物、农场、交易所和合同 |
|
|
173
|
+
| `POST /dsh-zoo/action` | 放行、串门、改名、换皮、礼物、农场、买卖、雇佣等本机动作 |
|
|
174
|
+
| `POST /dsh-zoo/self-state` | 其他本机插件上报“我现在在干嘛” |
|
|
175
|
+
| `GET /dsh-zoo/desktop` | 桌面 helper 的实时状态 |
|
|
176
|
+
| `GET /dsh-zoo-farm/<visitId>` | 局域网只读:访客在串门期间拉主人的农场快照(素材端口 45873) |
|
|
177
|
+
|
|
178
|
+
常用动作:
|
|
179
|
+
|
|
180
|
+
| 分组 | action |
|
|
181
|
+
| --- | --- |
|
|
182
|
+
| 放行 | `admit` / `reject` / `dismiss` |
|
|
183
|
+
| 串门 | `visit` / `recall` / `end-visit` |
|
|
184
|
+
| 开关 | `accept-visits` / `auto-visits` |
|
|
185
|
+
| 名字与外观 | `rename` / `use-skin` |
|
|
186
|
+
| 动作与桌面 | `play-anim` / `reload` / `open-site` |
|
|
187
|
+
| 带派 | `bring` / `unbring` / `gift-open` / `gift-reveal` / `gift-discard` / `gift-copy` |
|
|
188
|
+
| 农场 | `plant` / `harvest` / `water` / `fertilize`(桌面同义 `farm-*`) |
|
|
189
|
+
| 交易所 | `buy-seed` / `sell-crop`(桌面同义 `farm-buy-seed` / `farm-sell-crop`) |
|
|
190
|
+
| 雇佣 | `hire` / `hire-listing` / `recall-worker` / `end-contract` |
|
|
191
|
+
| 访客农场 | `farm-steal` / `farm-help`(串门期间;`visitId` 可省略) |
|
|
192
|
+
| 农场小窗 | `farm-open`(`plotId` 可选) |
|
|
193
|
+
|
|
194
|
+
每个 action 的 body、返回值和错误码见 [`docs/protocol.md`](docs/protocol.md)。
|
|
195
|
+
`state` 里最常看的是 `neighbors`、`prompt`、`visitors`、`skin`、`backpack`、`gifts`、
|
|
196
|
+
`farm`、`market` 和 `contracts`。
|
|
197
|
+
|
|
198
|
+
```sh
|
|
199
|
+
# 查看邻居和待放行队列
|
|
200
|
+
curl -s http://127.0.0.1:<DSH端口>/dsh-zoo/state | jq '.neighbors, .prompt'
|
|
201
|
+
|
|
202
|
+
# 放行一位邻居
|
|
203
|
+
curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/action \
|
|
204
|
+
-H 'content-type: application/json' \
|
|
205
|
+
-d '{"action":"admit","deviceId":"<邻居 UUID>"}'
|
|
206
|
+
|
|
207
|
+
# 让别的本机插件上报自己的状态
|
|
208
|
+
curl -s -X POST http://127.0.0.1:<DSH端口>/dsh-zoo/self-state \
|
|
209
|
+
-H 'content-type: application/json' \
|
|
210
|
+
-d '{"action":"写代码","semantic":"working","say":"在写代码"}'
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
`self-state` 的 `action` 自由命名(≤64 字),`semantic` 只能是
|
|
214
|
+
`working` / `eating` / `sleeping` / `idle` / `other`,`say` 最多 80 字。
|
|
215
|
+
|
|
216
|
+
## 带派:串门捎东西
|
|
217
|
+
|
|
218
|
+
右键自己 →「带派」,放一张字条或一个文件;也可以用 `bring` 动作直接放进背包。
|
|
219
|
+
到了邻居家东西留下,访客旁边出现礼物卡。**收到对方回执才算送到**,否则串门结束时退回背包。
|
|
220
|
+
|
|
221
|
+
礼物卡跟着这一次访客走:访客离开卡片收起,礼物本身留在 `gifts/`。卡片正文按纯文本渲染,
|
|
222
|
+
不解析 HTML/Markdown。
|
|
223
|
+
|
|
224
|
+
| 项 | 限制 |
|
|
225
|
+
| --- | --- |
|
|
226
|
+
| 字条 | ≤500 字 |
|
|
227
|
+
| 文件 | ≤16 MiB |
|
|
228
|
+
| 背包 | 最多 2 件,先放的先带走 |
|
|
229
|
+
| 收件箱 | 总量 ≤500 MiB、≤200 件 |
|
|
230
|
+
| 频率 | 同一邻居 ≤10 件/小时、≤50 件/天 |
|
|
231
|
+
|
|
232
|
+
礼物永远不会自动打开或执行;打开、显示、复制、扔掉都只在用户点卡片时发生。
|
|
233
|
+
细节与完整动作见 [`docs/protocol.md`](docs/protocol.md)。
|
|
234
|
+
|
|
235
|
+
## 农场:种、收、偷、雇、交易所
|
|
236
|
+
|
|
237
|
+
农场属于**身份**:换皮、改名都不动它。初始农场是 4 块空地(最多可解锁到 50 块)、
|
|
238
|
+
30 硬币、2 颗小番茄种子、0 露水;第一次打开就能直接种。完整操作在农场小窗里(页签:农场 / 交易所 / 雇工 /
|
|
239
|
+
记录);桌面上没有地块条,右键「农场」唤醒,再点一次或 ×/Esc 关闭。
|
|
240
|
+
小窗是奶白底、祖母绿/琥珀点缀的卡片农场:顶部有「我的农场 / X/Y 已种植」、硬币/露水胶囊
|
|
241
|
+
和 ×;地块卡分空地(点一下开播种弹窗)、生长中(倒计时 + 进度 + 浇水/施肥)、成熟
|
|
242
|
+
(轻微弹跳 + 收获/施肥);农场页还有「一键种满 / 一键收割」,底部常驻种子背包和收获仓库。
|
|
243
|
+
地块网格按宿主下发的 `farm.plots` 自适应(开局 4 块、最多 50 块)。已解锁的地块后面
|
|
244
|
+
跟着一张「下一块」锁定卡,显示地价;顶部计数直接写 `x/50`。
|
|
245
|
+
记录页给最近 100 条农场日志(种/收/偷/帮/雇/结算/解锁);
|
|
246
|
+
偷来的作物和未结算的工资显示在窗口顶部的「驮包」里,只显示、不重复记账。
|
|
247
|
+
|
|
248
|
+
### 作物
|
|
249
|
+
|
|
250
|
+
| 作物 | id | 生长 | 种子价 | 产量 | 交易所底价 |
|
|
251
|
+
| --- | --- | --- | --- | --- | --- |
|
|
252
|
+
| 小番茄 | `tomato` | 30 分钟 | 6 | 3 | 5 |
|
|
253
|
+
| 胡萝卜 | `carrot` | 2 小时 | 14 | 5 | 6 |
|
|
254
|
+
| 南瓜 | `pumpkin` | 8 小时 | 36 | 3 | 30 |
|
|
255
|
+
|
|
256
|
+
初始种子只有小番茄;其他种子去交易所买。
|
|
257
|
+
|
|
258
|
+
### 怎么玩
|
|
259
|
+
|
|
260
|
+
- **种 / 收**:右键「农场」打开小窗;点空地卡片弹出播种底部弹窗,选种子种下;成熟后
|
|
261
|
+
点「收获」。也可以「一键种满」(按空地与种子库存逐块种下)或「一键收割」
|
|
262
|
+
(所有成熟地块顺序收获)。产量 = 表里的产量 + 施肥 1 − 被偷数量(最低 0)。
|
|
263
|
+
不枯萎、不生病。
|
|
264
|
+
- **解锁地块**:第 5 块起用硬币永久解锁,最高 50 块;只能按顺序买,不退不卖。
|
|
265
|
+
地价 `round5(60 × 1.10^(已解锁−4))`:第 5 块 60,第 10 块 95,第 20 块 250,
|
|
266
|
+
第 30 块 650,第 40 块 1,685,第 50 块 4,375;全部解锁共约 47,500 硬币。
|
|
267
|
+
解锁即时完成,但**至少留 6 硬币买一颗种子**;金币直接烧掉,不进任何人的口袋。
|
|
268
|
+
锁着的地块不能种/收/偷/帮;访客只看得见你已解锁的地。
|
|
269
|
+
- **浇水 / 施肥**:每株各一次。浇水花 1 露水,+10% 生长;施肥花 5 露水,收获 +1。
|
|
270
|
+
露水不够会明确报 `no-dew`。
|
|
271
|
+
- **待机 / 露水**:DSH 开着、10 分钟没做农场动作算待机;每 10 分钟 +1 露水,
|
|
272
|
+
每天最多挣 48、余额也封顶 48,本地午夜重置。任何一次种/收/浇/施肥/买卖/雇佣都会重置计时。
|
|
273
|
+
- **离线生长**:关掉 DSH 作物仍按真实时间长;一次最多补 12 小时,回来接着长。
|
|
274
|
+
- **交易所**:交易所页买种子(固定价)、卖作物(按本机 `bid`)。卖多了价跌,
|
|
275
|
+
每 10 分钟向底价回归 3%;价格永远夹在底价的 0.5–2 倍。买种子不影响作物价。
|
|
276
|
+
卖价冲击的分母随农场规模放大(`5 × 已解锁`):4 块时仍是 20,50 块时 250,
|
|
277
|
+
所以「一茬全卖」在哪个规模都约跌 7–9%(单笔上限 99,150 个要分两笔)。
|
|
278
|
+
每行有数量步进器和「买满 / 全卖」两个快捷量(只改数量,不直接成交;买满会同时受
|
|
279
|
+
硬币与 999 上限约束)。硬币不够、仓库没货时按钮上直接写「差 6 硬币」「没有可卖的」,
|
|
280
|
+
旁边再留一行原因,不会点了没反应。
|
|
281
|
+
- **行情**:每 30 秒(或价格/挂牌变化时)向放行邻居广播一次本机价格与挂牌;
|
|
282
|
+
各家取新鲜样本的中位数混成局域网指数,成交仍在本机。
|
|
283
|
+
- **偷菜 / 帮忙**:串门时打开农场窗进入访客视图。成熟的地可以偷 1 个;
|
|
284
|
+
生长中的地可以帮一次(花 1 露水、+10% 生长、得 1 硬币)。偷菜成功会让主人收获少 1;
|
|
285
|
+
被抓只是这次白跑。两种互动都有每日上限和每块地每轮一次的限制。
|
|
286
|
+
- **看田 / 派它去偷**:右键邻居小街上的那户(或农场窗顶部的邻居切换器)就能在家看邻居的地:
|
|
287
|
+
只读,只有地块、守卫和这趟最多几块。看田窗底部的「派它去偷」让宠物真的出门跑一趟——
|
|
288
|
+
不用放行、也不用先串门;它出现在对面的桌面上,带「偷菜」角标,把这一趟能偷的都偷完
|
|
289
|
+
就自己回家,作物回家时已经在仓库里。对方版本太老(没有 `raid` / `look`)时,
|
|
290
|
+
切换器那一项会写「对方版本太老」。
|
|
291
|
+
- **雇工**:雇工页保存自己的挂牌(开关 / 时薪 / 可雇时段)。邻居的挂牌随行情摘要过来,
|
|
292
|
+
选宠物和时长就能雇。工资 + 5% 手续费预付;雇工出现在雇主的桌面上(带「打工」角标),
|
|
293
|
+
雇主守卫 0.3 + 0.5 = 0.8 封顶。合同期内雇工不能串门、不能被别人雇,**自家农场没人看**。
|
|
294
|
+
主人可以召回,雇主可以提前结束,按实际服务时长结算;手续费不退。
|
|
295
|
+
- **没有桌面层**:HTTP 动作和 `/dsh-zoo/state` 照常可用,只是没有农场窗,也没有雇工宠物。
|
|
296
|
+
|
|
297
|
+
### 限额
|
|
298
|
+
|
|
299
|
+
| 项 | 上限 |
|
|
300
|
+
| --- | --- |
|
|
301
|
+
| 地块 | 起始 4 块,最多 50 块(`p1`–`p50`),按顺序解锁 |
|
|
302
|
+
| 作物 | 3 种 |
|
|
303
|
+
| 硬币 | 1,000,000 |
|
|
304
|
+
| 每种种子 / 作物 | 999 |
|
|
305
|
+
| 露水 | 每天最多挣 48,余额上限 48 |
|
|
306
|
+
| 离线生长 | 一次最多补 12 小时 |
|
|
307
|
+
| 农场日志 | 文件 200 条;`/state.farm.log` 20 条;窗口记录页 100 条 |
|
|
308
|
+
| 驮包 | 只显示:偷来的作物到本次串门结束;工资到合同结算 |
|
|
309
|
+
| 行情历史 | 文件 200 笔;`/state.market.history` 50 笔 |
|
|
310
|
+
| 合同 | 每侧 20 条(未结算的不淘汰) |
|
|
311
|
+
| 偷菜 | 同一访客对同一农场 `3+floor((n−4)/10)`/天;同一农场 `5+floor((n−4)/5)`/天;同一访客 `10+floor((n−4)/10)`/天;每块地每轮 1 次 |
|
|
312
|
+
| 帮忙 | 同一访客对同一农场 `3+floor((n−4)/10)`/天;同一农场 `5+floor((n−4)/5)`/天;同一访客 `5+floor((n−4)/10)`/天;每块地每轮 1 次;每次 1 露水、+1 硬币 |
|
|
313
|
+
| 行情广播 | 每个 peer 30 秒最多 1 条;只认 2 分钟内、价格在 `[base×0.5, base×2]` 的样本 |
|
|
314
|
+
| 买卖 | 单次 1–99 个;每分钟最多 10 笔(买 + 卖共用) |
|
|
315
|
+
| 价格 | 夹在 `base×0.5`–`base×2`;`bid = round(effective × 0.9)`;每 10 分钟回归 3% |
|
|
316
|
+
| 幂等缓存 | `farm-action` 按 `${deviceId}:${requestId}` 留最近 200 条 / 10 分钟;`work-*` ack 留 200 条 / 10 分钟 |
|
|
317
|
+
| 雇佣 | 时薪 1–100,时长 2–8 小时,手续费 `ceil(工资 × 5%)`、最低 1 |
|
|
318
|
+
| 守卫 | 主人在家 0.3 + 雇工 0.5,相加封顶 0.8;宠物串门/打工时自家为 0 |
|
|
319
|
+
| 农场快照 | HTTP 响应 ≤64 KiB;访客宿主 2 秒超时,失败按地址冷却 60 秒 |
|
|
320
|
+
|
|
321
|
+
表里的 `n` 是当前已解锁地块数(4–50);地价 = `round5(60 × 1.10^(n−4))`。
|
|
322
|
+
偷/帮的「同一访客/天」是访客本机跨农场账本,按**访客自己农场**的 `n` 算;
|
|
323
|
+
其余按主人农场的 `n`。
|
|
324
|
+
|
|
325
|
+
### 数据文件与降级
|
|
326
|
+
|
|
327
|
+
农场三个文件和 `visits.json` / `backpack.json` 同一套路:带 `version: 1`、可手改、可删;
|
|
328
|
+
损坏时按默认值运行并只告警一次;写入串行 + 临时文件 rename。删掉 `farm.json` 就是重新开局。
|
|
329
|
+
|
|
330
|
+
| 文件 | 内容 |
|
|
331
|
+
| --- | --- |
|
|
332
|
+
| `farm.json` | 硬币、种子、作物、露水、已解锁地块(最多 50)、挂牌、访客计数、农场日志 |
|
|
333
|
+
| `market.json` | 三种作物的 `base/price/volume24h/at`、最近 200 笔成交、局域网指数 |
|
|
334
|
+
| `contracts.json` | `outgoing`(我是雇主)与 `incoming`(我是雇工)两份合同列表 |
|
|
335
|
+
|
|
336
|
+
| 情况 | 看到 |
|
|
337
|
+
| --- | --- |
|
|
338
|
+
| 旧版本邻居 | 串门、礼物、记录照常;没有农场入口,不能偷/帮/雇;行情忽略 |
|
|
339
|
+
| 没有桌面层 | HTTP 动作与 `state` 可用;没有农场窗,也没有雇工宠物 |
|
|
340
|
+
| 对方离线 | 不能去/偷/帮/雇;行情过期;合同按最后心跳结束 |
|
|
341
|
+
| 对方没开局域网端口 | 串门照常;农场快照取不到,不能偷/帮;雇工不可用 |
|
|
342
|
+
| 没有种子 / 硬币 / 露水 | 明确错误码 + 一句人话 |
|
|
343
|
+
| 合同一方离线 | 合同结束,按最后心跳结算;重连后按 `contractId` 幂等补发 |
|
|
344
|
+
|
|
345
|
+
### 验收:一台机器(先走这条)
|
|
346
|
+
|
|
347
|
+
偷菜和雇工都是**跨机**的功能,所以单机靠产品界面试不出来。这个仓库自带一对宠物:
|
|
348
|
+
|
|
349
|
+
```sh
|
|
350
|
+
npm run two-pets # 两台「真宠物」跑在回环上,各自一份临时数据目录
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
它会打印两个 `baseUrl`(真 `/dsh-zoo/state` 与 `/dsh-zoo/action`,可以直接 curl),然后:
|
|
354
|
+
|
|
355
|
+
```
|
|
356
|
+
> look # 在家看 B 家的农场(不用放行、不用串门)
|
|
357
|
+
> raid # 派 A 去偷 B:不带地块就让它把能偷的都偷了
|
|
358
|
+
> admit # 互相放行(雇工必须先放行;看田和偷菜不需要)
|
|
359
|
+
> visit # A 去 B 家;串门期间仍可以偷/帮(老流程)
|
|
360
|
+
> steal p1 # B 的 p1 开局就是熟的;守卫 30% 会抓
|
|
361
|
+
> recall # A 回家
|
|
362
|
+
> listing 10 2 8 # B 挂牌:时薪 10、2–8 小时
|
|
363
|
+
> hire 2 # A 雇 B 两小时,工资 + 5% 手续费预付
|
|
364
|
+
> contracts # 两边的合同、工资、结算应当一致
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
`npm run two-pets -- --lucky` 把守卫那一掷固定成「没被抓」,只看链路不掷骰子。
|
|
368
|
+
|
|
369
|
+
这条路径覆盖的是**数据链路**:真 UDP、真 HTTP、真农场规则,两侧都是产品代码。
|
|
370
|
+
窗口渲染仍由 `npm run smoke:desktop` 覆盖——它喂的是手搭的 payload,不是链路。
|
|
371
|
+
|
|
372
|
+
### 验收:两台机器或假邻居
|
|
373
|
+
|
|
374
|
+
两台机器都装 v1.1、同一 UDP 端口、互相放行,然后走一遍:
|
|
375
|
+
|
|
376
|
+
1. A 种一块地并等成熟;B 串门到 A,打开农场窗,偷一次、帮另一块地。
|
|
377
|
+
A 的 `/state.farm.log` 应出现「谁偷了 / 谁帮了」,A 的地块 `stolenBy` / `helpedBy` 各多一位。
|
|
378
|
+
2. A 在雇工页打开挂牌;B 在雇工页看到 A 的挂牌并雇佣。
|
|
379
|
+
A 的桌面上出现带「打工」角标的宠物,`/state.farm.guard` 变成 0.8。
|
|
380
|
+
3. B 雇主提前结束(或 A 召回),等合同从 active 走到 ended/settled;
|
|
381
|
+
两边 `/state.contracts` 的 `earned` / `settled` 一致,重复操作不会重复加钱。
|
|
382
|
+
4. 用一台旧版本机器串门:串门、礼物、记录照常;农场入口不出现,脚本不会崩。
|
|
383
|
+
|
|
384
|
+
```sh
|
|
385
|
+
# 看农场、交易所和合同
|
|
386
|
+
curl -s http://127.0.0.1:<DSH端口>/dsh-zoo/state | jq '.farm, .market, .contracts'
|
|
387
|
+
|
|
388
|
+
# 用假邻居验发现、放行、串门、召回、记录
|
|
389
|
+
npm run fake-peer -- --name 楼下的柯基 --auto-visit 5
|
|
390
|
+
```
|
|
391
|
+
|
|
392
|
+
`scripts/fake-peer.mjs` 目前只实现发现 / 串门 / 礼物(它是一颗真 UDP socket,但没有
|
|
393
|
+
农场仓库和合同状态机),所以偷/帮/雇/结算没有做成脚本化的假邻居验收;这几条由
|
|
394
|
+
`test/farm-*-e2e.test.js`、`test/work-*-e2e.test.js` 里的两个 service + fake peer 覆盖。
|
|
395
|
+
两台真机的手工步骤就是上面这四步。
|
|
396
|
+
|
|
397
|
+
## 与 dsh-pet 的关系
|
|
398
|
+
|
|
399
|
+
- `dsh-pet` 提供宠物本体:名字、动作、外观和桌宠窗口;`dsh-zoo` 只做联机、串门和画布。
|
|
400
|
+
- 名字只有一份:源头是 `dsh-pet` 的 `pets[].name`,`dsh-zoo` 只是镜像;没装 `dsh-pet` 时
|
|
401
|
+
回落到主机名或「我」,以 `identity.json` 为准。桌面上的「改名」装了 `dsh-pet` 就写回它
|
|
402
|
+
(写不进去整体失败,不会只改一半),没装则写 `identity.json`。
|
|
403
|
+
- **装了但没启用**(`main-config.jsonc` 还在、profile 的 `dsh.profile.bundles` 里没有 `dsh-pet`):
|
|
404
|
+
它的 `/dsh-pet-7340/config` 路由不存在,`dsh-zoo` 会退到直接读写那份配置文件,名字仍然只有一份。
|
|
405
|
+
代价是 JSONC 注释会丢(`dsh-pet` 自己的 `PUT /config` 同样会丢)。
|
|
406
|
+
- **两个插件同时开桌面层会画两只宠物**:两个透明窗口重叠时,看到的那只和拖到的那只可能不是同一只。
|
|
407
|
+
只留一个:关掉 `dsh-pet` 的桌面窗,或用 `{"desktop": false}` / `DSH_ZOO_DESKTOP=0` 关掉这一层。
|
|
408
|
+
- 访客不需要本机装 `dsh-pet`:对方有素材源就拉远端素材,没有就退回本机同名素材或通用小人。
|
|
409
|
+
|
|
410
|
+
## 升级与改名
|
|
411
|
+
|
|
412
|
+
项目已从 `dsh-local-pet` 改名为 `dsh-zoo`([ADR-0014](docs/adr/0014-rename-to-dsh-zoo.md)):
|
|
413
|
+
|
|
414
|
+
- 首次启动会把 `~/.dsh/local-pet/` 整体改名为 `~/.dsh/dsh-zoo/`;改名失败就继续用旧目录,数据不丢。
|
|
415
|
+
- 局域网旧路由 `/local-pet-skin/*`、`/local-pet-gift/*` 仍然接受,新旧版本邻居可以混跑。
|
|
416
|
+
- 本机旧接口 `/local-pet/*` 不再提供,脚本要改成 `/dsh-zoo/*`。
|
|
417
|
+
- `node scripts/install.mjs` 会顺手摘掉 profile 里旧的 `dsh-local-pet` 依赖和 bundles 条目。
|
|
418
|
+
|
|
419
|
+
<details>
|
|
420
|
+
<summary>从 0.4.0 及更早版本升级</summary>
|
|
421
|
+
|
|
422
|
+
0.4.1 起 helper 的工作目录挪到了系统临时目录([ADR-0012](docs/adr/0012-helper-cwd-outside-package.md))。
|
|
423
|
+
已经在跑的旧 helper 改不了自己的 cwd,Windows 上直接替换包可能 `ERR_PNPM_EPERM`。
|
|
424
|
+
先退出 DSH,再:
|
|
425
|
+
|
|
426
|
+
```sh
|
|
427
|
+
node scripts/stop-helper.mjs --dry-run
|
|
428
|
+
node scripts/stop-helper.mjs
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
</details>
|
|
432
|
+
|
|
433
|
+
## 排错
|
|
434
|
+
|
|
435
|
+
| 症状 | 先做什么 |
|
|
436
|
+
| --- | --- |
|
|
437
|
+
| 桌面窗挡住点击或位置怪 | `settings.json` 里设 `{"desktop": false}`,或 `DSH_ZOO_DESKTOP=0`;只关桌面层,网络照常 |
|
|
438
|
+
| 宠物看得见但拖不动 | 先确认是否同时装了 `dsh-pet`(两个透明层);再看 `/dsh-zoo/desktop` 的 `helperStatus` |
|
|
439
|
+
| 看不到邻居 | 同一网段?UDP 45871 被占或被防火墙挡?macOS 允许传入连接?跑 `npm run fake-peer` 排除本机问题 |
|
|
440
|
+
| 文件礼物取不到 | 对方 TCP 45873 不可达;串门本身仍成功,礼物会在串门结束时退回背包 |
|
|
441
|
+
| 点了「改名」没有任何反应 | 桌面层跑的还是旧进程:`ps` 看 helper 的启动时间,比 `desktop/` 里文件的修改时间早就是它;重装 + 重启 DSH |
|
|
442
|
+
| 改名报「dsh-pet 没有响应」 | `curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:<端口>/dsh-pet-7340/config`:404 = 这个 profile 没启用 dsh-pet(新版会退到直写配置文件),连不上才是它真的不可用 |
|
|
443
|
+
| 改名后数据像丢了 | 看日志有没有「旧数据目录改名失败」;数据可能还在 `~/.dsh/local-pet/` |
|
|
444
|
+
|
|
445
|
+
`/dsh-zoo/desktop` 里最常看的三项是 `ignoring`、`trustedInputs` 和 `busy`:`trustedInputs` 不增长,
|
|
446
|
+
说明真实左键没进渲染端;涨了但 `busy` 不立,问题在渲染端。
|
|
447
|
+
|
|
448
|
+
## 开发
|
|
449
|
+
|
|
450
|
+
```sh
|
|
451
|
+
npm test # node --test,零依赖
|
|
452
|
+
npm run check # 语法检查 + 全部测试
|
|
453
|
+
npm run smoke:desktop # 真 Electron 冒烟,不进 npm test
|
|
454
|
+
DSH_ZOO_SMOKE_ONLY=farm DSH_ZOO_SMOKE_NOTES=1 npm run smoke:desktop # 只跑农场段并写截图
|
|
455
|
+
npm run fake-peer # 在本机模拟一位邻居
|
|
456
|
+
npm pack # → dsh-zoo-<version>.tgz
|
|
457
|
+
```
|
|
458
|
+
|
|
459
|
+
```sh
|
|
460
|
+
npm run fake-peer -- --name 楼下的柯基 --auto-visit 5
|
|
461
|
+
npm run fake-peer -- --gift $'给你留了张便条\n第二行'
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
| 路径 | 是什么 |
|
|
465
|
+
| --- | --- |
|
|
466
|
+
| `index.js` | 宿主入口,`cordis.patch.yml` 挂载 |
|
|
467
|
+
| `src/` | 宿主逻辑:纯状态机 + 薄 I/O 外壳 |
|
|
468
|
+
| `desktop/` | Electron helper:全屏透明窗、点击穿透、场景渲染 |
|
|
469
|
+
| `scripts/` | 安装、卸载、冒烟、假邻居 |
|
|
470
|
+
| `test/` | `node:test`,零依赖 |
|
|
471
|
+
| `docs/` | 协议文档和 ADR |
|
|
472
|
+
|
|
473
|
+
真 Electron 冒烟的截图写在 `.scratch/dsh-zoo/notes/`;`DSH_ZOO_SMOKE_NOTES=1` 会额外保存整窗和特写。
|
|
474
|
+
|
|
475
|
+
## 已知限制
|
|
476
|
+
|
|
477
|
+
- 桌面层只支持 macOS / Windows;多屏时一扇窗铺满所有屏的并集,可以跨屏拖动;走路只在同一高度的
|
|
478
|
+
相邻屏之间(高度不同时停在屏边,不会掉进黑边);没有键盘输入,宠物之间也没有物理碰撞。
|
|
479
|
+
- 外观只认 WebM;GIF、Spine、Live2D 会退回通用小人;素材缓存上限 200 MiB。
|
|
480
|
+
- 礼物:单件 ≤16 MiB、字条 ≤500 字、一次串门只带一件、背包最多 2 件;不自动打开。
|
|
481
|
+
- 0.3.x 及更早版本不认礼物字段:串门照常,但礼物会显示「没送到」并退回背包。
|
|
482
|
+
- 农场:开局 4 块、最多 50 块;3 种作物、一个雇工位;没有土地升级、狗/篱笆、装饰、
|
|
483
|
+
天气、虫害、卖地/退地。访客不能在主人的交易所成交,硬币和作物只有被宠物驮着才跨机;
|
|
484
|
+
没有跨机账本。50 块时的行情仍只由本机交易所吸收,深度按 `5 × 已解锁` 放大。
|
|
485
|
+
- 农场小窗的记录页给最近 100 条日志;`/state.farm.log` 仍只给最近 20 条。驮包是只显示的
|
|
486
|
+
「在途」标记,作物/硬币的账在宿主那本账里只记一次。
|
|
487
|
+
- 旧版本邻居看不到农场:串门、礼物、记录照常,但偷/帮/雇/行情需要双方都是 v1.1。
|
|
488
|
+
- 一次场景最多 256 只;访客没有 TTL,靠对方心跳判断失联。放行提示最多同时排 8 位,
|
|
489
|
+
心跳影子表最多 8 位。
|
|
490
|
+
- 只支持 IPv4 局域网,不支持跨网段、NAT 穿透或中继。
|
|
491
|
+
|
|
492
|
+
## 文档
|
|
493
|
+
|
|
494
|
+
- 协议、动作、错误码与敌意输入边界:[`docs/protocol.md`](docs/protocol.md)
|
|
495
|
+
- 桌面 helper、点击穿透、场景 v3、素材协议:[`desktop/README.md`](desktop/README.md)
|
|
496
|
+
- 领域词汇:[`CONTEXT.md`](CONTEXT.md)
|
|
497
|
+
- 决策记录:[`docs/adr/`](docs/adr/)
|
|
498
|
+
- 发布与上架 dsh-market:[`docs/release.md`](docs/release.md)
|
|
499
|
+
- 开发笔记与验收截图:[`.scratch/dsh-zoo/`](.scratch/dsh-zoo/)
|
|
500
|
+
|
|
501
|
+
## 许可证
|
|
502
|
+
|
|
503
|
+
MIT
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# dsh-zoo 的挂载声明:往 DSH 的配置树里插一行。
|
|
2
|
+
#
|
|
3
|
+
# id 必须与包名一致(插件按 id 定位,覆盖 patch 也靠它)。
|
|
4
|
+
# name 解析到 package.json 的入口 index.js(宿主半边)。
|
|
5
|
+
# v2 起桌宠改由独立的 Electron helper 画(ADR-0005),本包不再有浏览器半边:
|
|
6
|
+
# 没有 dsh.client,也没有 shell.overlay。
|
|
7
|
+
|
|
8
|
+
- insert:
|
|
9
|
+
- id: dsh-zoo
|
|
10
|
+
name: 'dsh-zoo'
|