README.md（精簡中文）

# lifeq-score

把人生各面向（財富、人脈、聲譽、身心、技能、時間、影響、親密）量化成 **0~120** 分，並匯總為 LIFE‑Q。

## 安裝

```bash
npm i @your-scope/lifeq-score

快速開始（Node / ESM）

import { computeLifeQ, PRESET_PILLARS, PRESET_METRICS } from '@your-scope/lifeq-score';

const input = { wealth: { runway_months: 6, savings_rate_pct: 28 } };
const res = computeLifeQ(input);
console.log(res.lifeQ, res.pillars);

前端（React / Vite）

import { useMemo } from 'react';
import { computeLifeQ } from '@your-scope/lifeq-score';

export default function LifeQWidget({ data }) {
  const result = useMemo(() => computeLifeQ(data), [data]);
  return (
    <div>
      <h3>LIFE-Q：{result.lifeQ}</h3>
      <ul>
        {result.pillars.map(p => (
          <li key={p.key}>{p.name}：{p.score}</li>
        ))}
      </ul>
    </div>
  );
}

CLI

npx @your-scope/lifeq-score/cli -f data.json --metrics

自訂

• 改權重：傳入 options.pillars。
• 改指標/目標：傳入 options.metrics（或 fork 預設）。

公式

• 達標=100，超標線性加到 120。
• 上行指標：floor→target (0→100)；target→cap (100→120)。
• 下行指標：target→upper (100→0)；lower→target (120→100)。
• 支柱/總分：幾何平均。

免責聲明：僅供自我追蹤與行動輔助，非專業醫療或財務建議。