@saluzi/saluzi-edu 0.2.35 → 0.2.37
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.
|
@@ -11,10 +11,6 @@
|
|
|
11
11
|
"title": "模型选择与切换",
|
|
12
12
|
"path": "docs/guide/model-selection"
|
|
13
13
|
},
|
|
14
|
-
{
|
|
15
|
-
"title": "微信控制",
|
|
16
|
-
"path": "docs/guide/weixin-login"
|
|
17
|
-
},
|
|
18
14
|
{
|
|
19
15
|
"title": "对话基础",
|
|
20
16
|
"path": "docs/guide/conversation-basics"
|
|
@@ -22,6 +18,18 @@
|
|
|
22
18
|
{
|
|
23
19
|
"title": "上下文管理",
|
|
24
20
|
"path": "docs/guide/context-tips"
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"title": "查看与提交代码",
|
|
24
|
+
"path": "docs/guide/commit-workflow"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"title": "查看消耗",
|
|
28
|
+
"path": "docs/guide/cost-usage"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"title": "排障",
|
|
32
|
+
"path": "docs/guide/troubleshooting"
|
|
25
33
|
}
|
|
26
34
|
]
|
|
27
35
|
},
|
|
@@ -44,6 +52,10 @@
|
|
|
44
52
|
"title": "MOM 混合模型",
|
|
45
53
|
"path": "docs/guide/mom-mixed-models"
|
|
46
54
|
},
|
|
55
|
+
{
|
|
56
|
+
"title": "微信控制",
|
|
57
|
+
"path": "docs/guide/weixin-login"
|
|
58
|
+
},
|
|
47
59
|
{
|
|
48
60
|
"title": "Remote Control 与 ACP",
|
|
49
61
|
"path": "docs/guide/remote-control-acp"
|
|
@@ -67,12 +79,7 @@
|
|
|
67
79
|
"commands": [
|
|
68
80
|
{
|
|
69
81
|
"name": "btw",
|
|
70
|
-
"description": "Ask a quick side question without interrupting the main conversation"
|
|
71
|
-
"argumentHint": "<question>"
|
|
72
|
-
},
|
|
73
|
-
{
|
|
74
|
-
"name": "cost",
|
|
75
|
-
"description": "Show the total cost and duration of the current session"
|
|
82
|
+
"description": "Ask a quick side question without interrupting the main conversation"
|
|
76
83
|
},
|
|
77
84
|
{
|
|
78
85
|
"name": "exit",
|
|
@@ -81,10 +88,6 @@
|
|
|
81
88
|
"quit"
|
|
82
89
|
]
|
|
83
90
|
},
|
|
84
|
-
{
|
|
85
|
-
"name": "extra-usage",
|
|
86
|
-
"description": "Configure extra usage to keep working when limits are hit"
|
|
87
|
-
},
|
|
88
91
|
{
|
|
89
92
|
"name": "help",
|
|
90
93
|
"description": "Show help and available commands"
|
|
@@ -108,9 +111,6 @@
|
|
|
108
111
|
"android"
|
|
109
112
|
]
|
|
110
113
|
},
|
|
111
|
-
{
|
|
112
|
-
"name": "passes"
|
|
113
|
-
},
|
|
114
114
|
{
|
|
115
115
|
"name": "stats",
|
|
116
116
|
"description": "Show your Saluzi usage statistics and activity"
|
|
@@ -122,14 +122,6 @@
|
|
|
122
122
|
{
|
|
123
123
|
"name": "stickers",
|
|
124
124
|
"description": "Order Saluzi stickers"
|
|
125
|
-
},
|
|
126
|
-
{
|
|
127
|
-
"name": "upgrade",
|
|
128
|
-
"description": "Upgrade to Max for higher rate limits and Max model access"
|
|
129
|
-
},
|
|
130
|
-
{
|
|
131
|
-
"name": "usage",
|
|
132
|
-
"description": "Show plan usage limits"
|
|
133
125
|
}
|
|
134
126
|
]
|
|
135
127
|
},
|
|
@@ -148,30 +140,18 @@
|
|
|
148
140
|
},
|
|
149
141
|
{
|
|
150
142
|
"name": "compact",
|
|
151
|
-
"description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]"
|
|
152
|
-
"argumentHint": "<optional custom summarization instructions>"
|
|
153
|
-
},
|
|
154
|
-
{
|
|
155
|
-
"name": "context",
|
|
156
|
-
"description": "Visualize current context usage as a colored grid"
|
|
143
|
+
"description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]"
|
|
157
144
|
},
|
|
158
145
|
{
|
|
159
146
|
"name": "effort",
|
|
160
|
-
"description": "Set effort level for model usage"
|
|
161
|
-
"argumentHint": "[low|medium|high|xhigh|max|auto]"
|
|
147
|
+
"description": "Set effort level for model usage"
|
|
162
148
|
},
|
|
163
149
|
{
|
|
164
150
|
"name": "export",
|
|
165
|
-
"description": "Export the current conversation to a file or clipboard"
|
|
166
|
-
"argumentHint": "[filename]"
|
|
151
|
+
"description": "Export the current conversation to a file or clipboard"
|
|
167
152
|
},
|
|
168
153
|
{
|
|
169
|
-
"name": "
|
|
170
|
-
"argumentHint": "[on|off]"
|
|
171
|
-
},
|
|
172
|
-
{
|
|
173
|
-
"name": "model",
|
|
174
|
-
"argumentHint": "[model]"
|
|
154
|
+
"name": "model"
|
|
175
155
|
},
|
|
176
156
|
{
|
|
177
157
|
"name": "poor",
|
|
@@ -182,8 +162,7 @@
|
|
|
182
162
|
"description": "Resume a previous conversation",
|
|
183
163
|
"aliases": [
|
|
184
164
|
"continue"
|
|
185
|
-
]
|
|
186
|
-
"argumentHint": "[conversation id or search term]"
|
|
165
|
+
]
|
|
187
166
|
},
|
|
188
167
|
{
|
|
189
168
|
"name": "rewind",
|
|
@@ -192,17 +171,9 @@
|
|
|
192
171
|
"checkpoint"
|
|
193
172
|
]
|
|
194
173
|
},
|
|
195
|
-
{
|
|
196
|
-
"name": "session",
|
|
197
|
-
"description": "Show remote session URL and QR code",
|
|
198
|
-
"aliases": [
|
|
199
|
-
"remote"
|
|
200
|
-
]
|
|
201
|
-
},
|
|
202
174
|
{
|
|
203
175
|
"name": "skill-search",
|
|
204
|
-
"description": "Control automatic skill matching during conversations"
|
|
205
|
-
"argumentHint": "[start|stop|about|status]"
|
|
176
|
+
"description": "Control automatic skill matching during conversations"
|
|
206
177
|
},
|
|
207
178
|
{
|
|
208
179
|
"name": "summary",
|
|
@@ -217,16 +188,14 @@
|
|
|
217
188
|
"commands": [
|
|
218
189
|
{
|
|
219
190
|
"name": "add-dir",
|
|
220
|
-
"description": "Add a new working directory"
|
|
221
|
-
"argumentHint": "<path>"
|
|
191
|
+
"description": "Add a new working directory"
|
|
222
192
|
},
|
|
223
193
|
{
|
|
224
194
|
"name": "branch",
|
|
225
195
|
"description": "Create a branch of the current conversation at this point",
|
|
226
196
|
"aliases": [
|
|
227
197
|
"fork"
|
|
228
|
-
]
|
|
229
|
-
"argumentHint": "[name]"
|
|
198
|
+
]
|
|
230
199
|
},
|
|
231
200
|
{
|
|
232
201
|
"name": "copy",
|
|
@@ -236,14 +205,9 @@
|
|
|
236
205
|
"name": "diff",
|
|
237
206
|
"description": "View uncommitted changes and per-turn diffs"
|
|
238
207
|
},
|
|
239
|
-
{
|
|
240
|
-
"name": "files",
|
|
241
|
-
"description": "List all files currently in context"
|
|
242
|
-
},
|
|
243
208
|
{
|
|
244
209
|
"name": "rename",
|
|
245
|
-
"description": "Rename the current conversation"
|
|
246
|
-
"argumentHint": "[name]"
|
|
210
|
+
"description": "Rename the current conversation"
|
|
247
211
|
}
|
|
248
212
|
]
|
|
249
213
|
},
|
|
@@ -261,8 +225,7 @@
|
|
|
261
225
|
"description": "Start a local web server with the Saluzi usage guide (opens browser)",
|
|
262
226
|
"aliases": [
|
|
263
227
|
"docs"
|
|
264
|
-
]
|
|
265
|
-
"argumentHint": "[port]"
|
|
228
|
+
]
|
|
266
229
|
},
|
|
267
230
|
{
|
|
268
231
|
"name": "hooks",
|
|
@@ -270,26 +233,15 @@
|
|
|
270
233
|
},
|
|
271
234
|
{
|
|
272
235
|
"name": "ide",
|
|
273
|
-
"description": "Manage IDE integrations and show status"
|
|
274
|
-
"argumentHint": "[open]"
|
|
275
|
-
},
|
|
276
|
-
{
|
|
277
|
-
"name": "install-github-app",
|
|
278
|
-
"description": "Set up Saluzi GitHub Actions for a repository"
|
|
279
|
-
},
|
|
280
|
-
{
|
|
281
|
-
"name": "install-slack-app",
|
|
282
|
-
"description": "Install the Saluzi Slack app"
|
|
236
|
+
"description": "Manage IDE integrations and show status"
|
|
283
237
|
},
|
|
284
238
|
{
|
|
285
239
|
"name": "job",
|
|
286
|
-
"description": "Manage template jobs"
|
|
287
|
-
"argumentHint": "[list|new|reply|status]"
|
|
240
|
+
"description": "Manage template jobs"
|
|
288
241
|
},
|
|
289
242
|
{
|
|
290
243
|
"name": "mcp",
|
|
291
|
-
"description": "Manage MCP servers"
|
|
292
|
-
"argumentHint": "[enable|disable [server-name]]"
|
|
244
|
+
"description": "Manage MCP servers"
|
|
293
245
|
},
|
|
294
246
|
{
|
|
295
247
|
"name": "pr-comments",
|
|
@@ -299,37 +251,13 @@
|
|
|
299
251
|
"name": "reload-plugins",
|
|
300
252
|
"description": "Activate pending plugin changes in the current session"
|
|
301
253
|
},
|
|
302
|
-
{
|
|
303
|
-
"name": "remote-control",
|
|
304
|
-
"description": "Connect this terminal for remote-control sessions",
|
|
305
|
-
"aliases": [
|
|
306
|
-
"rc"
|
|
307
|
-
],
|
|
308
|
-
"argumentHint": "[name] [--team-id <id>] [--user-id <id>] [--username <name>]"
|
|
309
|
-
},
|
|
310
|
-
{
|
|
311
|
-
"name": "sandbox",
|
|
312
|
-
"argumentHint": "exclude "
|
|
313
|
-
},
|
|
314
254
|
{
|
|
315
255
|
"name": "skill-learning",
|
|
316
|
-
"description": "Manage skill learning (observe, analyze, evolve)"
|
|
317
|
-
"argumentHint": "[start|stop|about|status|ingest|evolve|export|import|prune|promote|projects]"
|
|
256
|
+
"description": "Manage skill learning (observe, analyze, evolve)"
|
|
318
257
|
},
|
|
319
258
|
{
|
|
320
259
|
"name": "skills",
|
|
321
260
|
"description": "List available skills"
|
|
322
|
-
},
|
|
323
|
-
{
|
|
324
|
-
"name": "terminal-setup"
|
|
325
|
-
},
|
|
326
|
-
{
|
|
327
|
-
"name": "think-back",
|
|
328
|
-
"description": "Your 2025 Saluzi Year in Review"
|
|
329
|
-
},
|
|
330
|
-
{
|
|
331
|
-
"name": "web-setup",
|
|
332
|
-
"description": "Setup Saluzi on the web (requires connecting your GitHub account)"
|
|
333
261
|
}
|
|
334
262
|
]
|
|
335
263
|
},
|
|
@@ -355,12 +283,7 @@
|
|
|
355
283
|
},
|
|
356
284
|
{
|
|
357
285
|
"name": "plan",
|
|
358
|
-
"description": "Enable plan mode or view the current session plan"
|
|
359
|
-
"argumentHint": "[open|<description>]"
|
|
360
|
-
},
|
|
361
|
-
{
|
|
362
|
-
"name": "privacy-settings",
|
|
363
|
-
"description": "View and update your privacy settings"
|
|
286
|
+
"description": "Enable plan mode or view the current session plan"
|
|
364
287
|
}
|
|
365
288
|
]
|
|
366
289
|
},
|
|
@@ -371,8 +294,7 @@
|
|
|
371
294
|
"commands": [
|
|
372
295
|
{
|
|
373
296
|
"name": "color",
|
|
374
|
-
"description": "Set the prompt bar color for this session"
|
|
375
|
-
"argumentHint": "<color|default>"
|
|
297
|
+
"description": "Set the prompt bar color for this session"
|
|
376
298
|
},
|
|
377
299
|
{
|
|
378
300
|
"name": "config",
|
|
@@ -381,26 +303,13 @@
|
|
|
381
303
|
"settings"
|
|
382
304
|
]
|
|
383
305
|
},
|
|
384
|
-
{
|
|
385
|
-
"name": "desktop",
|
|
386
|
-
"description": "Continue the current session in Saluzi Desktop",
|
|
387
|
-
"aliases": [
|
|
388
|
-
"app"
|
|
389
|
-
]
|
|
390
|
-
},
|
|
391
306
|
{
|
|
392
307
|
"name": "keybindings",
|
|
393
308
|
"description": "Open or create your keybindings configuration file"
|
|
394
309
|
},
|
|
395
310
|
{
|
|
396
311
|
"name": "lang",
|
|
397
|
-
"description": "Set display language (en/zh/auto)"
|
|
398
|
-
"argumentHint": "<en|zh|auto>"
|
|
399
|
-
},
|
|
400
|
-
{
|
|
401
|
-
"name": "tag",
|
|
402
|
-
"description": "Toggle a searchable tag on the current session",
|
|
403
|
-
"argumentHint": "<tag-name>"
|
|
312
|
+
"description": "Set display language (en/zh/auto)"
|
|
404
313
|
},
|
|
405
314
|
{
|
|
406
315
|
"name": "theme",
|
|
@@ -417,33 +326,17 @@
|
|
|
417
326
|
"title": "Automation & Advanced",
|
|
418
327
|
"titleZh": "自动化与高级",
|
|
419
328
|
"commands": [
|
|
420
|
-
{
|
|
421
|
-
"name": "assistant",
|
|
422
|
-
"description": "Open the Kairos assistant panel"
|
|
423
|
-
},
|
|
424
|
-
{
|
|
425
|
-
"name": "buddy",
|
|
426
|
-
"description": "Hatch a coding companion · pet, off",
|
|
427
|
-
"argumentHint": "[pet|off]"
|
|
428
|
-
},
|
|
429
329
|
{
|
|
430
330
|
"name": "daemon",
|
|
431
|
-
"description": "Manage background sessions and daemon"
|
|
432
|
-
"argumentHint": "[status|start|stop|bg|attach|logs|kill]"
|
|
331
|
+
"description": "Manage background sessions and daemon"
|
|
433
332
|
},
|
|
434
333
|
{
|
|
435
334
|
"name": "mom",
|
|
436
|
-
"description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn"
|
|
437
|
-
"argumentHint": "[content]"
|
|
335
|
+
"description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn"
|
|
438
336
|
},
|
|
439
337
|
{
|
|
440
338
|
"name": "parade",
|
|
441
|
-
"description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop."
|
|
442
|
-
"argumentHint": "[off]"
|
|
443
|
-
},
|
|
444
|
-
{
|
|
445
|
-
"name": "remote-env",
|
|
446
|
-
"description": "Configure the default remote environment for teleport sessions"
|
|
339
|
+
"description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop."
|
|
447
340
|
},
|
|
448
341
|
{
|
|
449
342
|
"name": "tasks",
|
|
@@ -451,10 +344,6 @@
|
|
|
451
344
|
"aliases": [
|
|
452
345
|
"bashes"
|
|
453
346
|
]
|
|
454
|
-
},
|
|
455
|
-
{
|
|
456
|
-
"name": "voice",
|
|
457
|
-
"description": "Toggle voice mode. Use /voice doubao for Doubao ASR backend"
|
|
458
347
|
}
|
|
459
348
|
]
|
|
460
349
|
},
|
|
@@ -476,34 +365,22 @@
|
|
|
476
365
|
"commands": {
|
|
477
366
|
"add-dir": {
|
|
478
367
|
"name": "add-dir",
|
|
479
|
-
"description": "Add a new working directory"
|
|
480
|
-
"argumentHint": "<path>"
|
|
368
|
+
"description": "Add a new working directory"
|
|
481
369
|
},
|
|
482
370
|
"agents": {
|
|
483
371
|
"name": "agents",
|
|
484
372
|
"description": "Manage agent configurations"
|
|
485
373
|
},
|
|
486
|
-
"assistant": {
|
|
487
|
-
"name": "assistant",
|
|
488
|
-
"description": "Open the Kairos assistant panel"
|
|
489
|
-
},
|
|
490
374
|
"branch": {
|
|
491
375
|
"name": "branch",
|
|
492
376
|
"description": "Create a branch of the current conversation at this point",
|
|
493
377
|
"aliases": [
|
|
494
378
|
"fork"
|
|
495
|
-
]
|
|
496
|
-
"argumentHint": "[name]"
|
|
379
|
+
]
|
|
497
380
|
},
|
|
498
381
|
"btw": {
|
|
499
382
|
"name": "btw",
|
|
500
|
-
"description": "Ask a quick side question without interrupting the main conversation"
|
|
501
|
-
"argumentHint": "<question>"
|
|
502
|
-
},
|
|
503
|
-
"buddy": {
|
|
504
|
-
"name": "buddy",
|
|
505
|
-
"description": "Hatch a coding companion · pet, off",
|
|
506
|
-
"argumentHint": "[pet|off]"
|
|
383
|
+
"description": "Ask a quick side question without interrupting the main conversation"
|
|
507
384
|
},
|
|
508
385
|
"clear": {
|
|
509
386
|
"name": "clear",
|
|
@@ -515,13 +392,11 @@
|
|
|
515
392
|
},
|
|
516
393
|
"color": {
|
|
517
394
|
"name": "color",
|
|
518
|
-
"description": "Set the prompt bar color for this session"
|
|
519
|
-
"argumentHint": "<color|default>"
|
|
395
|
+
"description": "Set the prompt bar color for this session"
|
|
520
396
|
},
|
|
521
397
|
"compact": {
|
|
522
398
|
"name": "compact",
|
|
523
|
-
"description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]"
|
|
524
|
-
"argumentHint": "<optional custom summarization instructions>"
|
|
399
|
+
"description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]"
|
|
525
400
|
},
|
|
526
401
|
"config": {
|
|
527
402
|
"name": "config",
|
|
@@ -530,29 +405,13 @@
|
|
|
530
405
|
"settings"
|
|
531
406
|
]
|
|
532
407
|
},
|
|
533
|
-
"context": {
|
|
534
|
-
"name": "context",
|
|
535
|
-
"description": "Visualize current context usage as a colored grid"
|
|
536
|
-
},
|
|
537
408
|
"copy": {
|
|
538
409
|
"name": "copy",
|
|
539
410
|
"description": "Copy Saluzi"
|
|
540
411
|
},
|
|
541
|
-
"cost": {
|
|
542
|
-
"name": "cost",
|
|
543
|
-
"description": "Show the total cost and duration of the current session"
|
|
544
|
-
},
|
|
545
412
|
"daemon": {
|
|
546
413
|
"name": "daemon",
|
|
547
|
-
"description": "Manage background sessions and daemon"
|
|
548
|
-
"argumentHint": "[status|start|stop|bg|attach|logs|kill]"
|
|
549
|
-
},
|
|
550
|
-
"desktop": {
|
|
551
|
-
"name": "desktop",
|
|
552
|
-
"description": "Continue the current session in Saluzi Desktop",
|
|
553
|
-
"aliases": [
|
|
554
|
-
"app"
|
|
555
|
-
]
|
|
414
|
+
"description": "Manage background sessions and daemon"
|
|
556
415
|
},
|
|
557
416
|
"diff": {
|
|
558
417
|
"name": "diff",
|
|
@@ -564,8 +423,7 @@
|
|
|
564
423
|
},
|
|
565
424
|
"effort": {
|
|
566
425
|
"name": "effort",
|
|
567
|
-
"description": "Set effort level for model usage"
|
|
568
|
-
"argumentHint": "[low|medium|high|xhigh|max|auto]"
|
|
426
|
+
"description": "Set effort level for model usage"
|
|
569
427
|
},
|
|
570
428
|
"exit": {
|
|
571
429
|
"name": "exit",
|
|
@@ -576,28 +434,14 @@
|
|
|
576
434
|
},
|
|
577
435
|
"export": {
|
|
578
436
|
"name": "export",
|
|
579
|
-
"description": "Export the current conversation to a file or clipboard"
|
|
580
|
-
"argumentHint": "[filename]"
|
|
581
|
-
},
|
|
582
|
-
"extra-usage": {
|
|
583
|
-
"name": "extra-usage",
|
|
584
|
-
"description": "Configure extra usage to keep working when limits are hit"
|
|
585
|
-
},
|
|
586
|
-
"fast": {
|
|
587
|
-
"name": "fast",
|
|
588
|
-
"argumentHint": "[on|off]"
|
|
589
|
-
},
|
|
590
|
-
"files": {
|
|
591
|
-
"name": "files",
|
|
592
|
-
"description": "List all files currently in context"
|
|
437
|
+
"description": "Export the current conversation to a file or clipboard"
|
|
593
438
|
},
|
|
594
439
|
"guide": {
|
|
595
440
|
"name": "guide",
|
|
596
441
|
"description": "Start a local web server with the Saluzi usage guide (opens browser)",
|
|
597
442
|
"aliases": [
|
|
598
443
|
"docs"
|
|
599
|
-
]
|
|
600
|
-
"argumentHint": "[port]"
|
|
444
|
+
]
|
|
601
445
|
},
|
|
602
446
|
"help": {
|
|
603
447
|
"name": "help",
|
|
@@ -609,21 +453,11 @@
|
|
|
609
453
|
},
|
|
610
454
|
"ide": {
|
|
611
455
|
"name": "ide",
|
|
612
|
-
"description": "Manage IDE integrations and show status"
|
|
613
|
-
"argumentHint": "[open]"
|
|
614
|
-
},
|
|
615
|
-
"install-github-app": {
|
|
616
|
-
"name": "install-github-app",
|
|
617
|
-
"description": "Set up Saluzi GitHub Actions for a repository"
|
|
618
|
-
},
|
|
619
|
-
"install-slack-app": {
|
|
620
|
-
"name": "install-slack-app",
|
|
621
|
-
"description": "Install the Saluzi Slack app"
|
|
456
|
+
"description": "Manage IDE integrations and show status"
|
|
622
457
|
},
|
|
623
458
|
"job": {
|
|
624
459
|
"name": "job",
|
|
625
|
-
"description": "Manage template jobs"
|
|
626
|
-
"argumentHint": "[list|new|reply|status]"
|
|
460
|
+
"description": "Manage template jobs"
|
|
627
461
|
},
|
|
628
462
|
"keybindings": {
|
|
629
463
|
"name": "keybindings",
|
|
@@ -635,8 +469,7 @@
|
|
|
635
469
|
},
|
|
636
470
|
"lang": {
|
|
637
471
|
"name": "lang",
|
|
638
|
-
"description": "Set display language (en/zh/auto)"
|
|
639
|
-
"argumentHint": "<en|zh|auto>"
|
|
472
|
+
"description": "Set display language (en/zh/auto)"
|
|
640
473
|
},
|
|
641
474
|
"login": {
|
|
642
475
|
"name": "login"
|
|
@@ -647,8 +480,7 @@
|
|
|
647
480
|
},
|
|
648
481
|
"mcp": {
|
|
649
482
|
"name": "mcp",
|
|
650
|
-
"description": "Manage MCP servers"
|
|
651
|
-
"argumentHint": "[enable|disable [server-name]]"
|
|
483
|
+
"description": "Manage MCP servers"
|
|
652
484
|
},
|
|
653
485
|
"memory": {
|
|
654
486
|
"name": "memory",
|
|
@@ -663,21 +495,15 @@
|
|
|
663
495
|
]
|
|
664
496
|
},
|
|
665
497
|
"model": {
|
|
666
|
-
"name": "model"
|
|
667
|
-
"argumentHint": "[model]"
|
|
498
|
+
"name": "model"
|
|
668
499
|
},
|
|
669
500
|
"mom": {
|
|
670
501
|
"name": "mom",
|
|
671
|
-
"description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn"
|
|
672
|
-
"argumentHint": "[content]"
|
|
502
|
+
"description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn"
|
|
673
503
|
},
|
|
674
504
|
"parade": {
|
|
675
505
|
"name": "parade",
|
|
676
|
-
"description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop."
|
|
677
|
-
"argumentHint": "[off]"
|
|
678
|
-
},
|
|
679
|
-
"passes": {
|
|
680
|
-
"name": "passes"
|
|
506
|
+
"description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop."
|
|
681
507
|
},
|
|
682
508
|
"permissions": {
|
|
683
509
|
"name": "permissions",
|
|
@@ -688,8 +514,7 @@
|
|
|
688
514
|
},
|
|
689
515
|
"plan": {
|
|
690
516
|
"name": "plan",
|
|
691
|
-
"description": "Enable plan mode or view the current session plan"
|
|
692
|
-
"argumentHint": "[open|<description>]"
|
|
517
|
+
"description": "Enable plan mode or view the current session plan"
|
|
693
518
|
},
|
|
694
519
|
"poor": {
|
|
695
520
|
"name": "poor",
|
|
@@ -699,22 +524,10 @@
|
|
|
699
524
|
"name": "pr-comments",
|
|
700
525
|
"description": "Get comments from a GitHub pull request"
|
|
701
526
|
},
|
|
702
|
-
"privacy-settings": {
|
|
703
|
-
"name": "privacy-settings",
|
|
704
|
-
"description": "View and update your privacy settings"
|
|
705
|
-
},
|
|
706
527
|
"reload-plugins": {
|
|
707
528
|
"name": "reload-plugins",
|
|
708
529
|
"description": "Activate pending plugin changes in the current session"
|
|
709
530
|
},
|
|
710
|
-
"remote-control": {
|
|
711
|
-
"name": "remote-control",
|
|
712
|
-
"description": "Connect this terminal for remote-control sessions",
|
|
713
|
-
"aliases": [
|
|
714
|
-
"rc"
|
|
715
|
-
],
|
|
716
|
-
"argumentHint": "[name] [--team-id <id>] [--user-id <id>] [--username <name>]"
|
|
717
|
-
},
|
|
718
531
|
"remote-control-server": {
|
|
719
532
|
"name": "remote-control-server",
|
|
720
533
|
"description": "Start a self-hosted Remote Control Server with Web UI (requires RCS_API_KEYS)",
|
|
@@ -722,22 +535,16 @@
|
|
|
722
535
|
"rcs"
|
|
723
536
|
]
|
|
724
537
|
},
|
|
725
|
-
"remote-env": {
|
|
726
|
-
"name": "remote-env",
|
|
727
|
-
"description": "Configure the default remote environment for teleport sessions"
|
|
728
|
-
},
|
|
729
538
|
"rename": {
|
|
730
539
|
"name": "rename",
|
|
731
|
-
"description": "Rename the current conversation"
|
|
732
|
-
"argumentHint": "[name]"
|
|
540
|
+
"description": "Rename the current conversation"
|
|
733
541
|
},
|
|
734
542
|
"resume": {
|
|
735
543
|
"name": "resume",
|
|
736
544
|
"description": "Resume a previous conversation",
|
|
737
545
|
"aliases": [
|
|
738
546
|
"continue"
|
|
739
|
-
]
|
|
740
|
-
"argumentHint": "[conversation id or search term]"
|
|
547
|
+
]
|
|
741
548
|
},
|
|
742
549
|
"rewind": {
|
|
743
550
|
"name": "rewind",
|
|
@@ -746,26 +553,13 @@
|
|
|
746
553
|
"checkpoint"
|
|
747
554
|
]
|
|
748
555
|
},
|
|
749
|
-
"sandbox": {
|
|
750
|
-
"name": "sandbox",
|
|
751
|
-
"argumentHint": "exclude "
|
|
752
|
-
},
|
|
753
|
-
"session": {
|
|
754
|
-
"name": "session",
|
|
755
|
-
"description": "Show remote session URL and QR code",
|
|
756
|
-
"aliases": [
|
|
757
|
-
"remote"
|
|
758
|
-
]
|
|
759
|
-
},
|
|
760
556
|
"skill-learning": {
|
|
761
557
|
"name": "skill-learning",
|
|
762
|
-
"description": "Manage skill learning (observe, analyze, evolve)"
|
|
763
|
-
"argumentHint": "[start|stop|about|status|ingest|evolve|export|import|prune|promote|projects]"
|
|
558
|
+
"description": "Manage skill learning (observe, analyze, evolve)"
|
|
764
559
|
},
|
|
765
560
|
"skill-search": {
|
|
766
561
|
"name": "skill-search",
|
|
767
|
-
"description": "Control automatic skill matching during conversations"
|
|
768
|
-
"argumentHint": "[start|stop|about|status]"
|
|
562
|
+
"description": "Control automatic skill matching during conversations"
|
|
769
563
|
},
|
|
770
564
|
"skills": {
|
|
771
565
|
"name": "skills",
|
|
@@ -787,11 +581,6 @@
|
|
|
787
581
|
"name": "summary",
|
|
788
582
|
"description": "Generate and display a session summary"
|
|
789
583
|
},
|
|
790
|
-
"tag": {
|
|
791
|
-
"name": "tag",
|
|
792
|
-
"description": "Toggle a searchable tag on the current session",
|
|
793
|
-
"argumentHint": "<tag-name>"
|
|
794
|
-
},
|
|
795
584
|
"tasks": {
|
|
796
585
|
"name": "tasks",
|
|
797
586
|
"description": "List and manage background tasks",
|
|
@@ -799,36 +588,13 @@
|
|
|
799
588
|
"bashes"
|
|
800
589
|
]
|
|
801
590
|
},
|
|
802
|
-
"terminal-setup": {
|
|
803
|
-
"name": "terminal-setup"
|
|
804
|
-
},
|
|
805
591
|
"theme": {
|
|
806
592
|
"name": "theme",
|
|
807
593
|
"description": "Change the theme"
|
|
808
594
|
},
|
|
809
|
-
"think-back": {
|
|
810
|
-
"name": "think-back",
|
|
811
|
-
"description": "Your 2025 Saluzi Year in Review"
|
|
812
|
-
},
|
|
813
|
-
"upgrade": {
|
|
814
|
-
"name": "upgrade",
|
|
815
|
-
"description": "Upgrade to Max for higher rate limits and Max model access"
|
|
816
|
-
},
|
|
817
|
-
"usage": {
|
|
818
|
-
"name": "usage",
|
|
819
|
-
"description": "Show plan usage limits"
|
|
820
|
-
},
|
|
821
595
|
"vim": {
|
|
822
596
|
"name": "vim",
|
|
823
597
|
"description": "Toggle between Vim and Normal editing modes"
|
|
824
|
-
},
|
|
825
|
-
"voice": {
|
|
826
|
-
"name": "voice",
|
|
827
|
-
"description": "Toggle voice mode. Use /voice doubao for Doubao ASR backend"
|
|
828
|
-
},
|
|
829
|
-
"web-setup": {
|
|
830
|
-
"name": "web-setup",
|
|
831
|
-
"description": "Setup Saluzi on the web (requires connecting your GitHub account)"
|
|
832
598
|
}
|
|
833
599
|
},
|
|
834
600
|
"envVars": [
|
|
@@ -3059,6 +2825,22 @@
|
|
|
3059
2825
|
}
|
|
3060
2826
|
],
|
|
3061
2827
|
"chapters": {
|
|
2828
|
+
"docs/guide/commit-workflow": {
|
|
2829
|
+
"frontmatter": {
|
|
2830
|
+
"title": "查看与提交代码 - diff、commit 与 PR 工作流",
|
|
2831
|
+
"description": "使用 /diff 预览改动、/commit 提交、/commit-push-pr 一条龙推送并创建 PR、/review 代码审查。",
|
|
2832
|
+
"keywords": [
|
|
2833
|
+
"diff",
|
|
2834
|
+
"commit",
|
|
2835
|
+
"commit-push-pr",
|
|
2836
|
+
"review",
|
|
2837
|
+
"提交",
|
|
2838
|
+
"PR",
|
|
2839
|
+
"代码审查"
|
|
2840
|
+
]
|
|
2841
|
+
},
|
|
2842
|
+
"content": "\n## 预览改动\n\n在提交前,先用 `/diff` 查看当前工作区所有未提交的改动,确认修改范围是否符合预期:\n\n```\n> /diff\n```\n\nSaluzi 会列出已暂存和未暂存的文件变更摘要,帮助你快速定位哪些文件被新增、修改或删除。\n如果发现意外改动,可以先撤销再继续。\n\n## 提交代码\n\n确认改动无误后,使用 `/commit` 提交。Saluzi 会根据 diff 内容自动生成 Conventional Commits 格式的 commit message:\n\n```\n> /commit\n```\n\n你也可以附加参数指定 message 类型或描述:\n\n```\n> /commit -m \"fix: 修复登录页的空指针问题\"\n```\n\n提交后改动保存在本地仓库,不会自动推送到远端。\n\n## 推送并创建 PR\n\n如果想一步到位——提交、推送、并在 GitHub 上创建 Pull Request,使用 `/commit-push-pr`:\n\n```\n> /commit-push-pr\n```\n\nSaluzi 会依次执行:\n1. 根据改动生成 commit message 并提交\n2. 将当前分支推送到远端\n3. 基于 commit 信息创建 PR 标题与描述\n\n适合功能分支开发完毕后一次性完成发布流程。\n\n## 代码审查\n\n使用 `/review` 对当前分支的改动或指定 PR 进行审查:\n\n```\n> /review\n```\n\n也可以指定 PR 编号:\n\n```\n> /review #42\n```\n\nSaluzi 会逐文件分析改动,指出潜在的 bug、风格问题和改进建议。\n\n## 提交模式对比\n\n| 特性 | `/commit` | `/commit-push-pr` |\n|------|-----------|-------------------|\n| 自动生成 commit message | 是 | 是 |\n| 提交到本地仓库 | 是 | 是 |\n| 推送到远端分支 | 否 | 是 |\n| 创建 Pull Request | 否 | 是 |\n| 适用场景 | 本地暂存、分批提交 | 功能完成后一步发布 |\n\n## 下一步\n\n- [上下文与项目记忆](./context-tips) — 让 AI 更懂你的项目\n- [查看消耗](./cost-usage) — 了解会话花费\n- [排障](./troubleshooting) — 常见问题与解决方案\n"
|
|
2843
|
+
},
|
|
3062
2844
|
"docs/guide/parade": {
|
|
3063
2845
|
"frontmatter": {
|
|
3064
2846
|
"title": "Parade 桌面悬浮提示",
|
|
@@ -3088,6 +2870,19 @@
|
|
|
3088
2870
|
},
|
|
3089
2871
|
"content": "\n## 什么是 CodeGraph\n\nCodeGraph 是 Saluzi 的本地优先(local-first)代码智能系统。它将整个代码库解析为 SQLite 知识图谱(每个符号、边、文件都有记录),提供亚毫秒级的结构化查询。\n\n## 7 个工具\n\n| 工具 | 用途 |\n|------|------|\n| `codegraph_explore` | 自然语言查询,返回相关符号源码 + 调用路径 + 影响范围 |\n| `codegraph_search` | 关键词搜索符号 |\n| `codegraph_node` | 查询单个符号的详细信息 |\n| `codegraph_callers` | 查找谁调用了某个符号 |\n| `codegraph_callees` | 查找某个符号调用了谁 |\n| `codegraph_impact` | 分析修改某符号的影响范围 |\n| `codegraph_files` | 按文件查询符号 |\n\n## 启用 CodeGraph\n\nCodeGraph **不会自动生成索引**。首次使用需要在 `/codegraph` 卡片中手动初始化:\n\n```\n> /codegraph # 打开管理面板\n```\n\n面板包含三个区域:\n\n1. **索引状态**:显示索引统计数据,或提供初始化按钮。点击后**异步**构建索引(不阻塞当前会话),大项目可能需要 1-2 分钟\n2. **模式切换**:explore / half / full / off(详见下文)\n3. **可用工具列表**:根据当前模式显示已启用的工具\n\n索引构建完成后,后续通过文件监听自动保持同步(写入后约 1 秒)。\n\n## 4 种可见模式\n\nCodeGraph 有 4 种工具可见模式,控制 AI 能使用哪些 CodeGraph 工具:\n\n| 模式 | 可见工具数 | 工具列表 | 适用场景 |\n|------|-----------|---------|---------|\n| **explore**(默认) | 1 | `codegraph_explore` | 日常使用,一个工具覆盖大多数场景 |\n| **half** | 4 | explore + node + search + callers | 需要更精确的符号级查询 |\n| **full** | 7 | 全部 7 个工具 | 深度代码分析、重构评估 |\n| **off** | 0 | 全部禁用 | 不需要 CodeGraph 时节省 token |\n\n**默认行为**:如果项目已有 CodeGraph 索引(`.codegraph/` 目录),默认使用 `explore` 模式;如果没有索引,默认为 `off`。\n\n模式存储在 `.saluzi-edu/settings.json` 中,按项目独立配置。\n\n## 典型场景\n\n### 理解陌生代码\n\n```\n> 这个函数是怎么启动 HTTP 服务器的\n```\n\nSaluzi 调用 `codegraph_explore`,返回相关函数的源码、调用路径与依赖它的文件。\n\n### 评估改动影响\n\n```\n> 改这个函数会影响哪些地方\n```\n\nSaluzi 调用 `codegraph_impact`,返回所有调用该函数的位置,帮助评估重构风险。\n\n### 追踪调用链\n\n```\n> 从入口到这个工具的完整调用路径\n```\n\nSaluzi 通过 `codegraph_explore` 的 flow 查询追踪完整路径,包括动态分派(回调、JSX children)。\n\n## 与 grep 的区别\n\n| grep | CodeGraph |\n|------|-----------|\n| 字符串匹配 | AST 解析 |\n| 无调用关系 | 完整调用图 |\n| 跨文件需手动追踪 | 自动追踪 |\n| 无影响分析 | 提供影响范围 |\n| 快但浅 | 稍慢但深 |\n\n## 性能与限制\n\n- 索引大小:约为代码库的 2-3 倍(SQLite 压缩)\n- 索引滞后:文件写入后约 1 秒同步\n- 跨文件解析:基于名称匹配,模糊调用可能返回多候选\n- 不验证正确性:仍需编译器/测试套件确认\n"
|
|
3090
2872
|
},
|
|
2873
|
+
"docs/guide/cost-usage": {
|
|
2874
|
+
"frontmatter": {
|
|
2875
|
+
"title": "查看消耗 - 会话花费与历史统计",
|
|
2876
|
+
"description": "使用 /cost、/stats 查看当前会话花费与历史统计。",
|
|
2877
|
+
"keywords": [
|
|
2878
|
+
"cost",
|
|
2879
|
+
"stats",
|
|
2880
|
+
"消耗",
|
|
2881
|
+
"统计"
|
|
2882
|
+
]
|
|
2883
|
+
},
|
|
2884
|
+
"content": "\n## 当前会话花费\n\n`/cost` 显示本次会话的 token 消耗与费用明细。适合在长对话中随时检查开销:\n\n```\n> /cost\n```\n\n输出包含输入 token、输出 token 以及折算后的费用。会话结束后计数清零,下次对话重新累计。\n\n## 历史统计\n\n`/stats` 展示跨会话的累计数据,包括总对话次数、总 token 消耗等:\n\n```\n> /stats\n```\n\n与 `/cost` 的区别在于:`/cost` 只看当前会话,`/stats` 汇总所有历史记录。\n\n## 命令速查\n\n| 命令 | 作用范围 | 用途 |\n|------|---------|------|\n| `/cost` | 当前会话 | 本次对话的 token 与费用 |\n| `/stats` | 全部历史 | 累计消耗与会话统计 |\n\n## 下一步\n\n- [故障排查](./troubleshooting) — 常见问题与解决方案\n- [代码图谱](./codegraph) — 用 CodeGraph 探索项目结构\n- [模型选择与切换](./model-selection) — 调整模型以控制成本\n"
|
|
2885
|
+
},
|
|
3091
2886
|
"docs/guide/getting-started": {
|
|
3092
2887
|
"frontmatter": {
|
|
3093
2888
|
"title": "新手入门 - 安装、登录与首次对话",
|
|
@@ -3100,12 +2895,12 @@
|
|
|
3100
2895
|
"commit"
|
|
3101
2896
|
]
|
|
3102
2897
|
},
|
|
3103
|
-
"content": "\n## 安装 Saluzi CLI\n\nSaluzi 是终端原生的 agentic coding system,通过 npm 全局安装:\n\n```bash\nnpm install -g @saluzi/saluzi-edu\n```\n\n安装后验证:\n\n```bash\nslz --version\n```\n\n## 首次登录\n\n启动 CLI 后输入 `/login` 命令:\n\n```\nslz\n> /login\n```\n\n
|
|
2898
|
+
"content": "\n## 安装 Saluzi CLI\n\nSaluzi 是终端原生的 agentic coding system,通过 npm 全局安装:\n\n```bash\nnpm install -g @saluzi/saluzi-edu\n```\n\n安装后验证:\n\n```bash\nslz --version\n```\n\n## 首次登录\n\n启动 CLI 后输入 `/login` 命令:\n\n```\nslz\n> /login\n```\n\n弹出 `Login` 对话框,首先提示 `Select login method:`,共 6 个 Provider 选项。按 `↑/↓` 选择,`Enter` 确认:\n\n| # | 选项 | 副标题 | 适用场景 |\n|---|------|--------|---------|\n| 1 | Anthropic Compatible | Configure your own API endpoint | 自建/代理的 Anthropic 格式端点(如反代、中转) |\n| 2 | OpenAI Compatible | Ollama, DeepSeek, vLLM, One API, etc. | OpenAI Chat Completions 格式的本地或第三方模型 |\n| 3 | Gemini API | Google Gemini native REST/SSE | Google 原生 Gemini 接口 |\n| 4 | Saluzi account with subscription | Pro, Max, Team, or Enterprise | 订阅账户(个人/团队最常用) |\n| 5 | Anthropic Console account | API usage billing | Anthropic Console 按 API 用量计费 |\n| 6 | 3rd-party platform | Amazon Bedrock, Microsoft Foundry, or Vertex AI | 云厂商托管入口 |\n\n> 如果已设置 `ANTHROPIC_API_KEY` 环境变量,Saluzi 会自动检测并跳过登录,`/login` 此时显示为 \"Switch Saluzi accounts\"。\n\n### 选项 1-3:API 表单登录\n\n选择前三个选项(Anthropic / OpenAI / Gemini Compatible)后进入对应的字段表单。三者字段完全一致,只是写入的环境变量不同:\n\n| 字段 | 标签 | 说明 | 是否必填 |\n|------|------|------|---------|\n| baseUrl | Base URL | API 端点地址,需含协议(如 `https://api.example.com`) | 否(留空走默认) |\n| apiKey | API Key | 密钥,输入时掩码显示 | 否 |\n| stdModel | Std | standard 模型名(如 `claude-sonnet-4-5`) | 否 |\n| proModel | Pro | pro 模型名 | 否 |\n| maxModel | Max | max 模型名 | 否 |\n| maxOutputTokens | Out Tok | 单次响应最大 token 数 | 否 |\n| autoCompactWindow | AC Win | 自动压缩上下文的窗口大小 | 否 |\n| autoCompactPctOverride | AC Pct% | 自动压缩触发阈值百分比 | 否 |\n\n操作方式:`↑/↓` 或 `Tab` 切换字段,`Enter` 在最后一个字段提交保存,`Esc` 返回选项菜单。保存后表单中的值会写入 `~/.saluzi/settings.json` 的 `env` 段(对应 `ANTHROPIC_BASE_URL`/`OPENAI_BASE_URL`/`GEMINI_BASE_URL` 等环境变量),下次启动自动加载。\n\n### 选项 4-5:OAuth 浏览器登录\n\n选择 Saluzi 账户或 Anthropic Console 后进入 OAuth 流程:\n\n1. 终端显示 `Opening browser to sign in…`(带加载图标),自动打开浏览器\n2. 在浏览器完成账户登录与授权\n3. 浏览器返回一串授权码,复制后回到终端\n4. 终端提示 `Paste code here if prompted >`(掩码输入),粘贴授权码并 `Enter`\n5. 终端显示 `Creating API key for Saluzi…`,完成后提示 `Login successful. Press Enter to continue…`\n\n如果浏览器没有自动打开,终端会展示 URL 和复制提示,按 `c` 可复制 URL 手动打开。\n\n### 选项 6:第三方平台\n\n选择 3rd-party platform 后只显示提示信息:Saluzi 支持 Amazon Bedrock、Microsoft Foundry、Vertex AI,需要先设置对应的环境变量再重启 Saluzi。按 `Enter` 返回选项菜单,不在 CLI 内直接配置。企业用户需联系管理员获取配置参数。\n\n### 登录后\n\n登录成功后 Saluzi 会自动刷新策略配额、GrowthBook 特性开关、远程受管设置,并为本机注册 trusted device(用于 Remote Control)。无需额外操作,直接开始对话即可。\n\n## 添加项目目录\n\n进入项目后用 `/add-dir` 挂载工作目录:\n\n```\n> /add-dir\n```\n\nSaluzi 会扫描目录结构,后续对话即可基于代码上下文回答。\n\n## 第一次对话\n\n直接输入需求:\n\n```\n> 帮我看看这个项目的目录结构,有没有潜在问题\n```\n\nSaluzi 会:\n1. 调用 `Read`、`Glob`、`Grep` 工具探索代码\n2. 分析后给出建议\n3. 若需修改,会请求权限后调用 `Edit`、`Write` 工具\n\n每次工具调用前会弹出权限确认(除非已 Allow)。\n\n## 提交代码工作流\n\n完成修改后:\n\n```\n> /diff # 预览改动\n> /commit # 提交(自动生成 commit message)\n> /commit-push-pr # 一条龙:提交 + 推送 + 创建 PR\n```\n\n## 下一步\n\n- [模型选择与切换](./model-selection) — 了解 `/model`、`/effort`、`/mom`\n- [对话基础](./conversation-basics) — 多轮对话与流式输出\n- [上下文管理](./context-tips) — 让 AI 更好理解你的项目\n"
|
|
3104
2899
|
},
|
|
3105
2900
|
"docs/guide/model-selection": {
|
|
3106
2901
|
"frontmatter": {
|
|
3107
2902
|
"title": "模型选择与切换 - Max/Pro/Std 与推理深度",
|
|
3108
|
-
"description": "使用 /model 切换模型,/effort 调节推理深度,/mom
|
|
2903
|
+
"description": "使用 /model 切换模型,/effort 调节推理深度,/mom 配置混合模型。",
|
|
3109
2904
|
"keywords": [
|
|
3110
2905
|
"model",
|
|
3111
2906
|
"effort",
|
|
@@ -3116,7 +2911,7 @@
|
|
|
3116
2911
|
"推理深度"
|
|
3117
2912
|
]
|
|
3118
2913
|
},
|
|
3119
|
-
"content": "\n## 模型选择\n\nSaluzi 支持多个模型,按能力与成本分级:\n\n| 模型 | 能力 | 速度 | 成本 | 适用场景 |\n|------|------|------|------|---------|\n| Max | 最强 | 慢 | 高 | 复杂架构、深度推理 |\n| Pro | 均衡 | 中 | 中 | 日常开发(默认) |\n| Std | 快 | 快 | 低 | 简单任务、快速验证 |\n\n## /model 切换\n\n```\n> /model\n```\n\n打开模型选择面板,可切换当前会话的模型。也可直接指定:\n\n```\n> /model max\n> /model pro\n> /model std\n```\n\n支持模型别名:`best`、`max[1m]`(1M 上下文)、`pro[1m]`、`maxplan` 等。\n\n## /effort 推理深度\n\n`/effort` 调节推理链长度(仅支持推理模型的 extended thinking):\n\n```\n> /effort low # 快速响应\n> /effort medium # 中等(默认)\n> /effort high # 深度推理\n> /effort xhigh # 极深度推理\n> /effort max # 最大推理深度\n> /effort auto # 清除手动设置,使用自动\n```\n\n也可通过环境变量设置:`SALUZI_EFFORT_LEVEL=high slz`\n\n深度推理适合:\n\n- 复杂 bug 分析\n- 架构设计\n- 多步骤规划\n- 代码审查\n\n## /
|
|
2914
|
+
"content": "\n## 模型选择\n\nSaluzi 支持多个模型,按能力与成本分级:\n\n| 模型 | 能力 | 速度 | 成本 | 适用场景 |\n|------|------|------|------|---------|\n| Max | 最强 | 慢 | 高 | 复杂架构、深度推理 |\n| Pro | 均衡 | 中 | 中 | 日常开发(默认) |\n| Std | 快 | 快 | 低 | 简单任务、快速验证 |\n\n## /model 切换\n\n```\n> /model\n```\n\n打开模型选择面板,可切换当前会话的模型。也可直接指定:\n\n```\n> /model max\n> /model pro\n> /model std\n```\n\n支持模型别名:`best`、`max[1m]`(1M 上下文)、`pro[1m]`、`maxplan` 等。\n\n## /effort 推理深度\n\n`/effort` 调节推理链长度(仅支持推理模型的 extended thinking):\n\n```\n> /effort low # 快速响应\n> /effort medium # 中等(默认)\n> /effort high # 深度推理\n> /effort xhigh # 极深度推理\n> /effort max # 最大推理深度\n> /effort auto # 清除手动设置,使用自动\n```\n\n也可通过环境变量设置:`SALUZI_EFFORT_LEVEL=high slz`\n\n深度推理适合:\n\n- 复杂 bug 分析\n- 架构设计\n- 多步骤规划\n- 代码审查\n\n## /mom 混合模型\n\n见 [MOM 混合模型章节](./mom-mixed-models)。MOM 允许多模型协同:主机 + 顾问。\n\n- `/mom` 打开配置面板\n- `/mom \"内容\"` 执行一次性 MOM 回合\n- `/mom-<mode> \"内容\"` 使用特定 MOM 模式(如 `/mom-avg`)\n\n## /poor 节约模式\n\n```\n> /poor\n```\n\n切换节约模式,关闭**记忆提取**(extract_memories)和**提示建议**(prompt_suggestion),减少 token 消耗。\n\n## Provider 选择\n\nSaluzi 自动选择最优 Provider。如需指定:\n- 通过环境变量(如 `ANTHROPIC_API_KEY`)指定\n- 通过 `/keys` 绑定特定 provider 的 Key\n- 通过 `/model` 切换当前会话模型\n\n## 推荐配置\n\n| 场景 | 推荐 |\n|------|------|\n| 日常开发 | Pro + medium effort |\n| 复杂重构 | Max + high effort |\n| 快速原型 | Std + low effort |\n| 关键决策 | MOM(Pro 主机 + Max 顾问) |\n| 节约模式 | `/poor`(关闭记忆提取与提示建议) |\n\n## 成本监控\n\n用 `/cost` 查看当前会话消耗,`/stats` 查看历史统计。\n"
|
|
3120
2915
|
},
|
|
3121
2916
|
"docs/guide/mom-mixed-models": {
|
|
3122
2917
|
"frontmatter": {
|
|
@@ -3187,6 +2982,23 @@
|
|
|
3187
2982
|
},
|
|
3188
2983
|
"content": "\n## 什么是 OMS\n\nOMS(Orchestra Management System)是 Saluzi 的高级任务编排系统。它将复杂任务分解为多个阶段(stage),每个阶段由专属角色的 agent 执行,通过 DAG(有向无环图)调度依赖关系,支持并行执行、质量门禁、失败重试与多轮迭代。\n\n## OMS 命令一览\n\n| 命令 | 用途 | 定位 |\n|------|------|------|\n| `/oms` | 智能路由:根据自然语言自动选择最佳工作流 | 入口 |\n| `/oms-autopilot` | 全自动 6 阶段流水线:需求→规划→实现→QA→验证→报告 | 全链路 |\n| `/oms-ralplan` | 共识规划:Planner→Architect→Critic 三轮审议 | 规划 |\n| `/oms-ralph` | PRD 驱动的持久循环:逐个用户故事实现并验证 | 执行 |\n| `/oms-team` | N 并行 worker:任务分解→并行实现→集成验证 | 并行执行 |\n| `/oms-clarify` | 苏格拉底式深度访谈:通过问答降低需求模糊度 | 需求澄清 |\n| `/oms-autoresearch` | 评估器驱动的迭代改进:实验→评估→决策→迭代 | 研究 |\n| `/oms-ultrawork` | 3 层并行执行:按复杂度路由到 std/pro/max 模型 | 轻量并行 |\n| `/oms-goal` | 多目标工作流:Oracle 门控 + 角色分工执行 | 目标管理 |\n| `/oms-orchestra` | 运行自定义 YAML 工作流 | 自定义 |\n| `/oms-define` | 定义自定义 agent 或工作流(生成 YAML) | 定义工具 |\n\n## Prompt 模式与 Program 模式\n\n多数 OMS 工作流支持两种执行模式:\n\n### Program 模式(默认)\n\nWorkflowEngine 直接执行 DAG——创建 Orchestrator,加载 22 种内置 agent 角色,按拓扑序调度各阶段,管理 worker 并发。无需 LLM 参与调度,速度快、确定性强。\n\n```\n> /oms-autopilot 实现用户登录功能\n```\n\nProgram 模式失败时会自动降级到 Prompt 模式重试。\n\n### Prompt 模式(`--prompt`)\n\nLLM 作为编排层,通过 Agent 工具逐阶段派生子 agent 执行。更灵活(可适应异常情况),但速度较慢。\n\n```\n> /oms-autopilot --prompt 实现用户登录功能\n```\n\n适用于需要 LLM 判断力的场景(如需求模糊、需动态调整执行路径)。\n\n### 仅 Prompt 模式的工作流\n\n以下工作流只支持 Prompt 模式:\n\n| 工作流 | 原因 |\n|--------|------|\n| `/oms-clarify` | 苏格拉底式访谈依赖 AskUserQuestion 多轮对话,Program 模式无法支持 |\n| `/oms-goal` | Oracle 门控 + 多目标状态管理需要 LLM 判断 |\n| `/oms`(路由器) | 纯分类分发,无 DAG 执行 |\n| `/oms-define` | 纯 YAML 生成,无 DAG 执行 |\n\n## 典型用法:组合使用 /oms-define 与 /oms-orchestra\n\n除了内置工作流,OMS 支持定义和运行**自定义工作流**。\n\n### 第一步:定义自定义 agent 或工作流\n\n`/oms-define` 根据自然语言描述生成 YAML 定义文件:\n\n```\n> /oms-define 我需要一个安全审计 agent,只读代码,用 max 模型\n```\n\nSaluzi 会在 `.orchestra/agents/` 下生成 YAML:\n\n```yaml\nname: security-auditor\nrole: reviewer\ndescription: \"Security-focused code review.\"\nmodel: max\ntools: [Read, Glob, Grep]\ndisallowed_tools: [Write, Edit, Bash]\n```\n\n定义自定义工作流:\n\n```\n> /oms-define 创建一个代码审查工作流,先探索、再审查、再验证\n```\n\n生成 `.orchestra/workflows/code-review.yaml`:\n\n```yaml\nname: code-review\ndescription: \"Multi-stage code review\"\nstages:\n explore:\n agent: explorer\n workers: 3\n review:\n agent: reviewer\n depends_on: [explore]\n verify:\n agent: verifier\n depends_on: [review]\n gate: true\n on_failure: retry\n max_retries: 2\n```\n\n### 第二步:运行自定义工作流\n\n```\n> /oms-orchestra code-review \"检查最近提交的认证模块改动\"\n```\n\n`/oms-orchestra` 加载 `.orchestra/workflows/` 下的 YAML 定义,构建 DAG 并按拓扑序执行各阶段。\n\n## 各工作流 DAG 详解\n\n每个内置工作流都是一个 DAG(有向无环图)。阶段之间通过 `depends_on` 声明依赖,引擎按拓扑序调度,无依赖的阶段可并行执行。\n\n### /oms-autopilot — 全自动 6 阶段流水线\n\n```\nexpansion → planning → execution → qa → ┬─ validation-functional ─┐\n ├─ validation-security ──┼→ cleanup\n └─ validation-quality ───┘\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| expansion | Analyst | 将想法转为技术规格(需求、架构、风险) |\n| planning | Planner | 创建实现计划(任务分解、并行策略、测试方案) |\n| execution | Executor | 按计划并行实现(自动/标准/高复杂度三级路由) |\n| qa | Verifier [gate] | build + lint + test 循环,最多重试 5 次 |\n| validation-* | 3 个并行 reviewer [gate] | 功能验证、安全审查、代码质量审查 |\n| cleanup | Writer | 生成最终报告 |\n\n特点:如果已存在 ralplan 计划(`.oms/plans/ralplan-*.md`),自动跳过 expansion 和 planning,直接从 execution 开始。\n\n### /oms-ralplan — 共识规划\n\n```\nplan → architect_review → critic_review → revision\n ↑ ↓ (ITERATE)\n └── 重新执行整个 DAG ──┘ (最多 5 轮)\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| plan | Planner | RALPLAN-DR 结构化审议(原则→驱动因素→选项→推荐) |\n| architect_review | Architect | 反方论证、权衡分析、风险评级 |\n| critic_review | Critic [gate] | 9 维度评分,输出 APPROVE / ITERATE / REJECT |\n| revision | Planner | 逐条回应 Critic 问题,更新计划 |\n\n特点:Critic 输出 ITERATE 时,引擎重新执行整个 DAG(最多 5 轮)。APPROVE 后提示选择执行路径(team 或 ralph)。支持 `--interactive` 模式在关键节点暂停确认。\n\n### /oms-ralph — PRD 驱动的持久循环\n\n```\nanalyze → implement [loop ≤50] → verify [gate] → review [gate, retry ≤10] → deslop → regression_verify [gate, retry ≤3] → debug_fix [retry ≤3]\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| analyze | Analyst | 生成 PRD(用户故事 + 验收标准) |\n| implement | Executor | 逐个实现用户故事,循环直到所有故事通过 |\n| verify | Verifier [gate] | 全量重新验证所有故事 |\n| review | CodeSimplifier [gate] | 代码审查,最多重试 10 次 |\n| deslop | CodeSimplifier | 去除不必要的复杂度 |\n| regression_verify | Verifier [gate] | deslop 后回归测试 |\n| debug_fix | Debugger | 诊断修复剩余问题 |\n\n### /oms-team — N 并行 worker\n\n```\nplan → prd → exec (N workers) → verify [gate] → fix [retry ≤3]\n ↑ ↓\n └──────────────┘ (loop until PASS)\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| plan | Planner | 将任务分解为 N 个独立子任务 |\n| prd | Analyst | 为每个子任务定义验收标准(任务 >5 个子任务时) |\n| exec | Executor | N 个 worker 并行实现(N>20 自动启用 Ant-Colony 模式) |\n| verify | Verifier [gate] | 验证所有子任务 + 集成检查 |\n| fix | Debugger | 诊断修复失败项,最多 3 轮 |\n\n### /oms-clarify — 苏格拉底式深度访谈(交互式)\n\n```\nexplore → interview [loop ≤20] → ┬─ challenge-contrarian (模糊度>0.4) ─┐\n ├─ challenge-simplifier (模糊度>0.3) ─┼→ crystallize → bridge\n └─ challenge-ontologist (模糊度>0.5) ─┘\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| explore | Explorer | 检测项目类型(brownfield/greenfield),映射代码区域 |\n| interview | Analyst | 逐轮提问,每轮计算模糊度评分(目标/约束/标准/上下文) |\n| challenge-* | 3 个条件 agent | 反方论证、简化探测、本体论重构(按模糊度阈值激活) |\n| crystallize | Writer | 综合所有分析,生成规格文档 |\n| bridge | Planner | 推荐执行模式并跳转 |\n\n特点:模糊度降至 ≤20% 自动进入下一阶段。支持 `--quick`(阈值 30%,5 轮)和 `--deep`(阈值 10%,30 轮)。\n\n### /oms-autoresearch — 评估器驱动的迭代改进\n\n```\nconfirm-mission → initialize-run → experiment → evaluate [gate] → decide → iterate [loop ≤50] → finalize\n ↑ ↓ (CONTINUE/PIVOT)\n └──────────┘\n```\n\n特点:通过外部评估器(如测试套件、benchmark)量化每轮改进,决策引擎输出 CONTINUE / PIVOT / COMPLETE / ABORT。\n\n### /oms-ultrawork — 3 层并行执行\n\n```\nground → classify → ┬─ execute-simple (LOW, std 模型) ─┐\n ├─ execute-standard (MED, pro 模型) ─┼→ verify [gate] → report\n └─ execute-complex (HIGH, max 模型) ─┘\n```\n\n特点:按复杂度将子任务路由到不同模型层级,独立任务并行执行。\n\n### /oms-goal — 多目标工作流\n\nOracle 门控 + 结构化 intake + 角色分工执行(Scout/Worker/Judge),通过文件系统持久化状态(`.oms/ultragoal/`),支持中断恢复。\n\n## 3 阶段流水线:ralplan → autopilot\n\n工作流之间可以串联。典型的全链路开发流程:\n\n```\n1. /oms-ralplan \"实现用户认证模块\" → 生成共识计划\n2. Critic APPROVE 后选择执行路径 → team 或 ralph\n3. 执行完毕 → 验证通过 → 完成\n```\n\n`/oms-autopilot` 检测到已有的 ralplan 计划时,自动跳过 expansion + planning,直接从 execution 阶段开始。\n\n## 与普通对话的区别\n\n| 普通对话 | OMS 工作流 |\n|---------|-----------|\n| 单轮 request-response | 多阶段 DAG 调度 |\n| AI 自主决策 | 角色化分工 + 质量门禁 |\n| 适合小任务 | 适合复杂任务(5+ 文件) |\n| 上下文单一 | 多 agent 并行上下文 |\n\n## 何时用 OMS\n\n- 任务涉及 5+ 文件改动\n- 需要架构设计 + 实现 + 测试多阶段\n- 需要多个专业角色(如安全审查 + 性能优化)\n- 需求不明确,需要深度澄清(clarify)\n- 需要多 worker 并行执行(team)\n- 希望自动化长链任务\n"
|
|
3189
2984
|
},
|
|
2985
|
+
"docs/guide/troubleshooting": {
|
|
2986
|
+
"frontmatter": {
|
|
2987
|
+
"title": "排障 - 诊断安装与调整权限",
|
|
2988
|
+
"description": "使用 /doctor 诊断安装、/help 查命令、/permissions 调整权限、/plan 规划模式。",
|
|
2989
|
+
"keywords": [
|
|
2990
|
+
"doctor",
|
|
2991
|
+
"help",
|
|
2992
|
+
"permissions",
|
|
2993
|
+
"plan",
|
|
2994
|
+
"排障",
|
|
2995
|
+
"诊断",
|
|
2996
|
+
"权限",
|
|
2997
|
+
"规划模式"
|
|
2998
|
+
]
|
|
2999
|
+
},
|
|
3000
|
+
"content": "\n## 诊断安装\n\n遇到启动异常或功能不符预期时,先运行 `/doctor` 做全面体检:\n\n```\n> /doctor\n```\n\n该命令会依次检查:\n\n- CLI 版本是否为最新\n- Node / Bun 运行环境是否满足\n- 配置文件是否完整\n- 网络连接是否正常\n\n若有异常项,输出会给出具体的修复建议。\n\n## 查命令\n\n不确定某个命令的用法时,用 `/help` 列出所有可用命令:\n\n```\n> /help\n```\n\n查看单个命令的详细用法:\n\n```\n> /help commit\n```\n\n输出包含命令说明、参数列表和使用示例。\n\n## 调整权限\n\nSaluzi 每次调用工具前会请求权限。用 `/permissions` 查看和调整当前权限规则:\n\n```\n> /permissions\n```\n\n权限分三种策略:\n\n| 策略 | 含义 |\n|------|------|\n| Allow | 自动放行,不再询问 |\n| Deny | 直接拒绝,禁止调用 |\n| Ask | 每次弹出确认(默认) |\n\n对常用工具设置 Allow 可以减少交互打断,提升效率。\n\n## 规划模式\n\n面对复杂任务时,用 `/plan` 让 Saluzi 先制定计划再执行:\n\n```\n> /plan 重构用户模块,拆分为独立的 service 层\n```\n\n进入规划模式后,Saluzi 会:\n1. 分析需求并拆解步骤\n2. 列出待执行的操作清单\n3. 确认后再逐步实施\n\n适合在动手前理清思路,避免盲目修改。\n\n## 常见问题\n\n| 问题 | 可能原因 | 解决方法 |\n|------|---------|---------|\n| 登录失败 | Token 过期或网络异常 | 重新运行 `/login`,或检查代理设置 |\n| 工具权限被拒 | 对应工具被设为 Deny | 运行 `/permissions` 将策略改为 Allow |\n| 命令找不到 | 输入拼写有误 | 运行 `/help` 确认命令名称 |\n| 模型不可用 | 账户额度耗尽或区域限制 | 用 `/model` 切换到其他可用模型 |\n\n## 下一步\n\n- [查看与提交代码](./commit-workflow) — diff、commit 与 PR 工作流\n- [费用与用量](./cost-usage) — 了解 Token 消耗与费用控制\n- [代码图谱](./codegraph) — 用 CodeGraph 深入理解项目结构\n"
|
|
3001
|
+
},
|
|
3190
3002
|
"docs/guide/weixin-login": {
|
|
3191
3003
|
"frontmatter": {
|
|
3192
3004
|
"title": "微信控制 - 通过微信远程操控 Saluzi",
|