工具与效率 · v0.7.0
dsh-documents
为 DeepSeek Harness 管理的文档流水线:agent 写入 Markdown 并收到 DOCX/PDF,交出 DOCX/PDF 并收到 Markdown,或存储在线来源的文本——wiki 附件、位于……之后的文档
作者原文(英文)
Managed document pipeline for the DeepSeek Harness: the agent writes Markdown and receives DOCX/PDF, hands over a DOCX/PDF and receives Markdown, or stores the text of an online source — a wiki attachment, a document behind an…
简介取自插件 README 开头,由 DeepSeek 模型翻译,仅供参考。
安装命令
dsh plugin --profile web add @yadsh/dsh-documents@0.7.0
已试装 · 层已挂载
已在一个隔离的 profile 里真装过:包能装上,并且插件层挂载成功。这一条是实测结果,不是作者的声明。
检测报告
能力清单
- 可执行外部程序
spawns-processes高关注1 处命中lib/documents/providers/process.js:16import { spawn } from "node:child_process";- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 含混淆或编码代码
obfuscated-code需留意110 处命中lib/client/card.js:98return (_jsxs("div", { className: "dsh-docs-body", children: [snapshot.status === "unavailable" ? (_jsx(Notice, { tone: …lib/client/card.js:100} }), _jsx(SelectField, { label: "PDF \u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E", value: confi…lib/client/card.js:101DEFAULT_DOCUMENTS_CONFIG.create.defaultPdfMode, disabled: fieldDisabled, options: PDF_MODES, testId: "docs-pipeline-pdf-…lib/client/card.js:103} }), _jsx(Notice, { tone: typstEngine === "enabled" ? "info" : "warn", testId: "docs-pipeline-typst-engine", children: …- 混淆本身不是恶意,但公开源码里出现大段混淆值得问一句为什么。
- 写入文件
writes-files需留意22 处命中…documents/orchestrator/assets.js:63await mkdir(options.assetsDir, { recursive: true });…documents/orchestrator/assets.js:162await writeFile(target, bytes);lib/documents/providers/docling.js:163await mkdir(assetsDir, { recursive: true });lib/documents/providers/docling.js:184await writeFile(path.join(assetsDir, fileName), payload);- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 可终止进程
kills-processes需留意1 处命中lib/workflow/store.js:98process.kill(pid, 0);- 看它终止的是自己启动的进程,还是按名字匹配到的任意进程。
- 发起网络请求
network需留意1 处命中lib/index.js:199return await web.fetch({ url }, signal);- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 读取文件
reads-files一般25 处命中…documents/orchestrator/assets.js:109bytes = await readFile(resolved).catch((error) => {lib/documents/providers/docling.js:70const file = await import("node:fs/promises").then((fs) => fs.readFile(input.inputPath));…orchestrator/extract-document.js:217const markdown = markdownPath === "" ? "" : (await readFile(markdownPath)).toString("utf8");…cuments/providers/libreoffice.js:121const entries = await readdir(outputDir).catch(() => []);- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 动态加载模块
dynamic-import一般11 处命中lib/documents/providers/docling.js:70const file = await import("node:fs/promises").then((fs) => fs.readFile(input.inputPath));lib/documents/providers/docling.js:168const { writeFile } = await import("node:fs/promises");…pes/documents/tools/compare.d.ts:153export declare function createDocumentCompareTool(options: DocumentToolOptions): import("@deepseek-ai/dsh-tools").ToolDe……pes/documents/tools/convert.d.ts:6export declare function createDocumentConvertTool(options: DocumentToolOptions): import("@deepseek-ai/dsh-tools").ToolDe…- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 读取环境变量
reads-env一般4 处命中lib/index.js:80this.workflows = new DocumentWorkflowService(() => this.runtime(), new WorkflowStore(path.join(process.env["DSH_HOME"] ?…lib/index.js:175const withEnv = applyDocumentsEnvOverrides(this.configSource(), process.env);lib/documents/providers/process.js:26export function buildProcessEnv(extra, source = process.env) {lib/documents/runtime.js:134const withEnv = applyDocumentsEnvOverrides(options.config, options.env ?? process.env);- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 接触凭据或密钥
credentials一般1 处命中lib/client.js:18"api-key": "Создать API-ключ",- 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 1 |
| 含混淆或编码代码 | obfuscated-code | 需留意 | 110 |
| 写入文件 | writes-files | 需留意 | 22 |
| 可终止进程 | kills-processes | 需留意 | 1 |
| 发起网络请求 | network | 需留意 | 1 |
| 读取文件 | reads-files | 一般 | 25 |
| 动态加载模块 | dynamic-import | 一般 | 11 |
| 读取环境变量 | reads-env | 一般 | 4 |
| 接触凭据或密钥 | credentials | 一般 | 1 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 182 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
可信度
- 0没有可扣分的项
认证等级 L2
- L0静态结构与契约✓sha512-hGuUapYgGTbkvken… 与本地 tarball 复算一致,补丁与入口齐备
- L1配置组合与依赖图✓跨包无 entry id 冲突,插入模块可解析,目录内 peer 满足
- L2隔离沙箱冒烟✓隔离 profile 安装成功,3.2s,层已挂载;宿主带它启动(booted)
- L3运行时健康监控—运行时观测到异常:spawns
评分口径与作者信息
从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分
- 维护者
- xarleyn
- 仓库
- https://github.com/xarleyn/dsh-plugins
- 许可
- MIT
- 最后发布
- 2026-10-11
- 周下载
- 702
- star
- 2
扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。
认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。
| DSH peer 依赖 | 9 个cordiscordis-plugin-loaderdsh-client-ui-plugin-managerdsh-client-ui-settingsdsh-client-ui-slotsdsh-scopedsh-settingsdsh-skill-filesystemdsh-tools均为 @deepseek-ai/ 下的包 |
|---|---|
| Node 要求 | >=22 |
| 第三方依赖 | 2 个 |
| bundle patch | ./cordis.patch.yml |
| 依赖安全公告 | 2 条,见下方 |
这个插件声明的依赖中,有 2 条已公开的安全公告 (最高等级:中):
| 等级 | 依赖包 | 编号 | 摘要 |
|---|---|---|---|
| 中 | yaml | CVE-2023-2251 | Uncaught Exception in yaml 修复版本:2.2.2 详情 |
| 低 | yaml | CVE-2026-33532 | yaml is vulnerable to Stack Overflow via deeply nested YAML collections 修复版本:1.10.3, 2.8.3 详情 |
查询的是依赖声明范围的下界(如 ^4.2.0 查 4.2.0),
不是实际安装到的版本。真正装的时候如果解析到了修复版本,就不受影响——
所以这是「可能受影响」,不是「这个插件有漏洞」。数据来自
OSV.dev。
元数据
| 主页 | https://github.com/xarleyn/dsh-plugins/tree/main/plugins/dsh-documents#readme |
|---|---|
| 仓库最近提交 | 2026-10-12 |
| 仓库创建 | 2026-08-29 |
DSH