返回目錄

dsh-invoice-ledger

精選清單收錄維護狀態: 活躍

perrylink/dsh-invoice-ledger

核對發票臺賬:重複報銷、價稅勾稽、抬頭、日期、模板佔位符,輸出異常清單與規範化臺賬。

前往 GitHub專案首頁
$ dsh plugin add dsh-invoice-ledger

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README 中的設定行加入你的 profile / patch 設定,然後重啟即可。

查看安裝教學

1

星數

0

Fork

TypeScript

語言

Apache-2.0

授權條款

2026-10-23

建立於

2026-11-10

最近推送

README

dsh-invoice-ledger 横幅:右侧是一份 5 行发票台账,第 1、2 行共用同一个发票键、第 3 行价税合计 300.00 与金额加税额 226.00 不符、第 5 行开票日期 2026-10-20 晚于基准日 2026-10-15;下方是 3 条差异、12 条执行 / 14 条未执行规则和三页工作簿,数据取自 samples/quickstart

dsh-invoice-ledger

在发票入账之前把台账逐行核完——每条差异都指到行、给出依据。

面向财务与报销审核岗的 DeepSeek Harness 检查插件:读一份台账,核对重复报销、价税勾稽、抬头、日期与模板占位符,输出异常清单和三页工作簿;不改原件、不联网、不调用模型。

最近一次核验:DeepSeek Harness dsh-v0.2.3-alpha.1(2026-11-22)。

安装 · 配置 · FAQ · 简体中文 · English · Español · Português · हिन्दी

License DSH npm CI Node

Stars npm downloads dshfind OpenSSF Scorecard Gitee

dsh plugin --profile <name> add dsh-invoice-ledger

社区插件,与 DeepSeek 官方无关。唯一仓库:https://github.com/PerryLink/dsh-invoice-ledger(Gitee 为镜像)。

它是什么

dsh-invoice-ledger 真实终端运行

本仓库一次真实运行的动图回放。

dsh-invoice-ledger 读一份发票台账,逐行核对:同一张发票有没有被记两次、价税合计在容差内是否等于金额加税额、购方抬头是不是本公司(或已登记分支机构)、开票日期是否落在所属期且不在未来、单元格里是否还留着 XX公司 这类模板文字。结果是一份异常清单(指到行,给出实际值、期望值、建议处理与依据)和一份三页工作簿。

有两处是刻意的:判重只看发票代码 + 号码,不看金额,所以金额写错也仍会被判为重复;报告会逐一列出这一版没有执行的规则——一份台账报了 4 条差异、另有 14 条规则没跑,不等于只有 4 个问题。

dsh-invoice-ledger 结构:台账文件与 26 条规则库汇流入 invoice_ledger 闸门,按 params.check.kind 派发;执行通道 12 条规则产出 3 条指到行的差异,未执行通道把 14 条规则按 id 与检查类型单列;两条通道再汇流到先列未执行、再列差异的 Markdown 报告和三页工作簿

三步上手

  1. 安装(三选一):

    # npm 通道(推荐,已发布版本)
    dsh plugin --profile <name> add dsh-invoice-ledger
    # git 通道(最新 main)
    dsh plugin --profile <name> add github:PerryLink/dsh-invoice-ledger
    # tarball 通道:本仓库 pnpm pack 后
    dsh plugin --profile <name> add ./dsh-invoice-ledger-<version>.tgz
    

    从源码安装会先跑 pnpm install:prepare 脚本用 tsdown 生成 lib/index.mjs;跳过脚本安装时要手动构建一次,否则工具不会出现。

  2. 最小配置(默认即可用;cordis.patch.yml 只 insert 一行):

    - insert:
        - id: dsh-invoice-ledger
          name: dsh-invoice-ledger
    

    全部可调项都在 src/config.ts 的 Schemastery schema 里;逐条阈值在 rules/invoice-ledger.yaml。

  3. 验证已生效:

    dsh --profile <name> --dump-config | grep dsh-invoice-ledger
    node samples/quickstart/run.mjs --check
    

    自带样例是一份 5 行合成台账(1 条重复、1 条价税不符、1 条未来日期),应输出:

    invoice_ledger: quickstart OK — output matches expected/result.json
    

    Observed from samples/quickstart/expected/result.json

    样例输入在 samples/quickstart/input/,期望结果在 samples/quickstart/expected/result.json,运行截图见 docs/assets/quickstart.png。在会话里也可以直接说(package.json 的 dsh.demo.prompt):

    用自带样例核对一遍发票台账,告诉我发现了几条问题、分别是什么级别。

卸载:dsh plugin --profile <name> remove dsh-invoice-ledger(或从 profile patch 删掉该行)。

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。

核心能力

插件注册 invoice_ledger 工具:读入一份台账(.xlsx / .xlsm / .csv),套用带版本的规则库,返回结构化报告并写出一份工作簿。

  • 判重按发票键,不按金额 —— 数电票的 20 位号码、纸票的代码 + 号码都按字符串比较;同一张发票在本次台账内、跨报销单重复都会报出,金额写错也逃不掉。
  • 价税勾稽 —— 价税合计应在容差内等于金额加税额(随包规则库的容差是 0.02);超出容差报 error,备注命中差额征税、通行费、成品油等特殊情形时降级为 warn,而不是隐藏。
  • 抬头与主体 —— 购方名称、税号与本公司(含别名与已登记分支机构)比对;销方是交易对方,只检查名称是否填写,不拿销方与本公司比较;个人抬头按票种白名单放行。
  • 日期与期间 —— 日期必须可解析、不在未来、不早于公司成立日,并落在所属期内;跨年、晚于合同、超过内部申报期限分别提示。
  • 模板占位符 —— 扫描购方、销方、发票号码与备注中的模板文字;模式已加锚点,真实的 20 位数电票号码不会被误报。
  • 未执行规则单列 —— 规则库 26 条中,这一版执行 12 条、实现 8 类检查;其余 14 条按规则 id 与检查类型列出。未执行不等于通过。
  • 报告与工作簿 —— Markdown 报告先说未执行规则、再说异常;工作簿三张表:汇总、异常清单(一条发现一行)、未执行规则。
  • 只读、纯本地 —— 不改原件;不联网、不调用模型;唯一写操作是异常工作簿。
台账文件 ──dsh-table-ingest──▶ 行/列 ──规则库 26 条──▶ invoice_ledger ──▶ 异常清单 + 工作簿
                                    ▲                                    │
                                    └──── 未执行规则按 id 单列 ──────────┘

它回答什么问题

  • 同一张发票有没有被记两次,甚至跨两张报销单?
  • 价税合计在容差内是否等于金额加税额?
  • 购方到底是不是本公司,或是已登记的分支机构?
  • 销方名称是否填写?(销方是交易对方,不与本公司名称比对。)
  • 开票日期是否落在所属期内、不在未来,也在内部申报期限之内?
  • 哪些单元格还留着 XX公司 这类模板文字?

以及一个必须回答的问题:哪些规则没有跑?

配置

在 GitHub 閱讀完整 README →

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。