Vai al contenuto principale
A

dsh-loan-cal

aaalittlecloud/dsh-loan-cal

Strict-convention loan math for DeepSeek Harness: real APR from installment fees, amortization schedules, bank-statement audits, prepayment break-even, offer comparison and LPR repricing. Zero dependencies.

Installazione

dsh plugin --profile web add github:aaalittlecloud/dsh-loan-cal

README

dsh-loan-cal

English | 中文

Strict-convention loan math for DeepSeek Harness. Six tools, zero dependencies.

Overview

The same loan gets different answers depending on the convention applied. Nothing is guessed here: the compounded rate follows the PBOC 2021 IRR notice, the simple rate sits beside it and is labelled, and daily accrual requires an explicit basis. Money is integer fen throughout; the final instalment absorbs rounding.

The tools cover one chain: true annual rate → amortisation table → audit of a bank statement → early payoff → comparing offers → LPR repricing. No network, no Excel parsing, no bundled LPR snapshot — by design.

Tools

ToolWhat it does
real_aprMonthly fee rate and fees → monthly IRR, simple and compounded annual rate
loan_scheduleEqual-installment / equal-principal / interest-only / balloon → amortisation table + implied IRR
loan_auditA bank's repayment schedule → per-period diff, overcharge total, attributed cause (rate / day count / rounding)
prepay_auditEarly payoff → interest saved, penalty, implied return, payback, both bank options
apr_compareSeveral offers → one yardstick, ranked, with the spread
lpr_resetLPR plus fixed spread → new rate, new instalment, interest change

Language

Results tables, conclusions and warnings are Chinese — a person reads them. Tool names, descriptions, parameter docs and error messages are English — the model acts on them. Documentation is bilingual: this file and README-zh.md.

Conventions

  • The compounded rate (1 + monthly IRR)¹² − 1 is the headline (PBOC 2021 notice); the simple rate monthly IRR × 12 is shown beside it and never mixed — ADR 0002
  • Daily accrual requires an explicit ACT/360, ACT/365 or 30/360; there is no default
  • Integer fen throughout; one rounding per rate × amount; principal parts always sum to the principal
  • CSV/TSV or pasted text only, never xlsx — ADR 0003; LPR is supplied by the caller

Install and development

Install from the release tarball — no npm account, no git:

dsh plugin --profile <profile> add https://github.com/aaaLittleCloud/dsh-loan-cal/releases/download/v0.1.0/dsh-loan-cal-0.1.0.tgz

Or from source:

git clone https://github.com/aaaLittleCloud/dsh-loan-cal
dsh plugin --profile <profile> add file:./dsh-loan-cal

Not on npm yet; once published it will be dsh plugin --profile <profile> add dsh-loan-cal.

npm test        # 99 tests, no network

A file: install is a snapshot: re-run remove + add after changing the code.

Verification

99 tests, including the three worked examples in the annex of the PBOC 2021 notice (4.88% / simple 5% and IRR 5.12% / simple 12.80% and IRR 13.58%). All six tools executed inside a real profile.

Citation

@software{dsh-loan-cal,
  author = {aaaLittleCloud},
  title  = {dsh-loan-cal: strict-convention loan math for DeepSeek Harness},
  year   = {2026},
  url    = {https://github.com/aaaLittleCloud/dsh-loan-cal}
}

aaaLittleCloud. (2026). dsh-loan-cal [Computer software]. https://github.com/aaaLittleCloud/dsh-loan-cal

License

MIT

Plugin correlati