dsh-medrec-qc 0.2.11 → 0.2.13

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

@@ -8,6 +8,7 @@ dsh plugin --profile <name> add dsh-medrec-qc
 
 
 [![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-medrec-qc?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-medrec-qc?ref=badge)
 
 `dsh-medrec-qc` lee una exportación de la portada del historial clínico de hospitalización (病案首页), una fila por alta, con el juego de columnas de la exportación de evaluación nacional, de la estadística sanitaria o de una exportación local del hospital, y comprueba la completitud formal, la aritmética interna y la forma de codificación de esa misma exportación: que cada columna obligatoria tenga contenido o el marcador `-`, que las horas de ingreso y de alta estén presentes, sean precisas al minuto y no estén invertidas, que la estancia declarada coincida con las dos fechas, que el nombre y el código del diagnóstico principal y los de la operación principal se rellenen juntos, que los códigos tengan la forma escrita que configura el paquete de reglas, que las tres columnas de firma reflejen la responsabilidad médica de tres niveles, que el modo de alta sea uno de los códigos definidos, que la edad y los pesos neonatales usen las formas prescritas, que el número de otros diagnósticos no supere el techo configurado, y que se señalen para revisión humana un diagnóstico incompatible con el sexo registrado o dos horas discordantes en un alta por fallecimiento.
 
@@ -20,14 +21,52 @@ dsh --profile <name> --dump-config | grep 'dsh-medrec-qc'
 
 ## Cómo se ve la salida
 
-![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-hero.png)
+![Diagrama de flujo de dsh-medrec-qc: llamada → plugin → resultado.](docs/assets/dsh-medrec-qc-flow.svg)
+
+*Resumen del flujo: llamada → plugin → resultado. Los ejemplos siguientes usan la superficie de comandos real.*
 
-![Animated terminal demo of dsh-medrec-qc](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.gif)
 
 Salida real de este plugin sobre su propio fixture de prueba `MR-009` — 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** `medrec_qc`
+
+**Entrada**
+
+~~~yaml
+target: 2026 年 3 月出院病案首页导出
+cases:
+  - row: 1
+    病案号: ""
+    入院时间: "2026-03-01 08:30"
+    出院时间: "2026-03-06 10:00"
+~~~
+ 
+**Salida**
+
+~~~json
+{
+  "id": "dsh-medrec-qc.MR-001.a58905f0",
+  "ruleId": "MR-001",
+  "severity": "error",
+  "locator": {
+    "row": 1,
+    "column": "病案号"
+  },
+  "found": "「病案号」为空",
+  "expected": "附件1 必填栏不能为空项，没有可填写内容时填写\"-\""
+}
+~~~
+
+*Observado en `dsh-medrec-qc/tests/fixtures/MR-001/MR-001-unsafe.yaml`*
+
 | Usted pregunta | Qué responde |
 |---|---|
 | Una columna obligatoria está vacía, pero escribí `-` en ella. ¿Se informa de eso? | No. `MR-001` considera un `-` aislado la marca de «no hay nada que registrar» e informa solo de las columnas realmente vacías. Comprueba que la columna obligatoria tenga contenido, no que el contenido sea correcto. Es un `error`: la nota al pie del anexo 1 del documento 24号文 se leyó literalmente el **2026-10-13** (el anexo **tiene capa de texto**: 328 páginas, 205 847 caracteres extraíbles, **sin OCR**), y dice 「注：必填栏不能为空项，没有可填写内容时填写“-”」. ⚠️ `www.nhc.gov.cn` devuelve **HTTP 412** a las peticiones automáticas, así que el texto se leyó de una **recopilación del Centro de Control de Calidad de Historias Clínicas de Henan** — la misma URL que el `source` de esta regla siempre ha llevado; véase `rules/evidence/clause-verification-homepage-attachment1.md`. Ese mismo `-` sigue contando como firma ausente en `MR-009`. |
@@ -108,6 +147,10 @@ node ../scripts/sync-shared.mjs dsh-medrec-qc
 
 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-medrec-qc contributors.

package/README-hi.md

@@ -8,6 +8,7 @@ dsh plugin --profile <name> add dsh-medrec-qc
 
 
 [![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-medrec-qc?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-medrec-qc?ref=badge)
 
 `dsh-medrec-qc` भर्ती रोगी के मेडिकल रिकॉर्ड की फ्रंट शीट (病案首页) के एक्सपोर्ट को पढ़ता है, जिसमें प्रत्येक डिस्चार्ज की एक पंक्ति होती है और कॉलम-सेट राष्ट्रीय मूल्यांकन एक्सपोर्ट, स्वास्थ्य सांख्यिकी एक्सपोर्ट या अस्पताल के स्थानीय एक्सपोर्ट का हो सकता है, और उसी एक्सपोर्ट की रूप-पूर्णता, आंतरिक अंकगणित तथा कोडन-रूप की जाँच करता है: हर अनिवार्य कॉलम में सामग्री या `-` चिह्न हो, भर्ती और डिस्चार्ज का समय दर्ज हो, मिनट तक सटीक हो और उलटा न हो, दर्ज ठहराव-अवधि दोनों तारीख़ों से मेल खाए, मुख्य निदान का नाम और कोड तथा मुख्य ऑपरेशन का नाम और कोड साथ-साथ भरे गए हों, कोड उस लिखित रूप में हों जो नियम-पैक कॉन्फ़िगर करता है, तीन हस्ताक्षर कॉलम त्रि-स्तरीय चिकित्सक उत्तरदायित्व दर्शाते हों, डिस्चार्ज मोड निर्धारित कोड में से हो, आयु और नवजात का वज़न निर्धारित रूपों में हों, अन्य निदानों की संख्या कॉन्फ़िगर की गई सीमा के भीतर हो, और दर्ज लिंग से असंगत निदान अथवा मृत्यु-डिस्चार्ज में परस्पर भिन्न दो समय मानवीय समीक्षा के लिए सामने लाए जाएँ।
 
@@ -20,14 +21,52 @@ dsh --profile <name> --dump-config | grep 'dsh-medrec-qc'
 
 ## आउटपुट कैसा दिखता है
 
-![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-hero.png)
+![dsh-medrec-qc कार्यप्रवाह आरेख: कॉल → प्लगइन → परिणाम।](docs/assets/dsh-medrec-qc-flow.svg)
+
+*कार्यप्रवाह: कॉल → प्लगइन → परिणाम। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
 
-![Animated terminal demo of dsh-medrec-qc](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.gif)
 
 इस प्लगइन का अपने ही `MR-009` टेस्ट फ़िक्स्चर पर वास्तविक आउटपुट — कोई नकली चित्र नहीं। नियम-पैक उद्धरण नहीं गढ़ता, इसलिए हर निष्कर्ष लागू किए गए खंड का नाम और यह भी बताता है कि उसका मूल पाठ इस बार प्राप्त नहीं हुआ।
 
 ## यह किन सवालों का जवाब देता है
 
+### उदाहरण
+
+नीचे दी गई तालिका उदाहरण-समुच्चय है: पहली पंक्ति विस्तृत केस है, बाकी संक्षिप्त केस हैं।
+
+#### विस्तृत आउटपुट
+
+**उपकरण** `medrec_qc`
+
+**इनपुट**
+
+~~~yaml
+target: 2026 年 3 月出院病案首页导出
+cases:
+  - row: 1
+    病案号: ""
+    入院时间: "2026-03-01 08:30"
+    出院时间: "2026-03-06 10:00"
+~~~
+ 
+**आउटपुट**
+
+~~~json
+{
+  "id": "dsh-medrec-qc.MR-001.a58905f0",
+  "ruleId": "MR-001",
+  "severity": "error",
+  "locator": {
+    "row": 1,
+    "column": "病案号"
+  },
+  "found": "「病案号」为空",
+  "expected": "附件1 必填栏不能为空项，没有可填写内容时填写\"-\""
+}
+~~~
+
+*स्रोत `dsh-medrec-qc/tests/fixtures/MR-001/MR-001-unsafe.yaml`*
+
 | आपका सवाल | इसका जवाब |
 |---|---|
 | कोई अनिवार्य कॉलम खाली छूटा है, पर मैंने उसमें `-` लिखा है। क्या यह दर्ज होगा? | नहीं। `MR-001` अकेले `-` को «यहाँ दर्ज करने योग्य कुछ नहीं» का चिह्न मानता है और केवल सचमुच खाली छूटे कॉलम दर्ज करता है। यह देखता है कि अनिवार्य कॉलम में सामग्री है, यह नहीं कि सामग्री सही है। यह `error` है: 24号文 के अनुलग्नक 1 की अंतिम टिप्पणी **2026-10-13** को शब्दशः प्राप्त हुई (अनुलग्नक में **पाठ-परत है**: 328 पृष्ठ, 205,847 वर्ण निकाले जा सकते हैं, **OCR का प्रयोग नहीं**), और वह है 「注：必填栏不能为空项，没有可填写内容时填写“-”」。⚠️ `www.nhc.gov.cn` स्वचालित अनुरोधों पर **HTTP 412** लौटाता है, इसलिए पाठ **हेनान प्रांतीय मेडिकल रिकॉर्ड गुणवत्ता नियंत्रण केंद्र** के संकलन से पढ़ा गया — वही URL जो इस नियम के `source` में पहले से है; देखें `rules/evidence/clause-verification-homepage-attachment1.md`। वही `-` `MR-009` में हस्ताक्षर अनुपस्थित ही गिना जाता है। |
@@ -108,6 +147,10 @@ node ../scripts/sync-shared.mjs dsh-medrec-qc
 
 अंतिम कमांड `../_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-medrec-qc contributors.

package/README-pt.md

@@ -8,6 +8,7 @@ dsh plugin --profile <name> add dsh-medrec-qc
 
 
 [![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-medrec-qc?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-medrec-qc?ref=badge)
 
 `dsh-medrec-qc` lê uma exportação da folha de rosto do registo clínico de internamento (病案首页), uma linha por alta, com o conjunto de colunas da exportação de avaliação nacional, da estatística sanitária ou de uma exportação local do hospital, e verifica a completude formal, a aritmética interna e a forma de codificação dessa mesma exportação: que cada coluna obrigatória tenha conteúdo ou o marcador `-`, que as horas de admissão e de alta estejam preenchidas, sejam precisas ao minuto e não estejam invertidas, que o tempo de internamento declarado coincida com as duas datas, que o nome e o código do diagnóstico principal e os da operação principal sejam preenchidos em conjunto, que os códigos tenham a forma escrita que o pacote de regras configura, que as três colunas de assinatura reflitam a responsabilidade médica de três níveis, que o modo de alta seja um dos códigos definidos, que a idade e os pesos neonatais usem as formas prescritas, que o número de outros diagnósticos não exceda o limite configurado, e que sejam assinalados para revisão humana um diagnóstico incompatível com o sexo registado ou duas horas discordantes numa alta por óbito.
 
@@ -20,14 +21,52 @@ dsh --profile <name> --dump-config | grep 'dsh-medrec-qc'
 
 ## Como é a saída
 
-![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-hero.png)
+![Diagrama de fluxo de dsh-medrec-qc: chamada → plugin → resultado.](docs/assets/dsh-medrec-qc-flow.svg)
+
+*Visão geral do fluxo: chamada → plugin → resultado. Os exemplos abaixo usam a superfície real de comandos.*
 
-![Animated terminal demo of dsh-medrec-qc](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.gif)
 
 Saída real deste plugin sobre o seu próprio fixture de teste `MR-009` — 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** `medrec_qc`
+
+**Entrada**
+
+~~~yaml
+target: 2026 年 3 月出院病案首页导出
+cases:
+  - row: 1
+    病案号: ""
+    入院时间: "2026-03-01 08:30"
+    出院时间: "2026-03-06 10:00"
+~~~
+ 
+**Saída**
+
+~~~json
+{
+  "id": "dsh-medrec-qc.MR-001.a58905f0",
+  "ruleId": "MR-001",
+  "severity": "error",
+  "locator": {
+    "row": 1,
+    "column": "病案号"
+  },
+  "found": "「病案号」为空",
+  "expected": "附件1 必填栏不能为空项，没有可填写内容时填写\"-\""
+}
+~~~
+
+*Observado em `dsh-medrec-qc/tests/fixtures/MR-001/MR-001-unsafe.yaml`*
+
 | Você pergunta | O que ele responde |
 |---|---|
 | Uma coluna obrigatória ficou vazia, mas escrevi `-` nela. Isso é reportado? | Não. `MR-001` considera um `-` isolado a marca de «não há nada a registar» e reporta apenas as colunas realmente vazias. Verifica que a coluna obrigatória tem conteúdo, não que o conteúdo está correto. É um `error`: a nota de rodapé do anexo 1 do documento 24号文 foi lida literalmente em **2026-10-13** (o anexo **tem camada de texto**: 328 páginas, 205 847 caracteres extraíveis, **sem OCR**), e diz 「注：必填栏不能为空项，没有可填写内容时填写“-”」. ⚠️ `www.nhc.gov.cn` devolve **HTTP 412** a pedidos automáticos, pelo que o texto foi lido de uma **compilação do Centro de Controlo de Qualidade de Processos Clínicos de Henan** — o próprio URL que o `source` desta regra sempre indicou; ver `rules/evidence/clause-verification-homepage-attachment1.md`. Esse mesmo `-` continua a contar como assinatura em falta em `MR-009`. |
@@ -108,6 +147,10 @@ node ../scripts/sync-shared.mjs dsh-medrec-qc
 
 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-medrec-qc contributors.

package/README-zh.md

@@ -1,8 +1,27 @@
 # dsh-medrec-qc — 病案首页形式质控与逻辑矛盾提示
 
+### 快速试跑（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-medrec-qc`
+<!-- /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-medrec-qc?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-medrec-qc?ref=badge)
 
 `dsh-medrec-qc` 读取一份住院病案首页导出表，每行一例出院病例，列名可以是国家绩效考核导出、卫生统计导出或医院本地导出的写法，核对这份材料自身的形式齐备、内部算术与编码形式：必填栏目是否有内容或按规范填写 `-`、入院时间与出院时间是否填写且精确到分钟且前后不倒置、填写的实际住院天数是否与两个日期一致、主要诊断的名称与编码以及主要手术的名称与编码是否同时填写、编码是否符合规则库配置的书写形式、三级医师签名栏是否齐全、离院方式是否为规定代码、年龄与新生儿体重是否使用规定形式、其他诊断条数是否在配置上限内，以及诊断与性别不相容、死亡病例两条时间不一致等需人工核实的情形是否被列出。
 
@@ -15,14 +34,52 @@ dsh --profile <name> --dump-config | grep 'dsh-medrec-qc'
 
 ## 实际输出长什么样
 
-![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-hero.png)
+![dsh-medrec-qc 工作流图：调用 → 插件 → 结果。](docs/assets/dsh-medrec-qc-flow.svg)
+
+*工作流概览：调用 → 插件 → 结果。下面的示例使用实际命令面。*
 
-![Animated terminal demo of dsh-medrec-qc](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.gif)
 
 本插件对自己 `MR-009` 测试夹具的**真实输出**，不是示意图。规则库不伪造引文，因此每条发现都会同时写明所引条款，以及该条款原文本次未取得。
 
 ## 它回答什么问题
 
+### 示例
+
+下表是示例集：第一行是详细走查，其余行是简短案例。
+
+#### 详细输出
+
+**工具** `medrec_qc`
+
+**输入**
+
+~~~yaml
+target: 2026 年 3 月出院病案首页导出
+cases:
+  - row: 1
+    病案号: ""
+    入院时间: "2026-03-01 08:30"
+    出院时间: "2026-03-06 10:00"
+~~~
+ 
+**输出**
+
+~~~json
+{
+  "id": "dsh-medrec-qc.MR-001.a58905f0",
+  "ruleId": "MR-001",
+  "severity": "error",
+  "locator": {
+    "row": 1,
+    "column": "病案号"
+  },
+  "found": "「病案号」为空",
+  "expected": "附件1 必填栏不能为空项，没有可填写内容时填写\"-\""
+}
+~~~
+
+*来源 `dsh-medrec-qc/tests/fixtures/MR-001/MR-001-unsafe.yaml`*
+
 | 你会问 | 它怎么答 |
 |---|---|
 | 某个必填栏目是空的，但我填了 `-`，会被报出来吗？ | 不会。`MR-001` 把单独一个 `-` 视为「没有可填写内容」的标注，只报真正留空的栏目。它核对的是必填栏目有没有内容，不判断内容填得对不对。本条为 `error`：24 号文附件1 的表末注释已于 **2026-10-13 逐字取得**（该附件**有文字层**，328 页、205,847 字符可提取，**未使用 OCR**），原文为「注：必填栏不能为空项，没有可填写内容时填写“-”」。⚠️ 发布机关 `www.nhc.gov.cn` 对自动访问返回 **HTTP 412**，本次采用的是**河南省病案质量控制中心的汇编件**——即本条 `source` 一直指向的那份文件；详见 `rules/evidence/clause-verification-homepage-attachment1.md`。同一个 `-` 在 `MR-009` 里仍然算签名缺失。 |
@@ -41,12 +98,7 @@ dsh --profile <name> --dump-config | grep 'dsh-medrec-qc'
 | 《卫生部关于修订住院病案首页的通知》 | 卫医政发〔2011〕84号 | MR-004, MR-009, MR-010, MR-011, MR-012 |
 | 国家医疗保障局"两库"知识点（诊断与患者性别不符） | 国家医疗保障局公告（第二十一批） | MR-014 |
 
-**Boundary:** this plugin checks the **front sheet of the inpatient medical record (病案首页)** — the
-one-page discharge summary coders and the national assessment system read — for form completeness,
-internal contradictions and coding form. It is not `dsh-nurse-record-check` (which checks nursing
-documentation timeliness), not `dsh-icd-rule-check` (which checks ICD coding rules and dagger/asterisk
-pairing), and it does not judge whether a diagnosis was clinically correct. It reads an export of the
-front sheet and reports literal mismatches against cited clauses.
+**边界（中文译文，以英文原文为准）：** 本插件核对**住院病案首页**——编码员与国家考核体系所阅读的那一页出院摘要——的表格完整性、内部矛盾与编码形态。它不是 `dsh-nurse-record-check`（后者核对护理文书的及时性），不是 `dsh-icd-rule-check`（后者核对 ICD 编码规则与剑号/星号配对），也不判定诊断在临床上是否正确。它读取病案首页的导出数据，并报出与所引条款之间的字面不符。
 
 ## Compatibility
 
@@ -103,6 +155,10 @@ node ../scripts/sync-shared.mjs dsh-medrec-qc
 
 第 4 项把 `../_shared` 的共享件同步进 `src/shared/`；每次改动共享件后都要重跑。
 
+## PerryLink DSH Plugin Family
+
+完整清单（62 个核查器 + 通用插件）见 [按材料选核查器](https://perrylink.github.io/zh/checkers/choose/)；本仓只是其中一个。
+
 ## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-medrec-qc contributors.

package/README.md

@@ -2,12 +2,17 @@
 
 [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
 
-```sh
-dsh plugin --profile <name> add dsh-medrec-qc
-```
-
+<!-- topblock:v1 -->
+> **What it is** — Form check and logic-contradiction prompts for the inpatient medical record front sheet. It returns a list of what is inconsistent, where, and what to fix.
+> **Who it is for** — medical records and quality control; 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 "Medical Record QC Suite" in WorkBuddy / Coze (this check is one part of it; availability as listed); or:
+> `dsh plugin --profile <name> add dsh-medrec-qc`
+<!-- /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-medrec-qc?metric=downloads)](https://dshfind.com/en/plugins/PerryLink/dsh-medrec-qc?ref=badge)
 
 `dsh-medrec-qc` reads an export of the inpatient medical record front sheet (病案首页), one row per discharge, in the column set of the national assessment export, the health statistics export or a hospital-local export, and checks that export's own form completeness, internal arithmetic and coding form: that each required column carries content or the `-` marker, that the admission and discharge times are present, precise to the minute and not in the wrong order, that the declared length of stay agrees with the two dates, that the primary diagnosis name and code and the primary operation name and code are filled together, that the codes have the written form the pack configures, that the three signature columns reflect three-level physician responsibility, that the discharge mode is one of the defined codes, that the age and the neonatal weights use the prescribed forms, that the count of other diagnoses stays within the configured ceiling, and that a diagnosis incompatible with the recorded sex or two disagreeing times in a death discharge are surfaced for human review.
 
@@ -20,14 +25,51 @@ dsh --profile <name> --dump-config | grep 'dsh-medrec-qc'
 
 ## What it looks like
 
-![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-hero.png)
+![Workflow diagram for dsh-medrec-qc: call → plugin → result.](docs/assets/dsh-medrec-qc-flow.svg)
+
+*Workflow overview: call → plugin → result. The examples below use the real command surface.*
 
-![Animated terminal demo of dsh-medrec-qc](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.gif)
 
-Real output from this plugin over its own `MR-009` 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** `medrec_qc`
+
+**Input**
+
+~~~yaml
+target: 2026 年 3 月出院病案首页导出
+cases:
+  - row: 1
+    病案号: ""
+    入院时间: "2026-03-01 08:30"
+    出院时间: "2026-03-06 10:00"
+~~~
+ 
+**Output**
+
+~~~json
+{
+  "id": "dsh-medrec-qc.MR-001.a58905f0",
+  "ruleId": "MR-001",
+  "severity": "error",
+  "locator": {
+    "row": 1,
+    "column": "病案号"
+  },
+  "found": "「病案号」为空",
+  "expected": "附件1 必填栏不能为空项，没有可填写内容时填写\"-\""
+}
+~~~
+
+*Observed from `dsh-medrec-qc/tests/fixtures/MR-001/MR-001-unsafe.yaml`*
+
 | You ask | What it answers |
 |---|---|
 | A required column is left empty, but I typed `-` in it. Is that reported? | No. `MR-001` treats a lone `-` as the marker for 'nothing to record here' and reports only the columns that are truly blank. It checks that a required column carries content, not that the content is correct. It is an `error` because 附件1's note now **has** been read verbatim (2026-10-13) — see the note below. The same `-` still counts as a missing signature under `MR-009`. |
@@ -230,6 +272,10 @@ pnpm run build       # tsdown -> lib/index.mjs + lib/index.d.mts
 node ../scripts/sync-shared.mjs dsh-medrec-qc   # refresh src/shared from ../_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-medrec-qc contributors.

package/TROUBLESHOOTING.md

@@ -0,0 +1,34 @@
+# Troubleshooting `dsh-medrec-qc`
+
+## 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-medrec-qc`.
+- 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-medrec-qc/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-medrec-qc-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-medrec-qc workflow">
+<title>dsh-medrec-qc 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-medrec-qc</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
+medrec_qc: 1 issue(s) — error 1, warn 0, info 0
+skipped: 14

package/lib/index.d.mts

@@ -1,12 +1,11 @@
 import Schema from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
-//#region src/config.d.ts
 /**
  * Every tunable lives here so an operator can change behaviour from
  * `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 +17,11 @@ interface Config {
   /** Tool timeout budget in milliseconds. */
   timeoutMs: number;
 }
-declare const Config: Schema<Config>;
-//#endregion
-//#region src/index.d.ts
-declare const name = "dsh-medrec-qc";
-declare const inject: string[];
+export declare const Config: Schema<Config>;
+export declare const name = "dsh-medrec-qc";
+export declare const inject: string[];
 /** Tool id exposed to the model, and the row id in `cordis.patch.yml`. */
-declare const TOOL_NAME = "medrec_qc";
+export declare const TOOL_NAME = "medrec_qc";
 /**
  * Locate a package-owned file such as the rule pack.
  *
@@ -36,7 +33,7 @@ declare const TOOL_NAME = "medrec_qc";
  * @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 +44,4 @@ 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;

package/lib/index.mjs

@@ -3,7 +3,7 @@ import { existsSync } from "node:fs";
 import { dirname, isAbsolute, resolve } from "node:path";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
-//#region src/config.ts
+// src/config.ts
 const Config = Schema.object({
 	rulesFile: Schema.string().default("rules/medrec-qc.yaml").description("规则库文件路径（相对插件包根目录）。替换该文件即可切换规则集版本。"),
 	disabledRules: Schema.array(Schema.string()).default([]).description("要停用的规则 id 列表；停用的规则会出现在报告的 skipped 中。"),
@@ -11,8 +11,7 @@ const Config = Schema.object({
 	skipNotes: Schema.string().default("").description("附加到每条 skipped 说明后的备注，例如标注本机构实施细则。"),
 	timeoutMs: Schema.number().default(12e4).description("工具协作式超时预算（毫秒）。")
 });
-//#endregion
-//#region src/shared/datetime.ts
+// src/shared/datetime.ts
 const DATE_PATTERN = /^(\d{4})[-/.](\d{1,2})[-/.](\d{1,2})$/;
 const TIME_PATTERN = /^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;
 function pad(value, width = 2) {
@@ -72,8 +71,7 @@ function dayNumber(date) {
 function diffDays(from, to) {
 	return dayNumber(to) - dayNumber(from);
 }
-//#endregion
-//#region src/shared/rules.ts
+// src/shared/rules.ts
 /**
 * Compose the one-line `basis` string rendered into reports.
 * @param basis - the rule's normative basis.
@@ -103,8 +101,7 @@ function disabledAsSkipped(ruleset, disabledIds, reason) {
 		reason
 	}));
 }
-//#endregion
-//#region src/shared/yaml.ts
+// src/shared/yaml.ts
 /**
 * Minimal, dependency-free YAML reader for rule packs and check material.
 *
@@ -457,6 +454,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,
@@ -536,8 +537,7 @@ function requireString(source, key, where) {
 	if (typeof value !== "string" || value.trim() === "") throw new YamlSubsetError(`${where}: missing required string field "${key}"`);
 	return value;
 }
-//#endregion
-//#region src/shared/ruleset.ts
+// src/shared/ruleset.ts
 /**
 * Rule-pack loading and validation.
 *
@@ -667,8 +667,7 @@ function paramStrings(rule, key, fallback) {
 	if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) throw new YamlSubsetError(`rule ${rule.id}: params.${key} must be a list of strings`);
 	return value;
 }
-//#endregion
-//#region src/shared/report.ts
+// src/shared/report.ts
 /** Locator fields that participate in the stable issue id, in fixed order. */
 const LOCATOR_ID_KEYS = [
 	"file",
@@ -744,8 +743,7 @@ function sortValue(value) {
 	}
 	return target;
 }
-//#endregion
-//#region src/check.ts
+// src/check.ts
 /**
 * Pure check core: `(input, ruleset, options) => Report`.
 *
@@ -1222,8 +1220,7 @@ function runCheck(input, ruleset, options) {
 		skipped
 	});
 }
-//#endregion
-//#region src/shared/dictionary.ts
+// src/shared/dictionary.ts
 /** Strip decoration that never carries meaning in a header cell. */
 function normalizeHeader(raw) {
 	return raw.replace(/[\u3000\s]+/g, "").replace(/[*＊]/g, "").replace(/[（(][^（()）]*[)）]/g, "").replace(/[：:]/g, "").replace(/[【】\[\]]/g, "").toLowerCase();
@@ -1252,8 +1249,7 @@ function resolveHeaders(headers, fields) {
 		return ranked.find((entry) => header.includes(entry.alias))?.key;
 	});
 }
-//#endregion
-//#region src/parse.ts
+// src/parse.ts
 /**
 * Reader for the canonical front-sheet material, plus the column dictionary.
 *
@@ -1524,12 +1520,10 @@ function parseMaterial(source, target) {
 		warnings
 	};
 }
-//#endregion
-//#region src/shared/wording.ts
+// src/shared/wording.ts
 /** Footer appended to every rendered report. */
 const DISCLAIMER = "免责声明：本报告由程序按声明的规则集自动生成，仅列出与所引条款之间的字面差异，供人工复核线索使用；不构成对任何事实、行为或文件的定性意见，也不替代主管人员、评审专家或监管机构的判断。规则集的时效性与适用范围以引用文件的最新有效版本为准。";
-//#endregion
-//#region src/view.ts
+// src/view.ts
 /**
 * Model-facing projection of a {@link Report}.
 *
@@ -1609,8 +1603,7 @@ function buildView(report) {
 		reportJson: canonicalJson(report)
 	};
 }
-//#endregion
-//#region src/shared/memo.ts
+// src/shared/memo.ts
 /**
 * Memoized loading of package-owned rule packs.
 *
@@ -1633,8 +1626,7 @@ function loadRulesetFile(path) {
 	pending.catch(() => cache.delete(path));
 	return pending;
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 const name = "dsh-medrec-qc";
 const inject = ["tools"];
 /** Tool id exposed to the model, and the row id in `cordis.patch.yml`. */
@@ -1771,5 +1763,4 @@ function apply(ctx, config) {
 		}
 	}));
 }
-//#endregion
 export { Config, TOOL_NAME, apply, inject, name, resolvePackageFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-medrec-qc",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "病案首页形式质控与逻辑矛盾提示（依据国卫办医发〔2016〕24号等公开文件，仅提示差异，不作出定性结论）",
   "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/MR-001-unsafe.yaml",
+      "prompt": "用自带样例跑一次这项检查，告诉我发现了几条问题、分别是什么级别。",
+      "expect": "samples/quickstart/expected/result.json",
+      "screenshot": "docs/assets/quickstart.png",
+      "reads": [
+        "用户指定的材料文件"
+      ],
+      "writes": [],
+      "network": false,
+      "external": []
+    },
+    "capabilities": [
+      "tools:register"
+    ],
+    "labels": []
   },
   "keywords": [
     "deepseek-harness",
@@ -77,14 +97,14 @@
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.5-alpha.1",
-    "@deepseek-ai/dsh-package-manifest": "0.2.1-rc.2",
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-package-manifest": "0.2.1-rc.3",
     "@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": "medrec_qc",
+  "issueCount": 1,
+  "summary": {
+    "error": 1,
+    "warn": 0,
+    "info": 0
+  },
+  "skippedCount": 14
+}

package/samples/quickstart/input/MR-001-unsafe.yaml

@@ -0,0 +1,23 @@
+target: 2026 年 3 月出院病案首页导出
+cases:
+  - row: 1
+    病案号: ""
+    入院时间: "2026-03-01 08:30"
+    出院时间: "2026-03-06 10:00"
+    实际住院天数: "5"
+    性别: "1"
+    出生日期: "1972-05-04"
+    年龄: "53"
+    离院方式: "1"
+    科主任: "赵主任"
+    主任医师: "钱主任医师"
+    主治医师: "孙主治"
+    住院医师: "李医师"
+    责任护士: "周护士"
+    编码员: "吴编码"
+    主要诊断名称: "2型糖尿病"
+    主要诊断编码: "E11.900"
+    其他诊断: "高血压;慢性肾功能不全"
+    主要手术名称: "腹腔镜胆囊切除术"
+    主要手术编码: "51.2300"
+    有手术操作: "1"

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', "MR-001-unsafe.yaml"), '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-medrec-qc-hero.png",
+    "kind": "hero",
+    "alt": "dsh-medrec-qc terminal output",
+    "caption": "Real dsh-medrec-qc checker output; 33 tests passed."
+  },
+  {
+    "path": "docs/assets/dsh-medrec-qc-demo.gif",
+    "kind": "demo",
+    "alt": "Animated dsh-medrec-qc terminal session",
+    "caption": "The same run, assembled line by line."
+  }
+]