安装
Mriter 以 DSH 技能形式分发。装好后在对话里丢一段歌词，它跑分析并给报告。
两种安装方式
| 方式 | 需要 Python 吗 | 适合 |
|---|---|---|
| 插件（推荐） | 不需要，引擎随包内置 | 只想用，不想配环境 |
| 技能 | 需要本机 Python 3 | 想改代码、跟着仓库走 |
方式一：插件（推荐）
插件会注册一个 mriter_advice 工具，Agent 直接调用，内置引擎二进制，不需要 Python。
dsh plugin --profile desktop add @jojonadam/dsh-mriter
或在 DSH 的「设置 → 插件」里搜索 @jojonadam/dsh-mriter 安装。
装完重启 DSH。当前内置 darwin-arm64 二进制；其他平台会退化到「技能」方式（源码 + Python）。
方式二：技能
- Python 3：macOS 自带；Windows 需要自行安装
- 引擎是纯标准库，无第三方依赖
安装技能
git clone <仓库地址> ~/AI_Projects/Mriter mkdir -p ~/.dsh/skills cp -R ~/AI_Projects/Mriter/packaging/dsh-skill/mriter ~/.dsh/skills/mriter
重启 DSH 或刷新会话，技能列表里会出现 mriter。如果仓库不在默认路径，设置环境变量 MRITER_HOME。
用法（两步）
直接把歌词贴给 Agent，说「帮我看这段词」。它会调用：
python3 -m antimusic.advice --lyrics <歌词文件> --out <输出目录>
看退出码决定下一步：
| 退出码 | 含义 | 怎么办 |
|---|---|---|
0 | 报告已生成 | 读 advice.md，逐节讲 |
3 | 题材没判定 | Agent 会回来问题材；拿到答案后加 --theme 重跑 |
2 | 输入错误 | 检查文件路径与编码 |
可选参数
--share：另出一张分享卡share.html（自包含，不含歌词原文）--theme 爱情遗憾：直接指定题材，跳过追问--data-dir <目录>：换语料/风格卡数据包（将来云端同步用这个口）
常见问题
报告里有些数字是空的？
说明该数据缺失（例如没提供和声语料索引）。报告会写明「未提供语料索引」，不会编造。
为什么风格卡标「草稿态」？
风格归属来自 121 首既有分组的粗分桶，不是专业风格标注。跨组差异可用，组内绝对数仅供参考。详见判据与盲区。
能离线用吗？
能。引擎零网络请求，数据全部在本机。