dsh-ap-three-way 0.1.1 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.2.0] — 2026-11-13
4
+
5
+ ### Breaking
6
+
7
+ - Tool names now use underscores instead of dots: `ap_import`, `ap_import_invoice_xml`, `ap_match`, `ap_export`, `ap_tolerance_match`, `ap_duplicate_check`. The model provider validates `tools[].name` against `^[a-zA-Z0-9_-]+$`; a dotted name makes it reject the whole `tools` array, so the plugin registered but every request carrying the tools failed. The old dotted names are no longer registered — update prompts, scripts and saved call history to the underscore names. Minor bump per the compatibility promise (breaking changes require a minor bump).
8
+
9
+ ### Added
10
+
11
+ - Regression test `test/tool-name-wire.test.mjs`: every registered tool name matches `^[a-zA-Z0-9_-]+$`, contains no dot, and is unique.
12
+
3
13
  ## [0.1.0] — 2026-11-03
4
14
 
5
15
  ### Stable
@@ -22,13 +32,17 @@
22
32
 
23
33
  ### Added
24
34
 
25
- - `ap.duplicate_check`: duplicate invoice-line detection (same supplier, PO line, quantity and amount) before matching; supplier names are compared case- and space-insensitively. Verified by `node --test test/*.test.mjs` (11/11).
35
+ - `ap_duplicate_check`: duplicate invoice-line detection (same supplier, PO line, quantity and amount) before matching; supplier names are compared case- and space-insensitively. Verified by `node --test test/*.test.mjs` (11/11).
26
36
 
27
37
  ## [Unreleased]
28
38
 
39
+ ## [0.2.1] - 2026-11-22
40
+
41
+ - Compatibility: declare DeepSeek Harness 0.2.3-alpha.1 support (>=0.2.3-0 <0.3.0-0 in engines.dsh and every @deepseek-ai/dsh-* peer range) and refresh README verification stamps.
42
+
29
43
  ### Added
30
44
 
31
- - `ap.tolerance_match`: three-way match with a configurable policy — price, quantity and amount tolerances in basis points, explicit `matched`/`exception` reasons, and header-only GRN treated as "no receipt". Read-only; it does not overwrite stored matches. Verified by `node --test test/*.test.mjs` (8/8); fixtures are our own public/synthetic rows.
45
+ - `ap_tolerance_match`: three-way match with a configurable policy — price, quantity and amount tolerances in basis points, explicit `matched`/`exception` reasons, and header-only GRN treated as "no receipt". Read-only; it does not overwrite stored matches. Verified by `node --test test/*.test.mjs` (8/8); fixtures are our own public/synthetic rows.
32
46
 
33
47
  ## [0.1.0-alpha.7] — 2026-11-01
34
48
 
package/README.en.md ADDED
@@ -0,0 +1,297 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way: real local test-run terminal output — four tests passed, zero failed; one real capture shared by both colour schemes">
6
+ </picture>
7
+
8
+ <picture>
9
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
10
+ <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="dsh-ap-three-way data flow: invoice/PO/GRN CSV and invoice XML → ap_import into the local storage domain → ap_match three-way match (1% price tolerance) → ap_export Matches/Exceptions workpaper; ap_tolerance_match and ap_duplicate_check are read-only">
11
+ </picture>
12
+
13
+ # dsh-ap-three-way
14
+
15
+ **Match invoices, purchase orders, and goods receipts line by line — postable rows pass, exceptions land in a workpaper with their reasons.**
16
+
17
+ A purely local AP three-way-match plugin for DeepSeek Harness: CSV/XML import, a 1% default price tolerance, a bps-tunable tolerance policy, and duplicate-line detection — no network, no model call.
18
+
19
+ Last verified on DeepSeek Harness `dsh-v0.2.3-alpha.1` (2026-11-22).
20
+
21
+ [Install](#three-step-setup) · [Configuration](#configuration) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
22
+
23
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
24
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.1%20%3C0.4.0-4B67B4?style=flat-square&labelColor=2B3245)](#compatibility)
25
+ [![npm](https://img.shields.io/npm/v/dsh-ap-three-way?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-ap-three-way)
26
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-ap-three-way/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-ap-three-way/actions/workflows/ci.yml)
27
+ [![Node](https://img.shields.io/badge/node-%3E%3D24.9%20%3C25-339933?style=flat-square&labelColor=2B3245)](#compatibility)
28
+
29
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-ap-three-way?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-ap-three-way/stargazers)
30
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-ap-three-way?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-ap-three-way)
31
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-ap-three-way?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-ap-three-way?ref=badge)
32
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
33
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-ap-three-way)
34
+
35
+ ```sh
36
+ dsh plugin --profile <profile> add dsh-ap-three-way
37
+ ```
38
+
39
+ </div>
40
+
41
+ <sub>Community plugin, not affiliated with DeepSeek. Canonical repository: <https://github.com/PerryLink/dsh-ap-three-way> (Gitee is a mirror). Status: alpha · verified on public/synthetic data only · not GA — no customer data or customer evidence, no production-readiness claim.</sub>
42
+
43
+ ## What it is
44
+
45
+ Accounts-payable three-way matching: every invoice line is matched against its purchase order (PO) and goods receipt (GRN); the unit price passes within a 1% default tolerance, while quantity over receipt, a missing PO, or a missing receipt counts as an exception. Matches and exception reasons land in a local storage domain, and one command exports a two-sheet xlsx workpaper (Matches / Exceptions). Everything runs on your machine — no network, no model call, no upload; inputs are read by the session and passed to the tools as arguments, and the original files are never touched.
46
+
47
+ - **Good fit**: invoice/PO/GRN CSVs of tens to a few hundred lines; AP reconciliation that needs a "postable / exception" list under a tolerance policy plus a workpaper trail.
48
+ - **Not a fit**: automatic posting, vendor-master changes, or replacing approvals — this package only matches locally and never modifies any document.
49
+
50
+ ## Three-step setup
51
+
52
+ 1. **Install** (pick one channel):
53
+
54
+ ```sh
55
+ # npm channel (recommended; published releases)
56
+ dsh plugin --profile <profile> add dsh-ap-three-way
57
+ # git channel (latest main; equivalent to git+https://github.com/PerryLink/dsh-ap-three-way.git)
58
+ dsh plugin --profile <profile> add github:PerryLink/dsh-ap-three-way
59
+ # tarball channel: pnpm pack in this repo, then
60
+ dsh plugin --profile <profile> add ./dsh-ap-three-way-<version>.tgz
61
+ ```
62
+
63
+ 2. **Minimal config** (the install command already applies the bundle patch; hand-written profiles paste this one row):
64
+
65
+ ```yaml
66
+ - insert:
67
+ - id: dsh-ap-three-way
68
+ name: dsh-ap-three-way
69
+ ```
70
+
71
+ The plugin has no plugin-level config keys; the tolerance policy is passed as tool arguments — see "Configuration".
72
+
73
+ 3. **Verify it mounts**:
74
+
75
+ ```sh
76
+ dsh --profile <profile> --dump-config | grep dsh-ap-three-way
77
+ ```
78
+
79
+ A synthetic sample ships with the repo — run the full pipeline once (it should end with `quickstart ok`):
80
+
81
+ ```sh
82
+ node samples/quickstart/run.mjs
83
+ ```
84
+
85
+ **Uninstall**: `dsh plugin --profile <profile> remove dsh-ap-three-way` (or remove the row from the profile patch).
86
+
87
+ Inside a session you can also just ask for it — this is the one-line demo prompt shipped in `package.json` as `dsh.demo.prompt`:
88
+
89
+ ```text
90
+ 帮我用自带样例做一次发票、采购单、收货单三单匹配,把能过的和例外分别列出来。
91
+ ```
92
+
93
+ <details>
94
+ <summary>Install from the DSH Desktop market</summary>
95
+
96
+ Every PerryLink plugin is listed in the built-in DSH Desktop market: **Market → Sources → Add source → paste** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ select**. Installation still requires the market's npm identity check and your confirmation.
97
+
98
+ </details>
99
+
100
+ ## Core capabilities
101
+
102
+ - **Three-way match** — `ap_match` matches every invoice line against its PO and GRN: a 1% default unit-price tolerance, and quantity over receipt is an exception; matched/exception plus the reason are written to the local storage domain.
103
+ - **Configurable tolerance re-run** — `ap_tolerance_match` sets price, quantity, and amount tolerances independently in basis points; read-only, never overwrites stored matches.
104
+ - **Duplicate invoice-line detection** — `ap_duplicate_check` flags duplicate lines before matching by supplier (case- and space-insensitive), PO line, quantity, and amount; read-only.
105
+ - **Exception workpaper export** — `ap_export` writes the Matches / Exceptions sheets to `exports/ap-<timestamp>.xlsx` and returns the path plus its sha256.
106
+ - **Invoice XML import** — `ap_import_invoice_xml` parses a local generic invoice XML (root `<Invoice>`, with `Seller/Name` and `Items/Item`).
107
+ - **Purely local** — no HTTP / DNS / WebSocket calls in the source; no ERP or vendor-system connections, nothing uploaded.
108
+
109
+ ### Tool surface
110
+
111
+ Tool names are a stable API (a compatibility promise since 0.1.0 — breaking changes require a minor bump). Writing tools are marked **R1 (local write)**, read-only tools **R0**.
112
+
113
+ Since 0.2.1 tool names use underscores (e.g. `ap_import`): the provider validates `tools[].name` against `^[a-zA-Z0-9_-]+$`, and a dot makes it reject the whole `tools` array. The old dotted names are no longer registered — migrate using the table below.
114
+
115
+ | Tool | Purpose | Risk |
116
+ |---|---|---|
117
+ | `ap_import` | Import invoice, PO, and GRN rows (CSV text passed as arguments); re-importing the same invoice is skipped via `skipped` | R1 local write |
118
+ | `ap_import_invoice_xml` | Import invoice lines from a local generic invoice XML, optional PO reference | R1 local write |
119
+ | `ap_match` | Three-way match: 1% default unit-price tolerance, quantity over receipt is an exception; stores matches and exceptions | R1 local write |
120
+ | `ap_export` | Export the two-sheet Matches / Exceptions xlsx workpaper | R1 local write |
121
+ | `ap_tolerance_match` | Re-run the three-way match under a configurable tolerance (bps); read-only, never overwrites stored matches | R0 read-only |
122
+ | `ap_duplicate_check` | Detect duplicate invoice lines before matching | R0 read-only |
123
+
124
+ ### Input and output
125
+
126
+ Input:
127
+
128
+ - Invoice CSV: UTF-8, header `supplier,invoice_no,po_no,line_no,qty,unit_price,amount` (`invoice_no` may be omitted).
129
+ - PO CSV: `po_no,line_no,qty,unit_price,amount`; GRN CSV: `po_no,line_no,qty`.
130
+ - Invoice XML: root `<Invoice>` with `Seller/Name` and `Items/Item` (`Quantity` / `UnitPrice` / `Amount`).
131
+ - Amounts carry at most two decimals; keep each file ≤5 MB. The shipped sample lives in `samples/quickstart/input/` (synthetic, far below 500 KB).
132
+
133
+ Output:
134
+
135
+ - Terminal summary: how many lines postable, how many exceptions, at the 1% default price tolerance.
136
+ - Workpaper: `$DSH_HOME/storages/dsh-ap-three-way/exports/ap-<timestamp>.xlsx` with `Matches` / `Exceptions` sheets, plus a sha256.
137
+ - Original files are never modified.
138
+
139
+ ### Examples
140
+
141
+ Quickstart sample (synthetic, shipped with the package):
142
+
143
+ ```sh
144
+ node samples/quickstart/run.mjs # human-readable transcript, should end with quickstart ok
145
+ node samples/quickstart/run.mjs --json # canonical result — the source of the expected/result.json gold file
146
+ ```
147
+
148
+ ![Real dsh-ap-three-way quickstart run output](docs/assets/quickstart.png)
149
+
150
+ *Synthetic sample → gold file `samples/quickstart/expected/result.json`; the command and output hashes are recorded in `screenshots.json` (real run on 2026-11-02).*
151
+
152
+ ![Real dsh-ap-three-way quickstart run output](docs/assets/dsh-ap-three-way-demo.gif)
153
+
154
+ *Animated replay of a real run recorded in this repository.*
155
+
156
+ Public-fixture acceptance: input [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml) (public MIT sample); re-run `node scripts/acceptance.mjs`. Details in `ACCEPTANCE.csv`, quoted verbatim:
157
+
158
+ ```text
159
+ req_id,metric,threshold,actual,pass,source,counted
160
+ SKU-05-A01,发票行解析,20/20,20,true,public/synthetic,false
161
+ PS1-QS01,quickstart 样例与金标一致,1/1,1,true,synthetic/quickstart,true
162
+ ```
163
+
164
+ *The SKU row is a public/synthetic fixture check (`counted=false`); PS1-QS01 is a local reproduction of the shipped sample (`counted=true`). Neither is a customer run, and no output is invented.*
165
+
166
+ ## Configuration
167
+
168
+ This plugin has no Schemastery `Config` keys — `cordis.patch.yml` only `insert`s one row (see "Three-step setup"), so there is no plugin-level key to override. The tolerance policy is passed as arguments to `ap_tolerance_match`:
169
+
170
+ | Parameter | Default | Meaning |
171
+ |---|---|---|
172
+ | `price_bps` | `100` | Unit-price tolerance in basis points (100 = 1%); integer 0–10000 |
173
+ | `qty_bps` | `0` | Quantity tolerance relative to the received quantity; default 0 — quantity over receipt is an exception |
174
+ | `amount_bps` | `0` | Amount tolerance; default 0 disables the amount dimension |
175
+ | `min_price_cents` | `1` | Floor for the unit-price tolerance (cents), so small-amount lines are not judged too strictly |
176
+
177
+ Out-of-range arguments (non-integer, negative, above 10000) fail loudly at call time in the uniform error format (one plain message + an `E_XXX` code + the next step), e.g.:
178
+
179
+ ```text
180
+ 容差参数 price_bps 超出范围(E_AP_POLICY)|下一步:把 price_bps 设为 0–10000 的整数
181
+ ```
182
+
183
+ `ap_match` always uses the default 1% unit-price tolerance plus "quantity not over receipt"; only `ap_tolerance_match` accepts these four parameters.
184
+
185
+ ## FAQ
186
+
187
+ <details>
188
+ <summary>Where does the data live? Are my original files touched?</summary>
189
+
190
+ Match state (invoices, PO, GRN, match results) is written only to the local storage domain `$DSH_HOME/storages/dsh-ap-three-way`; exported workpapers go to its `exports/` subdirectory. Input CSV/XML is read by the session and passed to the tools as arguments — the original files are never modified, and nothing is uploaded.
191
+
192
+ </details>
193
+
194
+ <details>
195
+ <summary>Install fails — what now?</summary>
196
+
197
+ Confirm DSH `>=0.2.1-rc.3 <0.4.0` and Node `>=24.9 <25`, then retry with a fresh `DSH_HOME`; the full steps are in [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
198
+
199
+ </details>
200
+
201
+ <details>
202
+ <summary>The price is within 1% — why is the line still an exception?</summary>
203
+
204
+ The default tolerance only relaxes the unit price; quantity over the GRN (`qty_over_grn`) is still an exception, as are a missing PO (`po_missing`) and a missing receipt (`grn_missing`). To relax further, call `ap_tolerance_match` with explicit `price_bps` / `qty_bps` / `amount_bps` and keep the policy parameters on record.
205
+
206
+ </details>
207
+
208
+ <details>
209
+ <summary>Can it process my real invoices?</summary>
210
+
211
+ It runs locally, but the package is alpha and verified only on public/synthetic data — it is not an audit or payment conclusion. Sanitize real data before use and keep a human reviewer in the loop.
212
+
213
+ </details>
214
+
215
+ <details>
216
+ <summary>Does it make network calls or upload data?</summary>
217
+
218
+ No. The tools, the sample, and the export all run on your machine; the source contains no HTTP / DNS / WebSocket calls.
219
+
220
+ </details>
221
+
222
+ ## Security boundaries
223
+
224
+ - **No network, no model call.** Unless a tool explicitly says so, there is no model or network call; input and output stay local.
225
+ - **Original files are never modified.** Writes land only in `$DSH_HOME/storages/dsh-ap-three-way` (match state and `exports/*.xlsx`).
226
+ - **Path-traversal guard on export.** Export file names pass a safe-path guard; invoice ids are content hashes; PO/GRN headers are validated; re-importing the same invoice is idempotently skipped.
227
+ - **Uniform errors, loud failures.** Errors follow one format — a plain one-line message, an `E_XXX` code, and the next step; full errors and stack traces go to the log only and never print internal paths. The three most common cases — unreadable amount (`E_AP_CSV_INVALID`), missing CSV column (`E_AP_CSV_INVALID`), out-of-range tolerance (`E_AP_POLICY`) — are listed with symptom/cause/action in [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
228
+
229
+ ## Permissions & data
230
+
231
+ - **Reads**: the invoice / PO / GRN CSVs and invoice XML you point at (read by the session and passed in as arguments); no other directories.
232
+ - **Writes**: `$DSH_HOME/storages/dsh-ap-three-way` (match state and `exports/*.xlsx`); original files untouched.
233
+ - **Network**: no (no HTTP / DNS / WebSocket calls in the source).
234
+ - **External systems**: none (no ERP / vendor-system connections, no uploads).
235
+ - **Data boundary**: verified on public/synthetic samples only; no customer data, no customer evidence.
236
+
237
+ ## Known limitations
238
+
239
+ - **Verified on public/synthetic data only.** Every acceptance row comes from a public or synthetic fixture (`counted=false` for the SKU rows in `ACCEPTANCE.csv`; PS1-QS01 is a local sample reproduction with `counted=true`); no customer data or customer evidence.
240
+ - **Alpha / partial / not counted / not GA.** No production-readiness claim; not an audit or payment conclusion.
241
+ - **Matching only, no posting.** It does not post automatically, change vendor master data, or replace approvals; it only matches locally and modifies no document.
242
+ - **Input format constraints.** Amounts carry at most two decimals; keep each file ≤5 MB; CSV headers must match verbatim (a missing column raises `E_AP_CSV_INVALID`).
243
+ - **Per-tool boundaries** are exactly the tool table above plus `ACCEPTANCE.csv`.
244
+
245
+ ## Compatibility
246
+
247
+ | Surface | Status |
248
+ |---|---|
249
+ | Harness | DeepSeek Harness `>=0.2.1-rc.3 <0.4.0` (`engines.dsh` in `package.json`) |
250
+ | Node | `>=24.9.0 <25` (`.nvmrc`: 24) |
251
+ | Platforms | Anywhere DSH runs; local files only |
252
+ | Data | No network, no model call, no upload |
253
+
254
+ ## Ecosystem & quality
255
+
256
+ - [Gitee mirror](https://gitee.com/perrylink/dsh-ap-three-way) (sync mirror; GitHub is canonical)
257
+ - [dshfind plugin page](https://dshfind.com/plugins/PerryLink/dsh-ap-three-way) (installs and ranking)
258
+ - [DSH Market](https://dsh.market/) (listed)
259
+ - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile <profile> add dsh-ap-three-way` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking)
260
+ - [Domain index](https://perrylink.github.io/dsh-plugins/) · [Checker family](https://perrylink.github.io/zh/checkers/) · [Scenario article](https://perrylink.github.io/dsh-plugins/articles/finops-suite.html)
261
+
262
+ ### Related work and checkers
263
+
264
+ Sibling packages and family indexes: [dsh-einvoice](https://github.com/PerryLink/dsh-einvoice) · [dsh-bankrec](https://github.com/PerryLink/dsh-bankrec) · [dsh-travel-recon](https://github.com/PerryLink/dsh-travel-recon) · [dsh-finops-suite](https://github.com/PerryLink/dsh-finops-suite)
265
+
266
+ Each checker is a separate package with its own rule pack and version; install only the ones you need:
267
+
268
+ | Package | Why it is relevant |
269
+ |---|---|
270
+ | [`dsh-invoice-ledger`](https://github.com/PerryLink/dsh-invoice-ledger) | Invoice-side duplicate and arithmetic checks before or after the three-way match |
271
+ | [`dsh-excel-reconcile`](https://github.com/PerryLink/dsh-excel-reconcile) | Fallback two-table alignment when PO/GRN data arrives as flat files |
272
+
273
+ ## Development
274
+
275
+ ```sh
276
+ pnpm install --frozen-lockfile # node >=24.9 <25
277
+ pnpm build && pnpm lint && pnpm typecheck && pnpm test # tsc build + lint + 27 node --test cases
278
+ pnpm gate:sku05 # acceptance gate (ACCEPTANCE.csv)
279
+ node scripts/acceptance.mjs # re-run the public/synthetic acceptance
280
+ node samples/quickstart/run.mjs # synthetic sample, should print quickstart ok
281
+ ```
282
+
283
+ Current version `0.2.1` (matches `package.json`). Tests: `node --test test/*.test.mjs` all green (11 test files, 27 cases; `pnpm test` builds first). The README images are generated programmatically by [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; light/dark SVG flow pair shared by all five languages) and are safe to re-run: `python scripts/gen-readme-assets.py`.
284
+
285
+ Topics: `deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
286
+
287
+ ## Family & thanks
288
+
289
+ This project is part of the DeepSeek Harness plugin family from [PerryLink](https://github.com/PerryLink) (all Apache-2.0). If it is useful, **a star helps the next person find it** — nothing is gated behind it.
290
+
291
+ - [@PerryLink](https://github.com/PerryLink) — creator and maintainer: the three-way-match engine and tolerance policy, the six `ap.*` tools, the quickstart sample and acceptance suite, and the five-language docs.
292
+
293
+ ## License
294
+
295
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-ap-three-way contributors; see also `NOTICE` and `THIRD-PARTY-NOTICES`.
296
+
297
+ <p align="center"><sub>Apache-2.0 · Community plugin, not affiliated with DeepSeek.</sub></p>
package/README.es.md ADDED
@@ -0,0 +1,297 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way: salida real de terminal de la ejecución local de pruebas — cuatro pruebas pasadas, cero fallidas; una sola captura real compartida por ambos esquemas de color">
6
+ </picture>
7
+
8
+ <picture>
9
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
10
+ <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="Flujo de datos de dsh-ap-three-way: CSV de factura/OC/recepción y XML de factura → ap_import al dominio de almacenamiento local → ap_match conciliación triple (tolerancia de precio del 1%) → ap_export hoja Matches/Exceptions; ap_tolerance_match y ap_duplicate_check son de solo lectura">
11
+ </picture>
12
+
13
+ # dsh-ap-three-way
14
+
15
+ **Concilia facturas, órdenes de compra y recepciones línea a línea: las líneas contabilizables pasan y las excepciones quedan en una hoja de trabajo con sus motivos.**
16
+
17
+ Un plugin de conciliación triple de AP puramente local para DeepSeek Harness: importación CSV/XML, tolerancia de precio predeterminada del 1%, política de tolerancia ajustable en bps y detección de líneas duplicadas — sin red y sin llamadas a un modelo.
18
+
19
+ Última verificación: DeepSeek Harness `dsh-v0.2.3-alpha.1` (2026-11-22).
20
+
21
+ [Instalar](#instalación-en-tres-pasos) · [Configuración](#configuración) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
22
+
23
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
24
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.1%20%3C0.4.0-4B67B4?style=flat-square&labelColor=2B3245)](#compatibilidad)
25
+ [![npm](https://img.shields.io/npm/v/dsh-ap-three-way?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-ap-three-way)
26
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-ap-three-way/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-ap-three-way/actions/workflows/ci.yml)
27
+ [![Node](https://img.shields.io/badge/node-%3E%3D24.9%20%3C25-339933?style=flat-square&labelColor=2B3245)](#compatibilidad)
28
+
29
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-ap-three-way?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-ap-three-way/stargazers)
30
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-ap-three-way?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-ap-three-way)
31
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-ap-three-way?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-ap-three-way?ref=badge)
32
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
33
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-ap-three-way)
34
+
35
+ ```sh
36
+ dsh plugin --profile <profile> add dsh-ap-three-way
37
+ ```
38
+
39
+ </div>
40
+
41
+ <sub>Plugin de la comunidad, no afiliado a DeepSeek. Repositorio canónico: <https://github.com/PerryLink/dsh-ap-three-way> (Gitee es un espejo). Estado: alpha · verificado solo con datos públicos/sintéticos · no GA — sin datos ni evidencia de clientes, sin promesa de producción.</sub>
42
+
43
+ ## Qué es
44
+
45
+ Conciliación triple de cuentas por pagar: cada línea de factura se confronta con su orden de compra (OC) y su recepción (GRN); el precio unitario pasa dentro de una tolerancia predeterminada del 1%, mientras que cantidad por encima de lo recibido, OC ausente o recepción ausente cuentan como excepción. Los resultados y los motivos de excepción quedan en un dominio de almacenamiento local, y un comando exporta una hoja de trabajo xlsx de dos pestañas (Matches / Exceptions). Todo se ejecuta en tu máquina — sin red, sin llamadas a un modelo, sin subidas; las entradas las lee la sesión y se pasan a las herramientas como argumentos, y los archivos originales no se tocan.
46
+
47
+ - **Adecuado para**: CSV de facturas/OC/recepciones de decenas a unos pocos cientos de líneas; conciliaciones de AP que necesitan una lista «contabilizable / excepción» bajo una política de tolerancia con hoja de trabajo.
48
+ - **No adecuado para**: contabilización automática, cambios en el maestro de proveedores o sustituir aprobaciones; este paquete solo concilia en local y no modifica ningún documento.
49
+
50
+ ## Instalación en tres pasos
51
+
52
+ 1. **Instalar** (elige un canal):
53
+
54
+ ```sh
55
+ # canal npm (recomendado; versiones publicadas)
56
+ dsh plugin --profile <profile> add dsh-ap-three-way
57
+ # canal git (último main; equivalente a git+https://github.com/PerryLink/dsh-ap-three-way.git)
58
+ dsh plugin --profile <profile> add github:PerryLink/dsh-ap-three-way
59
+ # canal tarball: pnpm pack en este repo, luego
60
+ dsh plugin --profile <profile> add ./dsh-ap-three-way-<version>.tgz
61
+ ```
62
+
63
+ 2. **Configuración mínima** (el comando de instalación ya aplica el bundle patch; los perfiles escritos a mano pegan esta única fila):
64
+
65
+ ```yaml
66
+ - insert:
67
+ - id: dsh-ap-three-way
68
+ name: dsh-ap-three-way
69
+ ```
70
+
71
+ El plugin no tiene claves de configuración propias; la política de tolerancia se pasa como argumentos de la herramienta — ver «Configuración».
72
+
73
+ 3. **Verificar que se monta**:
74
+
75
+ ```sh
76
+ dsh --profile <profile> --dump-config | grep dsh-ap-three-way
77
+ ```
78
+
79
+ El repo incluye una muestra sintética: ejecuta la cadena completa una vez (debe terminar con `quickstart ok`):
80
+
81
+ ```sh
82
+ node samples/quickstart/run.mjs
83
+ ```
84
+
85
+ Dentro de una sesión también basta con pedirlo (prompt citado de `dsh.demo` en `package.json`):
86
+
87
+ ```text
88
+ 帮我用自带样例做一次发票、采购单、收货单三单匹配,把能过的和例外分别列出来。
89
+ ```
90
+
91
+ **Desinstalar**: `dsh plugin --profile <profile> remove dsh-ap-three-way` (o quita la fila del patch del perfil).
92
+
93
+ <details>
94
+ <summary>Instalar desde el mercado de DSH Desktop</summary>
95
+
96
+ Todos los plugins de PerryLink están en el mercado integrado de DSH Desktop: **Market → Sources → Add source → pega** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ selecciona**. La instalación sigue requiriendo la verificación de identidad npm del mercado y tu confirmación.
97
+
98
+ </details>
99
+
100
+ ## Capacidades clave
101
+
102
+ - **Conciliación triple** — `ap_match` confronta cada línea de factura con su OC y su GRN: tolerancia de precio unitario predeterminada del 1%, y cantidad por encima de lo recibido es excepción; matched/exception y el motivo se escriben en el dominio de almacenamiento local.
103
+ - **Recálculo con tolerancia configurable** — `ap_tolerance_match` fija tolerancias de precio, cantidad e importe de forma independiente en puntos básicos; solo lectura, nunca sobrescribe las conciliaciones guardadas.
104
+ - **Detección de líneas de factura duplicadas** — `ap_duplicate_check` marca duplicados antes de conciliar por proveedor (sin distinguir mayúsculas ni espacios), línea de OC, cantidad e importe; solo lectura.
105
+ - **Exportación de la hoja de excepciones** — `ap_export` escribe las pestañas Matches / Exceptions en `exports/ap-<timestamp>.xlsx` y devuelve la ruta con su sha256.
106
+ - **Importación de XML de factura** — `ap_import_invoice_xml` analiza un XML de factura genérico local (raíz `<Invoice>`, con `Seller/Name` y `Items/Item`).
107
+ - **Puramente local** — sin llamadas HTTP / DNS / WebSocket en el código; sin conexiones a ERP ni a sistemas de proveedores, nada se sube.
108
+
109
+ ### Superficie de herramientas
110
+
111
+ Los nombres de las herramientas son una API estable (promesa de compatibilidad desde 0.1.0: los cambios disruptivos requieren un bump minor). Las herramientas que escriben se marcan **R1 (escritura local)** y las de solo lectura **R0**.
112
+
113
+ Desde 0.2.1 los nombres usan guiones bajos (p. ej. `ap_import`): el proveedor valida `tools[].name` con `^[a-zA-Z0-9_-]+$` y un punto hace que se rechace todo el array `tools`. Los nombres con punto ya no se registran; migra según la tabla siguiente.
114
+
115
+ | Herramienta | Propósito | Riesgo |
116
+ |---|---|---|
117
+ | `ap_import` | Importar filas de factura, OC y GRN (texto CSV como argumentos); reimportar la misma factura se omite vía `skipped` | R1 escritura local |
118
+ | `ap_import_invoice_xml` | Importar líneas de factura desde un XML genérico local, con referencia de OC opcional | R1 escritura local |
119
+ | `ap_match` | Conciliación triple: tolerancia de precio unitario predeterminada del 1%, cantidad por encima de lo recibido es excepción; guarda conciliaciones y excepciones | R1 escritura local |
120
+ | `ap_export` | Exportar la hoja xlsx de dos pestañas Matches / Exceptions | R1 escritura local |
121
+ | `ap_tolerance_match` | Repetir la conciliación triple con tolerancia configurable (bps); solo lectura, no sobrescribe lo guardado | R0 solo lectura |
122
+ | `ap_duplicate_check` | Detectar líneas de factura duplicadas antes de conciliar | R0 solo lectura |
123
+
124
+ ### Entrada y salida
125
+
126
+ Entrada:
127
+
128
+ - CSV de facturas: UTF-8, cabecera `supplier,invoice_no,po_no,line_no,qty,unit_price,amount` (`invoice_no` puede omitirse).
129
+ - CSV de OC: `po_no,line_no,qty,unit_price,amount`; CSV de GRN: `po_no,line_no,qty`.
130
+ - XML de factura: raíz `<Invoice>` con `Seller/Name` y `Items/Item` (`Quantity` / `UnitPrice` / `Amount`).
131
+ - Los importes llevan como máximo dos decimales; cada archivo ≤5 MB recomendado. La muestra incluida está en `samples/quickstart/input/` (sintética, muy por debajo de 500 KB).
132
+
133
+ Salida:
134
+
135
+ - Resumen en terminal: cuántas líneas contabilizables y cuántas excepciones, con la tolerancia de precio predeterminada del 1%.
136
+ - Hoja de trabajo: `$DSH_HOME/storages/dsh-ap-three-way/exports/ap-<timestamp>.xlsx` con las pestañas `Matches` / `Exceptions`, más un sha256.
137
+ - Los archivos originales nunca se modifican.
138
+
139
+ ### Ejemplos
140
+
141
+ Muestra de inicio rápido (sintética, incluida en el paquete):
142
+
143
+ ```sh
144
+ node samples/quickstart/run.mjs # transcripción legible, debe terminar con quickstart ok
145
+ node samples/quickstart/run.mjs --json # resultado canónico — origen del oro expected/result.json
146
+ ```
147
+
148
+ ![Salida real de la ejecución del quickstart de dsh-ap-three-way](docs/assets/quickstart.png)
149
+
150
+ *Muestra sintética → archivo de oro `samples/quickstart/expected/result.json`; el comando y los hashes de salida están en `screenshots.json` (ejecución real del 2026-11-02).*
151
+
152
+ ![Salida real de la ejecución del quickstart de dsh-ap-three-way](docs/assets/dsh-ap-three-way-demo.gif)
153
+
154
+ *Repetición animada de una ejecución real registrada en este repositorio.*
155
+
156
+ Aceptación con fixture pública: entrada [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml) (muestra MIT pública); se repite con `node scripts/acceptance.mjs`. Detalle en `ACCEPTANCE.csv`, citado literalmente:
157
+
158
+ ```text
159
+ req_id,metric,threshold,actual,pass,source,counted
160
+ SKU-05-A01,发票行解析,20/20,20,true,public/synthetic,false
161
+ PS1-QS01,quickstart 样例与金标一致,1/1,1,true,synthetic/quickstart,true
162
+ ```
163
+
164
+ *La fila SKU es una comprobación de fixture pública/sintética (`counted=false`); PS1-QS01 es una reproducción local de la muestra incluida (`counted=true`). Ninguna es una ejecución de cliente y no se inventa salida.*
165
+
166
+ ## Configuración
167
+
168
+ Este plugin no tiene claves `Config` de Schemastery — `cordis.patch.yml` solo `insert` una fila (ver «Instalación en tres pasos»), así que no hay ninguna clave de plugin que sobrescribir. La política de tolerancia se pasa como argumentos a `ap_tolerance_match`:
169
+
170
+ | Parámetro | Predeterminado | Significado |
171
+ |---|---|---|
172
+ | `price_bps` | `100` | Tolerancia de precio unitario en puntos básicos (100 = 1%); entero 0–10000 |
173
+ | `qty_bps` | `0` | Tolerancia de cantidad relativa a lo recibido; por defecto 0 — cantidad por encima de lo recibido es excepción |
174
+ | `amount_bps` | `0` | Tolerancia de importe; por defecto 0, la dimensión de importe está desactivada |
175
+ | `min_price_cents` | `1` | Suelo de la tolerancia de precio unitario (céntimos), para que las líneas de importe pequeño no se juzguen con demasiada severidad |
176
+
177
+ Los argumentos fuera de rango (no enteros, negativos, mayores que 10000) fallan en voz alta al llamar, con el formato de error `<qué pasó>(E_XXX)|下一步:<acción>`, por ejemplo:
178
+
179
+ ```text
180
+ 容差参数 price_bps 超出范围(E_AP_POLICY)|下一步:把 price_bps 设为 0–10000 的整数
181
+ ```
182
+
183
+ `ap_match` usa siempre la tolerancia de precio unitario predeterminada del 1% más «cantidad no superior a lo recibido»; solo `ap_tolerance_match` acepta estos cuatro parámetros.
184
+
185
+ ## FAQ
186
+
187
+ <details>
188
+ <summary>¿Dónde viven los datos? ¿Se tocan mis archivos originales?</summary>
189
+
190
+ El estado de conciliación (facturas, OC, GRN, resultados) solo se escribe en el dominio de almacenamiento local `$DSH_HOME/storages/dsh-ap-three-way`; las hojas exportadas van a su subdirectorio `exports/`. Las entradas CSV / XML las lee la sesión y se pasan a las herramientas como argumentos — los archivos originales nunca se modifican y no se sube nada.
191
+
192
+ </details>
193
+
194
+ <details>
195
+ <summary>¿Qué hago si no se instala?</summary>
196
+
197
+ Confirma DSH `>=0.2.1-rc.3 <0.4.0` y Node `>=24.9 <25`, y reintenta con un `DSH_HOME` nuevo; los pasos completos están en [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
198
+
199
+ </details>
200
+
201
+ <details>
202
+ <summary>El precio está dentro del 1%, ¿por qué la línea sigue siendo excepción?</summary>
203
+
204
+ La tolerancia predeterminada solo relaja el «precio unitario»; la cantidad por encima de la recepción (`qty_over_grn`) sigue siendo excepción, igual que una OC ausente (`po_missing`) o una recepción ausente (`grn_missing`). Para relajar más, llama a `ap_tolerance_match` con `price_bps` / `qty_bps` / `amount_bps` explícitos y conserva los parámetros de la política.
205
+
206
+ </details>
207
+
208
+ <details>
209
+ <summary>¿Puede procesar mis facturas reales?</summary>
210
+
211
+ Se ejecuta en local, pero el paquete es alpha y solo está verificado con datos públicos/sintéticos — no constituye una conclusión de auditoría ni de pago. Anonimiza los datos reales antes de usarlos y mantén un revisor humano.
212
+
213
+ </details>
214
+
215
+ <details>
216
+ <summary>¿Hace llamadas de red o sube datos?</summary>
217
+
218
+ No. Las herramientas, la muestra y la exportación se ejecutan en tu máquina; el código no contiene llamadas HTTP / DNS / WebSocket.
219
+
220
+ </details>
221
+
222
+ ## Límites de seguridad
223
+
224
+ - **Sin red, sin llamadas a un modelo.** Salvo que una herramienta lo indique, no hay llamadas a modelo ni de red; la entrada y la salida permanecen locales.
225
+ - **Los archivos originales nunca se modifican.** Las escrituras solo caen en `$DSH_HOME/storages/dsh-ap-three-way` (estado de conciliación y `exports/*.xlsx`).
226
+ - **Guardia contra path traversal en la exportación.** Los nombres de archivo exportados pasan una guardia safe-path; los id de factura son hashes de contenido; las cabeceras de OC/GRN se validan; reimportar la misma factura se omite de forma idempotente.
227
+ - **Errores uniformes, fallos en voz alta.** Los errores siguen el formato `<qué pasó>(E_XXX)|下一步:<acción>`; el error completo y la pila solo se escriben en el log y nunca imprimen rutas internas. Los tres casos más comunes — importe ilegible (`E_AP_CSV_INVALID`), columna CSV ausente (`E_AP_CSV_INVALID`), tolerancia fuera de rango (`E_AP_POLICY`) — aparecen con síntoma/causa/acción en [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
228
+
229
+ ## Permisos y datos
230
+
231
+ - **Lee**: los CSV de factura / OC / GRN y el XML de factura que tú indiques (leídos por la sesión y pasados como argumentos); ningún otro directorio.
232
+ - **Escribe**: `$DSH_HOME/storages/dsh-ap-three-way` (estado de conciliación y `exports/*.xlsx`); los originales intactos.
233
+ - **Red**: no (sin llamadas HTTP / DNS / WebSocket en el código).
234
+ - **Sistemas externos**: ninguno (sin conexiones a ERP ni a sistemas de proveedores, sin subidas).
235
+ - **Frontera de datos**: verificado solo con muestras públicas/sintéticas; sin datos ni evidencia de clientes.
236
+
237
+ ## Limitaciones conocidas
238
+
239
+ - **Verificado solo con datos públicos/sintéticos.** Cada fila de aceptación proviene de una fixture pública o sintética (filas SKU con `counted=false` en `ACCEPTANCE.csv`; PS1-QS01 es una reproducción local de la muestra con `counted=true`); sin datos ni evidencia de clientes.
240
+ - **Alpha / parcial / no contabilizado / no GA.** Sin promesa de producción; no constituye conclusión de auditoría ni de pago.
241
+ - **Solo concilia, no contabiliza.** No contabiliza automáticamente, no cambia el maestro de proveedores ni sustituye aprobaciones; solo concilia en local y no modifica ningún documento.
242
+ - **Restricciones de formato de entrada.** Importes con dos decimales como máximo; cada archivo ≤5 MB recomendado; las cabeceras CSV deben coincidir literalmente (una columna ausente eleva `E_AP_CSV_INVALID`).
243
+ - **Los límites exactos por herramienta** son la tabla de herramientas de arriba más `ACCEPTANCE.csv`.
244
+
245
+ ## Compatibilidad
246
+
247
+ | Superficie | Estado |
248
+ |---|---|
249
+ | Harness | DeepSeek Harness `>=0.2.1-rc.3 <0.4.0` (`engines.dsh` en `package.json`) |
250
+ | Node | `>=24.9.0 <25` (`.nvmrc`: 24) |
251
+ | Plataformas | Dondequiera que DSH se ejecute; solo archivos locales |
252
+ | Datos | Sin red, sin llamadas a un modelo, sin subidas |
253
+
254
+ ## Ecosistema y calidad
255
+
256
+ - [Espejo en Gitee](https://gitee.com/perrylink/dsh-ap-three-way) (espejo sincronizado; GitHub es el canónico)
257
+ - [Página del plugin en dshfind](https://dshfind.com/plugins/PerryLink/dsh-ap-three-way) (instalaciones y ranking)
258
+ - [DSH Market](https://dsh.market/) (listado)
259
+ - **Canal de la tienda 1024**: `npm i -g dsh1024` una vez, luego `dsh1024 plugin --profile <profile> add dsh-ap-three-way` (cuenta en el ranking de instalaciones de [deepseek1024.com](https://deepseek1024.com))
260
+ - [Índice de dominio](https://perrylink.github.io/dsh-plugins/) · [Familia de checkers](https://perrylink.github.io/zh/checkers/) · [Artículo de escenario](https://perrylink.github.io/dsh-plugins/articles/finops-suite.html)
261
+
262
+ ### Trabajo relacionado y checkers
263
+
264
+ Paquetes hermanos e índices de la familia: [dsh-einvoice](https://github.com/PerryLink/dsh-einvoice) · [dsh-bankrec](https://github.com/PerryLink/dsh-bankrec) · [dsh-travel-recon](https://github.com/PerryLink/dsh-travel-recon) · [dsh-finops-suite](https://github.com/PerryLink/dsh-finops-suite)
265
+
266
+ Cada checker es un paquete independiente con su propio paquete de reglas y versión; instala solo los que necesites:
267
+
268
+ | Paquete | Por qué es relevante |
269
+ |---|---|
270
+ | [`dsh-invoice-ledger`](https://github.com/PerryLink/dsh-invoice-ledger) | Comprobaciones de duplicados y aritmética del lado de la factura antes o después de la conciliación triple |
271
+ | [`dsh-excel-reconcile`](https://github.com/PerryLink/dsh-excel-reconcile) | Alineación de dos tablas como fallback cuando los datos de OC/GRN llegan como archivos planos |
272
+
273
+ ## Desarrollo
274
+
275
+ ```sh
276
+ pnpm install --frozen-lockfile # node >=24.9 <25
277
+ pnpm build && pnpm lint && pnpm typecheck && pnpm test # build tsc + lint + 27 casos node --test
278
+ pnpm gate:sku05 # puerta de aceptación (ACCEPTANCE.csv)
279
+ node scripts/acceptance.mjs # repetir la aceptación pública/sintética
280
+ node samples/quickstart/run.mjs # muestra sintética, debe imprimir quickstart ok
281
+ ```
282
+
283
+ Versión actual `0.2.1` (coincide con `package.json`). Pruebas: `node --test test/*.test.mjs` todo en verde (11 archivos de prueba, 27 casos; `pnpm test` compila primero). Las imágenes del README se generan programáticamente con [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; par SVG de flujo claro/oscuro compartido por los cinco idiomas) y se pueden repetir: `python scripts/gen-readme-assets.py`.
284
+
285
+ Topics: `deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
286
+
287
+ ## Familia y agradecimientos
288
+
289
+ Este proyecto forma parte de la familia de plugins de DeepSeek Harness de [PerryLink](https://github.com/PerryLink) (todos Apache-2.0). Si te resulta útil, **una estrella ayuda a que la siguiente persona lo encuentre** — no hay nada bloqueado tras ella.
290
+
291
+ - [@PerryLink](https://github.com/PerryLink) — creador y mantenedor: el motor de conciliación triple y la política de tolerancia, las seis herramientas `ap.*`, la muestra quickstart y la suite de aceptación, y la documentación en cinco idiomas.
292
+
293
+ ## Licencia
294
+
295
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-ap-three-way contributors; ver también `NOTICE` y `THIRD-PARTY-NOTICES`.
296
+
297
+ <p align="center"><sub>Apache-2.0 · Plugin de la comunidad, no afiliado a DeepSeek.</sub></p>