starc

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

关于

故事架构师（STARC）是一个开源应用程序，帮助作者从最初的创意发展到可用于生产的完整文档。它将无干扰写作与规划、研究、角色和地点开发、可视化工具、统计以及专业格式化相结合。

该项目由 KIT Scenarist 背后的团队创建，使用 C 和 Qt 构建。它可在 Windows、macOS 和 Linux 上运行，并且允许你使用任何语言进行写作。

亮点

• 多种写作格式 — 剧本、电视剧、小说、漫画书、舞台剧、有声剧、演示文稿以及自由形式文本。
• 专业模板 — 针对不同地区和行业惯例的页面预设。
• 一个地方管理整个故事 — 将草稿、剧本、笔记、研究、图片、角色、地点和故事世界集中在一起。
• 规划工具 — 大纲、卡片、时间线、思维导图、系列计划和剧本分解。
• 故事智能 — 统计数据、角色对白报告、角色关系、地点场景及其他分析视图。
• 灵活的工作流程 — 在单个项目中使用多个文档和多个草稿。
• 导入和导出 — 与流行的剧本写作和办公格式交换作品，包括 Final Draft、Fountain、DOCX、ODT、PDF、Celtx、Trelby 和 KIT Scenarist 格式（可用性因文档类型和方向而异）。
• 国际界面 — 数十种用户界面翻译，并支持从左到右和从右到左的书写系统。
• 跨平台桌面应用 — 提供 Windows、macOS 和 Linux 的本地安装包。

获取故事架构工具

开始最简单的方法是下载官方版本：

访问 starc.app/download 获取最新的稳定版和开发版。

从源代码构建

先决条件

该应用程序使用 C 17、Qt 和 qmake 构建。CI 当前测试 Qt 5 和 Qt 6 的构建。

你将需要：

• Git；
• 兼容 C 17 的编译器；
• Qt 5 或 Qt 6 与 qmake，包括 Core、GUI、Widgets、Concurrent、Multimedia、Network、SQL 和 XML；一些捆绑组件还使用 Qt GUI/Widgets 的私有头文件；
• 使用 Qt 6 时，Qt 5 Core 兼容模块（官方 CI 设置还安装了 Speech 和 WebSockets）；
• CMake、GNU Make 以及在 Linux/macOS 上的 pkg-config；
• Python 以及 Chromium 的 depot_tools 所需的平台构建工具（Crashpad 脚本会下载这些工具和源文件）；
• OpenSSL 和 zlib 开发文件。

在 Ubuntu/Debian 上，可以使用 CI 使用的本地软件包安装如下：

sudo apt update
sudo apt install \
  cmake make pkg-config libx11-dev xcb libx11-xcb-dev \
  libxkbcommon-x11-0 libxkbcommon-dev libgtk-3-dev \
  libgstreamer-plugins-base1.0-0 libcurl4-openssl-dev \
  zlib1g-dev libxcb-cursor0

1. 克隆仓库

git clone https://github.com/story-apps/starc.git
cd starc

初始化社区构建使用的公共 PDF 依赖项：

git submodule update --init --recursive \
  src/3rd_party/pdfhummus \
  src/3rd_party/pdftextextraction

2. 构建 Crashpad

从仓库根目录开始：

cd build
chmod +x build_crashpad.sh
./build_crashpad.sh
cd ..

有用的选项：

例如，使用 ./build_crashpad.sh -a x64 构建 64 位 Windows，或使用 ./build_crashpad.sh -u 构建通用 macOS。

3. 构建应用程序

cd src
qmake starc.pro CONFIG+=release
make -j"$(nproc)"

在 macOS 上，将 $(nproc) 替换为合适的数字，例如 4。在 Windows 上，从匹配的 Qt/MSVC 开发者环境运行 qmake，并使用 nmake：

cd src
qmake starc.pro CONFIG+=release CRASHPAD_ARCH=x64
nmake

构建产品会写入 src/_build/；主可执行文件名为 starcapp（Windows 上为 starcapp.exe）。

调试构建

Crashpad 与应用程序应使用相同的配置：

cd build
./build_crashpad.sh -d
cd ../src
qmake starc.pro CONFIG+=debug
make -j"$(nproc)"

项目结构

starc/
├── build/                  Packaging scripts and Crashpad builder
├── img/                    README artwork
└── src/
    ├── 3rd_party/          Bundled and submodule dependencies
    ├── app/                Application entry point
    ├── core/               Main application and feature UI
    ├── corelib/            Domain, data, business, and shared UI layers
    ├── interfaces/         Cross-module interfaces
    ├── testapp/            Internal test application
    └── starc.pro           Top-level qmake project

顶层 qmake 项目首先构建依赖项，然后是应用程序库、插件和可执行文件。

贡献

欢迎贡献。一个好的工作流程是：

1. 在提出新问题之前，请搜索现有问题。
2. 分叉仓库并创建一个专注的分支。
3. 保持更改小幅度并遵循现有的 C/Qt 风格。
4. 使用仓库的 src/.clang-format 配置格式化 C/C++ 更改。
5. 在本地构建应用程序并描述你执行的检查。
6. 提出 pull request 时请附上明确的动机，并针对 UI 更改提供截图。

请不要在 pull request 中包含无关的格式化或生成的构建文件。

本地化

想在您的语言中使用故事架构器或改进现有翻译吗？加入 Transifex 项目并查看 翻译指南。

反馈与错误报告

发现了一个错误、有什么问题，或想分享反馈？请在GitHub 问题追踪器中提交问题，或通过电子邮件发送给我们 support@starc.app 。

支持项目

您可以通过以下方式支持持续开发：

• 为仓库加星；
• 报告可重现的错误并提出改进建议；
• 贡献代码或翻译；
• 与其他作家分享 Story Architect；
• exploring the premium plans.

产品新闻和发布说明会发布在 Story Architect 博客 上。

许可

Story Architect 根据 GNU 通用公共许可证 v3.0 发布。完整条款请参见 LICENSE。

第三方组件和可选模块可能有其自己的许可条款。