deepseek-harness-novel-studio

Readme

# Novel Studio · 小说创作工作台

![Novel Studio icon](assets/novel-studio-icon.png)

**把 AI 对话变成真正能写长篇小说的创作工作台。**

Novel Studio 让作者在同一处完成小说大纲、章节正文、人物关系、世界观、关键时间线、伏笔、禁写规则和写作技法管理。对话负责创作，工作台负责记住、约束和校验；作品越长，设定越不容易失控。

![Novel Studio 最新小说创作联动界面](assets/screenshot-native.png)

![Novel Studio 大纲联动编辑界面](assets/screenshot-main.png)

## 为什么适合写小说

- **小说设定不再散落在聊天记录里**：人物、世界、线索、时间线和章节始终可以查、改、删、补。
- **人物和剧情不再轻易写乱**：关系树、关键事件、角色状态和一致性检查帮助避免“已死角色复活”“忘记伏笔”等长篇常见问题。
- **写作规则真正能落地**：可设置禁写词、禁用句式、项目原则与专属技法；当前会话每轮自动读取，硬约束由系统级写作协议执行。
- **对话、正文、设定同步联动**：不用在多个页面之间反复切换；需要时打开，写作时收起。
- **AI 只能提议，作者始终拍板**：生成内容、设定变更和重要事实都需要作者确认后才进入项目。
- **从空白到长篇都能用**：支持 TXT、Markdown、JSON、DOCX、EPUB 导入，也支持从第一章开始建立项目。

## 核心能力

- 小说大纲、章节正文与场景契约
- 人物卡、人物关系树、状态与出场管理
- 世界观、资料库、伏笔与关键剧情时间线
- 禁写规则、项目原则、一致性检查与待确认清单
- 写作技法库、对白与节奏工具、自定义 AI 技能
- 修订版本、导入预览、人工确认和本地优先的数据存储

## 持续更新与反馈

这是一个持续迭代的小说创作插件。欢迎作者提出真实写作场景、功能建议和问题反馈；每一条有价值的反馈都会帮助它变得更适合长篇小说创作。

请前往 [GitHub Issues](https://github.com/qinpeizhan77/deepseek-harness-novel-studio/issues) 留言，也欢迎关注后续版本更新。

## 安装

During local development:

```powershell
npm install
npm run check
dsh plugin --profile web add file:C:\path\to\dsh-novel-studio
```

Restart `dsh web`, then open any session and click **小说** inside the native composer or the `N` action beside the session title. The linked workspace opens around the existing conversation without navigating to a separate legacy page. It can be closed at any time and restored from **设置 → 小说工作台**; unsaved manuscript, scene, and project forms are protected before closing or switching.

安装公开测试版：

```powershell
dsh plugin --profile web add deepseek-harness-novel-studio@beta
```

## 内置写作技能

- `novel-project-workflow`
- `novel-premise-tournament`
- `novel-proof-scene`
- `novel-engine-stress-test`
- `novel-state-review`

The workflow router is always available to the model. The four specialist skills follow the switches saved in the current workspace. Project-created skills are also registered with the Harness skill provider while enabled.

## 本地数据

The host stores the active project in:

```text
<workspace>/.novel-studio/project.json
```

Writes use optimistic revisions, a serialized write queue, an append-only event list, SHA-256 event links, and atomic file replacement. A new workspace starts completely empty; Novel Studio does not insert a sample novel.

## 开发

```powershell
npm run dev
npm run typecheck
npm test
npm run build
```

The Vite development server uses a browser-local demonstration state when the DSH host API is unavailable.

## 当前版本

3.4.2-beta.3 使用会话联动工作台：左侧项目导航向右自然展开，右侧场景驾驶仪会随屏幕尺寸自适应。人物关系、关键时间线、禁写规则、写作技法、资料来源和自定义 AI 技能都是可编辑项目数据；规则和当前章节由服务器按会话自动注入模型上下文，界面会明确显示联动是否生效；导入先预览，AI 变更先待确认，项目数据本地优先保存。

## License

MIT. Fiction produced with Novel Studio belongs to its author; the software license does not claim rights over user output.