这个项目能做什么
DSH for Vaults 是一款 Obsidian 桌面插件,它将 DeepSeek Harness (DSH) 原生 Web UI 嵌入到 Obsidian 内部。根据 README 介绍,每个库(vault)都拥有一个完全隔离的 DSH 实例:打开一个库会启动以该库为工作空间的 DSH,且会话历史记录按库存储,互不干扰。该插件充当启动器和嵌入式客户端,而非捆绑 DSH 的具体实现。
README 中描述的核心功能包括:
- 嵌入式 webview UI:真实的 DSH 界面运行在专用的 Electron webview 中,具有持久的每库会话存储和安全的 cookie 令牌身份验证。
- 双向桥接:右键点击选中文本可将包含文件及行/列范围的定位行发送至 DSH composer;在 DSH 聊天中点击库文件路径可打开 Obsidian 中对应的笔记。缺失文件会收到通知,而库外路径和二进制路径则保持 DSH 默认行为。
- 热键透传:通过设置开关,在 DSH 面板获得焦点时,配置的 Obsidian 快捷键仍可继续触发。
- 零终端引导:如果缺失 Node.js 或 DSH,面板可安装一个私有的便携式运行时(约 30 MB,无需管理员权限,不影响系统),随后自动下载并启动 DSH 内核,并提供实时进度显示和 npm 镜像回退机制。
- DSH 实例间的模型配置同步:增量模式会根据冲突复制缺失的条目和提示词;覆盖模式则将提供商和凭据引用与选定源对齐并自动备份文件。同步项包括 LLM 提供商和 API 凭据引用;每实例登录记录、默认模型路由、搜索模型和插件配置文件不参与同步。
- 更新策略:跟踪官方稳定频道,仅在明确确认后安装;启动时不会在线更改版本。
- 数据迁移:从旧版本内核升级时,会自动迁移会话数据并在迁移前进行备份,备份目录可配置。
- 每库隔离:数据存储在库之外的专用本地目录中,根据 README,该数据不会通过 OneDrive 同步。
- 诊断功能:设置界面显示探测、Node 检测、端口、内核和 UI 加载的各阶段启动时间,以及错误尾随日志和可复制的日志;超时后会清理过时的进程树。
要求:Windows 平台上的 Obsidian 桌面版 v1.4 或更高版本。无需预装 Node.js,因为插件可以安装便携式运行时或通过绝对路径检测现有安装。
安装方式:可通过 Obsidian 社区插件搜索 DSH for Vaults 安装,通过 BRAT 使用仓库 moozhu/dsh-obsidian 安装,或手动将 main.js、manifest.json 和 styles.css 放入库的 .obsidian/plugins/dsh-ob/ 文件夹并启用插件。
使用方法:通过鲸鱼图标或命令面板打开面板,等待启动,然后将库作为活动工作空间进行对话。状态栏显示实例状态。多库行为包括:每个库拥有确定性端口、不同库使用独立实例、同一库在两个窗口中共享实例,以及除非另有配置,否则在关闭窗口时停止实例。底部内边距可在 0 到 40 像素之间调节。
隐私:README 指出该插件仅作为启动器和嵌入式客户端,仅通过 localhost (127.0.0.1) 与 DSH 通信,无遥测或中继。DSH 本身可能会根据任务向模型 API 等发出出站请求。会话历史、模型配置和 API 凭据存储在库的专用本地数据目录中。
设置项包括:可执行文件路径、版本更新、数据备份目录、基础端口、Obsidian 启动时自动启动、关闭时停止、热键透传、反向桥接、模型配置同步、面板位置、面板底部内边距以及启动时间诊断。
开发命令为:npm install,npm run dev(TypeScript 监听),npm run typecheck,以及 npm run build(进行类型检查并使用 esbuild 打包)。
评论
0 评分人数达到10人后显示
登录后参与讨论。