菜单栏快捷入口mycherish/dsh-bridge

DSH Bridge

DSH Bridge 是一个开源、原生的 macOS 菜单栏入口，用于 DeepSeek Harness。它专为一个专注的工作流而设计：从任意位置唤起 Quick Bar，将任务发送到选定的工作区，查看实时 agent 活动，然后返回工作。

项目状态：开发者预览版。可下载的 Apple Silicon 预览版已提供，但它采用 ad-hoc 签名，未经 Apple 公证。

简体中文

为什么选择 DSH Bridge

DSH Bridge 不是另一个完整的聊天客户端，也不是 DSH Web 的封装。它为 DeepSeek Harness 提供了一个小巧的系统级界面：

Option+Space
-> 输入任务
-> 可选附加剪贴板文本
-> 在选定的工作区中运行
-> 查看实时工具活动和审批
-> 接收结果和 macOS 通知

该应用不会启动 DSH Web，也不会监听 127.0.0.1:3080。

当前功能

- 原生 SwiftUI 菜单栏应用，带有 AppKit 面板和窗口。
- 全局 Option+Space Quick Bar。
- 将提示词提交到一个默认工作区。
- 显式附加纯文本剪贴板内容，带三行预览和 64 KB 限制。
- DeepSeek API 密钥存储在 macOS Keychain 中。
- 内置官方 macOS arm64 DeepSeek Harness 运行时；用户无需 Node.js、npm、pnpm 或 dsh。
- 新建和可恢复的嵌入式 Harness 会话，带本地历史记录。
- 实时、有界活动时间线，带配对的工具调用和工具结果行。
- 针对敏感 Bash 操作的原生一次性审批 UI；不可用的审批通道会失败关闭。
- 最终响应渲染，支持轻量级 Markdown。
- 完成和失败通知，仅包含隐私安全的会话路由信息。
- 运行时崩溃报告、stderr 日志、请求超时、优雅关闭和脱敏诊断。
- 运行时校验和、架构、helper、原生能力以及干净环境冒烟验证。

要求和限制

- Apple Silicon Mac（arm64）。
- macOS 14 或更高版本。
- 从源码构建需要 Xcode 16 或更高版本。
- 一个 DeepSeek API 密钥。
- 应用 UI 目前仅支持简体中文。
- 一次只能运行一个任务。
- Stop Task 尚未实现；退出应用会执行运行时优雅关闭。
- 公开预览版采用 ad-hoc 签名，未经公证；目前没有自动更新通道、引导流程、Intel 构建或 Windows 构建。
- DeepSeek Harness 和内置运行时仍是预发布依赖，可能会引入破坏兼容性的变更。

下载和安装

从 GitHub Releases 下载最新预览版及其 SHA-256 校验和。当前软件包仅支持 Apple Silicon。

1. 打开下载的 DMG。
2. 将 DSH Bridge 拖到 Applications。
3. 从菜单栏的 Settings 项配置 DeepSeek API 密钥和默认工作区。
此预览版为临时签名，未经公证。如果 macOS 阻止首次启动，请在 Finder 中按住 Control 键点按应用并选择 打开，或在 系统设置 → 隐私与安全性 中选择 仍要打开。请勿为来自不受信任来源的构建版本绕过 Gatekeeper。

使用随附的校验和文件验证下载内容：

shasum -a 256 -c DSHBridge-0.1.0-alpha.1-macos-arm64.dmg.sha256

构建并运行

DSH Bridge 必须以 macOS 应用程序包的形式运行，因为它使用应用包资源和 macOS 用户通知。请勿使用 swift run 或 Xcode 生成的 executable scheme 启动原始的 SwiftPM 可执行文件。

构建并启动开发版应用：

./Scripts/build-app.sh
open .build/DSHBridge.app

要生成本地发布构建：

CONFIGURATION=release ./Scripts/build-app.sh

两条命令均使用临时签名。发布打包脚本使用相同的签名模式，并在生成校验和之前验证应用包和生成的磁盘映像：

./Scripts/package-dmg.sh 0.1.0-alpha.1

Xcode 仍可用于编辑包和运行测试。要调试应用，请先启动生成的包，然后将 Xcode 的调试器附加到 DSHBridge 进程。

如果仓库已被移动，请在重新构建前先清理一次 Swift 依赖路径的构建缓存：

swift package clean

从菜单栏的“设置”项配置 API 密钥和默认工作区。然后按 Option+Space 打开快速栏。

验证

swift-format lint --strict -r Sources Tests Package.swift
swift test --disable-sandbox
node --test Tests/RuntimePlugin/.test.mjs
./Scripts/build-app.sh
codesign --verify --deep --strict --verbose=2 .build/DSHBridge.app
./Scripts/smoke-runtime.sh

维护者可以使用 DSH_BRIDGE_UI_SMOKE=1 启动应用，以立即打开快速栏，并在运行完成或失败时显示活动窗口。

架构

App / AppState
├── UI
│   ├── MenuBar
│   ├── QuickBar (SwiftUI hosted by AppKit NSPanel)
│   ├── Activity and History
│   ├── Approval Panel
│   ├── Status HUD
│   └── Settings
├── Domain
│   ├── HarnessEvent
│   ├── RunContext / RunResult
│   └── Session models
└── Services
├── SessionManager / SessionProvider
├── HarnessService
│   ├── HarnessAdapter
│   ├── JSONRPCClient
│   ├── SessionChannel / ApprovalChannel
│   ├── RuntimeProcess
│   └── RuntimeResources
├── ClipboardService
├── ShortcutService
├── NotificationService
├── KeychainService
├── DiagnosticsService
└── WorkspaceService

UI 不依赖 JSON-RPC。协议和进程细节保留在 HarnessService 之后；UI 代码使用桥接层拥有的领域事件和会话模型。

安全与隐私

- API 密钥存储在 Keychain 中，并且仅注入到子运行时进程。
- 剪贴板文本在快速栏打开时读取，并且仅在显式附加后才进入代理上下文。
- 剪贴板内容不会存储在 Bridge 会话索引或通知正文中。
- 会话摘要和诊断信息会遮盖常见的凭据赋值。
- 敏感 Bash 命令在执行前需要原生的一次性批准。
- 选定的工作区是代理执行边界，而非只读预览。请审查批准提示并使用可信仓库。

DeepSeek Harness 社区发现

DSH Bridge 内嵌了 Bridge 专用的 Cordis 插件，但该仓库目前是一个 macOS 应用程序，而非传统的可安装 dsh plugin add 包。添加 GitHub 主题 dsh-plugin 可使公共仓库从 DeepSeek Harness 社区主题页面被发现；它本身并不会发布或安装该 macOS 应用。

在将 DSH Bridge 作为标准 DSH 插件呈现之前，请执行以下任一操作：

1. 继续将该产品明确描述为带有内嵌 Harness 插件的 macOS 配套应用；或
2. 将可复用的 Cordis 层提取为一个有文档的 npm 包，附带 dsh.bundle 清单和安装测试。

分发状态

GitHub Releases 页面提供了一个明确标注的、未经公证的预览版供测试使用。若要在 Mac App Store 之外进行可信的公开下载，未来的版本必须使用 Developer ID Application 证书签名、使用强化运行时、由 Apple 公证，并装订其公证票据。当前的临时构建不满足这些信任要求。

Mac App Store 不是推荐的首选分发渠道，因为 DSH Bridge 有意在用户选定的工作区中执行工具。商店构建将需要 App Sandbox 支持、安全作用域书签、正确沙盒化的辅助可执行文件，以及单独的 App Review 可行性评估。

内置运行时与许可证

DSH Bridge 内置了官方 deepseek-harness-runtime-bin 0.1.0rc7 macOS arm64 wheel。构建过程会验证其 SHA-256 校验和，并将其 MIT 许可证和第三方声明提取到应用包中。参见 Vendor/Runtime/README.md、Docs/runtime-native-dependencies.md 和 Docs/runtime-protocol.md。

DSH Bridge 源代码在 MIT License 下提供。内置的第三方组件仍受其各自许可证和声明的约束。

简体中文

产品定位

DSH Bridge 是 DeepSeek Harness 的原生 macOS 菜单栏快速入口，不是完整聊天客户端，也不是 DSH Web 的套壳。

Option+Space
-> 输入任务
-> 可选附加剪贴板文本
-> 在选定工作区执行
-> 查看实时工具活动与敏感操作授权
-> 获取结果和 macOS 通知

应用不会启动 DSH Web，也不会监听 127.0.0.1:3080。

当前功能

- SwiftUI + AppKit 原生菜单栏应用、面板和窗口。
- Option+Space 全局 Quick Bar。
- 在一个默认工作区中提交任务。
- 显式附加纯文本剪贴板，提供三行预览和 64 KB 限制。
- 使用 macOS 钥匙串保存 DeepSeek API Key。
- 内置官方 macOS arm64 DeepSeek Harness Runtime，用户不需要安装 Node.js、npm、pnpm 或 dsh。
- 支持新建、恢复和继续 Embedded Harness Session，并保存本地历史。
- 实时且有界的执行时间线，配对展示工具调用和结果。
- 敏感 Bash 操作使用原生单次授权；授权通道不可用时默认拒绝。
- 最终结果支持轻量 Markdown 渲染。
- 完成和失败通知只携带安全的 Session 路由信息。
- Runtime 崩溃诊断、stderr 日志、请求超时、优雅退出和脱敏诊断。
- Runtime 校验和、架构、辅助程序、原生能力和干净环境 smoke 验证。

要求与已知限制

- Apple Silicon Mac（arm64）。
- macOS 14 或更高版本。
- 从源码构建需要 Xcode 16 或更高版本。
- 需要 DeepSeek API Key。
- 当前应用界面仅支持简体中文。
- 同一时间只能运行一个任务。
- Stop Task 尚未实现；退出应用时会优雅关闭 Runtime。
- 公开预览版使用 ad-hoc 签名且未经过 Apple 公证；暂不提供自动更新、首次引导、Intel 版本和 Windows 版本。
- DeepSeek Harness 和内置 Runtime 仍是预发布依赖，后续可能出现破坏性兼容变更。

下载与安装

请从 GitHub Releases 下载最新预览版和对应的 SHA-256 校验文件。当前安装包仅支持 Apple Silicon。

1. 打开下载的 DMG。
2. 将 DSH Bridge 拖到 Applications。
3. 从菜单栏“设置”中配置 DeepSeek API Key 和默认工作区。

该预览版使用 ad-hoc 签名，尚未经过 Apple 公证。如果 macOS 首次启动时阻止打开，请在 Finder 中按住 Control 点击应用并选择“打开”，或前往“系统设置 → 隐私与安全性”选择“仍要打开”。不要对来源不可信的构建绕过 Gatekeeper。

使用随附的校验文件验证下载：

shasum -a 256 -c DSHBridge-0.1.0-alpha.1-macos-arm64.dmg.sha256

构建与运行

DSH Bridge 必须以 macOS App Bundle 形式运行，因为系统通知和应用资源依赖有效的 .app Bundle。请不要使用 swift run，也不要直接运行 Xcode 自动生成的 Swift Package executable scheme。

构建并启动开发版应用：

./Scripts/build-app.sh
open .build/DSHBridge.app

生成本地 Release 构建：

CONFIGURATION=release ./Scripts/build-app.sh

以上构建都使用 ad-hoc 签名。发布打包脚本使用相同签名方式，并在生成校验和之前验证 App Bundle 和 DMG：

./Scripts/package-dmg.sh 0.1.0-alpha.1

Xcode 仍可用于编辑 Package 和运行测试。需要断点调试时，请先启动生成的 App Bundle，再使用 Xcode 附加到 DSHBridge 进程。

如果移动过仓库目录，请在重新构建前清理一次包含旧绝对路径的 Swift 构建缓存：

swift package clean

在菜单栏的“设置”中配置 API Key 和默认工作区，随后使用 Option+Space 打开 Quick Bar。

验证

swift-format lint --strict -r Sources Tests Package.swift
swift test --disable-sandbox
node --test Tests/RuntimePlugin/.test.mjs
./Scripts/build-app.sh
codesign --verify --deep --strict --verbose=2 .build/DSHBridge.app
./Scripts/smoke-runtime.sh

维护者可以设置 DSH_BRIDGE_UI_SMOKE=1 启动应用：Quick Bar 会立即出现，任务完成或失败后会自动显示 Activity 窗口。

架构

App / AppState
├── UI：MenuBar、QuickBar、Activity、History、Approval、Status HUD、Settings
├── Domain：HarnessEvent、RunContext、RunResult、Session models
└── Services
├── SessionManager / SessionProvider
├── HarnessService
│   ├── HarnessAdapter
│   ├── JSONRPCClient
│   ├── SessionChannel / ApprovalChannel
│   ├── RuntimeProcess
│   └── RuntimeResources
├── ClipboardService / ShortcutService / NotificationService
└── KeychainService / DiagnosticsService / WorkspaceService

UI 不依赖 JSON-RPC。协议和进程细节封装在 HarnessService 后面，UI 只消费 Bridge 自己的领域事件与 Session 模型。

安全与隐私

- API Key 只保存在钥匙串中，仅注入子 Runtime 进程。
- Quick Bar 打开时读取剪贴板，但只有用户明确附加后才会进入 Agent 上下文。
- 剪贴板内容不会写入 Bridge Session 索引或系统通知正文。
- Session 摘要和诊断信息会脱敏常见凭据赋值。
- 敏感 Bash 命令执行前需要原生单次授权。
- 选定工作区是 Agent 的执行边界，不是只读预览；请检查授权提示并只使用可信仓库。

DSH 社区入口

DSH Bridge 内置了 Bridge 专用 Cordis 插件，但当前仓库的产品形态是 macOS 应用，并不是常规的 dsh plugin add 安装包。给公开 GitHub 仓库添加 dsh-plugin Topic 后，可以出现在 DeepSeek Harness 社区 Topic 页面；该 Topic 本身不会发布或安装 macOS 应用。

对外宣传为标准 DSH 插件前，建议二选一：

1. 明确定位为“内置 Harness 插件的 macOS Companion App”；或
2. 把可复用 Cordis 层拆成带 dsh.bundle manifest、安装文档和安装测试的 npm 包。
分发状态

GitHub Releases 页面现在提供明确标注为“未公证”的测试预览版。未来若要在 Mac App Store 之外提供可信下载，需要使用 Developer ID Application 证书签名、启用 Hardened Runtime、提交 Apple 公证并装订公证票据。当前 ad-hoc 构建不满足这些信任要求。

不建议第一阶段优先走 Mac App Store。DSH Bridge 需要在用户选择的工作区中执行工具；商店版本必须额外完成 App Sandbox、Security-Scoped Bookmark、Helper 沙箱签名，并单独验证 App Review 可行性。

内置 Runtime 与许可证

DSH Bridge 内置官方 deepseek-harness-runtime-bin 0.1.0rc7 macOS arm64 wheel。构建过程会校验 SHA-256，并把其 MIT License 和第三方声明提取到 App Bundle。详见 Vendor/Runtime/README.md、Docs/runtime-native-dependencies.md 和 Docs/runtime-protocol.md。

DSH Bridge 源代码采用 MIT License。内置第三方组件仍分别遵循其许可证和第三方声明。