@gaias/client_node 1.0.14 → 1.0.18

package/.npmrc.example

@@ -0,0 +1,14 @@
+# NPM Registry Configuration Example
+# Copy this file to .npmrc and replace YOUR_GITHUB_TOKEN with your actual token
+
+# Default registry for all packages
+registry=https://registry.npmjs.org/
+
+# GitHub Packages registry for @sight-saber scope
+@sight-saber:registry=https://npm.pkg.github.com/
+@gaias:registry=https://registry.npmjs.org/
+
+# Authentication token for GitHub Packages
+# Generate a personal access token at: https://github.com/settings/tokens
+# Required scopes: read:packages, write:packages
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN

package/CONFIG.md

@@ -0,0 +1,608 @@
+# 项目配置文件详解
+
+本文档详细说明 `@gaias/client_node` 项目中所有配置文件的用途和配置项。
+
+## 📦 目录
+
+- [package.json - 项目元数据与依赖管理](#packagejson)
+- [tsconfig.json - TypeScript 编译配置](#tsconfigjson)
+- [eslint.config.js - 代码质量检查配置](#eslintconfigjs)
+- [jest.config.js - 测试框架配置](#jestconfigjs)
+- [.prettierrc.json - 代码格式化配置](#prettierrrcjson)
+- [.ctirc - 索引文件自动生成配置](#ctirc)
+
+---
+
+## package.json
+
+### 基本信息
+
+```json
+{
+  "name": "@gaias/client_node",
+  "version": "1.0.6",
+  "description": "store data in cookie and localstorage",
+  "main": "dist/single/index.js",
+  "types": "dist/single/index.d.ts",
+  "license": "UNLICENSED"
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `name` | NPM 包名，使用 `@gaias` 命名空间 |
+| `version` | 当前版本号，遵循语义化版本 (Semver) |
+| `description` | 包描述 |
+| `main` | CommonJS 入口文件 |
+| `types` | TypeScript 类型定义文件入口 |
+| `license` | 许可证类型 |
+
+### 发布配置
+
+```json
+{
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}
+```
+
+- `access`: `public` - 公开发布包
+- `registry`: NPM 官方仓库地址
+
+### 关键词
+
+```json
+{
+  "keywords": [
+    "restclient",
+    "globalstorage",
+    "messageclient",
+    "configclient"
+  ]
+}
+```
+
+用于 NPM 搜索的关键词，提高包的可发现性。
+
+### 引擎要求
+
+```json
+{
+  "engines": {
+    "node": ">=18.0.0",
+    "yarn": ">=1.22.x"
+  }
+}
+```
+
+指定项目运行所需的最低 Node.js 和 Yarn 版本。
+
+### NPM Scripts
+
+#### 构建相关
+
+| Script | 命令 | 说明 |
+|--------|------|------|
+| `ncc:build` | `ncc build ./src/index.ts -m -o ./dist/single -e sqlite3 --no-source-map-register && ncc cache clean` | 使用 `@vercel/ncc` 将代码打包成单文件，排除 sqlite3 依赖 |
+| `prepub` | `rimraf dist && mkdir dist && tsc && mv temp/* dist/ && rimraf temp` | 发布前准备：清理构建目录、运行 TypeScript 编译、移动产物 |
+
+**prepub 命令详解**:
+1. `rimraf dist` - 删除现有的 dist 目录
+2. `mkdir dist` - 创建新的 dist 目录
+3. `tsc` - 使用 TypeScript 编译器编译（输出到 temp 目录）
+4. `mv temp/* dist/` - 将编译产物从 temp 移动到 dist
+5. `rimraf temp` - 删除临时目录
+
+#### 开发相关
+
+| Script | 命令 | 说明 |
+|--------|------|------|
+| `dev` | `http-server` | 启动本地开发服务器 |
+| `upver` | `ncu -u && yarn install` | 更新所有依赖到最新版本 |
+| `gen:idx` | `cti create ./src` | 自动生成 src 目录的 index.ts 文件 |
+
+#### 测试相关
+
+| Script | 命令 | 说明 |
+|--------|------|------|
+| `test` | `jest` | 运行 Jest 测试套件 |
+
+#### 代码质量
+
+| Script | 命令 | 说明 |
+|--------|------|------|
+| `lint` | `tsc --noEmit && eslint . --ext .ts` | 运行类型检查和 ESLint 检查 |
+| `lint:fix` | `eslint . --ext .ts --fix` | 自动修复 ESLint 问题 |
+| `precommit` | `yarn lint` | 提交前运行 lint 检查 |
+
+#### 安全审计
+
+| Script | 命令 | 说明 |
+|--------|------|------|
+| `security` | `yarn audit` | 运行完整的依赖安全审计 |
+| `security:summary` | `yarn audit --summary` | 显示安全审计摘要 |
+| `security:json` | `yarn audit --json` | 以 JSON 格式输出审计结果 |
+| `security:check` | `node tools/security-check.js` | 自定义安全检查脚本 |
+
+### 依赖说明
+
+#### 核心运行时依赖
+
+| 依赖 | 版本 | 说明 |
+|------|------|------|
+| `axios` | ^1.12.2 | HTTP 客户端 |
+| `cls-hooked` | ^4.2.2 | 异步上下文管理 |
+| `dot-object` | ^2.1.5 | 对象路径操作工具 |
+| `eventemitter3` | ^5.0.1 | 事件发射器 |
+| `ioredis` | ^5.8.2 | Redis 客户端 |
+| `js-cookie` | ^3.0.5 | Cookie 操作库 |
+| `js-yaml` | ^4.1.0 | YAML 解析器 |
+| `jsonata` | ^2.1.0 | JSON 查询和转换 |
+| `lodash` | ^4.17.21 | 工具函数库 |
+| `mustache` | ^4.2.0 | 模板引擎 |
+| `storage-manager-js` | ^4.2.6 | 存储管理 |
+| `store2` | ^2.14.4 | 本地存储封装 |
+| `typedi` | ^0.10.0 | 依赖注入容器 |
+| `whatwg-url` | ^15.1.0 | URL 解析 |
+
+#### 开发依赖
+
+主要包括：
+- TypeScript 相关工具链
+- ESLint 及插件
+- Jest 测试框架
+- Prettier 代码格式化
+- @vercel/ncc 打包工具
+
+---
+
+## tsconfig.json
+
+TypeScript 编译器配置文件。
+
+### 编译选项
+
+```json
+{
+  "compilerOptions": {
+    "outDir": "temp",
+    "target": "ES2021",
+    "module": "CommonJS"
+  }
+}
+```
+
+#### 基础配置
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `outDir` | `"temp"` | 编译输出目录（由 prepub 脚本移动到 dist） |
+| `target` | `"ES2021"` | 编译目标 JavaScript 版本 |
+| `module` | `"CommonJS"` | 模块系统类型 |
+| `lib` | `["ES2021"]` | 可用的库文件 |
+| `moduleResolution` | `"node"` | Node.js 风格的模块解析 |
+
+#### 严格模式选项
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `strict` | `true` | 启用所有严格类型检查选项 |
+| `noImplicitAny` | `true` | 禁止隐式 any 类型 |
+| `strictPropertyInitialization` | `false` | 关闭类属性必须初始化的检查 |
+| `forceConsistentCasingInFileNames` | `true` | 强制文件名大小写一致 |
+
+#### 互操作性选项
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `esModuleInterop` | `true` | 允许 CommonJS 和 ES 模块互操作 |
+| `allowSyntheticDefaultImports` | `true` | 允许从没有默认导出的模块导入默认值 |
+| `resolveJsonModule` | `true` | 允许导入 JSON 文件 |
+
+#### 装饰器支持
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `experimentalDecorators` | `true` | 启用实验性装饰器语法 |
+| `emitDecoratorMetadata` | `true` | 为装饰器生成元数据（TypeDI 需要） |
+
+#### 类型声明
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `declaration` | `true` | 生成 .d.ts 类型声明文件 |
+| `declarationMap` | `true` | 生成声明文件的 source map |
+
+#### 调试与优化
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `sourceMap` | `true` | 生成 source map 文件 |
+| `removeComments` | `true` | 移除编译后的注释 |
+| `skipLibCheck` | `true` | 跳过声明文件的类型检查（加快编译） |
+
+#### 路径映射
+
+```json
+{
+  "paths": {
+    "@/*": ["src/*"]
+  },
+  "baseUrl": "."
+}
+```
+
+允许使用 `@/` 作为 `src/` 的别名。
+
+#### 类型声明
+
+```json
+{
+  "types": ["node", "jest"]
+}
+```
+
+包含 Node.js 和 Jest 的类型定义。
+
+### 包含与排除
+
+```json
+{
+  "include": [
+    "src/**/*",
+    "example/**/*",
+    "tools/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "temp",
+    "dist",
+    "**/*.spec.ts",
+    "**/*.test.ts"
+  ]
+}
+```
+
+- **include**: 编译 src、example 和 tools 目录
+- **exclude**: 排除 node_modules、构建产物和测试文件
+
+---
+
+## eslint.config.js
+
+ESLint 9.x 新版扁平化配置格式。
+
+### 配置结构
+
+项目使用多配置策略，针对不同目录应用不同的规则：
+
+#### 1. 忽略文件
+
+```javascript
+{
+  ignores: [
+    '**/node_modules/**',
+    '**/temp/**',
+    '**/dist/**',
+    '**/*.js',
+    '**/*.d.ts',
+  ]
+}
+```
+
+排除不需要检查的文件和目录。
+
+#### 2. src/ 和 example/ 目录配置
+
+**特点**: 启用类型感知的 lint 规则
+
+```javascript
+{
+  files: ['src/**/*.ts', 'example/**/*.ts'],
+  languageOptions: {
+    parser: tsParser,
+    parserOptions: {
+      project: './tsconfig.json'  // 使用项目配置进行类型检查
+    }
+  }
+}
+```
+
+**启用的类型感知规则**:
+- `@typescript-eslint/no-floating-promises`: 'warn' - 警告未处理的 Promise
+- `@typescript-eslint/await-thenable`: 'warn' - 避免 await 非 thenable 对象
+- `@typescript-eslint/no-misused-promises`: 'warn' - Promise 误用检查
+
+#### 3. tools/ 目录配置
+
+**特点**: 不启用类型检查（提高性能）
+
+```javascript
+{
+  files: ['tools/**/*.ts'],
+  languageOptions: {
+    parserOptions: {
+      // ✅ 不使用 project，避免解析错误
+    }
+  }
+}
+```
+
+#### 4. __tests__ 目录配置
+
+**特点**: 测试文件专用配置
+
+### 通用规则设置
+
+| 规则 | 设置 | 说明 |
+|------|------|------|
+| `@typescript-eslint/no-require-imports` | off | 允许使用 require() |
+| `@typescript-eslint/no-var-requires` | off | 允许 require 赋值给变量 |
+| `@typescript-eslint/explicit-function-return-type` | off | 不强制函数返回类型声明 |
+| `@typescript-eslint/no-explicit-any` | off | 允许使用 any 类型 |
+| `@typescript-eslint/no-unused-vars` | off | 不检查未使用变量 |
+| `no-console` | off | 允许使用 console |
+| `lines-between-class-members` | warn | 类成员之间需要空行 |
+
+---
+
+## jest.config.js
+
+Jest 测试框架配置。
+
+```javascript
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    setupFiles: ['reflect-metadata'],
+};
+```
+
+### 配置说明
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `preset` | `'ts-jest'` | 使用 ts-jest 预设，支持 TypeScript |
+| `testEnvironment` | `'node'` | 在 Node.js 环境中运行测试 |
+| `setupFiles` | `['reflect-metadata']` | 测试前加载 reflect-metadata（装饰器元数据支持） |
+
+### 使用方式
+
+```bash
+# 运行所有测试
+yarn test
+
+# 运行特定测试文件
+yarn test path/to/test.spec.ts
+```
+
+---
+
+## .prettierrc.json
+
+Prettier 代码格式化配置。
+
+```json
+{
+    "semi": true,
+    "trailingComma": "all",
+    "singleQuote": true,
+    "printWidth": 220,
+    "tabWidth": 4,
+    "arrowParens": "always"
+}
+```
+
+### 配置说明
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `semi` | `true` | 语句末尾添加分号 |
+| `trailingComma` | `"all"` | 在所有可能的地方添加尾随逗号 |
+| `singleQuote` | `true` | 使用单引号而非双引号 |
+| `printWidth` | `220` | 单行最大字符数（较宽） |
+| `tabWidth` | `4` | 缩进宽度为 4 个空格 |
+| `arrowParens` | `"always"` | 箭头函数参数始终使用括号 |
+
+### 格式化示例
+
+**Before:**
+```typescript
+const foo = (x) => {return x + 1}
+const obj = {a: 1, b: 2}
+```
+
+**After:**
+```typescript
+const foo = (x) => {
+    return x + 1;
+};
+const obj = { a: 1, b: 2 };
+```
+
+---
+
+## .ctirc
+
+`create-ts-index` (cti) 工具配置，用于自动生成 TypeScript 索引文件。
+
+### 配置说明
+
+```json
+{
+  "fileFirst": false,
+  "addNewline": true,
+  "useSemicolon": true,
+  "useTimestamp": false,
+  "includeCWD": true,
+  "excludes": ["__test__", "__tests__", "node_modules", "tools"],
+  "fileExcludePatterns": ["*excludeme.ts"],
+  "targetExts": ["ts", "tsx"],
+  "withoutBackupFile": true,
+  "quote": "'",
+  "verbose": false
+}
+```
+
+| 选项 | 值 | 说明 |
+|------|-----|------|
+| `fileFirst` | `false` | 不优先导出文件 |
+| `addNewline` | `true` | 文件末尾添加换行符 |
+| `useSemicolon` | `true` | 导出语句添加分号 |
+| `useTimestamp` | `false` | 不在注释中添加时间戳 |
+| `includeCWD` | `true` | 包含当前工作目录 |
+| `excludes` | `[...]` | 排除的目录 |
+| `targetExts` | `["ts", "tsx"]` | 目标文件扩展名 |
+| `withoutBackupFile` | `true` | 不创建备份文件 |
+| `quote` | `"'"` | 使用单引号 |
+| `verbose` | `false` | 不显示详细日志 |
+
+### 使用方式
+
+```bash
+# 生成 src 目录的 index.ts
+yarn gen:idx
+```
+
+### 生成示例
+
+对于目录结构：
+```
+src/
+  ├── foo.ts
+  ├── bar.ts
+  └── utils/
+      └── helper.ts
+```
+
+生成的 `src/index.ts`:
+```typescript
+export * from './foo';
+export * from './bar';
+export * from './utils/helper';
+```
+
+---
+
+## 构建流程
+
+### 完整发布流程
+
+1. **清理旧构建**:   `rimraf dist`
+2. **创建目录**:     `mkdir dist`
+3. **TypeScript 编译**: `tsc` (输出到 temp)
+4. **移动产物**: `mv temp/* dist/`
+5. **清理临时文件**: `rimraf temp`
+6. **单文件打包**: `yarn ncc:build` (可选)
+
+### 输出结构
+
+```
+dist/
+  ├── index.js          # CommonJS 主入口
+  ├── index.d.ts        # 类型定义
+  ├── index.d.ts.map    # 类型定义 source map
+  └── ...               # 其他编译产物
+
+dist/single/
+  └── index.js          # NCC 打包的单文件 (包含所有依赖)
+```
+
+---
+
+## 最佳实践
+
+### 开发工作流
+
+1. **启动开发**: `yarn dev`
+2. **自动生成索引**: `yarn gen:idx`
+3. **代码检查**: `yarn lint`
+4. **运行测试**: `yarn test`
+5. **发布前构建**: `yarn prepub`
+
+### 版本发布
+
+```bash
+# 1. 更新版本号
+npm version patch  # 或 minor/major
+
+# 2. 构建
+yarn prepub
+
+# 3. 发布到 NPM
+npm publish --access public
+
+# 4. 推送标签
+git push origin main --follow-tags
+```
+
+详细发布流程请参考 [PUBLISHING.md](./PUBLISHING.md)。
+
+### 依赖更新
+
+```bash
+# 检查可更新的依赖
+ncu
+
+# 更新所有依赖
+yarn upver
+
+# 安全审计
+yarn security
+```
+
+---
+
+## 故障排除
+
+### TypeScript 编译错误
+
+```bash
+# 只进行类型检查，不生成文件
+yarn lint
+
+# 查看详细错误信息
+tsc --noEmit
+```
+
+### ESLint 配置问题
+
+- **错误**: "Parsing error: Cannot read file 'tsconfig.json'"
+  - **解决**: 确保 `tsconfig.json` 在项目根目录
+  - **说明**: tools 和 __tests__ 目录不需要 project 配置
+
+### 构建产物问题
+
+```bash
+# 清理所有构建产物
+rimraf dist temp
+
+# 重新构建
+yarn prepub
+```
+
+### Jest 测试失败
+
+- **错误**: "Cannot find module 'reflect-metadata'"
+  - **解决**: 确保 `setupFiles` 包含 'reflect-metadata'
+  - **说明**: TypeDI 装饰器需要元数据反射支持
+
+---
+
+## 相关文档
+
+- [发布指南](./PUBLISHING.md)
+- [TypeScript 官方文档](https://www.typescriptlang.org/tsconfig)
+- [ESLint 配置文档](https://eslint.org/docs/latest/use/configure/)
+- [Jest 配置文档](https://jestjs.io/docs/configuration)
+- [Prettier 配置文档](https://prettier.io/docs/en/options.html)
+
+---
+
+## 更新日志
+
+| 日期 | 版本 | 说明 |
+|------|------|------|
+| 2025-10-23 | 1.0.0 | 初始版本 |

package/PUBLISHING.md

@@ -0,0 +1,170 @@
+# 发布指南 / Publishing Guide
+
+本文档说明如何将 `@gaias/client_node` 包发布到 npmjs.org 和 GitHub Packages。
+
+## 前置要求
+
+### 1. npmjs.org 配置
+
+1. 在 npmjs.org 注册账号并创建访问令牌：
+   - 访问 https://www.npmjs.com/settings/[你的用户名]/tokens
+   - 点击 "Generate New Token" → "Classic Token"
+   - 选择 "Automation" 类型
+   - 复制生成的 token
+
+2. 在 GitHub 仓库中添加 Secret：
+   - 进入仓库的 Settings → Secrets and variables → Actions
+   - 点击 "New repository secret"
+   - Name: `NPM_TOKEN`
+   - Value: 粘贴你的 npm token
+   - 点击 "Add secret"
+
+### 2. GitHub Packages 配置
+
+GitHub Packages 使用仓库的 `GITHUB_TOKEN`，这个 token 会自动提供给 GitHub Actions，无需手动配置。
+
+## 自动发布流程
+
+### 触发方式
+
+工作流会在以下情况下自动触发：
+
+1. **推送到 main 分支**
+   ```bash
+   git push origin main
+   ```
+
+2. **创建版本标签**
+   ```bash
+   git tag v1.0.2
+   git push origin v1.0.2
+   ```
+
+3. **发布 Release**
+   - 在 GitHub 仓库页面创建新的 Release
+
+4. **手动触发**
+   - 进入 Actions 标签页
+   - 选择 "Publish npm Package" 工作流
+   - 点击 "Run workflow"
+
+### 发布步骤
+
+工作流会自动执行以下步骤：
+
+1. 检出代码
+2. 安装依赖
+3. 运行 linter（可选）
+4. 运行测试（可选）
+5. 构建包（`yarn ncc:build` 和 `yarn prepub`）
+6. 发布到 npmjs.org（使用 `@gaias/client_node` 包名）
+7. 发布到 GitHub Packages（使用 `@sight-saber/client_node` 包名）
+
+## 包版本管理
+
+在发布前，请更新 `package.json` 中的版本号：
+
+```bash
+# 补丁版本（bug 修复）
+npm version patch  # 1.0.1 → 1.0.2
+
+# 次要版本（新功能）
+npm version minor  # 1.0.2 → 1.1.0
+
+# 主要版本（破坏性更改）
+npm version major  # 1.1.0 → 2.0.0
+```
+
+然后推送更改和标签：
+
+```bash
+git push origin main --follow-tags
+```
+
+## 安装已发布的包
+
+### 从 npmjs.org 安装
+
+```bash
+npm install @gaias/client_node
+# 或
+yarn add @gaias/client_node
+```
+
+### 从 GitHub Packages 安装
+
+1. 创建或编辑 `.npmrc` 文件（参考 `.npmrc.example`）：
+   ```
+   @sight-saber:registry=https://npm.pkg.github.com
+   //npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+   ```
+
+2. 安装包：
+   ```bash
+   npm install @sight-saber/client_node
+   # 或
+   yarn add @sight-saber/client_node
+   ```
+
+## 本地测试发布
+
+在推送之前，可以本地测试构建流程：
+
+```bash
+# 运行 linter
+yarn lint
+
+# 运行测试
+yarn test
+
+# 构建包
+yarn ncc:build
+yarn prepub
+
+# 检查构建产物
+ls -la dist/
+```
+
+## 故障排除
+
+### NPM_TOKEN 无效
+
+- 确认 token 类型为 "Automation"
+- 确认 token 有 "Publish" 权限
+- 在 GitHub Secrets 中重新设置 token
+
+### GitHub Packages 发布失败
+
+- 确认仓库 owner 是 `sight-saber`
+- 确认工作流有 `packages: write` 权限
+- 检查 package.json 中的包名 scope 是否正确
+
+### 构建失败
+
+- 检查 linter 错误：`yarn lint`
+- 检查测试失败：`yarn test`
+- 检查构建错误：`yarn ncc:build` 和 `yarn prepub`
+
+## 手动发布（不推荐）
+
+如果需要手动发布，可以使用以下命令：
+
+```bash
+# 构建
+yarn ncc:build
+yarn prepub
+
+# 发布到 npmjs.org
+npm publish --access public
+
+# 发布到 GitHub Packages（需要先设置 .npmrc）
+npm publish --registry=https://npm.pkg.github.com
+```
+
+## 相关链接
+
+- [npmjs.org 包页面](https://www.npmjs.com/package/@gaias/client_node)
+- [GitHub Packages](https://github.com/sight-saber/client_node/packages)
+- [GitHub Actions 工作流](.github/workflows/npm-publish-github-packages.yml)
+- [npm 文档](https://docs.npmjs.com/)
+- [GitHub Packages 文档](https://docs.github.com/en/packages)

package/config/CommonParam.yaml

@@ -0,0 +1,2 @@
+test: 1
+abc: defg

package/config/RestClientA.yaml

@@ -0,0 +1,5 @@
+example:
+  ipify1: "{{staticParam}}/{{file}}?{{abc}}"
+  ipify2:
+    method: get # default value is get if remove method define.
+    endPoint: "{{staticParam}}/{{file}}"

package/config/RestClientB.yaml

@@ -0,0 +1,8 @@
+mo:
+  userservice:
+    test3:
+      method: "get" # default value is get if remove method define.
+      endPoint: "{{baseURL}}?format={{format}}"
+    test4:
+      method: "get" # default value is get if remove method define.
+      endPoint: "{{baseURL}}?format={{format}}"

package/eslint.config.js

@@ -0,0 +1,141 @@
+// eslint.config.js
+const js = require('@eslint/js');
+const tsPlugin = require('@typescript-eslint/eslint-plugin');
+const tsParser = require('@typescript-eslint/parser');
+const globals = require('globals');
+
+module.exports = [
+  {
+    ignores: [
+      '**/node_modules/**',
+      '**/temp/**',
+      '**/dist/**',
+      '**/*.js',
+      '**/*.d.ts',
+    ],
+  },
+  
+  js.configs.recommended,
+  
+  // 配置 1: src/ 和 example/ 目录（需要类型检查）
+  {
+    files: ['src/**/*.ts', 'example/**/*.ts'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2018,
+        sourceType: 'module',
+        project: './tsconfig.json',  // 使用项目配置
+      },
+      globals: {
+        ...globals.node,
+        ...globals.es6,
+        NodeJS: 'readonly',
+        Atomics: 'readonly',
+        SharedArrayBuffer: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      '@typescript-eslint/no-require-imports': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/ban-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      // 新增推荐规则 / New recommended rules
+      '@typescript-eslint/no-floating-promises': 'warn',  // 警告未处理的 Promise
+      '@typescript-eslint/await-thenable': 'warn',        // 避免 await 非 thenable
+      '@typescript-eslint/no-misused-promises': 'warn',   // Promise 误用检查
+      'no-console': 'off', // 允许使用 console（生产环境可以考虑启用）
+      'lines-between-class-members': ['warn', 'always'],
+      'no-undef': 'off',
+    },
+  },
+  
+  // 配置 2: tools/ 目录（不需要类型检查）
+  {
+    files: ['tools/**/*.ts'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2018,
+        sourceType: 'module',
+        // ✅ 不使用 project，避免解析错误
+      },
+      globals: {
+        ...globals.node,
+        ...globals.es6,
+        NodeJS: 'readonly',
+        Atomics: 'readonly',
+        SharedArrayBuffer: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      '@typescript-eslint/no-require-imports': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/ban-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      // 注意：tools/ 目录不启用需要类型信息的规则
+      // Note: Type-aware rules are not enabled for tools/ directory
+      'no-console': 'off',  // tools 目录允许使用 console
+      'lines-between-class-members': ['warn', 'always'],
+      'no-undef': 'off',
+    },
+  },
+
+  // 配置 3: __tests__ 目录（不需要类型检查）
+  {
+    files: ['__tests__/**/*.ts'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2018,
+        sourceType: 'module',
+        // ✅ 不使用 project，避免解析错误
+      },
+      globals: {
+        ...globals.node,
+        ...globals.es6,
+        NodeJS: 'readonly',
+        Atomics: 'readonly',
+        SharedArrayBuffer: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      '@typescript-eslint/no-require-imports': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/ban-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      // 注意：测试目录不启用需要类型信息的规则
+      // Note: Type-aware rules are not enabled for test directory
+      'no-console': 'off',  // 测试目录允许使用 console
+      'lines-between-class-members': ['warn', 'always'],
+      'no-undef': 'off',
+    },
+  },
+];

package/package.json

@@ -1,10 +1,14 @@
 {
     "name": "@gaias/client_node",
-    "version": "1.0.14",
+    "version": "1.0.18",
     "description": "store data in cookie and localstorage",
     "main": "dist/single/index.js",
     "types": "dist/single/index.d.ts",
     "license": "UNLICENSED",
+    "repository": {
+       "type": "git",
+       "url": "git+https://github.com/sight-saber/client_node.git"
+     },
     "publishConfig": {
         "access": "public",
         "registry": "https://registry.npmjs.org/"
@@ -19,10 +23,6 @@
         "node": ">=18.0.0",
         "yarn": ">=1.22.x"
     },
-    "files": [
-    "dist",
-    "README.md"
-  ],
     "scripts": {
         "//===ncc build===": "",
         "ncc:build": "ncc build ./src/index.ts -m -o ./dist/single -e sqlite3 --no-source-map-register && ncc cache clean",
@@ -42,7 +42,9 @@
         "security:summary": "yarn audit --summary",
         "security:json": "yarn audit --json",
         "security:check": "node tools/security-check.js",
-        "precommit": "yarn lint"
+        "//===publish===": "",
+        "precommit": "yarn lint",
+        "build:publish": "npm run gen:idx && rimraf dist && mkdir dist && tsc && mv temp/* dist/ && rimraf temp"
     },
     "devDependencies": {
         "@eslint/js": "^9.38.0",