dsh-photo2dsh-by-lan

DSH PLUGIN视觉与多模态

仓库 apherchin/dsh-photo2dsh-by-lan · npm dsh-photo2dsh-by-lan

视觉与多模态 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

这款 DeepSeek Harness 插件让手机拍照经局域网一键直传 PC 指定文件夹,无需云盘或 IM,落地目录可在插件面板配置,DSH Agent 随即读取分析。

一句话选型结论

按资料字段整理

dsh-photo2dsh-by-lan 是视觉与多模态类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类视觉与多模态 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-04 创建于 2026-10-03
README 6.1 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:apherchin/dsh-photo2dsh-by-lan
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-photo2dsh-by-lan可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-photo2dsh-by-lan:把手机照片经局域网送进 DeepSeek Harness 工作区

  • 手机一键 POST 传图
  • 落地目录面板可配
  • Agent 直接读取分析
  • 到达弹 Windows 通知
  • 可选 token 校验

适用场景

文件读写存储视觉识别

上游标签

androidcordisdeepseek-harnessdshdsh-pluginios-shortcutslanlocal-firstphotophoto-transferpluginproductivityself-hostedwindows

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-09): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在视觉与多模态场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-photo2dsh-by-lan当前 L5 · 运行验证通过 低风险 0 0.2.0-rc.2 有
open-design L4 · 沙盒安装通过 低风险 10.0 万 未标注 有
awesome-gpt-image-2 L3 · 安装规范通过 低风险 3.4 万 未标注 无
PicGo L3 · 安装规范通过 低风险 2.7 万 未标注 无
iPolloWork L4 · 沙盒安装通过 低风险 6,775 未标注 有
modlens L5 · 运行验证通过 低风险 4,207 0.2.0-rc.2 等 13 个 有

仓库档案

视觉与多模态
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方apherchin仓库 dsh-photo2dsh-by-lan · 默认分支 main
分类视觉与多模态vision
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-03 · 2026-10-04最后推送 2026-10-04
本站收录2026-10-04首次进入本站目录的时间

README 全文

6.1 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-photo2dsh-by-lan

English | 中文

Phone camera → LAN → a folder on this PC → directly readable by the DSH agent.

One tap on the phone (iOS Shortcuts, Android HTTP Shortcuts) POSTs a photo to this PC.
The plugin receives it, writes it into a folder you choose, and raises a Windows toast.
No cloud, no IM app, no mobile app, no app.asar patching.

Its configuration UI lives in the DSH sidebar: Plugins → this package's page.


Features

  • One tap on the phone — iOS Shortcuts or Android HTTP Shortcuts POST a photo; nothing to install on the phone beyond that.
  • You choose the landing folder — configured in the panel; files appear there immediately.
  • Agent-readable — the folder is a normal directory, so DSH agents can read/analyse the photos right away.
  • Toast on arrival — a Windows notification confirms each photo (with a click-through).
  • No cloud, no IM app, no mobile app, no app.asar patching.
  • Optional token gate — off by default; when off, the LAN is the trust boundary (see §6).
  • Offline test bench — 50 assertions including every real-device failure mode we hit.

1. Install

# preferred (migratable)
dsh plugin --profile desktop add dsh-photo2dsh-by-lan

# or from a local checkout
dsh plugin --profile desktop add file:D:\path\to\dsh-photo2dsh-by-lan

Then allow the port through the firewall once (the only step needing admin):

netsh advfirewall firewall add rule name="DSH Photo2DSH" dir=in action=allow protocol=TCP localport=8787 profile=any

> ⚠️ Do not omit profile=any. A rule that only covers the public profile silently drops
> inbound packets when Windows classifies your network as private — the phone then reports
> "the server stopped responding", which is very hard to diagnose.
>
> Do not try to reuse an already-open port either: on the machine this was developed on, the only
> "any program, any profile" TCP port was held exclusively by http.sys (EACCES).

Restart DSH afterwards (the client half is assembled at boot).


2. Configure it in the plugin panel

Sidebar Plugins → this package → the config card:

Field Meaning
Landing directory Where photos land. A \ subfolder is created automatically
Port default 8787 — changing it needs a new firewall rule
Max file size (MB) default 64
Toast on arrival default on
Require token default on; keep it on
Upload URL / token read-only, one-click copy

Prefer a directory inside your current session workspace, so the file sandbox lets the agent read it.


3. Phone side

iPad / iPhone (Shortcuts) — four steps, step 3 is the one people miss

  1. Add Select Photos (or Take Photo).
  2. Add Convert Image → JPEG, quality 80%.
    Without it the same 8 MP photo arrives as a ~12 MB lossless PNG instead of ~1.5 MB.
  3. Add Get Contents of URL: paste the URL from the config card, expand Show More,
    set Method = POST, Request Body = File, then ⚠️ point the File field at "Converted Image"
    (leaving it on the original photo makes step 2 pointless). Finish with Quick Look.
  4. Run it. The response is a short human-readable message, not JSON:
✅ 照片已收到

格式:JPEG(1.63 MB)
文件:20261003232612-4d2b993e-image.jpg
时间:2026-10-03 23:26:12

已存入 PC 的收件箱文件夹

> On first LAN access iPadOS asks "allow access to local network devices" — you must allow it.
> That is an iOS gate, unrelated to the firewall.

To send only selected photos: ⓘ → Show in Share Sheet → accept Images, then share from Photos.

Android

Same URL, same POST + file body. The wire protocol is identical.


4. What lands on disk

\
└─ 2026-10-03\
├─ 20261003232612-4d2b993e-image.jpg     ← local timestamp - sha256[0:8] - sanitized name
└─ 20261003232612-4d2b993e-image.json    ← sidecar: original name, note, bytes, sha256, format, source
  • Same-second, same-name uploads never overwrite each other (link() + -1/-2 suffixes).
  • Format is decided by magic bytes, never by Content-Type: a real device sent image/jpeg
    in the header while the body was actually PNG.

5. Troubleshooting

Symptom Cause Fix
"server stopped responding" (timeout) inbound dropped by the firewall add the rule, with profile=any
❌ ... 地址里缺少正确的 token URL missing the /u/ part re-copy the full URL from the config card
❌ 这不是一张能识别的图片 the body really is not an image check the File field in your shortcut
response says "仍是 PNG" Convert Image is not wired to the File field see step 3 above
the package page does not appear its loader row is disabled, or profile not restarted the client half attaches to the row whose specifier is exactly the package name
port failed to start port already in use change the port and open the firewall for the new one

Log: $DSH_HOME\photo2dsh-by-lan.log · Config: $DSH_HOME\photo2dsh-by-lan.json


6. Security

  • Listens on the LAN only; never exposed to the internet.
  • 128-bit token in the URL path, generated and persisted on first run (so the install is portable).
  • A 401 never echoes the correct token.
  • The setup page (GET /) is served only to 127.0.0.1.
  • Turning Require token off lets anyone on the LAN — including a web page you visit — write files here.

7. Limitations

  • Windows only (os: ["win32"]; toasts use the Windows PowerShell 5.1 WinRT projection).
  • The toast shows Windows PowerShell as the app name unless you register an AUMID.
  • Not included: cloud relay, IM channels, an in-app photo browser, message injection, auto-cleanup.
  • Uninstalling does not delete photos you already received.

8. Development

node test/photo2dsh.test.mjs   # 50 offline assertions, including every real-device failure case

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-photo2dsh-by-lan 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:apherchin/dsh-photo2dsh-by-lan` 即可。对应的 npm 包名是 `dsh-photo2dsh-by-lan`。

dsh-photo2dsh-by-lan 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-photo2dsh-by-lan 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-photo2dsh-by-lan 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-photo2dsh-by-lan 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2。

dsh-photo2dsh-by-lan 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-photo2dsh-by-lan 有哪些功能?

手机一键 POST 传图、落地目录面板可配、Agent 直接读取分析、到达弹 Windows 通知、可选 token 校验。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

视觉与多模态
按星标排序,可作替代方案

open-design

open-design

L4 · 沙盒安装通过 10.0 万 星

awesome-gpt-image-2

awesome-gpt-image-2

GPT Image 2 / 2.5 提示词与案例库,530+ 个案例、20+ 套工业级模板与可复用 Skills,新增 2.5 同提示词对比

L3 · 安装规范通过 3.4 万 星

PicGo

PicGo

L3 · 安装规范通过 2.7 万 星

iPolloWork

iPolloWork

L4 · 沙盒安装通过 6,775 星

modlens

modlens

ModLens 是 DeepSeek Harness 的视觉插件,为纯文本模型外挂视觉能力,粘贴图片即得结构化 JSON 证据(OCR、版面

L5 · 运行验证通过 4,207 星

OpenBiliClaw

OpenBiliClaw

本地私有、开源的自进化跨平台 AI 内容发现 Agent:先理解你,再主动从 B站、小红书、抖音、YouTube、X、知乎、Reddit、微

L4 · 沙盒安装通过 3,398 星

apherchin 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-09。