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 合作写作伙伴。