工具总览

@axewo/fin-core 提供无 Vue、无 UI 的通用工具，基座、子应用和普通项目使用同一套实现。请求工具涉及网络操作，防抖涉及计时器，因此这里的“无框架”不表示所有函数都没有副作用。

pnpm add @axewo/fin-core

分类入口

分类	导入入口	说明
基础工具	@axewo/fin-core/utils	金额、日期、数组、对象、字符串、函数、树、校验
请求工具	@axewo/fin-core/http	Fetch、Axios 与认证请求，也可使用独立子入口
配置与错误	@axewo/fin-core/config、@axewo/fin-core/errors	地址验证、配置解析与安全错误分类
语言工具	@axewo/fin-core/locale	语言标识规范化、词条合并、翻译回调
权限工具	@axewo/fin-core/permission	单个、任意、全部权限判断

根入口继续汇总以上工具；仅需要某类工具时直接从分类入口导入。类型随工具模块导出，不再提供集中堆放业务模型的 /types 入口。

import { moneyAdd, checkDebitCreditBalance } from '@axewo/fin-core/utils'
import type { DebitCreditEntry, BalanceCheckResult } from '@axewo/fin-core/utils'

const entries: readonly DebitCreditEntry[] = [
  { debitAmount: moneyAdd(0.1, 0.2), creditAmount: 0.3 },
]
const result: BalanceCheckResult = checkDebitCreditBalance(entries)
// { totalDebit: 0.3, totalCredit: 0.3, difference: 0, isBalanced: true }

文档导航

• 基础工具：金额、日期、数组、对象、字符串、函数、树、校验。
• 请求工具：Fetch、Axios、认证请求、配置与错误。
• 语言工具：基础函数与 fin-locale 接入。
• 权限工具：纯判断与 fin-micro 集成。
• 升级说明：职责调整与迁移。

包的职责

core 不管理登录页、菜单、用户状态、Vue 响应式或路由跳转。语言包和 Vue 国际化实例由 fin-locale 维护；微前端会话、权限 Hook 与路由守卫由 fin-micro 维护；业务模型、税率政策和状态色值由业务应用维护。

语言标识与词条合并由 fin-locale 复用 core 的实现，权限判断由 fin-micro SDK 复用 core 的实现。应用无需再复制一套公共方法。