@yangda611/dsh-scriptor 8.4.2 → 8.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -1,23 +1,23 @@
|
|
|
1
1
|
# Webnovel Writer · 网文写作工作台
|
|
2
2
|
|
|
3
|
-
Scriptor 8.4.
|
|
3
|
+
Scriptor 8.4.3 适配 DSH 0.2.2-rc.1。安装范围为 `>=0.2.2-rc.1 <0.3.0-0`,Node最低24.9;实际验证按具体版本记录。
|
|
4
4
|
|
|
5
5
|
[产品主页](https://yangda611.github.io/dsh-scriptor-full/) · [新手教程](https://yangda611.github.io/dsh-scriptor-full/docs/beginner.html)
|
|
6
6
|
|
|
7
|
-
> Scriptor 8.4.
|
|
7
|
+
> Scriptor 8.4.3 配套 **DSH 0.2.2-rc.1**。旧格式先备份并使用书仓维护预览,按明确批准执行升级。
|
|
8
8
|
|
|
9
|
-
DSH 插件 `@yangda611/dsh-scriptor` 提供写作工作台。8.4.
|
|
9
|
+
DSH 插件 `@yangda611/dsh-scriptor` 提供写作工作台。8.4.3包含12个写作与维护技能和八个脚本入口。
|
|
10
10
|
要求 Node.js至少24.9,DSH 0.2.2-rc.1。许可证 GPL-3.0-only。
|
|
11
11
|
|
|
12
12
|
## 安装
|
|
13
13
|
|
|
14
|
-
在 DSH 0.2.2-rc.1 桌面端侧栏打开“插件 → 添加插件”,输入 `@yangda611/dsh-scriptor@8.4.
|
|
14
|
+
在 DSH 0.2.2-rc.1 桌面端侧栏打开“插件 → 添加插件”,输入 `@yangda611/dsh-scriptor@8.4.3`,核对后安装并应用变更。桌面端自带运行时,不需要另外安装 Node/pnpm。
|
|
15
15
|
|
|
16
16
|
以下是进阶用户创建独立 Web profile 的方式,不用于桌面端保留的 `desktop` profile:
|
|
17
17
|
|
|
18
18
|
```powershell
|
|
19
19
|
dsh --profile webnovel --from-default-profile web --dump-config
|
|
20
|
-
dsh plugin --profile webnovel add C:/scriptor-dist/yangda611-dsh-scriptor-8.4.
|
|
20
|
+
dsh plugin --profile webnovel add C:/scriptor-dist/yangda611-dsh-scriptor-8.4.3.tgz
|
|
21
21
|
dsh --profile webnovel --host 127.0.0.1 --port 6104 --no-open
|
|
22
22
|
```
|
|
23
23
|
|
|
@@ -27,7 +27,7 @@ dsh --profile webnovel --host 127.0.0.1 --port 6104 --no-open
|
|
|
27
27
|
|
|
28
28
|
## 更新与卸载
|
|
29
29
|
|
|
30
|
-
先停止指定 profile 的运行实例,再安装目标精确版本并重启(本版为 `C:/scriptor-dist/yangda611-dsh-scriptor-8.4.
|
|
30
|
+
先停止指定 profile 的运行实例,再安装目标精确版本并重启(本版为 `C:/scriptor-dist/yangda611-dsh-scriptor-8.4.3.tgz`)。
|
|
31
31
|
卸载后可执行上面的安装命令重装:
|
|
32
32
|
|
|
33
33
|
```powershell
|
|
@@ -37,7 +37,7 @@ dsh --profile webnovel --dump-config
|
|
|
37
37
|
|
|
38
38
|
卸载插件不会删除作品书仓。安装不需要源码、安装时构建或 npm 账号。tarball 放在无空格目录,并核对对应 Release 提供的 SHA256。首次下载宿主依赖仍可能需要网络。
|
|
39
39
|
|
|
40
|
-
## 8.4.
|
|
40
|
+
## 8.4.3 更新与旧项目升级
|
|
41
41
|
|
|
42
42
|
本二开版保持原有的千章关系星团、证据轨迹、原生设置与书仓维护能力。先升级到 DSH 0.2.2-rc.1,再更新已用插件。旧格式须先备份,检查并预览整仓升级;正常读取不再转换旧字段。升级后新建写作模式对话,打开原工作区继续;旧对话不会自动迁移。
|
|
43
43
|
|
|
@@ -49,7 +49,7 @@ dsh --profile webnovel --dump-config
|
|
|
49
49
|
|
|
50
50
|
## 公开文档
|
|
51
51
|
|
|
52
|
-
当前主包 8.4.
|
|
52
|
+
当前主包 8.4.3。完整的安装、配置、首章和备份教程见 [公开使用文档](https://github.com/yangda611/dsh-scriptor-full/tree/main/docs/user)。
|
|
53
53
|
|
|
54
54
|
第三方组件的原始声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md),许可证文本随包放在 licenses/。源码及校验和由对应的 GitHub Release 提供。
|
|
55
55
|
|
package/package.json
CHANGED
|
@@ -33,9 +33,9 @@ user-invocable: false
|
|
|
33
33
|
|
|
34
34
|
子节内只写这三项正整数,下限 ≤ 目标 ≤ 上限;说明文字放在其他子节。范围随所在分部确认,暂定内容不能当已确认约束。计数为脚本正文汉字数,含章标题,不含 frontmatter 与候选事实。以后细纲、起草、审读继承此项;超范围走原审读发现项与处置,不增加审批步骤,不自动裁稿。
|
|
35
35
|
|
|
36
|
-
### 路径 A
|
|
36
|
+
### 路径 A:快速开写(默认)
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
**默认走本路径**:作者没说要逐部细聊时,直接按本路径一次起草、作者过目一次就确认。作者想先跑起来、以后再细化时也是本路径:你按构想快照一次起草开写所需的全部设计,作者过目一次,同意后逐件经工具写入。省的是对谈轮数,不是内容——只有标注、没有正文的「已确认」一律不写。
|
|
39
39
|
|
|
40
40
|
1. 与作者确认「先跑起来再细化」,读 `构想/构想快照.md`;
|
|
41
41
|
2. 一次起草当前所需材料,必要部分写一两句实质内容:
|
|
@@ -49,7 +49,9 @@ user-invocable: false
|
|
|
49
49
|
4. 作者明确批准后按序写入:`novel_update_contract`(六部逐部)→ `novel_confirm_worldbook_entry` → `novel_update_skeleton` → `novel_update_volume_layout` → `novel_confirm_volume_outline`(卷纲、计划时间线各一次)→ `novel_roll_window` 追加第一章条目;
|
|
50
50
|
5. 写完查 `novel_get_book_progress`,确认没有「无内容」标记,向作者播报写入结果与留白项。
|
|
51
51
|
|
|
52
|
-
### 路径 B
|
|
52
|
+
### 路径 B:深度定制(作者明确要求时才走)
|
|
53
|
+
|
|
54
|
+
只有作者明确说要逐部细聊、深度定制时才走本路径。**每部对谈时先给 3–4 个具体选项**(按契约里已定的市场与题材库出真实内容,不是空泛的 A/B/C),让作者说编号或直接说选项;最后加一个“自己有想法,手动输入”的选项。绝不在没有给选项的情况下问开放式问题。每部开头告诉作者现在是第几部(契约六部,第 N/6 部)、这一步要定什么;作者选完后简短确认一句,直接进下一部,不重复问已经定好的事。
|
|
53
55
|
|
|
54
56
|
1. **契约六部**逐部对谈(题材与读者定位 / 核心看点与差异化 / 阅读体验与情绪承诺 / 主角原则与关系边界 / 叙事方式与文风基调 / 创作禁区与不可妥协项),每聊定一部调 `novel_update_contract`——「已确认」随确认产生 `design:` 提交,「暂定/留白」只写文件;
|
|
55
57
|
2. **世界书**:`novel_confirm_worldbook_entry` 写入/确认条目;
|
|
@@ -60,7 +62,7 @@ user-invocable: false
|
|
|
60
62
|
- 提出三条因果、人物选择或信息组织明显不同的路线;可用一条典型版作对照,但不默认它最好,也不强制把作者意图改成典型套路;
|
|
61
63
|
- 依据本卷矛盾选择发散轴,如代价承担者、揭露顺序、人物立场、解决问题的方式;不同路线应有实质差异,不局限于固定短表,也不只改名称;
|
|
62
64
|
- 每个方向都写代价与放弃项,只有好处的方向打回重写;
|
|
63
|
-
-
|
|
65
|
+
- 三个方向呈作者选择或组合,再加一个“自己有想法,手动输入”的选项。卷纲末尾「方向选择」小节写 `选定方向`,`已排除走向` 只记作者明确否决的走向;未选方案不自动成为禁区,没有明确排除就写“无”。行文不复述章名、不带 `〔…〕` 标记;
|
|
64
66
|
6. **卷规划**:用 `novel_confirm_volume_outline` 提交卷纲或计划时间线的完整正文。卷纲包含仍有效的各段和「方向选择」小节。
|
|
65
67
|
成功时,工具返回卷规划的写入和提交结果。
|
|
66
68
|
7. **窗口**:用 `novel_roll_window` 追加窗口条目。
|
|
@@ -14,6 +14,10 @@ user-invocable: false
|
|
|
14
14
|
|
|
15
15
|
短段发展用于探索,不是待入稿正文。分岔可以全部推翻,不预设终点,也不自动成为正式路线、事实或兑现义务。可用问答、具体发展试探、人物选择推演或参考作品分析,不连续出选择题代替材料。作者表达偏好后保留他喜欢的部分、改变不满意的机制;已有信息足够就先提建议,一次只追问最影响方向的一件事。已有明确路线时沿该路线探索,不强迫重新二选一。方向清楚后再收敛七要素;明确只想记录时不启动探索。
|
|
16
16
|
|
|
17
|
+
### 提问方式:先给选择,再兜底手动输入
|
|
18
|
+
|
|
19
|
+
从第一次对话到建书完成,一共三步,每步开头先告诉作者现在是第几步、这一步要定什么、后面还剩几步。**每个要作者定夺的点,先给 3–4 个具体选项**(按已定的市场与题材库出真实内容,不是空泛的 A/B/C),让作者说编号或直接说选项;**最后加一个“自己有想法,手动输入”的选项**。作者也可以一次回答多个点,或直接改你给的草案。**绝不在没有给选项的情况下问开放式问题**,不要让作者每次都必须手动打字。每个选项旁标明哪一个是推荐(★推荐)或默认;作者不选就按默认来。作者选完后简短确认一句(“好,定下来了:……”),直接进下一步,不重复问已经定好的事。
|
|
20
|
+
|
|
17
21
|
1. **随手记**:仅要求记录时,保留作者原意,不评判、不主动展开。用通用写工具落到灵感池 `<工作范围>/书房/灵感池/`,一条脑洞一个 `.md`,frontmatter 三项——`状态: 候选`、`身份:` 与文件名同值、`来源快照:` 落 ISO 时间戳。探索中将值得保留的候选与作者原话区分记录。
|
|
18
22
|
2. **收敛七要素**(要素名与 `novel_create_book` 的 `concept` 参数字段逐字对应,呈报与调用照抄):
|
|
19
23
|
- **核心创意**——一句话卖点;
|
|
@@ -23,13 +27,14 @@ user-invocable: false
|
|
|
23
27
|
- **核心看点**——追更的爽点/悬念/期待感;
|
|
24
28
|
- **差异化方向**——同类里独特的记忆点;
|
|
25
29
|
- **明确不要什么**(创作禁区)——明确不写的桥段、人设、走向。
|
|
26
|
-
3
|
|
30
|
+
- **做法:先给草案,再让作者改**——根据作者已说的想法和题材库,先把七要素填成一份草案给作者过目;作者只改想改的部分,不用逐个回答。草案里定不下来的要素先写「留白」,不要为了填满而编。草案里每个未定要素附 3–4 个具体选项 + “自己有想法,手动输入”;作者可以一次定多个要素。`核心创意` 与 `题材与目标读者` 两项必须非留白,其余五项可留白,不要求全部定死才立项。
|
|
31
|
+
3. **呈报确认**:七要素整理为构想草案,用通用写工具落 `<工作范围>/书房/构想/<书名或代称>.md`,再呈作者;获明确同意后调 `novel_create_book`,七个要素字段一个不缺地给全,`concept.状态` 必须为「已确认」。
|
|
27
32
|
|
|
28
|
-
**建书前先定市场与输出形态**(调 `novel_create_book`
|
|
29
|
-
-
|
|
30
|
-
-
|
|
33
|
+
**建书前先定市场与输出形态**(调 `novel_create_book` 之前,**两项放在同一条消息里一次问完**,各给选项,大白话,别用术语):
|
|
34
|
+
- 市场——“这个项目面向海外还是中文市场?”:1. 中文(★推荐,默认)——给国内观众,用中文题材库(赘婿、战神、霸总等);2. 海外——给海外观众,用海外题材库(狼人、亿万富翁、黑手党等);3. 自己有想法,手动输入。作者不选默认 `中文`。
|
|
35
|
+
- 输出形态——“要出短剧、电影剧本还是小说?”:1. 小说(★推荐,默认)——长篇小说,走原来的写章流程;2. 短剧——一集一集的短剧,走分集大纲 → 单集剧本 → 审读;3. 电影剧本——一部电影的剧本,走故事稿 → 分场大纲 → 剧本草稿 → 审读;4. 自己有想法,手动输入。作者不选默认 `小说`。
|
|
31
36
|
- 两项一旦写入作品契约 frontmatter(`市场` / `输出形态`),建书后不再静默改写;作者之后想改,走契约修订流程。旧书没有这两个字段时按默认值(中文 / 小说)处理,不要自动补写。
|
|
32
|
-
4. **跃迁**:建书由工具完成——书仓脚手架、构想快照冻结、书id 写入契约、`vol:` 首次提交(草稿区不入库),设计面跃迁为「作品定调」。**建书不自动切书**:拿 `novel_create_book` 返回的 `bookId` 调 `novel_select_book`
|
|
37
|
+
4. **跃迁**:建书由工具完成——书仓脚手架、构想快照冻结、书id 写入契约、`vol:` 首次提交(草稿区不入库),设计面跃迁为「作品定调」。**建书不自动切书**:拿 `novel_create_book` 返回的 `bookId` 调 `novel_select_book` 落定当前书,再向作者说明去向——**默认走快速开写**(《定调设计》路径 A:一次起草、作者过目确认);只有作者明确说要逐部细聊、深度定制时,才走深度定制(《定调设计》路径 B:逐部细聊)。
|
|
33
38
|
|
|
34
39
|
## 工具
|
|
35
40
|
|
|
@@ -14,6 +14,13 @@ user-invocable: false
|
|
|
14
14
|
- **输出形态**(`输出形态`):必须是 `电影剧本` 才进本技能。不是就停下,告诉作者走错了管线。
|
|
15
15
|
- 旧书没有这两个字段时,按默认值处理(`中文` / `小说`),不要自动补写、不要擅自改写。
|
|
16
16
|
|
|
17
|
+
## 提问方式:先给选择,再兜底手动输入
|
|
18
|
+
|
|
19
|
+
需要作者做决定时,先给 3–4 个具体选项,让作者说编号或直接说选项;最后加一个“自己有想法,手动输入”的选项。绝不在没有给选项的情况下问开放式问题。每次只问一个决定点,作者选完后简短确认一句,直接继续,不重复问已经定好的事。具体决定点:
|
|
20
|
+
|
|
21
|
+
- 片长(第 4 步审读前):1. 长片(★推荐,90–110 页) 2. 短片 3. 自己有想法,手动输入。
|
|
22
|
+
- 导出格式(第 5 步):1. 分镜剧本(★推荐,默认,《痴迷》式,编剧层 + 导演层) 2. Fountain 3. master-scene 4. 三份都要 5. 自己有想法,手动输入。
|
|
23
|
+
|
|
17
24
|
## 四步流程(一步一步来,不要跳步)
|
|
18
25
|
|
|
19
26
|
### 第 1 步:故事稿(小说浓缩版)
|
|
@@ -10,12 +10,15 @@ user-invocable: false
|
|
|
10
10
|
|
|
11
11
|
## 大白话总流程
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
13
|
+
需要作者做决定时,先给具体选项 + “自己有想法,手动输入”,不要直接问开放式问题。每次只问一个决定点,作者选完后简短确认一句,直接继续。
|
|
14
|
+
|
|
15
|
+
1. **定画幅**:先问作者要竖屏还是横屏。这是两种产品,不是同一个剧本换个画幅比。一次问完,给选项:
|
|
16
|
+
- 1. 竖屏(★推荐,默认):手机上刷着看,9:16,每集 60–120 秒,2–4 场,一季 60–100 集。
|
|
17
|
+
- 2. 横屏:长视频平台点播着看,16:9,每集 10–20 分钟,一季 20–30 集,有头有尾的完整故事。
|
|
18
|
+
- 3. 自己有想法,手动输入。
|
|
19
|
+
- 作者不选默认竖屏(短剧的主流形态),一句话就能改。
|
|
16
20
|
- 节拍规则两画幅共用同一套(只按单集时长缩放,不按画幅放宽):开头 3–5 秒进冲突、无片头无铺垫、每 20–30 秒一个转折、结尾 5–10 秒留悬念切在问题上。时长、集数、台词总量、取景(竖屏特写 / 横屏宽幅与环境)按画幅区分。
|
|
17
|
-
|
|
18
|
-
2. **分集大纲**:按集排钩子与爽点分布(见 `工序/分集大纲.md`)。调 `novel_shortdrama_plan_episodes` 出结构,再一集一集填内容。
|
|
21
|
+
2. **分集大纲**:按集排钩子与爽点分布(见 `工序/分集大纲.md`)。调 `novel_shortdrama_plan_episodes` 出结构,再一集一集填内容。钩子类型默认按身份 → 情感 → 顿悟轮换;作者想换时给选项:1. 身份钩 2. 情感钩 3. 顿悟钩 4. 自己有想法,手动输入。
|
|
19
22
|
3. **单集剧本**:一集一集写编剧层分场景剧本(见 `工序/单集剧本.md`)。调 `novel_shortdrama_render_episode` 渲染,定稿路径是 `剧本/短剧/集001.md` 起。
|
|
20
23
|
4. **节拍检查**:每集写完调 `novel_shortdrama_check_beats`,哪集哪条规则没过会逐条报出来,不过就改,不凭感觉放行。
|
|
21
24
|
5. **审读**:调 `novel_shortdrama_review_episode` 做确定性检查(模块名 `短剧审读`,经共享审读注册表,适用范围 集),再按 `底本/短剧审读.md` 派语义审读(模块名 `短剧审读(语义)`);发现项经 `novel_record_review_findings`(适用范围 集,传同一份剧本/大纲对象与审读指纹)回写进分集审读记录(`草稿区/审核/审-集NNN.json`);两个范围模块全部回写完毕才算审核完成。指纹对不上会被拒绝(已过期),不要换成后来取得的值。
|