Skip to content

docs: 写清文档型连接连不上时该弹提示框 - #16

Merged
joesdu merged 1 commit into
devfrom
docs/document-connection-failure-dialog
Sep 3, 2026
Merged

docs: 写清文档型连接连不上时该弹提示框#16
joesdu merged 1 commit into
devfrom
docs/document-connection-failure-dialog

Conversation

@joesdu

@joesdu joesdu commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

这个 PR 做了什么

zh/host/交互与界面规格.mden/host/interaction-and-ui-specs.md 的 §7,在「断开连接状态(ZufZw)」之后补一节「文档型连接的失败提示」。

为什么这么改

现有规格只写了终端会话断开时的覆盖层。那套写法有个没写出来的前提:标签页已经在了 —— 终端标签在握手之前就建出来,失败画在它里面即可。

SFTP / FTP / 插件文件系统(S3…)/ 插件工作台(Redis…)没有这个前提:它们连上了才有标签页。宿主原来在这四条路径上只把失败写进 24px 状态栏就返回,于是本机没起 Redis 时点开一条 Redis 会话是彻底静默的 —— 没有提示,也没有标签页。宿主已改为弹错误提示框,规格里得跟上,否则下一个人照着规格实现新的连接类型,会把同一个洞再挖一遍。

补的一节写清四点:

  • 弹框与凭据框共用同一道串行闸(启动恢复多条会话是并发发起的,两类模态框叠在同一个 owner 上会互相锁死);
  • 用户主动取消不算失败 —— 凭据框上点取消、证书提示上点"不信任",都只更新状态栏,不弹框;取消时还要清空 LastConnectionError,插件代开会话那条路径靠它区分"没连上"与"人不同意";
  • 三次凭据都没过、循环退出时也要报一次;
  • 插件协议族的异常消息按 SDK 契约本就是面向用户的、且已带端点,宿主原样呈现,不再套一层"连接 X 失败:"把同一个地址写两遍。

关联

按 AGENTS.md 的约定,这条与宿主 PR 一起合。

同步检查

  • zh/en/ 两棵树都改了,内容一一对应
  • 没有新增跨仓库绝对 URL(节内引用沿用既有写法)

§7「断开连接状态」那套覆盖层的前提是标签页已经在了 —— 终端标签在握手之前就建出来。
SFTP / FTP / 插件文件系统(S3)/ 插件工作台(Redis)没有这个前提:它们连上了才有标签页,
失败时屏幕上一无所有。规格里补一节写清这四类改为弹错误提示框,以及三条边界:
串行闸、用户主动取消不算失败、三次凭据都没过时也要报一次。

zh/ 与 en/ 同步。

对应宿主 PR:joesdu/VelaShell(文档型连接连不上时弹提示框)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J5gfiQ8G3JfqomjRkuHmPP
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant