马尔福桌面 op7418/malfoy-desktop

马尔福桌面 · Malfoy Desktop

和马尔福小姐（Miss Malfoy）一起，住进斯莱特林公共休息室的互动桌面。 Live with Miss Malfoy in the Slytherin common room — an interactive short drama on your desktop.

中文 · English

怎么用

macOS（仅支持 Apple Silicon）
1. 到 Releases 下载 Miss-Malfoy-mac-arm64.dmg，打开后把 Miss Malfoy 拖进「应用程序」。
2. 安装包没有签名，第一次打开会被拦下：右键 → 打开；如果还是打不开，到「系统设置 → 隐私与安全性」，在最下面点「仍要打开」。
3. 打开后她会出现在桌面上，菜单栏多出一个 🐍。选「和她互动…」进入互动模式，就能点她、打开下面的菜单，第一章在「剧情」里。按 Esc 回到壁纸模式。

Windows（Wallpaper Engine）
1. 在 Steam 上装好 Wallpaper Engine。
2. 打开创意工坊页面，点「订阅」，然后在 Wallpaper Engine 里选中它。
3. 第一次打开会先播第一章，看完她会走进休息室。
4. 要能点到她，在 Wallpaper Engine 的设置里打开「鼠标输入」。声音默认是关的，在壁纸属性里打开「壁纸声音」。

DeepSeek Harness（主题插件）
1. 装好 DeepSeek Harness，然后执行：
dsh plugin --profile web add https://github.com/op7418/malfoy-desktop/releases/latest/download/dsh-malfoy-desktop.tgz
dsh web

2. 整个窗口会变成斯莱特林公共休息室：开场一团飞路火烧出界面，对话时背景虚化，智能体做完或等你批准时她会抬头说一句。剧情、相册、换装在侧栏的「休息室」里。详见 插件说明。

一个用 即梦 AI 短剧工作室 做的沉浸式角色扮演加 AI 女友桌面 Demo。

你扮演刚转进斯莱特林的转学生，在午夜的禁书区遇见马尔福小姐。看完第一章之后，她会一直待在你桌面上的斯莱特林公共休息室里：
- 待机：她看书、翻页、伸懒腰，晚上会睡着
- 互动：点她，她会回你一句
- 好感度：好感度越高，她对你的称呼越近，还会解锁新装扮和她的 CCD 合照
- 冥想盆：看过的剧情随时可以回看

画面、角色和对白配音全部由即梦生成，音乐由 Suno 生成；剪辑、魔法转场特效和桌面程序是用代码做的。

- 架构与生成过程，事无巨细：技术文档.md
- 素材说明：MEDIA.md
- 后续计划：TODO.md

仓库里有什么

这里只放代码。视频、图片、音乐、剧本和文章是我们自己的作品，不公开；安装包里已经带好了运行需要的素材。

├─ 共享资源/ 三个项目共用的代码与字体 │ ├─ lib/magic.js Three.js 魔法特效：飞路火焰、冥想盆、荧光闪烁、银墨书写、斯莱特林法阵 │ ├─ lib/hogwarts-ui.css 界面组件 │ ├─ lib/type-system.css 视频里的字体与排版 │ ├─ lib/fx.js 上一版特效（碎裂、银尘、粒子环），保留备查 │ └─ fonts/ Cormorant Garamond、Cinzel、DSEG7（均为 SIL OFL 1.1） ├─ 剪辑/ 剧情正片（HyperFrames 工程） ├─ 宣传片/ 宣传片（HyperFrames 工程） ├─ 桌面程序/ │ ├─ app/ 网页核心：播放引擎、剧情、好感度、相册、UI │ ├─ mac/ Electron 外壳与打包 │ ├─ wallpaper-engine/ Windows 版工程文件（其余内容从 app/ 拷贝） │ └─ tools/ 静止循环、图标生成脚本 ├─ plugins/ │ └─ dsh-malfoy-desktop/ DeepSeek Harness 主题插件（网页部分复用 桌面程序/app/） └─ 工具/ 语音识别、响度母带、运动热图、安装包打包

从源码运行，需要按 MEDIA.md 里的路径和文件名自备素材：

桌面程序
cd 桌面程序/mac && npm install
npm start # 开发运行（会先把 ../app 同步到 web/）
npm run dist # 打包 dmg

视频（在 剪辑/ 或 宣传片/ 目录里）
npx hyperframes preview --background
npx hyperframes render -o renders/输出.mp4
../工具/master-loudness.sh renders/输出.mp4 renders/输出_master.mp4 # 母带：-15 LUFS / -1 dBTP

依赖：Node 22、ffmpeg 8、HyperFrames CLI 0.8.210、Electron 33.2.1、electron-builder 25.1.8、three.js 0.160.0、GSAP 3.14.2。语音识别另需 faster-whisper（Python venv，small.en / medium.en）。

制作

- 画面、角色、场景、对白配音：即梦 AI 短剧工作室
- 音乐：Suno（主题曲 Say Nothing Tonight、剧情配乐 Clockwork Hush、桌面 BGM Hush, Piano Alone）
- 剪辑、特效、桌面程序：HyperFrames、Three.js、GSAP、Electron

许可

- 代码：PolyForm Noncommercial 1.0.0。可以学习、研究，也可以在非商业前提下修改和分发，不能商用；如需商用，请联系作者。
- 安装包里的素材（视频、图片、音乐）：只用于个人体验，不授权再分发、二次剪辑或商用。
- 字体：各自遵循 SIL Open Font License 1.1。

声明

这是一个非商业的同人创作。《哈利·波特》相关的人物、名称、世界观版权归原作者及华纳兄弟所有，本项目与他们没有任何关联，也没有得到授权。角色"马尔福小姐"是基于原作人物的性转二创，所有出场人物均已成年。请勿将本项目用于商业用途，也不要把它重新打包上架到应用商店或创意工坊。官方的 Windows 版只发布在作者自己的创意工坊页面。

使用方法

macOS（仅支持 Apple Silicon）
1. 从 Releases 下载 Miss-Malfoy-mac-arm64.dmg，把 Miss Malfoy 拖进 Applications。
2. 应用没有签名，macOS 第一次会拦截：右键 → 打开。如果还是打不开，去 系统设置 → 隐私与安全性，点底部的 仍要打开。
3. 她会出现在你的桌面上，菜单栏里也会多出一个 🐍。选「和她互动…」就能点她、用菜单；第一章在「剧情」里。按 Esc 回到壁纸模式。

Windows（Wallpaper Engine）
1. 在 Steam 上安装 Wallpaper Engine。
2. 打开创意工坊页面，点 订阅，然后在 Wallpaper Engine 里选中它。
3. 第一次启动会播放第一章，之后她走进公共休息室。
4. 在 Wallpaper Engine 设置里打开 鼠标输入，就能和她互动。声音默认关闭，在壁纸属性里打开「壁纸声音」。

DeepSeek Harness（主题插件）
1. 安装 DeepSeek Harness，然后运行： bash
dsh plugin --profile web add https://github.com/op7418/malfoy-desktop/releases/latest/download/dsh-malfoy-desktop.tgz
dsh web
2. 整个窗口变成斯莱特林公共休息室：壁炉的飞路火焰把界面「烧」进来，你聊天时房间会虚化，智能体结束任务或需要审批时，她会抬头说一句台词。故事、相册和服装都在侧边栏的「休息室」下。详见插件 README。

Malfoy Desktop（马尔福桌面）是一个沉浸式角色扮演 Demo，也是 AI 桌面伴侣，主角是马尔福小姐，用即梦 AI 短剧工作室打造。

你扮演一名刚转学来的新生，被分到斯莱特林。某天深夜在禁书区，你撞见了马尔福小姐。第一章结束后，她就留在你的桌面上，待在斯莱特林公共休息室里：

- 待机生活：她在沙发上读书、翻页、伸懒腰，晚上 11 点后睡着。她不动的时候，炉火和窗光仍在流动（4K）。
- 互动：点她一下，她会回应你。
- 分支故事：第一章《禁书区》要你做一次选择，每个答案她的反应都不一样。
- 好感度：好感度升高后，她对你的称呼会变，还能解锁一套居家服、一个扶手椅场景，以及一本相册，里面是六张 Y2K 数码相机风格的照片。
- 冥想盆：回放你看过的任意一段记忆。

所有画面、角色和配音对白都用即梦生成；音乐用 Suno 制作。剪辑、魔法转场（飞路火焰、冥想盆漩涡、荧光闪烁、银色墨水、斯莱特林纹章——全部用 Three.js 实现）和桌面程序都是代码。

本仓库内容

只有代码。视频、图片、音乐、剧本和文章都是我们自己的作品，不在此发布；安装包里已包含运行所需的一切。

- 共享资源/（shared）：Three.js 魔法特效库（lib/magic.js）、UI 套件和字体
- 剪辑/（film）和 宣传片/（trailer）：HyperFrames 视频项目
- 桌面程序/（desktop app）：Web 核心（播放引擎、故事、好感度、相册、UI）、Electron 外壳和 Wallpaper Engine 项目
- plugins/dsh-malfoy-desktop/：DeepSeek Harness 主题插件，复用 Web 核心
- 工具/（tools）：语音识别、响度母带处理、动作映射、发布打包

要从源码运行，先把你自己的媒体文件放到 MEDIA.md 列出的路径，然后： bash
cd 桌面程序/mac && npm install
npm start # run in development
npm run dist # build the dmg

完整架构和生产流程记录在技术文档.md（中文）。

许可

- 代码：PolyForm Noncommercial 1.0.0。你可以出于非商业目的学习、修改和分享。不允许商业使用；商业授权请联系作者。
- 安装包内的媒体（视频、图片、音乐）：仅供个人使用。不允许再分发、二次剪辑和商业使用。
- 字体：SIL Open Font License 1.1。

免责声明

这是非商业同人项目。Harry Potter 的角色、名称与设定归 J.K. Rowling 与 Warner Bros. 所有；本项目与二者无隶属关系，也未获其认可。「Miss Malfoy」是性别转换的同人解读，所有角色均为成年人。请勿将本项目用于商业用途，也不要重新打包后发布到应用商店或创意工坊。Windows 正式版仅在作者本人的创意工坊页面发布。