技能包 · v0.2.4
dsh-lightrag
面向 DeepSeek Harness 智能体的知识库工具:模型可以查询 LightRAG 图 RAG 索引对某个主题的了解,以及该索引包含什么、健康状况如何,而无需获得 HTTP 客户端。
作者原文(英文)
Knowledge-base tools for DeepSeek Harness agents: the model can ask what a LightRAG graph-RAG index knows about a topic — and what the index holds and how healthy it is — without ever receiving an HTTP client.
简介取自插件 README 开头,由 DeepSeek 模型翻译,仅供参考。
安装命令
dsh plugin --profile web add @yadsh/dsh-lightrag@0.2.4
已试装 · 层已挂载
已在一个隔离的 profile 里真装过:包能装上,并且插件层挂载成功。这一条是实测结果,不是作者的声明。
检测报告
能力清单
- 写入文件
writes-files需留意1 处命中package.json:78"clean": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 动态加载模块
dynamic-import一般8 处命中lib/tools/documents.d.ts:30export declare function createLightRagDocumentsTool(deps: LightRagToolDeps): import("@deepseek-ai/dsh-tools").ToolDefini…lib/index.d.ts:34export declare const Config: import("@deepseek-ai/schemastery").default<LightRagConfig>;lib/index.d.ts:57Config: import("@deepseek-ai/schemastery").default<LightRagConfig>;lib/tools/query.d.ts:29export declare function createLightRagQueryTool(deps: LightRagToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition…- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 接触凭据或密钥
credentials一般6 处命中lib/client.js:207if (config.apiKey !== "")lib/client.js:208headers["X-API-Key"] = config.apiKey;lib/config.js:57if (url.username !== "" || url.password !== "") {lib/config.js:130const configuredKey = typeof config.apiKey === "string" ? config.apiKey.trim() : "";- 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
- 读取环境变量
reads-env一般1 处命中lib/config.js:128export function resolveLightRagConfig(raw, env = process.env) {- 环境变量里常混有密钥。看它是否把整个 env 都读走。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 写入文件 | writes-files | 需留意 | 1 |
| 动态加载模块 | dynamic-import | 一般 | 8 |
| 接触凭据或密钥 | credentials | 一般 | 6 |
| 读取环境变量 | reads-env | 一般 | 1 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 23 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
可信度
- -10声明与实物不符:client-present-undeclaredmajor:['lib/client.d.ts', 'lib/client.d.ts.map', 'lib/client.js', 'lib/client.js.map']
认证等级 未评级
- L0静态结构与契约—没有取到 npm 官方哈希
- L1配置组合与依赖图✓跨包无 entry id 冲突,插入模块可解析,目录内 peer 满足(前一级未通过,本项不计入等级)前一级未通过,不计入等级
- L2隔离沙箱冒烟✓隔离 profile 安装成功,8.6s,层已挂载;宿主带它启动(booted)(前一级未通过,本项不计入等级)前一级未通过,不计入等级
- L3运行时健康监控✓抽样会话内未观测到外部进程 / 越界写 / 外连(2 个事件)(前一级未通过,本项不计入等级)前一级未通过,不计入等级
评分口径与作者信息
从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分
- 维护者
- xarleyn
- 仓库
- https://github.com/xarleyn/dsh-plugins
- 许可
- MIT
- 最后发布
- 2026-10-11
- 周下载
- 814
- star
- 2
扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。
认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。
| DSH peer 依赖 | 1 个dsh-tools均为 @deepseek-ai/ 下的包 |
|---|---|
| Node 要求 | ^22.19.0 || >=24.0.0 |
| 第三方依赖 | 1 个 |
| bundle patch | ./cordis.patch.yml |
| 依赖安全公告 | 已查询全部依赖,没有匹配到已公开的安全公告(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。) |
元数据
| 主页 | https://github.com/xarleyn/dsh-plugins/tree/main/plugins/dsh-lightrag#readme |
|---|---|
| 仓库最近提交 | 2026-10-12 |
| 仓库创建 | 2026-08-29 |
DSH