因幡巡主题皮肤 · Inaba Meguru Skin
DSH Web GUI 的一套纯展示层主题：活力橙 × 围巾金 × 校服粉、拍立得照片墙、满屏立绘、星屑装饰、侧栏小巡、Ciallo 台词，自带「设置 → 因幡巡」配置页。
A pure presentational theme for the DSH Web GUI: polaroid photo wall, full-screen artwork, ambient decorations, a sidebar mascot and settings page.
角色 / Character: 因幡巡（いなば めぐる）· 柚子社《魔女的夜宴》 / Yuzusoft "Sanoba Witch"
配色 / Palette: 活力橙 #EF7D33 · 围巾金 #F2C14E · 校服粉 #F27B9E
⚠️ 本仓库只包含代码，不含任何角色素材。 图片需要你自己准备（见 素材准备）。
This repo contains code only — no character artwork. You bring your own images.
✨ 特性 / Features
| |
|---|
| 🎚️ 三档出场强度 | 克制（边缘装饰）/ 标准（满屏底色）/ 满屏（立绘进场），随时切换 |
| 🖼️ 三种底图 × 深浅两版 | 照片墙（深色深棕墙 / 浅色米白墙各一套）、官方 CG、夜色渐变 |
| ⚙️ 原生设置页 | 「设置 → 因幡巡」改强度/底图/装饰/台词，点一下即生效 |
| 🌟 氛围装饰 | 星屑、光带、十字星芒、垂饰、蛋挞/手柄/爱心小物、侧栏小巡 |
| 💬 Ciallo 台词 | 输入框下方「Ciallo～(∠·ω< )⌒★」+ 侧栏小巡气泡 |
| 🧹 纯展示层 | 关闭插件即完全还原（CSS/标记/token/插槽一起撤） |
| 🖥️ 素材走同源路由 | 图片放 assets/ 即用，不内嵌、不改包、刷新即生效 |
📦 安装 / Install
从 GitHub 安装（推荐）
dsh plugin --profile web add github:mol-inko/dsh-client-ui-skin-inaba-meguru
想固定到某个提交（可复现）：
dsh plugin --profile web add github:mol-inko/dsh-client-ui-skin-inaba-meguru#<commit-sha>
从本地目录安装
dsh plugin --profile web add /path/to/dsh-client-ui-skin-inaba-meguru
或在 DSH 会话里让 Agent 用 plugin_manager 的 install_bundle 装本地目录。
装完刷新页面 → 设置 → 因幡巡。没有素材时也能装：底图自动降级成纯渐变。
🎨 素材准备 / Assets
本仓库不含官方图（版权在柚子社）。你需要自备并生成：
pip install pillow numpy
# 1) 把图放进 assets/ref-char/（文件名对照见 assets/README.md）
# 2) 生成两版照片墙
python tools/make_wall.py
# 3) 生成立绘 / CG / 头像
python tools/make_images.py hero assets/ref-char/3.png
python tools/make_images.py cg assets/ref-char/c_070c69eac9dd943c.png
python tools/make_images.py face assets/ref-char/3.png
生成的 5 个文件（assets/*.webp）已被 .gitignore 排除——别把它们提交到仓库。
assets/
├── bg-wall-dark.webp 深色主题照片墙（3200×2000）
├── bg-wall-light.webp 浅色主题照片墙（3200×2000）
├── art-hero.webp 满屏档立绘（透明底）
├── bg-cg.webp 官方 CG 底图
└── face.webp 圆形头像
素材缺失时对应层自动降级成纯渐变，不会报错。
⚙️ 设置 / Settings
设置 → 因幡巡（settings.section，id inaba-meguru）：
| 项 | 取值 |
|---|
| 出场强度 | 克制 / 标准 / 满屏 |
| 底图 | 照片墙 / 官方 CG / 夜色 |
| 氛围装饰 | 开 / 关 |
| 台词 | 开 / 关 |
配置落在 $DSH_HOME/inaba-meguru/config.json，由 Host 路由 /inaba-meguru/api 读写（同源 cookie 鉴权）。
🔌 HTTP surface
| 路由 | 说明 |
|---|
GET /inaba-meguru/api | 读外观配置 |
POST /inaba-meguru/api | { action: 'save', patch } / { action: 'reset' } |
GET /inaba-meguru/assets/<name> | 皮肤素材（白名单 5 个文件名，每次读盘） |
所有路由走宿主 connection.requestRejection 信任栅栏 + 插件自校验（回环 Host / 同源 Origin / 拒跨站）。
🧩 兼容 / Compatibility
- DSH 0.2.1-rc.2（
settings.section 插槽、webServer.register 的 prefix 路由）
- 可与其它皮肤（如
ui-skin-maid-atelier）并存：设置 → 插件里各占一行，开一个关另一个即可
- 客户端改动刷新即生效（宿主按需重建 client bundle）；
index.js 改动需重启 host
🛠️ 开发 / Development
index.js Host 半：配置读写 + 素材路由（prefix）+ 三层鉴权
client.js Client 半：CSS 主题 / 三档强度 / 两版底图 / 设置页 / 装饰层
cordis.patch.yml bundle 挂载声明
assets/ 素材（不入库，见上）
tools/ 素材生成脚本（Pillow）
退出/卸载时所有写入挂在 ctx.effect 上自动撤销。
🙏 Credits
- 信任栅栏的三层结构参考自 dsh-whale-widget（MIT）的「安全修复 S1」。
- 插件注册写法参考社区插件
dsh-workflow-panel 的 apply() 形状（不包 ctx.effect、直接返回 disposer）。
⚖️ 版权 / Legal
- 代码：MIT（见 LICENSE）
- 素材：不随仓库分发。「因幡巡」及《魔女的夜宴》美术版权归 柚子社（Yuzusoft） 所有；
本项目为同人非商业作品，与柚子社、DeepSeek 均无关联。
- 素材由使用者自行提供：请使用你自己合法拥有或有权使用的图片（官方公开素材、自己绘制或 AI 生成等），
仅限个人使用，不要二次分发官方图。
📄 License
MIT for the code. Character artwork is © Yuzusoft and is not included.
