dsh-design-qa

LIMITATIONS

Known limitations

- **本体改动不能自失效。** 补丁是磁盘上的文件改动，而卸载插件只摘掉插件行、不会去重写那些文件。 所以卸载必须显式 `--revert-patches`，顺序见上面的卸载一节。 - **升级 DSH 会冲掉本体改动**（文件被新版覆盖）。表现是「粘图又被拒了」，重跑一次 `node install.mjs --route-only` 即可。这也是有意的：新版 DSH 万一自己支持了图片，补丁不该悄悄留着。 升级后即使备份文件还在，`--revert-patches` 也只会清掉那份过期备份、不会把新版文件覆盖回旧内容。 - **按代码形态定位锚点，不按版本号。** 上游改写了那三处时，脚本会**报错并列出文件**， 而不是打半个补丁。两种形态都会被改到（源码运行的 `src/*.ts`、npm 安装的 `lib/index.js`）—— 无法可靠判断哪份是活的，宁可都改；源码仓库里因此会多出未跟踪的 `.dsh-design-qa-orig` 备份文件。 - **模型必须支持 tool calling。** 整套机制是「模型看到指针 → 自己调工具」，不支持工具调用的 纯文本模型只会看到一行 `[图片 …]` 而无法进一步。配路由前先确认端点支持 `tools` 参数。 - **`attachment=<id>` 形式只在进程内有效**：id → 路径的索引是内存态，重启后失效，需改用文件路径。 - **未覆盖多图对比**：`deepseek_vision` 一次只看一张图。设计稿与实现的并排对比图需调用方自己拼。 - **私有文档的图取不到**：飞书、Notion 这类需要登录态的图片，直传 URL 会 401/403。 需先用对应 skill 下载到本地再传路径。工具会在报错里指明这条路，但没有内建凭据通路。 - **自检是宽松匹配**：`settings.yaml` 由 DSH 的设置写入器维护并会规范化格式， 因此自检只做模糊匹配 —— 它查的是「像不像配过」，不是「配得对不对」。