CharacterArc(弧光)不是"只会对话的 AI 壳子",而是一套围绕小说项目组织、章节写作与 AI 协作搭起来的桌面工作台。

下面这组截图按实际创作流程排列,基本覆盖了弧光从项目管理、拆书沉淀、Skill 配置到章节写作和封面生成的主要体验。

• Node.js 18+
• pnpm 10+
• Windows / macOS(打包需使用目标平台运行:Windows 打 NSIS,macOS 打 DMG/ZIP)

# 安装依赖
pnpm install
# 启动开发环境(同时启动 Electron 主进程 + Vite 渲染进程)
pnpm run dev
# 类型检查 + 构建
pnpm run build
# 打包 Windows 安装程序
pnpm run dist:win
# 打包 macOS 安装包(在 macOS 上运行)
pnpm run dist:mac

macOS 产物为 ad-hoc 签名、未公证的 .dmg / .zip,适合内部安装测试;正式分发给普通用户需要配置 Apple Developer 证书与 notarization。

仓库内置 GitHub Actions 工作流 .github/workflows/release.yml:

• workflow_dispatch:手动触发构建
• v* tag push:版本标签触发构建
• 相关打包配置变更的 PR:验证 macOS 打包

工作流分别在 macos-26 与 macos-26-intel runner 上构建 Apple Silicon (arm64) 和 Intel (x64) 产物,并上传到 Actions artifacts。macOS runner 版本以 GitHub-hosted runners 当前提供的镜像标签为准;当前配置使用 ad-hoc 签名且未做公证。如需正式发布,需补充 CSC_LINK、CSC_KEY_PASSWORD、APPLE_ID、APPLE_APP_SPECIFIC_PASSWORD、APPLE_TEAM_ID 等 secrets 并启用 Developer ID 签名/公证流程。

首次进入应用后,在「设置」面板中填写:

CharacterArc/
├── electron/
│ ├── main/
│ │ ├── ai/ # AI 管线
│ │ │ ├── agent/ # Agent Loop、系统提示词、工具注册表
│ │ │ ├── prompts/ # 通用提示词片段
│ │ │ ├── runtime/ # 任务调度、上下文构建
│ │ │ ├── skills/ # Skill 加载与匹配
│ │ │ ├── tasks/ # 各 AI 任务 handler
│ │ │ └── transport/ # 模型传输层(OpenAI 兼容 / Anthropic / 图像)
│ │ ├── index.ts # 主进程入口
│ │ ├── register-main-ipc.ts # IPC 注册
│ │ ├── window-manager.ts # 窗口管理
│ │ ├── workspace-store.ts # SQLite 建表、迁移、快照读写
│ │ └── knowledge-retrieval.ts # 章节调用前的本地知识检索
│ ├── preload/ # window.characterArc 桥接层
│ └── shared/ # 主进程/渲染层共享类型
├── renderer/
│ └── src/
│ ├── components/ # 业务组件
│ │ ├── chapterWorkspace/ # 章节创作工作区
│ │ └── home/ # 首页/项目中心
│ ├── features/ # 功能模块(ai、chapters、cover、knowledge、relations...)
│ ├── pages/ # 页面级视图
│ ├── stores/ # Pinia Store
│ ├── styles/ # 全局样式
│ ├── theme/ # 主题与设计令牌
│ ├── types/ # 共享类型
│ └── utils/ # 工具函数
├── resources/
│ ├── icon.ico / icon.png # 应用图标
│ └── skills/ # 内置 Skill 包
├── electron.vite.config.ts
├── package.json
└── tsconfig.json

┌─────────────────────────────────────────────────────────┐
│ Electron 主进程 │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │
│ │ 窗口管理 │ │ SQLite │ │ AI 管线 │ │
│ │ │ │ 读写/迁移 │ │ 调度 → Skill → 模型 │ │
│ └──────────┘ └──────────┘ └──────────────────────┘ │
├─────────────────── IPC 桥接 ────────────────────────────┤
│ Vue 渲染层 │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │
│ │ Pinia │ │ TipTap │ │ Naive UI 组件 │ │
│ │ Store │ │ 编辑器 │ │ │ │
│ └──────────┘ └──────────┘ └──────────────────────┘ │
└─────────────────────────────────────────────────────────┘

数据流:启动 → 主进程建窗 → 渲染层初始化 Store → 从 SQLite 加载工作区 → 用户编辑 → Pinia 更新 → 防抖写回 SQLite → AI 请求统一由主进程调用

应用当前在 resources/skills/ 下内置 3 组、共 28 个 Skill。技能面板会按来源分组展示,开发版与打包版使用同一套目录结构。

• story-long-write、story-long-analyze、story-long-scan
• story-short-write、story-short-analyze、story-short-scan
• story-chapter-exec、story-chapter-repair
• story-blueprint、story-cover、story-deslop、story-format-tomato

• humanizer-zh:中文小说去 AI 味润色
• style-fingerprint:提取参考文本的风格指纹
• style-fusion:组合多个来源的风格特征

• novel-anti-detection:反 AI 检测与混合创作风控
• novel-character-design:主角、配角、反派与人物弧光设计
• novel-commercialization:平台选择、签约与商业化方向
• novel-compliance:平台规则、敏感词与内容合规
• novel-emotion:情绪曲线、共情点与沉浸感设计
• novel-genres:题材选择、子类融合与赛道判断
• novel-innovation:反套路、微创新与趋势参考
• novel-language-style:文风、视角、修辞与画面感
• novel-pacing:开篇、断章、高潮与整体节奏
• novel-pleasure-points:爽点设计与疲劳管理
• novel-polishing:润色、去 AI 味与风格增强
• novel-tools:提示词、写作工作流与发布分析
• novel-worldbuilding:世界观、势力、规则与设定一致性

resources/skills/<来源>/<skill-id>/SKILL.md 会被自动扫描为内置 Skill;同级的 scripts/ 等辅助目录不会被当成 Skill。

还可以导入独立的 Skill 包,作用范围仅限该项目。

应用数据保存在 Electron 用户目录下:

• 📊 数据库:<userData>/data/workspace.db(SQLite)
• 📦 项目 Skill:<userData>/project-skills/<project-scope>

🔒 所有数据完全本地,不上传任何第三方服务。

• oh-story-claudecode — 提供了核心写作 Skills 的方法论与 prompt 工程基础
• dama-cyber/Distilled-Novel-Toolbox — 提供了小说工作流与创作辅助方向的参考

• LINUX DO — 新的理想型社区

QQ群二维码

点击链接加入群聊:https://qm.qq.com/q/lTQfy3AYvY

MIT © zhouyeshan