English | 简体中文
dsh-jina
DeepSeek Harness 的 Jina AI 插件（bundle）：把 jina-cli 的全部 API 能力以模型工具的形式装进 dsh，并在 Web 设置的插件 → 配置页（与 终端 / Agent 循环 / 网页搜索 相同的标准插件配置位置）提供 Jina Tools 卡片来配置 API key。
更新日志
0.3.0（2026-08-15）
- feat
jina_primer重做：返回真实上下文——主机时钟（ISO 时间 / unix / 时区 / UTC 偏移）、网络事实（公网 IP 与位置，尽力而为，失败时降级）与 Jina 账户状态（身份 / 余额）。解析与格式化抽成纯函数模块primer.js，新增 17 个零依赖单元测试（npm test）。 - fix 工具描述不再把「需要 API key」列为前置条件。
0.2.0（2026-08-14）
- feat 新增
jina_search_arxiv/jina_search_ssrn专用学术检索工具（对应jina search --arxiv/--ssrn），工具名即用途；README 增加与内置web_search的交叉对比表。 - feat 设置页 Jina Tools 卡片实时显示当前 key 的身份与余额（经
/api/dsh-jina/primer，可手动刷新；保存 / 清除 key 后自动重检）。 - feat
jina_datetime返回提取出的标题 / 发布时间，不再吐原始 JSON 块。 - fix 工具参数改为规范的 JSON Schema；设置 UI 移入标准插件配置位置（设置 → 插件 → 配置）。
- refactor API key 改走 dsh 原生凭据通道（
JINA_API_KEYcredential seam）。 - fix 增强
link:安装的 schemastery 解析；导出package.json子路径。 - style 设置页主题 token 增加降级颜色。
- docs 新增英文 README 与语言切换链接；修正 README 安装命令的仓库地址与 key 获取链接。
0.1.0（2026-08-14）
- feat 首版：dsh-jina bundle——10 个
jina_*模型工具（search / read / screenshot / embed / rerank / classify / pdf / expand / datetime / primer）+ 设置页 API key 配置 UI。
功能
安装后所有会话（所有 agent preset）都会获得 12 个 jina_* 工具：
| 工具 | 对应 jina-cli 命令 | 说明 |
|---|---|---|
jina_search |
jina search |
通用网页搜索（默认 web 域；images / blog 域，支持时间过滤与地区/语言提示） |
jina_search_arxiv |
jina search --arxiv |
arXiv 预印本检索（CS / ML / 数学 / 物理等，返回 arxiv.org 官方论文直链） |
jina_search_ssrn |
jina search --ssrn |
SSRN 论文检索（经济 / 金融 / 法律 / 管理等社会科学，返回 papers.ssrn.com 直链） |
jina_read |
jina read |
把网页读成干净的 markdown |
jina_screenshot |
jina screenshot |
网页截图，返回托管图片 URL（支持整页截图） |
jina_datetime |
jina datetime |
推测网页的发布/更新时间 |
jina_expand |
jina expand |
把搜索词扩展成一组相关查询 |
jina_embed |
jina embed |
文本向量化（默认 jina-embeddings-v5-text-small） |
jina_rerank |
jina rerank |
按相关性重排文档（默认 jina-reranker-v3.5） |
jina_classify |
jina classify |
文本分类 |
jina_pdf |
jina pdf |
从 PDF 提取图表/公式（支持 arXiv ID） |
jina_primer |
jina primer |
获取当前上下文：主机时钟（ISO 时间/unix/时区/UTC 偏移）、网络事实（公网 IP 与位置，尽力而为）与 Jina 账户状态（身份/余额） |
效果实测（与内置 web_search 交叉对比）
为了让模型不用记住参数就能用对检索域，学术检索单独拆成了 jina_search_arxiv / jina_search_ssrn 两个专用工具（对应 jina search --arxiv / --ssrn）——工具名即用途，模型看到用户要论文会直接调用它们。以下为 2026-08-13 在同机真实网络环境（VPN 系统代理）下的抽样对比：同一查询分别调用本插件与 dsh 内置 web_search，人工核对结果。
| 场景 | 本插件（dsh-jina） | 内置 web_search | 结论 |
|---|---|---|---|
| 学术检索（arXiv） | jina_search_arxiv「retrieval augmented generation survey」→ 9/9 全部为 arxiv.org 官方直链：2312.10997（RAG 经典综述）、2506.00054、2410.12837、2501.09136（Agentic RAG）、2405.07437、2504.08748 等，篇篇主题契合、摘要准确 |
同查询返回 arXiv 镜像站（ezproxy.obspm.fr、ar5iv、sinoxiv.napstic.cn）与 BibTeX 链接，官方直链缺失 | ✅ jina 胜：官方直链 + 精准召回 |
| 学术检索（SSRN） | jina_search_ssrn「large language models financial markets」→ 9/9 全部为 papers.ssrn.com 原文：市场情绪预测、LLM 模拟交易、AI 羊群效应、投资者分歧等，契合度极高 |
无 SSRN 专用检索能力 | ✅ jina 胜：独占 SSRN 域 |
| 中文新闻 / 社区 / 官方源 | jina_search 官方源（政府 / 公司官网）置顶，可加 time 过滤时效 |
同查询结果相关，但官方源不置顶 | ✅ jina 优：权威源优先 + 时效过滤 |
| 泛学术检索（未指定域） | 默认 web 域对 Springer / IEEE / ACL 等覆盖面一般（学术检索请改用上面的专用工具） | Springer / IEEE / ACL 覆盖面广 | ✅ web_search 优：泛学术检索用它 |
结论与分工用法：学术论文 → jina_search_arxiv / jina_search_ssrn；中文时效新闻 → jina_search（+ time）；泛学术 / 工程文档 → 内置 web_search。两者互补，覆盖全部检索场景。
注：上表为单轮抽样对比（非严格 benchmark），结果受当天网络与查询选择影响；两个工具链均真实可用，结论供选型参考。
安装
仓库地址：https://github.com/minatoAI/jina-web-search-dsh-plugin
插件按 bundle 方式分发，用 dsh plugin 安装进 profile（从源码 checkout 运行时用 pnpm dsh 代替 dsh）：
# 从 GitHub 安装（本项目无 build 脚本，无需 allowBuilds 授权）
dsh plugin --profile web add github:minatoAI/jina-web-search-dsh-plugin
# 更稳妥：固定到某个 commit，避免后续推送改变实际安装到的代码
dsh plugin --profile web add github:minatoAI/jina-web-search-dsh-plugin#<commit-sha>
# 或本地文件夹安装（开发调试用）
dsh plugin --profile web add ./jina-dsh-plugin
安装完成后重启 dsh（新 bundle 在下次启动时生效）：
dsh --profile web
然后打开 Web 界面 → 设置 → 插件 → 配置 选项卡 → 展开 Jina Tools 卡片 → 粘贴 API key → 保存。免费 key 在 https://jina.ai/ 获取。
卡片中的 API key 检测 区域会实时显示当前 key 的身份（Jina 账号）与余额（credits），并标注 key 的来源（本页保存 / key 文件 / 匿名配额），用于确认 key 是否真正生效；点击「刷新」重新检测（保存/清除 key 后也会自动重检）。该数据由主机端插件通过 /api/dsh-jina/primer 路由提供（与 jina_primer 工具同一接口），key 明文永不离开主机。
API key 解析顺序
每次工具调用按以下顺序找 key（任一命中即用）：
- 工具调用参数
apiKey - 设置页保存的 key（credential 引用
JINA_API_KEY，由 dsh 凭据存储持久化，如~/.dsh/.credentials.yaml） - 会话工作区的
jina-api-key.txt - dsh 主目录（
$DSH_HOME，默认~/.dsh）下的jina-api-key.txt
设置页保存新 key 后立即生效（无需重启，每次调用即时解析）；HTTP 401 时也会自动重读文件并重试一次。凭据值只通过 credentials.set 上行，任何读取接口都不会回传明文。同时支持在页面上一键清除。
网络与代理（中国大陆用户）
Jina 域名被直连网络屏蔽，需要 VPN。插件通过系统代理访问 Jina：每次调用前从 WinINET 注册表发现系统代理地址，传输失败时自动重新发现并重试一次——VPN 重启换了端口也能自愈。VPN 未开时工具会返回带提示的错误信息。
卸载
dsh plugin --profile web remove dsh-jina
仓库结构
jina-dsh-plugin/
├── package.json # manifest: "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
├── cordis.patch.yml # 组合层：插入 dsh-jina（主机工具行）与 dsh-jina/ui（客户端 UI 行）
├── index.js # 主机插件：12 个工具（含 jina_search_arxiv / jina_search_ssrn 专用学术检索）+ 网络传输 + JINA_API_KEY 凭据解析
├── primer.js # 纯函数模块：jina_primer 的解析 / 格式化逻辑（零依赖，可单测）
├── test/
│ └── primer.test.js # jina_primer 单元测试（node --test 自动发现）
├── ui/
│ ├── package.json # dsh.client 声明（platform: web）
│ ├── index.js # 空主机半身（保证 loader 行可用）
│ └── client.js # 预构建浏览器 bundle：设置 → 插件 → 配置 的 "Jina Tools" 卡片
├── README.md # 简体中文说明（本文件）
└── README.en.md # English README
开发说明
- 主机插件只依赖 Node 内置模块与 dsh 主机服务（
fs、subprocess、tools、credentials），无第三方 npm 依赖；凭据走 dsh 原生的 credential seam（引用JINA_API_KEY），任何 profile 组合都可以直接使用。 - 客户端 bundle 直接提交（
ui/client.js），无构建步骤，git 安装开箱即用。改 UI 后直接改该文件并重启即可。卡片注册进 Web 设置包声明的settings.plugin.item插槽（设置 → 插件 → 配置），这是第三方插件配置的标准位置；key 通过标准的credentials.describe/set/unsetRPC 管理（这是唯一对第三方插件开放的配置通道——settings 命名空间对浏览器有白名单限制）。 - 组合层遵循 dsh 约定：主机行
dsh-jina注册模型工具；客户端行dsh-jina/ui由 host 的 client-modules 服务通过ui/package.json的dsh.client声明发现并接入 Web boot graph。
测试
纯函数逻辑（primer 解析/格式化等）使用 Node 内置测试运行器，零依赖：
npm test # 等价于 node --test（自动发现 test/*.test.js）
测试用真实抓取的 r.jina.ai / ipinfo.io 响应形状作为 fixture，覆盖解析容错、 时间事实推导、文本/JSON 两种渲染与“不输出 undefined”等契约。
No comments yet. Be the first to write one.