InvisibleSirius/dsh-obsidian-workbench

dsh-obsidian-workbench v1.2.0-alpha.7

v1.2 Alpha 7（2026-08-22）：修正 Harness 与 Obsidian HUD 的小鲸鱼思考动画——气泡从头顶向左上方冒出，不再靠近尾巴；小鲸鱼锁定为 DeepSeek 品牌蓝，原生 HUD 的“回答完成”继续使用蓝色流动高光状态。

DeepSeek Harness 的 Obsidian 研究工作台：以对话为中心，同时阅读本机 Obsidian 笔记、检索知识库、引用原文并安全回写内容。

- 左侧抽屉：Vault 导航（文件树 / 全文搜索 / 标签 / 最近打开）
- 右侧抽屉：Markdown 阅读器（标题目录 / wikilink / 附件 / 原生选区工具栏 / 选中提问 / 前进后退 / 在 Obsidian 打开）
- 右侧抽屉边缘：无论是否已打开笔记，都有独立的 › 收起柄，可随时向右关闭
- AI HUD：⌘⇧H 打开，可拖动、缩放、固定与最小化；通过可见页签、快捷动作和输入框内 / 命令操作；自动选择 Obsidian 新鲜选区、工作台当前笔记或无上下文；回答实时回传
- Obsidian 伴侣：在原生 Obsidian 窗口自动捕获活动 Markdown 笔记/选区，选区旁弹出 Ask/改写/精简/解释菜单；编辑与捕获只生成 Diff，确认前不写盘
- 权限接力：由 Obsidian HUD 发起的 Harness 受保护操作会在同一 HUD 显示一次性权限卡；审批 ID、任务来源与会话必须全部匹配，重复或过期决定会被拒绝
- 文档头部按容器宽度自适应：标题优先、低频操作收纳到“更多”，窄屏自动双行；阅读选区工具栏在多行、跨段、反向与滚动后保持原生选区和稳定锚点
- 对话区完全保持原样：通过「加入上下文」chips 把笔记注入下一条消息；回答用 vault: 引用格式，消息下方自动出现可点击的来源卡片
- 模型工具：obsidian_list_vaults / list_files / read_note / search / get_outline / get_backlinks / get_tags / get_note_metadata / get_context / open_note / index_status，以及受控写入 obsidian_create_note / append_note / update_note（默认关闭）

已实现（第一阶段纵向切片）

- 多 Vault 授权（必须用户确认）、激活/切换、自动发现候选；配置持久化于 ~/.dsh/settings.yaml，重启保留
- 默认只读；写入工具开箱即拒；开启后每次写入都走 Harness approval（fail-closed）+ diff 预览 + 原子写 + 备份 + 冲突检测 + 操作日志
- 本地索引：node:sqlite FTS5（CJK 逐字检索）+ 线性兜底；增量更新、删除/重命名/修改、手动重建、索引状态
- 路径防护：../、绝对路径、盘符、NUL、符号链接逃逸（读写双路径）、macOS NFD/NFC 规范化、二进制/超大文件拒绝、排除目录（.obsidian/.trash/.git 等）+ 用户规则
- 引用格式：vault名 + 相对路径 + 可选标题 + 可选行号范围，工具输出、上下文注入、来源卡片共用同一格式

AI HUD（v1.2 Alpha 7）

Harness 网页右下角的 小鲸鱼 AI 打开悬浮工作台；主快捷键为 ⌘⇧H（兼容 ⌘⇧Space）。原先重复的 ⌘K 命令面板已移除，直接点击模式页签/快捷动作，或在输入框键入 / 即可选择命令。HUD 支持：

- 自动识别上下文：20 秒内的新鲜 Obsidian 上下文优先，其次是工作台当前笔记/选区；也可强制选择“Obsidian / 工作台笔记 / 不附带”。
- 快捷动作：总结、解释、找矛盾、提取待办；保留最近 8 条提问，只存浏览器 localStorage。
- Notion 式操作：问 AI / 编辑选区 / 快速捕获三种模式，中文斜杠命令，拖动、缩放、固定到右侧，并持久化位置、尺寸和操作偏好。
- 引用回跳：回答中的 vault: 引用可以直接打开原笔记/标题/行号，并返回此前阅读位置。
- 受控写入：改写选区和快速捕获都先展示逐行 Diff；只有点击“确认写入”才会创建、追加或替换，放弃则磁盘不变。
- 真实流式回传：请求只由空闲 Harness 会话领取；已有草稿或正在生成时保持排队，绝不覆盖草稿。
- 明确发送边界：自动同步只在本机显示当前笔记/选区；只有点击“发送”后，选定上下文才进入模型请求。
- 一会话一请求：同一会话一次只运行一个 HUD 问题；未领取的排队问题可取消，已经提交的模型回合不伪装成可取消。
- 同端审批：当 Harness 工具需要权限时，Obsidian HUD 立即切换为“等待权限确认”，展示请求原因并提供“拒绝／允许一次”；处理后同一模型回合继续或安全结束。
- 品牌与状态动画：Harness 启动按钮、最小化状态、HUD 标题和 Obsidian Ribbon/标题统一为 DeepSeek 官方蓝小鲸鱼；排队、准备、提交和流式回答期间，思考气泡从鲸鱼头顶向左上方冒出，不再从右上方尾巴附近出现。“回答完成”使用蓝色流动高光；系统开启“减少动态效果”时自动停用动画。

可选的原生伴侣在 obsidian-companion/；安装到目标 Vault 后，可直接在 Obsidian 中用相同快捷键问答。伴侣本身不直接修改编辑器；写入由 Harness Host 在确认时复核提案归属、目标文件与原内容哈希，不一致即拒绝。

安装

环境：DSH 0.1.0-rc.6（npm 全局安装），Node 22.19+，pnpm（插件构建用）。

1. 构建（主机 tsc + 客户端 tsdown；依赖类型从全局 dsh 安装链接）
2. 持久化安装到 web profile（改 profile dependencies+bundles+junction+免重启热装配）

在 Harness 会话内（超级模组注入器可用时）执行：

- dev_install_package，dir 为本插件目录，profile 为 web

手工安装等价步骤：

- 在 ~/.dsh/profiles/web/package.json 的 dependencies 添加
"@dsh-external/dsh-obsidian-workbench": "link:/绝对路径/dsh-obsidian-workbench"
- 在 dsh.profile.bundles 数组添加 "@dsh-external/dsh-obsidian-workbench"
- 建立 junction：ln -s /绝对路径/dsh-obsidian-workbench ~/.dsh/profiles/web/node_modules/@dsh-external/dsh-obsidian-workbench

安装 Obsidian 原生伴侣（可选）

Harness host 先启动一次以生成配对令牌，然后执行：

bash scripts/install-obsidian-companion.sh "/绝对路径/你的Vault"

脚本只复制 manifest.json、main.js、styles.css 到该 Vault 的 .obsidian/plugins/dsh-obsidian-hud/，覆盖前会把旧副本备份到本项目 backups/obsidian-companion/ 并校验三份文件的 SHA-256。随后在 Obsidian“设置 → 第三方插件”中启用 DeepSeek Harness AI HUD。默认连接生产地址 http://127.0.0.1:3080；隔离测试可在插件设置中改为 3180。

启动

dsh web 启动后访问 http://127.0.0.1:3080
配置（界面）

「设置 → Obsidian 工作台」：

1. 输入 Vault 目录绝对路径（或点「自动发现候选」），点「添加并授权」——授权必须由用户明确确认；
2. 选择激活 Vault；点「重建索引」；
3. 输入框左侧按钮打开导航抽屉，选中笔记后阅读器自动打开；
4. 阅读器操作：「加入上下文」「询问当前笔记/标题/选中文本」「复制定位」「在 Obsidian 打开」；
5. 回答中的 vault 引用会渲染为来源卡片，点击定位到笔记与行号；
6. 上下文 chips 显示在输入框上方（字符预算、截断标记、移除/清空）；未点发送前不会把内容发给模型。

测试

- typecheck：tsc --noEmit
- v1.2 Alpha 2：新增 HUD 状态模型、命令面板/Slash、拖放/缩放/固定、快速捕获、引用回跳、请求绑定 Diff 与 Obsidian 选区菜单测试。
- v1.2 Alpha 4：移除双端 HUD 自有 ⌘K 面板与遮罩层，新增静态契约，确保构建物不再包含该阻塞界面。
- v1.2 Alpha 5：回答区不再引用 Harness 中缺失的 --dsw-alias-bg-layer-0 并回退到深色常量；双端改为直接跟随当前主题主面板色。
- v1.2 Alpha 6：双端星星图标替换为 DeepSeek 小鲸鱼；新增思考动画和蓝色“回答完成”加载状态，并为图标、状态条件和 reduced-motion 增加回归契约。
- 真实冷会话：HUD → composer 两阶段提交 → opencode-go/MiMo V2.5 → 流式/最终回答回 HUD；回答精确包含 OBSIDIAN_LIVE_CONTEXT_SENTINEL_847291，session.history 的 request header 含对应 Obsidian 上下文，fixture SHA-256 前后不变。
- 构建：bash scripts/build.sh（host tsc + client tsdown）

卸载与回滚

1. Harness 会话内：dev_uninstall_package（match 为 obsidian-workbench）或 dev_uninject_plugin；
2. 手工回滚：从 ~/.dsh/profiles/web/package.json 移除本插件的 dependencies 与 bundles 条目；删除对应 node_modules junction；重启 dsh web；
3. 数据：~/.dsh/storages/obsidian-workbench 下索引文件与 settings.yaml 中 obsidian-workbench 段可随时删除；插件从不写入未授权目录。

升级

1. git pull（或更新插件目录）后 bash scripts/build.sh；
2. Harness 会话内 dev_reload_package（packageName 为 obsidian-workbench）热重载；
3. 或重启 dsh web（bundles 装配自动加载新版本）。

已知限制

- 附件第一阶段只显示名称/路径；图片经严格路径校验后可本地显示，PDF/音频仅提供打开入口；
- heading anchor 为近似 Obsidian 算法（行号引用不受影响，始终精确）；
- 反链匹配覆盖相对路径/文件名/后缀匹配；对 ./ 相对链接与重名笔记的歧义消解为已知限制；
- 大 Vault 首次索引耗时取决于文件数（后续增量）；文件监听使用 fs.watch + 60s 轮询兜底；
- 原生 HUD 是桌面伴侣（isDesktopOnly=true）；实时问答需要 Harness 网页保持打开且至少有一个会话。快速捕获预览在本机直接生成，不依赖模型会话。
- Obsidian 自动同步只传送到本机 HTTP 回环地址；伴侣会主动拒绝远程主机、HTTPS、用户信息、额外路径、查询或片段，避免误把配对令牌带出本机。
- 伴侣只读取当前用户主目录内名为 bridge-token 的普通文件，并强制校验当前用户所有权、非符号链接和 0600 权限。
- 写入仅支持新建/追加/局部替换，删除功能留待后续阶段；
- 向量检索/OCR/PDF 锚点、法律/学术工作区为后续阶段模块。

后续迭代

后续 Notion 式方向：块级拖拽/重排、引用预览浮层、数据库属性视图、会话与笔记双向链接和多提案批量审阅；研究方向继续保留 Legal Matter Workspace / Authority Table / Evidence Matrix / Academic Research Workspace / OCR-PDF Anchor（独立服务或可组合视图）。