easy-writing

# 易创（easy-writing）

**纯本地的网文写作桌面软件**：小说写作、码字统计、AI 辅助创作、排行榜风向。作品、设定和写作记录存在你自己的电脑上；无需注册登录，基础写作功能可离线使用。

[English](./README.en.md) · [下载安装](#下载安装) · [下一步计划](#下一步计划) · [商业合作](#商业合作与联系)

> 由长期线上运营的写作平台客户端改造而来，编辑器、自动保存、章节管理都经过真实网文作者的日常使用打磨。适合起点、番茄、七猫、晋江等平台的作者，也适合任何想把稿子攥在自己手里的写作者。

## 界面预览

**本地创作首页**

![易创本地创作首页](./docs/images/home.png)

**写作台与体验设置**

![易创写作台与打字音效、特效设置](./docs/images/writing-experience.png)

**AI 工作流建书**

![易创 AI 工作流建书](./docs/images/workflow-book.png)

## 为什么选它

- **数据在你手里**：作品、设定、码字记录全部存本机（桌面版是一个 SQLite 数据库文件），支持定时自动备份成 txt + json，随时整本导出。
- **AI 用你自己的钥匙（BYOK）**：可配置 DeepSeek、通义千问、智谱、Kimi、OpenAI 等模型，以及多数提供 OpenAI 兼容接口的服务。API Key 保存在本机，请求时从你的电脑直连所配置的模型服务商。Ollama、LM Studio 等本地部署模型同样支持——API Key 留空即可。
- **提示词全开放**：所有 AI 提示词是本机的 md 文件，界面里可视化改，或者直接改文件，连每个场景的采样温度都能调。
- **免费且开源**：AGPL-3.0 协议，代码全公开。

## 功能

### 写作

- **写作台**：富文本编辑器（TipTap），卷/章目录树、拖拽排序、全书搜索、查找替换
  - 边写边存（160ms 本地落盘 + 关窗快照），异常退出重开即恢复
  - 每章自动保留历史版本，随时回看与恢复
  - 敏感词检测（本地词库可自定义）、打字音效、专注模式、自爆挑战
- **参考资料五件套**：大纲、角色（含关系图画布）、设定、时间线、故事线（思维导图画布）
- **书架**：多作品管理、分组、封面、TXT/JSON 导入导出、回收站
- **码字统计**：今日字数、趋势图、码字日历、连续天数、每日目标；手写与 AI 产出分开记账
- **灵感速记**：首页快记 + 素材库 + 写作台面板，一份数据三处可用

### 写作体验与个性化

- **沉浸式打字反馈**：支持青轴机械键、茶轴机械键、老式打字机、枪声、狗狗汪叫等按键音效，也可完全静音
- **光标处视觉特效**：每次输入可触发挥毫泼墨、墨纹涟漪、云烟缭绕、真实烈焰或文字鼓励，不喜欢动效可一键关闭
- **编辑器自由排版**：可调整字体、粗细、颜色、字号、行高、正文宽度、段间空行、对齐方式与网格线样式
- **四套主题与背景**：内置无界通透、古韵信笺、森系护眼、暗夜水墨四套主题，附带 8 张背景图，也可使用自己的图片作为写作背景
- **专注与阅读预览**：支持全屏写作、停止输入倒计时的“自爆挑战”，以及与正文同步滚动的手机阅读预览

### AI 辅助（需自备 API Key）

- **划词 AI 工具**：选中文字一键润色 / 扩写 / 纠错 / 自定义指令，改完可采纳可废弃
- **续写补全**：快捷键整拍续写（流式进正文）+ 打字时的幽灵字建议（Tab 采纳）
- **妙笔对话**：右栏 AI 顾问，剧情 / 人设 / 设定随时聊，会话历史本地保存
- **工作流一键建书**：灵感 → 大纲 → 设定 → 建书 → 逐章自动生文，断点可续
- **竞品拆书**：TXT 整本导入，逐章拆解节奏与卖点，黄金三章深析 + 全书报告
- **取名器 / 简介生成 / AI 封面**：人名地名功法批量起，简介按平台风格生成
- **AI 调用账本**：每次调用的场景、字数、Token、成败原因全记录

### 榜单风向（桌面版）

内置爬虫用**你自己的网络**抓各站排行榜（起点 / 番茄 / 七猫等 80+ 源），数据只存本机；趋势分析、标签风向、CSV 导出、AI 解读。

## 下一步计划

> 以下功能正在规划中，具体内容与上线时间以后续版本发布为准。

- **工作流生书无限画布**：将灵感、人物、世界观、大纲、卷纲、章纲与正文生成拆成可连接节点，支持自由编排、分支探索、节点复用和中途调整
- **AI 剧本写作**：从故事概念、人物小传、分集大纲逐步推进到场次、动作和对白，保留人工确认与局部重写节点
- **分镜拆分工作流**：将剧本按场景和镜头拆分，生成景别、机位、运镜、人物表演、对白、时长与画面提示词等结构化信息
- **小说—剧本—分镜联动**：逐步打通从网文创作到剧本改编、分镜拆解的上下文与版本记录，降低跨阶段重复整理成本

## 下载安装

安装包发布后，可在 [Releases](https://github.com/yilujian/easy-writing/releases) 页面下载：

- **macOS**：下载 `.dmg`。当你确认安装包来自本仓库时，若首次打开提示“已损坏/无法验证开发者”，可在终端执行 `xattr -cr /Applications/易创.app` 后再尝试（应用目前未做苹果签名公证）。
- **Windows**：下载 `.exe` 安装程序。SmartScreen 若拦截，点"更多信息 → 仍要运行"。

应用启动后会自动检查新版本（每天最多一次，只查 GitHub 公开接口），有新版会弹通知，点开即达下载页。

## 快速上手

1. 装好打开，「新建作品」写书名建书，直接开写——写作功能不需要任何配置。
2. 要用 AI：侧栏「模型管理」→ 选服务商预设（如 DeepSeek）→ 填入你自己的 API Key → 测试连接 → 保存，再把它设为默认模型即可。
3. 提示词不合口味：侧栏「提示词管理」里每个场景都能改，恢复默认随时可点。

## 数据存在哪里

- **桌面版**：应用数据目录下的 SQLite 数据库；自动备份（txt+json）默认在「文稿」目录；提示词 md 文件在「文稿/易创提示词」。
- **浏览器模式**（开发预览用）：IndexedDB + localStorage，清浏览器数据前请先导出作品。

## 开发

```bash
pnpm install
pnpm dev        # 浏览器开发模式（端口 6789）
pnpm check      # 类型检查 + Lint；有本地测试文件时一并运行
pnpm build      # 构建 Web 产物
```

桌面端（Tauri 2）：需要先安装 [Rust](https://rustup.rs/)，然后 `pnpm dev:de