前言¶

长时间阅读、写代码或写论文时，环境里的谈话声、车流声和电器嗡鸣很容易打断思路。有人会随手打开一个固定的雨声或咖啡馆循环，但不同任务对节奏感和频谱的需求并不一样；纯靠试听往往试不出稳定可用的组合。

「学习白噪音库」是 SkillHub 上的一条社区 education 类 Skill（@user_70c2f807/study-white-noise-library，v1.0.0）。它把 Agent 约束成「学习音景顾问」：根据任务类型、干扰源和偏好，输出分层配方、时段策略和工具方向，而不是泛泛推荐一个 App。下面介绍它是什么、能做什么，以及如何安装与使用。

这是什么¶

定位： 当用户需要按学习场景推荐或生成沉浸式音景（雨声、咖啡馆、图书馆等）以提升专注力时，由 Agent 按 Skill 内规则作答；不用于音乐创作、专业混音、冥想引导或睡眠障碍治疗。

维护与来源： 发布者为 SkillHub 社区用户 user_70c2f807，来源标记为 community，分类为 education。SkillHub 页面显示评分 100000、下载约 825 次（统计以商店为准）。标签标明 requires_api_key=false，安装后无需额外 API Key。

要解决的问题： 把「用什么白噪音」变成可执行的音景配方（底层 / 中层 / 点缀、音量占比、时长与番茄钟配合），并说明限制——Skill 明确写明无法直接播放音频，只提供描述与平台 / App 推荐方向。

核心功能¶

以下能力均来自 Skill 自带的 SKILL.md 说明：

1. 按任务匹配音景：阅读、写作、记忆、计算等学习任务，对应不同推荐逻辑。
2. 多层配方设计：组合自然音（雨、溪流、风）、环境音（咖啡馆、图书馆、火车）与混合音景，并给出音量配比建议。
3. 时段化方案：专注期、休息期、切换过渡的音景安排，可与学习流程（如番茄钟）对齐。
4. 干扰遮蔽建议：针对人声、低频环境噪声等，说明遮蔽思路（含白噪音 / 粉噪音 / 棕噪音的差异与适用场景）。
5. 工具方向：指向 Noisli、Coffitivity、myNoise、Brain.fm、Rainy Mood 等的使用方向（非强制绑定某一产品）。
6. 安全与边界：提醒音量（如建议总量约 40–50dB、长期使用注意听力）、不适用医学级干预，以及对听觉敏感、耳鸣等情况的处理指引。

安装与启用¶

1. 准备 SkillHub CLI¶

先确认本机是否已安装 skillhub：

command -v skillhub && skillhub --version

若未安装，可按 SkillHub 官方安装文档执行（完整安装或仅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装说明原文：https://skillhub.cn/install/skillhub.md

2. 安装到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 目录；装到错误路径时 Agent 不会加载。官方搜索索引给出的安装命令为：

skillhub install study-white-noise-library --namespace user_70c2f807 --dir <你的 skills 目录>

常见路径示例（以 SkillHub 安装文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将下面提示词发给支持 Skill 的 AI，让其按官方流程安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_70c2f807/study-white-noise-library`。

安装完成后，按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。

典型用法¶

Skill 在「快速开始」中给出了可直接复现的对话入口，例如：

1. 「我写论文时需要什么白噪音能帮我集中注意力？」
2. 「推荐一个适合深夜学习的环境音组合」
3. 「咖啡馆白噪音和图书馆白噪音有什么区别？各适合什么任务？」
4. 「我容易被人声干扰，有没有屏蔽人声的音景方案？」
5. 「帮我设计一个 2 小时学习时段的音景切换方案」

Agent 按 Skill 约定的四步执行：了解场景 → 匹配音景 → 输出配方 → 使用策略。输出形态为「学习音景配方卡」，包含场景、目标、干扰源、分层表格（音源、音量占比、作用）、使用建议、备选方案与推荐工具方向。用户需在 Noisli、myNoise 等工具中自行混音播放。

同发布者还有「专注模式」（focus-mode）Skill，侧重专注时段与白噪音建议；若既要计时又要音景配方，可按需求分别安装，避免混用职责。

适用场景与注意¶

适合谁

• 需要为不同学习任务定制环境音、又不愿反复试听的开发者与学生。
• 已在用白噪音 App，但希望 Agent 给出结构化配方和时段策略的用户。
• 希望 Agent 主动说明听力安全、不适用医疗场景等边界的团队。

限制与坑

• 不播放音频：只能得到文字配方与工具方向，播放仍依赖外部 App 或网站。
• 效果因人而异：Skill 要求对「听白噪音更烦躁」等情况给出降音量、换类型或接受安静环境的建议。
• 勿当治疗手段：睡眠障碍、耳鸣声治疗等应走专业渠道；Skill 在「不适用场景」表中已列出。
• 开放办公室：需兼顾对同事呼唤的响应，Skill 建议入耳降噪与更低音量，而非追求完全隔绝。
• 商店统计：SkillHub 页面显示安装数为 0 仅表示商店侧计数，不代表本地无法通过 CLI 安装；以你本机 skillhub install 结果为准。

结尾¶

「学习白噪音库」把学习场景、干扰源和任务类型收敛成可执行的音景配方与使用策略，并明确不播放音频、不替代医学干预。若你希望在 Cursor 等 Agent 里用自然语言拿到分层方案，可按上文命令安装 v1.0.0 社区版 Skill。

官方页面：https://www.skillhub.cn/skills/user_70c2f807/study-white-noise-library
API 坐标：https://api.skillhub.cn/user_70c2f807/study-white-noise-library