dsh-pointer
Pointer
DSH 的预览内元素指针（指代器）：选择可预览文档中的元素，并向代理提供选择器、outerHTML 和 file:line
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Phonky-Chou/dsh-pointer#d042a84a42c0bb624caedee38558995a70dd722d
dsh-pointer
DSH 的预览内元素指针（指代器）：选择可预览文档中的元素，并向代理提供选择器、outerHTML 和 file:line
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Phonky-Chou/dsh-pointer#d042a84a42c0bb624caedee38558995a70dd722dPointer 以 dsh-pointer 发布，当前版本为 0.3.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 的文档预览里直接「指代」UI 元素：左键选中元素、右键拖拽框选区域， 把结构化信息 + 源码行号 送进对话，模型据此精确定位要改的代码。
预览里左键选元素、右键拖拽框选区域，编号标记与输入框 chip 一一对应：
选中的目标会变成输入框里的引用 chip，随消息一起发送：
文件:行号 精确交给 agent —— 不用再向模型描述「那个卡片」。dsh plugin --profile desktop add dsh-pointerdsh plugin --profile desktop add https://github.com/Phonky-Chou/dsh-pointerdsh plugin --profile desktop add <本仓库绝对路径>0.2.0-rc.2（Windows 桌面版）；无需构建、无第三方依赖127.0.0.1 上注册两条本地路由；状态写入 ~/.dsh/（pointer-context.json / pointer-settings.json / pointer-debug.json）。html / htm 渲染器（priority: 'extension'），
内置预览仍可从渲染器下拉切回 —— 不侵入、可卸载。srcdoc 沙箱 iframe 里，探针用 postMessage 回传；
用户页面无法接触 DSH 页面（不降级为 allow-same-origin）。<style>、图片/字体 → data: URL、CSS 内 url() 也一并内联，
因此带外部依赖的真实项目也能正常预览。文件:行:列；内联后会把 data: URL 还原成原始引用再匹配源码。DSH 的文档读取层对单页有 32 MB 上限（error.tooLarge），超过时 bytes-complete
预览拿不到内容。本插件默认的 「指代页」 使用 loading: 'renderer' 模式解决这个问题：
渲染器下拉里另有一个 「指代页·兼容模式」（bytes-complete），由 DSH 自己投递文件字节，
仅作兜底排障用，正常不需要选。
host 处理文档的内存开销约为文件大小的 6~7 倍，因此默认加了一道保护：
| 文件大小 | 行为 |
|---|---|
| ≤ 100 MB | 正常打开 |
| > 100 MB | 不读取，直接显示「文件过大」提示页（保护宿主进程） |
位置：预览头部开关旁的 「▾」菜单 → 大文件上限，可选 50 / 100 / 200 / 500 MB 或 不限。
设置保存在 ~/.dsh/pointer-settings.json，对所有预览生效。
实测参考（host 侧，同一台机器）：
| 文件大小 | host 耗时 | host 内存 |
|---|---|---|
| 10 MB | 193 ms | 103 MB |
| 41.3 MB | 752 ms | ~300 MB |
| 100 MB | 1375 ms | 691 MB |
| 项目 | 上限 |
|---|---|
| 外部资源内联总预算 | 8 MB（超出部分保留原始路径，可能显示裂图） |
| 行号可用（host 回传源码） | 源码 ≤ 8 MB，更大的文件只有路径、没有行号 |
| 单个元素上下文 HTML | 8 KB（区域项 2 KB，渲染进上下文时 600 字符） |
| pick 请求体 | 2 MB |
0.2.0-rc.2），并至少启动过一次lib/ 是可直接运行的产物）DSH 左侧栏点 插件 → 右上角 添加插件
输入 npm 包名：
dsh-pointer
也可以填源码地址（不需要 NPM 时）：
https://github.com/Phonky-Chou/dsh-pointer
国内网络可用 Gitee 镜像（必须带 .git 结尾）：
https://gitee.com/z_xl7974/dsh-pointer.git
填源码地址时的两个坑： pnpm 只把
.git结尾或git+https://开头的地址当 git 仓库，漏掉.git会报ERR_PNPM_TARBALL_EXTRACT；另外不要用github:owner/repo速记， 实测在部分网络下会因git ls-remote失败而报错，https://全写形式更稳。
安装完成后点对话框里的立即启用（没有这个按钮就忽略，见下一步）
重启 DeepSeek Harness；重启后到 插件 → dsh-pointer 确认开关是打开状态 （开关关闭时插件只是「已安装」，预览不会出现指代器）
git clone https://github.com/Phonky-Chou/dsh-pointer.git
cd dsh-pointer
powershell -ExecutionPolicy Bypass -File .\install.ps1
脚本会自动定位 DSH 安装目录、调用 DSH 自带 CLI 装进 desktop profile。
其它 profile / 卸载：
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Profile desktop
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Uninstall
# 从 npm 安装（推荐）
dsh plugin --profile desktop add dsh-pointer
# 或从源码安装
dsh plugin --profile desktop add https://github.com/Phonky-Chou/dsh-pointer
Gitee 镜像要写全（带 .git）：
dsh plugin --profile desktop add https://gitee.com/z_xl7974/dsh-pointer.git
装完都需要重启 DeepSeek Harness：host 与客户端包都在启动时加载。
在 DSH 右侧栏用预览方式打开一个 .html 文件（默认会走「指代页」渲染器）。
点顶部工具栏的 ◉ 指代器 进入指代模式 —— 按钮位置：
左键点页面元素 → 输入框出现「元素N」；右键拖拽框选区域 → 出现「区域N」。
把 chip 写进句子发送；模型收到选择器、标签、文本、outerHTML 与 文件:行:列。
▾ 展开角标可查看探针状态、本次已选数量，并可一键清除全部标记。
第一次打开文件时：DSH 会先在对话里给出一个蓝色文件链接，点它才会在右侧打开预览面板。 指代器只存在于预览面板里 —— 所以看不到
◉ 指代器时，先确认预览面板已经打开。
html / htm；md / txt / svg / PDF 等尚未接入（后续按 provider 扩展）。outerHTML 在上下文块里截断到 2KB。0.2.0-rc.2。lib/index.js host 半边：上下文块 + `/dsh-pointer/pick`、`/dsh-pointer/inline` 路由
lib/inline.js host 侧相对资源内联（fs 直接读盘）
lib/client.js client 半边：预览实现、探针、chip 投递、渲染层 chip 装饰
docs/DESIGN.md 技术底座设计（分层、协议、类型扩展方案）
examples/with-assets/ 资源内联验证夹具（外链 CSS / SVG / CSS 内 url()）
examples/demo/ 截图演示页（Aurora 数据看板，中性内容）
install.ps1 可选的一键安装/卸载脚本
MIT