安装

Mriter 以 DSH 技能形式分发。装好后在对话里丢一段歌词，它跑分析并给报告。

前提

• DSH（DeepSeek Harness）桌面版或 Web 版
• Python 3：macOS 自带；Windows 需要自行安装（后续会提供独立二进制包）
• 不需要任何 Python 依赖——引擎是纯标准库

安装技能

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 首既有分组的粗分桶，不是专业风格标注。跨组差异可用，组内绝对数仅供参考。详见判据与盲区。

能离线用吗？

能。引擎零网络请求，数据全部在本机。