guofeng-threejs SKILL.md skillA

guofeng-threejs from sanhuang520-ship-it/awesome-chinese-ai-tools is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sanhuang520-ship-it/awesome-chinese-ai-tools/guofeng-threejs@git:20260822.3f4a804

Pins git:20260822.3f4a804 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sanhuang520-ship-it/awesome-chinese-ai-tools
Path
skills/guofeng-threejs/SKILL.md
Versions recorded
5
Latest version
git:20260822.3f4a804, committed Aug 22, 2026
First version recorded
Aug 13, 2026
Size
18,321 bytes
Repository stars
11
License
MIT

国风 3D 网页渲染。当用户要"水墨风 3D""中国风网页特效""Three.js 水墨""国风 H5""青绿山水 3D""非真实感渲染 NPR""古风 WebGL"时使用。提供可运行的中式渲染 shader 与实现方法,不是通用 Three.js 教程。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 国风 Three.js 渲染

**定位说明**:通用 Three.js 教程已经很多(英文社区有大量高质量资源)。
这个技能只做一件他们不做的事——**中式美学的实时渲染**。

## 什么时候用

中国风官网 / 文旅 H5 / 品牌活动页 / 水墨风交互 / 国风游戏原型 / 非真实感渲染(NPR)。

**不适用**:通用 3D 建模、物理仿真、写实渲染——那些去看 Three.js 官方文档更好。

## 先问清楚

1. **载体**(PC 官网 / 手机 H5 / 微信内嵌)—— 决定性能预算
2. **要哪种中式质感**(水墨 / 青绿山水 / 敦煌壁画 / 剪纸皮影)
3. **有没有模型**(有 glTF?还是用几何体?)
4. **动效需求**(自动旋转 / 跟随鼠标 / 滚动驱动)

> ⚠️ **移动端警告**:Three.js + 自定义 shader 在中低端安卓上会明显发热掉帧。
> H5 项目务必先确认目标机型,必要时降级为静态图。

## 水墨渲染的三个核心

水墨效果不是加个滤镜,是**三件事的组合**:

### 1️⃣ 墨分五色 —— 色阶量化

真实光照是连续的,水墨是**分层**的。把明暗量化成 5 阶:

```glsl
float lam = max(dot(N, normalize(uLight)), 0.0);
float steps = 5.0;
float q = floor(clamp(lam, 0.0, 1.0) * steps) / (steps - 1.0);
vec3 col = mix(uInk, uPaper, q);   // 浓墨 → 纸白
```

> 阶数太多(>8)失去水墨感,太少(<3)像色块。**5 阶是甜点**。

### 2️⃣ 边缘积墨 —— rim 压深

毛笔在轮廓处停留更久,墨更浓。用视线与法线夹角模拟:

```glsl
float rim  = 1.0 - max(dot(N, normalize(vV)), 0.0);
float edge = smoothstep(0.45, 0.95, rim);
col = mix(col, uInk, edge * 0.85);
```

### 3️⃣ 笔触扰动 —— 噪声打破机械感

纯数学量化的边界太整齐,不像手绘。**在量化前扰动光照值**:

```glsl
float n = noise(vP * 5.5 + uTime * 0.06);
lam += (n - 0.5) * 0.16;          // 扰动幅度别超过 0.2
```

再叠一层细噪声当宣纸颗粒:

```glsl
col *= 0.97 + 0.03 * noise(vP * 40.0);
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sanhuang520-ship-it/awesome-chinese-ai-tools/guofeng-threejs@sha256:ead83bdbd099b87a

The line at the top of this page pins the label git:20260822.3f4a804, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_op7isb4hyhnsyk5b.svg)](https://markdownregistry.com/a/art_op7isb4hyhnsyk5b)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 13, 2026 and Aug 22, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260822.3f4a804 latest2026-08-22 3f4a804 18,321 BA view · diff
git:20260822.6e821c82026-08-22 6e821c8 15,765 BA view · diff
git:20260820.9c4dc342026-08-20 9c4dc34 12,616 BA view · diff
git:20260820.cdd2f192026-08-20 cdd2f19 8,938 BA view · diff
git:20260813.4dbb4e22026-08-13 4dbb4e2 6,609 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18321 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

sanhuang520-ship-it/awesome-chinese-ai-tools · 11 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_op7isb4hyhnsyk5b
GET https://markdownregistry.com/api/v1/resolve?ref=sanhuang520-ship-it/awesome-chinese-ai-tools/guofeng-threejs
GET https://markdownregistry.com/api/v1/blob/ead83bdbd099b87ab1853814377d9a872c4795af4332b7dd14c92da19727ea40

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sanhuang520-ship-it/awesome-chinese-ai-tools

DESIGN.md DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · DESIGN.md
git:20260812.f828705 · audit A · 11 stars
llms.txt llms.txt file
sanhuang520-ship-it/awesome-chinese-ai-tools · llms.txt
git:20260914.683ae36 · audit A · 11 stars
ai-learning-coach SKILL.md skill
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/ai-learning-coach/SKILL.md · 用 AI 系统学习任何东西的教练。当用户要"学 XX""怎么入门""帮我制定学习计划""我想搞懂 XX""考证/备考""复习"时使用。不是直接讲答案,而是带着走完整的学习循环:定目标→输入→主动回忆→输出→纠错→间隔复习→项目交付。
git:20260812.8dc2f6e · audit A · 11 stars
book-digest-cn SKILL.md skill
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/book-digest-cn/SKILL.md · 中文拆书与读书笔记助手。当用户要"拆书""读书笔记""这本书讲什么""帮我读这本书""做读书卡片""写书评""整理一本书的框架"时使用。重点是把书变成能用的东西,不是复述目录。
git:20260812.8dc2f6e · audit A · 11 stars
bookkeeping-cn SKILL.md skill
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/bookkeeping-cn/SKILL.md · 中文记账与账目整理助手。当用户要"记账""整理流水""做收支表""对账""分类消费""做预算""看看钱花哪了"时使用。只做数据整理与呈现,不提供税务筹划或投资建议。
git:20260812.8dc2f6e · audit A · 11 stars
chinese-design-md SKILL.md skill
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/SKILL.md · 中式 DESIGN.md 设计系统。当用户要"中国风网页""国风页面""中式设计系统""给项目定个中式风格""DESIGN.md""让 AI 按设计规范生成界面""中文网页排版规范"时使用。提供 8 套可直接丢进项目根目录的…
git:20260812.8dc2f6e · audit A · 11 stars
DESIGN.md@skills/chinese-design-md/design-md/azurite DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/design-md/azurite/DESIGN.md · 石青与石绿的矿物色,取自《千里江山图》的色彩体系。装饰性强,适合文旅、展览、需要「贵气」的场景。 Azurite and malachite mineral pigments, drawn from the color system of…
v1 · audit A · 11 stars
DESIGN.md@skills/chinese-design-md/design-md/bamboo DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/design-md/bamboo/DESIGN.md · 竹青与素白,清爽。适合健康、教育、环保、任何想显得「干净有生气」的场景。 Bamboo green and plain white. Fresh and clean.
v1 · audit A · 11 stars
DESIGN.md@skills/chinese-design-md/design-md/dunhuang DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/design-md/dunhuang/DESIGN.md · 土红、石青、土黄,带斑驳的壁画质感。最有故事感的一套,适合文化 IP、展览、叙事型页面。 Earthy ochre, azurite and clay yellow with weathered mural texture. The…
v1 · audit A · 11 stars
DESIGN.md@skills/chinese-design-md/design-md/ink DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/design-md/ink/DESIGN.md · 宣纸的米白、墨的层次、大量留白。最克制的一套,适合长文阅读、文化类内容、需要「安静」的界面。 Rice-paper off-white, graded ink tones, generous emptiness. The most…
v1 · audit A · 11 stars
DESIGN.md@skills/chinese-design-md/design-md/neo DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/design-md/neo/DESIGN.md · 木色与暖灰,低饱和,线条简洁。最百搭的一套,适合家居、生活方式、品牌官网。 Wood tones and warm greys, low saturation, clean lines. The most versatile set.
v1 · audit A · 11 stars
DESIGN.md@skills/chinese-design-md/design-md/night DESIGN.md file
sanhuang520-ship-it/awesome-chinese-ai-tools · skills/chinese-design-md/design-md/night/DESIGN.md · 深色底配暖金,唯一一套深色主题。适合影音、夜间模式、高端活动、需要「戏剧感」的页面。 Dark ground with warm gold — the only dark theme in this set. Cinematic and…
v1 · audit A · 11 stars

Every file in sanhuang520-ship-it/awesome-chinese-ai-tools

Browse by kind, by grade A, or by owner.