uu201/character-arc

CharacterArc(弧光) AI 小说创作应用，集项目设定、角色关系、剧情大纲、章节写作与多模型 AI 协作于一体

📚 什麼是 CharacterArc？

CharacterArc（弧光）是一款適用於 Windows/macOS 的桌面應用程式，協助小說作者組織專案並與大型語言模型（LLM）服務協作。它不僅僅是聊天視窗——它提供一個功能完整的寫作工作區，您可在其中儲存世界觀資料、規劃情節、編輯章節，並執行 AI 驅動的助手（稱為 Skills）來生成、潤色或分析文字。所有資料均本地儲存在 SQLite 資料庫中，因此您可以完全掌控您的手稿。

✨ 核心功能

領域	您可獲得的功能
專案管理	建立獨立的小說專案，每個專案擁有獨立的設定、知識庫與 AI 運行日誌。
世界觀與關係	人物、組織、場景的結構化表格；視覺化關係圖（Cytoscape）。
情節大綱	雙欄時間軸檢視，支援拖曳排序，AI 輔助擴展大綱節點。
章節工作區	三面板佈局——檔案樹、富文字編輯器（TipTap）與 AI 邊欄。支援自動儲存、版本快照、字數目標、專注/閱讀模式，以及匯出為 `.txt` 或 `.docx`。
AI 輔助	• 草稿生成、續寫、重寫、潤色、節奏調整。
• 摘要、伏筆檢測、下一場景建議。
• 多階段「草稿 → 審核 → 修復」流程。
• Agent Loop：模型可自動根據任務選擇並執行合適的 Skill。
Skill 系統	內建 28 個 Skills（如長篇寫作、風格指紋提取、防 AI 檢測）。您也可為每個專案匯入自訂 Skill 套件。
封面設計師	生成平台特定的封面提示，呼叫影像模型，並比較版本化預覽。
本地優先 & 多供應商	支援任何 OpenAI 相容 API（OpenAI、DeepSeek、Anthropic、Kimi 等）與 Anthropic 專用端點。所有請求透過您在設定面板中設定的可變基礎 URL 與 API 金鑰進行。
資料隱私	所有內容均本地儲存（Electron 使用者資料資料夾中的 `workspace.db`）。除非您自行新增，否則無雲端同步。

🛠️ 技術堆疊

框架：Electron + Vue 3（TypeScript）—— 提供原生桌面 UI 感。
狀態管理：Pinia。
UI 庫：Naive UI。
富文字編輯器：TipTap（支援搜尋/取代、格式化、選擇操作）。
持久化：SQLite（由 Electron 主程序處理）。
圖形視覺化：Cytoscape。
AI SDK：Vercel AI SDK（@ai-sdk/openai，@ai-sdk/anthropic）。
建置工具：electron-vite（Vite 7）。
文件解析：mammoth（用於 .docx），marked（用於 Markdown）。

🚀 快速上手（Windows/macOS）

# 1. 安裝前置需求
#    Node 18+ 和 pnpm 10+

# 2. 安裝相依套件
pnpm install

# 3. 開發模式執行（Electron + Vite 熱重載）
pnpm run dev

# 4. 建構生產版本
pnpm run build

# 5. 打包安裝檔
pnpm run dist:win   # Windows NSIS 安裝程式
pnpm run dist:mac   # macOS DMG/ZIP（需在 macOS 上執行）

首次啟動後，開啟 設定 → AI 並新增一個或多個 API 設定（基礎 URL、API 金鑰、模型名稱）。您可從標題列切換不同設定。

📦 Skill 套件（內建）

倉儲在 resources/skills/ 下提供了三組 Skill（共 28 個）：

來源	例子 Skill	目的
`oh-story-claudecode`	`story-long-write`, `story-chapter-exec`	核心小說寫作流程（長篇/短篇、章節執行、封面生成、防 AI 檢測等）。
`community-skills`	`humanizer-zh`, `style-fingerprint`	中文潤色、風格提取與融合。
`Distilled-Novel-Toolbox`	`novel-pacing`, `novel-worldbuilding`, `novel-commercialization`	全棧小說工具箱——節奏、世界觀建構、平台特定商業建議、合規性、情感曲線等。

每個 Skill 是一個包含 SKILL.md 說明與提示/範本檔案的資料夾；應用啟動時會自動掃描。您可將額外的 Skill 資料夾放入專案目錄下的 project-skills/ 中以擴展功能。

📄 授權

MIT 授權——可自由使用、修改與分發。

總結：CharacterArc 是一個基於 Electron 的本地執行寫作環境，透過模組化 Skill 系統緊密整合 LLM，為中文語境下的小說作者提供強大且保護隱私的 AI 合作寫作夥伴。