hellosky983/dsh-qrcode

dsh-qrcode

Awesome DSH Plugin

一个用于 DeepSeek Harness 的离线二维码和条形码生成器。纯本地计算——无网络、无 shell、无依赖。

概述

DeepSeek Harness 会话通常在受限的网络访问下运行（没有 npm、没有 CDN、没有在线编码器 API），因此在会话内部生成可扫描的码并非易事。本插件解决了这个问题：它提供 qrcode 和 barcode 模型工具，完全在本地进行编码和渲染，零运行时依赖。它面向需要在任何 DSH 会话中（包括完全离线或沙箱化的会话）以 SVG / PNG / ASCII 输出获取二维码（URL、WiFi、vCard、tel、sms）或一维条形码（Code128、EAN-13）的智能体和用户。

兼容性

- DSH 版本：0.1.0-rc.6
- 主线：已针对 2026-08-14 的 deepseek-harness 主线快照进行验证
- 最后验证时间：2026-08-14

安装 / 卸载

安装（从 GitHub）：

dsh plugin add github:hellosky983/dsh-qrcode

或克隆并在本地安装：

git clone https://github.com/hellosky983/dsh-qrcode.git
cd dsh-qrcode
dsh plugin add .

升级：在 git pull 后重新运行安装命令。

临时禁用：从你的 profile 组合中移除该插件行，或运行：

dsh plugin remove dsh-qrcode

卸载：从 profile 的 package.json 中移除 dsh-qrcode 依赖及其 bundle 条目，然后执行 pnpm install。

快速开始

告诉智能体：

把这个链接做成二维码: https://example.com

或直接调用工具：

qrcode text="https://example.com" format=svg
barcode text="ABC-123" symbology=code128 format=svg

qrcode 返回 SVG 标记（保存为 .svg 文件）、PNG 数据 URL 或 ASCII 预览。barcode 支持 code128 和 ean13。

配置

| 工具 | 选项 | 默认值 | 描述 |
| --- | --- | --- | --- |
| qrcode | text | —（必填） | 要编码的内容：URL、WIFI:...、vCard、tel/sms 或纯文本 |
| qrcode | format | svg | svg / ascii / png |
| qrcode | ecl | M | 纠错级别 L/M/Q/H |
| qrcode | scale / border / fg / bg / mask | 4 / 4 / #000 / #fff / auto | 渲染选项 |
| barcode | text | —（必填） | Code128（ASCII）或 EAN-13（12/13 位数字）的内容 |
| barcode | symbology | code128 | code128 / ean13 |

无环境变量，无密钥。

权限与数据

- 读取：无（完全由输入参数决定的纯函数）。
- 写入：无。工具在结果中返回文本/SVG/PNG 数据。
- 网络：无。编码和渲染完全在本地进行。
- 凭据：无。

故障排除

- 安装后工具不可见：重启 dsh，或检查 bundle 行是否出现在 dsh --dump-config 中。
- "cannot get property tools without inject"：该插件需要 inject = ['tools']；请从声明了该项的最新提交重新安装。
- PNG 输出为 data URL：当需要文件产物时，agent 应优先使用 format=svg，并将返回的标记保存为 .svg 文件。
- 日志：dsh profile 日志位于 ~/.dsh/profiles// 下。
- 回滚：通过重新安装先前的 git commit 来还原到之前的插件版本。

开发

git clone https://github.com/hellosky983/dsh-qrcode.git
cd dsh-qrcode
node --check index.js

该编码器已针对 zxing-cpp 进行验证（96/96 测试向量，版本 1–40，所有掩码/纠错级别），并与 segno 交叉核对掩码评分。测试套件保存在本仓库的提交历史中。

贡献：在 GitHub 上提交 issue 和 pull request。保持变更无依赖（编码器是自包含的）。报告 bug 时请附上最小复现案例。

许可证与安全

MIT — 参见 LICENSE。不附带任何机密信息；请通过 GitHub issue（仓库为公开）或发送邮件给仓库所有者私下报告安全问题。