🌟 Enci Lite

輕量級智能核心 - 決策追蹤 · 智能預測 · 主動探索


---

📦 安裝

``bash
npm install @enci/lite
`

---

🚀 快速開始

$3

`typescript
import { EnciLite } from '@enci/lite';

// 初始化
const enci = new EnciLite({
dataPath: '.enci-lite-data.json',
enableMetaCognition: true,
enablePrediction: true,
enableCuriosity: true,
});

// 記錄用戶動作
enci.recordAction('chat', { message: '你好' });

// 記錄決策
enci.recordDecision('選擇方案', '方案A');

// 預測下一步動作
const prediction = enci.predictNextAction();
console.log('預測:', prediction);
// → { action: 'chat', confidence: 0.75, reasoning: '...' }

// 獲取探索建議
const suggestion = enci.suggestExploration();
console.log('建議:', suggestion?.message);
// → "老板，你知唔知我仲有 '語音輸入' 功能？要唔要試下？ 😎"

// 停止並保存
enci.stop();
`

---

🎯 核心功能

$3

追蹤決策與習慣分析

`typescript
// 記錄決策
enci.recordDecision('選擇框架', 'React');
enci.recordDecision('選擇框架', 'Vue');
enci.recordDecision('選擇框架', 'React'); // 又選咗 React

// 獲取習慣模式
const patterns = enci.getTopPatterns(5);
console.log(patterns);
// → [{ context: '選擇框架', decisions: ['React', 'Vue'], frequency: 3 }]
`

$3

預測用戶下一步動作

`typescript
// 記錄歷史動作
enci.recordAction('search', { query: '天氣' });
enci.recordAction('search', { query: '交通' });
enci.recordAction('search', { query: '天氣' });

// 預測下一步
const prediction = enci.predictNextAction();
console.log(prediction);
// → {
// action: 'search',
// confidence: 0.67,
// reasoning: '基於最近 5 次動作，檢測到 search 模式',
// suggestions: ['老板好耐冇同我傾計啦，有咩需要幫手？']
// }
`

$3

發現未使用的功能

`typescript
// 記錄已發現的功能
enci.recordFeatureDiscovery('語音輸入');
enci.recordFeatureDiscovery('快捷鍵操作');

// 獲取探索建議
const suggestion = enci.suggestExploration();
console.log(suggestion);
// → {
// type: 'feature',
// message: '老板，你知唔知我仲有 "自動翻譯" 功能？要唔要試下？ 😎',
// priority: 0.5,
// serendipity: 35
// }
`

---

⚙️ 配置選項

`typescript
interface EnciLiteConfig {
dataPath?: string; // 數據存儲路徑 (默認: '.enci-lite-data.json')
enableMetaCognition?: boolean; // 啟用決策追蹤 (默認: true)
enablePrediction?: boolean; // 啟用智能預測 (默認: true)
enableCuriosity?: boolean; // 啟用主動探索 (默認: true)
autoSave?: boolean; // 自動保存數據 (默認: true)
saveInterval?: number; // 自動保存間隔 ms (默認: 60000)
}
`

---

📊 統計信息

`typescript
const stats = enci.getStats();
console.log(stats);
// → {
// totalActions: 42,
// totalPatterns: 8,
// discoveredFeatures: 3,
// uptime: 1234567
// }
`

---

🎭 事件監聽

`typescript
enci.on('action:recorded', (action) => {
console.log('記錄動作:', action.type);
});

enci.on('decision:recorded', ({ context, decision }) => {
console.log('記錄決策:', context, '→', decision);
});

enci.on('feature:discovered', (feature) => {
console.log('發現功能:', feature);
});

enci.on('state:saved', () => {
console.log('狀態已保存');
});
`

---

🏗️ 整合到 Electron App

`javascript
const { EnciLite } = require('@enci/lite');

let enciLite;

// 啟動時初始化
app.on('ready', () => {
enciLite = new EnciLite({
dataPath: path.join(app.getPath('userData'), '.enci-lite.json'),
});
});

// 處理用戶消息
ipcMain.on('user-message', (event, message) => {
enciLite.recordAction('chat', { message });

// 獲取預測
const prediction = enciLite.predictNextAction();
if (prediction.confidence > 0.7) {
event.reply('suggestion', prediction.suggestions[0]);
}
});

// 關閉時保存
app.on('before-quit', () => {
enciLite.stop();
});
`

---

📈 性能指標

| 項目 | 指標 |
|------|------|
| CPU 消耗 | < 5% |
| Memory | < 50 MB |
| 響應時間 | < 100ms |
| 代碼量 | ~450 行 |

---

🔧 開發

`bash


安裝依賴

npm install

編譯

npm run build

測試

npm test

發布

npm publish
``

---

📝 授權

MIT © 鄧恩賜 (Enci)

---

🌟 特色

- ✅ 輕量級 - 只有 3 個核心引擎，代碼量 < 500 行
- ✅ 低資源消耗 - CPU < 5%，Memory < 50 MB
- ✅ 自動保存 - 自動持久化用戶數據
- ✅ 事件驅動 - 支持事件監聽
- ✅ TypeScript - 完整類型支持
- ✅ 即插即用 - 可整合到任何 Node.js / Electron 應用

---

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

---

由 鄧恩賜 (Enci) 用 ❤️ 打造