Skip to content

feat: 服务器仓库可挂载到本机,Show in Finder 一直可用 - #81

Merged
rakuyoMo merged 17 commits into
mainfrom
feature/rakuyo/server-repository-mount
Nov 18, 2026
Merged

rakuyoMo merged 17 commits into
mainfrom
feature/rakuyo/server-repository-mount

Conversation

@rakuyoMo

@rakuyoMo rakuyoMo commented Nov 17, 2026 •

Copy link
Copy Markdown
Owner

对应需求 M23(服务器仓库挂载到本机):服务器仓库的本机位置可以自动查找、经 SMB 或 sshfs 挂载或指定文件夹,Show in Finder 一直可以点;同时修正侧边栏、工具栏提示、图标、展开状态、复制路径、验证码按钮与失效工作树。版本改为 0.23.0。

改动

  • 本机位置
    • 仓库设置的本机文件夹换成 Location on This Mac:自动查找、SMB 挂载、sshfs 挂载、指定文件夹四种,按仓库记下;旧的本机文件夹记录迁移为指定文件夹
    • SMB 经 NetFS 挂载,登录与钥匙串交给系统,挂上后在卷里找到仓库并记下共享;sshfs 挂到选定的空文件夹,经仓库 Git 目录里的临时标记文件核对,核对后删掉
    • 445 端口 2 秒内连得上才提供 SMB,找得到 sshfs 才提供 sshfs
    • 打开仓库连上服务器后在后台挂载一次,不询问;推出卷后由 Show in Finder 重新挂载;Spooky 从不卸载
    • 添加服务器仓库的对话框可以选挂载方式
  • Show in Finder
    • 仓库窗口、仓库管理与最近克隆里的服务器仓库都可以点:能直接打开就直接打开,否则 sheet 依次连接、查找、挂载,没有本机位置时换成本机位置的表单
    • 不能直接打开时,提示写出原因
  • 仓库管理、最近克隆与工作树的右键菜单里,本机与服务器仓库都有 Show in Finder 与 Copy Path 两项
  • 失效工作树:行变暗并带警告图标,详情给出 Repair… 与 Remove,菜单与快捷操作随之调整;修复对话框用位置菜单选目录并核对所选目录,服务器仓库读服务器上的文件
  • 侧边栏与工具栏
    • 侧边栏不再提示上游已不存在,Branches Review 照旧
    • 服务器仓库的工具栏提示不再带主机前缀
    • 远端分支、合并、变基、新建分支与 Pull Request 等处换用自绘图形
    • 侧边栏按仓库记住各分组的展开状态
  • GitHub 登录时,验证码下面的按钮只复制验证码
  • 文档:架构、M7 / M9 / M12 / M14 的验收步骤与两份 README 随之更新,新增 M23 的验收步骤

验证

  • mise run swift:lint 0 处违规,mise run build 通过
  • mise run test:829 个测试(471 + 349 + 9)全部通过,需要环境变量开启的测试照常跳过
  • swift build --product Spooky、./scripts/build-app.sh、mise run bundle 通过,codesign --verify --deep --strict 通过,Bundle 版本 0.23.0
  • 在指向本机回环的测试服务器上实测:
    • 失效工作树:选不相干的目录报错,选移走后的目录修复成功;目录删掉后 Remove 去掉登记
    • sshfs(FUSE-T):后台挂载不询问;核对挂载的卷通过、不相干的本机文件夹不通过,仓库的 Git 目录里没有留下标记文件;已挂着时不重复挂载;状态清空后卷仍挂着
    • SMB(本机 Kerberos,不输入账号密码):没有记下共享且不许询问时报错、不弹框;挂上共享后在卷里找到仓库并记下共享,再挂一次沿用同一个挂载
    • Show in Finder:没连上时先经 SSH 连接、再查找,返回 SMB 卷里的仓库目录;连不上的主机报连接错误与 ssh 的原因
  • 实测发现 sshfs 挂上后仍被判为没挂着:同一个文件夹 URL 在挂载前取过卷信息,之后读到的是缓存的旧值。改为取前清掉缓存
    • 修复前后各跑一次回环实测,由失败转为通过
    • 本机临时挂上磁盘映像核对:同一文件夹先查看、挂上后再查看,不清缓存时认不出,清后认得出

未验证

  • 界面验收与 25 个依赖辅助功能的测试:本次环境没有辅助功能、录屏与发送事件权限,App 没有实际启动、操作和截图,docs/testing/M23.md 的手动步骤没有走
  • 断网后恢复时 Show in Finder 继续进行:要断开本机网络
  • SMB 需要账号密码、存进钥匙串的一侧:要另一台 Mac 的共享
  • macFUSE 版的 sshfs,以及 sshfs 询问口令
  • 核对期间取消时删掉服务器上的标记文件
  • GitHub 登录时验证码下面的按钮
  • 自动查找能否认出 Spooky 之外挂载的 SMB 与 sshfs 卷

注意

  • 留下两处 #warning:
    • ShowInFinderDialog:进行中与没连上时 sheet 的说明与底栏,目前没有说明,进行中底栏只有 Cancel
    • RepositoryLocalLocationRow:还没有查找结果(如还没连上服务器)时这一行与正在查找相同
  • 上面的缓存问题没有补自动测试:要复现必须真实挂载,而挂载会向整个测试进程广播卷变化,让并行的其它测试重新查找
  • sshfs 与 macFUSE 或 FUSE-T 由用户自行安装
  • SMB 是否可用只看 445 端口能否连上;本机走代理的 TUN 时可能总能连上,此时挂载失败照常写出 NetFS 的原因

@rakuyoMo
rakuyoMo merged commit b47da94 into main Nov 18, 2026
5 checks passed
@rakuyoMo
rakuyoMo deleted the feature/rakuyo/server-repository-mount branch November 18, 2026 09:15
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