dsh-origin-rvc-check 0.2.9 → 0.2.11

package/LICENSE

@@ -2,14 +2,200 @@
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
 
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
-    http://www.apache.org/licenses/LICENSE-2.0
+   1. Definitions.
 
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 PerryLink
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README-es.md

@@ -3,6 +3,7 @@
 [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
 
 [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-origin-rvc-check?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-origin-rvc-check?ref=badge)
 
 `dsh-origin-rvc-check` lee un registro de determinación de origen (原产地判定台账) —la cabecera del acuerdo más una fila por material— y comprueba la aritmética de ese mismo registro: que se declaren el acuerdo y el producto, que el contenido de valor regional sea igual a (FOB − valor de los materiales no originarios) ÷ FOB × 100, que el RVC alcance el umbral que usted configura, que cada material indique su origen, que el criterio de origen proceda del vocabulario de su acuerdo, que los números de material no se repitan y que no quede ningún marcador de plantilla sin sustituir en la descripción.
 
@@ -15,14 +16,47 @@ dsh --profile <name> --dump-config | grep 'dsh-origin-rvc-check'
 
 ## Cómo se ve la salida
 
-![Terminal demo of dsh-origin-rvc-check: real output over its OR-001 fixture](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-hero.png)
+![Diagrama de flujo de dsh-origin-rvc-check: documento → reglas → hallazgos.](docs/assets/dsh-origin-rvc-check-flow.svg)
+
+*Resumen del flujo: documento → reglas → hallazgos. Los ejemplos siguientes usan la superficie de comandos real.*
 
-![Animated terminal demo of dsh-origin-rvc-check](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-demo.gif)
 
 Salida real de este plugin sobre su propio fixture de prueba `OR-001` — no es un montaje. El paquete de reglas no inventa citas, así que cada hallazgo nombra la cláusula aplicada y advierte que su texto no se obtuvo.
 
 ## Qué responde
 
+### Ejemplos
+
+La tabla siguiente es el conjunto de ejemplos: la primera fila es el caso detallado y las demás son casos breves.
+
+
+#### Salida detallada
+
+**Herramienta** `origin_rvc_check`
+
+**Entrada**
+
+~~~json
+{"product":"某型电子元件","rows":[{"序号":"1","商品编号":"8541400000","品名":"某型电子元件","原产国":"日本","成交价格":"180","币制":"USD","非原产材料价值":"180","是否原产":"否","区域价值成分":"55.00","原产地标准":"RVC"}]}
+~~~
+ 
+**Salida**
+
+~~~json
+{
+  "id": "dsh-origin-rvc-check.OR-001.811c9dc5",
+  "ruleId": "OR-001",
+  "severity": "warn",
+  "locator": {
+    "field": "agreement"
+  },
+  "found": "材料表头缺少 agreement",
+  "expected": "表头应提供 agreement、product"
+}
+~~~
+
+*Observado en `dsh-origin-rvc-check/tests/fixtures/OR-001/OR-001-unsafe.json`*
+
 | Usted pregunta | Qué responde |
 |---|---|
 | La columna «区域价值成分» dice `70.00`, pero el «净价值» de la fila es `220` y el FOB de la cabecera es `400`. ¿Se detecta? | Sí. `OR-002` recalcula la fórmula de deducción (FOB − valor de los materiales no originarios) ÷ FOB × 100 a partir de la columna «净价值» y del FOB, con una tolerancia de 0,5 puntos, y señala la fila cuando el RVC declarado no coincide. Solo hace la aritmética y supone el método de deducción: un registro calculado por el método de acumulación se señala aunque su convención sea la correcta, así que cambie `expression` o desactive la regla. Si el RVC, el «净价值» o el FOB no se pueden leer como número, la regla se informa en `skipped` en lugar de pasar en silencio. |
@@ -121,6 +155,10 @@ node ../scripts/sync-shared.mjs dsh-origin-rvc-check
 
 El último comando copia el kit compartido de `../_shared` a `src/shared/`; vuelva a ejecutarlo tras cada cambio compartido.
 
+## PerryLink DSH Plugin Family
+
+Full family index: [choose a checker by material](https://perrylink.github.io/zh/checkers/choose/) and [all plugins](https://github.com/PerryLink). This repository is one of them.
+
 ## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-origin-rvc-check contributors.

package/README-hi.md

@@ -3,6 +3,7 @@
 [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
 
 [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-origin-rvc-check?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-origin-rvc-check?ref=badge)
 
 `dsh-origin-rvc-check` एक उद्गम-निर्धारण रजिस्टर (原产地判定台账) पढ़ता है — समझौते का हेडर और प्रत्येक सामग्री की एक पंक्ति — और उसी रजिस्टर के अपने अंकगणित की जाँच करता है: कि समझौता और उत्पाद घोषित हैं, कि क्षेत्रीय मूल्य-अंश (FOB − गैर-उद्गम सामग्री मूल्य) ÷ FOB × 100 के बराबर है, कि RVC आपकी निर्धारित सीमा तक पहुँचता है, कि प्रत्येक सामग्री अपना उद्गम बताती है, कि उद्गम मानदंड आपके समझौते की शब्दावली से आता है, कि सामग्री क्रमांक दोहराए नहीं गए हैं, और कि विवरण में कोई अप्रतिस्थापित प्लेसहोल्डर शेष नहीं है।
 
@@ -15,14 +16,47 @@ dsh --profile <name> --dump-config | grep 'dsh-origin-rvc-check'
 
 ## आउटपुट कैसा दिखता है
 
-![Terminal demo of dsh-origin-rvc-check: real output over its OR-001 fixture](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-hero.png)
+![dsh-origin-rvc-check कार्यप्रवाह आरेख: दस्तावेज़ → नियम → निष्कर्ष।](docs/assets/dsh-origin-rvc-check-flow.svg)
+
+*कार्यप्रवाह: दस्तावेज़ → नियम → निष्कर्ष। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
 
-![Animated terminal demo of dsh-origin-rvc-check](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-demo.gif)
 
 इस प्लगइन का अपने ही `OR-001` टेस्ट फ़िक्स्चर पर वास्तविक आउटपुट — कोई नकली चित्र नहीं। नियम-पैक उद्धरण नहीं गढ़ता, इसलिए हर निष्कर्ष लागू किए गए खंड का नाम और यह भी बताता है कि उसका मूल पाठ इस बार प्राप्त नहीं हुआ।
 
 ## यह किन सवालों का जवाब देता है
 
+### उदाहरण
+
+नीचे दी गई तालिका उदाहरण-समुच्चय है: पहली पंक्ति विस्तृत केस है, बाकी संक्षिप्त केस हैं।
+
+
+#### विस्तृत आउटपुट
+
+**उपकरण** `origin_rvc_check`
+
+**इनपुट**
+
+~~~json
+{"product":"某型电子元件","rows":[{"序号":"1","商品编号":"8541400000","品名":"某型电子元件","原产国":"日本","成交价格":"180","币制":"USD","非原产材料价值":"180","是否原产":"否","区域价值成分":"55.00","原产地标准":"RVC"}]}
+~~~
+ 
+**आउटपुट**
+
+~~~json
+{
+  "id": "dsh-origin-rvc-check.OR-001.811c9dc5",
+  "ruleId": "OR-001",
+  "severity": "warn",
+  "locator": {
+    "field": "agreement"
+  },
+  "found": "材料表头缺少 agreement",
+  "expected": "表头应提供 agreement、product"
+}
+~~~
+
+*स्रोत `dsh-origin-rvc-check/tests/fixtures/OR-001/OR-001-unsafe.json`*
+
 | आपका सवाल | इसका जवाब |
 |---|---|
 | «区域价值成分» कॉलम में `70.00` लिखा है, पर उस पंक्ति का «净价值» `220` है और हेडर का FOB `400` — क्या यह पकड़ में आता है? | हाँ। `OR-002` «净价值» कॉलम और FOB से कटौती-सूत्र (FOB − गैर-उद्गम सामग्री मूल्य) ÷ FOB × 100 दोबारा जोड़ता है, 0.5 अंक की सहनशीलता के साथ, और घोषित RVC मेल न खाने पर वह पंक्ति दर्ज करता है। यह केवल अंकगणित करता है और कटौती पद्धति मान लेता है: जोड़ाई पद्धति से भरा रजिस्टर भी दर्ज होगा, चाहे उसकी अपनी परिपाटी सही हो — इसलिए `expression` बदलें या नियम बंद करें। RVC, «净价值» या FOB में से कोई संख्या के रूप में न पढ़ा जाए तो यह नियम चुपचाप पास होने के बजाय `skipped` में बताता है। |
@@ -121,6 +155,10 @@ node ../scripts/sync-shared.mjs dsh-origin-rvc-check
 
 अंतिम कमांड `../_shared` का साझा किट `src/shared/` में कॉपी करता है; हर साझा बदलाव के बाद इसे दोबारा चलाएँ।
 
+## PerryLink DSH Plugin Family
+
+Full family index: [choose a checker by material](https://perrylink.github.io/zh/checkers/choose/) and [all plugins](https://github.com/PerryLink). This repository is one of them.
+
 ## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-origin-rvc-check contributors.

package/README-pt.md

@@ -3,6 +3,7 @@
 [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
 
 [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-origin-rvc-check?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-origin-rvc-check?ref=badge)
 
 `dsh-origin-rvc-check` lê um registo de determinação de origem (原产地判定台账) —o cabeçalho do acordo mais uma linha por material— e verifica a aritmética desse próprio registo: que o acordo e o produto sejam declarados, que o conteúdo de valor regional seja igual a (FOB − valor dos materiais não originários) ÷ FOB × 100, que o RVC atinja o limiar que configura, que cada material indique a sua origem, que o critério de origem venha do vocabulário do seu acordo, que os números de material não se repitam e que não reste nenhum marcador de modelo por substituir na descrição.
 
@@ -15,14 +16,47 @@ dsh --profile <name> --dump-config | grep 'dsh-origin-rvc-check'
 
 ## Como é a saída
 
-![Terminal demo of dsh-origin-rvc-check: real output over its OR-001 fixture](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-hero.png)
+![Diagrama de fluxo de dsh-origin-rvc-check: documento → regras → achados.](docs/assets/dsh-origin-rvc-check-flow.svg)
+
+*Visão geral do fluxo: documento → regras → achados. Os exemplos abaixo usam a superfície real de comandos.*
 
-![Animated terminal demo of dsh-origin-rvc-check](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-demo.gif)
 
 Saída real deste plugin sobre o seu próprio fixture de teste `OR-001` — não é uma simulação. O pacote de regras não inventa citações, por isso cada achado nomeia a cláusula aplicada e avisa que o seu texto não foi obtido.
 
 ## O que ele responde
 
+### Exemplos
+
+A tabela abaixo é o conjunto de exemplos: a primeira linha é o caso detalhado e as demais são casos curtos.
+
+
+#### Saída detalhada
+
+**Ferramenta** `origin_rvc_check`
+
+**Entrada**
+
+~~~json
+{"product":"某型电子元件","rows":[{"序号":"1","商品编号":"8541400000","品名":"某型电子元件","原产国":"日本","成交价格":"180","币制":"USD","非原产材料价值":"180","是否原产":"否","区域价值成分":"55.00","原产地标准":"RVC"}]}
+~~~
+ 
+**Saída**
+
+~~~json
+{
+  "id": "dsh-origin-rvc-check.OR-001.811c9dc5",
+  "ruleId": "OR-001",
+  "severity": "warn",
+  "locator": {
+    "field": "agreement"
+  },
+  "found": "材料表头缺少 agreement",
+  "expected": "表头应提供 agreement、product"
+}
+~~~
+
+*Observado em `dsh-origin-rvc-check/tests/fixtures/OR-001/OR-001-unsafe.json`*
+
 | Você pergunta | O que ele responde |
 |---|---|
 | A coluna «区域价值成分» diz `70.00`, mas o «净价值» da linha é `220` e o FOB do cabeçalho é `400`. Isso é detetado? | Sim. O `OR-002` recalcula a fórmula de dedução (FOB − valor dos materiais não originários) ÷ FOB × 100 a partir da coluna «净价值» e do FOB, com uma tolerância de 0,5 pontos, e assinala a linha quando o RVC declarado não coincide. Faz apenas a aritmética e assume o método de dedução: um registo calculado pelo método de acumulação é assinalado embora a sua convenção esteja correta, pelo que deve alterar `expression` ou desativar a regra. Se o RVC, o «净价值» ou o FOB não forem legíveis como número, a regra reporta-se em `skipped` em vez de passar em silêncio. |
@@ -121,6 +155,10 @@ node ../scripts/sync-shared.mjs dsh-origin-rvc-check
 
 O último comando copia o kit compartilhado de `../_shared` para `src/shared/`; execute-o novamente após cada alteração compartilhada.
 
+## PerryLink DSH Plugin Family
+
+Full family index: [choose a checker by material](https://perrylink.github.io/zh/checkers/choose/) and [all plugins](https://github.com/PerryLink). This repository is one of them.
+
 ## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-origin-rvc-check contributors.

package/README-zh.md

@@ -1,8 +1,27 @@
 # dsh-origin-rvc-check — 原产地区域价值成分核对
 
+### 快速试跑（1 分钟）
+
+```bash
+node samples/quickstart/run.mjs --check
+```
+
+样例在 `samples/quickstart/input/`，期望输出在 `samples/quickstart/expected/result.json`；截图见 `docs/assets/quickstart.png`。
+
+
 [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
 
+<!-- topblock:v1 -->
+> **这是什么**　原产地区域价值成分核对。输出一份「哪一行、哪一栏、差什么」的清单。
+> **给谁用**　原产地证申领、关务；不用懂命令行。
+> **你交什么**　这项核对用到的原始材料（表格、清单或文书）；不改原件。Excel 可先转成 JSON/YAML，对话里也能代转。
+> **它不做什么**　不判合规、不认定责任、不替代审核人；只列材料内部能逐条指认的差异。
+> **怎么开始**　在 WorkBuddy / 扣子搜「关务合规核对包」（本检查是其中一项；上架以商城为准）；或命令行：
+> `dsh plugin --profile <name> add dsh-origin-rvc-check`
+<!-- /topblock:v1 -->
+
 [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-origin-rvc-check?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-origin-rvc-check?ref=badge)
 
 `dsh-origin-rvc-check` 读取一份原产地判定台账——表头写明协定与产品，每种料件一行——核对这份台账自身的算术：协定与产品是否声明、区域价值成分是否等于 (FOB − 非原产材料价值) ÷ FOB × 100、RVC 是否达到你配置的门槛、每条料件是否填写原产国、原产地标准是否出自你所适用协定的口径、料件序号是否唯一、品名栏是否残留未替换的占位符。
 
@@ -15,14 +34,47 @@ dsh --profile <name> --dump-config | grep 'dsh-origin-rvc-check'
 
 ## 实际输出长什么样
 
-![Terminal demo of dsh-origin-rvc-check: real output over its OR-001 fixture](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-hero.png)
+![dsh-origin-rvc-check 工作流图：文档 → 规则包 → 核对结果。](docs/assets/dsh-origin-rvc-check-flow.svg)
+
+*工作流概览：文档 → 规则包 → 核对结果。下面的示例使用实际命令面。*
 
-![Animated terminal demo of dsh-origin-rvc-check](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-demo.gif)
 
 本插件对自己 `OR-001` 测试夹具的**真实输出**，不是示意图。规则库不伪造引文，因此每条发现都会同时写明所引条款，以及该条款原文本次未取得。
 
 ## 它回答什么问题
 
+### 示例
+
+下表是示例集：第一行是详细走查，其余行是简短案例。
+
+
+#### 详细输出
+
+**工具** `origin_rvc_check`
+
+**输入**
+
+~~~json
+{"product":"某型电子元件","rows":[{"序号":"1","商品编号":"8541400000","品名":"某型电子元件","原产国":"日本","成交价格":"180","币制":"USD","非原产材料价值":"180","是否原产":"否","区域价值成分":"55.00","原产地标准":"RVC"}]}
+~~~
+ 
+**输出**
+
+~~~json
+{
+  "id": "dsh-origin-rvc-check.OR-001.811c9dc5",
+  "ruleId": "OR-001",
+  "severity": "warn",
+  "locator": {
+    "field": "agreement"
+  },
+  "found": "材料表头缺少 agreement",
+  "expected": "表头应提供 agreement、product"
+}
+~~~
+
+*来源 `dsh-origin-rvc-check/tests/fixtures/OR-001/OR-001-unsafe.json`*
+
 | 你会问 | 它怎么答 |
 |---|---|
 | 「区域价值成分」栏填的是 `70.00`，但该行「净价值」是 `220`、表头 FOB 是 `400`，这种情况查得出来吗？ | 查得出来。`OR-002` 拿「净价值」栏与 FOB 按扣减法 (FOB − 非原产材料价值) ÷ FOB × 100 重算，容差 0.5 个百分点，填报值与之不符即逐行报出。它只做算术，而且按扣减法核对：台账若按累加法填写，即使口径本身正确也会被报出差异，此时请改 `expression` 或停用本条。RVC、净价值、FOB 有一项读不成数值时，本条报告「无法执行」，不会静默通过。 |
@@ -40,31 +92,17 @@ dsh --profile <name> --dump-config | grep 'dsh-origin-rvc-check'
 |---|---|---|
 | 各自由贸易协定原产地规则（协定文本，本次未取得） | 现行协定版本本次未核实 | OR-001, OR-002, OR-003, OR-004, OR-005, OR-006, OR-007 |
 
-**Boundary:** this plugin checks an **原产地判定台账** for arithmetic — that the agreement and product are
-declared, that regional value content equals (FOB − non-originating value) ÷ FOB × 100, that RVC meets the
-threshold you configure, that every material states its origin, that the origin criterion comes from your
-agreement's vocabulary, that material numbers are unique, and that no placeholder survives. It does **not**
-decide whether goods qualify as originating, whether a preferential rate applies, whether an origin declaration
-is valid, or whether origin circumvention occurred.
+**边界（中文译文，以英文原文为准）：** 本插件核对一份**原产地判定台账**的算术——是否声明协定与产品，区域价值成分是否等于（FOB − 非原产材料价值）÷ FOB × 100，RVC 是否达到你配置的门槛，每种材料是否写明其原产地，原产地标准是否取自你所适用协定的取值口径，材料编号是否唯一，以及是否残留占位符。它**不**判定货物是否具备原产资格、是否适用优惠税率、原产地声明是否有效，也不判定是否发生原产地规避。
 
-> ### ⚠️ Origin rules are treaty text, and this pack does not pretend to quote one
+> ### ⚠️ 原产地规则是条约文本，本规则库不假装引用其中任何一条（以英文原文为准）
 >
-> RVC and the other origin criteria — wholly obtained, change of tariff classification — are set by **each free
-> trade agreement's rules of origin**. RCEP, ASEAN–China, China–Korea and the rest differ in their thresholds
-> (40%, 30% and other tiers) and in their calculation methods. **The verification pass obtained no verbatim text
-> from any agreement**, so every rule's `basis` says exactly that and stays at `warn` or `info`.
+> RVC 以及其他原产地标准——完全获得、税则归类改变——由**各自由贸易协定自己的原产地规则**设定。RCEP、中国—东盟、中国—韩国等协定在阈值上（40%、30% 及其他档次）和计算方法上都各不相同。**核验环节没有从任何协定中取得逐字原文**，因此每条规则的 `basis` 都如实写明这一点，并停留在 `warn` 或 `info`。
 >
-> Three consequences are worth knowing before trusting a finding:
+> 在信任一项发现之前，有三点后果值得了解：
 >
-> - **`OR-002` assumes the build-down method** — RVC = (FOB − VNM) ÷ FOB × 100. Some agreements permit the
->   **build-up** method (regional value ÷ FOB × 100), which yields a different number for the same goods. A
->   register computed that way will report a difference; change `expression` or disable the rule. The check
->   reads FOB and the net value through a header fallback, so a figure stated once for the whole set is found.
-> - **`OR-003`'s threshold ships unset.** Thresholds vary by agreement *and* by tariff line, so the plugin
->   hard-codes none. A finding means "below the threshold you set", **not** "these goods are not originating" —
->   because origin can also be earned through wholly-obtained or tariff-classification-change criteria.
->   **RVC is only one path.** That distinction matters, and the rule's note states it.
-> - **`OR-005`'s criterion vocabulary ships empty**; criterion names and abbreviations differ per agreement.
+> - **`OR-002` 假定的是扣减法**——RVC = (FOB − VNM) ÷ FOB × 100。有些协定允许**累加法**（区域价值 ÷ FOB × 100），对同样的货物会得出不同的数值。按那种方法计算的台账会被报出差异；请修改 `expression` 或停用该规则。该项检查通过表头回退来读取 FOB 和净价值，因此整套数据只声明一次的数值也能被找到。
+> - **`OR-003` 的阈值出厂时未设定。** 阈值因协定*和*税则行而异，因此本插件不硬编码任何阈值。一项发现的意思是「低于你设定的阈值」，**而不是**「这些货物非原产」——因为原产地也可以通过完全获得或税则归类改变标准取得。**RVC 只是其中一条路径。** 这一区分很重要，该规则的说明也写明了它。
+> - **`OR-005` 的标准词表出厂为空**；标准名称和缩写因协定而异。
 
 ## Compatibility
 
@@ -121,6 +159,10 @@ node ../scripts/sync-shared.mjs dsh-origin-rvc-check
 
 第 4 项把 `../_shared` 的共享件同步进 `src/shared/`；每次改动共享件后都要重跑。
 
+## PerryLink DSH Plugin Family
+
+完整清单（62 个核查器 + 通用插件）见 [按材料选核查器](https://perrylink.github.io/zh/checkers/choose/)；本仓只是其中一个。
+
 ## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-origin-rvc-check contributors.

package/README.md

@@ -2,7 +2,17 @@
 
 [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
 
+<!-- topblock:v1 -->
+> **What it is** — Regional value content check for an origin determination register. It returns a list of what is inconsistent, where, and what to fix.
+> **Who it is for** — origin-certificate and customs staff; no command line required.
+> **What you give it** — the source material the check works on (a table, register or document); the original is never modified. Excel can be converted to JSON/YAML first, in chat if the platform supports it.
+> **What it does not do** — no compliance verdict, no liability finding, no replacement for the reviewer; differences only.
+> **How to start** — search "Customs Compliance Suite" in WorkBuddy / Coze (this check is one part of it; availability as listed); or:
+> `dsh plugin --profile <name> add dsh-origin-rvc-check`
+<!-- /topblock:v1 -->
+
 [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-origin-rvc-check?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-origin-rvc-check?ref=badge)
 
 `dsh-origin-rvc-check` reads one origin determination register (原产地判定台账) — the agreement header plus one row per material — and checks that register's own arithmetic: that the agreement and product are declared, that regional value content equals (FOB − non-originating value) ÷ FOB × 100, that RVC meets the threshold you configure, that every material states its origin, that the origin criterion comes from your agreement's vocabulary, that material numbers are unique, and that no unreplaced placeholder survives in the description.
 
@@ -15,14 +25,45 @@ dsh --profile <name> --dump-config | grep 'dsh-origin-rvc-check'
 
 ## What it looks like
 
-![Terminal demo of dsh-origin-rvc-check: real output over its OR-001 fixture](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-hero.png)
+![Workflow diagram for dsh-origin-rvc-check: document → rule pack → findings.](docs/assets/dsh-origin-rvc-check-flow.svg)
+
+*Workflow overview: document → rule pack → findings. The examples below use the real command surface.*
 
-![Animated terminal demo of dsh-origin-rvc-check](https://raw.githubusercontent.com/PerryLink/dsh-origin-rvc-check/main/docs/assets/dsh-origin-rvc-check-demo.gif)
 
-Real output from this plugin over its own `OR-001` test fixture — not a mock-up. The rule pack ships no invented quotations, so a finding names both the clause it applied and the fact that the clause text was not obtained.
 
 ## What it answers
 
+### Examples
+
+The table below is the example set: the first row is the detailed walkthrough, the remaining rows are short cases.
+
+#### Detailed output
+
+**Tool** `origin_rvc_check`
+
+**Input**
+
+~~~json
+{"product":"某型电子元件","rows":[{"序号":"1","商品编号":"8541400000","品名":"某型电子元件","原产国":"日本","成交价格":"180","币制":"USD","非原产材料价值":"180","是否原产":"否","区域价值成分":"55.00","原产地标准":"RVC"}]}
+~~~
+ 
+**Output**
+
+~~~json
+{
+  "id": "dsh-origin-rvc-check.OR-001.811c9dc5",
+  "ruleId": "OR-001",
+  "severity": "warn",
+  "locator": {
+    "field": "agreement"
+  },
+  "found": "材料表头缺少 agreement",
+  "expected": "表头应提供 agreement、product"
+}
+~~~
+
+*Observed from `dsh-origin-rvc-check/tests/fixtures/OR-001/OR-001-unsafe.json`*
+
 | You ask | What it answers |
 |---|---|
 | The 区域价值成分 column says `70.00`, but the row's 净价值 is `220` and the header's FOB is `400`. Is that caught? | Yes. `OR-002` recomputes the build-down formula (FOB − non-originating value) ÷ FOB × 100 from the 净价值 column and FOB, with a 0.5-point tolerance, and reports the row when the declared RVC differs. It does only the arithmetic, and it assumes the build-down method: a register filled in by the build-up method is reported although its own convention is right, so change `expression` or disable the rule. If the RVC, the 净价值 or the FOB cannot be read as a number, the rule reports itself in `skipped` instead of passing silently. |
@@ -169,6 +210,10 @@ node ../scripts/sync-shared.mjs dsh-origin-rvc-check   # refresh src/shared from
 The plugin is **data-only**: `src/model.ts` declares the table shape, the shared kit supplies the reader and
 the check engine, and the rule pack declares every check.
 
+## PerryLink DSH Plugin Family
+
+Full family index: [choose a checker by material](https://perrylink.github.io/zh/checkers/choose/) and [all plugins](https://github.com/PerryLink). This repository is one of them.
+
 ## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-origin-rvc-check contributors.

package/TROUBLESHOOTING.md

@@ -0,0 +1,34 @@
+# Troubleshooting `dsh-origin-rvc-check`
+
+## The package is not found or refuses to install
+
+- This checker targets DSH `>=0.2.1-0 <0.3.0` and Node `^22.19.0 || >=24.0.0`.
+- Install it through the profile closure: `dsh plugin --profile <name> add dsh-origin-rvc-check`.
+- If npm reports a peer conflict, check the host line first; do not force-install an older DSH core.
+
+## It installs, but I see no findings
+
+- The checker only reports what it can decide from the document you pass to its tool.
+- Confirm the tool ran and returned a result; an empty result is not the same as a skipped run.
+- Check the document's required columns/fields against the checker's README table. Missing input is usually reported as `skipped`, not as a guessed finding.
+
+## A finding says the clause text was not obtained
+
+- The rule pack follows a citation gate: it never invents clause text.
+- When the exact text is unavailable, the finding stays at `warn`/`info` and says so in its `excerpt`.
+- Treat that as a verification gap, not as proof that the document is compliant.
+
+## Everything is `warn` or `info`
+
+- By design, this checker does not make a legal, medical, customs, or safety determination.
+- It reports differences and gaps; a human owner decides what to do with them.
+
+## Reporting a bug
+
+Open an issue at `https://github.com/PerryLink/dsh-origin-rvc-check/issues` with:
+
+- the checker version and DSH host version;
+- the command or tool call you used;
+- a minimal, redacted input and the actual vs expected result.
+
+Never paste credentials, tokens, personal data, or sealed evidence bytes into an issue.

package/docs/assets/dsh-origin-rvc-check-flow.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="360" viewBox="0 0 1200 360" role="img" aria-label="dsh-origin-rvc-check workflow">
+<title>dsh-origin-rvc-check workflow</title>
+<rect width="1200" height="360" rx="18" fill="#0d1117"/>
+<text x="60" y="58" fill="#f0f6fc" font-family="ui-sans-serif,system-ui,sans-serif" font-size="30" font-weight="700">dsh-origin-rvc-check</text>
+<text x="60" y="92" fill="#8b949e" font-family="ui-monospace,monospace" font-size="16">DeepSeek Harness plugin</text>
+<line x1="60" y1="118" x2="1140" y2="118" stroke="#30363d"/>
+<rect x="120" y="150" width="240" height="140" rx="14" fill="#161b22" stroke="#2563eb" stroke-width="2"/>
+<rect x="213" y="185" width="54" height="66" rx="8" fill="none" stroke="#2563eb" stroke-width="3"/><path d="M226 205h28M226 217h28M226 229h18" stroke="#2563eb" stroke-width="3" stroke-linecap="round"/>
+<circle cx="330" cy="270" r="13" fill="#2563eb"/><text x="330" y="276" fill="#0d1117" text-anchor="middle" font-family="ui-monospace,monospace" font-size="14" font-weight="700">1</text>
+<path d="M368 220h64" stroke="#2563eb" stroke-width="3"/><path d="M422 213l10 7-10 7" fill="none" stroke="#2563eb" stroke-width="3" stroke-linecap="round"/>
+<rect x="480" y="150" width="240" height="140" rx="14" fill="#161b22" stroke="#2563eb" stroke-width="2"/>
+<path d="M577 203h46M577 219h46M577 235h46" stroke="#2563eb" stroke-width="3" stroke-linecap="round"/><circle cx="591" cy="203" r="6" fill="#2563eb"/><circle cx="611" cy="219" r="6" fill="#2563eb"/><circle cx="597" cy="235" r="6" fill="#2563eb"/>
+<circle cx="690" cy="270" r="13" fill="#2563eb"/><text x="690" y="276" fill="#0d1117" text-anchor="middle" font-family="ui-monospace,monospace" font-size="14" font-weight="700">2</text>
+<path d="M728 220h64" stroke="#2563eb" stroke-width="3"/><path d="M782 213l10 7-10 7" fill="none" stroke="#2563eb" stroke-width="3" stroke-linecap="round"/>
+<rect x="840" y="150" width="240" height="140" rx="14" fill="#161b22" stroke="#2563eb" stroke-width="2"/>
+<circle cx="960" cy="218" r="28" fill="none" stroke="#2563eb" stroke-width="3"/><path d="M947 219l9 9 18-20" fill="none" stroke="#2563eb" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+<circle cx="1050" cy="270" r="13" fill="#2563eb"/><text x="1050" y="276" fill="#0d1117" text-anchor="middle" font-family="ui-monospace,monospace" font-size="14" font-weight="700">3</text>
+<text x="60" y="332" fill="#8b949e" font-family="ui-monospace,monospace" font-size="14">PerryLink DSH plugin family · Apache-2.0</text>
+</svg>

package/docs/assets/quickstart.log

@@ -0,0 +1,3 @@
+$ node samples/quickstart/run.mjs
+origin_rvc_check: 1 issue(s) — error 0, warn 1, info 0
+skipped: 3

package/lib/index.d.mts

@@ -6,7 +6,7 @@ import { Context } from "@deepseek-ai/cordis";
  * `cordis.yml` without editing code (the family's "no hard-coded tunables"
  * redline). The rule pack itself is data as well and can be pointed elsewhere.
  */
-interface Config {
+export interface Config {
   /** Rule-pack path relative to the plugin package root. */
   rulesFile: string;
   /** Rule ids disabled for this deployment. */
@@ -18,13 +18,13 @@ interface Config {
   /** Tool timeout budget in milliseconds. */
   timeoutMs: number;
 }
-declare const Config: Schema<Config>;
+export declare const Config: Schema<Config>;
 //#endregion
 //#region src/index.d.ts
-declare const name = "dsh-origin-rvc-check";
-declare const inject: string[];
+export declare const name = "dsh-origin-rvc-check";
+export declare const inject: string[];
 /** Tool id exposed to the model, and the row id in `cordis.patch.yml`. */
-declare const TOOL_NAME = "origin_rvc_check";
+export declare const TOOL_NAME = "origin_rvc_check";
 /**
  * Locate a package-owned file such as the rule pack.
  *
@@ -36,7 +36,7 @@ declare const TOOL_NAME = "origin_rvc_check";
  * @returns the resolved absolute path.
  * @throws Error naming every location tried, when the file is absent.
  */
-declare function resolvePackageFile(relative: string): string;
+export declare function resolvePackageFile(relative: string): string;
 /**
  * Register the checker tool.
  *
@@ -47,6 +47,5 @@ declare function resolvePackageFile(relative: string): string;
  * @param ctx - plugin context, with `tools` already available.
  * @param config - validated configuration.
  */
-declare function apply(ctx: Context, config: Config): () => void;
-//#endregion
-export { Config, TOOL_NAME, apply, inject, name, resolvePackageFile };
+export declare function apply(ctx: Context, config: Config): () => void;
+//#endregion

package/lib/index.mjs

@@ -365,6 +365,10 @@ var Reader = class {
 			if (!isSequenceItem(line.text)) break;
 			this.index += 1;
 			const rest = line.text === "-" ? "" : line.text.slice(2).trim();
+			if (rest.startsWith("{") || rest.startsWith("[")) {
+				items.push(parseScalar(rest, line.num));
+				continue;
+			}
 			if ((rest === "" ? -1 : findKeySeparator(rest)) >= 0) {
 				items.push(this.readMapping(indent + 2, {
 					text: rest,
@@ -833,7 +837,7 @@ function optionalNumber(params, key) {
 function locatorOf(row, field) {
 	const out = {};
 	if (row !== void 0) out.row = row;
-	if (field !== "") out.field = field;
+	if (field !== "") out.column = field;
 	return out;
 }
 /**
@@ -1164,7 +1168,7 @@ function sumToConstant(ctx) {
 	const total = parsed.reduce((sum, value) => sum + value, 0);
 	const gap = Math.abs(total - target);
 	if (gap <= tolerance) return;
-	ctx.add(locatorOf(void 0, field), `${parsed.length} 行的「${field}」合计 ${Number(total.toFixed(4))}，与配置的目标值 ${target} 相差 ${Number(gap.toFixed(4))}`, `「${field}」的合计应为 ${target}，允许偏差 ${tolerance}`, str(ctx.params, "fix", "核对是否有行遗漏或数值抄错；本条只做加法核对，不判断设置是否合规"));
+	ctx.add(locatorOf(void 0, field), `${parsed.length} 行的「${field}」合计 ${Number(total.toFixed(4))}，与配置的目标值 ${target} 相差 ${Number(gap.toFixed(4))}`, `「${field}」的合计应为 ${target}，允许偏差 ${tolerance}`, str(ctx.params, "fix", "核对是否有行遗漏或数值抄错；本条只做加法核对，不评价分值设置本身"));
 }
 /** `countPerGroup` — each group value must appear at least N times. */
 function countPerGroup(ctx) {
@@ -2112,7 +2116,10 @@ function runChecks(input, ruleset, options) {
 	const issues = [];
 	const reasons = /* @__PURE__ */ new Map();
 	const fired = /* @__PURE__ */ new Set();
+	const disabled = /* @__PURE__ */ new Set([...ruleset.disabled, ...options.disabledRules]);
+	const only = new Set(options.onlyRules);
 	for (const rule of ruleset.rules) {
+		if (disabled.has(rule.id) || only.size > 0 && !only.has(rule.id)) continue;
 		const declaredCheck = typeof rule.params.check === "object" && rule.params.check !== null && !Array.isArray(rule.params.check) ? rule.params.check : {};
 		const check = {
 			...rule.params,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-origin-rvc-check",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "原产地区域价值成分核对（按 RVC 定义式与门槛核对原产地判定自洽，仅提示差异，不作出定性结论）",
   "type": "module",
   "main": "lib/index.mjs",
@@ -25,7 +25,11 @@
     "icon.svg",
     "rules",
     "CHANGELOG.md",
-    "SECURITY.md"
+    "SECURITY.md",
+    "docs/assets/*",
+    "samples",
+    "TROUBLESHOOTING.md",
+    "screenshots.json"
   ],
   "scripts": {
     "build": "tsdown",
@@ -42,7 +46,23 @@
     "manifestVersion": 1,
     "bundle": {
       "patch": "./cordis.patch.yml"
-    }
+    },
+    "demo": {
+      "sample": "samples/quickstart/input/OR-001-unsafe.json",
+      "prompt": "用自带样例跑一次这项检查，告诉我发现了几条问题、分别是什么级别。",
+      "expect": "samples/quickstart/expected/result.json",
+      "screenshot": "docs/assets/quickstart.png",
+      "reads": [
+        "用户指定的材料文件"
+      ],
+      "writes": [],
+      "network": false,
+      "external": []
+    },
+    "capabilities": [
+      "tools:register"
+    ],
+    "labels": []
   },
   "keywords": [
     "deepseek-harness",
@@ -78,14 +98,14 @@
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.5-alpha.1",
+    "@deepseek-ai/cordis": "4.0.5",
     "@deepseek-ai/dsh-package-manifest": "0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
-    "@deepseek-ai/schemastery": "3.18.5-alpha.1",
+    "@deepseek-ai/schemastery": "3.18.5",
     "@types/node": "^22.20.1",
     "vitest": "^3.2.7",
     "@deepseek-ai/dsh-working-directory": "0.2.1-rc.2",
-    "tsdown": "^0.22.14",
+    "tsdown": "^0.23.1",
     "typescript": "^5.9.3"
   },
   "dependencies": {}

package/samples/quickstart/expected/result.json

@@ -0,0 +1,10 @@
+{
+  "tool": "origin_rvc_check",
+  "issueCount": 1,
+  "summary": {
+    "error": 0,
+    "warn": 1,
+    "info": 0
+  },
+  "skippedCount": 3
+}

package/samples/quickstart/input/OR-001-unsafe.json

@@ -0,0 +1,20 @@
+{
+  "product": "某型电子元件",
+  "rows": [
+    {
+      "序号": "1",
+      "商品编号": "8541400000",
+      "品名": "某型电子元件",
+      "原产国": "日本",
+      "供应商": "某某商社",
+      "成交价格": "180",
+      "币制": "USD",
+      "非原产材料价值": "180",
+      "是否原产": "否",
+      "区域价值成分": "55.00",
+      "原产地标准": "RVC",
+      "原产地证书号": "",
+      "申报日期": "2026-03-10"
+    }
+  ]
+}

package/samples/quickstart/run.mjs

@@ -0,0 +1,27 @@
+import { readFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import * as plugin from '../../lib/index.mjs'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const material = await readFile(join(here, 'input', "OR-001-unsafe.json"), 'utf8')
+
+const registered = []
+const ctx = { tools: { register: (tool) => { registered.push(tool); return () => {} } } }
+plugin.apply(ctx, plugin.Config ? plugin.Config({}) : {})
+const tool = registered.find((t) => t.name === plugin.TOOL_NAME)
+if (!tool) throw new Error('tool not registered: ' + plugin.TOOL_NAME)
+
+const result = await tool.execute({ material }, { signal: new AbortController().signal })
+const summary = {
+  tool: tool.name,
+  issueCount: result.issueCount,
+  summary: result.summary,
+  skippedCount: result.skippedCount,
+}
+if (process.argv.includes('--json')) console.log(JSON.stringify(summary, null, 2))
+else {
+  console.log('$ node samples/quickstart/run.mjs')
+  console.log(tool.name + ': ' + summary.issueCount + ' issue(s) — error ' + summary.summary.error + ', warn ' + summary.summary.warn + ', info ' + summary.summary.info)
+  console.log('skipped: ' + summary.skippedCount)
+}

package/screenshots.json

@@ -0,0 +1,14 @@
+[
+  {
+    "path": "docs/assets/dsh-origin-rvc-check-hero.png",
+    "kind": "hero",
+    "alt": "dsh-origin-rvc-check terminal output",
+    "caption": "Real dsh-origin-rvc-check checker output; 31 tests passed."
+  },
+  {
+    "path": "docs/assets/dsh-origin-rvc-check-demo.gif",
+    "kind": "demo",
+    "alt": "Animated dsh-origin-rvc-check terminal session",
+    "caption": "The same run, assembled line by line."
+  }
+]