@saluzi/saluzi-edu 0.2.63 → 0.2.65
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/dist/cli.js +176 -176
- package/dist/guide/assets/main-Bx1xb7yl.css +1 -0
- package/dist/guide/assets/main-CdOE18lg.js +277 -0
- package/dist/guide/guide-data.json +27 -5
- package/dist/guide/index.html +2 -2
- package/dist/rcs-schema.sql +2 -1
- package/package.json +1 -1
- package/packages/remote-control-server/src/__tests__/attach-code.test.ts +195 -0
- package/packages/remote-control-server/src/__tests__/attach-wait.test.ts +270 -0
- package/packages/remote-control-server/src/__tests__/attach.test.ts +580 -0
- package/packages/remote-control-server/src/auth/bridge-auth.ts +120 -0
- package/packages/remote-control-server/src/db/rcs-schema.sql +2 -1
- package/packages/remote-control-server/src/db/sqlite.ts +1 -0
- package/packages/remote-control-server/src/routes/v1/environments.ts +97 -73
- package/packages/remote-control-server/src/routes/v1/sessions.ts +592 -4
- package/packages/remote-control-server/src/routes/web/sessions.ts +67 -0
- package/packages/remote-control-server/src/services/environment.ts +27 -0
- package/packages/remote-control-server/src/store.ts +123 -2
- package/packages/remote-control-server/src/types/api.ts +2 -0
- package/dist/guide/assets/main-CSpz9pKf.css +0 -1
- package/dist/guide/assets/main-C_ykjDzn.js +0 -167
|
@@ -0,0 +1 @@
|
|
|
1
|
+
@import "https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap";@layer components;@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-space-y-reverse:0;--tw-space-x-reverse:0;--tw-divide-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-backdrop-blur:initial;--tw-backdrop-brightness:initial;--tw-backdrop-contrast:initial;--tw-backdrop-grayscale:initial;--tw-backdrop-hue-rotate:initial;--tw-backdrop-invert:initial;--tw-backdrop-opacity:initial;--tw-backdrop-saturate:initial;--tw-backdrop-sepia:initial;--tw-duration:initial;--tw-ease:initial;--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0;--tw-content:""}}}@layer theme{:root,:host{--font-sans:"Poppins", system-ui, -apple-system, sans-serif;--font-serif:Georgia, "Times New Roman", serif;--font-mono:"JetBrains Mono", monospace;--color-red-50:oklch(97.1% .013 17.38);--color-red-100:oklch(93.6% .032 17.717);--color-red-200:oklch(88.5% .062 18.334);--color-red-600:oklch(57.7% .245 27.325);--color-red-700:oklch(50.5% .213 27.518);--color-red-800:oklch(44.4% .177 26.899);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-md:28rem;--container-2xl:42rem;--container-3xl:48rem;--container-4xl:56rem;--container-5xl:64rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height:calc(1.5 / 1);--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75 / 1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2 / 1.5);--text-3xl:1.875rem;--text-3xl--line-height:calc(2.25 / 1.875);--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5 / 2.25);--text-5xl:3rem;--text-5xl--line-height:1;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--tracking-tight:-.025em;--tracking-wider:.05em;--leading-tight:1.25;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--radius-xl:.75rem;--ease-out:cubic-bezier(0, 0, .2, 1);--animate-spin:spin 1s linear infinite;--blur-sm:8px;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--radius:.625rem;--font-display:"Poppins", sans-serif;--color-surface-3:#d4bfae;--color-text-primary:#372e37;--color-text-secondary:#737373;--color-background:#f0e0d3;--color-foreground:#372e37;--color-card:#e6d2c2;--color-primary:#7d5a8a;--color-primary-foreground:#f0e0d3;--color-secondary:#e6d2c2;--color-secondary-foreground:#372e37;--color-muted:#e6d2c2;--color-muted-foreground:#737373;--color-accent:#7d5a8a;--color-accent-foreground:#f0e0d3;--color-destructive:#4b1535;--color-border:#7d5a8a;--color-border-light:#e6d2c2;--color-ring:#7d5a8a}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}html,body{background:var(--color-background);color:var(--color-text-primary);font-family:var(--font-sans);-webkit-font-smoothing:antialiased}*,:before,:after{border-color:var(--color-border)}}@layer utilities{.pointer-events-none{pointer-events:none}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{inset:calc(var(--spacing) * 0)}.top-4{top:calc(var(--spacing) * 4)}.top-full{top:100%}.right-0{right:calc(var(--spacing) * 0)}.right-2{right:calc(var(--spacing) * 2)}.right-4{right:calc(var(--spacing) * 4)}.bottom-2{bottom:calc(var(--spacing) * 2)}.bottom-4{bottom:calc(var(--spacing) * 4)}.left-2{left:calc(var(--spacing) * 2)}.left-4{left:calc(var(--spacing) * 4)}.z-10{z-index:10}.z-50{z-index:50}.container{width:100%}@media (width>=40rem){.container{max-width:40rem}}@media (width>=48rem){.container{max-width:48rem}}@media (width>=64rem){.container{max-width:64rem}}@media (width>=80rem){.container{max-width:80rem}}@media (width>=96rem){.container{max-width:96rem}}.mx-1{margin-inline:calc(var(--spacing) * 1)}.mx-auto{margin-inline:auto}.my-1{margin-block:calc(var(--spacing) * 1)}.my-2{margin-block:calc(var(--spacing) * 2)}.my-4{margin-block:calc(var(--spacing) * 4)}.my-6{margin-block:calc(var(--spacing) * 6)}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:calc(var(--spacing) * 1)}.mt-1\.5{margin-top:calc(var(--spacing) * 1.5)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-3{margin-top:calc(var(--spacing) * 3)}.mt-4{margin-top:calc(var(--spacing) * 4)}.mt-5{margin-top:calc(var(--spacing) * 5)}.mt-6{margin-top:calc(var(--spacing) * 6)}.mb-1{margin-bottom:calc(var(--spacing) * 1)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.mb-3{margin-bottom:calc(var(--spacing) * 3)}.mb-6{margin-bottom:calc(var(--spacing) * 6)}.mb-8{margin-bottom:calc(var(--spacing) * 8)}.mb-10{margin-bottom:calc(var(--spacing) * 10)}.mb-12{margin-bottom:calc(var(--spacing) * 12)}.mb-14{margin-bottom:calc(var(--spacing) * 14)}.mb-16{margin-bottom:calc(var(--spacing) * 16)}.mb-20{margin-bottom:calc(var(--spacing) * 20)}.ml-1{margin-left:calc(var(--spacing) * 1)}.ml-2{margin-left:calc(var(--spacing) * 2)}.ml-3{margin-left:calc(var(--spacing) * 3)}.ml-auto{margin-left:auto}.block{display:block}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.list-item{display:list-item}.table{display:table}.table-cell{display:table-cell}.table-row{display:table-row}.size-4{width:calc(var(--spacing) * 4);height:calc(var(--spacing) * 4)}.size-full{width:100%;height:100%}.h-2\.5{height:calc(var(--spacing) * 2.5)}.h-3{height:calc(var(--spacing) * 3)}.h-4{height:calc(var(--spacing) * 4)}.h-7{height:calc(var(--spacing) * 7)}.h-8{height:calc(var(--spacing) * 8)}.h-16{height:calc(var(--spacing) * 16)}.h-\[46px\]{height:46px}.h-\[calc\(100vh-2rem\)\]{height:calc(100vh - 2rem)}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.min-h-28{min-height:calc(var(--spacing) * 28)}.min-h-\[200px\]{min-height:200px}.w-1\.5{width:calc(var(--spacing) * 1.5)}.w-2\.5{width:calc(var(--spacing) * 2.5)}.w-3{width:calc(var(--spacing) * 3)}.w-4{width:calc(var(--spacing) * 4)}.w-7{width:calc(var(--spacing) * 7)}.w-8{width:calc(var(--spacing) * 8)}.w-56{width:calc(var(--spacing) * 56)}.w-64{width:calc(var(--spacing) * 64)}.w-full{width:100%}.w-screen{width:100vw}.max-w-2xl{max-width:var(--container-2xl)}.max-w-3xl{max-width:var(--container-3xl)}.max-w-4xl{max-width:var(--container-4xl)}.max-w-5xl{max-width:var(--container-5xl)}.max-w-full{max-width:100%}.max-w-md{max-width:var(--container-md)}.max-w-none{max-width:none}.min-w-0{min-width:calc(var(--spacing) * 0)}.min-w-\[120px\]{min-width:120px}.flex-1{flex:1}.flex-shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.border-collapse{border-collapse:collapse}.origin-center{transform-origin:50%}.rotate-\[0\.3deg\]{rotate:.3deg}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.animate-spin{animation:var(--animate-spin)}.cursor-default{cursor:default}.cursor-pointer{cursor:pointer}.list-inside{list-style-position:inside}.list-decimal{list-style-type:decimal}.list-disc{list-style-type:disc}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-baseline{align-items:baseline}.items-center{align-items:center}.items-stretch{align-items:stretch}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:calc(var(--spacing) * 1)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-5{gap:calc(var(--spacing) * 5)}.gap-10{gap:calc(var(--spacing) * 10)}:where(.space-y-1>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 1) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 1) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-1\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 1.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 1.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-3>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 3) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 3) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 4) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 4) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-x-2>:not(:last-child)){--tw-space-x-reverse:0;margin-inline-start:calc(calc(var(--spacing) * 2) * var(--tw-space-x-reverse));margin-inline-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-x-reverse)))}:where(.divide-y>:not(:last-child)){--tw-divide-y-reverse:0;border-bottom-style:var(--tw-border-style);border-top-style:var(--tw-border-style);border-top-width:calc(1px * var(--tw-divide-y-reverse));border-bottom-width:calc(1px * calc(1 - var(--tw-divide-y-reverse)))}:where(.divide-border>:not(:last-child)){border-color:var(--color-border)}.self-start{align-self:flex-start}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:var(--radius)}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-xl{border-radius:var(--radius-xl)}.border{border-style:var(--tw-border-style);border-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-b-2{border-bottom-style:var(--tw-border-style);border-bottom-width:2px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-l-2{border-left-style:var(--tw-border-style);border-left-width:2px}.border-l-4{border-left-style:var(--tw-border-style);border-left-width:4px}.border-border{border-color:var(--color-border)}.border-border-light{border-color:var(--color-border-light)}.border-current{border-color:currentColor}.border-destructive{border-color:var(--color-destructive)}.border-muted-foreground\/30{border-color:#7373734d}@supports (color:color-mix(in lab, red, red)){.border-muted-foreground\/30{border-color:color-mix(in oklab, var(--color-muted-foreground) 30%, transparent)}}.border-primary{border-color:var(--color-primary)}.border-red-200{border-color:var(--color-red-200)}.border-transparent{border-color:#0000}.border-white\/10{border-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.border-white\/10{border-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.bg-\[\#0b0e14\]{background-color:#0b0e14}.bg-\[\#27c93f\]{background-color:#27c93f}.bg-\[\#ff5f56\]{background-color:#ff5f56}.bg-\[\#ffbd2e\]{background-color:#ffbd2e}.bg-accent{background-color:var(--color-accent)}.bg-background{background-color:var(--color-background)}.bg-background\/80{background-color:#f0e0d3cc}@supports (color:color-mix(in lab, red, red)){.bg-background\/80{background-color:color-mix(in oklab, var(--color-background) 80%, transparent)}}.bg-background\/90{background-color:#f0e0d3e6}@supports (color:color-mix(in lab, red, red)){.bg-background\/90{background-color:color-mix(in oklab, var(--color-background) 90%, transparent)}}.bg-background\/95{background-color:#f0e0d3f2}@supports (color:color-mix(in lab, red, red)){.bg-background\/95{background-color:color-mix(in oklab, var(--color-background) 95%, transparent)}}.bg-black\/10{background-color:#0000001a}@supports (color:color-mix(in lab, red, red)){.bg-black\/10{background-color:color-mix(in oklab, var(--color-black) 10%, transparent)}}.bg-card{background-color:var(--color-card)}.bg-destructive{background-color:var(--color-destructive)}.bg-muted{background-color:var(--color-muted)}.bg-muted\/40{background-color:#e6d2c266}@supports (color:color-mix(in lab, red, red)){.bg-muted\/40{background-color:color-mix(in oklab, var(--color-muted) 40%, transparent)}}.bg-muted\/80{background-color:#e6d2c2cc}@supports (color:color-mix(in lab, red, red)){.bg-muted\/80{background-color:color-mix(in oklab, var(--color-muted) 80%, transparent)}}.bg-primary{background-color:var(--color-primary)}.bg-primary\/10{background-color:#7d5a8a1a}@supports (color:color-mix(in lab, red, red)){.bg-primary\/10{background-color:color-mix(in oklab, var(--color-primary) 10%, transparent)}}.bg-red-50{background-color:var(--color-red-50)}.bg-red-100{background-color:var(--color-red-100)}.bg-secondary{background-color:var(--color-secondary)}.bg-surface-3{background-color:var(--color-surface-3)}.bg-white\/5{background-color:#ffffff0d}@supports (color:color-mix(in lab, red, red)){.bg-white\/5{background-color:color-mix(in oklab, var(--color-white) 5%, transparent)}}.p-1{padding:calc(var(--spacing) * 1)}.p-1\.5{padding:calc(var(--spacing) * 1.5)}.p-2{padding:calc(var(--spacing) * 2)}.p-3{padding:calc(var(--spacing) * 3)}.p-4{padding:calc(var(--spacing) * 4)}.p-5{padding:calc(var(--spacing) * 5)}.p-8{padding:calc(var(--spacing) * 8)}.px-1\.5{padding-inline:calc(var(--spacing) * 1.5)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-6{padding-inline:calc(var(--spacing) * 6)}.px-8{padding-inline:calc(var(--spacing) * 8)}.px-10{padding-inline:calc(var(--spacing) * 10)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:calc(var(--spacing) * 1)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-8{padding-block:calc(var(--spacing) * 8)}.py-12{padding-block:calc(var(--spacing) * 12)}.py-16{padding-block:calc(var(--spacing) * 16)}.pb-3{padding-bottom:calc(var(--spacing) * 3)}.pb-8{padding-bottom:calc(var(--spacing) * 8)}.pl-2{padding-left:calc(var(--spacing) * 2)}.pl-3{padding-left:calc(var(--spacing) * 3)}.pl-4{padding-left:calc(var(--spacing) * 4)}.text-center{text-align:center}.text-left{text-align:left}.font-display{font-family:var(--font-display)}.font-mono{font-family:var(--font-mono)}.font-serif{font-family:var(--font-serif)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[10px\]{font-size:10px}.text-\[11px\]{font-size:11px}.text-\[13px\]{font-size:13px}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.leading-tight{--tw-leading:var(--leading-tight);line-height:var(--leading-tight)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-\[0\.2em\]{--tw-tracking:.2em;letter-spacing:.2em}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.wrap-anywhere{overflow-wrap:anywhere}.whitespace-normal{white-space:normal}.whitespace-nowrap{white-space:nowrap}.text-\[\#7dd3fc\]{color:#7dd3fc}.text-\[\#27c93f\]{color:#27c93f}.text-\[\#ffbd2e\]{color:#ffbd2e}.text-accent-foreground{color:var(--color-accent-foreground)}.text-destructive{color:var(--color-destructive)}.text-foreground{color:var(--color-foreground)}.text-muted-foreground{color:var(--color-muted-foreground)}.text-primary{color:var(--color-primary)}.text-primary-foreground{color:var(--color-primary-foreground)}.text-primary\/80{color:#7d5a8acc}@supports (color:color-mix(in lab, red, red)){.text-primary\/80{color:color-mix(in oklab, var(--color-primary) 80%, transparent)}}.text-red-600{color:var(--color-red-600)}.text-red-700{color:var(--color-red-700)}.text-red-800{color:var(--color-red-800)}.text-secondary-foreground{color:var(--color-secondary-foreground)}.lowercase{text-transform:lowercase}.uppercase{text-transform:uppercase}.italic{font-style:italic}.underline{text-decoration-line:underline}.opacity-0{opacity:0}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a), 0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a), 0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.backdrop-blur-sm{--tw-backdrop-blur:blur(var(--blur-sm));-webkit-backdrop-filter:var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,);backdrop-filter:var(--tw-backdrop-blur,) var(--tw-backdrop-brightness,) var(--tw-backdrop-contrast,) var(--tw-backdrop-grayscale,) var(--tw-backdrop-hue-rotate,) var(--tw-backdrop-invert,) var(--tw-backdrop-opacity,) var(--tw-backdrop-saturate,) var(--tw-backdrop-sepia,)}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-shadow{transition-property:box-shadow;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-transform{transition-property:transform,translate,scale,rotate;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-150{--tw-duration:.15s;transition-duration:.15s}.duration-200{--tw-duration:.2s;transition-duration:.2s}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}.\[counter-increment\:line_0\]{counter-increment:line 0}.\[counter-reset\:line\]{counter-reset:line}@media (hover:hover){.group-hover\:block:is(:where(.group):hover *){display:block}.group-hover\:translate-x-0\.5:is(:where(.group):hover *){--tw-translate-x:calc(var(--spacing) * .5);translate:var(--tw-translate-x) var(--tw-translate-y)}.group-hover\:translate-x-1:is(:where(.group):hover *){--tw-translate-x:calc(var(--spacing) * 1);translate:var(--tw-translate-x) var(--tw-translate-y)}.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}}.before\:mr-4:before{content:var(--tw-content);margin-right:calc(var(--spacing) * 4)}.before\:inline-block:before{content:var(--tw-content);display:inline-block}.before\:w-4:before{content:var(--tw-content);width:calc(var(--spacing) * 4)}.before\:w-6:before{content:var(--tw-content);width:calc(var(--spacing) * 6)}.before\:text-right:before{content:var(--tw-content);text-align:right}.before\:font-mono:before{content:var(--tw-content);font-family:var(--font-mono)}.before\:text-\[13px\]:before{content:var(--tw-content);font-size:13px}.before\:text-muted-foreground\/50:before{content:var(--tw-content);color:#73737380}@supports (color:color-mix(in lab, red, red)){.before\:text-muted-foreground\/50:before{color:color-mix(in oklab, var(--color-muted-foreground) 50%, transparent)}}.before\:content-\[counter\(line\)\]:before{--tw-content:counter(line);content:var(--tw-content)}.before\:select-none:before{content:var(--tw-content);-webkit-user-select:none;user-select:none}.before\:\[counter-increment\:line\]:before{content:var(--tw-content);counter-increment:line}:is(.\*\:first\:mt-0>*):first-child{margin-top:calc(var(--spacing) * 0)}:is(.\*\:last\:mb-0>*):last-child{margin-bottom:calc(var(--spacing) * 0)}:is(.\*\:last\:after\:inline>*):last-child:after{content:var(--tw-content);display:inline}:is(.\*\:last\:after\:align-baseline>*):last-child:after{content:var(--tw-content);vertical-align:baseline}:is(.\*\:last\:after\:content-\(--streamdown-caret\)>*):last-child:after{--tw-content:var(--streamdown-caret);content:var(--tw-content)}@media (hover:hover){.hover\:bg-background:hover{background-color:var(--color-background)}.hover\:bg-muted:hover{background-color:var(--color-muted)}.hover\:bg-muted\/40:hover{background-color:#e6d2c266}@supports (color:color-mix(in lab, red, red)){.hover\:bg-muted\/40:hover{background-color:color-mix(in oklab, var(--color-muted) 40%, transparent)}}.hover\:bg-white\/5:hover{background-color:#ffffff0d}@supports (color:color-mix(in lab, red, red)){.hover\:bg-white\/5:hover{background-color:color-mix(in oklab, var(--color-white) 5%, transparent)}}.hover\:text-foreground:hover{color:var(--color-foreground)}.hover\:opacity-80:hover{opacity:.8}.hover\:shadow-md:hover{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a), 0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}.focus-visible\:ring-2:focus-visible{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color,var(--color-ring));box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.focus-visible\:ring-primary:focus-visible{--tw-ring-color:var(--color-primary)}.disabled\:cursor-not-allowed:disabled{cursor:not-allowed}.disabled\:opacity-50:disabled{opacity:.5}@media (width>=40rem){.sm\:px-4{padding-inline:calc(var(--spacing) * 4)}.sm\:px-10{padding-inline:calc(var(--spacing) * 10)}.sm\:px-14{padding-inline:calc(var(--spacing) * 14)}.sm\:px-16{padding-inline:calc(var(--spacing) * 16)}.sm\:py-16{padding-block:calc(var(--spacing) * 16)}.sm\:py-20{padding-block:calc(var(--spacing) * 20)}}@media (width>=48rem){.md\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (width>=64rem){.lg\:block{display:block}}@media (prefers-color-scheme:dark){.dark\:bg-\(--shiki-dark-bg\)\!{background-color:var(--shiki-dark-bg)!important}.dark\:text-\(--shiki-dark\)\!{color:var(--shiki-dark)!important}}.\[\&_svg\]\:h-auto svg{height:auto}.\[\&_svg\]\:w-auto svg{width:auto}.\[\&\>div\]\:h-full>div{height:100%}.\[\&\>div\]\:overflow-hidden>div{overflow:hidden}.\[\&\>p\]\:inline>p{display:inline}li .\[li_\&\]\:pl-6{padding-left:calc(var(--spacing) * 6)}}.dark{--color-surface-0:#1a1917;--color-surface-1:#222120;--color-surface-2:#2c2a28;--color-surface-3:#3a3835;--color-text-primary:#efeee9;--color-text-secondary:#969088;--color-text-muted:#5e5a54;--color-bg-inverted:#f6f5f2;--color-text-inverted:#2c2a28;--color-border:#3a3835;--color-border-light:#2c2a28;--color-background:#1a1917;--color-foreground:#efeee9;--color-card:#222120;--color-card-foreground:#efeee9;--color-popover:#1a1917;--color-popover-foreground:#efeee9;--color-primary:#7d5a8a;--color-primary-foreground:#efeee9;--color-secondary:#2c2a28;--color-secondary-foreground:#efeee9;--color-muted:#2c2a28;--color-muted-foreground:#969088;--color-accent:#7d5a8a;--color-accent-foreground:#efeee9;--color-destructive:#4b1535;--color-input:#3a3835;--color-ring:#7d5a8a}::-webkit-scrollbar{width:6px;height:6px}::-webkit-scrollbar-track{background:0 0}::-webkit-scrollbar-thumb{background:var(--color-surface-3);border-radius:3px}.chapter-content{font-family:var(--font-sans);color:var(--color-text-primary);font-size:1.0625rem;line-height:1.75}.chapter-content p,.chapter-content ul,.chapter-content ol,.chapter-content blockquote,.chapter-content pre,.chapter-content table,.chapter-content hr,.chapter-content img{margin-top:1.25rem;margin-bottom:1.25rem}.chapter-content>:first-child,.chapter-content>div>:first-child{margin-top:0}.chapter-content>:last-child,.chapter-content>div>:last-child{margin-bottom:0}.chapter-content h1,.chapter-content h2,.chapter-content h3,.chapter-content h4,.chapter-content h5,.chapter-content h6{font-family:var(--font-display);letter-spacing:-.015em;color:var(--color-text-primary);margin-top:2.5rem;margin-bottom:1rem;font-weight:600;line-height:1.3}.chapter-content h1{margin-top:0;font-size:1.875rem}.chapter-content h2{border-bottom:1px solid var(--color-border-light);padding-bottom:.5rem;font-size:1.5rem}.chapter-content h3{font-size:1.25rem}.chapter-content h4{font-size:1.125rem}.chapter-content p{line-height:1.75}.chapter-content a{color:var(--color-primary);border-bottom:1px solid #0000;text-decoration:none;transition:border-color .2s}.chapter-content a:hover{border-bottom-color:var(--color-primary)}.chapter-content strong{color:var(--color-text-primary);font-weight:600}.chapter-content em{font-style:italic}.chapter-content ul,.chapter-content ol{padding-left:1.5rem}.chapter-content ul{list-style:outside}.chapter-content ol{list-style:decimal}.chapter-content li{margin-top:.5rem;margin-bottom:.5rem;line-height:1.7}.chapter-content li::marker{color:var(--color-primary)}.chapter-content blockquote{border-left:3px solid var(--color-primary);color:var(--color-text-secondary);padding:.5rem 0 .5rem 1.25rem;font-style:italic}.chapter-content code{font-family:var(--font-mono);background:var(--color-muted);color:var(--color-primary);border-radius:.375rem;padding:.125rem .375rem;font-size:.875em;font-weight:500}.chapter-content pre{background:var(--color-card);border:1px solid var(--color-border-light);border-radius:.75rem;padding:1.25rem 1.5rem;font-size:.875rem;line-height:1.6;overflow-x:auto}.chapter-content pre code{color:inherit;font-weight:inherit;background:0 0;border-radius:0;padding:0}.chapter-content pre code>span:last-child:empty{display:none}.chapter-content table{border-collapse:collapse;width:100%;font-size:.9375rem}.chapter-content th{text-align:left;font-family:var(--font-display);color:var(--color-text-primary);border-bottom:2px solid var(--color-primary);background:var(--color-muted);padding:.75rem 1rem;font-weight:600}.chapter-content td{border-bottom:1px solid var(--color-border-light);color:var(--color-text-primary);vertical-align:top;padding:.75rem 1rem}.chapter-content tr:hover td{background:var(--color-muted)}.chapter-content hr{border:none;border-top:1px solid var(--color-border-light)}.chapter-content img{border-radius:.625rem;max-width:100%;height:auto}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-space-x-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-divide-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-backdrop-blur{syntax:"*";inherits:false}@property --tw-backdrop-brightness{syntax:"*";inherits:false}@property --tw-backdrop-contrast{syntax:"*";inherits:false}@property --tw-backdrop-grayscale{syntax:"*";inherits:false}@property --tw-backdrop-hue-rotate{syntax:"*";inherits:false}@property --tw-backdrop-invert{syntax:"*";inherits:false}@property --tw-backdrop-opacity{syntax:"*";inherits:false}@property --tw-backdrop-saturate{syntax:"*";inherits:false}@property --tw-backdrop-sepia{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}@property --tw-content{syntax:"*";inherits:false;initial-value:""}@keyframes spin{to{transform:rotate(360deg)}}
|
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/streamdown-nMT_aKRc.js","assets/rolldown-runtime-S-ySWqyJ.js","assets/shiki-CMaUdEs0.js"])))=>i.map(i=>d[i]);
|
|
2
|
+
import{c as e,l as t,o as n,s as r}from"./streamdown-nMT_aKRc.js";import{t as i}from"./vendor-BU1MXatO.js";import{Ja as a}from"./shiki-CMaUdEs0.js";(function(){let e=document.createElement(`link`).relList;if(e&&e.supports&&e.supports(`modulepreload`))return;for(let e of document.querySelectorAll(`link[rel="modulepreload"]`))n(e);new MutationObserver(e=>{for(let t of e)if(t.type===`childList`)for(let e of t.addedNodes)e.tagName===`LINK`&&e.rel===`modulepreload`&&n(e)}).observe(document,{childList:!0,subtree:!0});function t(e){let t={};return e.integrity&&(t.integrity=e.integrity),e.referrerPolicy&&(t.referrerPolicy=e.referrerPolicy),e.crossOrigin===`use-credentials`?t.credentials=`include`:e.crossOrigin===`anonymous`?t.credentials=`omit`:t.credentials=`same-origin`,t}function n(e){if(e.ep)return;e.ep=!0;let n=t(e);fetch(e.href,n)}})();var o=e=>e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase(),s=e=>e.replace(/^([A-Z])|[\s-_]+(\w)/g,(e,t,n)=>n?n.toUpperCase():t.toLowerCase()),c=e=>{let t=s(e);return t.charAt(0).toUpperCase()+t.slice(1)},l=(...e)=>e.filter((e,t,n)=>!!e&&e.trim()!==``&&n.indexOf(e)===t).join(` `).trim(),u=e=>{for(let t in e)if(t.startsWith(`aria-`)||t===`role`||t===`title`)return!0},d={xmlns:`http://www.w3.org/2000/svg`,width:24,height:24,viewBox:`0 0 24 24`,fill:`none`,stroke:`currentColor`,strokeWidth:2,strokeLinecap:`round`,strokeLinejoin:`round`},f=t(),p=(0,f.forwardRef)(({color:e=`currentColor`,size:t=24,strokeWidth:n=2,absoluteStrokeWidth:r,className:i=``,children:a,iconNode:o,...s},c)=>(0,f.createElement)(`svg`,{ref:c,...d,width:t,height:t,stroke:e,strokeWidth:r?Number(n)*24/Number(t):n,className:l(`lucide`,i),...!a&&!u(s)&&{"aria-hidden":`true`},...s},[...o.map(([e,t])=>(0,f.createElement)(e,t)),...Array.isArray(a)?a:[a]])),m=(e,t)=>{let n=(0,f.forwardRef)(({className:n,...r},i)=>(0,f.createElement)(p,{ref:i,iconNode:t,className:l(`lucide-${o(c(e))}`,`lucide-${e}`,n),...r}));return n.displayName=c(e),n},h=m(`arrow-left`,[[`path`,{d:`m12 19-7-7 7-7`,key:`1l729n`}],[`path`,{d:`M19 12H5`,key:`x3x0zl`}]]),g=m(`arrow-right`,[[`path`,{d:`M5 12h14`,key:`1ays0h`}],[`path`,{d:`m12 5 7 7-7 7`,key:`xquz4c`}]]),_=m(`chevron-down`,[[`path`,{d:`m6 9 6 6 6-6`,key:`qrunsl`}]]),v=m(`chevron-right`,[[`path`,{d:`m9 18 6-6-6-6`,key:`mthhwq`}]]),ee=m(`monitor`,[[`rect`,{width:`20`,height:`14`,x:`2`,y:`3`,rx:`2`,key:`48i651`}],[`line`,{x1:`8`,x2:`16`,y1:`21`,y2:`21`,key:`1svkeh`}],[`line`,{x1:`12`,x2:`12`,y1:`17`,y2:`21`,key:`vw1qmm`}]]),te=m(`moon`,[[`path`,{d:`M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401`,key:`kfwtm`}]]),ne=m(`sun`,[[`circle`,{cx:`12`,cy:`12`,r:`4`,key:`4exip2`}],[`path`,{d:`M12 2v2`,key:`tus03m`}],[`path`,{d:`M12 20v2`,key:`1lh1kg`}],[`path`,{d:`m4.93 4.93 1.41 1.41`,key:`149t6j`}],[`path`,{d:`m17.66 17.66 1.41 1.41`,key:`ptbguv`}],[`path`,{d:`M2 12h2`,key:`1t8f8n`}],[`path`,{d:`M20 12h2`,key:`1q8mjw`}],[`path`,{d:`m6.34 17.66-1.41 1.41`,key:`1m8zz5`}],[`path`,{d:`m19.07 4.93-1.41 1.41`,key:`1shlcs`}]]),y=i();function b(...t){return r(e(t))}var x=n();function S({navigation:e,selected:t,onSelect:n,onHome:r}){return(0,x.jsxs)(`nav`,{className:`flex h-full w-64 flex-col border-r border-border bg-card`,children:[(0,x.jsx)(`div`,{className:`flex h-16 items-center border-b border-border px-4`,children:(0,x.jsxs)(`button`,{type:`button`,onClick:()=>r?.(),title:`返回首页`,className:`block text-left transition-opacity hover:opacity-80`,children:[(0,x.jsx)(`h1`,{className:`font-display text-lg font-bold `+(t===null?`text-primary`:`text-primary/80`),children:`Saluzi Guide`}),(0,x.jsx)(`p`,{className:`text-xs text-muted-foreground`,children:`使用指南`})]})}),(0,x.jsxs)(`div`,{className:`flex-1 overflow-y-auto px-2 py-2`,children:[(0,x.jsx)(C,{label:`命令宝典`,isActive:t===`__commands__`,onClick:()=>n(`__commands__`)}),(0,x.jsx)(`div`,{className:`my-2 border-t border-border-light`}),e.map(e=>(0,x.jsx)(re,{group:e,selected:t,onSelect:n},e.group))]})]})}function C({label:e,isActive:t,onClick:n}){return(0,x.jsx)(`button`,{type:`button`,onClick:n,className:b(`w-full rounded-md px-3 py-1.5 text-left text-sm transition-colors`,t?`bg-primary text-primary-foreground`:`text-foreground hover:bg-muted`),children:e})}function re({group:e,selected:t,onSelect:n}){let[r,i]=(0,f.useState)(!0);return(0,x.jsxs)(`div`,{className:`mb-1`,children:[(0,x.jsxs)(`button`,{type:`button`,onClick:()=>i(e=>!e),className:`flex w-full items-center gap-1 px-2 py-1.5 text-left text-xs font-semibold uppercase text-muted-foreground hover:text-foreground`,children:[r?(0,x.jsx)(_,{className:`h-3 w-3`}):(0,x.jsx)(v,{className:`h-3 w-3`}),e.group]}),r?(0,x.jsx)(`div`,{className:`ml-2 border-l border-border-light pl-2`,children:w(e.pages).map(e=>(0,x.jsx)(C,{label:e.title??e.path??``,isActive:t===e.path,onClick:()=>e.path&&n(e.path)},e.path))}):null]})}function w(e){let t=[];for(let n of e)n.path?t.push({title:n.title??n.path,path:n.path}):n.pages?t.push(...w(n.pages)):n.group&&t.push({title:n.group,path:void 0});return t}var T=`saluzi-guide-theme`;function E(){return typeof window>`u`?`light`:window.matchMedia(`(prefers-color-scheme: dark)`).matches?`dark`:`light`}function D(){return typeof window>`u`?`system`:localStorage.getItem(T)??`system`}function O(e){let t=e===`system`?E():e,n=document.documentElement;n.classList.remove(`light`,`dark`),n.classList.add(t)}function k(){let[e,t]=(0,f.useState)(D);return(0,f.useEffect)(()=>{O(e),e===`system`?localStorage.removeItem(T):localStorage.setItem(T,e)},[e]),(0,f.useEffect)(()=>{if(e!==`system`)return;let t=window.matchMedia(`(prefers-color-scheme: dark)`),n=()=>O(`system`);return t.addEventListener(`change`,n),()=>t.removeEventListener(`change`,n)},[e]),{theme:e,setTheme:t,resolved:e===`system`?E():e}}function A(){let{theme:e,setTheme:t}=k();return(0,x.jsx)(`div`,{className:`inline-flex items-center gap-1 rounded-md border border-border bg-card p-1`,children:[{id:`light`,icon:ne,label:`Light`},{id:`dark`,icon:te,label:`Dark`},{id:`system`,icon:ee,label:`Auto`}].map(({id:n,icon:r,label:i})=>(0,x.jsx)(`button`,{type:`button`,onClick:()=>t(n),"aria-label":i,"aria-pressed":e===n,className:b(`inline-flex h-7 w-7 items-center justify-center rounded-sm transition-colors`,e===n?`bg-primary text-primary-foreground`:`text-muted-foreground hover:text-foreground`),children:(0,x.jsx)(r,{className:`h-4 w-4`})},n))})}var j=[{id:`login`,step:1,title:`首次登录`,commands:[`/login`],description:`登录 Saluzi 账户或设置 API Key`,chapterPath:`docs/guide/getting-started`},{id:`model`,step:2,title:`选择与切换模型`,commands:[`/model`,`/effort`,`/mom`],description:`切换 Max/Pro/Std,调节推理深度,使用 MOM 混合模型`,chapterPath:`docs/guide/model-selection`},{id:`conversation`,step:3,title:`对话基础与多轮交互`,commands:[`/compact`,`/resume`,`/rewind`,`/export`],description:`第一次提问、多轮对话、流式输出、对话压缩与导出恢复`,chapterPath:`docs/guide/conversation-basics`},{id:`shortcuts`,step:4,title:`快捷键与模式切换`,commands:[`Shift+Tab`,`Ctrl+C`,`/keybindings`],description:`一键打断、切换计划模式、搜历史输入;不合手还能自定义按键`,chapterPath:`docs/guide/keyboard-shortcuts`},{id:`commit`,step:5,title:`查看与提交代码`,commands:[`/diff`,`/commit`,`/commit-push-pr`],description:`预览改动、提交、推送并创建 PR 一条龙`,chapterPath:`docs/guide/commit-workflow`},{id:`context`,step:6,title:`上下文与项目记忆`,commands:[`/add-dir`,`/memory`,`/compact`],description:`挂载目录、SALUZI.md 项目记忆、个人偏好,让 AI 更懂你的项目`,chapterPath:`docs/guide/context-tips`},{id:`cost`,step:7,title:`查看消耗`,commands:[`/cost`,`/stats`],description:`当前会话花费与历史统计`,chapterPath:`docs/guide/cost-usage`},{id:`troubleshoot`,step:8,title:`排障`,commands:[`/doctor`,`/help`,`/permissions`,`/plan`],description:`诊断安装、查命令、调整权限、规划模式`,chapterPath:`docs/guide/troubleshooting`}];function M({workflow:e,onSelect:t}){return(0,x.jsxs)(`button`,{type:`button`,onClick:()=>e.chapterPath&&t?.(e.chapterPath),className:b(`group flex w-full flex-col gap-2 rounded-xl border border-border bg-card p-5 text-left`,`transition-shadow hover:shadow-md`,!e.chapterPath&&`cursor-default`),disabled:!e.chapterPath,children:[(0,x.jsxs)(`div`,{className:`flex items-center gap-3`,children:[(0,x.jsx)(`span`,{className:`inline-flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-primary text-sm font-semibold text-primary-foreground`,children:e.step}),(0,x.jsx)(`h3`,{className:`font-display text-base font-semibold text-foreground`,children:e.title}),e.chapterPath&&(0,x.jsx)(g,{className:`ml-auto h-4 w-4 text-muted-foreground transition-transform group-hover:translate-x-1`})]}),(0,x.jsx)(`p`,{className:`text-sm text-muted-foreground`,children:e.description}),(0,x.jsx)(`div`,{className:`flex flex-wrap gap-1.5`,children:e.commands.map(e=>(0,x.jsx)(`code`,{className:`rounded-md border border-border-light bg-background px-2 py-0.5 font-mono text-xs text-foreground`,children:e},e))})]})}function N({command:e,onSelect:t}){let n=e.descriptionZh||e.description||`—`,r=!!e.detail,i=r&&t,a=(0,x.jsxs)(x.Fragment,{children:[(0,x.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,x.jsxs)(`code`,{className:`font-mono text-sm font-semibold text-primary`,children:[`/`,e.name]}),e.aliases?.length?(0,x.jsxs)(`span`,{className:`text-xs text-muted-foreground`,children:[`alias: `,e.aliases.map(e=>`/${e}`).join(`, `)]}):null]}),(0,x.jsx)(`p`,{className:`text-sm text-foreground`,children:n}),r?(0,x.jsxs)(`span`,{className:`mt-0.5 inline-flex items-center gap-1 text-xs font-medium text-primary`,children:[`查看详情`,(0,x.jsx)(g,{className:`h-3 w-3 transition-transform group-hover:translate-x-0.5`})]}):null]}),o=`group flex w-full flex-col gap-1.5 rounded-lg border border-border bg-card p-4 text-left transition-shadow`+(i?` hover:shadow-md focus:outline-none focus-visible:ring-2 focus-visible:ring-primary`:``);return i?(0,x.jsx)(`button`,{type:`button`,className:o,onClick:()=>t?.(e.name),children:a}):(0,x.jsx)(`div`,{className:o,children:a})}function P({preview:e}){let t=e.kind===`floating`,n=e.kind===`pane`;return(0,x.jsxs)(`div`,{className:`my-4`,children:[(0,x.jsx)(`p`,{className:`mb-2 text-xs font-semibold uppercase tracking-wider text-muted-foreground`,children:`面板预览 · Panel Preview`}),(0,x.jsxs)(`div`,{className:b(`overflow-hidden rounded-lg border border-border bg-[#0b0e14] shadow-sm`,t&&`rotate-[0.3deg] shadow-md`),children:[n?(0,x.jsxs)(`div`,{className:`flex items-stretch border-b border-white/10 bg-white/5`,children:[(0,x.jsx)(`div`,{className:`w-1.5 shrink-0 bg-primary`}),(0,x.jsxs)(`div`,{className:`flex items-center gap-2 px-3 py-1.5`,children:[(0,x.jsx)(`span`,{className:`font-mono text-xs font-semibold text-foreground`,children:e.title}),e.subtitle?(0,x.jsx)(`span`,{className:`ml-2 font-mono text-xs text-muted-foreground`,children:e.subtitle}):null]})]}):(0,x.jsxs)(`div`,{className:`flex items-center gap-2 border-b border-white/10 bg-white/5 px-3 py-1.5`,children:[(0,x.jsxs)(`span`,{className:`flex gap-1.5`,children:[(0,x.jsx)(`span`,{className:`h-2.5 w-2.5 rounded-full bg-[#ff5f56]`}),(0,x.jsx)(`span`,{className:`h-2.5 w-2.5 rounded-full bg-[#ffbd2e]`}),(0,x.jsx)(`span`,{className:`h-2.5 w-2.5 rounded-full bg-[#27c93f]`})]}),(0,x.jsx)(`span`,{className:`ml-1 font-mono text-xs font-semibold text-foreground`,children:e.title}),e.subtitle?(0,x.jsx)(`span`,{className:`ml-2 font-mono text-xs text-muted-foreground`,children:e.subtitle}):null]}),(0,x.jsx)(`div`,{className:b(`font-mono text-[13px] leading-relaxed`,`px-4 py-3`),children:e.lines.map((e,t)=>(0,x.jsx)(F,{line:e},t))}),e.footer?(0,x.jsx)(`div`,{className:`border-t border-white/10 bg-white/5 px-3 py-1.5`,children:(0,x.jsx)(`span`,{className:`font-mono text-[11px] text-muted-foreground`,children:e.footer})}):null]})]})}function F({line:e}){switch(e.type){case`heading`:return(0,x.jsx)(`div`,{className:`mt-2 mb-1 font-bold text-primary`,children:e.text});case`text`:return(0,x.jsx)(`div`,{className:`text-foreground`,children:e.text});case`dim`:return(0,x.jsx)(`div`,{className:`text-muted-foreground`,children:e.text});case`code`:return(0,x.jsx)(`div`,{className:`rounded bg-white/5 px-2 py-0.5 text-[#7dd3fc]`,children:e.text});case`success`:return(0,x.jsx)(`div`,{className:`text-[#27c93f]`,children:e.text});case`warn`:return(0,x.jsx)(`div`,{className:`text-[#ffbd2e]`,children:e.text});case`divider`:return(0,x.jsx)(`div`,{className:`my-1 border-t border-white/10`});case`kv`:return(0,x.jsxs)(`div`,{className:`text-foreground`,children:[(0,x.jsx)(`span`,{className:`text-muted-foreground`,children:e.label}),e.value?(0,x.jsx)(`span`,{className:`mx-1 text-muted-foreground`,children:`:`}):null,e.value?(0,x.jsx)(`span`,{className:`text-foreground`,children:e.value}):null]});case`item`:return(0,x.jsxs)(`div`,{className:b(`flex items-center gap-2 rounded px-2 py-0.5`,e.focused?`bg-primary text-primary-foreground`:`text-foreground hover:bg-white/5`),children:[(0,x.jsx)(`span`,{className:e.focused?`text-primary-foreground`:`text-muted-foreground`,children:e.focused?`❯`:` `}),(0,x.jsx)(`span`,{children:e.text})]});default:return null}}function I({title:e,children:t}){return(0,x.jsxs)(`section`,{className:`mb-10`,children:[(0,x.jsx)(`h2`,{className:`mb-3 font-display text-lg font-semibold text-primary`,children:e}),(0,x.jsx)(`div`,{className:`text-sm leading-relaxed text-foreground`,children:t})]})}function L({command:e,onBack:t}){let n=e.detail,r=e.descriptionZh||e.description,i=n?.summary||r||`—`;return(0,x.jsxs)(`div`,{className:`mx-auto max-w-3xl px-10 py-12 sm:px-14 sm:py-16`,children:[(0,x.jsxs)(`button`,{type:`button`,onClick:t,className:`mb-8 inline-flex items-center gap-1.5 text-sm text-muted-foreground transition-colors hover:text-foreground`,children:[(0,x.jsx)(h,{className:`h-4 w-4`}),`返回命令宝典`]}),(0,x.jsxs)(`header`,{className:`mb-10 border-b border-border pb-8`,children:[(0,x.jsx)(`p`,{className:`mb-3 text-xs font-semibold uppercase tracking-[0.2em] text-primary`,children:`Command`}),(0,x.jsxs)(`div`,{className:`flex flex-wrap items-center gap-3`,children:[(0,x.jsxs)(`code`,{className:`font-mono text-3xl font-bold text-foreground`,children:[`/`,e.name]}),e.aliases?.length?(0,x.jsx)(`div`,{className:`flex flex-wrap gap-2`,children:e.aliases.map(e=>(0,x.jsxs)(`span`,{className:`rounded-full border border-border-light bg-muted px-2.5 py-0.5 font-mono text-xs text-muted-foreground`,children:[`/`,e]},e))}):null]}),(0,x.jsx)(`p`,{className:`mt-4 font-serif text-base leading-relaxed text-muted-foreground`,children:i})]}),n?(0,x.jsxs)(x.Fragment,{children:[n.panelPreview?(0,x.jsx)(P,{preview:n.panelPreview}):null,(0,x.jsx)(I,{title:`使用场景`,children:n.scenario}),(0,x.jsx)(I,{title:`使用方式`,children:n.usage}),n.parameters?.length?(0,x.jsx)(I,{title:`参数说明`,children:(0,x.jsx)(`dl`,{className:`space-y-3`,children:n.parameters.map(e=>(0,x.jsxs)(`div`,{className:`rounded-lg border border-border-light bg-card p-3`,children:[(0,x.jsxs)(`div`,{className:`flex flex-wrap items-center gap-2`,children:[(0,x.jsx)(`code`,{className:`font-mono text-sm font-semibold text-foreground`,children:e.name}),e.required?(0,x.jsx)(`span`,{className:`rounded bg-primary/10 px-1.5 py-0.5 text-[10px] font-semibold uppercase text-primary`,children:`必填`}):(0,x.jsx)(`span`,{className:`rounded bg-muted px-1.5 py-0.5 text-[10px] font-semibold uppercase text-muted-foreground`,children:`可选`}),e.default?(0,x.jsxs)(`span`,{className:`text-xs text-muted-foreground`,children:[`默认:`,(0,x.jsx)(`code`,{className:`font-mono`,children:e.default})]}):null]}),(0,x.jsx)(`p`,{className:`mt-1.5 text-sm text-foreground`,children:e.description}),e.example?(0,x.jsxs)(`p`,{className:`mt-1 text-xs text-muted-foreground`,children:[`示例:`,(0,x.jsx)(`code`,{className:`font-mono text-foreground`,children:e.example})]}):null]},e.name))})}):(0,x.jsx)(I,{title:`参数说明`,children:(0,x.jsx)(`p`,{className:`text-muted-foreground`,children:`该命令无参数。`})}),n.examples?.length?(0,x.jsx)(I,{title:`示例`,children:(0,x.jsx)(`ul`,{className:`space-y-3`,children:n.examples.map(e=>(0,x.jsxs)(`li`,{className:`rounded-lg border border-border-light bg-card p-3`,children:[(0,x.jsx)(`code`,{className:`block font-mono text-sm text-primary`,children:e.command}),(0,x.jsx)(`p`,{className:`mt-1 text-sm text-foreground`,children:e.description})]},e.command))})}):null,n.tips?.length?(0,x.jsx)(I,{title:`小贴士`,children:(0,x.jsx)(`ul`,{className:`space-y-1.5`,children:n.tips.map((e,t)=>(0,x.jsxs)(`li`,{className:`flex gap-2 text-sm text-foreground`,children:[(0,x.jsx)(`span`,{className:`text-primary`,children:`·`}),(0,x.jsx)(`span`,{children:e})]},t))})}):null]}):(0,x.jsx)(I,{title:`使用方式`,children:(0,x.jsx)(`p`,{className:`text-muted-foreground`,children:`该命令暂无详细说明。`})})]})}var R=[`logo`,`mini`,`standard`,`detail`,`menu`];function z(e){return e&&R.includes(e)?e:`standard`}var B={logo:[130,130],mini:[176,130],standard:[220,130],detail:[460,340]},V={logo:`Cube only · 130×130`,mini:`Cube + counts · 176×130`,standard:`Standard(默认)· 220×130`,detail:`Detail · 460×340(可缩放)`,menu:`右键菜单 · 弹出于光标处,任何模式下都完整显示`};function ie({variant:e=`standard`}){return(0,x.jsxs)(`div`,{className:`parade-preview-root pp-${e}`,style:{margin:`20px 0`},children:[(0,x.jsx)(`style`,{children:W}),e===`menu`?(0,x.jsx)(U,{}):(0,x.jsx)(H,{variant:e}),(0,x.jsx)(`div`,{className:`pp-caption`,children:V[e]})]})}function H({variant:e}){let[t,n]=B[e];return(0,x.jsxs)(`div`,{className:`pp-window`,style:{width:`min(100%, ${t}px)`,aspectRatio:`${t} / ${n}`},children:[(0,x.jsx)(`div`,{className:`pp-cube-stage`,children:(0,x.jsx)(`div`,{className:`pp-cube`})}),(0,x.jsxs)(`div`,{className:`pp-panel`,children:[(0,x.jsxs)(`div`,{className:`pp-counts-row`,children:[(0,x.jsx)(`span`,{className:`pp-running-count`,children:`2`}),(0,x.jsx)(`span`,{className:`pp-counts-sep`,children:`/`}),(0,x.jsxs)(`span`,{className:`pp-waiting-pill`,children:[(0,x.jsx)(`span`,{className:`pp-dot`}),`1`]})]}),e===`detail`?(0,x.jsxs)(`div`,{className:`pp-sessions`,children:[(0,x.jsxs)(`div`,{className:`pp-session-row`,children:[(0,x.jsx)(`span`,{className:`pp-badge pp-badge-run`,children:`RUN`}),(0,x.jsx)(`span`,{className:`pp-session-text`,children:`重构认证模块:拆分会话验证逻辑并补齐单元测试`})]}),(0,x.jsxs)(`div`,{className:`pp-session-row`,children:[(0,x.jsx)(`span`,{className:`pp-badge pp-badge-run`,children:`RUN`}),(0,x.jsx)(`span`,{className:`pp-session-text`,children:`修复会话列表在空数据时的分页崩溃`})]}),(0,x.jsxs)(`div`,{className:`pp-session-row pp-blocked`,children:[(0,x.jsx)(`span`,{className:`pp-badge pp-badge-block`,children:`BLOCK`}),(0,x.jsx)(`span`,{className:`pp-session-text`,children:`等待批准:Bash(npm install)`})]}),(0,x.jsxs)(`div`,{className:`pp-session-row pp-idle`,children:[(0,x.jsx)(`span`,{className:`pp-badge pp-badge-idle`,children:`IDLE`}),(0,x.jsx)(`span`,{className:`pp-session-text`,children:`已连接,暂无任务`})]})]}):(0,x.jsxs)(`div`,{className:`pp-sessions`,children:[(0,x.jsx)(`div`,{className:`pp-session-row`,children:`cli · coding auth module`}),(0,x.jsx)(`div`,{className:`pp-session-row`,children:`cli · review PR #42`}),(0,x.jsx)(`div`,{className:`pp-session-row pp-blocked`,children:`cli · waiting approval`})]}),(0,x.jsx)(`div`,{className:`pp-ws-status`})]})]})}function U(){return(0,x.jsxs)(`div`,{className:`pp-menu-scene`,children:[(0,x.jsx)(`div`,{className:`pp-menu-cursor`,children:`▲`}),(0,x.jsxs)(`div`,{className:`pp-menu-card`,children:[(0,x.jsx)(`div`,{className:`pp-menu-label`,children:`View`}),(0,x.jsx)(`div`,{className:`pp-menu-item`,children:`Cube only`}),(0,x.jsx)(`div`,{className:`pp-menu-item`,children:`Cube + counts`}),(0,x.jsx)(`div`,{className:`pp-menu-item pp-menu-active`,children:`Standard`}),(0,x.jsx)(`div`,{className:`pp-menu-item`,children:`Detail`}),(0,x.jsx)(`div`,{className:`pp-menu-sep`}),(0,x.jsx)(`div`,{className:`pp-menu-item`,children:`Rotation: Dynamic`})]})]})}var W=`
|
|
3
|
+
.parade-preview-root {
|
|
4
|
+
display: flex;
|
|
5
|
+
flex-direction: column;
|
|
6
|
+
align-items: center;
|
|
7
|
+
}
|
|
8
|
+
.parade-preview-root .pp-window {
|
|
9
|
+
display: flex;
|
|
10
|
+
border-radius: 10px;
|
|
11
|
+
overflow: hidden;
|
|
12
|
+
background: #15121f;
|
|
13
|
+
box-shadow: 0 8px 32px rgba(0,0,0,0.4), 0 0 0 1px rgba(139, 92, 246, 0.18);
|
|
14
|
+
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
|
|
15
|
+
color: #e7e3f4;
|
|
16
|
+
user-select: none;
|
|
17
|
+
}
|
|
18
|
+
/* ---- Left: cube stage (43% in standard modes, 36% in detail) ---- */
|
|
19
|
+
.parade-preview-root .pp-cube-stage {
|
|
20
|
+
flex: 0 0 43%;
|
|
21
|
+
position: relative;
|
|
22
|
+
background:
|
|
23
|
+
radial-gradient(circle at 50% 45%, rgba(139, 92, 246, 0.35) 0%, transparent 60%),
|
|
24
|
+
linear-gradient(180deg, #1d1830 0%, #15121f 100%);
|
|
25
|
+
display: flex;
|
|
26
|
+
align-items: center;
|
|
27
|
+
justify-content: center;
|
|
28
|
+
border-right: 1px solid rgba(139, 92, 246, 0.18);
|
|
29
|
+
perspective: 200px;
|
|
30
|
+
}
|
|
31
|
+
.parade-preview-root .pp-cube-stage::after {
|
|
32
|
+
content: '';
|
|
33
|
+
position: absolute;
|
|
34
|
+
inset: 14px;
|
|
35
|
+
border: 1px solid rgba(139, 92, 246, 0.12);
|
|
36
|
+
border-radius: 8px;
|
|
37
|
+
pointer-events: none;
|
|
38
|
+
}
|
|
39
|
+
.parade-preview-root .pp-cube {
|
|
40
|
+
width: 22px;
|
|
41
|
+
height: 22px;
|
|
42
|
+
position: relative;
|
|
43
|
+
transform-style: preserve-3d;
|
|
44
|
+
transform: rotateX(-28deg) rotateY(45deg);
|
|
45
|
+
animation: pp-cube-spin 8s linear infinite;
|
|
46
|
+
background: rgba(139, 92, 246, 0.45);
|
|
47
|
+
border: 1px solid #8B5CF6;
|
|
48
|
+
}
|
|
49
|
+
.parade-preview-root .pp-cube::before,
|
|
50
|
+
.parade-preview-root .pp-cube::after {
|
|
51
|
+
content: '';
|
|
52
|
+
position: absolute;
|
|
53
|
+
inset: 0;
|
|
54
|
+
}
|
|
55
|
+
.parade-preview-root .pp-cube::before {
|
|
56
|
+
transform: rotateY(90deg) translateZ(11px);
|
|
57
|
+
background: rgba(167, 139, 250, 0.55);
|
|
58
|
+
border: 1px solid #a78bfa;
|
|
59
|
+
}
|
|
60
|
+
.parade-preview-root .pp-cube::after {
|
|
61
|
+
transform: rotateX(90deg) translateZ(11px);
|
|
62
|
+
background: rgba(109, 40, 217, 0.4);
|
|
63
|
+
border: 1px solid #6d28d9;
|
|
64
|
+
}
|
|
65
|
+
@keyframes pp-cube-spin {
|
|
66
|
+
from { transform: rotateX(-28deg) rotateY(0deg); }
|
|
67
|
+
to { transform: rotateX(-28deg) rotateY(360deg); }
|
|
68
|
+
}
|
|
69
|
+
@media (prefers-reduced-motion: reduce) {
|
|
70
|
+
.parade-preview-root .pp-cube { animation: none; }
|
|
71
|
+
}
|
|
72
|
+
/* ---- Right: info panel ---- */
|
|
73
|
+
.parade-preview-root .pp-panel {
|
|
74
|
+
flex: 1;
|
|
75
|
+
min-width: 0;
|
|
76
|
+
padding: 12px 14px 10px;
|
|
77
|
+
display: flex;
|
|
78
|
+
flex-direction: column;
|
|
79
|
+
gap: 8px;
|
|
80
|
+
background: linear-gradient(180deg, #1d1830 0%, #15121f 100%);
|
|
81
|
+
position: relative;
|
|
82
|
+
}
|
|
83
|
+
.parade-preview-root .pp-counts-row {
|
|
84
|
+
display: flex;
|
|
85
|
+
align-items: baseline;
|
|
86
|
+
gap: 8px;
|
|
87
|
+
}
|
|
88
|
+
.parade-preview-root .pp-running-count {
|
|
89
|
+
font-size: 28px;
|
|
90
|
+
font-weight: 700;
|
|
91
|
+
line-height: 1;
|
|
92
|
+
color: #a78bfa;
|
|
93
|
+
letter-spacing: -0.5px;
|
|
94
|
+
font-variant-numeric: tabular-nums;
|
|
95
|
+
}
|
|
96
|
+
.parade-preview-root .pp-counts-sep {
|
|
97
|
+
font-size: 14px;
|
|
98
|
+
color: #5c5575;
|
|
99
|
+
font-weight: 300;
|
|
100
|
+
}
|
|
101
|
+
.parade-preview-root .pp-waiting-pill {
|
|
102
|
+
display: inline-flex;
|
|
103
|
+
align-items: center;
|
|
104
|
+
gap: 4px;
|
|
105
|
+
padding: 2px 7px;
|
|
106
|
+
border-radius: 9px;
|
|
107
|
+
background: rgba(251, 191, 36, 0.12);
|
|
108
|
+
color: #fbbf24;
|
|
109
|
+
font-size: 11px;
|
|
110
|
+
font-weight: 600;
|
|
111
|
+
line-height: 1.3;
|
|
112
|
+
font-variant-numeric: tabular-nums;
|
|
113
|
+
}
|
|
114
|
+
.parade-preview-root .pp-waiting-pill .pp-dot {
|
|
115
|
+
width: 5px;
|
|
116
|
+
height: 5px;
|
|
117
|
+
border-radius: 50%;
|
|
118
|
+
background: #fbbf24;
|
|
119
|
+
box-shadow: 0 0 4px #fbbf24;
|
|
120
|
+
}
|
|
121
|
+
.parade-preview-root .pp-sessions {
|
|
122
|
+
flex: 1;
|
|
123
|
+
display: flex;
|
|
124
|
+
flex-direction: column;
|
|
125
|
+
gap: 3px;
|
|
126
|
+
min-height: 0;
|
|
127
|
+
}
|
|
128
|
+
.parade-preview-root .pp-session-row {
|
|
129
|
+
font-size: 10.5px;
|
|
130
|
+
line-height: 1.35;
|
|
131
|
+
color: #9b94b8;
|
|
132
|
+
padding: 2px 0 2px 14px;
|
|
133
|
+
position: relative;
|
|
134
|
+
font-variant-numeric: tabular-nums;
|
|
135
|
+
overflow: hidden;
|
|
136
|
+
text-overflow: ellipsis;
|
|
137
|
+
white-space: nowrap;
|
|
138
|
+
display: flex;
|
|
139
|
+
align-items: center;
|
|
140
|
+
}
|
|
141
|
+
.parade-preview-root .pp-session-row::before {
|
|
142
|
+
content: '';
|
|
143
|
+
position: absolute;
|
|
144
|
+
left: 0;
|
|
145
|
+
top: 50%;
|
|
146
|
+
transform: translateY(-50%);
|
|
147
|
+
width: 4px;
|
|
148
|
+
height: 4px;
|
|
149
|
+
border-radius: 50%;
|
|
150
|
+
background: #8B5CF6;
|
|
151
|
+
}
|
|
152
|
+
.parade-preview-root .pp-session-row.pp-blocked { color: #c9a96a; }
|
|
153
|
+
.parade-preview-root .pp-session-row.pp-blocked::before { background: #fbbf24; }
|
|
154
|
+
.parade-preview-root .pp-session-row.pp-idle { color: #5c5575; font-style: italic; }
|
|
155
|
+
.parade-preview-root .pp-session-row.pp-idle::before { background: #5c5575; }
|
|
156
|
+
.parade-preview-root .pp-ws-status {
|
|
157
|
+
position: absolute;
|
|
158
|
+
bottom: 5px;
|
|
159
|
+
right: 6px;
|
|
160
|
+
width: 6px;
|
|
161
|
+
height: 6px;
|
|
162
|
+
border-radius: 50%;
|
|
163
|
+
background: #4ade80;
|
|
164
|
+
box-shadow: 0 0 4px #4ade80;
|
|
165
|
+
}
|
|
166
|
+
/* ---- Mode-specific panel visibility ---- */
|
|
167
|
+
.parade-preview-root.pp-logo .pp-panel { display: none; }
|
|
168
|
+
.parade-preview-root.pp-logo .pp-cube-stage {
|
|
169
|
+
flex: 1 1 100%;
|
|
170
|
+
border-right: none;
|
|
171
|
+
}
|
|
172
|
+
.parade-preview-root.pp-mini .pp-sessions { display: none; }
|
|
173
|
+
.parade-preview-root.pp-mini .pp-panel { justify-content: center; }
|
|
174
|
+
/* ---- Detail mode: state badges + 2-line prompts ---- */
|
|
175
|
+
.parade-preview-root.pp-detail .pp-cube-stage { flex: 0 0 36%; }
|
|
176
|
+
.parade-preview-root .pp-badge {
|
|
177
|
+
flex-shrink: 0;
|
|
178
|
+
font-size: 8px;
|
|
179
|
+
font-weight: 700;
|
|
180
|
+
letter-spacing: 0.5px;
|
|
181
|
+
line-height: 1;
|
|
182
|
+
padding: 2px 4px;
|
|
183
|
+
border-radius: 3px;
|
|
184
|
+
margin-right: 6px;
|
|
185
|
+
font-style: normal;
|
|
186
|
+
}
|
|
187
|
+
.parade-preview-root .pp-badge-run { background: rgba(139, 92, 246, 0.18); color: #a78bfa; }
|
|
188
|
+
.parade-preview-root .pp-badge-block { background: rgba(251, 191, 36, 0.15); color: #fbbf24; }
|
|
189
|
+
.parade-preview-root .pp-badge-idle { background: rgba(155, 148, 184, 0.12); color: #5c5575; }
|
|
190
|
+
.parade-preview-root.pp-detail .pp-session-text {
|
|
191
|
+
white-space: normal;
|
|
192
|
+
display: -webkit-box;
|
|
193
|
+
-webkit-box-orient: vertical;
|
|
194
|
+
-webkit-line-clamp: 2;
|
|
195
|
+
overflow: hidden;
|
|
196
|
+
}
|
|
197
|
+
.parade-preview-root.pp-detail .pp-session-row { white-space: normal; }
|
|
198
|
+
/* ---- Menu popup ---- */
|
|
199
|
+
.parade-preview-root .pp-menu-scene {
|
|
200
|
+
width: min(100%, 320px);
|
|
201
|
+
padding: 26px 20px;
|
|
202
|
+
border-radius: 12px;
|
|
203
|
+
background:
|
|
204
|
+
radial-gradient(circle at 30% 30%, rgba(139, 92, 246, 0.12) 0%, transparent 60%),
|
|
205
|
+
#100d19;
|
|
206
|
+
box-shadow: inset 0 0 0 1px rgba(139, 92, 246, 0.1);
|
|
207
|
+
display: flex;
|
|
208
|
+
justify-content: center;
|
|
209
|
+
align-items: flex-start;
|
|
210
|
+
user-select: none;
|
|
211
|
+
}
|
|
212
|
+
.parade-preview-root .pp-menu-cursor {
|
|
213
|
+
color: #9b94b8;
|
|
214
|
+
font-size: 11px;
|
|
215
|
+
line-height: 1;
|
|
216
|
+
transform: translate(6px, -2px) rotate(45deg);
|
|
217
|
+
}
|
|
218
|
+
.parade-preview-root .pp-menu-card {
|
|
219
|
+
width: 158px;
|
|
220
|
+
background: #1d1830;
|
|
221
|
+
border: 1px solid rgba(139, 92, 246, 0.18);
|
|
222
|
+
border-radius: 6px;
|
|
223
|
+
padding: 3px;
|
|
224
|
+
box-shadow: 0 4px 16px rgba(0,0,0,0.5);
|
|
225
|
+
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
|
|
226
|
+
color: #e7e3f4;
|
|
227
|
+
}
|
|
228
|
+
.parade-preview-root .pp-menu-label {
|
|
229
|
+
padding: 4px 12px 2px;
|
|
230
|
+
font-size: 9px;
|
|
231
|
+
line-height: 11px;
|
|
232
|
+
letter-spacing: 1px;
|
|
233
|
+
text-transform: uppercase;
|
|
234
|
+
color: #5c5575;
|
|
235
|
+
}
|
|
236
|
+
.parade-preview-root .pp-menu-item {
|
|
237
|
+
padding: 5px 12px;
|
|
238
|
+
font-size: 11px;
|
|
239
|
+
line-height: 13px;
|
|
240
|
+
border-radius: 4px;
|
|
241
|
+
display: flex;
|
|
242
|
+
align-items: center;
|
|
243
|
+
}
|
|
244
|
+
.parade-preview-root .pp-menu-item::before {
|
|
245
|
+
content: '';
|
|
246
|
+
display: inline-block;
|
|
247
|
+
width: 9px;
|
|
248
|
+
height: 9px;
|
|
249
|
+
border-radius: 50%;
|
|
250
|
+
border: 1px solid #5c5575;
|
|
251
|
+
margin-right: 7px;
|
|
252
|
+
box-sizing: border-box;
|
|
253
|
+
flex-shrink: 0;
|
|
254
|
+
}
|
|
255
|
+
.parade-preview-root .pp-menu-active { color: #a78bfa; }
|
|
256
|
+
.parade-preview-root .pp-menu-active::before {
|
|
257
|
+
border-color: #8B5CF6;
|
|
258
|
+
background: #8B5CF6;
|
|
259
|
+
box-shadow: inset 0 0 0 2px #1d1830;
|
|
260
|
+
}
|
|
261
|
+
.parade-preview-root .pp-menu-sep {
|
|
262
|
+
height: 1px;
|
|
263
|
+
background: rgba(139, 92, 246, 0.18);
|
|
264
|
+
margin: 3px 6px;
|
|
265
|
+
}
|
|
266
|
+
/* ---- Caption ---- */
|
|
267
|
+
.parade-preview-root .pp-caption {
|
|
268
|
+
margin-top: 8px;
|
|
269
|
+
font-size: 12px;
|
|
270
|
+
color: #9b94b8;
|
|
271
|
+
text-align: center;
|
|
272
|
+
font-style: italic;
|
|
273
|
+
}
|
|
274
|
+
`,G=(0,f.lazy)(async()=>({default:(await a(()=>import(`./streamdown-nMT_aKRc.js`).then(e=>e.n),__vite__mapDeps([0,1,2]))).Streamdown}));function K(e){let t=e.split(`
|
|
275
|
+
`),n=[],r=!1,i=``;for(let e=0;e<t.length;e++){let a=t[e],o=a.trim(),s=/^(`{3}|~{3})/.exec(o);if(s){r?o.startsWith(i.repeat(3))&&(r=!1,i=``):(r=!0,i=s[1][0]),n.push(a);continue}if(r){n.push(a);continue}if(o===``||/^#{1,6} /.test(o)||o.startsWith(`|`)||/^[-*+]\s/.test(o)||/^\d+\.\s/.test(o)||o.startsWith(`>`)||/^(-{3,}|\*{3,}|_{3,})$/.test(o)||o.startsWith("```")){n.push(a);continue}let c=(n[n.length-1]??``).trim();c!==``&&!/^#{1,6} /.test(c)&&!c.startsWith(`|`)&&!/^[-*+]\s/.test(c)&&!/^\d+\.\s/.test(c)&&!c.startsWith(`>`)&&!/^(-{3,}|\*{3,}|_{3,})$/.test(c)&&!c.startsWith("```")&&n.push(``),n.push(a)}return n.join(`
|
|
276
|
+
`)}var q=/::parade-preview(?::([a-z-]+))?::/g;function J(e){return e.replace(/[*_`~]/g,``).replace(/[^\p{L}\p{N}\s-]/gu,``).trim().toLowerCase().replace(/\s+/g,`-`).replace(/-+/g,`-`).replace(/^-|-$/g,``)}function Y(e){let t=e.split(`
|
|
277
|
+
`),n=[],r=!1,i=``;for(let e of t){let t=e.trim(),a=/^(`{3}|~{3})/.exec(t);if(a){r?t.startsWith(i.repeat(3))&&(r=!1,i=``):(r=!0,i=a[1][0]);continue}if(r)continue;let o=/^(#{2,3})\s+(.+?)\s*$/.exec(t);if(!o)continue;let s=o[1].length,c=o[2],l=J(c);l&&n.push({level:s,text:c,slug:l})}let a=new Map;return n.map(e=>{let t=a.get(e.slug)??0;return a.set(e.slug,t+1),t===0?e:{...e,slug:`${e.slug}-${t}`}})}function ae(e){let t=[],n=0;for(let r of e.matchAll(q)){let i=e.slice(n,r.index);i&&t.push({kind:`md`,content:K(i)}),t.push({kind:`parade-preview`,variant:z(r[1])}),n=r.index+r[0].length}let r=e.slice(n);return r&&t.push({kind:`md`,content:K(r)}),t}function oe({chapter:e,path:t,onNavigate:n}){let r=e.frontmatter.title??t,i=(0,f.useRef)(null),a=(0,f.useRef)(null),[o,s]=(0,f.useState)(null),c=(0,f.useMemo)(()=>ae(e.content.replace(/^\{\/\*[\s\S]*?\*\/\}\s*\n/gm,``).replace(/^\{\/\*[\s\S]*?\*\/\}/gm,``)),[e.content]),l=(0,f.useMemo)(()=>Y(e.content),[e.content]);(0,f.useEffect)(()=>{if(!i.current||l.length===0)return;let e=i.current,t=()=>{e.querySelectorAll(`h2, h3`).forEach((e,t)=>{let n=l[t];n&&(e.id!==n.slug&&(e.id=n.slug),e.style.scrollMarginTop!==`5rem`&&(e.style.scrollMarginTop=`5rem`))})};t();let n=new MutationObserver(()=>t());return n.observe(e,{childList:!0,subtree:!0}),()=>n.disconnect()},[l,c]),(0,f.useEffect)(()=>{if(!i.current)return;let e=i.current.parentElement;for(;e&&getComputedStyle(e).overflowY!==`auto`;)e=e.parentElement;a.current=e},[]),(0,f.useEffect)(()=>{let e=a.current;if(!e||l.length===0)return;let t=()=>{let t=e.scrollTop,n=null;for(let e of l){let r=document.getElementById(e.slug);if(r)if(r.offsetTop-120<=t)n=e;else break}s(n?.slug??null)};return t(),e.addEventListener(`scroll`,t,{passive:!0}),()=>e.removeEventListener(`scroll`,t)},[l]);function u(e){if(!n)return null;if(e.startsWith(`docs/`))return e;let r=e.replace(/^(?:\.\.\/|\.\/|\/)+/,``);return r=r.replace(/\.(md|mdx)$/,``),r?`${t.split(`/`).slice(0,-1).join(`/`)}/${r}`:null}function d(e){if(!n)return;let t=e.target.closest(`a`);if(!t)return;let r=t.getAttribute(`href`);if(!r||/^(https?:|mailto:|#)/.test(r))return;let i=u(r);i&&(e.preventDefault(),n(i))}function p(e){let t=document.getElementById(e);if(t){t.scrollIntoView({behavior:`smooth`,block:`start`}),s(e);return}let n=0,r=window.setInterval(()=>{n+=1;let t=document.getElementById(e);t?(window.clearInterval(r),t.scrollIntoView({behavior:`smooth`,block:`start`}),s(e)):n>=20&&window.clearInterval(r)},50)}let m=l.length>=2;return(0,x.jsx)(`div`,{className:`mx-auto max-w-5xl px-6 py-12 sm:px-10 sm:py-16`,children:(0,x.jsxs)(`div`,{className:`flex gap-10`,children:[(0,x.jsxs)(`article`,{ref:i,className:`min-w-0 max-w-2xl flex-1 px-2 sm:px-4`,onClick:d,children:[(0,x.jsxs)(`header`,{className:`mb-12 border-b border-border pb-8`,children:[(0,x.jsx)(`h1`,{className:`font-display text-4xl font-bold leading-tight tracking-tight text-foreground`,children:r}),e.frontmatter.description?(0,x.jsx)(`p`,{className:`mt-4 font-serif text-lg leading-relaxed text-muted-foreground`,children:e.frontmatter.description}):null,e.frontmatter.keywords?.length?(0,x.jsx)(`div`,{className:`mt-6 flex flex-wrap gap-2`,children:e.frontmatter.keywords.map(e=>(0,x.jsx)(`span`,{className:`rounded-full border border-border-light bg-muted px-3 py-1 text-xs font-medium text-muted-foreground`,children:e},e))}):null]}),(0,x.jsx)(`div`,{className:`chapter-content max-w-none`,children:(0,x.jsx)(f.Suspense,{fallback:(0,x.jsx)(`div`,{className:`py-8 text-sm text-muted-foreground`,children:`Loading content…`}),children:c.map((e,t)=>e.kind===`parade-preview`?(0,x.jsx)(ie,{variant:e.variant},`pp-${t}`):(0,x.jsx)(G,{children:e.content},`md-${t}`))})})]}),m?(0,x.jsx)(`aside`,{className:`sticky top-4 hidden h-[calc(100vh-2rem)] w-56 shrink-0 self-start overflow-y-auto lg:block`,children:(0,x.jsxs)(`nav`,{"aria-label":`章节目录`,children:[(0,x.jsx)(`p`,{className:`mb-3 text-xs font-semibold uppercase tracking-wider text-muted-foreground`,children:`本章目录`}),(0,x.jsx)(`ul`,{className:`space-y-1 border-l border-border-light`,children:l.map(e=>{let t=o===e.slug;return(0,x.jsx)(`li`,{className:e.level===3?`ml-3`:``,children:(0,x.jsx)(`button`,{type:`button`,onClick:()=>p(e.slug),className:`block w-full border-l-2 py-1 pl-3 text-left text-xs leading-relaxed transition-colors `+(t?`border-primary text-primary`:`border-transparent text-muted-foreground hover:text-foreground`),style:{marginLeft:`-1px`},children:e.text})},e.slug)})})]})}):null]})})}var X=null;async function se(){if(X)return X;let e=await fetch(`./guide-data.json`);if(!e.ok)throw Error(`Failed to load guide-data.json: ${e.status}`);return X=await e.json(),X}function Z(){let e=window.location.hash.replace(/^#\/?/,``);if(!e)return{kind:`home`};if(e===`commands`)return{kind:`commands`};if(e.startsWith(`commands/`)){let t=e.slice(9);return t?{kind:`command`,name:t}:{kind:`commands`}}return{kind:`chapter`,path:e}}function Q(e){return e.kind===`home`?`#/`:e.kind===`commands`?`#/commands`:e.kind===`command`?`#/commands/${e.name}`:`#/${e.path}`}function ce(){let[e,t]=(0,f.useState)(null),[n,r]=(0,f.useState)(null),[i,a]=(0,f.useState)(()=>Z()),o=(0,f.useRef)(null),s=(0,f.useRef)(!1);if((0,f.useEffect)(()=>{se().then(t).catch(e=>r(e.message??String(e)))},[]),(0,f.useEffect)(()=>{let e=()=>a(Z());return window.addEventListener(`popstate`,e),()=>window.removeEventListener(`popstate`,e)},[]),(0,f.useEffect)(()=>{o.current?.scrollTo(0,0)},[i]),n)return(0,x.jsx)(`div`,{className:`flex h-screen items-center justify-center`,children:(0,x.jsxs)(`div`,{className:`max-w-md rounded-xl border border-destructive bg-card p-8 text-center`,children:[(0,x.jsx)(`h1`,{className:`font-display text-xl font-bold text-destructive`,children:`加载失败`}),(0,x.jsx)(`p`,{className:`mt-3 text-sm text-muted-foreground`,children:n}),(0,x.jsxs)(`p`,{className:`mt-2 text-xs text-muted-foreground`,children:[`请确认 guide-data.json 已生成(运行 `,(0,x.jsx)(`code`,{children:`npm run build:guide`}),`)。`]})]})});if(!e)return(0,x.jsx)(`div`,{className:`flex h-screen items-center justify-center text-muted-foreground`,children:`Loading guide…`});let c=e=>{window.location.hash!==e&&(window.history.pushState(null,``,e),s.current=!0)},l=e=>{c(Q(e)),a(e)},u=e=>{if(e===`__commands__`){l({kind:`commands`});return}l({kind:`chapter`,path:e})},d=e=>{l({kind:`command`,name:e})},p=()=>{l({kind:`commands`})},m=()=>{l({kind:`home`})},h=()=>{s.current&&window.history.length>1?window.history.back():p()},g=i.kind===`chapter`?i.path:i.kind===`commands`||i.kind===`command`?`__commands__`:null;return(0,x.jsxs)(`div`,{className:`flex h-screen w-screen overflow-hidden bg-background text-foreground`,children:[(0,x.jsx)(S,{navigation:e.navigation,selected:g,onSelect:u,onHome:m}),(0,x.jsxs)(`main`,{className:`flex flex-1 flex-col overflow-hidden`,children:[(0,x.jsx)(`header`,{className:`flex h-16 items-center justify-end border-b border-border bg-background/80 px-8 backdrop-blur-sm`,children:(0,x.jsx)(A,{})}),(0,x.jsx)(`div`,{ref:o,className:`flex-1 overflow-y-auto`,children:i.kind===`home`?(0,x.jsx)(le,{data:e,onSelect:u}):i.kind===`commands`?(0,x.jsx)(ue,{data:e,onSelectCommand:d}):i.kind===`command`?(0,x.jsx)(de,{data:e,name:i.name,onBack:h}):(0,x.jsx)(fe,{data:e,path:i.path,onSelect:u})})]})]})}function le({data:e,onSelect:t}){return(0,x.jsxs)(`div`,{className:`mx-auto max-w-5xl px-10 py-16 sm:px-16 sm:py-20`,children:[(0,x.jsxs)(`header`,{className:`mb-16`,children:[(0,x.jsx)(`p`,{className:`mb-3 text-xs font-semibold uppercase tracking-[0.2em] text-primary`,children:`Saluzi Guide`}),(0,x.jsx)(`h1`,{className:`font-display text-5xl font-bold leading-tight tracking-tight text-foreground`,children:`使用指南`}),(0,x.jsx)(`p`,{className:`mt-5 max-w-2xl font-serif text-lg leading-relaxed text-muted-foreground`,children:`Terminal-native agentic coding system · 终端原生的 AI 编程系统。 从新手入门到 Saluzi 特色,按你的节奏探索。`})]}),(0,x.jsxs)(`section`,{className:`mb-20`,children:[(0,x.jsxs)(`div`,{className:`mb-8 flex items-baseline justify-between border-b border-border pb-3`,children:[(0,x.jsx)(`h2`,{className:`font-display text-2xl font-semibold text-foreground`,children:`新手 Top 8 工作流`}),(0,x.jsx)(`span`,{className:`text-xs uppercase tracking-wider text-muted-foreground`,children:`按推荐顺序`})]}),(0,x.jsx)(`div`,{className:`grid grid-cols-1 gap-5 md:grid-cols-2`,children:j.map(e=>(0,x.jsx)(M,{workflow:e,onSelect:t},e.id))})]}),(0,x.jsxs)(`section`,{children:[(0,x.jsxs)(`div`,{className:`mb-8 flex items-baseline justify-between border-b border-border pb-3`,children:[(0,x.jsx)(`h2`,{className:`font-display text-2xl font-semibold text-foreground`,children:`Saluzi 特色`}),(0,x.jsx)(`span`,{className:`text-xs uppercase tracking-wider text-muted-foreground`,children:`saluzi 独有`})]}),(0,x.jsx)(`div`,{className:`grid grid-cols-1 gap-3 md:grid-cols-2`,children:e.navigation.find(e=>e.group===`Saluzi 特色`)?.pages.flatMap(e=>e.pages?e.pages:[e]).filter(e=>e.path).map(e=>(0,x.jsxs)(`button`,{type:`button`,onClick:()=>e.path&&t(e.path),className:`group flex items-center justify-between rounded-xl border border-border bg-card p-4 text-left transition-shadow hover:shadow-md`,children:[(0,x.jsx)(`span`,{className:`font-display text-base font-medium text-foreground`,children:e.title??e.path}),(0,x.jsx)(g,{className:`h-4 w-4 text-muted-foreground transition-transform group-hover:translate-x-1`})]},e.path))??null})]})]})}function ue({data:e,onSelectCommand:t}){let n=Object.values(e.commands).filter(e=>e.detail).length;return(0,x.jsxs)(`div`,{className:`mx-auto max-w-4xl px-10 py-16 sm:px-14 sm:py-20`,children:[(0,x.jsxs)(`header`,{className:`mb-14 border-b border-border pb-8`,children:[(0,x.jsx)(`p`,{className:`mb-3 text-xs font-semibold uppercase tracking-[0.2em] text-primary`,children:`Command Dictionary`}),(0,x.jsx)(`h1`,{className:`font-display text-4xl font-bold tracking-tight text-foreground`,children:`命令宝典`}),(0,x.jsxs)(`p`,{className:`mt-4 font-serif text-base leading-relaxed text-muted-foreground`,children:[`按分类列出所有可用命令(共 `,Object.keys(e.commands).length,` 条,其中 `,n,` `,`条含详解)。点击任意命令卡片查看命令名、简介、使用场景、使用方式与参数说明。`]})]}),e.categories.map(e=>(0,x.jsxs)(`section`,{className:`mb-14`,children:[(0,x.jsx)(`h2`,{className:`mb-6 font-display text-xl font-semibold text-primary`,children:e.titleZh??e.title}),(0,x.jsx)(`div`,{className:`grid grid-cols-1 gap-3 md:grid-cols-2`,children:e.commands.map(e=>(0,x.jsx)(N,{command:e,onSelect:t},e.name))})]},e.id))]})}function de({data:e,name:t,onBack:n}){let r=e.commands[t];return r?(0,x.jsx)(L,{command:r,onBack:n}):(0,x.jsxs)(`div`,{className:`mx-auto max-w-2xl px-10 py-16`,children:[(0,x.jsx)(`button`,{type:`button`,onClick:n,className:`mb-6 text-sm text-muted-foreground hover:text-foreground`,children:`← 返回命令宝典`}),(0,x.jsx)(`h1`,{className:`font-display text-3xl font-bold text-foreground`,children:`未找到命令`}),(0,x.jsxs)(`p`,{className:`mt-3 font-mono text-sm text-muted-foreground`,children:[`/`,t]}),(0,x.jsx)(`p`,{className:`mt-2 text-sm text-muted-foreground`,children:`该命令可能已移除或重命名。`})]})}function fe({data:e,path:t,onSelect:n}){let r=e.chapters[t];return r?(0,x.jsx)(oe,{chapter:r,path:t,onNavigate:n}):(0,x.jsxs)(`div`,{className:`mx-auto max-w-2xl px-10 py-16`,children:[(0,x.jsx)(`h1`,{className:`font-display text-3xl font-bold text-foreground`,children:`未找到章节`}),(0,x.jsx)(`p`,{className:`mt-3 text-sm text-muted-foreground`,children:`该章节可能已移除或重命名。`})]})}var $=document.getElementById(`root`);if(!$)throw Error(`root element not found`);(0,y.createRoot)($).render((0,x.jsx)(f.StrictMode,{children:(0,x.jsx)(ce,{})}));
|
|
@@ -6061,6 +6061,16 @@
|
|
|
6061
6061
|
"name": "SALUZI_BRIDGE_ALLOW_INSECURE_HTTP",
|
|
6062
6062
|
"category": "other"
|
|
6063
6063
|
},
|
|
6064
|
+
{
|
|
6065
|
+
"name": "SALUZI_BRIDGE_ATTACH_TIMEOUT_MS",
|
|
6066
|
+
"category": "bridge",
|
|
6067
|
+
"defaultValue": "86400000",
|
|
6068
|
+
"description": "等待接入的超时时间(毫秒)"
|
|
6069
|
+
},
|
|
6070
|
+
{
|
|
6071
|
+
"name": "SALUZI_BRIDGE_AUTO_CONNECT",
|
|
6072
|
+
"category": "other"
|
|
6073
|
+
},
|
|
6064
6074
|
{
|
|
6065
6075
|
"name": "SALUZI_BRIDGE_BASE_URL",
|
|
6066
6076
|
"category": "bridge",
|
|
@@ -6079,10 +6089,20 @@
|
|
|
6079
6089
|
"category": "bridge",
|
|
6080
6090
|
"description": "worker 连接 RCS 的 token"
|
|
6081
6091
|
},
|
|
6092
|
+
{
|
|
6093
|
+
"name": "SALUZI_BRIDGE_SESSION_ID",
|
|
6094
|
+
"category": "bridge",
|
|
6095
|
+
"description": "启动时接入指定 RCS 会话(等效 /rc --attach <会话ID>)"
|
|
6096
|
+
},
|
|
6082
6097
|
{
|
|
6083
6098
|
"name": "SALUZI_BRIDGE_SESSION_INGRESS_URL",
|
|
6084
6099
|
"category": "other"
|
|
6085
6100
|
},
|
|
6101
|
+
{
|
|
6102
|
+
"name": "SALUZI_BRIDGE_SESSION_MODE",
|
|
6103
|
+
"category": "bridge",
|
|
6104
|
+
"description": "设为 attach:启动后进入等待接入状态,由 Web UI 绑定会话"
|
|
6105
|
+
},
|
|
6086
6106
|
{
|
|
6087
6107
|
"name": "SALUZI_BRIDGE_TEAM_ID",
|
|
6088
6108
|
"category": "other"
|
|
@@ -7145,10 +7165,11 @@
|
|
|
7145
7165
|
"桌面",
|
|
7146
7166
|
"悬浮",
|
|
7147
7167
|
"会话状态",
|
|
7148
|
-
"可视化"
|
|
7168
|
+
"可视化",
|
|
7169
|
+
"显示模式"
|
|
7149
7170
|
]
|
|
7150
7171
|
},
|
|
7151
|
-
"content": "\n## 什么是 /parade\n\nParade 是 Saluzi
|
|
7172
|
+
"content": "\n## 什么是 /parade\n\nParade 是 Saluzi 的桌面悬浮提示功能。它在桌面显示一个小型悬浮窗口,实时反映:\n\n- **运行中会话数**:当前正在执行工具调用的会话(大数字)\n- **等待中会话数**:空闲或等待你确认的会话(琥珀色胶囊)\n- **会话列表**:每个已连接终端的当前任务,右下角绿点表示连接正常\n- **状态立方体**:有会话运行时旋转,全部空闲时静止,一眼可辨\n\n运行中 2 / 等待 1 的标准外观:\n\n::parade-preview:standard::\n\n## 启用与关闭\n\n```\n> /parade\n```\n\n首次启用会自动检测并安装 Electron(若未安装,支持 `ELECTRON_MIRROR` 环境变量配置镜像),然后启动悬浮窗。悬浮窗默认出现在**主显示器右下角**,无边框、始终置顶。\n\n关闭方式:\n\n```\n> /parade off\n```\n\n或把鼠标悬停在悬浮窗上,点击右上角浮现的 **×** 按钮(效果等同 `/parade off`)。\n\nParade 服务器以脱离模式运行——即使启动它的 CLI 关闭,悬浮窗仍然存活,直到用上述方式显式关闭。\n\n## 窗口操作\n\n- **移动**:按住窗口任意位置拖动\n- **缩放**:拖动窗口边角或边缘(最小 100×80)\n- **尺寸记忆**:手动调整过的尺寸按显示模式分别记忆,下次进入同一模式时恢复\n\n## 显示模式\n\n右键悬浮窗可打开菜单,在 4 种显示模式间切换,按信息完整度排序。当前模式在菜单中以实心圆点标记,切换后自动记住。\n\n### Cube only\n\n只保留立方体,占用最小的桌面空间。\n\n::parade-preview:logo::\n\n### Cube + counts\n\n立方体 + 运行/等待计数,不显示会话列表。\n\n::parade-preview:mini::\n\n### Standard(默认)\n\n立方体 + 计数 + 会话列表。运行中的会话排在最前,需要确认的会话以琥珀色显示,最多显示 5 行,超出的折叠为「+ N more」。\n\n::parade-preview:standard::\n\n### Detail\n\n大窗口详情:每个会话带状态徽章(RUN / BLOCK / IDLE)、任务描述显示更完整(约两行),最多显示 20 行,点击任意一行即可跳转终端。\n\n::parade-preview:detail::\n\n### 切换与记忆\n\n- 当前模式、按模式记忆的窗口尺寸、旋转设置都会持久保存,重启悬浮窗后仍生效\n- 放大窗口时,立方体与文字按比例缩放\n\n## 右键菜单\n\n在悬浮窗上右键,菜单会直接弹出于光标处——即使在最小的 Cube only 模式下也完整显示,不会被窗口边界截断。\n\n::parade-preview:menu::\n\n- **View** 区:四个显示模式的单选项,当前模式为实心圆点\n- **Rotation: Dynamic / Static**:控制立方体的旋转时机。Dynamic(默认)= 有会话运行时旋转、空闲时静止;Static = 相反(空闲时旋转、运行时静止),适合把「还在转」当作「等你回来处理」的信号\n\n此外,把鼠标放在左侧立方体区域滚动滚轮,也可以在相邻模式间逐级切换。\n\n## 跳转终端\n\n会话列表每行左侧的指示点(悬停变为 ▸)可跳转到该会话所在的终端窗口;Detail 模式下点击整行即可。点击后该行会有一道划过的光效确认已发送。\n\n跨边界场景(WSL 内的 CLI 向 Windows 侧悬浮窗上报)中,WSL 进程在 Windows 侧没有对应进程 ID,Parade 会退而激活检测到的终端窗口(Windows Terminal 等)。存在多个终端窗口时聚焦第一个匹配窗口,不保证定位到具体标签页。\n\n## 多会话并行\n\n多个终端各自运行 Saluzi 会话时,所有 CLI 实例共享同一个 Parade 窗口,悬浮窗显示所有已连接会话的运行/等待计数。\n\n## 平台支持\n\n| 平台 | 状态 | 说明 |\n|------|------|------|\n| macOS | 完全支持 | 原生 Electron |\n| Linux | 支持 | 需 X11 或 Wayland |\n| Windows | 支持 | Electron |\n| WSL | 支持 | 通过 /etc/resolv.conf 解析主机 IP |\n\n## 故障排查\n\n- **悬浮窗不显示**:检查 Electron 是否安装(`/parade` 会自动安装)\n- **Electron 安装路径**:`~/.saluzi/parade/`\n- **多显示器**:悬浮窗默认出现在主显示器右下角,可以随时拖动到其他屏幕\n"
|
|
7152
7173
|
},
|
|
7153
7174
|
"docs/guide/keyboard-shortcuts": {
|
|
7154
7175
|
"frontmatter": {
|
|
@@ -7323,22 +7344,23 @@
|
|
|
7323
7344
|
"docs/guide/remote-control-acp": {
|
|
7324
7345
|
"frontmatter": {
|
|
7325
7346
|
"title": "Remote Control 与 ACP - 让团队共享 Agent",
|
|
7326
|
-
"description": "Remote Control Server (RCS) 自托管 Web UI
|
|
7347
|
+
"description": "Remote Control Server (RCS) 自托管 Web UI,支持会话接入(Attach)与 ACP 外部 agent 接入,实现团队共享 agent 与远程控制会话。",
|
|
7327
7348
|
"keywords": [
|
|
7328
7349
|
"RCS",
|
|
7329
7350
|
"Remote Control",
|
|
7351
|
+
"Attach",
|
|
7352
|
+
"会话接入",
|
|
7330
7353
|
"ACP",
|
|
7331
7354
|
"团队协作",
|
|
7332
7355
|
"自托管",
|
|
7333
7356
|
"Web UI",
|
|
7334
7357
|
"Worker",
|
|
7335
|
-
"acp-link",
|
|
7336
7358
|
"claim",
|
|
7337
7359
|
"权限",
|
|
7338
7360
|
"可见域"
|
|
7339
7361
|
]
|
|
7340
7362
|
},
|
|
7341
|
-
"content": "\n## Remote Control Server (RCS)\n\nRCS 是 Saluzi 的自托管远程控制服务器,提供 Web UI 和会话管理。启动后,团队成员通过浏览器访问 Web UI,登录后即可创建会话、查看 worker 状态、与 agent 交互。\n\n## 启动 RCS\n\n```bash\n# 设置 API Key(管理员密码,也是 worker 连接 token)\nexport RCS_API_KEYS=sk-your-key\n\n# 启动(在 Saluzi CLI 中运行)\n> /rcs\n```\n\n也可通过 CLI 子命令直接启动:\n\n```bash\nslz rcs\n```\n\n默认端口 3000,Web UI 在 `http://localhost:3000/code/`。\n\n## RCS Web UI 使用\n\nWeb UI 是团队成员日常使用的控制面板:登录后可创建会话、查看 worker、审批权限、管理团队与环境。下面按首次部署到日常使用的顺序介绍。\n\n### 管理员初始化(首次访问)\n\n第一次打开 Web UI 时,系统没有任何用户。第一个登录的账号会成为系统管理员(role=admin),流程如下:\n\n1. 浏览器打开 `http://localhost:3000/code/`,自动跳转到 Setup 页面\n2. 填写表单:\n - **API Key**:必须与 RCS 启动时设置的 `RCS_API_KEYS` 中的某个 key 完全一致\n - **用户名**:登录用,后续不可改\n - **密码**:至少 8 位\n - **确认密码**\n3. 提交后第一个用户即成为 admin,进入管理面板\n\n后续访问的用户分两种:\n\n- **自注册**:如果 `RCS_ALLOW_REGISTRATION` 未设为 `false`(默认开放),新访问者可在登录页注册账户(用户名 + 密码)。密码以 argon2id 加密存储,登录有速率限制(5 次失败后锁定 5 分钟)。\n- **邀请制**:将 `RCS_ALLOW_REGISTRATION=false` 后,只有管理员预先创建的账户或通过团队邀请链接加入的用户能登录。\n\n管理员 API Key 拥有系统级权限,可直接访问所有 API(不通过 Web UI 登录流程)。\n\n登录后浏览器会保存 session cookie(`rcs_access`),后续请求自动认证。\n\n### 团队与角色\n\nRCS 用「团队」组织成员、环境和会话。每个登录用户都有一个「个人空间」(无需创建),可被加入一个或多个团队。\n\n**系统级角色**(`users.role`):\n\n| 角色 | 能力 |\n|------|------|\n| `admin` | 看到所有会话(含无主孤儿)、管理所有团队、转移任意环境;通常由 Setup 流程产生 |\n| 普通用户 | 仅看到自己拥有的、所属团队可见的、显式共享给自己的会话 |\n| `guest` | 不能创建团队;通常对应被降级的账户 |\n\n**团队级角色**(`team_members.role`):\n\n| 角色 | 团队内能力 |\n|------|-----------|\n| `owner` | 修改团队信息、删除团队、加/减成员、改成员角色、创建/撤销邀请、转移或解绑环境 |\n| `admin` | 加成员、创建/撤销邀请,但不能改 owner/admin 的角色,也不能删团队 |\n| `member` | 只能自退团队,看不到团队级管理按钮 |\n\n团队至少要保留一个 owner — 系统禁止降级或移除最后一个 owner。系统 admin 在任何团队中都视为 owner。\n\n**邀请加入**:团队 owner/admin 可在「团队详情 → 邀请」页面创建邀请链接,链接形如 `/join/<inv_xxx>`,可设置:\n\n- 角色:新成员加入后的角色(仅 `admin` 或 `member`,不能邀请为 owner)\n- 过期时间(默认 24 小时)\n- 最大使用次数(默认 1)\n\n也可以「添加已有用户」:通过用户名或用户 ID 搜索已注册账户,直接加入团队。\n\n### 环境管理\n\n「环境」(environment)是 worker 向 RCS 注册后产生的实体,代表一台正在提供 agent 服务的工作机。每个环境有:\n\n- 拥有者(owner_user_id,可能为空 → 需要认领)\n- 关联团队(可选,关联后团队内成员可见该环境及其会话)\n- worker 类型(slz CLI / ACP agent)、容量、心跳\n\n**环境的归属**:\n\n- 启动 worker 时通过 `--user-id` / `--team-id` 指定 → 直接归属到该用户或团队\n- 未指定且使用共享 API Key → 生成 `claim_token`,进入待认领状态(见下文 claim 机制)\n\n**环境与团队的关联**:\n\n- 在「团队详情 → 环境」页面可把个人环境链接到团队,或把团队环境解绑回个人\n- 环境可在团队之间转移(需要源团队和目标团队的 owner/admin 权限)\n- 转移环境时,该环境下的所有会话归属随之转移到目标团队\n\n### Claim 机制(环境认领)\n\n当 worker 使用共享 API Key 启动、且未指定 `--user-id` / `--team-id` 时,RCS 不会把环境直接归属给任何人,而是生成一个 `claim_token`(形如 `clm_xxxxxxxx`)并打印认领 URL:\n\n```\n/code/claim/clm_xxxxxxxx\n```\n\n**认领流程**:\n\n1. worker 启动后在终端看到认领 URL\n2. 把这个 URL 发给任意已登录用户\n3. 该用户在浏览器打开 URL → 自动调用 `/environments/claim` 接口\n4. 该环境的 `owner_user_id` 写入此用户,`claim_token` 清空\n5. 该环境下已经创建的会话也会一并 backfill 到该用户名下(否则会成为无主孤儿会话)\n\n`claim_token` 有过期时间(`claim_expires_at`),过期后无法认领。已被认领的环境再次访问会返回 409。\n\n这个机制让团队成员用共享 API Key 启动 worker 后,再由具体的人认领,避免环境长期处于无主状态。\n\n### 会话可见域\n\n每个会话有 `visibility` 字段,控制谁能看到它:\n\n| 可见域 | 谁能看到 |\n|--------|---------|\n| `private` | 仅会话的 user owner |\n| `team` | 会话所属团队的所有成员 |\n| `public` | 所有登录用户 |\n\n实际的可见规则综合考虑了 ownership、visibility 和显式共享:\n\n1. 系统 admin 能看到所有会话(含无主孤儿会话)\n2. 用户作为 user owner 拥有的会话\n3. 用户所属团队作为 team owner 拥有、且 visibility 为 `team` 或 `public` 的会话\n4. 通过 `session_shares` 显式共享给该用户的会话(未过期)\n5. 通过 `session_shares` 显式共享给该用户所属团队的会话(未过期)\n6. visibility=`public` 的会话\n7. 无主孤儿会话:仅 admin 可见\n\n**会话转移**:会话 owner(或团队 admin)可把会话从个人空间转到团队(visibility 自动变 `team`),或从团队转回个人(visibility 自动变 `private`)。转移时需要目标是该团队的 owner/admin。\n\n**会话分享**:会话 owner 可生成分享链接,授予指定用户或团队「只读」或「读写」权限,可设置过期时间。被分享者会在自己的会话列表里看到该会话。\n\n### 权限审批\n\nRCS Web UI 在 agent 请求工具调用时弹出审批面板。权限模式(permissionMode)有 6 种,决定 agent 是否需要等待人工确认:\n\n| 模式 | 行为 |\n|------|------|\n| `default` | 每次工具调用都请求确认 |\n| `auto` | agent 自动判断是否需要确认 |\n| `acceptEdits` | 自动接受文件编辑,其他工具仍需确认 |\n| `plan` | 规划模式,仅制定计划不执行 |\n| `dontAsk` | 不询问,直接执行 |\n| `bypassPermissions` | 绕过所有权限检查(仅 sandbox 环境可用,非 root) |\n\n权限模式可在创建会话时指定,也可在会话进行中切换。fallback 顺序:客户端传值 > acp-link 启动时的 `ACP_PERMISSION_MODE` 环境变量。\n\n**三种审批面板**:\n\n- **工具调用审批**:显示工具名、参数和描述,提供 Approve / Reject 按钮\n- **多问题面板**(AskUserQuestion):agent 一次提多个问题,用户在标签页中切换回答,每题可选预设选项或填写「Other」自定义文本\n- **计划审批**:显示 plan 内容,提供「Yes, auto-accept edits」「Yes, manually approve edits」「No, keep planning」三个选项,选 No 时可附反馈让 agent 重新规划\n\n### Worker 状态\n\nWeb UI 显示所有已连接的 worker(包括 slz CLI worker 和 acp-link agent):\n\n- **在线状态**:worker 当前是否可接受会话\n- **最大并发**:worker 配置的 `--capacity`\n- **最后活动时间**:最近一次心跳\n\n## RCS 服务器配置\n\n| 环境变量 | 默认 | 说明 |\n|---------|------|------|\n| `RCS_PORT` | 3000 | HTTP 端口 |\n| `RCS_HOST` | 0.0.0.0 | 监听地址 |\n| `RCS_API_KEYS` | — | 逗号分隔的 API Key(管理员权限,也是 worker 连接 token) |\n| `RCS_ALLOW_REGISTRATION` | true | 是否允许开放注册(设为 false 改为邀请制) |\n| `RCS_BASE_URL` | — | 外部访问 URL(反代时设置) |\n| `RCS_DB_PATH` | — | SQLite 数据库路径(默认内存,生产环境建议持久化) |\n| `RCS_WEB_CORS_ORIGINS` | — | Web UI CORS 允许的源(逗号分隔) |\n| `RCS_JWT_EXPIRES_IN` | 3600 | JWT 有效期(秒) |\n| `RCS_DISCONNECT_TIMEOUT` | 300 | 断开连接超时(秒) |\n| `RCS_WS_CLIENT_INACTIVITY_TIMEOUT` | 300 | WebSocket 客户端无活动超时(秒) |\n\n## Worker 接入\n\nWorker 是连接到 RCS 的 Saluzi CLI 实例,执行来自 Web UI 或其他客户端的会话。\n\n### 前置:设置环境变量\n\n**所有 worker 启动方式都需要先设置以下两个环境变量**:\n\n```bash\nexport SALUZI_BRIDGE_BASE_URL=http://rcs-host:3000\nexport SALUZI_BRIDGE_OAUTH_TOKEN=sk-your-key\n```\n\n- `SALUZI_BRIDGE_BASE_URL`:RCS 服务器地址\n- `SALUZI_BRIDGE_OAUTH_TOKEN`:必须与 RCS 启动时设置的 `RCS_API_KEYS` 中的某个 key 一致\n\n两个变量必须**同时设置**才生效。只设置一个会进入\"部分配置\"状态,启动时会提示补全。\n\n可选环境变量(用于归属和团队关联):\n\n| 环境变量 | 说明 |\n|---------|------|\n| `SALUZI_BRIDGE_USERNAME` | 归属用户名(发送为 `X-Username` 头,RCS 自动认领 env 到该用户) |\n| `SALUZI_BRIDGE_USER_ID` | 归属用户 ID(绕过自动认领,直接绑定到该用户) |\n| `SALUZI_BRIDGE_TEAM_ID` | 关联团队 ID(env 注册到指定团队) |\n| `SALUZI_ENVIRONMENT_KIND` | 设为 `bridge` 标记会话来源为 remote-control |\n| `SALUZI_USE_CCR_V2` | 启用 CCR v2 传输协议 |\n| `SALUZI_BRIDGE_ALLOW_INSECURE_HTTP` | 设为 `1` 允许非 localhost 的 HTTP 连接(自托管内网场景,见下文) |\n\n**关于 HTTP 连接**:默认情况下,`SALUZI_BRIDGE_BASE_URL` 如果是 `http://` 且不是 `localhost`/`127.0.0.1`,worker 会拒绝启动——这是为了防止 credentials 明文传输。如果远程 RCS 部署在可信内网(例如 TLS 由上游反代终止、或网络已加密),可设置 `SALUZI_BRIDGE_ALLOW_INSECURE_HTTP=1` 放开此限制。生产环境建议优先用 HTTPS 或 SSH 隧道转发到 localhost。\n\n如果不设置 `SALUZI_BRIDGE_USERNAME`/`SALUZI_BRIDGE_USER_ID`/`SALUZI_BRIDGE_TEAM_ID`,且 token 是共享的管理员 API Key,RCS 会生成 `claim_token` 并打印认领 URL,worker 终端会显示该 URL 供用户认领(详见上文「Claim 机制」)。\n\n### 启动方式\n\n设置好环境变量后,推荐直接运行:\n\n```bash\nslz rc\n```\n\n`slz rc` 是最简的启动方式,默认配置即可作为 worker 连接到 RCS。它是 `slz remote-control` 的简写,也接受 `slz remote`、`slz sync`、`slz bridge` 作为别名。\n\n其他可选方式:\n\n```bash\n# 交互式会话 + worker(既可本地用,也接受远程请求)\nslz --remote-control\n\n# 普通会话自动连接(设置好环境变量后直接运行)\nslz\n```\n\n### 高级参数\n\n需要调整 worker 行为时,`slz rc` 支持以下参数:\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| `--spawn <mode>` | Spawn 模式:`same-dir`、`worktree`、`session` | `--spawn=worktree` |\n| `--capacity <N>` | 最大并发会话数(仅 worktree/session 模式) | `--capacity=5` |\n| `--create-session-in-dir` | 启动时在当前目录预创建会话(默认开启) | `--no-create-session-in-dir` 禁用 |\n| `--session-id <id>` | 恢复指定会话 | `--session-id=abc123` |\n| `--continue` | 恢复最近会话 | — |\n| `--name <name>` | 会话名称(也用于 RCS 显示) | `--name=\"我的会话\"` |\n| `--username <name>` | 归属用户名(对应 `SALUZI_BRIDGE_USERNAME`) | `--username=alice` |\n| `--user-id <id>` | 归属用户 ID(对应 `SALUZI_BRIDGE_USER_ID`) | `--user-id=u-123` |\n| `--team-id <id>` | 关联团队 ID(对应 `SALUZI_BRIDGE_TEAM_ID`) | `--team-id=team-abc` |\n\n### Spawn 模式\n\n| 模式 | 说明 | 适用场景 |\n|------|------|---------|\n| `same-dir`(默认) | 所有会话在同一工作目录创建 | 单项目快速响应 |\n| `worktree` | 每个会话在独立 git worktree 中创建 | 多项目隔离,避免文件冲突 |\n| `session` | 单会话模式(容量固定为 1) | 简单场景,不需要并发 |\n\n## Worker 与 RCS 的关系\n\n```\n┌─────────────────┐\n│ RCS Server │ ← 运行 slz rcs\n│ (Web UI + API) │\n└────────┬────────┘\n │ Bridge 协议\n │\n ┌────┴────┐\n │ │\n┌───▼──┐ ┌──▼───┐\n│Worker│ │Worker│ ← slz rc / slz --remote-control / slz\n│ 1 │ │ 2 │\n└──────┘ └──────┘\n```\n\n- **RCS**:中央服务器,管理会话、用户、权限\n- **Worker**:通过 bridge 协议连接,从 RCS 获取任务,汇报状态\n- **Web UI**:通过浏览器访问 RCS,创建/查看会话\n\n## ACP 协议\n\nACP(Agent Control Protocol)让**外部 agent**(非 slz CLI,如 Claude Code、其他 ACP 兼容 agent)接入 RCS 的会话系统。slz CLI 自身使用 bridge 协议,不走 ACP。\n\n`acp-link` 是 ACP 桥接工具,随 `@saluzi/saluzi-edu` 一起安装,无需单独安装。\n\n### 连接 slz 到 RCS\n\n如果要让 slz CLI 作为 ACP agent 接入 RCS(而非 bridge worker),使用 `acp-link` 桥接:\n\n#### 1. 设置环境变量\n\n```bash\nexport ACP_RCS_URL=http://rcs-host:3000\nexport ACP_RCS_TOKEN=sk-your-key\n```\n\n- `ACP_RCS_URL`:RCS 服务器地址\n- `ACP_RCS_TOKEN`:必须与 RCS 的 `RCS_API_KEYS` 中的某个 key 一致\n\n可选环境变量:\n\n| 环境变量 | 说明 |\n|---------|------|\n| `ACP_RCS_GROUP` | Channel group ID(字母、数字、下划线、连字符) |\n| `ACP_RCS_USERNAME` | 归属用户名(自动认领 env 到该用户) |\n| `ACP_RCS_USER_ID` | 归属用户 ID(绕过自动认领) |\n| `ACP_RCS_TEAM_ID` | 关联团队 ID |\n| `ACP_AUTH_TOKEN` | 本地 WS 认证 token(不设则自动生成) |\n| `ACP_PERMISSION_MODE` | 默认权限模式 |\n\n#### 2. 启动 acp-link\n\n```bash\nacp-link slz -- --acp\n```\n\n`acp-link` 会启动 slz 作为子进程,通过 ACP 协议代理它与 RCS 之间的通信。slz 会出现在 RCS Web UI 的 agent 列表中,可接受会话请求。\n\n`--` 之后是传递给 slz 的参数(`--acp` 让 slz 进入 ACP 兼容模式)。\n\n### 连接 Claude Code 到 RCS\n\n`acp-link` 支持任何遵循 ACP 协议的 agent。Claude Code 通过专用的 ACP 适配包 `@agentclientprotocol/claude-agent-acp` 接入,接入命令是 `acp-link claude-agent-acp`(**不是** `acp-link claude`,因为 Claude Code 本身不直接说 ACP 协议,需要先装适配包)。\n\n#### 1. 安装 claude-agent-acp\n\nClaude Code 的 ACP 适配包需要单独安装:\n\n```bash\nnpm install -g @agentclientprotocol/claude-agent-acp\n```\n\n安装后会注册 `claude-agent-acp` 命令。\n\n#### 2. 设置环境变量\n\n```bash\nexport ACP_RCS_URL=http://rcs-host:3000\nexport ACP_RCS_TOKEN=sk-your-key\n```\n\n#### 3. 启动 acp-link 桥接\n\n```bash\nacp-link claude-agent-acp\n```\n\n`acp-link` 的第一个参数是 agent 的可执行命令名(这里是 `claude-agent-acp`)。`claude-agent-acp` 本身不需要额外参数,因此不需要 `--`。\n\n连接成功后,Claude Code 会作为 ACP agent 出现在 RCS Web UI 中,与 slz agent 并列,团队成员可在 Web UI 中选择它创建会话。\n\n其他 ACP 兼容 agent 的接入方式类似:安装对应的 ACP 适配包,然后用 `acp-link <命令名>` 启动。可在 npm 官网搜索 `@agentclientprotocol/*` 查找已适配的 agent。\n\n## 团队协作场景\n\n### 共享会话\n\n在 RCS Web UI 中创建会话,分享链接给队友(需登录才能查看),他们可查看或加入对话。也可通过 `session_shares` 显式授予指定用户或团队「只读」/「读写」权限,并设置过期时间。\n\n### 多 Worker 协作\n\n团队多个成员各自启动 worker,连接到同一 RCS:\n\n```bash\n# 成员 A:默认配置\nslz rc\n\n# 成员 B:worktree 隔离,5 并发\nslz rc --spawn=worktree --capacity=5\n```\n\nWeb UI 显示所有 worker 状态,会话与权限集中管理。\n\n### 外部 Agent 接入\n\n用 ACP 让非 slz 的 agent 接入 RCS。Claude Code 通过 `claude-agent-acp` 适配包接入:\n\n```bash\n# 先装适配包(仅一次)\nnpm install -g @agentclientprotocol/claude-agent-acp\n\n# 设置 RCS 连接\nexport ACP_RCS_URL=http://rcs-host:3000\nexport ACP_RCS_TOKEN=sk-your-key\n\n# 启动桥接\nacp-link claude-agent-acp\n```\n\n接入后所有 agent 在 Web UI 中统一管理,团队成员可选择任意 agent 创建会话。\n\n## 安全建议\n\n- RCS 默认监听 0.0.0.0,生产环境建议用反代 + HTTPS\n- 用强 API Key,定期轮换\n- 生产环境关闭 `RCS_ALLOW_REGISTRATION` 改为邀请制\n- 使用 `RCS_WEB_CORS_ORIGINS` 限制 Web UI 访问来源\n- 设置 `RCS_DB_PATH` 持久化 SQLite 数据库\n- 限制 worker 的权限(`/permissions` 配置)\n- `bypassPermissions` 模式仅在 sandbox 环境中启用,避免在主机直接放行所有工具调用\n\n## 故障排查\n\n| 问题 | 排查 |\n|------|------|\n| Worker 无法连接 | 检查 `SALUZI_BRIDGE_BASE_URL` 和 `SALUZI_BRIDGE_OAUTH_TOKEN` 是否同时设置;确认 token 与 RCS 的 `RCS_API_KEYS` 匹配 |\n| `Only HTTPS or localhost HTTP is allowed` | 远程 RCS 用 HTTP 被拒。优先用 HTTPS;或 SSH 隧道转发到 localhost;可信内网可设 `SALUZI_BRIDGE_ALLOW_INSECURE_HTTP=1` |\n| Web UI 登录失败 | 检查用户名密码;5 次失败后锁定 5 分钟 |\n| Web UI 401 | 确认使用 `RCS_API_KEYS` 中的 key 或有效的 session token |\n| 看不到某个会话 | 检查会话 visibility(private/team/public);确认是否在所属团队的成员列表里;admin 可看所有 |\n| 环境显示「待认领」 | worker 没指定 `--user-id`/`--team-id`,找到终端里的 `/code/claim/clm_xxx` URL,已登录用户打开即可认领 |\n| acp-link 无法连接 RCS | 检查 `ACP_RCS_URL` 和 `ACP_RCS_TOKEN` 是否设置 |\n| Agent 不出现在 Web UI | 确认 acp-link 已启动且 `ACP_RCS_TOKEN` 与 `RCS_API_KEYS` 匹配 |\n| 邀请链接失效 | 邀请 token 可能过期或达到 max_uses 上限;让团队 owner/admin 重新创建 |\n| 会话超时 | 调整 `RCS_DISCONNECT_TIMEOUT` 和 `RCS_WS_CLIENT_INACTIVITY_TIMEOUT` |\n"
|
|
7363
|
+
"content": "\n## Remote Control Server (RCS)\n\nRCS 是 Saluzi 的自托管远程控制服务器,提供 Web UI 和会话管理。启动后,团队成员通过浏览器访问 Web UI,登录后即可创建会话、查看 worker 状态、与 agent 交互。\n\n## 启动 RCS\n\n```bash\n# 设置 API Key(管理员密码,也是 worker 连接 token)\nexport RCS_API_KEYS=sk-your-key\n\n# 启动(在 Saluzi CLI 中运行)\n> /rcs\n```\n\n也可通过 CLI 子命令直接启动:\n\n```bash\nslz rcs\n```\n\n默认端口 3000,Web UI 在 `http://localhost:3000/code/`。\n\n## RCS Web UI 使用\n\nWeb UI 是团队成员日常使用的控制面板:登录后可创建会话、查看 worker、审批权限、管理团队与环境。下面按首次部署到日常使用的顺序介绍。\n\n### 管理员初始化(首次访问)\n\n第一次打开 Web UI 时,系统没有任何用户。第一个登录的账号会成为系统管理员(role=admin),流程如下:\n\n1. 浏览器打开 `http://localhost:3000/code/`,自动跳转到 Setup 页面\n2. 填写表单:\n - **API Key**:必须与 RCS 启动时设置的 `RCS_API_KEYS` 中的某个 key 完全一致\n - **用户名**:登录用,后续不可改\n - **密码**:至少 8 位\n - **确认密码**\n3. 提交后第一个用户即成为 admin,进入管理面板\n\n后续访问的用户分两种:\n\n- **自注册**:如果 `RCS_ALLOW_REGISTRATION` 未设为 `false`(默认开放),新访问者可在登录页注册账户(用户名 + 密码)。密码以 argon2id 加密存储,登录有速率限制(5 次失败后锁定 5 分钟)。\n- **邀请制**:将 `RCS_ALLOW_REGISTRATION=false` 后,只有管理员预先创建的账户或通过团队邀请链接加入的用户能登录。\n\n管理员 API Key 拥有系统级权限,可直接访问所有 API(不通过 Web UI 登录流程)。\n\n登录后浏览器会保存 session cookie(`rcs_access`),后续请求自动认证。\n\n### 团队与角色\n\nRCS 用「团队」组织成员、环境和会话。每个登录用户都有一个「个人空间」(无需创建),可被加入一个或多个团队。\n\n**系统级角色**(`users.role`):\n\n| 角色 | 能力 |\n|------|------|\n| `admin` | 看到所有会话(含无主孤儿)、管理所有团队、转移任意环境;通常由 Setup 流程产生 |\n| 普通用户 | 仅看到自己拥有的、所属团队可见的、显式共享给自己的会话 |\n| `guest` | 不能创建团队;通常对应被降级的账户 |\n\n**团队级角色**(`team_members.role`):\n\n| 角色 | 团队内能力 |\n|------|-----------|\n| `owner` | 修改团队信息、删除团队、加/减成员、改成员角色、创建/撤销邀请、转移或解绑环境 |\n| `admin` | 加成员、创建/撤销邀请,但不能改 owner/admin 的角色,也不能删团队 |\n| `member` | 只能自退团队,看不到团队级管理按钮 |\n\n团队至少要保留一个 owner — 系统禁止降级或移除最后一个 owner。系统 admin 在任何团队中都视为 owner。\n\n**邀请加入**:团队 owner/admin 可在「团队详情 → 邀请」页面创建邀请链接,链接形如 `/join/<inv_xxx>`,可设置:\n\n- 角色:新成员加入后的角色(仅 `admin` 或 `member`,不能邀请为 owner)\n- 过期时间(默认 24 小时)\n- 最大使用次数(默认 1)\n\n也可以「添加已有用户」:通过用户名或用户 ID 搜索已注册账户,直接加入团队。\n\n### 环境管理\n\n「环境」(environment)是 worker 向 RCS 注册后产生的实体,代表一台正在提供 agent 服务的工作机。每个环境有:\n\n- 拥有者(owner_user_id,可能为空 → 需要认领)\n- 关联团队(可选,关联后团队内成员可见该环境及其会话)\n- worker 类型(slz CLI / ACP agent)、容量、心跳\n\n**环境的归属**:\n\n- 启动 worker 时通过 `--user-id` / `--team-id` 指定 → 直接归属到该用户或团队\n- 未指定且使用共享 API Key → 生成 `claim_token`,进入待认领状态(见下文 claim 机制)\n\n**环境与团队的关联**:\n\n- 在「团队详情 → 环境」页面可把个人环境链接到团队,或把团队环境解绑回个人\n- 环境可在团队之间转移(需要源团队和目标团队的 owner/admin 权限)\n- 转移环境时,该环境下的所有会话归属随之转移到目标团队\n\n### Claim 机制(环境认领)\n\n当 worker 使用共享 API Key 启动、且未指定 `--user-id` / `--team-id` 时,RCS 不会把环境直接归属给任何人,而是生成一个 `claim_token`(形如 `clm_xxxxxxxx`)并打印认领 URL:\n\n```\n/code/claim/clm_xxxxxxxx\n```\n\n**认领流程**:\n\n1. worker 启动后在终端看到认领 URL\n2. 把这个 URL 发给任意已登录用户\n3. 该用户在浏览器打开 URL → 自动调用 `/environments/claim` 接口\n4. 该环境的 `owner_user_id` 写入此用户,`claim_token` 清空\n5. 该环境下已经创建的会话也会一并 backfill 到该用户名下(否则会成为无主孤儿会话)\n\n`claim_token` 有过期时间(`claim_expires_at`),过期后无法认领。已被认领的环境再次访问会返回 409。\n\n这个机制让团队成员用共享 API Key 启动 worker 后,再由具体的人认领,避免环境长期处于无主状态。\n\n### 会话可见域\n\n每个会话有 `visibility` 字段,控制谁能看到它:\n\n| 可见域 | 谁能看到 |\n|--------|---------|\n| `private` | 仅会话的 user owner |\n| `team` | 会话所属团队的所有成员 |\n| `public` | 所有登录用户 |\n\n实际的可见规则综合考虑了 ownership、visibility 和显式共享:\n\n1. 系统 admin 能看到所有会话(含无主孤儿会话)\n2. 用户作为 user owner 拥有的会话\n3. 用户所属团队作为 team owner 拥有、且 visibility 为 `team` 或 `public` 的会话\n4. 通过 `session_shares` 显式共享给该用户的会话(未过期)\n5. 通过 `session_shares` 显式共享给该用户所属团队的会话(未过期)\n6. visibility=`public` 的会话\n7. 无主孤儿会话:仅 admin 可见\n\n**会话转移**:会话 owner(或团队 admin)可把会话从个人空间转到团队(visibility 自动变 `team`),或从团队转回个人(visibility 自动变 `private`)。转移时需要目标是该团队的 owner/admin。\n\n**会话分享**:会话 owner 可生成分享链接,授予指定用户或团队「只读」或「读写」权限,可设置过期时间。被分享者会在自己的会话列表里看到该会话。\n\n### 权限审批\n\nRCS Web UI 在 agent 请求工具调用时弹出审批面板。权限模式(permissionMode)有 6 种,决定 agent 是否需要等待人工确认:\n\n| 模式 | 行为 |\n|------|------|\n| `default` | 每次工具调用都请求确认 |\n| `auto` | agent 自动判断是否需要确认 |\n| `acceptEdits` | 自动接受文件编辑,其他工具仍需确认 |\n| `plan` | 规划模式,仅制定计划不执行 |\n| `dontAsk` | 不询问,直接执行 |\n| `bypassPermissions` | 绕过所有权限检查(仅 sandbox 环境可用,非 root) |\n\n权限模式可在创建会话时指定,也可在会话进行中切换。fallback 顺序:客户端传值 > acp-link 启动时的 `ACP_PERMISSION_MODE` 环境变量。\n\n**三种审批面板**:\n\n- **工具调用审批**:显示工具名、参数和描述,提供 Approve / Reject 按钮\n- **多问题面板**(AskUserQuestion):agent 一次提多个问题,用户在标签页中切换回答,每题可选预设选项或填写「Other」自定义文本\n- **计划审批**:显示 plan 内容,提供「Yes, auto-accept edits」「Yes, manually approve edits」「No, keep planning」三个选项,选 No 时可附反馈让 agent 重新规划\n\n### Worker 状态\n\nWeb UI 显示所有已连接的 worker(包括 slz CLI worker 和 acp-link agent):\n\n- **在线状态**:worker 当前是否可接受会话\n- **最大并发**:worker 配置的 `--capacity`\n- **最后活动时间**:最近一次心跳\n\n## RCS 服务器配置\n\n| 环境变量 | 默认 | 说明 |\n|---------|------|------|\n| `RCS_PORT` | 3000 | HTTP 端口 |\n| `RCS_HOST` | 0.0.0.0 | 监听地址 |\n| `RCS_API_KEYS` | — | 逗号分隔的 API Key(管理员权限,也是 worker 连接 token) |\n| `RCS_ALLOW_REGISTRATION` | true | 是否允许开放注册(设为 false 改为邀请制) |\n| `RCS_BASE_URL` | — | 外部访问 URL(反代时设置) |\n| `RCS_DB_PATH` | — | SQLite 数据库路径(默认内存,生产环境建议持久化) |\n| `RCS_WEB_CORS_ORIGINS` | — | Web UI CORS 允许的源(逗号分隔) |\n| `RCS_JWT_EXPIRES_IN` | 3600 | JWT 有效期(秒) |\n| `RCS_DISCONNECT_TIMEOUT` | 300 | 断开连接超时(秒) |\n| `RCS_WS_CLIENT_INACTIVITY_TIMEOUT` | 300 | WebSocket 客户端无活动超时(秒) |\n\n## Worker 接入\n\nWorker 是连接到 RCS 的 Saluzi CLI 实例,执行来自 Web UI 或其他客户端的会话。\n\n### 前置:设置环境变量\n\n**所有 worker 启动方式都需要先设置以下两个环境变量**:\n\n```bash\nexport SALUZI_BRIDGE_BASE_URL=http://rcs-host:3000\nexport SALUZI_BRIDGE_OAUTH_TOKEN=sk-your-key\n```\n\n- `SALUZI_BRIDGE_BASE_URL`:RCS 服务器地址\n- `SALUZI_BRIDGE_OAUTH_TOKEN`:必须与 RCS 启动时设置的 `RCS_API_KEYS` 中的某个 key 一致\n\n两个变量必须**同时设置**才生效。只设置一个会进入\"部分配置\"状态,启动时会提示补全。\n\n可选环境变量(用于归属和团队关联):\n\n| 环境变量 | 说明 |\n|---------|------|\n| `SALUZI_BRIDGE_USERNAME` | 归属用户名(发送为 `X-Username` 头,RCS 自动认领 env 到该用户) |\n| `SALUZI_BRIDGE_USER_ID` | 归属用户 ID(绕过自动认领,直接绑定到该用户) |\n| `SALUZI_BRIDGE_TEAM_ID` | 关联团队 ID(env 注册到指定团队) |\n| `SALUZI_ENVIRONMENT_KIND` | 设为 `bridge` 标记会话来源为 remote-control |\n| `SALUZI_USE_CCR_V2` | 启用 CCR v2 传输协议 |\n| `SALUZI_BRIDGE_ALLOW_INSECURE_HTTP` | 设为 `1` 允许非 localhost 的 HTTP 连接(自托管内网场景,见下文) |\n| `SALUZI_BRIDGE_AUTO_CONNECT` | 设为 `1` 启用启动时自动连接 RCS(默认关闭;未设置时需在 CLI 内手动运行 `/rc` 或使用 `slz rc` 启动) |\n\n**关于 HTTP 连接**:默认情况下,`SALUZI_BRIDGE_BASE_URL` 如果是 `http://` 且不是 `localhost`/`127.0.0.1`,worker 会拒绝启动——这是为了防止 credentials 明文传输。如果远程 RCS 部署在可信内网(例如 TLS 由上游反代终止、或网络已加密),可设置 `SALUZI_BRIDGE_ALLOW_INSECURE_HTTP=1` 放开此限制。生产环境建议优先用 HTTPS 或 SSH 隧道转发到 localhost。\n\n如果不设置 `SALUZI_BRIDGE_USERNAME`/`SALUZI_BRIDGE_USER_ID`/`SALUZI_BRIDGE_TEAM_ID`,且 token 是共享的管理员 API Key,RCS 会生成 `claim_token` 并打印认领 URL,worker 终端会显示该 URL 供用户认领(详见上文「Claim 机制」)。\n\n### 启动方式\n\n设置好环境变量后,推荐直接运行:\n\n```bash\nslz rc\n```\n\n`slz rc` 是最简的启动方式,默认配置即可作为 worker 连接到 RCS。它是 `slz remote-control` 的简写,也接受 `slz remote`、`slz sync`、`slz bridge` 作为别名。\n\n其他可选方式:\n\n```bash\n# 交互式会话 + worker(既可本地用,也接受远程请求)\nslz --remote-control\n\n# 普通会话自动连接(需额外设置 SALUZI_BRIDGE_AUTO_CONNECT=1,否则普通会话不自动连接)\nSALUZI_BRIDGE_AUTO_CONNECT=1 slz\n```\n\n### 高级参数\n\n需要调整 worker 行为时,`slz rc` 支持以下参数:\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| `--spawn <mode>` | Spawn 模式:`same-dir`、`worktree`、`session` | `--spawn=worktree` |\n| `--capacity <N>` | 最大并发会话数(仅 worktree/session 模式) | `--capacity=5` |\n| `--create-session-in-dir` | 启动时在当前目录预创建会话(默认开启) | `--no-create-session-in-dir` 禁用 |\n| `--session-id <id>` | 恢复指定会话 | `--session-id=abc123` |\n| `--continue` | 恢复最近会话 | — |\n| `--name <name>` | 会话名称(也用于 RCS 显示) | `--name=\"我的会话\"` |\n| `--username <name>` | 归属用户名(对应 `SALUZI_BRIDGE_USERNAME`) | `--username=alice` |\n| `--user-id <id>` | 归属用户 ID(对应 `SALUZI_BRIDGE_USER_ID`) | `--user-id=u-123` |\n| `--team-id <id>` | 关联团队 ID(对应 `SALUZI_BRIDGE_TEAM_ID`) | `--team-id=team-abc` |\n\n### Spawn 模式\n\n| 模式 | 说明 | 适用场景 |\n|------|------|---------|\n| `same-dir`(默认) | 所有会话在同一工作目录创建 | 单项目快速响应 |\n| `worktree` | 每个会话在独立 git worktree 中创建 | 多项目隔离,避免文件冲突 |\n| `session` | 单会话模式(容量固定为 1) | 简单场景,不需要并发 |\n\n## 会话接入(Attach)\n\n默认情况下,`/remote-control` 会为当前终端**新建**一个远程会话。Attach 模式改变这一行为:不新建会话,而是把一个**已经存在**的 RCS 会话接入当前终端,在本地继续这段对话,Web UI 上同步可见。\n\n适合场景:会话是在 Web UI 上创建的、或由其他终端发起,想换到自己的终端里继续;团队协作中接手队友的会话;或者把多台机器上的工作收拢到一个终端。\n\n### 三种接入方式\n\n| 方式 | 命令 | 行为 |\n|------|------|------|\n| 指定会话 | `/rc --attach <会话ID>` | 直接接入指定会话 |\n| 交互式选择 | `/rc --attach` | 打开会话选择器:模糊搜索列表(标题 — 状态 (会话ID)),回车接入,Esc 取消 |\n| 等待接入 | `/rc --wait`(或 `/rc --attach --wait`) | 注册后待命,等待 Web UI 侧把会话接到这台终端 |\n\n选择器里只会列出**你有权限管理**的会话;已结束、正被占用的会话和 ACP agent 的会话不会出现。\n\n**等待接入**时,终端会显示提示并持续待命。此时在 RCS Web UI 中把会话绑定到这个 worker(例如新建会话时在环境中选择该 worker),接入立即完成;若该环境还没有归属,终端会同时给出认领 URL,先认领才能接入。\n\n### 接入后发生什么\n\n- 该会话的既有对话历史会合并进本地终端(本地已有内容时保留在后面,并有提示行说明合并了多少条)\n- 之后终端与 Web UI 实时共享同一个会话:任意一端发送消息、发起审批,另一端都同步可见\n- 历史拉取失败时接入会中止并报错——不会出现「半接入」状态\n\n### 启动时自动接入(环境变量)\n\n除在会话内执行 `/rc` 命令外,也可以在启动 CLI 时通过环境变量直接进入接入模式:\n\n| 环境变量 | 说明 |\n|---------|------|\n| `SALUZI_BRIDGE_SESSION_ID` | 启动时直接接入指定会话(等效 `/rc --attach <会话ID>`) |\n| `SALUZI_BRIDGE_SESSION_MODE` | 设为 `attach`:启动后进入等待接入状态 |\n| `SALUZI_BRIDGE_ATTACH_TIMEOUT_MS` | 等待接入的超时时间(毫秒,默认 24 小时) |\n\n```bash\n# 启动即接入指定会话\nexport SALUZI_BRIDGE_SESSION_ID=sess-abc123\nslz\n\n# 或启动后等待 Web UI 分配会话\nexport SALUZI_BRIDGE_SESSION_MODE=attach\nslz\n```\n\n### 已连接时切换绑定\n\n已处于远程控制连接状态时,再次执行 `/rc --attach …`、`/rc --wait`(或带 `--team-id` 等归属参数)会弹出确认框:确认后断开当前远程会话,按新的目标重新绑定;取消则保持现状。\n\n## Worker 与 RCS 的关系\n\n```\n┌─────────────────┐\n│ RCS Server │ ← 运行 slz rcs\n│ (Web UI + API) │\n└────────┬────────┘\n │ Bridge 协议\n │\n ┌────┴────┐\n │ │\n┌───▼──┐ ┌──▼───┐\n│Worker│ │Worker│ ← slz rc / slz --remote-control / slz\n│ 1 │ │ 2 │\n└──────┘ └──────┘\n```\n\n- **RCS**:中央服务器,管理会话、用户、权限\n- **Worker**:通过 bridge 协议连接,从 RCS 获取任务,汇报状态\n- **Web UI**:通过浏览器访问 RCS,创建/查看会话\n\n## ACP 协议\n\nACP(Agent Control Protocol)让**外部 agent**(非 slz CLI,如 Claude Code、其他 ACP 兼容 agent)接入 RCS 的会话系统。slz CLI 自身使用 bridge 协议,不走 ACP。\n\n`acp-link` 是 ACP 桥接工具,随 `@saluzi/saluzi-edu` 一起安装,无需单独安装。\n\n### 连接 slz 到 RCS\n\n如果要让 slz CLI 作为 ACP agent 接入 RCS(而非 bridge worker),使用 `acp-link` 桥接:\n\n#### 1. 设置环境变量\n\n```bash\nexport ACP_RCS_URL=http://rcs-host:3000\nexport ACP_RCS_TOKEN=sk-your-key\n```\n\n- `ACP_RCS_URL`:RCS 服务器地址\n- `ACP_RCS_TOKEN`:必须与 RCS 的 `RCS_API_KEYS` 中的某个 key 一致\n\n可选环境变量:\n\n| 环境变量 | 说明 |\n|---------|------|\n| `ACP_RCS_GROUP` | Channel group ID(字母、数字、下划线、连字符) |\n| `ACP_RCS_USERNAME` | 归属用户名(自动认领 env 到该用户) |\n| `ACP_RCS_USER_ID` | 归属用户 ID(绕过自动认领) |\n| `ACP_RCS_TEAM_ID` | 关联团队 ID |\n| `ACP_AUTH_TOKEN` | 本地 WS 认证 token(不设则自动生成) |\n| `ACP_PERMISSION_MODE` | 默认权限模式 |\n\n#### 2. 启动 acp-link\n\n```bash\nacp-link slz -- --acp\n```\n\n`acp-link` 会启动 slz 作为子进程,通过 ACP 协议代理它与 RCS 之间的通信。slz 会出现在 RCS Web UI 的 agent 列表中,可接受会话请求。\n\n`--` 之后是传递给 slz 的参数(`--acp` 让 slz 进入 ACP 兼容模式)。\n\n### 连接 Claude Code 到 RCS\n\n`acp-link` 支持任何遵循 ACP 协议的 agent。Claude Code 通过专用的 ACP 适配包 `@agentclientprotocol/claude-agent-acp` 接入,接入命令是 `acp-link claude-agent-acp`(**不是** `acp-link claude`,因为 Claude Code 本身不直接说 ACP 协议,需要先装适配包)。\n\n#### 1. 安装 claude-agent-acp\n\nClaude Code 的 ACP 适配包需要单独安装:\n\n```bash\nnpm install -g @agentclientprotocol/claude-agent-acp\n```\n\n安装后会注册 `claude-agent-acp` 命令。\n\n#### 2. 设置环境变量\n\n```bash\nexport ACP_RCS_URL=http://rcs-host:3000\nexport ACP_RCS_TOKEN=sk-your-key\n```\n\n#### 3. 启动 acp-link 桥接\n\n```bash\nacp-link claude-agent-acp\n```\n\n`acp-link` 的第一个参数是 agent 的可执行命令名(这里是 `claude-agent-acp`)。`claude-agent-acp` 本身不需要额外参数,因此不需要 `--`。\n\n连接成功后,Claude Code 会作为 ACP agent 出现在 RCS Web UI 中,与 slz agent 并列,团队成员可在 Web UI 中选择它创建会话。\n\n其他 ACP 兼容 agent 的接入方式类似:安装对应的 ACP 适配包,然后用 `acp-link <命令名>` 启动。可在 npm 官网搜索 `@agentclientprotocol/*` 查找已适配的 agent。\n\n## 团队协作场景\n\n### 共享会话\n\n在 RCS Web UI 中创建会话,分享链接给队友(需登录才能查看),他们可查看或加入对话。也可通过 `session_shares` 显式授予指定用户或团队「只读」/「读写」权限,并设置过期时间。\n\n### 多 Worker 协作\n\n团队多个成员各自启动 worker,连接到同一 RCS:\n\n```bash\n# 成员 A:默认配置\nslz rc\n\n# 成员 B:worktree 隔离,5 并发\nslz rc --spawn=worktree --capacity=5\n```\n\nWeb UI 显示所有 worker 状态,会话与权限集中管理。\n\n### 外部 Agent 接入\n\n用 ACP 让非 slz 的 agent 接入 RCS。Claude Code 通过 `claude-agent-acp` 适配包接入:\n\n```bash\n# 先装适配包(仅一次)\nnpm install -g @agentclientprotocol/claude-agent-acp\n\n# 设置 RCS 连接\nexport ACP_RCS_URL=http://rcs-host:3000\nexport ACP_RCS_TOKEN=sk-your-key\n\n# 启动桥接\nacp-link claude-agent-acp\n```\n\n接入后所有 agent 在 Web UI 中统一管理,团队成员可选择任意 agent 创建会话。\n\n## 安全建议\n\n- RCS 默认监听 0.0.0.0,生产环境建议用反代 + HTTPS\n- 用强 API Key,定期轮换\n- 生产环境关闭 `RCS_ALLOW_REGISTRATION` 改为邀请制\n- 使用 `RCS_WEB_CORS_ORIGINS` 限制 Web UI 访问来源\n- 设置 `RCS_DB_PATH` 持久化 SQLite 数据库\n- 限制 worker 的权限(`/permissions` 配置)\n- `bypassPermissions` 模式仅在 sandbox 环境中启用,避免在主机直接放行所有工具调用\n\n## 故障排查\n\n| 问题 | 排查 |\n|------|------|\n| Worker 无法连接 | 检查 `SALUZI_BRIDGE_BASE_URL` 和 `SALUZI_BRIDGE_OAUTH_TOKEN` 是否同时设置;确认 token 与 RCS 的 `RCS_API_KEYS` 匹配 |\n| `Only HTTPS or localhost HTTP is allowed` | 远程 RCS 用 HTTP 被拒。优先用 HTTPS;或 SSH 隧道转发到 localhost;可信内网可设 `SALUZI_BRIDGE_ALLOW_INSECURE_HTTP=1` |\n| Web UI 登录失败 | 检查用户名密码;5 次失败后锁定 5 分钟 |\n| Web UI 401 | 确认使用 `RCS_API_KEYS` 中的 key 或有效的 session token |\n| 看不到某个会话 | 检查会话 visibility(private/team/public);确认是否在所属团队的成员列表里;admin 可看所有 |\n| `/rc --attach` 列表为空 | 只列出你有权限管理、且未结束/未被占用的会话;确认目标会话的可见域与你的归属,或让会话 owner 共享 |\n| 接入报「环境无主」 | 该环境还没被认领,先在终端提示的 `/code/claim/clm_xxx` URL 完成认领,再重新接入 |\n| 等待接入一直没有会话 | 在 Web UI 把会话绑定到该 worker;超过超时(默认 24 小时)会放弃,可用 `SALUZI_BRIDGE_ATTACH_TIMEOUT_MS` 调整 |\n| 接入后历史没出现 | 接入会拉取会话历史,失败即中止;确认网络可达 RCS 后重试 `/rc --attach` |\n| 环境显示「待认领」 | worker 没指定 `--user-id`/`--team-id`,找到终端里的 `/code/claim/clm_xxx` URL,已登录用户打开即可认领 |\n| acp-link 无法连接 RCS | 检查 `ACP_RCS_URL` 和 `ACP_RCS_TOKEN` 是否设置 |\n| Agent 不出现在 Web UI | 确认 acp-link 已启动且 `ACP_RCS_TOKEN` 与 `RCS_API_KEYS` 匹配 |\n| 邀请链接失效 | 邀请 token 可能过期或达到 max_uses 上限;让团队 owner/admin 重新创建 |\n| 会话超时 | 调整 `RCS_DISCONNECT_TIMEOUT` 和 `RCS_WS_CLIENT_INACTIVITY_TIMEOUT` |\n"
|
|
7342
7364
|
},
|
|
7343
7365
|
"docs/guide/conversation-basics": {
|
|
7344
7366
|
"frontmatter": {
|
package/dist/guide/index.html
CHANGED
|
@@ -11,12 +11,12 @@
|
|
|
11
11
|
href="https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap"
|
|
12
12
|
rel="stylesheet"
|
|
13
13
|
/>
|
|
14
|
-
<script type="module" crossorigin src="/assets/main-
|
|
14
|
+
<script type="module" crossorigin src="/assets/main-CdOE18lg.js"></script>
|
|
15
15
|
<link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-S-ySWqyJ.js">
|
|
16
16
|
<link rel="modulepreload" crossorigin href="/assets/shiki-CMaUdEs0.js">
|
|
17
17
|
<link rel="modulepreload" crossorigin href="/assets/streamdown-nMT_aKRc.js">
|
|
18
18
|
<link rel="modulepreload" crossorigin href="/assets/vendor-BU1MXatO.js">
|
|
19
|
-
<link rel="stylesheet" crossorigin href="/assets/main-
|
|
19
|
+
<link rel="stylesheet" crossorigin href="/assets/main-Bx1xb7yl.css">
|
|
20
20
|
</head>
|
|
21
21
|
<body>
|
|
22
22
|
<div id="root"></div>
|