@zerowall/dsh-plugin-mineru 0.0.0-stage → 0.1.0-preview.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,7 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write distribution/plugins/dsh-plugin-mineru/README.md
+/zerowall-dsh-plugin-mineru:
+  en: e48113107e9795d7
+  zh: ae325254c499b86a

package/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# @zerowall/dsh-plugin-mineru
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+English | [中文](README.zh.md)
+
+MinerU document parsing for ZeroWallScience, using DSH 0.2.2-rc.1 and Node.js 24.9 or later. The package supplies `mineru_activate`, `mineru_parse`, `mineru_batch_parse` and `mineru_task`. Configure the API endpoint, parsing mode and token in the environment settings page or this plugin's configuration page. It uses the Host credential store and waits for official environment initialization before resolving `MINERU_API_TOKEN`.
+
+Inputs are HTTP(S) document URLs, files inside the current session workspace, or native file attachments verified against the current session's user messages and SHA-256 digest. Local paths outside the workspace require an authorized session attachment. Paths derive from the selected workspace or `DSH_HOME`; no previous installation directory is required.
+
+Task records and checksummed Markdown, normalized content lists and image artifacts are written under the session workspace's configured artifact directory. Conversations without a workspace store artifacts beneath `DSH_HOME` (or the standard user DSH home). Interrupted uploads and parsing resume through `mineru_task` using the original task ID, without submitting another document. Service disposal cancels and waits for active parsing before releasing its state.
+
+No Python runtime or separate MinerU Skill is installed by this package. A missing token is reported explicitly, and the settings page offers a connection test that does not submit a document.
+
+Development: `node ../../scripts/build-plugin.mjs`, `node node_modules/vitest/vitest.mjs run`, and `node node_modules/typescript/bin/tsc -p tsconfig.build.json --noEmit`.

package/README.zh.md

@@ -0,0 +1,13 @@
+# @zerowall/dsh-plugin-mineru
+
+[English](README.md) | 中文
+
+为 ZeroWallScience 提供 MinerU 文档解析，运行基线为 DSH 0.2.2-rc.1 和 Node.js 24.9 或更新版本。包提供 `mineru_activate`、`mineru_parse`、`mineru_batch_parse` 和 `mineru_task`。在环境设置或本插件的配置页设置 API 地址、解析模式和令牌。插件使用 Host 凭据存储，并在读取 `MINERU_API_TOKEN` 前等待官方环境初始化完成。
+
+输入可以是 HTTP(S) 文档 URL、当前会话工作区内的文件，或通过当前会话用户消息和 SHA-256 摘要验证的原生文件附件。工作区外的本地路径需要通过已授权的会话附件提供。路径从所选工作区或 `DSH_HOME` 解析，不依赖以前的安装目录。
+
+任务记录以及带校验和的 Markdown、规范化内容列表和图片产物写入会话工作区配置的产物目录。没有工作区的会话将产物保存到 `DSH_HOME` 或标准 DSH 用户目录下。中断的上传和解析通过 `mineru_task` 使用原任务 ID 恢复，不会重复提交文档。服务停用时先取消并等待正在执行的解析，再释放状态。
+
+此包不安装 Python 环境或独立 MinerU Skill。缺少令牌时会明确报错，设置页提供不提交文档的连接测试。
+
+开发检查：`node ../../scripts/build-plugin.mjs`、`node node_modules/vitest/vitest.mjs run` 和 `node node_modules/typescript/bin/tsc -p tsconfig.build.json --noEmit`。

package/dsh.bundle.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: zerowall-mineru
+      name: '@zerowall/dsh-plugin-mineru'