dsh-csv-and-image-preview

English | 中文

在 DeepSeek Harness 聊天中预览图片、SVG 和 CSV/TSV。图片使用原生 <img>，表格使用原生 <table>，支持粘性表头、320px 内部滚动和点击排序。

安装与升级

0.1.3 针对 DSH 0.1.5-rc.1 验证，使用新版 Connection RPC 接口。请使用该版本或兼容接口的更新版。

# 安装已发布版本
dsh plugin --profile web add @jetecho/dsh-csv-and-image-preview

# 从当前仓库打包并安装修复版（无需发布 npm）
npm ci
npm test
npm pack
dsh plugin --profile web add ./jetecho-dsh-csv-and-image-preview-0.1.3.tgz

安装后重启 dsh web 并刷新浏览器。包名、bundle 行 ID 和工具名均保持不变。

0.1.3：修正正文预览的实际挂载

0.1.3 使用独立的 conversation.chat.node 键控内容行，在 turn/end 之后显示预览，避开执行过程的折叠区间。原有文件卡片继续由 DSH 渲染。

图片、SVG、CSV 支持直接调用、run_code 嵌套调用和旧版 meta。刷新或重新打开会话后重放已保存的预览；仅调用 DSH present 而没有调用本插件的文件不在此功能范围内。

验证：npm test 使用真实 SlotCore 校验注册。设置 DSH_UPSTREAM 为 DSH 源码目录后，可额外使用真实 ConversationNodeAssembler 和 ChatSnapshotBuilder 检查增量事件与历史回放。npm run preview:test 提供浏览器验收页；同时设置 DSH_SESSION 为本机会话文件时，只读回放该会话及已有快照，不修改原会话文件。

兼容性修复

预览只注册 /api/csv-and-image-preview/get 精确路由，避免占用由 DSH 系统网关独享的 /api 拦截器，保证历史列表和插件列表正常加载。升级后重启 DSH 并刷新页面即可重新加载，修复不修改会话文件。

• 前端声明 slots、connection 服务依赖，后端声明 tools、connection；服务稍晚就绪时会等待，卸载时清理注册。
• 直接调用和 run_code 嵌套调用均可预览。 新版 DSH 不为嵌套调用生成 presentationMeta，因此本插件改用独立快照通道。
• 工具只读取、解析一次输入，在返回成功之前保存快照。模型和 run_code 程序收到的仍是字符串摘要，不额外包含图片字节或表格正文。
• 前端区分生成中、加载中、执行失败、快照缺失和图片解码失败，支持重试、连接恢复后重新读取，以及切换会话时取消过期请求。
• 旧会话已有的 block.meta.src / block.meta.rows 继续显示。旧版嵌套调用如果从未保存展示数据，需重新调用预览工具。

使用

让 agent 调用工具，例如：

preview_image {"path":"D:/assets/logo.svg","label":"Logo 预览"}
preview_csv {"path":"D:/data/sales.csv","label":"销售数据","maxRows":100}
preview_csv {"content":"姓名,分数\n张三,90\n李四,85"}

内联 SVG 可直接传入 content。相对路径以当前会话工作目录为基准。path 与 content 同时存在时优先读取 path。

图片支持 SVG、PNG、JPEG、GIF、WebP、BMP、ICO、AVIF。内联非 SVG 内容使用标准 base64，同时指定 mime。图片和 CSV 输入均限制为 8 MiB；内联 base64 限制按编码后的输入大小计算。

CSV 文件必须为 UTF-8，支持 UTF-8 BOM；其他编码会明确提示转换，而不是输出乱码。自动识别逗号、分号、Tab、竖线，或用 delimiter 指定；.tsv 默认 Tab。默认显示前 50 行，最多 500 行（均含表头）、40 列，每个单元格最多保存 200 字符加省略号。悬停显示已保存的单元格内容，截断部分无法还原。点击表头循环升序、降序、原始顺序，空值始终沉底。

数据与历史预览

预览快照保存在 $DSH_HOME/storages/csv-and-image-preview/；未设置 DSH_HOME 时使用 ~/.dsh/storages/csv-and-image-preview/。每条记录按会话 ID、调用 ID 和工具名定位，路径采用哈希文件名。通过 DSH Connection 的已认证 /api RPC 通道读取，并核对记录身份。

刷新页面、重启 DSH 或修改/删除原文件后，同一会话仍显示生成时的快照。备份会话时应同时备份此目录。当前不自动清理快照；删除目录会让新版历史预览失效。复制/分叉成新会话时不自动迁移原会话的快照。

调用返回 预览数据已生成… 表示快照保存成功，不代表浏览器已解码显示。工具执行错误作为真正的失败交给 DSH，避免误报成功。

预览优先约定

生成或修改图片、SVG、CSV 时，先预览，用户认可后再修改目标文件；预览快照本身会写入插件数据目录。此约定由 agent 遵守，插件不阻止其他写文件工具。可将 Agent.md 的说明加入 agent 指令。

开发

npm ci
npm test              # Cordis / DSH 工具调度、持久化、React 组件回归
npm run preview:test  # 本地浏览器验收页，终端显示地址
npm run build         # lib/ 为可直接发布的 JavaScript
npm pack --dry-run    # 检查发布文件

• lib/index.js：工具定义、输入读取与解析。
• lib/store.js：原子快照写入、读取边界、认证通道处理函数。
• lib/client.js：工具视图、RPC 读取、状态与重试、旧 meta 兼容。
• cordis.patch.yml：标准 Profile Bundle 插入行。

MIT © jetecho.