@klnpm/utils (1.0.2)

2026-08-03T16:48:42+08:00

Setup this registry in your project .npmrc file:

@klnpm:registry=

To install the package using npm, run the following command:

npm install @klnpm/utils@1.0.2

or add it to the package.json file:

"@klnpm/utils": "1.0.2"

For more information on the npm registry, see the documentation.

@klnpm/utils

klnpm 团队私有工具包，提供通用的格式化、时间、下载等工具函数。

下载（安装到项目）

1. 配置 Gitea 认证

在 Gitea 的 Settings → Applications → 生成 Personal Access Token，勾选 package 权限。

npm

# 设置 scope 专属 registry（推荐，不影响公共包下载）
npm config set @klnpm:registry=https://git.kldmp.com/api/packages/klnpm/npm/

# 设置 token
npm config set -- '//git.kldmp.com/api/packages/klnpm/npm/:_authToken' "你的token"

yarn v1

yarn config set @klnpm:registry https://git.kldmp.com/api/packages/klnpm/npm/
yarn config set '//git.kldmp.com/api/packages/klnpm/npm/:_authToken' "你的token"

yarn v2+ (Berry)

编辑 .yarnrc.yml：

npmScopes:
  klnpm:
    npmRegistryServer: "https://git.kldmp.com/api/packages/klnpm/npm/"
    npmAuthToken: "你的token"

token 存于 ~/.npmrc 或 .yarnrc.yml，只对当前用户可见，不要提交到代码仓库。

2. 安装

npm install @klnpm/utils

或：

yarn add @klnpm/utils

3. 使用

import { formatNoneValue, formatTimeToString, handleDownloadFile } from '@klnpm/utils'

formatNoneValue(1234.5678, 2)          // '1234.57'
formatTimeToString(new Date())          // '2026-05-22 14:30:00'
handleDownloadFile(blobData, '报表.xlsx')

开发（新增工具函数）

git clone <仓库地址>
cd klnpm-utils
npm install

配置发布权限

项目根目录新建 .npmrc，填入你的 token（不要提交到 git）：

//git.kldmp.com/api/packages/klnpm/npm/:_authToken=你的token

也可以写在全局 ~/.npmrc 里。

新增函数

在 src/ 下新建文件或直接在 src/index.ts 里加
从 src/index.ts 导出
npm run build 确认编译通过

发布

# 升版本（按需选择其一）
npm version patch   # 修复：1.0.0 → 1.0.1
npm version minor   # 新功能：1.0.0 → 1.1.0
npm version major   # 大改动：1.0.0 → 2.0.0

# 发布
npm publish

发布后可在 Gitea 仓库 → Packages 标签页查看。

删除

npm unpublish @klnpm/utils --registry=https://git.kldmp.com/api/packages/klnpm/npm/ --force

--force 是必须的，npm unpublish 默认仅允许删除 24 小时内发布的包，超时需要强制删除。

也可在 Gitea → Packages → @klnpm/utils → Settings → Delete 直接删除。

注意

.npmrc / .yarnrc.yml 中的 token 不要提交到 git
所有函数需保持浏览器环境兼容（使用了 Blob、document 等 DOM API）

Dependencies

ID	Version
dayjs	^1.11.20

Development Dependencies

ID	Version
@types/react	^19.2.17
typescript	^5.7.0

Details

npm

2026-08-03 16:48:42 +08:00

4

latest

16 KiB

Assets (1)

utils-1.0.2.tgz 16 KiB

Versions (2) View all

1.0.2

2026-08-03

1.0.1

2026-07-22