Skillget

StoryEngine

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: AGPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • exec() — Shell command execution in .zcode/workflows/project-audit.dwf.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

你来写，AI 管账：写长篇小说的桌面软件，逐章记账、核前后矛盾、设定本，数据全在本机 | Write your novel, let the AI keep the books: per-chapter ledger, continuity checks, story bible, 100% local

README.md

写长篇小说的桌面软件：正文你来写，右边的 AI 帮你管账。

写到第 30 章，忘了第 3 章主角伤的是哪只手？它逐章记下谁出场、发生了什么、过了几天、东西在谁手上；写完一章点一下，它对一遍前文，哪句对不上，两边原句并排摆给你。想让它代笔也行。

写完第 9 章点核账：AI 指出和前文对不上的句子，两边原句并排
真实截图：我们手写的第 9 章故意埋了 3 处和前文对不上的地方，核账全抓到了，另外还抓出 2 处我们自己都没注意到的真问题

能做什么

  • 逐章记账：每章定稿时，AI 把出场人物、发生的事、线索、故事里的日子、东西挪到哪记成账，每条都带正文原句、由代码逐字核对，核不上就如实说「没记上」
  • 核前后矛盾：写完一章让它核账，它跟读全书，指出这一章和前文对不上的地方，两边原句都摆出来；你点「改掉」它只改那几句，点「不是问题」它就记住
  • 设定本：人物、地点、物件、规则做成卡片，点字就改；AI 只能补空栏、建新卡，要动你写的得你点头
  • 时间线和东西在哪：故事里过了几天、哪件东西在谁手上，都从账里算；算不准的说「不知道」，不硬编
  • 想让 AI 代笔也行：想走法、出稿、接着往下写、按你的意思改、去 AI 味
  • 每步都能撤销：AI 每次改东西前自动存档；定稿只能你自己点按钮
  • 导入已写的书：txt 自动切章，AI 在后台逐章补账
  • 联网查资料（可选）：要真实世界的细节时让它搜，附来源，只当参考

伏笔与线索：刚埋下、在推进、停太久、已收口，一眼看到哪条线忘了接 故事地图：一行一章，每章是故事里第几天、谁出场

准不准：我们量过

同一本样书、同一份章纲，新旧两版各往下写 30 章（约 9.4 万字，三分之一模拟作者自己写），再由不知道来源的评审逐条翻原文判真假：

改进前 现在
漏过去的前后矛盾（每千字） 0.31 0.10
每章要你看的字（行） 58.7 19.5
作者手写章，核账抓到的真错 约一半 约四分之三

还会漏大约四分之一，偶尔也误报。我们不说「保证不吃书」，只说比一个人记靠谱得多。我们也以作者身份真点界面，从头写过一本 50 章、9 万多字的长篇。

几条死规矩

  • AI 不许猜：不许用关键词、正则去猜你的意思；AI 说「记下了」的每一条都必须带原句，代码去正文里逐字找，找不到就当没有
  • AI 不替你拍板：定稿、裁剪这类事只有你点按钮才执行；AI 改的每一步都先存档、能撤销
  • 数据只在你电脑上：没有账号、没有统计；只有你选的模型服务商会收到正文

🚧 持续更新中：遇到问题、想要新功能，欢迎到 Issues 提，我们会认真看。正在写长篇、愿意试用提意见的作者，特别欢迎来聊。

下载安装（Mac）

  1. 到 Releases 下载 StoryEngine-版本号-arm64.dmg（Apple 芯片的 Mac）

  2. 打开 dmg，把 StoryEngine 拖进「应用程序」

  3. 第一次打开会被系统拦下（我们还没有苹果开发者签名）：

    • 双击 StoryEngine，弹窗里点「完成」
    • 打开「系统设置 → 隐私与安全性」，往下翻到说 StoryEngine 被阻止的那一行，点「仍要打开」，再输入开机密码确认
    • 之后就能正常打开了

    会用终端的话，也可以一条命令放行：

    xattr -dr com.apple.quarantine /Applications/StoryEngine.app

下载安装（Windows）

⚠️ Windows 包还没在 Windows 真机上走查过（Mac 版走查过）。装不上、打不开、哪里不对，请到 Issues 说一声，附上「帮助 → 打开日志文件夹」里的 main.log，我们会尽快修。

  1. 到 Releases 下载 StoryEngine-版本号-x64-Setup.exe，双击安装
  2. 如果弹出「Windows 已保护你的电脑」（安装包还没有代码签名）：点「更多信息」→「仍要运行」

Intel 芯片的 Mac 暂时没有安装包，可以从源码运行。

开始用

  1. 接上 AI：书架顶上会提示「AI 还没接上」，点「去接上」→ 选一家服务商（DeepSeek、通义千问、智谱 GLM、Kimi、豆包等，任何 OpenAI 兼容接口都行）→ 填你自己的 API Key → 测试连接 → 点一个模型
  2. 开一本书：新建一本，或者「导入已写的书」
  3. 联网搜索：默认就能用，不要密钥（每天 100 次）；想换博查或 Tavily、或者关掉，到 设置 → 搜索

不接 AI 也能用：自己写、存稿、导出都不受影响。

你的数据

  • 书、设定、聊天记录都存在你自己电脑上（书库在 ~/StoryEngine-NG）
  • 密钥只存在 ~/.story-engine/，只有你的账户能读
  • 用 AI 时，正文和设定会发给你选的模型服务商；联网搜索时，搜索词会发给搜索服务商（默认 You.com，可换、可关）
  • 除此之外不联网：没有账号、没有统计、不收集任何数据

从源码运行

需要 Node.js ^20.20.0 / ^22.22.0 / >=24.0.0 和 pnpm 11：

pnpm install   # 安装依赖（会自动构建核心包）
pnpm dev       # 启动写作台

然后用浏览器打开终端里显示的地址（默认 http://127.0.0.1:5173）。

开发

包 说明
packages/story-core 核心：真相（每章账单、作者裁定、设定卡、正文）、写命令（定稿、记裁定、存稿、导入）、投影；纯 TypeScript，不调模型
packages/story-engine-ui React 写作台 + 本地 HTTP/SSE 服务（对话 AI、编辑部、写稿流程）
packages/story-engine-desktop Electron 桌面壳和打包（Mac 随包带精简 git，撤销不靠系统 git） 
pnpm test          # 全仓测试
pnpm typecheck     # 类型检查
pnpm build         # 构建

GitHub CI 在 Node.js 22 + pnpm 11 上跑这三条。测试会给每次运行单独分配临时目录、结束后只回收自己那份；要保留失败现场，设 STORY_ENGINE_KEEP_TEST_TMP=1。

打桌面包：packages/story-engine-desktop/build-desktop.sh --mac。默认包不含任何模型配置，打包后会用探针确认产物里没有密钥；带模型预设的内部测试包要显式确认 SE_ALLOW_SECRET_BUNDLE=I_UNDERSTAND_KEYS_ARE_EXTRACTABLE，产物名带 -with-model-preset，绝不能公开分发。

几条硬规矩：

  • 绝不提交 .env、API Key 或生成的安装包
  • AI 不能直接定稿或改作者写的东西：只出预览，作者点按钮才执行
  • AI 说「记下了」的每一条都要带原句、由代码核实

许可证

AGPL-3.0。拿去改了提供网络服务，也要公开全部修改后的源码。用到的第三方软件许可在应用里「设置 → 关于 → 第三方软件许可」。

Yorumlar (0)

Sonuc bulunamadi