dsh-sidebar-annotations
DSH 右边栏注释插件：网页预览、元素点选、多条折叠注释与页面调试
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zhxnix/dsh-sidebar-annotations#c6d04864ee386010359ac73a7e94b67a4a0e1706Sidebar Annotations 以 dsh-sidebar-annotations 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-sidebar-annotations 是一个可移植的 DSH 插件，为右边栏提供网页预览、元素点选注释、上下文批注和页面调试。每条注释都保留页面原文、网址和定位信息，多个注释可以折叠在输入框上方，一起随下一条普通消息发送。
它不绑定任何业务项目，也不会修改某个小程序插件。需要给本地小程序提供同样的交互时，预览插件可以使用本插件公开的 window.__dshWorkbenchPanels.BrowserPanel 适配器；见 docs/integrating-preview.md。
Esc 后恢复正常交互。sidebar_browser 工具，让 DSH 在当前会话的预览页上执行打开、快照、点击、填写、脚本和调试操作。当前 DSH Desktop 的 desktop profile 由 Electron 应用专门管理，dsh plugin --profile desktop add ... 会被 CLI 拒绝。因此桌面版请使用下面的 checkout 安装器；它会把插件链接到现有 desktop profile，并且不会替换 profile 中的其他内容：
git clone https://github.com/zhxnix/dsh-sidebar-annotations.git
cd dsh-sidebar-annotations
npm install
node scripts/install.mjs --profile "$HOME/.dsh/profiles/desktop"
也可以通过环境变量指定 profile：
DSH_PROFILE_DIR="$HOME/.dsh/profiles/desktop" node scripts/install.mjs
对于由 CLI 管理的 Web / Headless profile，可以使用 DSH 官方命令从 GitHub Release 安装：
dsh plugin --profile web add \
https://github.com/zhxnix/dsh-sidebar-annotations/releases/latest/download/dsh-sidebar-annotations.tgz
其中 web 可以换成当前 CLI 支持的 profile。CLI 是否接受 github:zhxnix/dsh-sidebar-annotations shorthand 取决于 DSH 版本；Release tarball 或 checkout 安装器更可靠。
本地安装器只会在 profile 的 plugins/dsh-sidebar-annotations 创建指向当前 checkout 的链接，并在 cordis.patch.yml 末尾追加带有明确起止标记的 loader 项。已有同名插件或未知文件不会被覆盖。
如果当前 DSH Desktop 已经启用 Electron webview，直接安装插件即可使用完整网页预览。较旧的 macOS 桌面版可能没有向 renderer 暴露 webview；这时插件会显示普通 iframe 兼容预览，网页加载仍可用，但跨源 DOM 点选、控制台和 DevTools 不能工作。
需要完整能力时，显式把 DSH Desktop 复制成另一份再打补丁。补丁脚本不会默认修改任何应用：
node scripts/patch-desktop.mjs \
--input "/Applications/DSH Desktop.app" \
--output "$HOME/Applications/DSH Sidebar Annotations.app" \
--codesign
也可以明确指定一个现有 app 或其 Contents/Resources/app 目录原地打补丁：
node scripts/patch-desktop.mjs --app "$HOME/Applications/DSH Sidebar Annotations.app"
安装器中的 --desktop-patch 只是这个脚本的便捷入口，同样必须明确提供输入 / 输出或目标 app：
node scripts/install.mjs \
--profile "$HOME/.dsh/profiles/desktop" \
--desktop-patch \
--desktop-input "/Applications/DSH Desktop.app" \
--desktop-output "$HOME/Applications/DSH Sidebar Annotations.app" \
--codesign
原 Electron 文件会保存在 ~/.dsh/backups/dsh-sidebar-annotations/，不进入插件包。恢复补丁：
node scripts/patch-desktop.mjs \
--restore \
--app "$HOME/Applications/DSH Sidebar Annotations.app"
补丁目前只支持 macOS Electron 桌面包。其他平台仍可安装插件并使用宿主支持的 iframe 预览；若宿主没有可控的 webview，完整 DOM 注释和 DevTools 需要由宿主后续提供相应能力。插件不会把 macOS 补丁强行应用到其他平台。
只有注释时，可以点击注释条上的箭头发送。发送失败时注释会留在当前 session 中，方便修改或重试。
小程序预览若由兼容插件提供 BrowserPanel，使用方式相同。元素若带有 data-dsh-source-file 和 data-dsh-source-line，注释还会携带源码文件及行号；这是预览编译器提供的模板位置，不推断业务逻辑位置。
注释插件在加载后暴露：
window.__dshWorkbenchPanels.BrowserPanel
预览插件可以将这个组件作为自己的 tab 内容，并传入独立的 panelKind 与 defaultUrl。这样每个预览 tab 可以记忆自己的网址，同时共享当前 session 的注释附件、上下文选择和发送逻辑。完整约定见 docs/integrating-preview.md。
对于由 CLI 管理的 Web / Headless profile：
dsh plugin --profile web remove dsh-sidebar-annotations
对于 checkout 安装：
node scripts/install.mjs \
--uninstall \
--profile "$HOME/.dsh/profiles/desktop"
checkout 卸载只删除本插件自己创建的链接和带标记的 loader 段，不会删除 profile 中的其他插件或配置。若使用过桌面补丁，还要按上面的 --restore 命令恢复 Electron 文件；删除应用副本是用户自行决定的可选清理步骤。重启 DSH 后插件才会完全卸载。
要求 Node.js >=22.12.0。构建不依赖作者机器上的绝对路径：
npm install
npm run build
npm test
npm pack --dry-run
src/client.js、src/style.css 和 picker / context-selection 模块会生成到 lib/。lib/ 是可直接被 DSH profile 加载的产物；发布包通过 package.json 的 files 白名单排除本地配置、profile、桌面应用副本和备份文件。
本项目使用 MIT License。上下文选区交互参考 dsh-select-to-chat，其许可全文和归属见 THIRD_PARTY_NOTICES.md 与 lib/context-selection.LICENSE。