Cấu hình và trình cắm ^2.3.0 ​

Phần này giới thiệu tính năng cấu hình và trình cắm của iztro. Tử Vi Đẩu Số（紫微斗數） có nhiều trường phái, với những khác biệt nhỏ về tứ hóa（四化） và độ sáng sao（星曜亮度）. Để đáp ứng các khác biệt ấy và cho phép mở rộng chức năng, iztro bổ sung cấu hình toàn cục và trình cắm của bên thứ ba từ v2.3.0.

Cấu hình ​

Xem Định nghĩa cấu hình để biết các tùy chọn. Để đặt cấu hình toàn cục, chỉ cần gọi astro.config() trước phương thức tạo lá số:

import { astro } from 'iztro';

astro.config({
  mutagens: { 庚: ['太阳', '武曲', '天同', '天相'] },
  brightness: {
    贪狼: ['旺', '旺', '旺', '旺', '旺', '旺', '旺', '旺', '旺', '旺', '旺', '旺'],
  },
});

Khi tạo lá số sau khi chạy đoạn mã trên, các giá trị cấu hình mới được hợp nhất với cấu hình mặc định rồi áp dụng. Những giá trị giống mặc định không cần khai báo lại. Xem Bảng tứ hóa theo mười thiên can（十天干四化表） và Bảng độ sáng sao（星曜亮度表） để biết các giá trị mặc định.

Ngoài mutagens và brightness, các tùy chọn sau cho phép điều chỉnh quy tắc tính toán lá số:

getConfig() ^2.3.0 ​

• Mục đích

  Lấy cấu hình toàn cục đang có hiệu lực. mutagens và brightness được trả về sử dụng tên khóa được chuẩn hóa trong thư viện, phù hợp để gỡ lỗi hoặc xác nhận trạng thái cấu hình.

  ^2.6.2 Giá trị trả về là một bản sao sâu độc lập. Sửa đối tượng hoặc các mảng tứ hóa và độ sáng bên trong không làm thay đổi cấu hình của thư viện.

• Định nghĩa

  ts

  type getConfig = () => {
    mutagens: Partial<Record<HeavenlyStemKey, StarKey[]>>;
    brightness: Partial<Record<StarKey, BrightnessKey[]>>;
    yearDivide: 'normal' | 'exact';
    ageDivide: 'normal' | 'birthday';
    dayDivide: 'current' | 'forward';
    horoscopeDivide: 'normal' | 'exact';
    algorithm: 'default' | 'zhongzhou';
  };

• Tham số

  Không có

• Giá trị trả về

  Đối tượng cấu hình hiện có hiệu lực

• Ví dụ

  ts

  import { astro } from 'iztro';
  
  astro.config({ algorithm: 'zhongzhou', ageDivide: 'birthday' });
  
  const currentConfig = astro.getConfig();

resetConfig() ^2.6.2 ​

Khôi phục cấu hình mặc định và xóa mọi bảng tứ hóa（四化） và độ sáng tùy chỉnh. Các lá số đã tạo không bị ảnh hưởng.

type resetConfig = () => void;

Các quy tắc phân chia mặc định là yearDivide: 'normal', horoscopeDivide: 'normal', ageDivide: 'normal' và dayDivide: 'forward'; thuật toán an sao mặc định là algorithm: 'default'. Phương thức này không nhận đối số và không trả về giá trị. Nó không đặt lại các trình cắm đã nạp.

const chart = astro.withOptions({
  dateStr: '2000-8-16',
  timeIndex: 3,
  gender: '男',
  config: { ageDivide: 'birthday' },
});
astro.resetConfig();
chart.horoscope('2026-3-1'); // 仍使用该星盘生成时的生日分界配置

Trình cắm ​

Trình cắm của iztro là một hàm bổ sung chức năng cho đối tượng lá số（星盤）. Bạn có thể mở rộng chức năng theo nhu cầu. Nếu dùng TypeScript, hãy khai báo các phương thức của trình cắm trong một giao diện kế thừa FunctionalAstrolabe.

Giao diện được khai báo như sau:

export interface IAstrolabe extends FunctionalAstrolabe {
  myNewFunc: () => string;
  majorStar: () => string;
}

Bạn có thể định nghĩa myNewFunc và majorStar theo nhu cầu. Các phương thức của giao diện có thể được triển khai trong một hàm trình cắm duy nhất hoặc chia ra nhiều hàm trình cắm:

// 创建一个插件函数
export function myTestPlugin(this: IAstrolabe): void {
  // 实现插件应用逻辑
  this.myNewFunc = () => {
    return this.fiveElementsClass;
  };
}

// 创建二个插件函数
export function myTestPlugin2(this: IAstrolabe): void {
  // 实现插件应用逻辑
  this.majorStar = () => {
    let stars = this.palace('命宫')
      ?.majorStars.filter((item) => item.type === 'major' && !['禄存', '天马'].includes(item.name))
      .map((item) => item.name)
      .join(',');

    if (!stars) {
      stars = this.palace('迁移')
        ?.majorStars.filter((item) => item.type === 'major' && !['禄存', '天马'].includes(item.name))
        .map((item) => item.name)
        .join(',');
    }

    return stars ?? '';
  };
}

Để đăng ký trình cắm, hãy nhập astro rồi gọi loadPlugin() hoặc loadPlugins(). Trình cắm đăng ký bằng cả hai cách đều được áp dụng cho các đối tượng lá số được tạo mới sau đó.

import {astro} from iztro;

// 批量挂载插件
astro.loadPlugins([myTestPlugin， myTestPlugin2]);

// 逐个加载插件
astro.loadPlugin(myTestPlugin);
astro.loadPlugin(myTestPlugin2);

Để chỉ áp dụng trình cắm cho một lá số（星盤） đã tạo cụ thể, hãy gọi phương thức use() của đối tượng lá số đó:

const astrolabe = astro.bySolar<IAstrolabe>('2023-10-18', 4, 'female');

astrolabe.use(myTestPlugin);
astrolabe.myNewFunc();

const astrolabe = astro.bySolar<IAstrolabe>('2023-10-18', 4, 'female');

 // 使用插件定义的方法
 astrolabe.myNewFunc();   // 火六局

 // 使用第二个插件方法
 astrolabe.majorStar();   // 七杀