cortico-world-map 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,109 @@
+# 更新日志
+
+市场按 `##` 标题里的版本号切段，显示在「历史版本」里。
+
+## 0.1.0
+
+**第一个版本。给 Coo 一张「周围的地图」：家在哪、常去哪儿、附近有什么、去远处旅行可以是什么样。**
+
+显示名 **「鱼的小世界」**（英文 `Little World`）。改名要同时动三处：`src/config.js` 的 `LABEL`、`package.json` 的 `cortico.displayName` + `locales`、`dist/webui.js` 里 `T.*.title`——`tools/check-name.mjs` 会把不一致当场抓出来。
+
+每处地方只有文字——空间、陈设、配色、光线、氛围——外加一句固定的画风锚点，所以同一个地方反复看、反复画都是同一副样子。画面可以**完全靠主人自己上传一张本地图**，装不装别的插件都能用。
+
+### 刻意没有的：路线、坐标、距离、导航
+
+一处地方就是「它长什么样」，不是「怎么走到它」。日程里写去哪是「鱼的每一天」的事，这里只提供「那个地方是什么样子」——所以「森林里的鱼出去上班」这种割裂从根上不会发生。
+
+这条不是「先不做」而是需求红线：`place` 的字段就是 `id / name / aliases / kind / desc / style / cover / scene / funVenue / frequent / terrain` 十一个，没有任何 geo 字段；`normalizePlace` / `normalizeState` 会主动**丢掉**混进来的 `lat` / `lng` / `route` / `distance` / `geo`。
+
+三道守门断言钉住它：
+
+- `test/places.test.mjs`：place 不含任何 geo 字段（变体表三十多个名字）；地形文案里不出现「路线 / 导航 / 坐标 / 公里 / 左转 / 车程」；
+- `tools/check-isolation.mjs`：源代码里不出现 `lat:` / `route:` / `distance:` 这类字段；
+- `test/world.test.mjs`：六个工具的回执里都不出现路线字眼；旅游那套另有一条「不许出现几天 / 行程 / 怎么去」。
+
+### 开箱：五套预设地形
+
+选一套 → **勾选表**挑要哪几处（默认全选、已有的置灰不可勾、全不选时「加进去」置灰）→ 只加勾上的那几处：
+
+| 地形 | 预置地点 |
+| --- | --- |
+| 林间 | 家（树洞/小木屋）、老橡树、溪边、蘑菇坡、林间空地 |
+| 小区 | 家、楼下长椅、便利店门口、小花园、单元楼道 |
+| 江边 | 家、江堤台阶、旧码头、芦苇滩、江边石墩 |
+| 山脚 | 家、上山口、山泉、半坡亭、碎石坡 |
+| 旅行 | 海边小镇、雪山客栈、古城老街、温泉旅馆、林间营地 |
+
+**换地形只追加，不删已有地点**（id 带地形前缀，`forest-home` / `riverside-home` 不撞）。所以「林间」写好的描写，切到「江边」之后还在。已经有的那几处不会被覆盖（可能是主人重命名过的）。
+
+骨架的 `style` / `scene` / `cover` 全是空的——骨架不知道主人喜欢什么画风、也不知道他库里有什么场景，猜一个就是错。
+
+### 两种画面来源
+
+**A · 本地图片（主人上传），可完全独立。** 面板里每处「传一张图」，落 `<数据目录>/map/covers/<id>.<ext>`，面板走 `ctx.invoke('cover', {id})` 拿 **base64 data URL** 显示。只认 png / jpg / webp / gif，上限 8 MiB，**按文件头魔数校验、不信扩展名**，扩展名也按魔数定。
+
+**B · 生图工作室联动，可选。** 「发图时 scene 填 X」那句**只在三条全满足时出现**：`mapImggenOn` 开着 + `worlds.imggen.enabled === true` + 这一处 `scene` 非空。缺任意一条，那句话**整段不出现**，回执里连 `imggen_draw` / `scene` 这个词都没有。
+
+### 三个联动，同一条规矩
+
+| 联动 | 开关 | 还要读到 | 还要 |
+| --- | --- | --- | --- |
+| 生图工作室 | `mapImggenOn` | `worlds.imggen.enabled` | 该处 `scene` 非空 |
+| 鱼的每一天 | `mapFeastOn` | `worlds.feast.enabled` | 有地点 |
+| 娱乐时间 | `mapFunOn` | `worlds.fun.enabled` | 该处 `funVenue` 非空 |
+
+只读 `config.json` 的布尔字段——不调对方的工具、不读对方的状态或素材库。三个 8 组真值表钉死（只有全真才提）。
+
+### 旅游：只说那儿长什么样，另给一个「最接近的去处」
+
+远方地名在娱乐时间的场所库里**不存在**，直接让她 `fun_go` 填「海边小镇」，那边会回「没听说过这处」——正是红线禁的「指向不存在的东西」。所以每处预置**最接近的一处**，回执明说不是同一个地方：
+
+| 地点 | 娱乐时间里最接近的 |
+| --- | --- |
+| 海边小镇 | 江边 |
+| 雪山客栈 | 爬山 |
+| 古城老街 | 旧货市场 |
+| 温泉旅馆 | 澡堂 |
+| 林间营地 | 公园 |
+
+> 这一趟想真去逛逛：`fun_go` 的 `place` 填「江边」——那是娱乐时间里**最接近这处**的一处。
+> （不是同一个地方：别把「江边」说成「海边小镇」。）
+
+旅游那套**不带行程**：没有几天、没有怎么去、没有第几天。
+
+### 画风固定 = 每处一句 style + 有图就锁死
+
+1. 每处一句 `style`，出图提示词里固定带上。
+2. **一旦有 `cover` 就锁死，不自动重生**：改文字改不到图（有测试钉住），也没有任何「重画」函数；要换只能主人手动清空再传。
+3. `mapStyleRef`（整图样式参考）这一版**只留字段不实现**。
+
+### 六个工具、零事件
+
+`map_places` / `map_look` / `map_add` / `map_edit` / `map_cover` / `map_view`。
+
+`describe.events` 是**空数组**、`start()` 里没有定时器：什么时候看地图，由「鱼的每一天」那边的一行顺手一提，或者她自己调 `map_places`。
+
+### 配置 5 项
+
+`mapOn` / `mapImggenOn` / `mapFeastOn` / `mapFunOn` / `mapStyleRef`（+ 宿主管的 `enabled`）。宿主 `/api/config` 不合并 defaults，插件自己 `#ensureConfigSection` 补齐——`enabled` 跳过、不覆盖已有值、`persist` 抛错也吞掉。
+
+### 占用很小（实测）
+
+每轮固定成本约 **2.3–3.0k tokens**（`ENV_PROMPT` 585–818 + 六工具 schema 1706–2212），加地点清单后约 2.4–4.2k。清单里每处只带 40 字描写、最多列 20 处，其余「还有 N 处」带过——所以地点再多也不会线性膨胀；完整描写永远由 `map_look` 现给。单次回执：`map_look` 约 0.2k、`map_places`（25 处）约 1.4–2.0k。
+
+### 面板：一张地点卡片墙
+
+有图的卡显示 base64 缩略图，没图的显示文字描写，没写描写显示「还没写描写」。点卡片展开能改名字 / 描写 / 画风 / 别名 / 归类 / `scene` / `funVenue`，标常去，传图 / 换图 / 清空图，删掉这处。顶部能选地形（出勾选表）、加一处。
+
+**界面里没有一个坐标输入框，也没有一根连线**；分组只是展示顺序。渲染出错会把原因显示出来 + 一个「重新载入」，不会停在半截点不动。
+
+### 降级
+
+没装生图 / 挪走素材库 / 关掉任一联动开关 / `scene` 或 `funVenue` 留空 / 没装「鱼的每一天」/ 状态文件坏 / config 坏 / 图片被删——一律静默降级，绝不报错、绝不卸载任何 World。`envPromptVars()` 全程 try/catch；`create()` 保持纯。
+
+### 校验
+
+```
+places 19 / state 38 / world 63 / panels 28 = 148 条
+check-name ✓  check-prompt ✓  check-isolation ✓  smoke ✓  make-describe --check ✓
+```

package/PUBLISHING.md

@@ -0,0 +1,82 @@
+# 发布清单（cortico-world-map）
+
+> 这一版 **0.1.0**，还没发。发布由主人自己在 PowerShell 里敲（`npm publish` 要真 TTY + 6 位 OTP，agent 做不了）。
+
+## 发之前
+
+```powershell
+cd "E:\deep seek\map-world"
+
+# 1) 全套测试（逐个跑，不用 node --test——受限沙箱里 spawn 子进程会 EPERM）
+node test/places.test.mjs
+node test/state.test.mjs
+node test/world.test.mjs
+node test/panels.test.mjs
+
+# 2) 单独跑的自检
+node tools/check-name.mjs        # 显示名三处一致
+node tools/check-prompt.mjs      # 占位符对齐 + 不提生图也能读通
+node tools/check-isolation.mjs   # 不依赖别的 World + 不带路线
+node tools/smoke.mjs             # dry-mount 冒烟
+
+# 3) describe.json 必须与代码一致
+node tools/make-describe.mjs --check
+
+# 4) install.ps1 的 BOM（前 3 字节必须是 239,187,191）
+node tools/fix-ps1-bom.mjs install.ps1
+```
+
+或者一条 `npm run verify`（= 补 BOM + 显示名 + 提示词 + 隔离 + 冒烟 + describe 比对）。
+
+## 发
+
+`npm publish` 需要 **`danger-full-access` + 真 TTY + 6 位 OTP**，必须在主人自己的 PowerShell 里敲：
+
+```powershell
+cd "E:\deep seek\map-world"
+npm pack --dry-run          # 先看会打进包里哪些文件
+npm publish --otp 123456    # 换成你手机上的码
+```
+
+`files` 字段只收 `src / dist / assets / describe.json / CHANGELOG.md / README.md / PUBLISHING.md`——`test/` 和 `tools/` 不进包。
+
+## 发之后验
+
+```powershell
+npm view cortico-world-map version        # 应回 0.1.0
+npm view cortico-world-map dist-tags      # latest 应是 0.1.0
+```
+
+想让它进市场，开一个 `[同步] cortico-world-map` issue。
+
+## 发之前必须确认的两件事
+
+1. **显示名已定稿「鱼的小世界」**（英文 `Little World`，2026-11-15 主人拍板）。
+   - 以后再改，三处一起改，缺一处界面与包里就对不上：`src/config.js` 的 `LABEL`、`package.json` 的 `cortico.displayName` + `locales.*.displayName`、`dist/webui.js` 里 `T.zh` / `T.en` 的 `title`。
+   - `node tools/check-name.mjs` 会把不一致当场抓出来（也已进 `verify` 和 `prepublishOnly`）。
+   - **英文名别带撇号**——`Fish's ...` 那次炸过 JS 单引号字符串，`node --check` 直接 `SyntaxError`。
+2. **`mapStyleRef` 要不要真实现**（整图一张样式参考当所有地点出图的风格基准）。现在只有字段，不影响任何回执。
+
+**`worlds.map` 段名不能改**：world id 必须是 `map`——「鱼的每一天」那边的 `maplink`（归另一个会话）只读 `worlds.map.enabled` 这一个字段。改了名就断了那条契约。
+
+## 版本号
+
+**首发定为 `0.1.0`**（2026-11-15 主人拍板）：`package.json` 的 `version` 与 `CHANGELOG.md` 的段标题都是 `0.1.0`，
+CHANGELOG 是**单节**（描述这一版是什么样，不含开发过程的修前/修后）。
+
+以后改版本号要同时改：
+
+- `package.json` 的 `version`
+- `CHANGELOG.md` 加一节（市场按 `##` 标题里的版本号切段）
+
+**git 提交、发版仍等主人点头。**
+
+## 常见坑
+
+| 坑 | 说明 |
+| --- | --- |
+| 用 `node --test` | 受限沙箱里 spawn 子进程会 EPERM，必须 `node test/xxx.test.mjs` 逐个跑 |
+| 用 `Set-Content` / `.NET` 静态调用改中文文件 | 会乱码。改中文一律用编辑工具或 Node `fs` |
+| `install.ps1` 丢 BOM | PowerShell 5.1 会按 GBK 读中文，整个脚本乱码。`node tools/fix-ps1-bom.mjs` |
+| 改了 `ENV_PROMPT.md` 忘了重跑 describe | `node tools/make-describe.mjs --check` 会报不一致 |
+| 发之前没跑 `check-isolation` | 它挡的是「偷偷依赖别的 World」和「偷偷加路线」，两条都是认证会查的 |

package/README.md

@@ -1,3 +1,205 @@
-# Temporary Holding Version
+# 鱼的小世界（cortico-world-map）
 
-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.
+> 包名 `cortico-world-map`、world id **`map`**、显示名 **「鱼的小世界」**（2026-11-15 定稿，英文 `Little World`）。
+> 需求文档：`MAP-小地图插件-方案.md`。
+
+给 Coo（Coopanion）桌宠一张**「周围的地图」**：家在哪、常去哪儿、附近有什么。
+
+每一处地方只有**文字**——空间、陈设、配色、光线、氛围——外加一句固定的画风锚点，所以同一个地方反复看、反复画都是同一副样子。画面可以**完全靠主人自己上传一张本地图**：装不装别的插件都能用，零成本、画风全由主人定。
+
+## 它刻意没有的东西
+
+**没有路线、没有坐标、没有距离、也没有导航。**
+
+一处地方就是「它长什么样」，不是「怎么走到它」。日程里写去哪是「鱼的每一天」的事，这里只提供「那个地方是什么样子」——所以「森林里的鱼出去上班」这种割裂从根上不会发生：库里列的是「家 / 溪边 / 老橡树」，她自然不会凭空写「公司 / 地铁」。
+
+这条不是「这一版先不做」：`place` 里不许有任何 geo 字段，`test/places.test.mjs` 和 `tools/check-isolation.mjs` 各钉了一道守门断言。
+
+## 装
+
+先把 Coo **完全退出**，然后：
+
+```powershell
+# 预演
+powershell -ExecutionPolicy Bypass -File .\install.ps1 -CooRoot "E:\Coopanion" -DryRun
+
+# 真装
+powershell -ExecutionPolicy Bypass -File .\install.ps1 -CooRoot "E:\Coopanion"
+```
+
+装完重启 Coo，面板 → 世界 →「鱼的小世界」应为 `active`，配置页 5 项。
+
+装上之后 `<数据目录>/../config.json` 里会有 `worlds.map.enabled = true`——**「鱼的每一天」那边的 `maplink` 就靠这一个字段**判断要不要在「自己的时间」里加一行（见下）。
+
+## 开箱：五套预设地形
+
+装上之后进面板选一套，**展开勾选表挑要哪几处**（默认全选、已有的置灰），主人只改文字、传图：
+
+| 地形 | id | 预置地点 |
+| --- | --- | --- |
+| 林间 | `forest` | 家（树洞/小木屋）、老橡树、溪边、蘑菇坡、林间空地 |
+| 小区 | `neighborhood` | 家、楼下长椅、便利店门口、小花园、单元楼道 |
+| 江边 | `riverside` | 家、江堤台阶、旧码头、芦苇滩、江边石墩 |
+| 山脚 | `foothill` | 家、上山口、山泉、半坡亭、碎石坡 |
+| 旅行 | `travel` | 海边小镇、雪山客栈、古城老街、温泉旅馆、林间营地 |
+
+**选地形不等于全加**：点了地形会先出勾选表，勾上哪几处才加哪几处。已有的那几处置灰、不能重复勾；全不勾时「加进去」是灰的，不会静默什么都不做。
+
+**换地形只追加，不删已有地点**——所以「林间」写好的描写，切到「江边」之后还在，两套并存（id 带地形前缀，`forest-home` / `riverside-home`，不撞）。
+
+### 旅行那几处
+
+远方地名，只说「那儿长什么样」。**没有几天、没有怎么去、没有第几天**——那是她日程的事，不是地图的事。
+
+每处预置一个「娱乐时间里最接近的那一处」：
+
+| 地点 | 最接近的 |
+| --- | --- |
+| 海边小镇 | 江边 |
+| 雪山客栈 | 爬山 |
+| 古城老街 | 旧货市场 |
+| 温泉旅馆 | 澡堂 |
+| 林间营地 | 公园 |
+
+为什么不是直接用娱乐时间那二十个正名：它的场所库里**没有**「海边小镇」「雪山」这种词，直接让她 `fun_go` 填这几个字，那边会回「没听说过这处」——正是红线禁的「指向不存在的东西」。所以递的是**最接近的一处**，回执会明说「不是同一个地方，别把『江边』说成『海边小镇』」。
+
+## 两种画面来源
+
+### 来源 A：本地图片（主人上传）—— 可完全独立
+
+面板里每处地方有「传一张图」。图落 `<数据目录>/map/covers/<id>.<ext>`，面板走 `ctx.invoke('cover', {id})` 拿 **base64 data URL** 显示。
+
+- 只认 **png / jpg / webp / gif**，上限 **8 MiB**，按**文件头魔数**校验，**不信扩展名**（从别处拖进来一个改名成 `.png` 的文件会被当场拒掉）。
+- 扩展名按魔数定，不听你传的那个。
+- 不装任何别的插件也能完整使用。
+
+### 来源 B：生图工作室联动 —— 可选，装了才提
+
+**那句「发图时 scene 填 X」只在三条全满足时才出现**：
+
+1. 配置 `mapImggenOn` 开着；
+2. 小地图读到 `worlds.imggen.enabled === true`（**只读 config 这一个布尔字段**，不调它的工具、不读它的素材库）；
+3. 这一处地方的 `scene` 非空（也就是主人真把库里的正名填进来了）。
+
+**缺任意一条，那句话整段不出现**，并且回执里连 `imggen_draw` / `scene` 这个词都不会出现——绝不指向一个不存在的工具或场景名。有测试逐条钉住（`test/world.test.mjs` 的「三道条件」一组）。
+
+`scene` 是**字符串，不是读库**：本插件不读 `imggen-library`，只把「该填哪个名字」递到她嘴边，填参数是她自己做的。
+
+## 画风固定 = 每处一句 style + 有图就锁死
+
+1. **每处地方一句 `style`**：出图提示词里固定带上，同一处地方不同次出图同风格。
+2. **一旦有 `cover` 就锁死，不自动重生**：要换得主人手动点「清空图」，再传一张新的。常去的地方因此永不漂。
+3. `mapStyleRef`（整图样式参考）**这一版只留字段不实现**——空着就是各地点用自己的 `style`。
+
+## 六个工具
+
+| 工具 | 作用 |
+| --- | --- |
+| `map_places` | 列出地点（家 / 常去 / 周围 / 旅行），`frequent` 排前；可 `kind` 筛 |
+| `map_look` | 看某一处：文字描写 + `style` + 有没有图；三条全满足才递「发图填哪个 scene」，旅游处还会递「想真去逛去哪」 |
+| `map_add` | 加一处：只填**文字**（name/aliases/kind/desc/style/scene/funVenue），没有坐标可填 |
+| `map_edit` | 改文字 / 置顶「常去」/ 改 `style` / 改 `scene` / 改 `funVenue`；只动传进来的那几项 |
+| `map_cover` | 换本地图或清空；受「锁死」约束 |
+| `map_view` | 整张小地图（按家 / 常去 / 周围 / 旅行分组铺开，纯展示，**不带路线连线、不带行程**） |
+
+**这个 World 不推任何事件**（`describe.events` 是空数组、`start()` 里没有定时器）。什么时候看地图，由「鱼的每一天」那边的一行提示顺手一提，或者她自己调 `map_places`。
+
+## 配置（5 项，默认都开，热改）
+
+| 键 | 默认 | 作用 |
+| --- | --- | --- |
+| `mapOn` | `true` | 总开关。关掉=不往提示词注入地点清单，工具与面板还在 |
+| `mapImggenOn` | `true` | 可选联动开关。关掉=纯文字+本地图，绝不提 `imggen_draw` |
+| `mapFeastOn` | `true` | 「鱼的每一天」联动。关掉=一个字都不提 `feast_life_plan` / `feast_life_now` |
+| `mapFunOn` | `true` | 「娱乐时间」联动。关掉=不提 `fun_go` / `fun_places` |
+| `mapStyleRef` | 空 | 整图样式参考。**这一版只留字段不实现** |
+
+三个联动开关**都是「开关 + 装没装 + 这处有没有名字」三条全满足才提**，缺一条整段不出现：
+
+| 联动 | 开关 | 还要读到 | 还要 |
+| --- | --- | --- | --- |
+| 生图 | `mapImggenOn` | `worlds.imggen.enabled === true` | 该处 `scene` 非空 |
+| 鱼的每一天 | `mapFeastOn` | `worlds.feast.enabled === true` | 有地点 |
+| 娱乐时间 | `mapFunOn` | `worlds.fun.enabled === true` | 该处 `funVenue` 非空 |
+
+> 宿主的 `/api/config` 读落盘段、**不合并 defaults**，所以插件自己 `#ensureConfigSection` 补齐（照 `fun-world/src/world.js` 那段，`enabled` 跳过、不覆盖已有值），否则界面会显示成 `false`。
+
+## 它和别的 World 是怎么联动的
+
+**不调别的 World 的工具、不读别人的状态或日程文件**（World 契约的红线）。联动只借两样东西：
+
+1. **读 config 一个布尔字段**：`worlds.imggen.enabled`，判断能不能提生图。read 配置文件不算 World 间依赖（和 `feed-world/src/life/funlink.js` 读 `worlds.fun.enabled` 同一套）。
+2. **提示词各写一句指向对方**：本插件 `ENV_PROMPT.md` 里指向 `feast_life_plan` / `feast_life_now`，以及（可选）`imggen_draw`。
+
+```
+鱼的小世界 ──「写日程用地点正名」──→ 鱼的每一天（一句提示词，不调工具）
+鱼的每一天 ──「lifeFreeMenu 列 map_*」──→ 鱼的小世界（maplink，归另一个会话）
+鱼的小世界 ──「可选：发图填地点正名」──→ 生图工作室（三条全满足才提）
+鱼的每一天 ──（0.7.1 已有）──────────→ 生图工作室
+```
+
+### 给「鱼的每一天」那个会话的契约（`maplink`，本插件不实现）
+
+| 项 | 约定 |
+| --- | --- |
+| 新文件 | `feed-world/src/life/maplink.js` |
+| 检测 | `readMapEnabled(dataDir)` 读 `<dataDir>/../config.json` 的 `worlds.map.enabled`（**只读这一个字段**） |
+| 追加行 | `- 看看周围、去个常去的地方：map_places 看有哪些地方 → map_look 看这一处长什么样` |
+| 去重 | 判据「这一行提到 `map_` 开头的工具」；只追加，从不改写 |
+| 开关 | 新配置 `lifeFreeMapOn`（默认 `true`，归「她自己的时间」卡） |
+
+本插件这边要做的事只有一件：**包名 `cortico-world-map`、world id `map`，装了启用后 `worlds.map.enabled` 就是 `true`**。已经做到了。
+
+## 降级验收
+
+| 情况 | 行为 |
+| --- | --- |
+| 没装生图工作室 / 挪走素材库 / 关掉 `mapImggenOn` | 文字 + 本地图全在，只是不出图那句提示；**绝不报错、绝不卸载** |
+| `scene` 留空（库里没有这处） | 一个字都不提，绝不编一个场景名 |
+| 没装「鱼的每一天」/ 关掉 `mapFeastOn` | 不提 `feast_life_*`；生图那句改成「按你这会儿真穿的那身填」 |
+| 没装「娱乐时间」/ 关掉 `mapFunOn` / `funVenue` 留空 | 不提 `fun_*`，旅游那处只给文字和图 |
+| 没装「鱼的每一天」 / 没装 `maplink` | 小地图照常完整可用，只是三方不对齐 |
+| 状态文件坏 / config 坏 / 图被删 | 静默降级：回空库、回「没图」，不抛错 |
+| 图片超过 8 MiB / 不是那四种 | 面板当场拒掉并说清楚，不影响别的 |
+
+`envPromptVars()` 全程 `try/catch` 永不抛错（抛错会把 World 卸载）；`create()` 保持纯（有测试钉住「create 之后目录还是空的」）。
+
+## 面板
+
+装好启用在 Coo 的世界页签里能看到一张**地点卡片墙**：
+
+- 有图的卡显示缩略图（base64 data URL），没图的显示那段文字描写；没写描写显示「还没写描写」。
+- 点卡片展开：改名字 / 描写 / 画风 / 别名 / 归类 / `scene`，标「常去」，传图 / 换图 / 清空图，删掉这处。
+- 顶上是统计、地形下拉（选中即追加）、「加一处」。
+- **没有坐标输入框、没有路线、不按远近排序**——分组只是展示顺序，界面里没有一根连线。
+
+## 校验怎么跑
+
+```powershell
+cd "E:\deep seek\map-world"
+node test/places.test.mjs   # 五套地形 / geo 守门 / id 安全 / hasScene / hasFunVenue
+node test/state.test.mjs    # 加改删传图 / 勾选式追加 / 换地形只追加 / cover 锁死
+node test/world.test.mjs    # 六工具 / 三个 8 组真值表 / 静默降级 / 图片守门
+node test/panels.test.mjs   # 卡片墙 / 勾选表 / base64 缩略图 / 无坐标输入框
+node tools/check-name.mjs   # 显示名三处一致（config / package.json / 面板产物）
+node tools/check-prompt.mjs # 占位符对齐 + 空块时不许出现任何外部工具名
+node tools/check-isolation.mjs # 不依赖别的 World / 不带路线
+node tools/smoke.mjs        # dry-mount 冒烟
+node tools/make-describe.mjs --check
+```
+
+`npm run verify` = 补 BOM + 显示名 + 提示词自检 + 隔离审计 + 冒烟 + describe 比对。
+
+## 还没定的事
+
+- **`mapStyleRef` 要不要真实现**（整图一张样式参考当所有地点出图的风格基准）。现在只有字段，不影响任何回执。
+- **要不要发 npm**（见 `PUBLISHING.md`）。
+- 显示名已定稿「鱼的小世界」。以后要改，得同时动三处，缺一处界面与包里就对不上：`src/config.js` 的 `LABEL`、`package.json` 的 `cortico.displayName` + `locales.*.displayName`、`dist/webui.js` 里 `T.zh` / `T.en` 的 `title`。`node tools/check-name.mjs` 会当场抓到不一致。
+- **英文名不带撇号**：`Fish's ...` 那次炸过 JS 单引号字符串，`node --check` 直接 `SyntaxError`。`check-name.mjs` 里也钉了这一条。
+
+## 相关文档
+
+- `MAP-小地图插件-方案.md` —— 本插件的定稿方案（§3 数据模型 / §4 画面来源 / §6 工具与配置 / §7 maplink 契约 / §10 红线）
+- `FUN-联动方案.md` —— 联动骨架模板（方案 A / C / D 的出处）
+- `IMGGEN-联动方案.md` —— 素材库结构、`entry.json` 字段、红线出处
+- `HANDOFF-2026-11-15-0.7.4-改名与联动.md` —— 0.7.4 现状、`funlink.js` 的来历

package/describe.json

@@ -0,0 +1,226 @@
+{
+  "tools": [
+    {
+      "name": "map_places",
+      "description": "看看周围有哪些地方：家、常去的、附近的、去远处旅行的。每处给一句文字描写、有没有图、是不是常去。默认按「常去 > 家 > 周围 > 旅行」排；想只看一类就填 kind。没有路线、没有远近，也没有「怎么走」。",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "kind": {
+            "type": "string",
+            "description": "只看某一类：家 / 常去的 / 周围 / 旅行（英文 home / frequent / around / travel 也认）。不填就全列。"
+          },
+          "all": {
+            "type": "boolean",
+            "description": "填 true 就列全部，否则也只列全部（这里没有截断，留着这个参数是为了和别的工具一致）。"
+          }
+        },
+        "additionalProperties": false
+      },
+      "tags": [
+        "read",
+        "snapshot"
+      ],
+      "summary": {
+        "zh": "看周围有哪些地方：家、常去的、附近的、旅行的，按常去排前；可只看某一类。",
+        "en": "See the places around her: home, the ones she often goes to, nearby and travel places; can filter by kind."
+      }
+    },
+    {
+      "name": "map_look",
+      "description": "看某一处长什么样：回执给这一处的文字描写、画风锚点、有没有图。写日程说「此刻在哪」、或者想发图之前用它。这处还空着的时候会明说空着——别替主人编一段描写。",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "place": {
+            "type": "string",
+            "description": "哪一处，填正名（家 / 溪边 / 老橡树…），别名也认。"
+          }
+        },
+        "required": [
+          "place"
+        ],
+        "additionalProperties": false
+      },
+      "tags": [
+        "read",
+        "snapshot"
+      ],
+      "summary": {
+        "zh": "看某一处长什么样：文字描写、画风锚点、有没有图；装了生图且这处有场景名才递发图该填哪个 scene，旅游处还会提娱乐时间里最接近那处。",
+        "en": "Look at one place: its written description, style line and whether it has a photo; names the image scene only when that place really has one, and for travel places the nearest venue in Fun time."
+      }
+    },
+    {
+      "name": "map_add",
+      "description": "加一处地方。只填文字：名字、别名、属于哪一类（家 / 常去的 / 周围 / 旅行）、一句描写、一句画风锚点。**不填坐标、不填路线、不填多远**——这个插件没有这些。",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "这处叫什么，例如「溪边」「楼下长椅」。"
+          },
+          "aliases": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "别名，最多 8 个，例如「小溪」「溪水」。"
+          },
+          "kind": {
+            "type": "string",
+            "description": "家 / 常去的 / 周围 / 旅行。不填算「周围」。"
+          },
+          "desc": {
+            "type": "string",
+            "description": "一句话文字描写：只写空间、陈设、配色、光线、氛围——不写姿势表情、不写她在干什么、不写「从这里走十分钟到哪」。"
+          },
+          "style": {
+            "type": "string",
+            "description": "一句画风锚点，以后每次出图都带上，越稳定越好。"
+          },
+          "scene": {
+            "type": "string",
+            "description": "生图素材库里的场景正名，**主人知道库里有什么才填**；拿不准就别填，留空不影响任何事。"
+          },
+          "funVenue": {
+            "type": "string",
+            "description": "娱乐时间里**最接近这处**的那个场所正名（例如「江边」「爬山」）；填了才可能提「想真去逛去哪」，拿不准就别填。"
+          },
+          "frequent": {
+            "type": "boolean",
+            "description": "是不是常去（置顶）。"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "additionalProperties": false
+      },
+      "tags": [
+        "write"
+      ],
+      "summary": {
+        "zh": "加一处地方：只填文字（名字、别名、归类、描写、画风），没有坐标也没有远近。",
+        "en": "Add a place: words only (name, aliases, kind, description, style); no coordinates, no distances."
+      }
+    },
+    {
+      "name": "map_edit",
+      "description": "改某一处的文字：描写、画风锚点、别名、归类、是否常去、scene 正名、娱乐时间那处。只改传进来的那几项，没传的一个字都不动。要换图用 map_cover。",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "place": {
+            "type": "string",
+            "description": "改哪一处，填正名或 id。"
+          },
+          "name": {
+            "type": "string",
+            "description": "改成这个正名。"
+          },
+          "aliases": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "整套别名（不是追加）。"
+          },
+          "kind": {
+            "type": "string",
+            "description": "家 / 常去的 / 周围 / 旅行。"
+          },
+          "desc": {
+            "type": "string",
+            "description": "换成这段文字描写。"
+          },
+          "style": {
+            "type": "string",
+            "description": "换成这句画风锚点。"
+          },
+          "scene": {
+            "type": "string",
+            "description": "换成这个 scene 正名；传空串就是清掉（以后不再提发图填什么）。"
+          },
+          "funVenue": {
+            "type": "string",
+            "description": "换成娱乐时间里最接近这处的那一处正名；传空串就是清掉（以后不再提去那儿逛）。"
+          },
+          "frequent": {
+            "type": "boolean",
+            "description": "标成 / 取消「常去」。"
+          }
+        },
+        "required": [
+          "place"
+        ],
+        "additionalProperties": false
+      },
+      "tags": [
+        "write"
+      ],
+      "summary": {
+        "zh": "改某一处的文字、画风、归类、是否常去、scene 正名、娱乐时间那处；只动传进来的那几项。",
+        "en": "Edit one place: words, style, kind, frequent flag, scene name, nearest Fun time venue; only the fields passed in."
+      }
+    },
+    {
+      "name": "map_cover",
+      "description": "这处地方的图：换成本地的一张、或者清空。**图是主人从面板上传的**，不是这里画的；你来这里只做两件事——把主人放好的那张挂上去，或者清空。清空之后主人才可以再放一张新的（有图的时候它锁死，不会自己变）。",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "place": {
+            "type": "string",
+            "description": "哪一处，填正名或 id。"
+          },
+          "file": {
+            "type": "string",
+            "description": "要挂的图片文件名（主人已经放进这处目录的那张）。不填就看现在挂着什么。"
+          },
+          "clear": {
+            "type": "boolean",
+            "description": "填 true 就清空这处的图。"
+          }
+        },
+        "required": [
+          "place"
+        ],
+        "additionalProperties": false
+      },
+      "tags": [
+        "write"
+      ],
+      "summary": {
+        "zh": "换这处地方的本地图或清空；有图就锁着不自动变，清空之后主人才可以再放一张。",
+        "en": "Swap or clear the local photo of one place; a photo stays put once set, and only the owner puts a new one."
+      }
+    },
+    {
+      "name": "map_view",
+      "description": "整张小地图：按「家 / 常去的 / 周围 / 旅行」分组把每一处铺开，带文字描写和有没有图。纯展示——**没有连线、没有路线、没有远近、也没有行程**。",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      },
+      "tags": [
+        "read",
+        "snapshot"
+      ],
+      "summary": {
+        "zh": "整张小地图：按家 / 常去 / 周围 / 旅行分组铺开，纯展示，没有连线、没有路线、也没有行程。",
+        "en": "The whole little map: grouped as home / frequent / around / travel, display only, no lines, no routes and no itinerary."
+      }
+    }
+  ],
+  "events": [],
+  "prompts": [
+    {
+      "key": "worlds.map.env",
+      "title": "鱼的小世界",
+      "role": "envPrompt",
+      "content": "## 小地图\n\n你周围有哪些地方——家在哪、常去哪儿、附近有什么、去远处旅行可以是什么样。每一处只有**文字**：空间、陈设、配色、光线、氛围，加一句固定的画风锚点；有主人放的图就照着那张看。\n\n**这里没有路线、没有坐标、没有距离、也没有导航。** 一处地方就是「它长什么样」，不是「怎么走到它」。所以不要从这儿推「走十分钟到 X」「先出小区再左转」——这种话不该出现在你说的地方上。\n\n- 想看有哪些地方：`map_places`。默认按「常去 > 家 > 周围 > 旅行」排，`kind` 能只看一类（家 / 常去的 / 周围 / 旅行）。\n- 想看某一处具体长什么样：`map_look`（`place` 填正名，别名也认）。回执给那句描写、画风锚点、有没有图。\n- 这处还空着、没写描写时，回执会明说「还没写描写」——**那就说不知道，别替主人编一段**。那是他的地方，不是你的。\n- 主人加地方、改描写、传图都在面板里做，或者让你用 `map_add` / `map_edit` / `map_cover`。加地方**只填文字**：名字、别名、归类、一句描写、一句画风锚点，没有坐标可填。\n- 一处地方一旦有了图就**锁着**，不会自己变；要换得主人先清空再放一张新的。所以看到有图的那处，就照着那张说，别另画一张。\n\n{{map_places_block}}\n\n## 旅行那几处\n\n「旅行」这一类的几处地方是**远方**：海边小镇、雪山客栈、古城老街、温泉旅馆、林间营地那种。\n\n- 它只回答「那儿长什么样」。**几天、怎么去、先去哪后去哪、行程怎么排，都不在这里**——那是你自己日程该管的事，别从小地图里推行程。\n- 真想去的时候，回执会告诉你娱乐时间里**最接近这处的一处**是哪个。那是「最接近的一处」，不是同一个地方：别把「江边」说成「海边小镇」，也别把「澡堂」说成「温泉旅馆」。\n- 只是想想、说说那儿是什么样，也完全可以——不去也是一种说法。\n\n{{map_feast_block}}\n\n{{map_imggen_block}}\n\n## 不用你操心的事\n\n- 你不必为了「地图上有这处」才去某处；不去也照样是这处地方。\n- 主人没写描写的地方就是空的，空着不是待办，不用催他填。\n- 地点会一直是这些，改的是文字和画面，不是路线和远近。\n"
+    }
+  ]
+}