扣扣空间

Setu Cloud v2.5 音乐功能重磅上线！

Sat, 27 Dec 2025 22:00:00 GMT

序言

距离 Setu Cloud v2 正式上线已经过去两周了，这段时间收到了很多小伙伴的反馈和建议。在保持原有图片 API 服务稳定运行的基础上，我们决定做一些"不务正业"的事情——给控制台加入音乐播放功能！

没错，现在你可以一边管理 API Key，一边听着网易云音乐放松心情了。这次更新不仅仅是简单的功能堆砌，而是从用户体验出发，打造了一套完整的音乐管理系统。

Setu Cloud 地址: https://cloud.yukiryou.icu/

核心更新

1. 全局音乐播放器

我们在控制台底部集成了一个全局音乐播放器，无论你切换到哪个页面，音乐都不会停止。

主要特性：

固定底部设计：采用毛玻璃效果，与整体 UI 风格完美融合
展开/收缩模式：可一键切换简洁/完整模式，节省屏幕空间
完整播放控制：上一曲、播放/暂停、下一曲、播放模式切换
实时进度条：可拖拽跳转到任意时间点
音量调节：支持静音和音量滑块控制
歌词展示：点击展开歌词面板，支持点击跳转、自动滚动跟踪

预览

2. 音乐搜索与播放

集成了网易云音乐 API，可以搜索海量曲库并在线播放。

核心功能：

智能搜索：支持歌曲名、歌手、专辑全文检索
快速操作：每首歌提供 4 个快捷按钮
- 🎵 播放：立即播放并加入播放列表
- 📋 添加到播放列表：仅添加不播放，适合批量收藏
- ➕ 添加到歌单：保存到自定义歌单
- ⬇️ 下载：一键下载高品质音频
字段映射优化：完美适配网易云 API 返回格式
超时处理：30 秒超时配置，避免长时间等待

预览

3. 我的歌单

支持创建自定义歌单，管理你的音乐收藏。

歌单管理功能：

创建歌单：自定义名称、描述、封面 URL
编辑歌单：随时修改歌单信息
播放模式：支持 4 种播放模式
- 顺序播放：按顺序播放到最后停止
- 随机播放：随机选择下一首
- 列表循环：播放完自动回到第一首
- 单曲循环：重复播放当前歌曲
歌曲排序：拖拽调整播放顺序
一键播放：直接播放整个歌单
公开/私密：控制歌单是否对外可见

预览

4. 播放历史

自动记录播放历史，最多保留 50 条记录。

历史功能亮点：

智能时间显示：
- 1 分钟内 → "刚刚"
- 1 小时内 → "5 分钟前"
- 今天 → "今天 14:30"
- 昨天 → "昨天 20:15"
- 其他 → "12 月 25 日 18:00"
分页浏览：支持 10/20/50 条每页
快速播放：点击历史记录直接播放
清空历史：一键清空所有记录

预览

5. 播放列表管理

类似网易云音乐的播放队列功能。

列表特性：

实时队列：显示当前播放列表
音波动画：正在播放的歌曲有动态指示器
快速操作：点击播放、移除歌曲、清空列表
数字徽章：显示列表中的歌曲数量
抽屉设计：侧边滑出，不遮挡主要内容

技术实现细节

这次音乐功能的实现，涉及了不少技术挑战：

前端架构

全局状态管理：使用 Pinia 管理音乐播放状态、歌单、历史记录
HTML5 Audio API：原生 audio 元素控制播放
自动播放优化：监听 canplay 事件，确保音频加载完成后再播放
歌词解析：正则表达式解析 LRC 格式歌词 [mm:ss.xx]歌词内容
播放模式逻辑：根据不同模式计算下一曲索引

后端集成

网易云 Token 管理：管理员可配置多个 Cookie，自动轮换使用
播放历史存储：每次播放自动调用后端 API 记录
字段映射：前端转换网易云 API 字段 (ar→artists, al→album, dt→duration)

用户体验优化

请求超时：默认 30 秒超时，搜索结果限制 10 条避免卡顿
毛玻璃效果：backdrop-filter: blur(20px) 打造视觉统一性
响应式设计：移动端自动隐藏部分信息，保持界面简洁
平滑动画：过渡动画让交互更流畅

快速上手指南

想要体验音乐功能？只需两步：

第一步：登录控制台 访问 Setu Cloud 官网并登录你的账号。

第二步：开始听歌 在左侧菜单点击 「音乐搜索」，输入你想听的歌曲，点击播放按钮即可。底部会出现全局播放器，切换页面也不会停止播放！

可选：创建歌单 点击 「我的歌单」 -> 「创建新歌单」，输入歌单名称和描述，然后从搜索页面添加歌曲到歌单。下次可以直接播放整个歌单。

可选：查看历史 点击 「播放历史」，可以看到最近播放的 50 首歌曲，点击即可重新播放。

技术栈更新

音乐功能基于以下技术实现：

前端：

Vue 3 Composition API (script setup)
Pinia 状态管理 (音乐 store)
HTML5 Audio API
Naive UI (NModal, NDrawer, NBadge 等组件)
TypeScript 严格类型检查

后端集成：

网易云音乐 API 代理
Cookie 池管理与轮换
播放历史持久化存储
歌单 CRUD 接口

优化细节：

音频预加载与缓冲处理
歌词实时滚动算法
播放模式状态机
全局播放器生命周期管理

已知问题 & 后续计划

已知问题：

部分歌曲因版权原因无法播放（网易云 API 限制）
歌词可能存在时间轴不准的情况（取决于网易云数据质量）

后续计划：

[ ] 支持歌单分享功能
[ ] 添加歌词翻译显示
[ ] 引入歌手/专辑详情页
[ ] 支持本地上传音乐
[ ] 添加音乐可视化效果

结语

Setu Cloud 从一个简单的图片 API 服务，逐渐演变成了一个多功能的娱乐控制台。音乐功能的加入，让开发者在管理 API 的同时也能享受片刻的放松。

这次更新耗时约一周，从需求设计到功能实现，再到 UI 打磨，每一个细节都经过了反复推敲。虽然"不务正业"，但确实提升了使用控制台的幸福感😊

欢迎大家登录体验，如果有任何建议或遇到 BUG，欢迎通过邮件或 QQ 反馈！

说个题外话，一边写代码一边循环播放《昔涟》真的很上头，崩铁的音乐制作真的绝了！推荐大家搜索试试这首歌～

相关链接：

Setu Cloud: https://cloud.yukiryou.icu/
反馈邮箱: yuki@yukiryou.online

Setu Cloud v2正式上线！

Sat, 13 Dec 2025 22:30:00 GMT

序言

最近一段时间没有更新博客了主要原因就是在写需求文档然后空闲时间在给setu_api完善好并写一个用户端和管理端。时间紧每天太累了，懒得更新了就。不过现在也是正式完工了。不过写什么都是以学习为目的，以交流为主，有问题希望锐评我。

Setu Cloud地址:https://cloud.yukiryou.icu/

相比于 v1 版本，v2 不仅仅是一次简单的版本号迭代，更是从交互体验到底层架构的一次全面升级。引入了全新的设计语言，重写了 API 管理逻辑，旨在为开发者提供更稳定、更美观、更易用的图片 API 服务。

核心更新

1.UI设计

我们抛弃了传统枯燥的后台管理界面，基于 Naive UI 打造了一套全新的“极光毛玻璃”设计系统。

沉浸式体验：全站背景采用动态模糊与半透明卡片设计，视觉层次丰富。
响应式布局：无论是桌面大屏还是移动端，控制台都能完美适配，随时随地管理你的服务。

预览

2. 更加灵活的 API Key 管理

在 v2 版本中，我们引入了更完善的鉴权机制。

自主创建：用户登录控制台后，可自助创建多个 API Key，用于区分不同的项目或环境。
配额可视化：在仪表盘中，你可以实时查看每个 Key 的今日调用、总调用以及剩余配额，用量一目了然。
安全可控：支持随时重命名、禁用或删除泄露的 Key，保障账户安全。

预览

3. 服务稳定性提升

后端架构进行了优化，引入了更完善的 IP 频率限制与黑名单防御机制，有效防止恶意刷接口导致的服务波动，确保正常用户的请求更加极速、稳定。

看板娘预览

快速上手指南

想要使用 Setu Cloud v2 的服务非常简单，只需三步：

第一步：注册与登录 访问 Setu Cloud 官网，使用邮箱注册账号。登录后，你将直接进入全新的用户仪表盘。

第二步：获取 API Key 在左侧菜单点击 「API Key 管理」 -> 「新建 API Key」。输入一个备注名称（例如 "My Blog"），点击创建。系统会生成一串密钥，请务必立即复制并保存。

第三步：发起调用 现在，你可以使用任何 HTTP 客户端调用接口了。记得在 Header 中带上你的 Key：

Bash

# 示例：使用 cURL 调用
curl -X GET "https://api.yukiryou.icu/setu/v2" \
     -H "X-API-Key: sk-你的密钥"

技术栈一览

对于感兴趣的开发者，Setu Cloud v2 的前端构建于以下现代技术栈之上：

核心框架：Vue 3 (Script Setup)
构建工具：Vite 5
UI 组件库：Naive UI
状态管理：Pinia
语言：TypeScript

结语

Setu Cloud 的初衷是提供简单、好用的二次元图片接口服务。v2 的上线是一个新的开始，未来我们将持续引入更多实用的功能（如更多维度的图片筛选、图库搜索等）。

欢迎大家注册体验，如果有任何建议或遇到 BUG，欢迎通过邮件或 QQ 提交反馈！

说个题外话，今天打一下午未许之地突袭8，谁能告诉我这玩意到底怎么过，越打越破防。

二次元随机美图api

Thu, 04 Dec 2025 02:22:00 GMT

起因

一直以来总想根据自己的性趣去部署一个图片api，最近购置了阿里云服务器进行备案，就干脆把阿里云的服务器拿来搭建好了。

API v2

https://api.yukiryou.icu/setu/v2

接口地址（GET / POST 通用）


/setu/v2

返回格式：JSON

请求参数说明

参数名	数据类型	默认值	描述
`r18`	int	0	0 非 R18，1 R18，2 混合
`num`	int	1	返回数量，范围 1–20
`uid`	int[]	无	按作者 UID 过滤（最多 20 个）
`keyword`	string	无	标题 / 作者 / 标签模糊匹配
`tag`	string[]	无	标签 AND / OR 组合匹配
`size`	string[]	["original"]	返回图片尺寸（可多选）
`proxy`	string	i.pixiv.re	替换图片 URL 域名
`dateAfter`	long	无	上传时间 ≥ 此时间（毫秒）
`dateBefore`	long	无	上传时间 ≤ 此时间（毫秒）
`dsc`	boolean	false	禁用自动缩写转换
`excludeAI`	boolean	false	排除 AI 作品（aiType = 2）
`aspectRatio`	string	无	图片宽高比过滤

标签（tag）高级匹配规则

标签匹配支持 AND / OR 组合，大小写不敏感。

AND 规则（数组之间）

例如：


tag=萝莉|少女

tag=黑丝|白丝

这代表：


(萝莉 OR 少女) AND (黑丝 OR 白丝)

OR 规则（同一个字符串内用 `|` 分隔）

例如：


tag=巨乳|おっぱい

表示匹配其中任意一个即可。

匹配范围：

| 字段 | 是否参与匹配 |

|------|-------------|

| 标签（tags） | ✔ |

| 标题（title） | ✔ |

| 作者（author） | ✔ |

全部以小写 + 包含（contains）匹配方式处理。

GET 示例

1️⃣ 获取 1 个非 R18 的随机图（默认 original 尺寸）


GET https://api.yukiryou.icu/setu/v2

2️⃣ 获取 5 张 original + regular 尺寸图片


GET https://api.yukiryou.icu/setu/v2?num=5&size=original&size=regular

3️⃣ 标签高级匹配示例


GET https://api.yukiryou.icu/setu/v2?tag=萝莉|少女&tag=白丝|黑丝

即：


(萝莉 OR 少女) AND (白丝 OR 黑丝)

4️⃣ 按关键字模糊搜索


GET https://api.yukiryou.icu/setu/v2?keyword=碧蓝航线

5️⃣ 按作者 uid 搜索


GET https://api.yukiryou.icu/setu/v2?uid=12345&uid=67890

6️⃣ 限制长宽比


GET https://api.yukiryou.icu/setu/v2?aspectRatio=1.6-1.8

7️⃣ 过滤 AI 图


GET https://api.yukiryou.icu/setu/v2?excludeAI=true

📨 POST 示例

POST 支持 JSON 的二维 tag：


{

  "num": 5,

  "r18": 0,

  "tag": [

    ["萝莉", "少女"],

    ["黑丝", "白丝"]

  ],

  "size": ["original", "regular", "small"],

  "excludeAI": false

}

就是：


tag=萝莉|少女

tag=黑丝|白丝

返回格式

示例：


{

  "error": "",

  "data": [

    {

      "pid": 82675630,

      "p": 0,

      "uid": 8244461,

      "title": "水着ル・マラン",

      "author": "Vldjm13",

      "r18": false,

      "width": 3360,

      "height": 3960,

      "tags": ["アズールレーン","碧蓝航线","水着"],

      "ext": "png",

      "aiType": 0,

      "uploadDate": 1593535904000,

      "urls": {

        "original": "https://i.yukiryou.top/img-original/...png",

        "regular": "https://i.yukiryou.top/img-master/..._master1200.jpg",

        "small": "/c/540x540_70/img-master/..._master1200.jpg",

        "thumb": "/c/250x250_80_a2/img-master/..._square1200.jpg",

        "mini": "/c/48x48/img-master/..._square1200.jpg"

      }

    }

  ]

}

🔄 图片 URL 自动生成逻辑

你只需要 original，即：

/img-original/.../90551655_p0.jpg

API 会自动生成：

size	URL 规则
original	`/img-original/.../90551655_p0.jpg`
regular	`/img-master/.../p0_master1200.jpg`
small	`/c/540x540_70/img-master/..._master1200.jpg`
thumb	`/c/250x250_80_a2/img-master/..._square1200.jpg`
mini	`/c/48x48/img-master/..._square1200.jpg`

⚠️ 注意事项

num 最大为 20
original 为唯一保证存在的尺寸
PNG 原图不一定有 regular/small/thumb/mini
标签大小写不敏感
tag 与 keyword 组合可能降低性能

其他服务

QQ Bot

后续可能优化一下并公开插件

QQbot插件优化

Tue, 02 Dec 2025 02:22:00 GMT

起因

最近一直在做p站的api，目前进度只有6000+的图片信息，数据库部分信息类似下图

所有图片均来自 Pixiv，版权也归作品的作者所有，API 仅储存了作品的基本信息，不提供图片的储存服务
为保证质量的话，所有图片信息都是根据本人xp来的，这里不过多解释了总之就是任务还没完成，只能偷工减料了。

QQ Bot

qq号:2830323446

成果一览

发图插件

- setu 随机仅从 外部 API + 数据库 取图；

- setu pid=... / uid=... / tag=...：官方优先→失败自动回退 API → DB，并 **通知主人；

- 随机策略：随机跳页 + 水库采样，避免“第一页偏置”；

优化过程

::github{repo="Tsuk1ko/pxder"} 通过以上项目可以获取到你自己账号的refresh_token，然后就可以愉快的获取pixiv的信息了。

具体实现（可直接复用的核心函数）

1) Pixiv 官方认证（refresh_token → access_token）


import requests

from pixivpy3 import AppPixivAPI

  

_OAUTH_TOKEN_URL = "https://oauth.secure.pixiv.net/auth/token"

_CLIENT_ID = "MOBrBDS8blbauoSck0ZfDbtuzpyT"

_CLIENT_SECRET = "lsACyCD94FhDUtGTXi3QzcFE2uU1hqtDaKeqrdwj"

_UA = "PixivAndroidApp/5.0.234 (Android 11; Pixel 5)"

  

def exchange_by_refresh_token(refresh_token: str):

    headers = {

        "User-Agent": _UA,

        "Referer": "https://app-api.pixiv.net/",

        "App-OS": "android",

        "App-OS-Version": "11",

        "App-Version": "5.0.234",

    }

    data = {

        "client_id": _CLIENT_ID,

        "client_secret": _CLIENT_SECRET,

        "grant_type": "refresh_token",

        "refresh_token": refresh_token,

        "include_policy": "true",

    }

    r = requests.post(_OAUTH_TOKEN_URL, headers=headers, data=data, timeout=30)

    r.raise_for_status()

    j = r.json()

    if "access_token" not in j:

        raise RuntimeError(f"token 交换失败：{j}")

    return j["access_token"], j.get("refresh_token", refresh_token)

  

def make_aapi(refresh_token: str) -> AppPixivAPI:

    at, rt = exchange_by_refresh_token(refresh_token)

    aapi = AppPixivAPI(timeout=30)

    aapi.set_auth(at, rt)

    try: aapi.set_accept_language("zh-CN")

    except: pass

    return aapi

2) 随机策略：随机跳页 + 水库采样


import random

  

def extract_pages(ill: dict) -> list[str]:

    out = []

    if ill.get("meta_pages"):

        for p in ill["meta_pages"]:

            img = p.get("image_urls") or {}

            u = img.get("original") or img.get("large") or img.get("medium")

            if u: out.append(u)

    if not out:

        if ill.get("meta_single_page", {}).get("original_image_url"):

            out.append(ill["meta_single_page"]["original_image_url"])

        else:

            img = ill.get("image_urls") or {}

            u = img.get("original") or img.get("large") or img.get("medium")

            if u: out.append(u)

    return out

  

def random_one_from_uid(aapi, uid: int, max_jumps: int = 30) -> str | None:

    res = aapi.user_illusts(uid)

    if not res or not getattr(res, "illusts", None): return None

    jumps = random.randint(0, max_jumps)

    cur = res

    for _ in range(jumps):

        if not getattr(cur, "next_url", None): break

        qs = aapi.parse_qs(cur.next_url)

        cur = aapi.user_illusts(**qs)

        if not cur or not getattr(cur, "illusts", None): break

    cand = getattr(cur, "illusts", []) or []

    if not cand: return None

    pages = extract_pages(random.choice(cand))

    return random.choice(pages) if pages else None

  

def random_one_from_tag(aapi, tag: str, max_jumps: int = 30) -> str | None:

    res = aapi.search_illust(tag, search_target="partial_match_for_tags")

    if not res or not getattr(res, "illusts", None): return None

    jumps = random.randint(0, max_jumps)

    cur = res

    for _ in range(jumps):

        if not getattr(cur, "next_url", None): break

        qs = aapi.parse_qs(cur.next_url)

        cur = aapi.search_illust(**qs)

        if not cur or not getattr(cur, "illusts", None): break

    cand = getattr(cur, "illusts", []) or []

    if not cand: return None

    pages = extract_pages(random.choice(cand))

    return random.choice(pages) if pages else None

3) 官方→API→DB 回退链路


async def notify_owner(bot, owner_qq: int, text: str, event=None):

    try:

        if hasattr(bot, "send_private"):

            await bot.send_private(owner_qq, f"[setu告警] {text}"); return

    except Exception:

        pass

    if event is not None:

        await bot.send(event, f"[setu告警] @{owner_qq} {text}")

  

async def get_by_pid_uid_tag_with_fallback(session, bot, event, owner_qq, refresh_token,

                                           pid: int|None, uid: int|None, tag: str|None,

                                           fetch_from_api, fetch_from_db):

    try:

        aapi = await asyncio.to_thread(make_aapi, refresh_token)

        if pid is not None:

            det = await asyncio.to_thread(aapi.illust_detail, pid)

            ill = det.illust

            urls = extract_pages(ill) if ill else []

        elif uid is not None:

            u = await asyncio.to_thread(random_one_from_uid, aapi, uid)

            urls = [u] if u else []

        elif tag:

            u = await asyncio.to_thread(random_one_from_tag, aapi, tag)

            urls = [u] if u else []

        else:

            urls = []

        if urls: return urls

        await notify_owner(bot, owner_qq, "官方为空，回退 API", event)

    except Exception as e:

        await notify_owner(bot, owner_qq, f"官方异常：{e}，回退 API", event)

  

    # API

    try:

        api_urls = await fetch_from_api(session, [] if pid or uid else ([f"tag={tag}"] if tag else []))

        if api_urls: return api_urls[:1]

        await notify_owner(bot, owner_qq, "API 为空，回退 DB", event)

    except Exception as e:

        await notify_owner(bot, owner_qq, f"API 异常：{e}，回退 DB", event)

  

    # DB

    try:

        db_urls = await fetch_from_db(1, None, tag, uid)

        return db_urls[:1] if db_urls else []

    except Exception as e:

        await notify_owner(bot, owner_qq, f"DB 异常：{e}，最终失败", event)

        return []

结果

结果就是我发现标签查询效果更好了，标签匹配更吻合了，非常满意

首次提交备案

Sat, 29 Nov 2025 02:22:00 GMT

准备工作

我们都知道国内服务器是需要备案的，但备案需要准备些什么呢？

首先选择一家合适的域名服务商进行代备案，我选择的是阿里云。
其次我们需要准备一个可备案域名和国内云服务器。

开始

准备好之后就可以申请备案了，我本以为备案会很复杂，但我提交申请到阿里云提交到管局审核也没花很长时间，不过我申请的时间是在周末，我想应该需要下周六才能通过了吧。

结束

附一张申请记录做为纪念

关于我对“赞助”的思考

Fri, 28 Nov 2025 02:22:00 GMT

开始

首先我们要弄明白什么叫赞助。在我的常识里，赞助就是用户为了某个活动、某个项目、某篇文章(具体来说就是某件事或物)提供经济支持。当我对别人赞助时，我不禁在思考，别人收到我的赞助会有什么心情和想法。虽然我知道我赞助的不算多，也并不是为了什么而去选择赞助。我仅仅是因为看到某些对我有帮助的文章，才会选择赞助对方，也希望对方能够提供更多有趣有帮助的文章。

Ciallo～ (∠・ω< )⌒★，搭建博客，重新开始

Wed, 26 Nov 2025 02:22:00 GMT

开始

闲着没事做，就想着好好搭建一个博客玩一下，正好觉得平时比较喜欢的博主:2x树树魔改的博客网站还不错，自己也部署一个试试。不过我也没啥文笔，没什么说的就这样吧。

扣扣空间

Setu Cloud v2.5 音乐功能重磅上线！

序言

核心更新

1. 全局音乐播放器

预览

2. 音乐搜索与播放

预览

3. 我的歌单

预览

4. 播放历史

预览

5. 播放列表管理

技术实现细节

前端架构

后端集成

用户体验优化

快速上手指南

技术栈更新

已知问题 & 后续计划

结语

Setu Cloud v2正式上线！

序言

核心更新

1.UI设计

预览

2. 更加灵活的 API Key 管理

预览

3. 服务稳定性提升

看板娘预览

快速上手指南

技术栈一览

结语

二次元随机美图api

起因

API v2

请求参数说明

标签（tag）高级匹配规则

AND 规则（数组之间）

OR 规则（同一个字符串内用 | 分隔）

匹配范围：

GET 示例

1️⃣ 获取 1 个非 R18 的随机图（默认 original 尺寸）

2️⃣ 获取 5 张 original + regular 尺寸图片

3️⃣ 标签高级匹配示例

4️⃣ 按关键字模糊搜索

5️⃣ 按作者 uid 搜索

6️⃣ 限制长宽比

7️⃣ 过滤 AI 图

📨 POST 示例

返回格式

🔄 图片 URL 自动生成逻辑

⚠️ 注意事项

其他服务

QQbot插件优化

起因

QQ Bot

成果一览

优化过程

具体实现（可直接复用的核心函数）

1) Pixiv 官方认证（refresh_token → access_token）

2) 随机策略：随机跳页 + 水库采样

3) 官方→API→DB 回退链路

结果

首次提交备案

准备工作

开始

结束

关于我对“赞助”的思考

开始

Ciallo～ (∠・ω< )⌒★，搭建博客，重新开始

开始

OR 规则（同一个字符串内用 `|` 分隔）