feat: skin site UUID lookup - auto-fetch UUID from player name

- GET /settings/uuid-lookup?site=&name= : proxy Yggdrasil API
  (POST {site}/api/yggdrasil/api/profiles/minecraft), SSRF guard,
  10s timeout, name regex, UUID formatting (with dashes)
- GET /settings/skin-site : public read of configured skin site
- settings page: 皮肤站地址 config
- bind identity modals (player dashboard + admin users): 获取UUID button,
  auto-fill site from settings, auto-fill UID from lookup
- verified live against littleskin.cn (Steve -> df273bda...)
- API docs updated
This commit is contained in:
2026-08-17 02:05:21 +08:00
parent a6a548b1ce
commit 1d669fd1d0
5 changed files with 120 additions and 2 deletions

View File

@@ -93,14 +93,47 @@ const Dashboard = {
<div class="form-group"><label>来源</label><select id="ident-source"><option value="netease">网易端</option><option value="skin">皮肤站</option></select></div>
<div class="form-group"><label>游戏名 *</label><input id="ident-name" required placeholder="Minecraft ID"></div>
<div class="form-group" id="ident-uid-group"><label>网易UID</label><input id="ident-uid" placeholder="仅网易端必填"></div>
<div class="form-group hidden" id="ident-skin-group">
<label>皮肤站地址</label>
<div style="display:flex;gap:6px">
<input id="ident-site" placeholder="https://littleskin.cn" style="flex:1">
<button type="button" class="btn btn-o btn-sm" id="ident-fetch-btn" style="flex:0 0 auto;white-space:nowrap"><i class="fas fa-magnifying-glass"></i> 获取UUID</button>
</div>
<span class="help">输入皮肤站用户名后点「获取UUID」自动填入下方UID</span>
</div>
<div id="ident-err" class="alert alert-e hidden"></div>
<div class="modal-f"><button type="button" class="btn btn-o" onclick="App.closeModal()">取消</button><button type="submit" class="btn btn-p">绑定</button></div>
</form>
`);
document.getElementById('ident-source').onchange = () => {
const toggleSource = () => {
const isNetease = document.getElementById('ident-source').value === 'netease';
document.getElementById('ident-uid-group').style.display = isNetease ? '' : 'none';
document.getElementById('ident-uid').required = isNetease;
document.getElementById('ident-skin-group').classList.toggle('hidden', isNetease);
};
document.getElementById('ident-source').onchange = toggleSource;
toggleSource();
// 自动带出站点配置的皮肤站地址
API.get('/settings/skin-site').then(r => {
if (r.site && !document.getElementById('ident-site').value) document.getElementById('ident-site').value = r.site;
}).catch(()=>{});
document.getElementById('ident-fetch-btn').onclick = async () => {
const site = document.getElementById('ident-site').value.trim();
const name = document.getElementById('ident-name').value.trim();
if (!site) return alert('请填写皮肤站地址');
if (!name) return alert('请先填写游戏名(皮肤站用户名)');
const btn = document.getElementById('ident-fetch-btn');
btn.disabled = true; btn.innerHTML = '<i class="fas fa-spinner fa-spin"></i> 查询中';
try {
const r = await API.get(`/settings/uuid-lookup?site=${encodeURIComponent(site)}&name=${encodeURIComponent(name)}`);
if (r.found) {
document.getElementById('ident-uid').value = r.uuid;
alert('已获取 UUID: ' + r.uuid);
} else {
alert(r.message || '未找到该用户名');
}
} catch (ex) { alert(ex.message); }
btn.disabled = false; btn.innerHTML = '<i class="fas fa-magnifying-glass"></i> 获取UUID';
};
document.getElementById('ident-form').onsubmit = async e => {
e.preventDefault();