概览
dsh-design-qa
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **本体改动不能自失效。** 补丁是磁盘上的文件改动,而卸载插件只摘掉插件行、不会去重写那些文件。 所以卸载必须显式 `--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 的设置写入器维护并会规范化格式, 因此自检只做模糊匹配 —— 它查的是「像不像配过」,不是「配得对不对」。
