cortico-world-simple-trpg-check 0.2.3 → 0.4.0

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.
Files changed (21) hide show
  1. package/AGENTS.md +12 -0
  2. package/CHANGELOG.md +11 -0
  3. package/CLAUDE.md +1 -0
  4. package/LICENSE +20 -20
  5. package/README.md +17 -9
  6. package/describe.json +413 -0
  7. package/dist/{console.js → webui.js} +53 -8
  8. package/package.json +62 -46
  9. package/src/ENV_PROMPT.md +70 -70
  10. package/src/check.ts +103 -103
  11. package/src/conda-environments.ts +5 -4
  12. package/src/config.ts +106 -80
  13. package/src/contest.ts +96 -96
  14. package/src/definition.ts +3 -2
  15. package/src/display.ts +175 -175
  16. package/src/level-readout.ts +53 -53
  17. package/src/model.ts +126 -125
  18. package/src/readout.ts +63 -63
  19. package/src/request.ts +154 -154
  20. package/src/{console → webui}/client.ts +132 -119
  21. package/src/world.ts +602 -590
package/AGENTS.md ADDED
@@ -0,0 +1,12 @@
1
+ # AGENTS.md
2
+
3
+ Before changing this world extension, read [Cortico extension contracts](https://github.com/Pal-AI-Lab/Cortico/blob/main/docs/extensions.md).
4
+
5
+ - Use a Cortico checkout at tag `v0.2.1` for framework checks; the sibling deployment checkout may run an older version. Match `cortico.api` to the printed contract version.
6
+ - After changing tools, events or environment prompt templates, run `pnpm describe:extension <dir>` from the v0.2.1 checkout. Commit the generated file and ship it through `cortico.describe` and `files`.
7
+ - Before publishing, select applicable tags from [TAGS.md](https://github.com/Pal-AI-Lab/cortico-extensions/blob/main/TAGS.md), including notice and warning tags. Maintainer tags take precedence; withdrawing a published warning requires a maintainer request.
8
+ - Add a `## <version>` section to CHANGELOG.md and include it in the package. Declare npm `os` only for supported platform restrictions.
9
+ - Run the package tests, TypeScript checks and WebUI build, then `pnpm check:extension <dir>` from the v0.2.1 checkout. Check the packed file list for the entry, browser assets, self-description and changelog.
10
+ - Build browser assets in an isolated copy while a deployed bot uses this checkout. Use fake deployments and scripted models for verification.
11
+ - Stage explicit paths and make local Conventional Commits. Push, publish and submit maintainer requests only when the user asks.
12
+ - For tag changes, certification, superseding packages or appeals, follow the [index request format](https://github.com/Pal-AI-Lab/cortico-extensions#readme). Certification requires a maintainer review.
package/CHANGELOG.md ADDED
@@ -0,0 +1,11 @@
1
+ # Changelog
2
+
3
+ ## 0.4.0 - 2026-10-16
4
+
5
+ - Target Cortico 0.2.1 and world contract 6.
6
+ - Rename browser contributions, imports and bundles to WebUI.
7
+ - Add extension self-description, official index tags and publishing guidance.
8
+
9
+ ## 0.3.0
10
+
11
+ - Last release using the previous Cortico extension contract.
package/CLAUDE.md ADDED
@@ -0,0 +1 @@
1
+ Read AGENTS.md
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
1
+ MIT License
2
+
3
3
  Copyright (c) 2026 DTMosken
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -2,13 +2,13 @@
2
2
 
3
3
  # Simple TRPG Check
4
4
 
5
- Cortico 的 TRPG 技能检定 World 扩展，检定规则由COC7规则启发。agent 提供角色背景、技能证据和当前情境，Laya 或 Jev 估计角色的技能水平，扩展据此进行 d100 检定，返回骰值、结果和可直接展示的文本。
5
+ Cortico 的 TRPG 技能检定 World 扩展，检定规则由COC7规则启发。agent 提供角色背景、技能证据和当前情境，本地或远程决策模型估计角色的技能水平，扩展据此进行 d100 检定，返回骰值、结果和可直接展示的文本。
6
6
 
7
7
  支持单项检定、组合检定、对抗检定，以及奖励骰、惩罚骰和困难／极难任务。技能名可以自定义，不需要预先填写数值角色卡。
8
8
 
9
9
  ## 安装与配置
10
10
 
11
- 要求 Node.js 22 或更新版本，以及 Cortico World API 5。在 Cortico 仓库的 `extensions/` 目录安装：
11
+ 要求 Node.js 22 或更新版本，以及 Cortico World API 6。在 Cortico 仓库的 `extensions/` 目录安装：
12
12
 
13
13
  ```powershell
14
14
  Set-Location "<Cortico 仓库路径>\extensions"
@@ -19,27 +19,31 @@ corepack pnpm add --ignore-workspace cortico-world-simple-trpg-check
19
19
 
20
20
  | 判定模型 | 配置方式 |
21
21
  | --- | --- |
22
- | Jev | 将“判定模型”设为 `jev`，选择 TypeSafe、OpenRouter 或自定义来源，填写对应密钥。自定义来源还需配置服务地址。 |
22
+ | 远程决策模型 | 选择 TypeSafe、OpenRouter 或自定义服务，填写对应密钥与模型 ID。自定义服务还需配置服务地址。 |
23
23
  | 多语言 Laya（默认） | 选择已安装 `laya` 的 Conda Python 环境。首次使用可能下载模型权重，后续使用本地缓存。 |
24
- | 英文 Laya | 将“判定模型”设为 `laya`，通过可选依赖 `@receptron/laya` 在本机运行。 |
24
+ | 英文 Laya | 选择“本地 Laya（英文）”，通过可选依赖 `@receptron/laya` 在本机运行。 |
25
25
 
26
26
  现有评测中，本地 Laya 对不同技能水平证据的区分较弱，建议使用 Jev。选择后点击“测试连接”验证服务与密钥；该操作不掷骰。
27
27
 
28
- Jev 密钥保存在部署目录的 `.env` 中，配置页的“打开密钥文件”可打开该文件。填写并保存后，下一次模型请求读取密钥。
28
+ “决策模型”输入框提供预设，也接受其他模型 ID；留空使用所选服务的默认 JEV 模型。OpenRouter 支持 Luna Decisions 预设 `openai/gpt-6-luna-decisions`。自定义服务须支持 SystemOne 请求和答案格式。配置键 `backend: "jev"`、`jevSource`、`jevEndpoint` 继续使用，模型 ID 保存在 `jevModel`。
29
29
 
30
- | Jev 来源 | 密钥变量 |
30
+ 默认 JEV 模型使用现有技能评分校准。Luna 与其他模型显示“未校准”，按档位代表值取期望；财富与信用评级仍使用专用标尺。
31
+
32
+ 决策服务密钥保存在部署目录的 `.env` 中，配置页的“打开密钥文件”可打开该文件。同一服务的模型共用密钥。填写并保存后，下一次模型请求读取密钥。
33
+
34
+ | 决策服务 | 密钥变量 |
31
35
  | --- | --- |
32
36
  | TypeSafe | `CORTICO_JEV_TYPESAFE_API_KEY` |
33
37
  | OpenRouter | `CORTICO_JEV_OPENROUTER_API_KEY` |
34
38
  | 自定义 | `CORTICO_JEV_API_KEY` |
35
39
 
36
- “强制适配多语言”要求 agent 用英文填写请求内容，不翻译已有输入。切换判定模型或 Python 环境后需要重启进程。Laya 空闲释放时间默认 10 分钟；同一进程内共用模型时取各使用者中最长的保留时间。
40
+ “强制适配多语言”要求 agent 用英文填写请求内容，不翻译已有输入。切换判定方式或 Python 环境后需要重启进程；远程服务与模型 ID 保存后从下一次请求生效。Laya 空闲释放时间默认 10 分钟；同一进程内共用模型时取各使用者中最长的保留时间。
37
41
 
38
42
  ## World 兼容性
39
43
 
40
44
  按 [Cortico World 兼容等级](https://github.com/Pal-AI-Lab/Cortico/blob/main/docs/world-compatibility.md)，本 World 的最低与完整等级均为 **L1**。
41
45
 
42
- 宿主须挂载工具，用 `envPromptVars()` 填充 `ENV_PROMPT.md` 并将环境描述加入 system 前缀，调用 `start(host)` / `stop()`。检定返回文本回执，Laya 或 Jev 评分由本 World 自行执行，不使用事件投递、实时输出或 `WorldHost.cognition`。
46
+ 宿主须挂载工具，用 `envPromptVars()` 填充 `ENV_PROMPT.md` 并将环境描述加入 system 前缀，调用 `start(host)` / `stop()`。检定返回文本回执，模型评分由本 World 自行执行，不使用事件投递、实时输出或 `WorldHost.cognition`。
43
47
 
44
48
  挂载时须提供 `WorldContext` 的配置与密钥读取。控制台不计入等级；没有控制台时，在宿主配置中选择评分后端，并按所选后端提供 Python 环境、服务地址、依赖或密钥。
45
49
 
@@ -108,7 +112,7 @@ corepack pnpm install
108
112
  corepack pnpm test
109
113
  corepack pnpm typecheck
110
114
  corepack pnpm typecheck:web
111
- corepack pnpm build:console
115
+ corepack pnpm build:webui
112
116
  ```
113
117
 
114
118
  在 Cortico 仓库根目录运行 `corepack pnpm check:extension <本包绝对路径>` 验证扩展。构建控制台前需停止本机正在运行的 bot 进程。
@@ -116,3 +120,7 @@ corepack pnpm build:console
116
120
  评测方法、语料和离线读出训练见仓库内的 `evals/README.md`。运行时使用包内已有的读出表；`evals/` 和 `tests/` 不随 npm 包发布。
117
121
 
118
122
  MIT License，见 [LICENSE](LICENSE)。
123
+
124
+ ## Cortico 0.2.1
125
+
126
+ 发布前从 Cortico 仓库运行 `pnpm describe:extension <本包目录>` 和 `pnpm check:extension <本包目录>`。工具与默认提示词通过 `describe.json` 提供给扩展市场；发布规则见 [AGENTS.md](AGENTS.md)，更新说明见 [CHANGELOG.md](CHANGELOG.md)。
package/describe.json ADDED
@@ -0,0 +1,413 @@
1
+ {
2
+ "tools": [
3
+ {
4
+ "name": "simple_trpg_check_roll",
5
+ "description": "按 checks 里的人物证据判定角色在每项技能上的水平作为难度，再逐项掷骰出结果。回执末尾的「显示：」块就是面向用户的完整格式，照抄即可。checks[i].bonus 是情景代偿的奖励/惩罚骰：整数，标尺 -2（巨大劣势）…2（巨大优势），0 或省略即基准；掷 1+|bonus| 颗，优势取最低、劣势取最高，|bonus|≥3 时不调用判定模型、直接自动成功/失败。checks[i].grade 取 1（困难）或 2（极难），把档位标签整体下压；只在难度本身是任务因素时使用。顶层 joint 取 and/or 把本调用里的所有技能合成一次投掷（and 取最小难度与最小 bonus、or 取最大），出现时至少两项技能且不得带 grade。模型失败、答案无效、输入超出预算或字段非法时不掷骰。",
6
+ "parameters": {
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "character": {
11
+ "type": "object",
12
+ "additionalProperties": false,
13
+ "description": "角色层面、跨技能共享的事实。",
14
+ "properties": {
15
+ "traits": {
16
+ "type": "string",
17
+ "minLength": 1,
18
+ "maxLength": 600,
19
+ "description": "长期特质、背景、词条。"
20
+ },
21
+ "condition": {
22
+ "type": "string",
23
+ "minLength": 1,
24
+ "maxLength": 600,
25
+ "description": "伤势、疲劳、体温、精神与消耗状态。"
26
+ }
27
+ },
28
+ "required": [
29
+ "traits",
30
+ "condition"
31
+ ]
32
+ },
33
+ "situation": {
34
+ "type": "object",
35
+ "additionalProperties": false,
36
+ "description": "这一时刻的情境；某项确实无影响就写“无”，不要省略。",
37
+ "properties": {
38
+ "weather": {
39
+ "type": "string",
40
+ "minLength": 1,
41
+ "maxLength": 600,
42
+ "description": "天气与介质。"
43
+ },
44
+ "gear": {
45
+ "type": "string",
46
+ "minLength": 1,
47
+ "maxLength": 600,
48
+ "description": "工具与装备。"
49
+ },
50
+ "info": {
51
+ "type": "string",
52
+ "minLength": 1,
53
+ "maxLength": 600,
54
+ "description": "已知信息与资料的秩序。"
55
+ },
56
+ "time": {
57
+ "type": "string",
58
+ "minLength": 1,
59
+ "maxLength": 600,
60
+ "description": "时限。"
61
+ },
62
+ "senses": {
63
+ "type": "string",
64
+ "minLength": 1,
65
+ "maxLength": 600,
66
+ "description": "可见度与感官条件。"
67
+ }
68
+ },
69
+ "required": [
70
+ "weather",
71
+ "gear",
72
+ "info",
73
+ "time",
74
+ "senses"
75
+ ]
76
+ },
77
+ "checks": {
78
+ "type": "array",
79
+ "minItems": 1,
80
+ "description": "按判定顺序列出本时刻的技能；顺序只决定回执排列，不表示依赖关系。",
81
+ "items": {
82
+ "type": "object",
83
+ "additionalProperties": false,
84
+ "properties": {
85
+ "skill": {
86
+ "type": "string",
87
+ "minLength": 1,
88
+ "maxLength": 120,
89
+ "description": "技能名。"
90
+ },
91
+ "goal": {
92
+ "type": "string",
93
+ "minLength": 1,
94
+ "maxLength": 300,
95
+ "description": "这项技能要达成的直接结果。"
96
+ },
97
+ "evidence": {
98
+ "type": "string",
99
+ "minLength": 1,
100
+ "maxLength": 300,
101
+ "description": "角色在该技能上的水平证据；不写数字、不写档位名，也不把情境写进去。"
102
+ },
103
+ "bonus": {
104
+ "type": "integer",
105
+ "description": "情景代偿的奖励/惩罚骰，整数；标尺 -2（巨大劣势）…2（巨大优势），0 或省略即基准。填合计数：情境修正与本项花掉的 banked 奖励骰 1:1 抵消后相加。|bonus|≥3 时不调用判定模型，直接自动成功/失败。"
106
+ },
107
+ "grade": {
108
+ "type": "integer",
109
+ "enum": [
110
+ 1,
111
+ 2
112
+ ],
113
+ "description": "难度等级：1 = 困难（困难成功视为普通成功、成功视为失败），2 = 极难（极难成功视为成功、其余视为失败）。只用于难度本身是任务因素的场合；大成功与大失败不受影响；与顶层 joint 不能同时出现。"
114
+ }
115
+ },
116
+ "required": [
117
+ "skill",
118
+ "goal",
119
+ "evidence"
120
+ ]
121
+ }
122
+ },
123
+ "joint": {
124
+ "type": "string",
125
+ "enum": [
126
+ "and",
127
+ "or"
128
+ ],
129
+ "description": "组合检定：and = 列表里每项都要成功（按最小难度与最小 bonus 判），or = 任意一项成功即可（按最大难度与最大 bonus 判）。出现时 checks 至少两项，且各项不得带 grade。"
130
+ }
131
+ },
132
+ "required": [
133
+ "character",
134
+ "situation",
135
+ "checks"
136
+ ]
137
+ },
138
+ "tags": [
139
+ "act"
140
+ ]
141
+ },
142
+ {
143
+ "name": "simple_trpg_check_roll_contest",
144
+ "description": "对抗检定：分别判定我方与对方的同一时刻水平，比成功等级定胜负。actor 与 opponent 各写完整一套（name、traits、condition、situation 五维、checks）；每侧各发一次判定请求，任一侧失败则整次失败且不掷骰。bonus 与 joint 挂在侧上：每侧只投一次骰，侧内 checks 多于一项时必须 joint。不支持 grade。自动判定按序短路：我方 bonus≥3 → 我方胜；对方≤-3 → 我方胜；我方≤-3 → 对方胜；对方≥3 → 对方胜。命中时两侧都不调用判定模型，未定调的一侧显示「跳过检定」。比档：大成功>极难>困难>普通成功>普通失败>大失败，同级比难度数值高者胜、相等则我方胜。对抗不触发奖励骰。",
145
+ "parameters": {
146
+ "type": "object",
147
+ "additionalProperties": false,
148
+ "properties": {
149
+ "actor": {
150
+ "type": "object",
151
+ "additionalProperties": false,
152
+ "description": "我方；一份完整的判定请求。",
153
+ "properties": {
154
+ "name": {
155
+ "type": "string",
156
+ "minLength": 1,
157
+ "maxLength": 120,
158
+ "description": "我方角色的名字，用于回执与显示串。"
159
+ },
160
+ "traits": {
161
+ "type": "string",
162
+ "minLength": 1,
163
+ "maxLength": 600,
164
+ "description": "长期特质、背景、词条。"
165
+ },
166
+ "condition": {
167
+ "type": "string",
168
+ "minLength": 1,
169
+ "maxLength": 600,
170
+ "description": "伤势、疲劳、体温、精神与消耗状态。"
171
+ },
172
+ "situation": {
173
+ "type": "object",
174
+ "additionalProperties": false,
175
+ "description": "我方所面对的处境；某项确实无影响就写“无”，不要省略。",
176
+ "properties": {
177
+ "weather": {
178
+ "type": "string",
179
+ "minLength": 1,
180
+ "maxLength": 600,
181
+ "description": "天气与介质。"
182
+ },
183
+ "gear": {
184
+ "type": "string",
185
+ "minLength": 1,
186
+ "maxLength": 600,
187
+ "description": "工具与装备。"
188
+ },
189
+ "info": {
190
+ "type": "string",
191
+ "minLength": 1,
192
+ "maxLength": 600,
193
+ "description": "已知信息与资料的秩序。"
194
+ },
195
+ "time": {
196
+ "type": "string",
197
+ "minLength": 1,
198
+ "maxLength": 600,
199
+ "description": "时限。"
200
+ },
201
+ "senses": {
202
+ "type": "string",
203
+ "minLength": 1,
204
+ "maxLength": 600,
205
+ "description": "可见度与感官条件。"
206
+ }
207
+ },
208
+ "required": [
209
+ "weather",
210
+ "gear",
211
+ "info",
212
+ "time",
213
+ "senses"
214
+ ]
215
+ },
216
+ "checks": {
217
+ "type": "array",
218
+ "minItems": 1,
219
+ "description": "参与对抗的技能；多于一项时必须同时给 joint。",
220
+ "items": {
221
+ "type": "object",
222
+ "additionalProperties": false,
223
+ "properties": {
224
+ "skill": {
225
+ "type": "string",
226
+ "minLength": 1,
227
+ "maxLength": 120,
228
+ "description": "技能名。"
229
+ },
230
+ "goal": {
231
+ "type": "string",
232
+ "minLength": 1,
233
+ "maxLength": 300,
234
+ "description": "这一侧要靠它达到的直接结果。"
235
+ },
236
+ "evidence": {
237
+ "type": "string",
238
+ "minLength": 1,
239
+ "maxLength": 300,
240
+ "description": "这一侧在该技能上的水平证据；不写数字与档位名。"
241
+ }
242
+ },
243
+ "required": [
244
+ "skill",
245
+ "goal",
246
+ "evidence"
247
+ ]
248
+ }
249
+ },
250
+ "joint": {
251
+ "type": "string",
252
+ "enum": [
253
+ "and",
254
+ "or"
255
+ ],
256
+ "description": "这一侧的组合检定：and 取最小难度、or 取最大。侧内 checks 多于一项时必须指定。"
257
+ },
258
+ "bonus": {
259
+ "type": "integer",
260
+ "description": "这一侧的奖励/惩罚骰合计值：情境修正 + 这一侧花掉的 banked 奖励骰，0 或省略即基准。|bonus|≥3 时两侧都不调用判定模型，直接定胜负。"
261
+ }
262
+ },
263
+ "required": [
264
+ "name",
265
+ "traits",
266
+ "condition",
267
+ "situation",
268
+ "checks"
269
+ ]
270
+ },
271
+ "opponent": {
272
+ "type": "object",
273
+ "additionalProperties": false,
274
+ "description": "对方；与 actor 同形，写对方自己的处境与证据。",
275
+ "properties": {
276
+ "name": {
277
+ "type": "string",
278
+ "minLength": 1,
279
+ "maxLength": 120,
280
+ "description": "对方的名字，用于回执与显示串。"
281
+ },
282
+ "traits": {
283
+ "type": "string",
284
+ "minLength": 1,
285
+ "maxLength": 600,
286
+ "description": "长期特质、背景、词条。"
287
+ },
288
+ "condition": {
289
+ "type": "string",
290
+ "minLength": 1,
291
+ "maxLength": 600,
292
+ "description": "伤势、疲劳、体温、精神与消耗状态。"
293
+ },
294
+ "situation": {
295
+ "type": "object",
296
+ "additionalProperties": false,
297
+ "description": "对方所面对的处境；某项确实无影响就写“无”，不要省略。",
298
+ "properties": {
299
+ "weather": {
300
+ "type": "string",
301
+ "minLength": 1,
302
+ "maxLength": 600,
303
+ "description": "天气与介质。"
304
+ },
305
+ "gear": {
306
+ "type": "string",
307
+ "minLength": 1,
308
+ "maxLength": 600,
309
+ "description": "工具与装备。"
310
+ },
311
+ "info": {
312
+ "type": "string",
313
+ "minLength": 1,
314
+ "maxLength": 600,
315
+ "description": "已知信息与资料的秩序。"
316
+ },
317
+ "time": {
318
+ "type": "string",
319
+ "minLength": 1,
320
+ "maxLength": 600,
321
+ "description": "时限。"
322
+ },
323
+ "senses": {
324
+ "type": "string",
325
+ "minLength": 1,
326
+ "maxLength": 600,
327
+ "description": "可见度与感官条件。"
328
+ }
329
+ },
330
+ "required": [
331
+ "weather",
332
+ "gear",
333
+ "info",
334
+ "time",
335
+ "senses"
336
+ ]
337
+ },
338
+ "checks": {
339
+ "type": "array",
340
+ "minItems": 1,
341
+ "description": "参与对抗的技能；多于一项时必须同时给 joint。",
342
+ "items": {
343
+ "type": "object",
344
+ "additionalProperties": false,
345
+ "properties": {
346
+ "skill": {
347
+ "type": "string",
348
+ "minLength": 1,
349
+ "maxLength": 120,
350
+ "description": "技能名。"
351
+ },
352
+ "goal": {
353
+ "type": "string",
354
+ "minLength": 1,
355
+ "maxLength": 300,
356
+ "description": "这一侧要靠它达到的直接结果。"
357
+ },
358
+ "evidence": {
359
+ "type": "string",
360
+ "minLength": 1,
361
+ "maxLength": 300,
362
+ "description": "这一侧在该技能上的水平证据；不写数字与档位名。"
363
+ }
364
+ },
365
+ "required": [
366
+ "skill",
367
+ "goal",
368
+ "evidence"
369
+ ]
370
+ }
371
+ },
372
+ "joint": {
373
+ "type": "string",
374
+ "enum": [
375
+ "and",
376
+ "or"
377
+ ],
378
+ "description": "这一侧的组合检定：and 取最小难度、or 取最大。侧内 checks 多于一项时必须指定。"
379
+ },
380
+ "bonus": {
381
+ "type": "integer",
382
+ "description": "这一侧的奖励/惩罚骰合计值：情境修正 + 这一侧花掉的 banked 奖励骰，0 或省略即基准。|bonus|≥3 时两侧都不调用判定模型，直接定胜负。"
383
+ }
384
+ },
385
+ "required": [
386
+ "name",
387
+ "traits",
388
+ "condition",
389
+ "situation",
390
+ "checks"
391
+ ]
392
+ }
393
+ },
394
+ "required": [
395
+ "actor",
396
+ "opponent"
397
+ ]
398
+ },
399
+ "tags": [
400
+ "act"
401
+ ]
402
+ }
403
+ ],
404
+ "events": [],
405
+ "prompts": [
406
+ {
407
+ "key": "worlds.simple-trpg-check.envPrompt",
408
+ "title": "Simple TRPG Check · 环境提示词",
409
+ "role": "envPrompt",
410
+ "content": "仅在结果不确定且情境具有戏剧性时酌情进行技能判定：平静地走过明亮门廊无需判定；被怪物追赶时穿过遍布瓦砾的狭窄走廊则适合判定。需要判定时调用 simple_trpg_check_roll；两个会推理、会反应的智能体互相比试时，改用 simple_trpg_check_roll_contest。\n\n投骰之前，若你已能判断玩家的方法在此情境下几乎不可能奏效（需要的东西完全不在手边、方法与目标不相干），先提醒玩家可以考虑更换方式；不要强迫，玩家坚持就照投。投过骰之后就不要再提醒，那已成既定事实。\n\n调用时填写 character、situation 与 checks。\n- `character.traits`：长期特质、背景、词条。\n- `character.condition`：伤势、疲劳、体温、精神与消耗状态（如 SAN）。\n- `situation.weather`：天气与介质。`situation.gear`：工具与装备。`situation.info`：已知信息与资料的秩序。`situation.time`：时限。`situation.senses`：可见度与感官条件。\n- `checks`：按顺序列出本时刻要判定的技能。`skill` 是技能名，`goal` 是这项技能要达成的直接结果，`evidence` 是角色在该技能上的水平证据。\n\n技能名可以用下面这套常用表（有子分类的写具体项，例如格斗的「斗殴」「刀」、射击的「手枪」「步枪」、科学的「化学」「生物学」；表外的技能名也可以用，前后保持一致）：\n\n力量、体质、敏捷、智力（别名灵感）、意志、教育（别名知识）、说服、取悦、恐吓、欺骗、侦查、聆听、运动、潜行（别名乔装、追踪）、巧手（别名偷窃、伪造、锁匠）、驾驶、骑乘、导航、格斗、射击、闪避、投掷、爆破、急救、医学、科学、神秘学、历史、财富（别名信用、信用评级）。\n\n财富的 `evidence` 写已确立的收入、资产、生活水准和可支配资金，判定按贫困至富裕的档位衡量。\n\n`situation` 的五个字段加上 `character.condition` 就是情境的全部六个维度，一个都不能省略；某项确实没有影响就写「无」。\n\n难度由角色在该技能上的水平决定：判定模型只从 `evidence` 读出角色属于哪一档，因此 `evidence` 是唯一直接决定难度的字段，必须写得足以把角色定位到某一档。`goal` 与六个维度仍要如实填写——它们是判定记录，也是你决定代偿幅度的依据。\n\n情景不进 `evidence`：顺手的工具、大雨、性格与体型上的优势写进 `bonus`，任务本身的难度写进 `grade`，两者都不改变判定模型看到的水平。\n\n## 情景代偿\n\n情景上的优劣势用 `checks[i].bonus` 表达，标尺是 -2…2：-2 为巨大劣势（若干个劣势叠加，但还不至于让人物不可能完成），-1 为劣势，0 是基准（可省略），1 为优势，2 为巨大优势（若干个优势叠加，但还不至于让检定无需进行）。优势与劣势 1:1 抵消，你把这一时刻的所有因素在心里加总之后，只填**合计值**。\n\n奖励/惩罚骰的门槛比想象中高：它挪动的不是几个百分点，别拿它记小账。一个因素如果轻微到只会让成败概率挪几个百分点，就当作不存在，不要写进 `bonus`。小雨里开车不算惩罚；暴雨里雨刷开到满速仍然几乎看不见，那才算。绝大多数时候只给 ±1；只有情势**极其**有利或极其不利时，才给 ±2。\n\n`bonus` 只作用于掷骰：判定模型照旧只回答「角色在这项技能上处于哪一档」，随后掷 1+|bonus| 颗 d100，优势取最低、劣势取最高，再拿选中的那颗去比难度。\n\n合计值超过 ±2 是允许的，而且**鼓励**：假如压上两颗 banked 奖励骰把合计推到 3，这一次检定就直接自动成功，不消耗判定模型、也不掷骰。要让玩家「跳过」一次检定，这是唯一通路。\n\n任务本身的难度用 `checks[i].grade` 表达，只取 1 或 2。它说的是**这件事本身有多难**，与角色强不强无关：1 是连专业人士都要认真对待的挑战，2 是连专家都要吃力的挑战，已经贴近人类可能性的边界。同一件事不会因为角色弱就升档、因为角色强就降档。机制上，1 是困难（困难成功视为普通成功、普通成功视为失败），2 是极难（极难成功视为成功，其余视为失败），大成功与大失败不受影响。`grade` 与 `bonus` 可以同时用，但那属于特例，尽量少用；`grade` 不能与 `joint` 同时出现。\n\n## 奖励骰（账本由你维护）\n\n奖励与惩罚是**你的**职责，插件只给建议：奖励骰的授予、记账与落盘都由你在外部工具里完成，回执不会替你记。\n\n- 大成功要发奖励，且**当场落档**。二选一：白得关键信息或有利位置（纯叙事，不进资源），或者一颗奖励骰。\n- 困难成功与极难成功的奖励是**酌情**的：给不给、给多大全看你当场判断，不必落档。仍在上面那两类里挑。\n- 拿到奖励骰就当场记账，写成 `奖励骰:N 即时奖励骰:M`，值有变化时重写一遍。\n- **即时奖励骰**只能在紧接的下一次检定用掉，过期作废；**banked 奖励骰**没有期限，由玩家自己决定何时消耗（你可以提示玩家消耗奖励骰）。因为 `bonus` 是发起调用时一次写定的，同一次调用里后面的技能用不上前面刚发的即时骰——即时骰只对**后续调用**有效。\n- 战斗轮里的大成功按常规反馈、**不给**奖励骰：敌人的失误多给你一次行动、暴击效果拔群、命中弱点。\n\n## 组合检定\n\n如果 `goal` 要同时满足若干个独立事件的达成，用 `joint: \"and\"`；只要任意一个达成即可，用 `joint: \"or\"`。组合检定按有效难度判：`and` 取各项难度里最小的、`or` 取最大的；`bonus` 同样按 `and` 取最小、`or` 取最大。整组只掷**一次**骰。出现 `joint` 时 `checks` 至少要两项，且各项都不能带 `grade`。\n\n## 对抗检定\n\n会推理、会反应的智能体之间用 `simple_trpg_check_roll_contest`；无推理、只会被动感知的障碍（犬、传感器、摄像头）不适用，按环境写进 `checks`。近战行动几乎总会触发对抗。\n\n典型配对：力量对力量、格斗对闪避、说服（或其它交涉技能）对意志、潜行对聆听或侦查、巧手对侦查。不必照抄，比例合适即可。\n\n`actor` 与 `opponent` 各写完整的一套——`name`、`traits`、`condition`、各自的 `situation` 五维、各自的 `checks`（各自的 `skill`/`goal`/`evidence`）。对抗不接受 `grade`。`bonus` 与 `joint` 挂在**侧**上，因为每侧只掷一次骰；某一侧的 `checks` 多于一项时，必须给这一侧指定 `joint`。\n\n胜负先比成功等级：大成功 > 极难成功 > 困难成功 > 普通成功 > 普通失败 > 大失败；等级相同就比较难度数值，**数值高的一方胜出**，数值相等判玩家胜。换句话说，对抗永远有一个赢家。对抗检定的大成功、极难成功与困难成功都**不触发奖励**。\n\n某一侧的合计 `bonus` 达到 ±3 时直接定胜负：两侧都不判定、不掷骰，回执里未参与结算的一侧显示「跳过检定」。\n\n写作纪律：\n\n1. 情境必须自带全部相关上下文：判定模型只看得到这一次请求，看不到之前的对话。角色的状态、随身物与余量、已知的破法、上一次失败的原因，都要写进对应字段，不能写「同上」。\n2. 不写数字，也不写档位名（不要出现「技能 65」「职业级」这类字样）。水平只用证据表达：是否以此谋生、训练与实操年限、学历或认证、同行中的相对地位、过往的成败。\n3. 只写已经确立的事实。若有会影响结果的事实尚未确定（走廊多宽、锁是哪一种），先在叙事里定下来再调用；定不下来就不要调用。\n4. 有智慧的因素不构成本项难度的修正：人的态度、巡逻、守门走对抗检定，不要写进 `checks`。被动感知型的障碍（犬、传感器、摄像头）按环境写；人造装置算不算对手，由你判断。\n5. 需要「先 A 再 B」的链条时分两次调用：先投 A；A 成为事实、环境改变之后，第二次调用要把改变后的六个维度重新写一遍，不要复用上一段的文字。\n6. 同一次调用里的多项技能默认是同一时刻的独立检定，顺序只决定回执的排列，不表示依赖关系；需要它们共同决定一个 `goal` 时改用 `joint`。\n7. 一场对抗与一个战斗回合都是**一次**调用。回合变化后重新写两侧的六个维度，不要复用上一段的文字。\n\n请求长度按 token 估算（英文字符约 0.3、中文字符约 0.6、其他字符按 1 计，判定时另留一成余量）：整份请求不超过 1000、情境不超过 768、单项问题不超过 256。对抗检定把两侧当作两份请求，各自按这三条检测。超出会被拒绝，按回执提示精简后重试。\n\n根据工具回执继续叙事。回执末尾的「显示：」块就是面向用户的成品格式：把里面的每一行**原样照抄**，不要再改写档位名、补数字或调整标点。难度是达成概率的百分数（钳在 1–99），骰值不超过难度才算成功；带 `bonus` 时回执已经列出每一颗骰值并用 `=>` 标出选中那颗，带 `grade` 时回执里的档位名已经下压过。模型请求失败或输入被拒绝时，按回执处理：精简重写后重试，不编造骰值。\n"
411
+ }
412
+ ]
413
+ }