メインコンテンツへスキップ
I

dsh-asset-library

isdou/dsh-asset-library

Local reference image library for DSH, allowing fast @keyword image search and attachment directly from the conversation input.

インストール

dsh plugin --profile web add github:isdou/dsh-asset-library

README

资产库 · DSH Asset Library

像 @人 一样在对话框引用设计参考图。
专为多模态 UI 开发打造的本地素材库,打字间隙无缝唤出参考图,彻底告别切屏找图。

为什么需要资产库?

在用视觉模型调界面、还原设计稿时,反复切桌面、截长图、拖拽粘贴,沉浸式编码心流总是被打断?

  • 对话框原生 @选图:在对话输入框输入 @关键词(如 @首页),即时呼出本地参考图菜单,回车即可作为附件喂给多模态模型,无需切屏找图。
  • 跨项目灵感集中营:集中存放竞品截图、UI 规范、产品视觉资产,支持内容去重、标签索引与多工作区自由复用。
  • 纯本地安全隔离:素材纯本地存储管理,无云端数据泄露风险,轻量极速。

能做什么

把设计参考、截图和灵感图片集中保存在本机,在不同产品工作区之间复用。在项目对话输入 @关键词,从原生候选菜单的 资产库 分组选图,即可追加图片附件。

安装

当前版本 0.2.2,支持 DeepSeek Harness 0.2.2-rc.3。请先确认宿主版本;后续宿主版本需要重新验证原生触发器和附件接口。

在 DSH 桌面版 插件 → 添加插件 中输入公开安装包链接:

https://github.com/isdou/dsh-asset-library/releases/download/v0.2.2/isdou-dsh-asset-library-0.2.2.tgz

Web profile 也可通过 CLI 安装:

dsh plugin --profile web add https://github.com/isdou/dsh-asset-library/releases/download/v0.2.2/isdou-dsh-asset-library-0.2.2.tgz

管理 desktop profile 时,使用桌面应用自带的 dsh 命令:

dsh plugin --profile desktop add https://github.com/isdou/dsh-asset-library/releases/download/v0.2.2/isdou-dsh-asset-library-0.2.2.tgz

打开左侧 资产库 即可使用。如宿主提示需要重启,请先保存当前工作,再重启应用。

使用

  1. 在资产库点击 导入图片,或把图片拖入图库。
  2. 可按产品或用途创建分组,并为图片添加标签。同一张图可属于多个分组,重复导入按内容去重。
  3. 在项目对话输入 @ 或 @关键词,从 资产库 分组中选图。支持搜索名称、标签和分组名称。
  4. 鼠标点击、Enter 或 Tab 选择图片;Escape 只关闭候选菜单。图片进入原生待发送附件栏,其他正文和已有附件保留,由你决定何时发送。

例如输入 参考 @首页。@ 需位于行首或空白之后,这是 DSH 的原生触发规则。包含空格的词可输入 @"产品 A。

也可以在图库卡片上直接预览、加入当前对话,或打开详情编辑名称、标签和分组。取图期间会显示“正在添加参考图…”,待附件出现后再发送;失败、改稿或切换对话时会取消尚未完成的加入,并通过原生提示说明。

支持 PNG、JPEG、WebP、GIF,单图最大 20 MiB,并遵循 DSH 自身的图片解码与尺寸限制。动画处理遵循宿主的静态参考图规则。实际读图需要选择支持图片的模型。

本地数据、升级和备份

默认数据保存在稳定的插件专属目录:

~/.dsh/plugin-data/isdou-asset-library/
├── index.json
├── originals/
└── trash/

配置 DSH_HOME 时,目录改为 $DSH_HOME/plugin-data/isdou-asset-library/。它与可替换的 npm 包目录分开,因此升级插件不会更换素材目录。所有使用同一 Harness home 的工作区和 profile 共用此库。

也可在启动宿主前设置 ISDOU_ASSET_LIBRARY_DATA_DIR 指定独立素材目录。该变量优先于 DSH_HOME;空白值视为未设置。

备份整个素材目录即可。删除分组只移除关联;移到回收站会保留原图与回收元数据。已经发送的图片由 DSH 原生附件存储保留,移出图库不会删除历史对话附件。

从早期本地开发安装迁移时,请先保留原来的 data/ 备份,再将确认属于本插件的数据复制到新的专属目录;不要覆盖已有图库。

数据流与权限

导入、浏览和搜索均在本机处理,不调用模型。通过 DSH 发送图片消息或使用读图工具时,图片才进入所选模型的输入流程。

插件提供 asset_library 和 asset_library_read_image 工具。工具是否展示取决于当前 Agent 预设;共享库写入遵守当前会话的原生权限或单次审批,不会自行授予权限。界面和工具复用相同操作。

图库使用跨进程锁、原子索引更新、内容去重和原图长度/SHA-256 核验。缩略图按需生成,图库分页加载。界面继承 DSH 的主题、字体、原生菜单及控件约定,支持明暗主题、键盘和窄屏。

开发

源码检出目录中可以运行 npm test、npm run check、npm run dev。公开安装包只包含运行文件和使用文档,不包含测试、开发脚本、素材或验收记录。

版权

本包公开提供安装和运行,作者保留版权,不按 MIT 等开源许可发布。修改、再分发或将代码用于其他产品的权利未由本次发布授予,详见 LICENSE。

関連プラグイン