fix: 修正凭据名称避免 DSH 重启失败

README.md

@@ -141,6 +141,17 @@ git+https://git.crash.work/cneicy/dsh-imagegen.git
 - 在 DSH「插件」页面停用或卸载 `dsh-imagegen-local`。
 - 卸载不会自动删除已保存的图片和凭据。如需清理密钥，请先在生图设置里清除对应地址的密钥，再卸载。
 
+### 1.0.1 凭据兼容修复（从 1.0.0 升级必读）
+
+1.0.0 曾将凭据名称写成 `dsh-imagegen:<SHA-256>`，不符合 DSH 的 `scope/id` 校验规则，可能导致凭据服务在下次启动时失败。1.0.1 统一使用 `imagegen-local/endpoint-<SHA-256>`；`endpoint-` 保证 ID 始终以字母开头，scope 与注册的 Host 插件名称一致。读、写、删除都使用同一格式。
+
+- **DSH 已能启动**：先更新插件并重启 DSH，再在「设置 → 生图」重新保存 API Key。旧版配置的 Base URL、模型列表和原图不受影响。
+- **DSH 因旧记录无法启动**：先退出 DSH，安全备份 `$DSH_HOME/.credentials.yaml`，只移出 `records` 下本插件的旧条目（`dsh-imagegen:<哈希>`，或曾手动改成的 `dsh-imagegen/<哈希>`），保留其他凭据和 YAML 结构；启动后更新插件，再重新保存 API Key。备份含密钥，请勿上传。
+- 不要仅替换冒号：十六进制哈希可能以数字开头，仍不符合 ID 规则。
+- 插件不会自动读取备份、恢复被移出的旧密钥，或直接改写全局凭据文件。凭据服务先于插件加载，启动被旧记录阻断时，插件自身无法执行迁移。
+
+回归测试现在在每次凭据读写、删除及持久化重载时校验名称，并覆盖哈希首字符的全部 16 种情况。
+
 ## 常见问题
 
 **出现 HTTP 401 / 403**：检查 API Key、Base URL 以及账号是否有该模型的权限。