yzsp-studio/mediakit-shared-suite / app-builder
app-builder
Unverified统一处理应用级和工程级产品的设计、开发、编辑及产物问答(单页html和h5的开发和设计不要使用这个skill)。当用户明确点名「妙搭」时请使用本技能。适用于全栈应用,包括多页面或多文件工程、前端框架、后端服务、API、数据库、登录权限、业务逻辑、构建运行和发布部署。也支持基于 PRD、文档、截图或素材开发应用,以及对已有应用新增功能、调整页面、修复 Bug、分析源码、排查运行错误和查询运营或发布状态。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 52.5 KB |
| reference/app-manage.md | markdown | 6.8 KB |
| reference/html-develop.md | markdown | 24.1 KB |
| reference/publish.md | markdown | 30.6 KB |
| reference/steering/charts.md | markdown | 11.8 KB |
| reference/steering/data-viz.md | markdown | 12.2 KB |
| reference/steering/frontend-design.md | markdown | 9.1 KB |
| reference/steering/hi-fi-design.md | markdown | 2.7 KB |
| reference/steering/interactive-prototype.md | markdown | 2.4 KB |
| reference/steering/mini-game.md | markdown | 4.6 KB |
| reference/steering/slide-deck.md | markdown | 18.6 KB |
| reference/steering/three-js.md | markdown | 3.3 KB |
| reference/steering/visual-report.md | markdown | 10.7 KB |
| reference/webapp-develop.md | markdown | 24.1 KB |
| reference/webapp/stack/react-standard-webapp.md | markdown | 34.2 KB |
reference/steering/three-js.md
View on GitHub---
name: three-js
description: Three.js r147 UMD 引入方式参考。做 3D 场景 / 3D 小游戏、需要用 script 标签引入 Three.js 时按需读取,不单独作为媒介入口命中。
metadata:
display-names:
zh: Three.js 引入
---
# Three.js r147 UMD 引入指南(3D 小游戏按需)
r147 是最后一个含 UMD `examples/js/` 的版本:经典 `<script>` 标签引入,全局 `THREE` 命名空间。无需 importmap、无需 `type="module"`。
## 基础引入
```html
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js" integrity="sha384-vV17nr/rMaJqmeZkFUzXLpHdQ+ME5QHKdydaqqN+3Ga39RJlNrTatJxHwGV4ml2C" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/controls/OrbitControls.js"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/loaders/GLTFLoader.js"></script>
<script>
const controls = new THREE.OrbitControls(camera, renderer.domElement);
const loader = new THREE.GLTFLoader();
</script>
```
覆盖路径:`examples/js/{controls,loaders,postprocessing,objects,shaders,exporters,...}/<Name>.js`。
## extensions 隐式依赖(黑屏陷阱)
**`examples/js` 下各文件之间有隐式全局依赖,且按 script 标签顺序求值。漏引或顺序错会直接抛 `TypeError` 并中断整个初始化脚本——页面卡在 loading 或永久黑屏,且没有任何报错提示。** 用到 addon 时整段复制下方清单,不要只挑名字对得上的那几个。
## 后期处理(EffectComposer / Bloom 等)——整段复制,顺序不可调换
```html
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js"></script>
<!-- EffectComposer.js 内部定义 THREE.Pass 基类,必须排在所有 *Pass 之前 -->
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/postprocessing/EffectComposer.js"></script>
<!-- 纯 shader 对象,供下面的 Pass 引用 -->
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/shaders/CopyShader.js"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/shaders/LuminosityHighPassShader.js"></script>
<!-- 各 Pass 均为 class X extends THREE.Pass,依赖上面的基类 -->
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/postprocessing/ShaderPass.js"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/postprocessing/RenderPass.js"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/postprocessing/UnrealBloomPass.js"></script>
```
| 你要用 | 必须同时引入 |
|---|---|
| `EffectComposer` | `CopyShader` + `ShaderPass`(构造函数里立即用到) |
| `UnrealBloomPass` | `LuminosityHighPassShader` + `CopyShader` |
| 任意 `*Pass` | `EffectComposer.js`(提供 `THREE.Pass` 基类),且必须排在它之后 |
只引 `EffectComposer` + `RenderPass` + `UnrealBloomPass` 这三个是**错的**,会报 `THREE.ShaderPass is not a constructor`。
## 色彩管理(r147 默认 Linear,必须显式启用 sRGB)
```js
renderer.outputEncoding = THREE.sRGBEncoding; // 输出 sRGB
texture.encoding = THREE.sRGBEncoding; // 颜色纹理(baseColor / albedo)
// 注意:normalMap / roughnessMap / metalnessMap 保持默认 Linear,不要改
```
未启用会导致 PBR 材质看上去发淡 / 过饱和。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |