补一份从启动到写卡开玩的使用说明,下载后能照着做。

截图按真实界面走了一遍最简的短对话卡。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-09-30 15:26:41 +08:00
co-authored by Cursor
parent 8bd469ceeb
commit d09829bdb8
9 changed files with 84 additions and 0 deletions
+84
View File
@@ -0,0 +1,84 @@
# Writing Agent 使用说明
解压或下载完成后,按下面的顺序即可:双击启动、打开浏览器、写一张最简单的卡,然后游玩一句。
需要先安装 [Node.js](https://nodejs.org/)(勾选安装时附带的 npm)。第一次启动会自动安装依赖,请等黑窗口跑完。
## 1. 双击 `start.bat`
在文件夹里双击 `start.bat`。会弹出一个黑窗口,并自动打开浏览器。地址是:
http://localhost:23337
窗口不要关。关窗口或按 `Ctrl+C` 就是停止软件。
![启动后的黑窗口](docs/guide/01-start.png)
想用桌面窗口而不是浏览器,改双击 `start-app.bat`。后面的操作一样。
## 2. 第一次要填模型接口
点右上角 **设置**,再点 **新增**。填上这四项后点 **保存并选用**:
- 名称:自己认得就行,例如 DeepSeek
- Base URL:接口地址,例如 `https://api.deepseek.com/v1`
- API Key:你的密钥
- 型号:这一行要用的模型名,例如 `deepseek-chat`
填完型号后也可以点 **嗅探**,从列表里点一个型号。
![新增 API](docs/guide/03-api.png)
项目根目录如果已经有填好的 `.env`,启动时会自动带上,这一步可以跳过。
## 3. 新建作品
还没有任何作品时,打开页面就会弹出 **新建作品**。输入名称,点 **创建**。以后再开新的,点左侧 **+**。
![填写作品名](docs/guide/04-new-book.png)
这里用「雨天小书店」做例子。
## 4. 写一张最简单的卡
在底部输入框里原样贴上这段,点发送(或按 Enter):
```text
请写一张最简单的可玩卡,写完就停。
题材:雨天小书店。玩家是进来躲雨的客人,店员是一只戴蓝色围巾的猫。
只要短对话。不要数值、地图、复杂世界观。
开场只要两三句:雨还在下,猫店员抬起头。
```
![把这段话放进输入框](docs/guide/05-prompt.png)
等它写完。中间的回复会说明卡已经好了,右侧 **已持久化** 是落下来的几张卡片。
![写好的卡](docs/guide/06-card.png)
写完它如果还追问,回复「都不用再加,写完开场就可以开玩」。
## 5. 保存并开玩
右上角出现 **保存定稿** 时,点它,给这份稿起个名字。没有这个按钮时,点输入框右侧的保存图标,效果相同。
然后点左侧的作品名,在弹出的菜单里选 **游玩**。
会先看到开场白:
![进入游玩后的开场](docs/guide/07-play.png)
在底部写你要做的事,再发送。例如:
```text
我收起伞,问店员今天适合躲雨看的书。
```
它会接下去写这一轮:
![说完一句之后](docs/guide/08-play-reply.png)
之后就一直这样:你说一句,它写一轮。右上角 **保存游玩** 可以把进度存下来。
想换你在故事里的名字,到 **设置 → 用户角色** 里新增一个角色并选用。创作时如果希望开场先写占位,把角色名写成 `@玩家`。
Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 97 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 161 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 121 KiB