DeepSeek Finder

访达工具栏上的 DeepSeek Harness 按钮（QuickClaude 风格）：透明底、灰色线条的 DeepSeek 鲸鱼 logo，在任意目录点击即可把该目录作为工作区打开 DeepSeek Harness Web 对话。

两种使用方式

方式一（推荐）：Finder Sync 工具栏按钮

1. 打开访达，在工具栏空白处右键 → 自定义工具栏…
2. 在备选按钮中找到 DeepSeek Harness（灰色鲸鱼图标），拖入工具栏，点"完成"
3. 在任意目录点击该按钮 → 弹出菜单：
   • 在此目录打开 DeepSeek Harness：以当前目录（或选中的单个文件夹）为工作区，直接进入对话
   • 打开 DeepSeek Harness 界面：打开 Web 界面首页

同一目录的对话会复用该目录已有的空白会话，重复点击不会开一堆新会话。

方式二：一键直达（无菜单）

按住 ⌘ 把 /Applications/DeepSeek Finder.app 拖到访达工具栏上。点击即触发：读取最前方访达窗口的目录 → 直接进入对话（无需二次点击菜单）。

首次使用会弹出 macOS 的自动化权限询问（"DeepSeek Finder"想要控制"访达"），点好/允许即可。

工作方式

访达按钮（FinderSync 扩展，沙盒）
  └─ 菜单项 → deepseekfinder://open/?workspace=<目录>
        └─ DeepSeek Finder（宿主 App，非沙盒）
             ├─ 检查 http://127.0.0.1:3080 是否在线，不在线则后台启动 dsh web
             └─ 打开 http://127.0.0.1:3080/?workspace=<目录>
                  └─ Web GUI 深链插件：新建/复用该目录为工作区的会话并选中

?workspace= 深链实现为本项目的独立插件 dsh-workspace-deep-link/（装在 web profile 里）， DeepSeek Harness 仓库本体保持零改动。

构建与安装

无需 Xcode，仅需 Command Line Tools：

Scripts/make-signing-identity.sh   # 首次/换机时创建自签名证书（macOS 拒绝注册 ad-hoc 签名的扩展）
Scripts/build.sh                   # 编译 x86_64 + arm64，打包 .app，签名
ditto Build/DeepSeekFinder.app "/Applications/DeepSeek Finder.app"
pluginkit -a "/Applications/DeepSeek Finder.app/Contents/PlugIns/DeepSeekFinderExtension.appex"
pluginkit -e use -i dev.zekdew.deepseek-finder.finder-sync
killall Finder                     # 让访达加载扩展

深链插件安装（一次性；插件在 $DSH_HOME 里，升级 Harness 不受影响）：

cd ~/dev/deepseek-harness && node apps/cli/lib/bin.js plugin --profile web add ~/dev/deepseek-finder/dsh-workspace-deep-link
# cordis.patch.yml 已含插件行; 若重建过 profile,需重新添加:
# - insert:
#     - id: workspace-deep-link
#       name: '@zekdew/dsh-client-workspace-deep-link'
kill $(lsof -ti :3080); cd ~/dev/deepseek-harness && nohup pnpm dsh web >/tmp/dsh-web.log 2>&1 &

升级 DeepSeek Harness 后按钮是否仍可用？

不受影响。 深链功能在仓库之外的 web profile 插件里，仓库保持零改动： dsh-update 的 git pull --ff-only / pnpm install / pnpm build 都不会触碰它， 升级脚本还会在构建后自检插件是否存在，缺失时打印重装命令（缺失期间按钮退化为仅打开界面首页）。

修改深链逻辑后重新构建插件并重启服务：

cd ~/dev/deepseek-finder/dsh-workspace-deep-link && pnpm install && pnpm tsdown
kill $(lsof -ti :3080); cd ~/dev/deepseek-harness && nohup pnpm dsh web >/tmp/dsh-web.log 2>&1 &

目录结构

• Sources/Extension/ — Finder Sync 扩展（工具栏按钮 + 菜单）
• Sources/App/ — 宿主 App（URL scheme 处理、一键直达、启动 dsh web）
• Sources/Shared/ — 共享启动逻辑（服务器探测/启动、深链 URL 构造）
• dsh-workspace-deep-link/ — 深链客户端插件（?workspace=，独立于 Harness 仓库）
• Assets/ — 官方 DeepSeek logo 路径的灰色描边渲染（应用图标 + 工具栏模板图）
• Scripts/render_logo.py — 用 PIL 从官方 SVG 路径渲染描边 logo（可调线宽/灰度）

已知限制

• Finder Sync 扩展点击后按系统机制必先弹菜单（所有这类按钮如此）；想要单击直达请用方式二。
• 应用与扩展用本地自签名证书签名（macOS 无 Apple 开发者证书时的标准做法）；换机器需重跑 make-signing-identity.sh 并重新注册扩展。

版权说明

• 本项目 MIT 许可（见 LICENSE）。
• DeepSeek 鲸鱼 logo 版权归 DeepSeek 所有，仅作为本项目图标使用，非官方背书。