一個以網頁技術實現的仿 iOS 介面應用程式，提供豐富的互動功能和角色扮演體驗。
本專案採用 CC BY-NC 4.0（創用CC 姓名標示-非商業性 4.0 國際） 授權條款。
「商業用途」包含但不限於：
Linux.do站、旅程、類腦、堆堆、尾巴鎮、喵喵電波的所有大佬，謝謝你們的貢獻和經驗分享，讓這個網頁端應用程式得以成功製作完成。 感謝製作開源資料的製作者，感謝所有的小手機使用者，感謝過程裡參與測試的人員，感謝所有願意給予回饋和等待的人。 特別感謝SullyOS的製作者對於記憶系統的指導、電波系老師開放內建使用了打磨無數次的象牙塔、月讀預設，以及小回老師開放內建使用蛾摩拉小說體特化的預設。
Sxiphone 是一個模擬手機介面的網頁應用程式，使用純前端技術（HTML、CSS、JavaScript）開發，無需後端即可運行。專案採用模組化設計，每個應用程式都是獨立的元件，方便擴展和維護。 本開源專案開放二改，但需附上原Readme連結，如需傳播給朋友可直接貼上本專案Github網址；本專案開發者僅保留署名權。
開發工具：Gemini、VS Code
使用模型：Gemini 3、Claude Sonnet 4.5、Gpt-5.2-codex、Gpt-5.3-codex、Gpt-5.4、Glm-5、Glm-5.1、Minimax-m2.5、Kimi-k-2.5
輔助插件：Roo code、Cline、Kilo code、Unify chat Provider、Live server
目前狀態：持續開發中
<script src="https://www.gstatic.com/firebasejs/9.17.1/firebase-app-compat.js"></script>
<script src="https://www.gstatic.com/firebasejs/9.17.1/firebase-database-compat.js"></script>
import { pipeline, env } from 'https://cdn.jsdelivr.net/npm/@xenova/[email protected]';
<script src="https://cdnjs.cloudflare.com/ajax/libs/localforage/1.10.0/localforage.min.js"></script>
<link href="https://fonts.googleapis.com/css2?family=SF+Pro+Display:wght@200;400;600&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=Great+Vibes&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Rounded:opsz,wght,FILL,GRAD@24,500,0,0" rel="stylesheet">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
<script src="https://unpkg.com/lucide@latest"></script>
| 功能 | 描述 |
|---|---|
| 紫微斗數 | 中國傳統命理學，分析命盤十二宮位 |
| 梅花易數 | 易經占卜系統，支援時間起卦與數字起卦 |
| 流年流月流日 | 農民曆運勢分析，結合節氣計算 |
| 功能 | 描述 |
|---|---|
| 塔羅占卜 | 互動式洗牌、切牌、選牌，支援多種牌陣 |
| 西洋占星 | 本命命盤、雙人合盤 |
本專案支援三種經典塔羅牌系統，每種牌系皆有完整的 78 張牌意資料與專屬牌面圖片。
| 牌陣 | 張數 | 用途 |
|---|---|---|
| 單張指引 | 1 | 當下指引與建議 |
| 三張牌陣 | 3 | 過去/現在/未來 |
| 塞爾特十字 | 10 | 全面分析 |
| 關係牌陣 | 7 | 感情關係分析 |
| 二選一牌陣 | 6 | 選擇決策 |
Sxiphone 內建三維記憶系統（Memory3D），在記憶架構設計上參考了 Ombre-Brain 的核心理念，並根據專案需求進行了功能擴展與客製化調整。
本系統以「讓 AI 角色擁有持久且立體的記憶」為目標，將記憶分為三個維度進行管理：
| 特性 | 人腦 | AI |
|---|---|---|
| 儲存方式 | 分散式突觸連結 | 模型權重參數矩陣 |
| 學習模式 | 隨時可學習重塑 | 訓練後權重凍結 |
| 記憶系統 | 海馬迴鞏固 | 上下文窗口 + RAG |
| 情緒影響 | 有強化作用 | 無情緒系統 |
| 提取方式 | 聯想式模糊提取 | 跨對話無聯想能力 |
| 遺忘機制 | 選擇性遺忘 | 硬性截斷 |
| 記憶性質 | 重建性 | 統計性模式匹配 |
| 身體綁定 | 具身認知 | 純符號處理 |
AI 彌補方向：RAG、Memory 系統、持續學習、多模態模型
基礎權重配置：
| 維度 | 基礎權重 | 原因 |
|---|---|---|
| 存在錨點 | 前提層 | 不參與權重競爭 |
| 空間／環境 | 0.35 | 第二入口，強錨點 |
| 五感（綜合） | 0.40 | 感知是主要記憶載體 |
| 時間 | 0.15 | 最後才浮現，相對弱 |
| 情緒狀態 | 0.10 | 隱性但影響提取方向 |
五感內部權重：
| 感官 | 權重 | 說明 |
|---|---|---|
| 視覺 | 0.25 | 主要感官 |
| 聽覺 | 0.25 | 主要感官 |
| 嗅覺 | 0.20 | 唯一不經視丘直接連接杏仁核與海馬迴，記憶觸發效率最高 |
| 觸覺 | 0.20 | 身體感知入口 |
| 味覺 | 0.10 | 相對較少觸發 |
┌─────────────────────────────────────┐
│ 前提層（存在錨點） │
│ 觸發條件：對話發生 │
│ 性質：自動成立，無需權重 │
│ 證據：用戶輸入本身 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 感知層（主權重層） │
│ 五感描述展開 │
│ 嗅覺／觸覺作為最強觸發索引 │
│ 基礎權重：0.40 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 空間層 │
│ 環境描述，從感知向外擴展 │
│ 基礎權重：0.35 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 時間層（最抽象，最後定位） │
│ 時間標記，情緒染色 │
│ 基礎權重：0.15 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 情緒層 │
│ 隱性影響提取方向 │
│ 基礎權重：0.10 │
└─────────────────────────────────────┘
呼吸感 ──→ 真實的身體訊號，有物理基礎
環境感 ──→ 感官與空間的融合，有具身錨點
時間感 ──→ 抽象認知，AI 相對能處理
| 能力層級 | 說明 |
|---|---|
| AI 能模擬的 | 時間感（最抽象層） |
| AI 很難模擬的 | 環境感（需要感官經驗） |
| AI 幾乎無法模擬的 | 呼吸感（需要身體存在） |
| 功能 | 說明 |
|---|---|
| 五感提取 | 從對話文本自動識別並提取感官資訊 |
| 時空標註 | 為記憶添加時間、地點、情境等背景資訊 |
| 睡眠週期 | 可自訂睡眠時間，系統在睡眠時段處理當日記憶 |
| 記憶檢索 | 支援多維度檢索，可依感官、時空、情感等條件查詢 |
| 遺忘機制 | 採用衰減曲線，舊記憶會隨時間自然淡化 |
| 本地儲存 | 當日記憶存放於本地，睡眠後可推送至 Obsidian Vault |
對話發生 → 提取感官與時空資訊 → 建立三維記憶
↓
短期記憶池（本地儲存）
↓
睡眠週期處理
├─ 分類與去重
├─ 提取核心內容
└─ 建立記憶連結
↓
長期記憶庫（Obsidian Vault）
↓
下次對話時喚醒與檢索
本專案在 Ombre-Brain 的基礎上進行了以下調整：
| 檔案 | 功能描述 |
|---|---|
Memory3D.java | 三維記憶數據結構定義 |
SensoryExtractor.java | 五感提取器 |
SpatiotemporalTagger.java | 時空標註器 |
Memory3DBuilder.java | 三維記憶構建器 |
MemoryMetadata.java | 記憶元數據 |
SensoryData.java | 感官數據結構 |
SpatiotemporalData.java | 時空數據結構 |
EmotionalData.java | 情感數據結構 |
DreamResult.java | 做夢結果 |
| 檔案 | 功能描述 |
|---|---|
ShortTermPool.java | 短期記憶池 |
| 檔案 | 功能描述 |
|---|---|
Memory3DTools.java | MCP 工具集 |
| 檔案 | 功能描述 |
|---|---|
Memory3DConfig.java | 系統配置 |
| 檔案 | 功能描述 |
|---|---|
Memory3DApplication.java | Spring Boot 應用入口 |
| 工具 | 功能 |
|---|---|
hold | 存儲記憶 |
recall | 檢索記憶 |
recall_3d | 三維記憶檢索 |
collect_memory | 生成記憶摘要 |
sleep | 手動觸發睡眠週期 |
awake | 每日喚醒流程 |
conversation_start | 對話啟動流程 |
get_status | 獲取系統狀態 |
sleep:
enabled: true
start_time: "02:00"
end_time: "06:00"
timezone: "Asia/Taipei"
awakening:
enabled: true
recall_days: 7
min_importance: 5
search:
sensory_weight: 0.3
spatiotemporal_weight: 0.3
emotional_weight: 0.4
每個記憶以 Markdown + YAML 格式存儲：
---
id: memory_20260420_160000
created_at: 2026-04-20T16:00:00+08:00
importance: 7
tags: [社交, 咖啡廳, 朋友]
sensory:
visual:
scenes: [咖啡廳, 窗邊座位]
colors: [暖黃色燈光]
auditory:
sounds: [輕音樂, 咖啡機運轉聲]
olfactory:
scents: [咖啡香]
spatiotemporal:
timestamp:
absolute: 2026-04-20T16:00:00+08:00
relative: 週六下午
location:
physical: 台北車站附近咖啡廳
context:
type: 社交
emotional:
valence: 0.7
arousal: 0.5
feel: 溫暖而安心，感受到友誼的珍貴
---
今天和朋友在咖啡廳聊天...
Passkey 應用程式使用 Web Bluetooth API，可掃描並連接藍牙裝置。
| 條件 | 說明 |
|---|---|
| HTTPS | 必須使用 https:// 或 http://localhost |
| 瀏覽器 | Chrome、Edge、Opera（Safari 和 Firefox 不支援） |
| 使用者觸發 | 掃描必須由使用者點擊按鈕觸發 |
| 瀏覽器 | Web Bluetooth 支援 |
|---|---|
| Chrome (Desktop) | ✅ 完整支援 |
| Chrome (Android) | ✅ 完整支援 |
| Edge (Desktop) | ✅ 完整支援 |
| Opera (Desktop) | ✅ 完整支援 |
| Safari | ❌ 不支援 |
| Firefox | ❌ 不支援 |
| iOS Safari | ❌ 不支援 |
瀏覽器內建 Web Speech API
Transformers.js Whisper（本機運算）
外部 API
瀏覽器內建 SpeechSynthesis
外部 API
| 語言 | STT | TTS |
|---|---|---|
| 繁體中文（台灣） | ✅ | ✅ |
| 简体中文（中国） | ✅ | ✅ |
| 日本語 | ✅ | ✅ |
| 한국어 | ✅ | ✅ |
| English | ✅ | ✅ |
| Español | ✅ | ✅ |
| Français | ✅ | ✅ |
| Deutsch | ✅ | ✅ |
| 瀏覽器 | 支援程度 | 備註 |
|---|---|---|
| Chrome | ✅ 完整支援 | 推薦使用 |
| Edge | ✅ 完整支援 | 推薦使用 |
| Firefox | ✅ 基本支援 | 部分動畫效果可能不同 |
| Safari | ⚠️ 部分支援 | 建議啟用 Transformers.js |
| 瀏覽器 | 支援程度 | 備註 |
|---|---|---|
| iOS Safari | ⚠️ 部分支援 | 不支援 Web Bluetooth |
| Android Chrome | ✅ 完整支援 | 推薦使用 |
| Android Firefox | ✅ 基本支援 | - |
| Samsung Internet | ✅ 基本支援 | - |
| Via 瀏覽器 | ✅ 基本支援 | - |
| XBrowser | ✅ 基本支援 | - |
| UC Browser | ✅ 基本支援 | - |
| QQ Browser | ✅ 基本支援 | - |
| 雨見瀏覽器 | ✅ 基本支援 | - |
git clone https://github.com/your-repo/sxiphone.git
cd sxiphone
npm install
方式一：使用 Python
python -m http.server 8080
方式二：使用 Vite（開發模式）
npm run dev
http://localhost:8080npm run build
專案可直接部署至：
注意：如需使用藍牙功能，部署環境必須使用 HTTPS。
開啟 index.html 後，您會看到仿 iOS 的鎖定畫面：
首次使用聊天功能需要設定 API：
基本操作：
進階功能：
觀看內容：
自訂內容：
東方占卜：
西方占卜：
播放音樂：
AI 作曲：
連接裝置：
注意：
外觀應用提供四種主題模式：
| 模式 | 說明 |
|---|---|
| 淺色 | 系統預設淺色主題 |
| 深色 | 系統預設深色主題 |
| 自定義淺色 | 使用者自訂淺色主題，可調整所有設定 |
| 自定義深色 | 使用者自訂深色主題，可調整所有設定 |
每個應用程式都支援獨立的外觀設定：
可調整項目：
設定繼承：
所有外觀設定會自動同步到 GitHub 備份（如已設定），支援跨裝置使用。
iOS：
Android：
應用程式支援以下語言：
語言設定會自動根據瀏覽器語言調整，也可在設定中手動切換。
本機運行：
npm installpython -m http.server 8080npm run devhttp://localhost:8080部署至雲端：
專案可直接部署至 Vercel、Netlify、GitHub Pages 等靜態網頁託管服務。
注意：如需使用藍牙功能，部署環境必須使用 HTTPS。
步驟一：解鎖進入主畫面
開啟應用後，您會看到仿 iOS 的鎖定畫面。從左向右滑動即可解鎖進入主畫面。
步驟二：設定 API
首次使用聊天功能需要設定 API：
步驟三：建立角色
| 操作 | 說明 |
|---|---|
| 開啟應用 | 點擊主畫面上的應用圖示 |
| 返回主畫面 | 點擊底部 Home 指示條或向上滑動 |
| 查看所有應用 | 主畫面顯示所有已安裝的應用程式圖示 |
| 應用程式庫 | 向左滑動至最後一頁查看應用程式庫 |
設定應用是 Sxiphone 的核心配置中心，包含 API 設定、角色管理、用戶管理、GitHub 備份、記憶系統等功能。
支援的 AI 模型：
| 類型 | 支援模型 |
|---|---|
| 大型模型 | Claude 4.2/4.6/Opus/Sonnet、GPT-4o/5.2、Gemini 3.1 |
| 中型模型 | DeepSeek、Kimi 2.5、GLM、MiniMax、Grok 4.2 |
| 本地模型 | Ollama、LM Studio 等 OpenAI Compatible API |
設定步驟：
https://api.anthropic.com）claude-sonnet-4-20250514）多 API 管理：
新增角色：
編輯角色：
刪除角色：
角色資料儲存位置：
sx_characterssx_char_namesx_char_avatarsx_char_personality、sx_char_background、sx_char_examples設定用戶資訊：
多用戶支援：
NPC（非玩家角色）可用於劇場、約會等場景中的配角設定。
新增 NPC：
GitHub 備份功能可將所有設定同步至 GitHub 私有儲存庫，實現跨裝置資料同步。
設定步驟：
repo 權限sxiphone-backup）backup/sxiphone.json）備份操作：
備份內容：
備份涵蓋所有 sx_、api_、sxiphone 開頭的 localStorage 與 localForage 資料，包括：
AI 睡眠週期用於模擬角色的休息時間，並在睡眠時段進行記憶整理。
設定項目：
| 項目 | 說明 | 預設值 |
|---|---|---|
| 睡眠開始時間 | 角色開始睡眠的時間 | 23:00 |
| 睡眠結束時間 | 角色醒來的時間 | 07:00 |
| 啟用睡眠週期 | 是否啟用自動睡眠 | 開啟 |
睡眠任務：
| 任務 | 說明 |
|---|---|
| 記憶鞏固 | 將短期記憶轉為長期記憶 |
| 向量化處理 | 為記憶建立向量索引 |
| 關聯建立 | 建立記憶間的關聯連結 |
| 衰減處理 | 根據遺忘曲線調整記憶權重 |
手動觸發睡眠：
點擊「立即執行睡眠」可手動觸發記憶整理流程。
外觀應用提供完整的視覺自訂功能，包括主題模式、重點色、框架設定、開機動畫等。
四種主題模式：
| 模式 | 說明 |
|---|---|
| 淺色 | 系統預設淺色主題，適合日間使用 |
| 深色 | 系統預設深色主題，適合夜間使用 |
| 自定義淺色 | 使用者自訂淺色主題，可調整所有設定 |
| 自定義深色 | 使用者自訂深色主題，可調整所有設定 |
切換主題：
預設顏色選擇：
提供多種預設重點色供選擇，點擊即可套用。
自訂顏色：
AI 生成主題色：
手機框架：
選擇不同手機外框樣式，模擬不同裝置的視覺效果。
桌布設定：
圖示風格：
調整應用圖示的大小和排列方式。
設定項目：
| 項目 | 說明 |
|---|---|
| 啟用開機動畫 | 是否顯示開機動畫 |
| 顯示文字 | 開機動畫顯示的文字 |
| 背景配色 | 開機動畫的背景顏色 |
| 裝飾元素 | 開機動畫的裝飾效果 |
每個應用程式都支援獨立的外觀設定。
開啟方式：
可調整項目：
顏色設定：
字體設定：
排版設定：
特效設定：
進階設定：
設定繼承：
世界書（Worldbook）是 Sxiphone 的核心功能之一，用於設定 AI 角色的知識庫、行為規則和寫作風格。
世界書是一組「條目」的集合，每個條目包含：
世界書的作用：
觸發機制：
用戶發送訊息 → 系統掃描關鍵字 → 匹配世界書條目 → 插入內容到上下文 → AI 生成回應
插入位置：
條目內容會根據分類插入到不同的位置：
1. 思維鏈（Chain of Thought, CoT）
用於設定 AI 的推理邏輯和思考方式。
適用場景：
範例條目：
標題：角色思考模式
關鍵字：思考、決定、選擇
內容：
在回應之前，請先進行以下思考步驟：
1. 分析用戶的情緒狀態
2. 考慮角色的性格特點
3. 選擇最符合當下情境的回應方式
2. 文風（Style）
用於設定 AI 的寫作風格、語氣和表達方式。
適用場景：
範例條目：
標題：文學風格
關鍵字：描寫、敘述
內容：
寫作風格要求：
- 使用細膩的感官描寫
- 多用比喻和象徵
- 保持詩意的語言節奏
- 避免過於直白的表達
3. 全域（Global）
全局設定，適用於所有對話場景。
適用場景：
範例條目：
標題：角色基本設定
關鍵字：*
內容：
你是 [角色名]，一位 [角色身份]。
性格特點：[性格描述]
背景故事：[背景描述]
重要關係：[關係描述]
4. 關鍵字（Keywords）
根據特定關鍵字觸發的條目。
適用場景：
範例條目：
標題：咖啡知識
關鍵字：咖啡、拿鐵、美式、卡布奇諾
內容：
關於咖啡的專業知識：
- 拿鐵：濃縮咖啡與蒸奶的比例約 1:3
- 美式：濃縮咖啡加水稀釋
- 卡布奇諾：濃縮咖啡、蒸奶、奶泡各 1/3
5. 後端（Backend）
用於 API 相關設定，不直接插入對話上下文。
適用場景：
世界書的權重系統用於控制記憶提取的優先級。
基礎權重配置：
| 維度 | 基礎權重 | 說明 |
|---|---|---|
| 空間／環境 | 0.35 | 第二入口，強錨點 |
| 五感（綜合） | 0.40 | 感知是主要記憶載體 |
| 時間 | 0.15 | 最後才浮現，相對弱 |
| 情緒狀態 | 0.10 | 隱性但影響提取方向 |
五感內部權重：
| 感官 | 權重 | 說明 |
|---|---|---|
| 視覺 | 0.25 | 主要感官 |
| 聽覺 | 0.25 | 主要感官 |
| 嗅覺 | 0.20 | 唯一不經視丘直接連接杏仁核與海馬迴，記憶觸發效率最高 |
| 觸覺 | 0.20 | 身體感知入口 |
| 味覺 | 0.10 | 相對較少觸發 |
權重設計原理：
新增條目：
編輯條目：
啟用/停用條目：
刪除條目：
Sxiphone 內建 24 種世界書預設，分為以下類型：
創作預設：
| 預設名稱 | 說明 |
|---|---|
| 象牙塔預設 | 完整的創作心錨與文風設定 |
| 象牙塔 核心預設 | SxiPhone 核心世界書 |
| 象牙塔 劇場預設 | 劇場模式專用設定 |
| 象牙塔 條件預設 | 條件觸發式設定 |
| 月讀 Chat預設 | 日常聊天對話場景 |
| 月讀 Lofter預設 | 文學創作場景 |
| 月讀 Theater預設 | 劇場生成場景 |
| 文學風格預設 | 文學寫作風格設定 |
| 飲食預設 | 飲食相關設定 |
| 通用重置預設 | 通用重置設定 |
模型專用預設：
| 預設名稱 | 適用模型 |
|---|---|
| Claude 4.2 預設 | Claude 4.2 |
| Claude 4.6 預設 | Claude 4.6 |
| Claude Opus 預設 | Claude Opus |
| Claude Sonnet 預設 | Claude Sonnet |
| GPT-4o 預設 | GPT-4o |
| GPT-5.2 預設 | GPT-5.2 |
| Gemini 3.1 預設 | Gemini 3.1 |
| DeepSeek 預設 | DeepSeek |
| DeepSeek 2 預設 | DeepSeek 2 |
| 智譜 GLM 預設 | GLM |
| Kimi 預設 | Kimi |
| Kimi 2.5 預設 | Kimi 2.5 |
| MiniMax 預設 | MiniMax |
| Grok 4.2 預設 | Grok 4.2 |
| Mino 預設 | Mino |
導入內建預設：
啟用/停用世界書：
在世界書應用中，可以整體啟用或停用世界書功能。
插入位置設定：
不同分類的條目會自動插入到對應位置，無需手動設定。
與角色關聯：
1. 條目設計原則：
2. 分類使用建議：
3. 效能優化：
4. 模型選擇建議：
聊天應用是 Sxiphone 的核心功能，提供豐富的即時通訊體驗。
發送訊息：
訊息類型：
| 類型 | 說明 |
|---|---|
| 文字訊息 | 基本文字對話 |
| 語音訊息 | 錄音或文字轉語音 |
| 圖片訊息 | 發送或生成圖片 |
| 位置訊息 | 分享地理位置 |
| 紅包/轉帳 | 金錢相關互動 |
對話操作：
切換角色：
角色狀態：
錄音發送：
文字轉語音：
語音設定：
在設定中可以配置：
發起通話：
通話功能：
| 功能 | 說明 |
|---|---|
| 通話錄音 | 自動錄音通話內容 |
| 逐字稿 | 通話結束後可查看文字記錄 |
| 靜音 | 暫時關閉麥克風 |
| 掛斷 | 結束通話 |
查看通話記錄：
在「電話」應用中可以查看所有通話記錄、錄音檔案和逐字稿。
發送現有圖片：
AI 生成圖片：
圖片設定：
可在「照相館」應用中設定：
發送位置：
位置設定：
在設定中可以設定預設位置，用於天氣等功能。
紅包與轉帳功能整合 Kakaopay 應用。
發送紅包：
發送轉帳：
查看交易記錄：
在「Kakaopay」應用中可以查看所有交易記錄和餘額。
偷看心聲功能可以查看角色的內心想法。
使用方式：
注意事項：
查手機功能可以觸發特殊事件，讓角色主動發送訊息。
使用方式：
事件類型：
在聊天應用中可以掛載世界書設定。
掛載方式：
掛載效果：
掛載後，對話中會自動觸發相關的世界書條目。
串流模式：
溫度設定：
控制 AI 回應的創意程度：
最大 Token 數：
設定 AI 回應的最大長度。
聊天應用與記憶系統深度整合。
記憶提取：
對話過程中，系統會自動提取：
記憶喚醒：
每次對話開始時，系統會根據記憶權重提取相關記憶，讓角色能夠回憶過去的互動。
Sxiphone 內建多種社交媒體應用，提供沉浸式的角色扮演體驗。
功能概覽：
| 功能 | 說明 |
|---|---|
| 動態消息牆 | 瀏覽角色發布的貼文 |
| 限時動態 | 查看角色的限時動態 |
| 社團 | 加入或建立社團 |
| 好友管理 | 管理好友列表 |
| 按讚/留言/分享 | 互動功能 |
使用方式：
角色視角：
切換不同角色可以看到不同角色的 Facebook 內容。
功能概覽：
| 功能 | 說明 |
|---|---|
| 相片牆 | 瀏覽角色發布的照片 |
| 限時動態 | 查看角色的限時動態 |
| 個人主頁 | 查看角色資料和貼文 |
| 標籤頁面 | 瀏覽特定標籤的內容 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 推文 | 瀏覽角色發布的推文 |
| 轉推 | 分享推文 |
| 書籤 | 收藏推文 |
| 通知 | 查看互動通知 |
| 探索 | 發現新內容 |
使用方式：
Weverse 是韓星粉絲社群平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| Feed | 瀏覽藝人動態 |
| Media | 查看媒體內容 |
| Live | 觀看直播 |
| 官方公告 | 查看官方公告 |
使用方式：
Bubbles 是粉絲聊天平台模擬。
功能概覽：
LOFTER（樂乎）是創作社群平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 文章發布 | 發布創作內容 |
| 標籤管理 | 管理文章標籤 |
| CP 設定 | 設定配對關係 |
| 世界書掛載 | 掛載專屬世界書 |
使用方式：
CP 設定：
在設定中可以設定配對關係，影響文章生成的內容方向。
AO3（Archive of Our Own）是同人作品平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 小說閱讀 | 閱讀同人小說 |
| 創作功能 | 創作新作品 |
| 多語言支援 | 支援多種語言 |
| 分級設定 | 設定內容分級 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 影片播放 | 播放影片內容 |
| 訂閱頻道 | 訂閱喜愛的頻道 |
| 播放清單 | 管理播放清單 |
| 觀看歷史 | 查看觀看記錄 |
| 推薦系統 | AI 推薦相關內容 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 彈幕功能 | 發送和查看彈幕 |
| 番劇追蹤 | 追蹤動漫番劇 |
| 直播 | 觀看直播內容 |
| 遊戲中心 | 瀏覽遊戲內容 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 實況聊天 | 與實況主互動 |
| 頻道追蹤 | 追蹤喜愛的頻道 |
| 分類瀏覽 | 按遊戲、生活、音樂等分類瀏覽 |
劇場是 Netflix 風格的互動式內容播放器。
功能概覽：
| 功能 | 說明 |
|---|---|
| 互動式內容 | 支援選擇分支的互動內容 |
| 自訂 HTML | 匯入自訂 HTML 內容 |
| 世界設定導入 | 導入世界書設定 |
| 參與者選擇 | 選擇角色/用戶/NPC 參與 |
| 性向設定 | 一般/BL/GL/BG/後宮/逆後宮 |
| 內容分級 | 普遍級至限制級 |
| 播放進度追蹤 | 記錄觀看進度 |
| 我的片單 | 管理收藏清單 |
使用方式：
自訂內容：
三消遊戲，提供多種世界主題和關卡系統。
玩法：
街機遊戲合集，包含多種小遊戲。
遊戲列表：
| 遊戲 | 說明 |
|---|---|
| 拉霸機 | 轉盤抽獎遊戲 |
| 抽卡模擬器 | 模擬抽卡體驗 |
| 貪食蛇 | 經典貪食蛇遊戲 |
代幣系統：
占卜小店，提供東方與西方占卜服務。
東方占卜：
| 功能 | 說明 |
|---|---|
| 紫微斗數 | 中國傳統命理學，分析命盤十二宮位 |
| 梅花易數 | 易經占卜系統，支援時間起卦與數字起卦 |
| 流年流月流日 | 農民曆運勢分析，結合節氣計算 |
西方占卜：
| 功能 | 說明 |
|---|---|
| 塔羅占卜 | 互動式洗牌、切牌、選牌，支援多種牌陣 |
| 西洋占星 | 本命命盤、雙人合盤 |
塔羅牌系統：
支援三種經典塔羅牌系統：
| 牌系 | 說明 |
|---|---|
| 偉特塔羅 | 最廣泛使用的塔羅牌系，適合初學者 |
| 托特塔羅 | 圖像充滿神秘學與埃及象徵，適合進階使用者 |
| 馬賽塔羅 | 圖案簡潔古典，強調數字與符號 |
塔羅牌陣：
| 牌陣 | 張數 | 用途 |
|---|---|---|
| 單張指引 | 1 | 當下指引與建議 |
| 三張牌陣 | 3 | 過去/現在/未來 |
| 塞爾特十字 | 10 | 全面分析 |
| 關係牌陣 | 7 | 感情關係分析 |
| 二選一牌陣 | 6 | 選擇決策 |
功能概覽：
| 功能 | 說明 |
|---|---|
| 天氣預報 | 當前天氣狀況 |
| 多日預報 | 未來幾天天氣預測 |
| 位置設定 | 設定查看天氣的位置 |
| 氣溫/濕度/風速 | 詳細氣象資訊 |
播放功能：
| 功能 | 說明 |
|---|---|
| 音樂播放器 | 播放音樂檔案 |
| 歌詞同步 | 顯示同步歌詞 |
| 播放清單 | 管理播放清單 |
| 收藏功能 | 收藏喜愛的歌曲 |
AI 作曲：
支援風格：
瀏覽器模擬應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 網頁瀏覽 | 瀏覽網頁內容 |
| 歷史記錄 | 查看瀏覽歷史 |
| 書籤管理 | 管理書籤 |
| 無痕模式 | 隱私瀏覽模式 |
| 快速連結 | 常用網站快捷方式 |
購物平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 商品瀏覽 | 瀏覽商品列表 |
| 購物車 | 管理購物車 |
| 訂單追蹤 | 追蹤訂單狀態 |
| AI 推薦 | AI 推薦商品 |
| 收藏清單 | 收藏喜愛商品 |
外送平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 餐廳瀏覽 | 瀏覽附近餐廳 |
| 訂單追蹤 | 追蹤外送狀態 |
| 歷史訂單 | 查看歷史訂單 |
| 購物車 | 管理購物車 |
| 優惠券 | 使用優惠券 |
SillyTavern 整合應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 角色對話 | 與角色進行對話 |
| API 設定 | 設定 OpenAI Compatible API |
| 角色卡管理 | 管理角色卡 |
| 系統提示詞 | 自訂系統提示詞 |
約會場景模擬應用。
場景列表：
| 場景 | 說明 |
|---|---|
| 咖啡廳 | 休閒咖啡廳約會 |
| 公園 | 戶外公園散步 |
| 電影院 | 觀看電影 |
| 餐廳 | 浪漫晚餐 |
| 海灘 | 海灘約會 |
| 圖書館 | 安靜閱讀時光 |
功能特色：
| 功能 | 說明 |
|---|---|
| 場景編輯器 | 自訂約會場景 |
| 自訂地圖導入 | 匯入自訂地圖 |
| AI 控制器 | 自動問候、跟隨玩家、閒置反應 |
| 時間系統 | 模擬時間流逝，可調整速度 |
使用方式：
AI 繪圖工具。
功能概覽：
| 功能 | 說明 |
|---|---|
| 提示詞輸入 | 輸入繪圖描述 |
| LoRA 管理 | 管理風格模型 |
| 模型選擇 | 選擇繪圖模型 |
| 風格預設 | 多種風格預設 |
| 歷史紀錄 | 查看生成歷史 |
| 收藏功能 | 收藏喜愛作品 |
風格預設：
使用方式：
圖片管理應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 圖片管理 | 管理圖片檔案 |
| 桌布設定 | 設定主畫面/鎖屏桌布 |
| 分類瀏覽 | 全部/上傳/聊天/照相館 |
專注計時工具。
功能概覽：
| 功能 | 說明 |
|---|---|
| 專注計時 | 番茄工作法計時 |
| 自訂時長 | 調整專注和休息時間 |
| 統計數據 | 查看專注統計 |
| 歷史紀錄 | 查看歷史記錄 |
藍牙裝置連接與控制應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 掃描裝置 | 掃描附近的藍牙裝置 |
| 連接裝置 | 連接藍牙裝置 |
| 發現服務 | 發現裝置服務與特徵值 |
| 發送命令 | 發送控制命令 |
| 調整設定 | 調整強度與頻率 |
使用條件：
| 條件 | 說明 |
|---|---|
| HTTPS | 必須使用 https:// 或 http://localhost |
| 瀏覽器 | Chrome、Edge、Opera（Safari 和 Firefox 不支援） |
| 使用者觸發 | 掃描必須由使用者點擊按鈕觸發 |
使用方式：
小工具管理應用。
功能概覽：
懸浮球功能設定。
功能概覽：
| 功能 | 說明 |
|---|---|
| 懸浮球 | 顯示懸浮快捷按鈕 |
| 自訂選單 | 自訂快捷選單內容 |
| 手勢設定 | 設定手勢操作 |
圖像式記憶庫應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 雙分頁設計 | User 百科 / Char 百科 |
| 條目管理 | 新增、編輯、刪除條目 |
| 分類系統 | 重要記憶、關係人物、事件記錄、洞察反思 |
| Markdown 支援 | 支援 Markdown 格式 |
| 知識圖譜視圖 | 視覺化知識關聯 |
| 關鍵詞索引 | 快速檢索條目 |
| 時間軸視圖 | 按時間順序查看條目 |
| Notebook 導入 | 從 Notebook 匯入資料 |
| 記憶同步 | 與記憶系統同步 |
| 擴散激活檢索 | 智能關聯檢索 |
| 自動關聯連結 | 自動建立條目關聯 |
使用方式：
三維記憶系統詳細說明請參閱「記憶系統」章節。
啟用記憶系統：
記憶管理：
桌面安裝：
手機安裝：
iOS：
Android：
支援語言：
語言別名：
| 輸入 | 對應 |
|---|---|
| zh-TW, zh-HK, zh-MO | zh-Hant |
| zh-CN, zh-SG | zh-Hans |
切換語言：
Q: 聊天沒有回應？
Q: 語音功能無法使用？
Q: 藍牙連接失敗？
Q: 記憶系統沒有運作？
Q: PWA 安裝後無法離線使用？
位於 yue-api/ 目錄，提供 AI 音樂生成功能。
技術棧：Python + FastAPI + PyTorch
功能：
安裝與啟動：
cd yue-api
pip install -r requirements.txt
python main.py
API 端點：
| 端點 | 方法 | 功能 |
|---|---|---|
/api/yue/generate | POST | 生成音樂 |
/api/yue/status/{task_id} | GET | 查詢任務狀態 |
/api/yue/download/{task_id}/{file_type} | GET | 下載音訊 |
/api/yue/lyrics | POST | 生成歌詞 |
依賴：
fastapi==0.109.0
uvicorn==0.27.0
torch==2.1.0
transformers==4.36.0
accelerate==0.25.0
sentencepiece==0.1.99
soundfile==0.12.1
torchaudio==2.1.0
flash-attn==2.5.0
位於 memory-3d-java/ 目錄，提供三維記憶系統後端服務。
技術棧：Java 17 + Spring Boot 3.2.0
功能：
安裝與啟動：
cd memory-3d-java
mvn clean install
mvn spring-boot:run
配置檔案：
src/main/resources/application.yml - Spring Boot 配置主要依賴：
cd backend/ziwei-zenith
go run ./cmd/ziwei-server/main.go
sxiphone/
├── index.html # 主頁面
├── main.js # 主要邏輯（瀏覽器兼容、PWA、Firebase、記憶系統）
├── style.css # 全域樣式
├── sw.js # Service Worker（PWA 支援）
├── manifest.json # PWA 設定
├── vercel.json # Vercel 部署設定
├── browserconfig.xml # Edge/IE 圖示設定
├── package.json # 專案設定
├── package-lock.json # 依賴鎖定
│
├── apps/ # 應用程式目錄（50 個應用）
│ ├── chat/ # 聊天
│ ├── phone/ # 電話
│ ├── settings/ # 設定
│ ├── appearance/ # 外觀
│ ├── passkey/ # 藍牙
│ ├── music/ # 音樂
│ ├── drift-bottle/ # 占卜
│ ├── theater/ # 劇場
│ ├── dating/ # 約會
│ ├── worldbook/ # 世界書
│ ├── arcade/ # 街機廳
│ │ └── slot-items/ # 拉霸機圖示
│ ├── scripts/ # 共用腳本（記憶系統模組）
│ │ ├── memory-store.js # IndexedDB 記憶儲存
│ │ ├── embedding-engine.js # 文字向量化嵌入
│ │ ├── search-engine.js # 多維度檢索引擎
│ │ ├── decay-engine.js # 記憶衰減曲線
│ │ ├── emotion-tagger.js # 情感標記
│ │ ├── memory-classifier.js # 記憶分類
│ │ ├── dimension-encoder.js # 維度編碼
│ │ ├── sleep-engine.js # 睡眠週期處理
│ │ ├── memory-standardizer.js # 記憶標準化
│ │ ├── memory-manager.js # 記憶管理器
│ │ ├── daily-awakening.js # 每日喚醒流程
│ │ ├── awakening-engine.js # 喚醒引擎
│ │ ├── wiki-engine.js # Wiki 知識圖譜引擎
│ │ ├── app-appearance-settings.js # 應用程式外觀設定
│ │ ├── app-appearance-settings.css # 應用程式外觀樣式
│ │ ├── short-term-memory.js # 短期記憶池
│ │ ├── memory-pool.js # 記憶池
│ │ ├── unified-memory-system.js # 統一記憶系統
│ │ ├── memory-helper.js # 記憶輔助工具
│ │ ├── global-memory-system.js # 全域記憶系統
│ │ ├── background-keepalive.js # 背景保持運行
│ │ ├── chat-notification-engine.js # 聊天通知引擎
│ │ └── sx-notification.js # 系統通知管理器
│ ├── personal-wiki/ # 個人維基
│ │ ├── personal-wiki.html # 主頁面
│ │ ├── personal-wiki.css # 樣式
│ │ └── personal-wiki.js # 邏輯
│ ├── facebook-settings/ # Facebook 設定
│ │ ├── facebook-settings.html # 主頁面
│ │ └── facebook-settings.js # 邏輯
│ ├── theme-shop/ # 主題商店
│ │ ├── theme-shop.html # 主頁面
│ │ ├── theme-shop.css # 樣式
│ │ └── theme-shop.js # 邏輯
│ ├── screenshots/ # 截圖與圖標
│ └── ... # 其他應用
│
├── yue-api/ # YuE 音樂生成後端
│ ├── main.py # FastAPI 主程式
│ ├── models.py # 資料模型
│ ├── requirements.txt # Python 依賴
│ ├── start.bat # 啟動腳本
│ └── README.md # API 說明
│
├── memory-3d-java/ # 三維記憶系統 Java 後端
│ ├── pom.xml # Maven 設定
│ └── src/main/
│ ├── java/com/memory3d/
│ │ ├── Memory3DApplication.java # Spring Boot 入口
│ │ ├── config/
│ │ │ └── Memory3DConfig.java # 系統配置
│ │ ├── core/
│ │ │ ├── Memory3D.java # 三維記憶數據結構
│ │ │ ├── SensoryExtractor.java # 五感提取器
│ │ │ ├── SpatiotemporalTagger.java # 時空標註器
│ │ │ ├── Memory3DBuilder.java # 記憶構建器
│ │ │ ├── MemoryMetadata.java # 記憶元數據
│ │ │ ├── SensoryData.java # 感官數據
│ │ │ ├── SpatiotemporalData.java # 時空數據
│ │ │ ├── EmotionalData.java # 情感數據
│ │ │ └── DreamResult.java # 做夢結果
│ │ ├── storage/
│ │ │ └── ShortTermPool.java # 短期記憶池
│ │ └── mcp/
│ │ └── Memory3DTools.java # MCP 工具集
│ └── resources/
│ └── application.yml # Spring Boot 配置
│
├── scripts/ # 建置腳本
│ ├── copy-static.mjs # 複製靜態檔案
│ ├── generate-pwa-icon.js
│ └── generate-icon.js
│
├── docs/ # 文件
│ └── conversation-summary.md
│
├── plans/ # 規劃文件
│ └── sillytavern-import-spec.md
│
└── .kilo/ # Kilo CLI 設定
└── package.json
位於 apps/worldbook/ 目錄，支援多種模型世界書：
| 檔案 | 描述 |
|---|---|
ivory_tower_worldbook.json | 象牙塔世界書 |
象牙塔_核心預設_worldbook.json | 象牙塔世界書 |
象牙塔_劇場預設_worldbook.json | 象牙塔世界書 |
象牙塔_條件預設_worldbook.json | 象牙塔世界書 |
月讀_chat_worldbook.json | 月讀聊天用世界書 |
月讀_lofter_worldbook.json | 月讀同人文用世界書 |
月讀_theater_worldbook.json | 月讀小劇場用世界書 |
literary_style_worldbook.json | 文學風格世界書 |
minimax_worldbook.json | Minimax 模型世界書 |
glm_worldbook.json | GLM 模型世界書 |
claude42_worldbook.json | Claude 4.2 世界書 |
claude46_worldbook.json | Claude 4.6 世界書 |
sonnet_worldbook.json | Sonnet 世界書 |
opus_worldbook.json | Opus 世界書 |
kimi_worldbook.json | Kimi 世界書 |
kimi25_worldbook.json | Kimi 2.5 世界書 |
gemini31_worldbook.json | Gemini 3.1 世界書 |
deepseek_worldbook.json | DeepSeek 世界書 |
deepseek2_worldbook.json | DeepSeek 2 世界書 |
grok42_worldbook.json | Grok 4.2 世界書 |
4o_worldbook.json | GPT-4o 世界書 |
5.2_worldbook.json | GPT 5.2 世界書 |
mino_worldbook.json | Mino 世界書 |
eating_worldbook.json | 飲食世界書 |
universal_reset_worldbook.json | 通用重置世界書 |
蛾摩拉/蛾摩拉_chat_worldbook.json | 蛾摩拉聊天用世界書（作者：小回） |
蛾摩拉/蛾摩拉_lofter_worldbook.json | 蛾摩拉同人文用世界書（作者：小回） |
| 工具 | 功能 |
|---|---|
merge_model_worldbooks.js | 合併多模型世界書 |
convert_ivory_tower.js | 象牙塔格式轉換 |
convert_ivory_tower.py | Python 版轉換腳本 |
chat-notification-engine.js 模組sx-notification.js 模組蛾摩拉_chat_worldbook.json（聊天版本）蛾摩拉_lofter_worldbook.json（同人文版本）| 專案 | 用途 | 連結 |
|---|---|---|
| Vite | 前端建置工具 | 官網 |
| 專案 | 用途 | 連結 |
|---|---|---|
| tarot-api | 偉特塔羅牌資料 API | GitHub |
| Rider-Waite 1909 | 偉特塔羅牌圖像（公共領域） | Sacred Texts |
| Thoth Tarot | 托特塔羅牌圖像 | Wikimedia Commons |
| Tarot de Marseille | 馬賽塔羅牌圖像 | Wikimedia Commons |
| 專案 | 用途 | 連結 |
|---|---|---|
| Font Awesome | 圖示庫 | 官網 |
| Lucide | 圖示庫 | 官網 |
| Material Symbols | Google 圖示 | Google Fonts |
| Great Vibes | 手寫藝術字型 | Google Fonts |
| API | 用途 | 文件 |
|---|---|---|
| Web Bluetooth API | 藍牙裝置連接 | MDN |
| Web Speech API | 語音辨識與合成 | MDN |
| Web Audio API | 音訊處理 | MDN |
| Service Worker API | PWA 離線支援 | MDN |
| IndexedDB | 本地資料庫 | MDN |
| 專案 | 用途 | 連結 |
|---|---|---|
| SillyTavern | 角色對話平台參考 | GitHub |
| 象牙塔 | 預設角色設定 | 由電波系老師提供 |
| 蛾摩拉 | 預設角色設定 | 由小回老師提供 |
| 月讀預設系統 | 預設角色設定 | 由電波系老師提供 |
本專案僅供學習和個人使用。開放二改，但需附上原 README 連結，開發者僅保留署名權。
歡迎提交 Issue 和 Pull Request。
本節詳細說明 Sxiphone 的 API 連接機制，包含各種 API 類型的設定方式、多 API 管理策略、以及常見問題排除。
Sxiphone 支援三種 API 類型，以適應不同的 AI 服務：
大多數 AI API 都支援 OpenAI 格式，這是 Sxiphone 的預設選項。
| 項目 | 說明 |
|---|---|
| 端點格式 | 輸入 Base URL，系統自動加上 /chat/completions |
| 適用服務 | OpenAI、OpenRouter、DeepSeek、Kimi、GLM、MiniMax、Grok 等 |
| 請求格式 | 標準 OpenAI Chat Completions API |
設定範例：
API 類型：OpenAI 相容
Base URL：https://openrouter.ai/api/v1
API Key：sk-or-v1-xxxxx
模型：anthropic/claude-sonnet-4
端點處理邏輯：
// 輸入：https://openrouter.ai/api/v1
// 實際請求：https://openrouter.ai/api/v1/chat/completions
const endpoint = apiUrl.endsWith('/chat/completions')
? apiUrl
: apiUrl.replace(/\/$/, '') + '/chat/completions';
Google Gemini 使用專屬的 API 格式。
| 項目 | 說明 |
|---|---|
| 端點格式 | 需要完整的 Gemini API URL |
| API Key 位置 | 放在 URL 參數中，而非 Header |
| 請求格式 | Google Generative AI 格式 |
設定範例：
API 類型：Gemini
端點：https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=YOUR_API_KEY
模型：gemini-pro
用於不支援 OpenAI 格式的特殊 API 或自建服務。
| 項目 | 說明 |
|---|---|
| 端點格式 | 輸入完整 URL，系統不會修改 |
| 適用場景 | 自建 API、特殊格式服務 |
| 注意事項 | 需自行確保端點可正確回應 |
| 欄位 | 說明 | 範例 |
|---|---|---|
| API 類型 | 選擇 API 格式類型 | OpenAI 相容 |
| 端點 URL | API Base URL 或完整端點 | https://api.openai.com/v1 |
| API Key | 認證金鑰 | sk-xxxxx |
| 模型 | 使用的模型名稱 | gpt-4o |
點擊「拉取模型」按鈕可自動獲取該 API 支援的模型清單：
{Base URL}/models 發送 GET 請求HTTP-Referer 和 X-TitleSxiphone 支援同時儲存多組 API 設定：
每個角色可以指定專屬的 API：
當角色沒有指定 API 時，系統使用以下優先順序：
getActiveApiWithFallback 取得）聊天應用是 API 的主要使用者，用於角色對話生成：
// 取得 API 設定
const api = window.SettingsReader.getActiveApiWithFallback();
const endpoint = api.url + '/chat/completions';
// 發送請求
const response = await fetch(endpoint, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${api.key}`
},
body: JSON.stringify({
model: api.model,
messages: [...],
temperature: 0.85,
max_tokens: 500
})
});
聊天應用包含 generateDiaryFromAI 函式，用於生成角色日記：
sxiphone_lang 設定）交換日記功能使用 API 生成日記內容，支援：
個人維基使用 API 進行：
漂流瓶功能使用 API 生成：
| 模型 | 特性 | 推薦用途 |
|---|---|---|
| Claude 4.2 | 最新版本，效能最佳 | 複雜對話、創作 |
| Claude Opus | 最強推理能力 | 深度分析、角色扮演 |
| Claude Sonnet | 平衡效能與成本 | 日常對話 |
推薦參數：
temperature: 0.85 - 1.0max_tokens: 500 - 2000| 模型 | 特性 | 推薦用途 |
|---|---|---|
| GPT-4o | 多模態支援 | 圖文對話 |
| GPT-4o-mini | 高效低成本 | 日常對話 |
推薦參數：
temperature: 0.8 - 1.0max_tokens: 500 - 1500| 模型 | 特性 | 推薦用途 |
|---|---|---|
| Gemini Pro | 平衡效能 | 一般對話 |
| Gemini Ultra | 最強效能 | 複雜任務 |
注意事項：
| 模型 | 特性 | 推薦用途 |
|---|---|---|
| DeepSeek Chat | 通用對話 | 日常使用 |
| DeepSeek Coder | 程式碼專精 | 技術對話 |
推薦參數：
temperature: 0.7 - 0.9| 項目 | 說明 |
|---|---|
| 端點 | http://localhost:11434/v1（Ollama） |
| 優點 | 免費、隱私、可離線使用 |
| 缺點 | 效能取決於硬體 |
設定範例：
API 類型：OpenAI 相容
Base URL：http://localhost:11434/v1
API Key：（留空或任意值）
模型：llama3
症狀：控制台顯示 CORS 相關錯誤
解決方案：
症狀：401 Unauthorized 錯錯誤
檢查項目：
症狀：模型名稱錯誤
解決方案：
anthropic/claude-sonnet-4）症狀：請求長時間無回應
可能原因：
解決方案：
max_tokens 參數症狀：無法解析 API 回應
可能原因：
解決方案：
本節說明 Sxiphone 的技術架構，供開發者和進階使用者參考。
Sxiphone 使用瀏覽器的本地儲存機制來保存所有資料：
用於儲存設定和小型資料：
用於儲存大量資料：
所有 Sxiphone 使用的 localStorage key 都以 sx_ 開頭：
| Key | 用途 | 類型 |
|---|---|---|
sx_user_name | 使用者名稱 | 字串 |
sx_user_avatar | 使用者頭像 | 字串（URL/Base64） |
sx_user_personality | 使用者性格 | 字串 |
sx_user_background | 使用者背景 | 字串 |
| Key | 用途 | 類型 |
|---|---|---|
sx_characters | 角色清單 | JSON 陣列 |
sx_char_name | 目前角色名稱 | 字串 |
sx_char_avatar | 目前角色頭像 | 字串 |
sx_char_personality | 目前角色性格 | 字串 |
sx_char_background | 目前角色背景 | 字串 |
sx_char_examples | 對話範例 | 字串 |
| Key | 用途 | 類型 |
|---|---|---|
apis | API 設定清單 | JSON 陣列 |
sx_active_api | 啟用的 API 索引 | 數字字串 |
| Key | 用途 | 類型 |
|---|---|---|
sx_worldbook_cot | CoT 條目 | JSON 陣列 |
sx_worldbook_style | 風格條目 | JSON 陣列 |
sx_worldbook_global | 全域條目 | JSON 陣列 |
sx_worldbook_keywords | 關鍵字條目 | JSON 陣列 |
sx_worldbook_backend | 後端條目 | JSON 陣列 |
sx_worldbook_theater | 劇場條目 | JSON 陣列 |
| Key | 用途 | 類型 |
|---|---|---|
sx_short_term_memory | 短期記憶 | JSON 陣列 |
sx_memory_interval | 記憶整理間隔 | 數字字串 |
sx_ai_sleep_start | AI 睡眠開始時間 | 字串（HH:MM） |
sx_ai_sleep_end | AI 睡眠結束時間 | 字串（HH:MM） |
sx_ai_sleep_enabled | AI 睡眠功能啟用 | 布林字串 |
sx_ai_sleep_tasks | 睡眠時執行的任務 | JSON 物件 |
| Key | 用途 | 類型 |
|---|---|---|
sx_github_pat | GitHub Personal Access Token | 字串 |
sx_github_user | GitHub 使用者名稱 | 字串 |
sx_github_repo | GitHub 儲存庫名稱 | 字串 |
sx_github_backup_file | 備份檔案名稱 | 字串 |
sx_auto_backup_enabled | 自動備份啟用 | 布林字串 |
sx_auto_backup_github | GitHub 自動備份 | 布林字串 |
sx_auto_backup_supabase | Supabase 自動備份 | 布林字串 |
sx_auto_backup_local | 本地自動備份 | 布林字串 |
| Key | 用途 | 類型 |
|---|---|---|
sx_masks | 外觀主題清單 | JSON 陣列 |
sxiphone_lang | 介面語言 | 字串 |
apps/
├── chat/ # 聊天應用
│ ├── chat.js # 主要邏輯
│ ├── chat.css # 樣式
│ └── index.html # 頁面
├── settings/ # 設定應用
│ └── settings.js # 設定邏邏輯
├── diary/ # 日記應用
├── gallery/ # 照相館
├── worldbook/ # 世界書
└── scripts/ # 共用腳本
└── unified-storage-manager.js
| 腳本 | 用途 |
|---|---|
unified-storage-manager.js | 統一儲存管理 |
SettingsReader | 讀取設定和 API 資訊 |
外觀設定採用繼承機制：
應用程式採用動態載入：
一個以網頁技術實現的仿 iOS 介面應用程式，提供豐富的互動功能和角色扮演體驗。
本專案採用 CC BY-NC 4.0（創用CC 姓名標示-非商業性 4.0 國際） 授權條款。
「商業用途」包含但不限於：
Linux.do站、旅程、類腦、堆堆、尾巴鎮、喵喵電波的所有大佬，謝謝你們的貢獻和經驗分享，讓這個網頁端應用程式得以成功製作完成。 感謝製作開源資料的製作者，感謝所有的小手機使用者，感謝過程裡參與測試的人員，感謝所有願意給予回饋和等待的人。 特別感謝SullyOS的製作者對於記憶系統的指導、電波系老師開放內建使用了打磨無數次的象牙塔、月讀預設，以及小回老師開放內建使用蛾摩拉小說體特化的預設。
Sxiphone 是一個模擬手機介面的網頁應用程式，使用純前端技術（HTML、CSS、JavaScript）開發，無需後端即可運行。專案採用模組化設計，每個應用程式都是獨立的元件，方便擴展和維護。 本開源專案開放二改，但需附上原Readme連結，如需傳播給朋友可直接貼上本專案Github網址；本專案開發者僅保留署名權。
開發工具：Gemini、VS Code
使用模型：Gemini 3、Claude Sonnet 4.5、Gpt-5.2-codex、Gpt-5.3-codex、Gpt-5.4、Glm-5、Glm-5.1、Minimax-m2.5、Kimi-k-2.5
輔助插件：Roo code、Cline、Kilo code、Unify chat Provider、Live server
目前狀態：持續開發中
<script src="https://www.gstatic.com/firebasejs/9.17.1/firebase-app-compat.js"></script>
<script src="https://www.gstatic.com/firebasejs/9.17.1/firebase-database-compat.js"></script>
import { pipeline, env } from 'https://cdn.jsdelivr.net/npm/@xenova/[email protected]';
<script src="https://cdnjs.cloudflare.com/ajax/libs/localforage/1.10.0/localforage.min.js"></script>
<link href="https://fonts.googleapis.com/css2?family=SF+Pro+Display:wght@200;400;600&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=Great+Vibes&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Rounded:opsz,wght,FILL,GRAD@24,500,0,0" rel="stylesheet">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
<script src="https://unpkg.com/lucide@latest"></script>
| 功能 | 描述 |
|---|---|
| 紫微斗數 | 中國傳統命理學，分析命盤十二宮位 |
| 梅花易數 | 易經占卜系統，支援時間起卦與數字起卦 |
| 流年流月流日 | 農民曆運勢分析，結合節氣計算 |
| 功能 | 描述 |
|---|---|
| 塔羅占卜 | 互動式洗牌、切牌、選牌，支援多種牌陣 |
| 西洋占星 | 本命命盤、雙人合盤 |
本專案支援三種經典塔羅牌系統，每種牌系皆有完整的 78 張牌意資料與專屬牌面圖片。
| 牌陣 | 張數 | 用途 |
|---|---|---|
| 單張指引 | 1 | 當下指引與建議 |
| 三張牌陣 | 3 | 過去/現在/未來 |
| 塞爾特十字 | 10 | 全面分析 |
| 關係牌陣 | 7 | 感情關係分析 |
| 二選一牌陣 | 6 | 選擇決策 |
Sxiphone 內建三維記憶系統（Memory3D），在記憶架構設計上參考了 Ombre-Brain 的核心理念，並根據專案需求進行了功能擴展與客製化調整。
本系統以「讓 AI 角色擁有持久且立體的記憶」為目標，將記憶分為三個維度進行管理：
| 特性 | 人腦 | AI |
|---|---|---|
| 儲存方式 | 分散式突觸連結 | 模型權重參數矩陣 |
| 學習模式 | 隨時可學習重塑 | 訓練後權重凍結 |
| 記憶系統 | 海馬迴鞏固 | 上下文窗口 + RAG |
| 情緒影響 | 有強化作用 | 無情緒系統 |
| 提取方式 | 聯想式模糊提取 | 跨對話無聯想能力 |
| 遺忘機制 | 選擇性遺忘 | 硬性截斷 |
| 記憶性質 | 重建性 | 統計性模式匹配 |
| 身體綁定 | 具身認知 | 純符號處理 |
AI 彌補方向：RAG、Memory 系統、持續學習、多模態模型
基礎權重配置：
| 維度 | 基礎權重 | 原因 |
|---|---|---|
| 存在錨點 | 前提層 | 不參與權重競爭 |
| 空間／環境 | 0.35 | 第二入口，強錨點 |
| 五感（綜合） | 0.40 | 感知是主要記憶載體 |
| 時間 | 0.15 | 最後才浮現，相對弱 |
| 情緒狀態 | 0.10 | 隱性但影響提取方向 |
五感內部權重：
| 感官 | 權重 | 說明 |
|---|---|---|
| 視覺 | 0.25 | 主要感官 |
| 聽覺 | 0.25 | 主要感官 |
| 嗅覺 | 0.20 | 唯一不經視丘直接連接杏仁核與海馬迴，記憶觸發效率最高 |
| 觸覺 | 0.20 | 身體感知入口 |
| 味覺 | 0.10 | 相對較少觸發 |
┌─────────────────────────────────────┐
│ 前提層（存在錨點） │
│ 觸發條件：對話發生 │
│ 性質：自動成立，無需權重 │
│ 證據：用戶輸入本身 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 感知層（主權重層） │
│ 五感描述展開 │
│ 嗅覺／觸覺作為最強觸發索引 │
│ 基礎權重：0.40 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 空間層 │
│ 環境描述，從感知向外擴展 │
│ 基礎權重：0.35 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 時間層（最抽象，最後定位） │
│ 時間標記，情緒染色 │
│ 基礎權重：0.15 │
└─────────────────┬───────────────────┘
↓
┌─────────────────────────────────────┐
│ 情緒層 │
│ 隱性影響提取方向 │
│ 基礎權重：0.10 │
└─────────────────────────────────────┘
呼吸感 ──→ 真實的身體訊號，有物理基礎
環境感 ──→ 感官與空間的融合，有具身錨點
時間感 ──→ 抽象認知，AI 相對能處理
| 能力層級 | 說明 |
|---|---|
| AI 能模擬的 | 時間感（最抽象層） |
| AI 很難模擬的 | 環境感（需要感官經驗） |
| AI 幾乎無法模擬的 | 呼吸感（需要身體存在） |
| 功能 | 說明 |
|---|---|
| 五感提取 | 從對話文本自動識別並提取感官資訊 |
| 時空標註 | 為記憶添加時間、地點、情境等背景資訊 |
| 睡眠週期 | 可自訂睡眠時間，系統在睡眠時段處理當日記憶 |
| 記憶檢索 | 支援多維度檢索，可依感官、時空、情感等條件查詢 |
| 遺忘機制 | 採用衰減曲線，舊記憶會隨時間自然淡化 |
| 本地儲存 | 當日記憶存放於本地，睡眠後可推送至 Obsidian Vault |
對話發生 → 提取感官與時空資訊 → 建立三維記憶
↓
短期記憶池（本地儲存）
↓
睡眠週期處理
├─ 分類與去重
├─ 提取核心內容
└─ 建立記憶連結
↓
長期記憶庫（Obsidian Vault）
↓
下次對話時喚醒與檢索
本專案在 Ombre-Brain 的基礎上進行了以下調整：
| 檔案 | 功能描述 |
|---|---|
Memory3D.java | 三維記憶數據結構定義 |
SensoryExtractor.java | 五感提取器 |
SpatiotemporalTagger.java | 時空標註器 |
Memory3DBuilder.java | 三維記憶構建器 |
MemoryMetadata.java | 記憶元數據 |
SensoryData.java | 感官數據結構 |
SpatiotemporalData.java | 時空數據結構 |
EmotionalData.java | 情感數據結構 |
DreamResult.java | 做夢結果 |
| 檔案 | 功能描述 |
|---|---|
ShortTermPool.java | 短期記憶池 |
| 檔案 | 功能描述 |
|---|---|
Memory3DTools.java | MCP 工具集 |
| 檔案 | 功能描述 |
|---|---|
Memory3DConfig.java | 系統配置 |
| 檔案 | 功能描述 |
|---|---|
Memory3DApplication.java | Spring Boot 應用入口 |
| 工具 | 功能 |
|---|---|
hold | 存儲記憶 |
recall | 檢索記憶 |
recall_3d | 三維記憶檢索 |
collect_memory | 生成記憶摘要 |
sleep | 手動觸發睡眠週期 |
awake | 每日喚醒流程 |
conversation_start | 對話啟動流程 |
get_status | 獲取系統狀態 |
sleep:
enabled: true
start_time: "02:00"
end_time: "06:00"
timezone: "Asia/Taipei"
awakening:
enabled: true
recall_days: 7
min_importance: 5
search:
sensory_weight: 0.3
spatiotemporal_weight: 0.3
emotional_weight: 0.4
每個記憶以 Markdown + YAML 格式存儲：
---
id: memory_20260420_160000
created_at: 2026-04-20T16:00:00+08:00
importance: 7
tags: [社交, 咖啡廳, 朋友]
sensory:
visual:
scenes: [咖啡廳, 窗邊座位]
colors: [暖黃色燈光]
auditory:
sounds: [輕音樂, 咖啡機運轉聲]
olfactory:
scents: [咖啡香]
spatiotemporal:
timestamp:
absolute: 2026-04-20T16:00:00+08:00
relative: 週六下午
location:
physical: 台北車站附近咖啡廳
context:
type: 社交
emotional:
valence: 0.7
arousal: 0.5
feel: 溫暖而安心，感受到友誼的珍貴
---
今天和朋友在咖啡廳聊天...
Passkey 應用程式使用 Web Bluetooth API，可掃描並連接藍牙裝置。
| 條件 | 說明 |
|---|---|
| HTTPS | 必須使用 https:// 或 http://localhost |
| 瀏覽器 | Chrome、Edge、Opera（Safari 和 Firefox 不支援） |
| 使用者觸發 | 掃描必須由使用者點擊按鈕觸發 |
| 瀏覽器 | Web Bluetooth 支援 |
|---|---|
| Chrome (Desktop) | ✅ 完整支援 |
| Chrome (Android) | ✅ 完整支援 |
| Edge (Desktop) | ✅ 完整支援 |
| Opera (Desktop) | ✅ 完整支援 |
| Safari | ❌ 不支援 |
| Firefox | ❌ 不支援 |
| iOS Safari | ❌ 不支援 |
瀏覽器內建 Web Speech API
Transformers.js Whisper（本機運算）
外部 API
瀏覽器內建 SpeechSynthesis
外部 API
| 語言 | STT | TTS |
|---|---|---|
| 繁體中文（台灣） | ✅ | ✅ |
| 简体中文（中国） | ✅ | ✅ |
| 日本語 | ✅ | ✅ |
| 한국어 | ✅ | ✅ |
| English | ✅ | ✅ |
| Español | ✅ | ✅ |
| Français | ✅ | ✅ |
| Deutsch | ✅ | ✅ |
| 瀏覽器 | 支援程度 | 備註 |
|---|---|---|
| Chrome | ✅ 完整支援 | 推薦使用 |
| Edge | ✅ 完整支援 | 推薦使用 |
| Firefox | ✅ 基本支援 | 部分動畫效果可能不同 |
| Safari | ⚠️ 部分支援 | 建議啟用 Transformers.js |
| 瀏覽器 | 支援程度 | 備註 |
|---|---|---|
| iOS Safari | ⚠️ 部分支援 | 不支援 Web Bluetooth |
| Android Chrome | ✅ 完整支援 | 推薦使用 |
| Android Firefox | ✅ 基本支援 | - |
| Samsung Internet | ✅ 基本支援 | - |
| Via 瀏覽器 | ✅ 基本支援 | - |
| XBrowser | ✅ 基本支援 | - |
| UC Browser | ✅ 基本支援 | - |
| QQ Browser | ✅ 基本支援 | - |
| 雨見瀏覽器 | ✅ 基本支援 | - |
git clone https://github.com/your-repo/sxiphone.git
cd sxiphone
npm install
方式一：使用 Python
python -m http.server 8080
方式二：使用 Vite（開發模式）
npm run dev
http://localhost:8080npm run build
專案可直接部署至：
注意：如需使用藍牙功能，部署環境必須使用 HTTPS。
開啟 index.html 後，您會看到仿 iOS 的鎖定畫面：
首次使用聊天功能需要設定 API：
基本操作：
進階功能：
觀看內容：
自訂內容：
東方占卜：
西方占卜：
播放音樂：
AI 作曲：
連接裝置：
注意：
外觀應用提供四種主題模式：
| 模式 | 說明 |
|---|---|
| 淺色 | 系統預設淺色主題 |
| 深色 | 系統預設深色主題 |
| 自定義淺色 | 使用者自訂淺色主題，可調整所有設定 |
| 自定義深色 | 使用者自訂深色主題，可調整所有設定 |
每個應用程式都支援獨立的外觀設定：
可調整項目：
設定繼承：
所有外觀設定會自動同步到 GitHub 備份（如已設定），支援跨裝置使用。
iOS：
Android：
應用程式支援以下語言：
語言設定會自動根據瀏覽器語言調整，也可在設定中手動切換。
本機運行：
npm installpython -m http.server 8080npm run devhttp://localhost:8080部署至雲端：
專案可直接部署至 Vercel、Netlify、GitHub Pages 等靜態網頁託管服務。
注意：如需使用藍牙功能，部署環境必須使用 HTTPS。
步驟一：解鎖進入主畫面
開啟應用後，您會看到仿 iOS 的鎖定畫面。從左向右滑動即可解鎖進入主畫面。
步驟二：設定 API
首次使用聊天功能需要設定 API：
步驟三：建立角色
| 操作 | 說明 |
|---|---|
| 開啟應用 | 點擊主畫面上的應用圖示 |
| 返回主畫面 | 點擊底部 Home 指示條或向上滑動 |
| 查看所有應用 | 主畫面顯示所有已安裝的應用程式圖示 |
| 應用程式庫 | 向左滑動至最後一頁查看應用程式庫 |
設定應用是 Sxiphone 的核心配置中心，包含 API 設定、角色管理、用戶管理、GitHub 備份、記憶系統等功能。
支援的 AI 模型：
| 類型 | 支援模型 |
|---|---|
| 大型模型 | Claude 4.2/4.6/Opus/Sonnet、GPT-4o/5.2、Gemini 3.1 |
| 中型模型 | DeepSeek、Kimi 2.5、GLM、MiniMax、Grok 4.2 |
| 本地模型 | Ollama、LM Studio 等 OpenAI Compatible API |
設定步驟：
https://api.anthropic.com）claude-sonnet-4-20250514）多 API 管理：
新增角色：
編輯角色：
刪除角色：
角色資料儲存位置：
sx_characterssx_char_namesx_char_avatarsx_char_personality、sx_char_background、sx_char_examples設定用戶資訊：
多用戶支援：
NPC（非玩家角色）可用於劇場、約會等場景中的配角設定。
新增 NPC：
GitHub 備份功能可將所有設定同步至 GitHub 私有儲存庫，實現跨裝置資料同步。
設定步驟：
repo 權限sxiphone-backup）backup/sxiphone.json）備份操作：
備份內容：
備份涵蓋所有 sx_、api_、sxiphone 開頭的 localStorage 與 localForage 資料，包括：
AI 睡眠週期用於模擬角色的休息時間，並在睡眠時段進行記憶整理。
設定項目：
| 項目 | 說明 | 預設值 |
|---|---|---|
| 睡眠開始時間 | 角色開始睡眠的時間 | 23:00 |
| 睡眠結束時間 | 角色醒來的時間 | 07:00 |
| 啟用睡眠週期 | 是否啟用自動睡眠 | 開啟 |
睡眠任務：
| 任務 | 說明 |
|---|---|
| 記憶鞏固 | 將短期記憶轉為長期記憶 |
| 向量化處理 | 為記憶建立向量索引 |
| 關聯建立 | 建立記憶間的關聯連結 |
| 衰減處理 | 根據遺忘曲線調整記憶權重 |
手動觸發睡眠：
點擊「立即執行睡眠」可手動觸發記憶整理流程。
外觀應用提供完整的視覺自訂功能，包括主題模式、重點色、框架設定、開機動畫等。
四種主題模式：
| 模式 | 說明 |
|---|---|
| 淺色 | 系統預設淺色主題，適合日間使用 |
| 深色 | 系統預設深色主題，適合夜間使用 |
| 自定義淺色 | 使用者自訂淺色主題，可調整所有設定 |
| 自定義深色 | 使用者自訂深色主題，可調整所有設定 |
切換主題：
預設顏色選擇：
提供多種預設重點色供選擇，點擊即可套用。
自訂顏色：
AI 生成主題色：
手機框架：
選擇不同手機外框樣式，模擬不同裝置的視覺效果。
桌布設定：
圖示風格：
調整應用圖示的大小和排列方式。
設定項目：
| 項目 | 說明 |
|---|---|
| 啟用開機動畫 | 是否顯示開機動畫 |
| 顯示文字 | 開機動畫顯示的文字 |
| 背景配色 | 開機動畫的背景顏色 |
| 裝飾元素 | 開機動畫的裝飾效果 |
每個應用程式都支援獨立的外觀設定。
開啟方式：
可調整項目：
顏色設定：
字體設定：
排版設定：
特效設定：
進階設定：
設定繼承：
世界書（Worldbook）是 Sxiphone 的核心功能之一，用於設定 AI 角色的知識庫、行為規則和寫作風格。
世界書是一組「條目」的集合，每個條目包含：
世界書的作用：
觸發機制：
用戶發送訊息 → 系統掃描關鍵字 → 匹配世界書條目 → 插入內容到上下文 → AI 生成回應
插入位置：
條目內容會根據分類插入到不同的位置：
1. 思維鏈（Chain of Thought, CoT）
用於設定 AI 的推理邏輯和思考方式。
適用場景：
範例條目：
標題：角色思考模式
關鍵字：思考、決定、選擇
內容：
在回應之前，請先進行以下思考步驟：
1. 分析用戶的情緒狀態
2. 考慮角色的性格特點
3. 選擇最符合當下情境的回應方式
2. 文風（Style）
用於設定 AI 的寫作風格、語氣和表達方式。
適用場景：
範例條目：
標題：文學風格
關鍵字：描寫、敘述
內容：
寫作風格要求：
- 使用細膩的感官描寫
- 多用比喻和象徵
- 保持詩意的語言節奏
- 避免過於直白的表達
3. 全域（Global）
全局設定，適用於所有對話場景。
適用場景：
範例條目：
標題：角色基本設定
關鍵字：*
內容：
你是 [角色名]，一位 [角色身份]。
性格特點：[性格描述]
背景故事：[背景描述]
重要關係：[關係描述]
4. 關鍵字（Keywords）
根據特定關鍵字觸發的條目。
適用場景：
範例條目：
標題：咖啡知識
關鍵字：咖啡、拿鐵、美式、卡布奇諾
內容：
關於咖啡的專業知識：
- 拿鐵：濃縮咖啡與蒸奶的比例約 1:3
- 美式：濃縮咖啡加水稀釋
- 卡布奇諾：濃縮咖啡、蒸奶、奶泡各 1/3
5. 後端（Backend）
用於 API 相關設定，不直接插入對話上下文。
適用場景：
世界書的權重系統用於控制記憶提取的優先級。
基礎權重配置：
| 維度 | 基礎權重 | 說明 |
|---|---|---|
| 空間／環境 | 0.35 | 第二入口，強錨點 |
| 五感（綜合） | 0.40 | 感知是主要記憶載體 |
| 時間 | 0.15 | 最後才浮現，相對弱 |
| 情緒狀態 | 0.10 | 隱性但影響提取方向 |
五感內部權重：
| 感官 | 權重 | 說明 |
|---|---|---|
| 視覺 | 0.25 | 主要感官 |
| 聽覺 | 0.25 | 主要感官 |
| 嗅覺 | 0.20 | 唯一不經視丘直接連接杏仁核與海馬迴，記憶觸發效率最高 |
| 觸覺 | 0.20 | 身體感知入口 |
| 味覺 | 0.10 | 相對較少觸發 |
權重設計原理：
新增條目：
編輯條目：
啟用/停用條目：
刪除條目：
Sxiphone 內建 24 種世界書預設，分為以下類型：
創作預設：
| 預設名稱 | 說明 |
|---|---|
| 象牙塔預設 | 完整的創作心錨與文風設定 |
| 象牙塔 核心預設 | SxiPhone 核心世界書 |
| 象牙塔 劇場預設 | 劇場模式專用設定 |
| 象牙塔 條件預設 | 條件觸發式設定 |
| 月讀 Chat預設 | 日常聊天對話場景 |
| 月讀 Lofter預設 | 文學創作場景 |
| 月讀 Theater預設 | 劇場生成場景 |
| 文學風格預設 | 文學寫作風格設定 |
| 飲食預設 | 飲食相關設定 |
| 通用重置預設 | 通用重置設定 |
模型專用預設：
| 預設名稱 | 適用模型 |
|---|---|
| Claude 4.2 預設 | Claude 4.2 |
| Claude 4.6 預設 | Claude 4.6 |
| Claude Opus 預設 | Claude Opus |
| Claude Sonnet 預設 | Claude Sonnet |
| GPT-4o 預設 | GPT-4o |
| GPT-5.2 預設 | GPT-5.2 |
| Gemini 3.1 預設 | Gemini 3.1 |
| DeepSeek 預設 | DeepSeek |
| DeepSeek 2 預設 | DeepSeek 2 |
| 智譜 GLM 預設 | GLM |
| Kimi 預設 | Kimi |
| Kimi 2.5 預設 | Kimi 2.5 |
| MiniMax 預設 | MiniMax |
| Grok 4.2 預設 | Grok 4.2 |
| Mino 預設 | Mino |
導入內建預設：
啟用/停用世界書：
在世界書應用中，可以整體啟用或停用世界書功能。
插入位置設定：
不同分類的條目會自動插入到對應位置，無需手動設定。
與角色關聯：
1. 條目設計原則：
2. 分類使用建議：
3. 效能優化：
4. 模型選擇建議：
聊天應用是 Sxiphone 的核心功能，提供豐富的即時通訊體驗。
發送訊息：
訊息類型：
| 類型 | 說明 |
|---|---|
| 文字訊息 | 基本文字對話 |
| 語音訊息 | 錄音或文字轉語音 |
| 圖片訊息 | 發送或生成圖片 |
| 位置訊息 | 分享地理位置 |
| 紅包/轉帳 | 金錢相關互動 |
對話操作：
切換角色：
角色狀態：
錄音發送：
文字轉語音：
語音設定：
在設定中可以配置：
發起通話：
通話功能：
| 功能 | 說明 |
|---|---|
| 通話錄音 | 自動錄音通話內容 |
| 逐字稿 | 通話結束後可查看文字記錄 |
| 靜音 | 暫時關閉麥克風 |
| 掛斷 | 結束通話 |
查看通話記錄：
在「電話」應用中可以查看所有通話記錄、錄音檔案和逐字稿。
發送現有圖片：
AI 生成圖片：
圖片設定：
可在「照相館」應用中設定：
發送位置：
位置設定：
在設定中可以設定預設位置，用於天氣等功能。
紅包與轉帳功能整合 Kakaopay 應用。
發送紅包：
發送轉帳：
查看交易記錄：
在「Kakaopay」應用中可以查看所有交易記錄和餘額。
偷看心聲功能可以查看角色的內心想法。
使用方式：
注意事項：
查手機功能可以觸發特殊事件，讓角色主動發送訊息。
使用方式：
事件類型：
在聊天應用中可以掛載世界書設定。
掛載方式：
掛載效果：
掛載後，對話中會自動觸發相關的世界書條目。
串流模式：
溫度設定：
控制 AI 回應的創意程度：
最大 Token 數：
設定 AI 回應的最大長度。
聊天應用與記憶系統深度整合。
記憶提取：
對話過程中，系統會自動提取：
記憶喚醒：
每次對話開始時，系統會根據記憶權重提取相關記憶，讓角色能夠回憶過去的互動。
Sxiphone 內建多種社交媒體應用，提供沉浸式的角色扮演體驗。
功能概覽：
| 功能 | 說明 |
|---|---|
| 動態消息牆 | 瀏覽角色發布的貼文 |
| 限時動態 | 查看角色的限時動態 |
| 社團 | 加入或建立社團 |
| 好友管理 | 管理好友列表 |
| 按讚/留言/分享 | 互動功能 |
使用方式：
角色視角：
切換不同角色可以看到不同角色的 Facebook 內容。
功能概覽：
| 功能 | 說明 |
|---|---|
| 相片牆 | 瀏覽角色發布的照片 |
| 限時動態 | 查看角色的限時動態 |
| 個人主頁 | 查看角色資料和貼文 |
| 標籤頁面 | 瀏覽特定標籤的內容 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 推文 | 瀏覽角色發布的推文 |
| 轉推 | 分享推文 |
| 書籤 | 收藏推文 |
| 通知 | 查看互動通知 |
| 探索 | 發現新內容 |
使用方式：
Weverse 是韓星粉絲社群平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| Feed | 瀏覽藝人動態 |
| Media | 查看媒體內容 |
| Live | 觀看直播 |
| 官方公告 | 查看官方公告 |
使用方式：
Bubbles 是粉絲聊天平台模擬。
功能概覽：
LOFTER（樂乎）是創作社群平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 文章發布 | 發布創作內容 |
| 標籤管理 | 管理文章標籤 |
| CP 設定 | 設定配對關係 |
| 世界書掛載 | 掛載專屬世界書 |
使用方式：
CP 設定：
在設定中可以設定配對關係，影響文章生成的內容方向。
AO3（Archive of Our Own）是同人作品平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 小說閱讀 | 閱讀同人小說 |
| 創作功能 | 創作新作品 |
| 多語言支援 | 支援多種語言 |
| 分級設定 | 設定內容分級 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 影片播放 | 播放影片內容 |
| 訂閱頻道 | 訂閱喜愛的頻道 |
| 播放清單 | 管理播放清單 |
| 觀看歷史 | 查看觀看記錄 |
| 推薦系統 | AI 推薦相關內容 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 彈幕功能 | 發送和查看彈幕 |
| 番劇追蹤 | 追蹤動漫番劇 |
| 直播 | 觀看直播內容 |
| 遊戲中心 | 瀏覽遊戲內容 |
使用方式：
功能概覽：
| 功能 | 說明 |
|---|---|
| 實況聊天 | 與實況主互動 |
| 頻道追蹤 | 追蹤喜愛的頻道 |
| 分類瀏覽 | 按遊戲、生活、音樂等分類瀏覽 |
劇場是 Netflix 風格的互動式內容播放器。
功能概覽：
| 功能 | 說明 |
|---|---|
| 互動式內容 | 支援選擇分支的互動內容 |
| 自訂 HTML | 匯入自訂 HTML 內容 |
| 世界設定導入 | 導入世界書設定 |
| 參與者選擇 | 選擇角色/用戶/NPC 參與 |
| 性向設定 | 一般/BL/GL/BG/後宮/逆後宮 |
| 內容分級 | 普遍級至限制級 |
| 播放進度追蹤 | 記錄觀看進度 |
| 我的片單 | 管理收藏清單 |
使用方式：
自訂內容：
三消遊戲，提供多種世界主題和關卡系統。
玩法：
街機遊戲合集，包含多種小遊戲。
遊戲列表：
| 遊戲 | 說明 |
|---|---|
| 拉霸機 | 轉盤抽獎遊戲 |
| 抽卡模擬器 | 模擬抽卡體驗 |
| 貪食蛇 | 經典貪食蛇遊戲 |
代幣系統：
占卜小店，提供東方與西方占卜服務。
東方占卜：
| 功能 | 說明 |
|---|---|
| 紫微斗數 | 中國傳統命理學，分析命盤十二宮位 |
| 梅花易數 | 易經占卜系統，支援時間起卦與數字起卦 |
| 流年流月流日 | 農民曆運勢分析，結合節氣計算 |
西方占卜：
| 功能 | 說明 |
|---|---|
| 塔羅占卜 | 互動式洗牌、切牌、選牌，支援多種牌陣 |
| 西洋占星 | 本命命盤、雙人合盤 |
塔羅牌系統：
支援三種經典塔羅牌系統：
| 牌系 | 說明 |
|---|---|
| 偉特塔羅 | 最廣泛使用的塔羅牌系，適合初學者 |
| 托特塔羅 | 圖像充滿神秘學與埃及象徵，適合進階使用者 |
| 馬賽塔羅 | 圖案簡潔古典，強調數字與符號 |
塔羅牌陣：
| 牌陣 | 張數 | 用途 |
|---|---|---|
| 單張指引 | 1 | 當下指引與建議 |
| 三張牌陣 | 3 | 過去/現在/未來 |
| 塞爾特十字 | 10 | 全面分析 |
| 關係牌陣 | 7 | 感情關係分析 |
| 二選一牌陣 | 6 | 選擇決策 |
功能概覽：
| 功能 | 說明 |
|---|---|
| 天氣預報 | 當前天氣狀況 |
| 多日預報 | 未來幾天天氣預測 |
| 位置設定 | 設定查看天氣的位置 |
| 氣溫/濕度/風速 | 詳細氣象資訊 |
播放功能：
| 功能 | 說明 |
|---|---|
| 音樂播放器 | 播放音樂檔案 |
| 歌詞同步 | 顯示同步歌詞 |
| 播放清單 | 管理播放清單 |
| 收藏功能 | 收藏喜愛的歌曲 |
AI 作曲：
支援風格：
瀏覽器模擬應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 網頁瀏覽 | 瀏覽網頁內容 |
| 歷史記錄 | 查看瀏覽歷史 |
| 書籤管理 | 管理書籤 |
| 無痕模式 | 隱私瀏覽模式 |
| 快速連結 | 常用網站快捷方式 |
購物平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 商品瀏覽 | 瀏覽商品列表 |
| 購物車 | 管理購物車 |
| 訂單追蹤 | 追蹤訂單狀態 |
| AI 推薦 | AI 推薦商品 |
| 收藏清單 | 收藏喜愛商品 |
外送平台模擬。
功能概覽：
| 功能 | 說明 |
|---|---|
| 餐廳瀏覽 | 瀏覽附近餐廳 |
| 訂單追蹤 | 追蹤外送狀態 |
| 歷史訂單 | 查看歷史訂單 |
| 購物車 | 管理購物車 |
| 優惠券 | 使用優惠券 |
SillyTavern 整合應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 角色對話 | 與角色進行對話 |
| API 設定 | 設定 OpenAI Compatible API |
| 角色卡管理 | 管理角色卡 |
| 系統提示詞 | 自訂系統提示詞 |
約會場景模擬應用。
場景列表：
| 場景 | 說明 |
|---|---|
| 咖啡廳 | 休閒咖啡廳約會 |
| 公園 | 戶外公園散步 |
| 電影院 | 觀看電影 |
| 餐廳 | 浪漫晚餐 |
| 海灘 | 海灘約會 |
| 圖書館 | 安靜閱讀時光 |
功能特色：
| 功能 | 說明 |
|---|---|
| 場景編輯器 | 自訂約會場景 |
| 自訂地圖導入 | 匯入自訂地圖 |
| AI 控制器 | 自動問候、跟隨玩家、閒置反應 |
| 時間系統 | 模擬時間流逝，可調整速度 |
使用方式：
AI 繪圖工具。
功能概覽：
| 功能 | 說明 |
|---|---|
| 提示詞輸入 | 輸入繪圖描述 |
| LoRA 管理 | 管理風格模型 |
| 模型選擇 | 選擇繪圖模型 |
| 風格預設 | 多種風格預設 |
| 歷史紀錄 | 查看生成歷史 |
| 收藏功能 | 收藏喜愛作品 |
風格預設：
使用方式：
圖片管理應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 圖片管理 | 管理圖片檔案 |
| 桌布設定 | 設定主畫面/鎖屏桌布 |
| 分類瀏覽 | 全部/上傳/聊天/照相館 |
專注計時工具。
功能概覽：
| 功能 | 說明 |
|---|---|
| 專注計時 | 番茄工作法計時 |
| 自訂時長 | 調整專注和休息時間 |
| 統計數據 | 查看專注統計 |
| 歷史紀錄 | 查看歷史記錄 |
藍牙裝置連接與控制應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 掃描裝置 | 掃描附近的藍牙裝置 |
| 連接裝置 | 連接藍牙裝置 |
| 發現服務 | 發現裝置服務與特徵值 |
| 發送命令 | 發送控制命令 |
| 調整設定 | 調整強度與頻率 |
使用條件：
| 條件 | 說明 |
|---|---|
| HTTPS | 必須使用 https:// 或 http://localhost |
| 瀏覽器 | Chrome、Edge、Opera（Safari 和 Firefox 不支援） |
| 使用者觸發 | 掃描必須由使用者點擊按鈕觸發 |
使用方式：
小工具管理應用。
功能概覽：
懸浮球功能設定。
功能概覽：
| 功能 | 說明 |
|---|---|
| 懸浮球 | 顯示懸浮快捷按鈕 |
| 自訂選單 | 自訂快捷選單內容 |
| 手勢設定 | 設定手勢操作 |
圖像式記憶庫應用。
功能概覽：
| 功能 | 說明 |
|---|---|
| 雙分頁設計 | User 百科 / Char 百科 |
| 條目管理 | 新增、編輯、刪除條目 |
| 分類系統 | 重要記憶、關係人物、事件記錄、洞察反思 |
| Markdown 支援 | 支援 Markdown 格式 |
| 知識圖譜視圖 | 視覺化知識關聯 |
| 關鍵詞索引 | 快速檢索條目 |
| 時間軸視圖 | 按時間順序查看條目 |
| Notebook 導入 | 從 Notebook 匯入資料 |
| 記憶同步 | 與記憶系統同步 |
| 擴散激活檢索 | 智能關聯檢索 |
| 自動關聯連結 | 自動建立條目關聯 |
使用方式：
三維記憶系統詳細說明請參閱「記憶系統」章節。
啟用記憶系統：
記憶管理：
桌面安裝：
手機安裝：
iOS：
Android：
支援語言：
語言別名：
| 輸入 | 對應 |
|---|---|
| zh-TW, zh-HK, zh-MO | zh-Hant |
| zh-CN, zh-SG | zh-Hans |
切換語言：
Q: 聊天沒有回應？
Q: 語音功能無法使用？
Q: 藍牙連接失敗？
Q: 記憶系統沒有運作？
Q: PWA 安裝後無法離線使用？
位於 yue-api/ 目錄，提供 AI 音樂生成功能。
技術棧：Python + FastAPI + PyTorch
功能：
安裝與啟動：
cd yue-api
pip install -r requirements.txt
python main.py
API 端點：
| 端點 | 方法 | 功能 |
|---|---|---|
/api/yue/generate | POST | 生成音樂 |
/api/yue/status/{task_id} | GET | 查詢任務狀態 |
/api/yue/download/{task_id}/{file_type} | GET | 下載音訊 |
/api/yue/lyrics | POST | 生成歌詞 |
依賴：
fastapi==0.109.0
uvicorn==0.27.0
torch==2.1.0
transformers==4.36.0
accelerate==0.25.0
sentencepiece==0.1.99
soundfile==0.12.1
torchaudio==2.1.0
flash-attn==2.5.0
位於 memory-3d-java/ 目錄，提供三維記憶系統後端服務。
技術棧：Java 17 + Spring Boot 3.2.0
功能：
安裝與啟動：
cd memory-3d-java
mvn clean install
mvn spring-boot:run
配置檔案：
src/main/resources/application.yml - Spring Boot 配置主要依賴：
cd backend/ziwei-zenith
go run ./cmd/ziwei-server/main.go
sxiphone/
├── index.html # 主頁面
├── main.js # 主要邏輯（瀏覽器兼容、PWA、Firebase、記憶系統）
├── style.css # 全域樣式
├── sw.js # Service Worker（PWA 支援）
├── manifest.json # PWA 設定
├── vercel.json # Vercel 部署設定
├── browserconfig.xml # Edge/IE 圖示設定
├── package.json # 專案設定
├── package-lock.json # 依賴鎖定
│
├── apps/ # 應用程式目錄（50 個應用）
│ ├── chat/ # 聊天
│ ├── phone/ # 電話
│ ├── settings/ # 設定
│ ├── appearance/ # 外觀
│ ├── passkey/ # 藍牙
│ ├── music/ # 音樂
│ ├── drift-bottle/ # 占卜
│ ├── theater/ # 劇場
│ ├── dating/ # 約會
│ ├── worldbook/ # 世界書
│ ├── arcade/ # 街機廳
│ │ └── slot-items/ # 拉霸機圖示
│ ├── scripts/ # 共用腳本（記憶系統模組）
│ │ ├── memory-store.js # IndexedDB 記憶儲存
│ │ ├── embedding-engine.js # 文字向量化嵌入
│ │ ├── search-engine.js # 多維度檢索引擎
│ │ ├── decay-engine.js # 記憶衰減曲線
│ │ ├── emotion-tagger.js # 情感標記
│ │ ├── memory-classifier.js # 記憶分類
│ │ ├── dimension-encoder.js # 維度編碼
│ │ ├── sleep-engine.js # 睡眠週期處理
│ │ ├── memory-standardizer.js # 記憶標準化
│ │ ├── memory-manager.js # 記憶管理器
│ │ ├── daily-awakening.js # 每日喚醒流程
│ │ ├── awakening-engine.js # 喚醒引擎
│ │ ├── wiki-engine.js # Wiki 知識圖譜引擎
│ │ ├── app-appearance-settings.js # 應用程式外觀設定
│ │ ├── app-appearance-settings.css # 應用程式外觀樣式
│ │ ├── short-term-memory.js # 短期記憶池
│ │ ├── memory-pool.js # 記憶池
│ │ ├── unified-memory-system.js # 統一記憶系統
│ │ ├── memory-helper.js # 記憶輔助工具
│ │ ├── global-memory-system.js # 全域記憶系統
│ │ ├── background-keepalive.js # 背景保持運行
│ │ ├── chat-notification-engine.js # 聊天通知引擎
│ │ └── sx-notification.js # 系統通知管理器
│ ├── personal-wiki/ # 個人維基
│ │ ├── personal-wiki.html # 主頁面
│ │ ├── personal-wiki.css # 樣式
│ │ └── personal-wiki.js # 邏輯
│ ├── facebook-settings/ # Facebook 設定
│ │ ├── facebook-settings.html # 主頁面
│ │ └── facebook-settings.js # 邏輯
│ ├── theme-shop/ # 主題商店
│ │ ├── theme-shop.html # 主頁面
│ │ ├── theme-shop.css # 樣式
│ │ └── theme-shop.js # 邏輯
│ ├── screenshots/ # 截圖與圖標
│ └── ... # 其他應用
│
├── yue-api/ # YuE 音樂生成後端
│ ├── main.py # FastAPI 主程式
│ ├── models.py # 資料模型
│ ├── requirements.txt # Python 依賴
│ ├── start.bat # 啟動腳本
│ └── README.md # API 說明
│
├── memory-3d-java/ # 三維記憶系統 Java 後端
│ ├── pom.xml # Maven 設定
│ └── src/main/
│ ├── java/com/memory3d/
│ │ ├── Memory3DApplication.java # Spring Boot 入口
│ │ ├── config/
│ │ │ └── Memory3DConfig.java # 系統配置
│ │ ├── core/
│ │ │ ├── Memory3D.java # 三維記憶數據結構
│ │ │ ├── SensoryExtractor.java # 五感提取器
│ │ │ ├── SpatiotemporalTagger.java # 時空標註器
│ │ │ ├── Memory3DBuilder.java # 記憶構建器
│ │ │ ├── MemoryMetadata.java # 記憶元數據
│ │ │ ├── SensoryData.java # 感官數據
│ │ │ ├── SpatiotemporalData.java # 時空數據
│ │ │ ├── EmotionalData.java # 情感數據
│ │ │ └── DreamResult.java # 做夢結果
│ │ ├── storage/
│ │ │ └── ShortTermPool.java # 短期記憶池
│ │ └── mcp/
│ │ └── Memory3DTools.java # MCP 工具集
│ └── resources/
│ └── application.yml # Spring Boot 配置
│
├── scripts/ # 建置腳本
│ ├── copy-static.mjs # 複製靜態檔案
│ ├── generate-pwa-icon.js
│ └── generate-icon.js
│
├── docs/ # 文件
│ └── conversation-summary.md
│
├── plans/ # 規劃文件
│ └── sillytavern-import-spec.md
│
└── .kilo/ # Kilo CLI 設定
└── package.json
位於 apps/worldbook/ 目錄，支援多種模型世界書：
| 檔案 | 描述 |
|---|---|
ivory_tower_worldbook.json | 象牙塔世界書 |
象牙塔_核心預設_worldbook.json | 象牙塔世界書 |
象牙塔_劇場預設_worldbook.json | 象牙塔世界書 |
象牙塔_條件預設_worldbook.json | 象牙塔世界書 |
月讀_chat_worldbook.json | 月讀聊天用世界書 |
月讀_lofter_worldbook.json | 月讀同人文用世界書 |
月讀_theater_worldbook.json | 月讀小劇場用世界書 |
literary_style_worldbook.json | 文學風格世界書 |
minimax_worldbook.json | Minimax 模型世界書 |
glm_worldbook.json | GLM 模型世界書 |
claude42_worldbook.json | Claude 4.2 世界書 |
claude46_worldbook.json | Claude 4.6 世界書 |
sonnet_worldbook.json | Sonnet 世界書 |
opus_worldbook.json | Opus 世界書 |
kimi_worldbook.json | Kimi 世界書 |
kimi25_worldbook.json | Kimi 2.5 世界書 |
gemini31_worldbook.json | Gemini 3.1 世界書 |
deepseek_worldbook.json | DeepSeek 世界書 |
deepseek2_worldbook.json | DeepSeek 2 世界書 |
grok42_worldbook.json | Grok 4.2 世界書 |
4o_worldbook.json | GPT-4o 世界書 |
5.2_worldbook.json | GPT 5.2 世界書 |
mino_worldbook.json | Mino 世界書 |
eating_worldbook.json | 飲食世界書 |
universal_reset_worldbook.json | 通用重置世界書 |
蛾摩拉/蛾摩拉_chat_worldbook.json | 蛾摩拉聊天用世界書（作者：小回） |
蛾摩拉/蛾摩拉_lofter_worldbook.json | 蛾摩拉同人文用世界書（作者：小回） |
| 工具 | 功能 |
|---|---|
merge_model_worldbooks.js | 合併多模型世界書 |
convert_ivory_tower.js | 象牙塔格式轉換 |
convert_ivory_tower.py | Python 版轉換腳本 |
chat-notification-engine.js 模組sx-notification.js 模組蛾摩拉_chat_worldbook.json（聊天版本）蛾摩拉_lofter_worldbook.json（同人文版本）| 專案 | 用途 | 連結 |
|---|---|---|
| Vite | 前端建置工具 | 官網 |
| 專案 | 用途 | 連結 |
|---|---|---|
| tarot-api | 偉特塔羅牌資料 API | GitHub |
| Rider-Waite 1909 | 偉特塔羅牌圖像（公共領域） | Sacred Texts |
| Thoth Tarot | 托特塔羅牌圖像 | Wikimedia Commons |
| Tarot de Marseille | 馬賽塔羅牌圖像 | Wikimedia Commons |
| 專案 | 用途 | 連結 |
|---|---|---|
| Font Awesome | 圖示庫 | 官網 |
| Lucide | 圖示庫 | 官網 |
| Material Symbols | Google 圖示 | Google Fonts |
| Great Vibes | 手寫藝術字型 | Google Fonts |
| API | 用途 | 文件 |
|---|---|---|
| Web Bluetooth API | 藍牙裝置連接 | MDN |
| Web Speech API | 語音辨識與合成 | MDN |
| Web Audio API | 音訊處理 | MDN |
| Service Worker API | PWA 離線支援 | MDN |
| IndexedDB | 本地資料庫 | MDN |
| 專案 | 用途 | 連結 |
|---|---|---|
| SillyTavern | 角色對話平台參考 | GitHub |
| 象牙塔 | 預設角色設定 | 由電波系老師提供 |
| 蛾摩拉 | 預設角色設定 | 由小回老師提供 |
| 月讀預設系統 | 預設角色設定 | 由電波系老師提供 |
本專案僅供學習和個人使用。開放二改，但需附上原 README 連結，開發者僅保留署名權。
歡迎提交 Issue 和 Pull Request。
本節詳細說明 Sxiphone 的 API 連接機制，包含各種 API 類型的設定方式、多 API 管理策略、以及常見問題排除。
Sxiphone 支援三種 API 類型，以適應不同的 AI 服務：
大多數 AI API 都支援 OpenAI 格式，這是 Sxiphone 的預設選項。
| 項目 | 說明 |
|---|---|
| 端點格式 | 輸入 Base URL，系統自動加上 /chat/completions |
| 適用服務 | OpenAI、OpenRouter、DeepSeek、Kimi、GLM、MiniMax、Grok 等 |
| 請求格式 | 標準 OpenAI Chat Completions API |
設定範例：
API 類型：OpenAI 相容
Base URL：https://openrouter.ai/api/v1
API Key：sk-or-v1-xxxxx
模型：anthropic/claude-sonnet-4
端點處理邏輯：
// 輸入：https://openrouter.ai/api/v1
// 實際請求：https://openrouter.ai/api/v1/chat/completions
const endpoint = apiUrl.endsWith('/chat/completions')
? apiUrl
: apiUrl.replace(/\/$/, '') + '/chat/completions';
Google Gemini 使用專屬的 API 格式。
| 項目 | 說明 |
|---|---|
| 端點格式 | 需要完整的 Gemini API URL |
| API Key 位置 | 放在 URL 參數中，而非 Header |
| 請求格式 | Google Generative AI 格式 |
設定範例：
API 類型：Gemini
端點：https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=YOUR_API_KEY
模型：gemini-pro
用於不支援 OpenAI 格式的特殊 API 或自建服務。
| 項目 | 說明 |
|---|---|
| 端點格式 | 輸入完整 URL，系統不會修改 |
| 適用場景 | 自建 API、特殊格式服務 |
| 注意事項 | 需自行確保端點可正確回應 |
| 欄位 | 說明 | 範例 |
|---|---|---|
| API 類型 | 選擇 API 格式類型 | OpenAI 相容 |
| 端點 URL | API Base URL 或完整端點 | https://api.openai.com/v1 |
| API Key | 認證金鑰 | sk-xxxxx |
| 模型 | 使用的模型名稱 | gpt-4o |
點擊「拉取模型」按鈕可自動獲取該 API 支援的模型清單：
{Base URL}/models 發送 GET 請求HTTP-Referer 和 X-TitleSxiphone 支援同時儲存多組 API 設定：
每個角色可以指定專屬的 API：
當角色沒有指定 API 時，系統使用以下優先順序：
getActiveApiWithFallback 取得）聊天應用是 API 的主要使用者，用於角色對話生成：
// 取得 API 設定
const api = window.SettingsReader.getActiveApiWithFallback();
const endpoint = api.url + '/chat/completions';
// 發送請求
const response = await fetch(endpoint, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${api.key}`
},
body: JSON.stringify({
model: api.model,
messages: [...],
temperature: 0.85,
max_tokens: 500
})
});
聊天應用包含 generateDiaryFromAI 函式，用於生成角色日記：
sxiphone_lang 設定）交換日記功能使用 API 生成日記內容，支援：
個人維基使用 API 進行：
漂流瓶功能使用 API 生成：
| 模型 | 特性 | 推薦用途 |
|---|---|---|
| Claude 4.2 | 最新版本，效能最佳 | 複雜對話、創作 |
| Claude Opus | 最強推理能力 | 深度分析、角色扮演 |
| Claude Sonnet | 平衡效能與成本 | 日常對話 |
推薦參數：
temperature: 0.85 - 1.0max_tokens: 500 - 2000| 模型 | 特性 | 推薦用途 |
|---|---|---|
| GPT-4o | 多模態支援 | 圖文對話 |
| GPT-4o-mini | 高效低成本 | 日常對話 |
推薦參數：
temperature: 0.8 - 1.0max_tokens: 500 - 1500| 模型 | 特性 | 推薦用途 |
|---|---|---|
| Gemini Pro | 平衡效能 | 一般對話 |
| Gemini Ultra | 最強效能 | 複雜任務 |
注意事項：
| 模型 | 特性 | 推薦用途 |
|---|---|---|
| DeepSeek Chat | 通用對話 | 日常使用 |
| DeepSeek Coder | 程式碼專精 | 技術對話 |
推薦參數：
temperature: 0.7 - 0.9| 項目 | 說明 |
|---|---|
| 端點 | http://localhost:11434/v1（Ollama） |
| 優點 | 免費、隱私、可離線使用 |
| 缺點 | 效能取決於硬體 |
設定範例：
API 類型：OpenAI 相容
Base URL：http://localhost:11434/v1
API Key：（留空或任意值）
模型：llama3
症狀：控制台顯示 CORS 相關錯誤
解決方案：
症狀：401 Unauthorized 錯錯誤
檢查項目：
症狀：模型名稱錯誤
解決方案：
anthropic/claude-sonnet-4）症狀：請求長時間無回應
可能原因：
解決方案：
max_tokens 參數症狀：無法解析 API 回應
可能原因：
解決方案：
本節說明 Sxiphone 的技術架構，供開發者和進階使用者參考。
Sxiphone 使用瀏覽器的本地儲存機制來保存所有資料：
用於儲存設定和小型資料：
用於儲存大量資料：
所有 Sxiphone 使用的 localStorage key 都以 sx_ 開頭：
| Key | 用途 | 類型 |
|---|---|---|
sx_user_name | 使用者名稱 | 字串 |
sx_user_avatar | 使用者頭像 | 字串（URL/Base64） |
sx_user_personality | 使用者性格 | 字串 |
sx_user_background | 使用者背景 | 字串 |
| Key | 用途 | 類型 |
|---|---|---|
sx_characters | 角色清單 | JSON 陣列 |
sx_char_name | 目前角色名稱 | 字串 |
sx_char_avatar | 目前角色頭像 | 字串 |
sx_char_personality | 目前角色性格 | 字串 |
sx_char_background | 目前角色背景 | 字串 |
sx_char_examples | 對話範例 | 字串 |
| Key | 用途 | 類型 |
|---|---|---|
apis | API 設定清單 | JSON 陣列 |
sx_active_api | 啟用的 API 索引 | 數字字串 |
| Key | 用途 | 類型 |
|---|---|---|
sx_worldbook_cot | CoT 條目 | JSON 陣列 |
sx_worldbook_style | 風格條目 | JSON 陣列 |
sx_worldbook_global | 全域條目 | JSON 陣列 |
sx_worldbook_keywords | 關鍵字條目 | JSON 陣列 |
sx_worldbook_backend | 後端條目 | JSON 陣列 |
sx_worldbook_theater | 劇場條目 | JSON 陣列 |
| Key | 用途 | 類型 |
|---|---|---|
sx_short_term_memory | 短期記憶 | JSON 陣列 |
sx_memory_interval | 記憶整理間隔 | 數字字串 |
sx_ai_sleep_start | AI 睡眠開始時間 | 字串（HH:MM） |
sx_ai_sleep_end | AI 睡眠結束時間 | 字串（HH:MM） |
sx_ai_sleep_enabled | AI 睡眠功能啟用 | 布林字串 |
sx_ai_sleep_tasks | 睡眠時執行的任務 | JSON 物件 |
| Key | 用途 | 類型 |
|---|---|---|
sx_github_pat | GitHub Personal Access Token | 字串 |
sx_github_user | GitHub 使用者名稱 | 字串 |
sx_github_repo | GitHub 儲存庫名稱 | 字串 |
sx_github_backup_file | 備份檔案名稱 | 字串 |
sx_auto_backup_enabled | 自動備份啟用 | 布林字串 |
sx_auto_backup_github | GitHub 自動備份 | 布林字串 |
sx_auto_backup_supabase | Supabase 自動備份 | 布林字串 |
sx_auto_backup_local | 本地自動備份 | 布林字串 |
| Key | 用途 | 類型 |
|---|---|---|
sx_masks | 外觀主題清單 | JSON 陣列 |
sxiphone_lang | 介面語言 | 字串 |
apps/
├── chat/ # 聊天應用
│ ├── chat.js # 主要邏輯
│ ├── chat.css # 樣式
│ └── index.html # 頁面
├── settings/ # 設定應用
│ └── settings.js # 設定邏邏輯
├── diary/ # 日記應用
├── gallery/ # 照相館
├── worldbook/ # 世界書
└── scripts/ # 共用腳本
└── unified-storage-manager.js
| 腳本 | 用途 |
|---|---|
unified-storage-manager.js | 統一儲存管理 |
SettingsReader | 讀取設定和 API 資訊 |
外觀設定採用繼承機制：
應用程式採用動態載入：