前言¶
做智能体或音乐相关工具时，演唱者往往只有一段清唱干声和主观感受，很难把「我适合唱什么」「嗓子有没有问题」「混音该怎么调」拆成可对照的指标。通用对话模型可以泛泛而谈，但缺少基于同一段音频的可复现数值。声生观察台是 DeepSeek Harness（DSH）上的模型推理类插件：上传清唱干声，在浏览器侧完成解码与分析，输出音域、频段、嗓况指标与编曲混音方向性建议。下面按定位、能力、安装与使用说明。
这是什么¶
声生观察台 · Sonic Observer 由维护者 MOHE007 发布，在 DSH 插件目录中归类为「模型推理」。npm 包名为 dsh-shengsheng-observer，当前 README 标注版本为 v0.5，package.json 中为 0.5.0，许可为 MIT。
插件解决的核心问题：用一段清唱干声，客观回答三类问题——我适合唱什么（适配）、嗓子状态如何（嗓况）、编曲混音怎么调（制作）。v1 设计为本地优先：音频解码与分析在浏览器完成，音频不上传服务器。
核心功能¶
README 将输出分为三个板块，当前 v0.5 各板块均有内容。
适配¶
回答「我适合唱什么」，包括但不限于：音域（最低/最高/舒适区）、频段能量分布、音色倾向、风格方向；并含波形、频谱、音高、音域、频段能量、动态等分析维度。
嗓况¶
回答「我的嗓子状态如何」，提供 jitter、shimmer、HNR，以及气声 / 颗粒感 / 稳定度等参考指数，并附带护嗓与就医提示。官方明确：嗓况板块只提供客观指标与就医提示，不是医疗诊断，也不能替代嗓音科/耳鼻喉科检查。
制作¶
回答「编曲混音怎么调」，涵盖频谱平衡、EQ 建议、动态与压缩、齿音与呼吸声、频段冲突等方向性建议。
交互与语言¶
支持上传后试听：播放 / 暂停、拖动进度、波形上的播放头。面板右上角可切换中文 / English。
设计原则（摘自官方说明）¶
- 本地优先：v1 的音频解码与分析全部在浏览器完成，音频不出本机。
- 客观先行：先给可复现的数值，再给方向性建议。
- 边界清晰：声带健康只做筛查提示，不做诊断。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议查看 GitHub 仓库 源码与 MIT 许可证。
方式一：npm 一键安装（README 推荐）
在 DeepSeek Harness 的「插件 → 添加插件」里搜索 dsh-shengsheng-observer，点安装。
方式二：下载安装包
- 到 Releases 下载最新版
dsh-shengsheng-observer-0.5.0.tgz； - 打开 DeepSeek Harness → 插件 → 添加插件，选择该 tgz 安装；
- 左侧栏出现「声生观察台」后，刷新页面即可使用。
方式三：命令行（本地 tgz 路径）
dsh plugin --profile <你的 profile> add file:/下载目录/dsh-shengsheng-observer-0.5.0.tgz
方式四：从源码本地链接安装
dsh plugin --profile desktop add link:/path/to/声生观察台
说明：DSH 生态理念是「一切皆插件」；社区目录站点（如 SkillHub 目录页）为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
典型用法¶
- 按上述任一方式安装并刷新，在左侧栏打开「声生观察台」。
- 上传一段清唱干声（无伴奏、便于分析人声本身）。
- 在面板中查看适配 / 嗓况 / 制作三块结果，可用试听控件核对音频与波形。
- 需要英文界面时，在面板右上角切换语言。
仓库 docs/ 下提供 ALGORITHMS.md（算法与库选型）与 ROADMAP.md（阶段计划），便于核对分析边界与后续规划。index.js 为 Host 半片（预留给 Python/numpy 重分析），client.js 为浏览器半片（面板 UI、解码与 DSP）。
适用场景与注意¶
适合谁：需要基于同一段干声做音域与音色画像、粗略嗓况参考、混音/EQ 方向讨论的创作者或开发者；在 DSH 里做音乐/语音相关智能体工作流时，可作为本地分析面板插件接入。
注意：
- 嗓况结果不能替代专业医疗检查。
- 分析依赖浏览器本地算力与上传音频质量；极短或强噪声样本可能影响指标准确度（具体算法见仓库文档）。
- 试用问题可在 GitHub Issues 反馈。
结尾¶
声生观察台把清唱干声拆成适配、嗓况、制作三块可读输出，并坚持本地解码与分析，适合在 DSH 里快速建立「上传 → 指标 → 建议」的闭环。目录与源码：
