啟動選項一覽
ssp.exe 可以加上以下選項(開關)啟動。
什麼是啟動選項?
這是在啟動 Windows 軟體時切換設定並執行的機制。
如需詳細資訊,請查詢「執行時選項」、「命令列選項」、「啟動選項」等詞彙。
使用方法
有各種不同的方法。
例如,也可以透過「命令提示字元」或「執行」使用。
以下說明如何建立專用於選項的捷徑。
- 建立 ssp.exe 的捷徑。
例如:在 ssp.exe 上按右鍵→建立捷徑 - 開啟建立好的捷徑內容。
例如:在捷徑上按右鍵→內容 - 確認「目標」欄位中有 ssp.exe 的路徑後,將整個路徑以「""」括起來。
- 在括起來的路徑後加上一個半形空格,並在後方輸入下列啟動選項。
例如:"C:/User/Document/略/SSP/ssp.exe" --random - 直接按下「確定」按鈕關閉內容視窗,並順便替捷徑取個容易辨識的名稱。
例如:SSP-隨機啟動 - 執行該捷徑後,與直接啟動 ssp.exe 不同,啟動時會套用選項設定。
選項一覽
建議使用 --オプション名 格式指定各個選項。為了維持向下相容性,也可以繼續使用 /x / -x 格式的短選項。
需要指定值的選項,請使用 --オプション名 値 格式,並以半形空格分隔選項名稱和值。值中若包含空格,請以「""」括起來。
2.8.97 之後也支援以 --オプション名=値 格式指定(例如:--sstp-listen=9900)。本頁以空格分隔的格式為主。另外,/x 格式的短選項無法使用 = 格式。
--option 選項
可以用逗號分隔並指定多個 --option 選項(例如:--option bootunlock,standalone)。
| 開關 | 功能 |
|---|---|
| --option nobootcheck (舊:/o nobootcheck) |
停用異常結束檢查 |
| --option layered (舊:/o layered) |
啟用半透明視窗 |
| --option region (舊:/o region) |
停用半透明視窗(區域模式) |
| --option bootunlock (舊:/o bootunlock) |
略過重複啟動檢查 |
| --option standalone (舊:/o standalone) |
如果 SSP.exe 已經在執行,就停用將安裝或啟動人格等處理委託給執行中的 SSP.exe 的機制,並一律由本身啟動人格或進行安裝。 如同時指定略過重複啟動檢查的選項,例如 --option bootunlock,standalone,即可在完全不顯示警告的情況下同時啟動多個 SSP.exe。 |
| --option kiosk (舊:/o kiosk) |
啟用 KIOSK 模式,行為如下。 [2.6.54~] 啟用 --option bootunlock,standalone 一律將 alignmenttodesktop 設為 free 不接受滑鼠與鍵盤輸入 完全不干涉重複啟動檢查 不顯示通知區域圖示與工作列圖示 不儲存 SSP 管理的人格或外殼設定 不顯示表示正在啟動的視窗 不顯示錯誤通知 |
| --option readonly (舊:/o readonly) |
啟用唯讀模式。 [2.8.96以降] 啟動時完全不對使用者環境進行永久變更。適用於想在不影響設定的情況下測試運作,或想在他人的電腦上暫時執行 SSP 等情況。 畫面上的行為及與人格的對話都和平常一樣,不會像 KIOSK 模式那樣阻擋輸入或限制顯示。此模式與 KIOSK 模式相互獨立,也可以如同 --option kiosk,readonly 一樣同時使用。 行為如下。 啟用 --option bootunlock,standalone(若將處理委託給正在執行的 SSP,該執行個體可能會寫入設定) 完全不干涉重複啟動檢查 不儲存偏好設定、人格、外殼、對話方塊或外掛程式的設定 不儲存啟動記錄、使用統計、快取、Cookie、vanish 記錄、SSTP 設定、POP 設定、伺か即時通訊的資訊與記錄 不儲存行事曆的行程(schedule.ics) 不進行存檔資料共用(不會匯出至雲端,也不會從雲端還原至本機) 不寫入登錄檔。不設定檔案關聯、不建立捷徑、不登錄跳躍清單,也不將項目加入「最近使用的項目」 不變更桌布或背景色彩 不清空資源回收筒 即使 vanish,也不會刪除人格資料夾 不自動更新本體、人格、對話方塊、外掛程式或語言資源。也不會手動進行線上更新或安裝 NAR 不安裝 initial_install.nar不使用 SNTP 進行 NTP 時間同步 設定值本身仍可照常變更,但結束時不會寫回檔案,因此不會沿用至下次啟動。 另外,運作所需的暫存檔案(暫存資料夾)仍會照常建立,並在結束時刪除。 |
| --option dontloadmodule (舊:/o dontloadmodule) |
不載入 SHIORI/MAKOTO/PLUGIN/HEADLINE/CALENDAR 相關模組 |
| --option dpiaware (舊:/o dpiaware) |
以 Per-Monitor V2 DPI Awareness Mode 啟動 |
| --option callghost (舊:/o callghost) |
與 --install 一起使用時,安裝完成後會自動呼叫人格。 |
| --option deletesource (舊:/o deletesource) |
與 --install 一起使用時,NAR 安裝成功後會刪除 NAR。 |
一般選項
| 開關 | 功能 |
|---|---|
| --fmo-name FMO名 (舊:/f FMO名) |
強制將要寫入的 FMO 名稱改為指定名稱。 |
| --random (舊:/r) |
不受設定影響,隨機啟動人格。 |
| --ghost フォルダ名/ゴースト名 (舊:/g フォルダ名/ゴースト名) |
啟動指定的人格。以空白分隔即可同時啟動多個人格。若在 SSP 啟動時指定,會將指定的人格中第一個作為第 1 組人格啟動。 2.8.99 以後,若在 SSP 啟動時指定人格資料夾的絕對路徑(例如: ssp.exe --ghost "C:\Users\user\Desktop\myGhost"),且該人格不在載入資料夾中,便會在這次啟動期間,暫時將其上層資料夾(本例中為 C:\Users\user\Desktop\)新增為人格載入資料夾,再啟動該人格。僅適用於存在 ghost\master\descript.txt 的資料夾。暫時新增的資料夾不會儲存至設定中,並會在資料夾設定畫面中顯示為「(temporary)」,無法編輯或刪除等。此外,也不會列為人格的安裝位置候選項目。若從資料夾設定畫面明確新增相同資料夾,便會將其儲存為一般載入資料夾。 若 SSP 已在執行中(指定內容會轉交給執行中的 SSP),則不會執行此處理。 |
| --help (舊:/?) |
使用瀏覽器開啟啟動選項的說明頁面。 |
| --help ファイル名 (舊:/? ファイル名) |
使用瀏覽器開啟指定檔名的說明頁面。 |
| --ukagaka-link x-ukagaka-link:URL (舊:/m x-ukagaka-link:URL) |
執行與開啟 x-ukagaka-link:URL 時相同的動作。若在 SSP 啟動時指定,會等到第 1 組人格啟動後才執行。 |
| --install NARファイル名 (舊:/i NARファイル名) |
安裝 NAR。若有正在執行的 SSP,會將安裝作業交由該 SSP 處理;若沒有,則會自行執行安裝作業後繼續啟動。 以空白分隔即可指定多個 NAR,並依序安裝。 即使負責安裝的 SSP 正顯示「尚未安裝人格」的警告對話方塊(「請想辦法處理」對話方塊),也能進行安裝。 此外,在這種情況下若也指定了 --option callghost,會自動按下警告對話方塊中的繼續啟動按鈕,並繼續啟動。 |
| --ssf SSFファイル名 (舊:/s SSFファイル名) |
執行 SSF 檔案。若在 SSP 啟動時指定,會等到第 1 組人格啟動後才執行。 |
| --windowmode モード [省略可] | 2.8.78~ 以實驗性功能「視窗模式」啟動。將人格啟動在視窗內,並把視窗內部視為一個虛擬螢幕,方便進行擷取等操作,也能避免影響整個桌面。 2.8.86~ 可指定模式。可指定的模式如下。省略時會沿用上次的設定(初始值為 shared)。 shared:將所有正在執行的人格合併在同一個視窗中。 perghost:每個人格各自使用一個視窗。 從 2.8.86 起,視窗模式的狀態會儲存為設定,因此即使不加上此選項,也會沿用上次的狀態啟動。若要關閉,請從右鍵選單的「設定」或偏好設定中的「串流」切換。 |
| --sstp-listen 待ち受け先 | 暫時指定 SSTP 伺服器的監聽端點後啟動。 [2.8.97 以後] 不讀取已儲存的 SSTP 伺服器監聽設定,只在指定的監聽端點上監聽。 這次啟動期間的監聽設定不會儲存。偏好設定中的 SSTP 伺服器清單只會顯示,無法新增、刪除或切換啟用/停用狀態。 預期用途是搭配 --option readonly,建立不會與其他正在執行的 SSP 互相干擾的測試用 SSP。 監聽端點可以用逗號分隔指定多個。格式如下。 連接埠號碼:在 IPv4 和 IPv6 的迴路位址(127.0.0.1 和 ::1)上監聽。例如:9801 localhost:連接埠號碼:與只指定連接埠號碼相同。 IPv4 位址:連接埠號碼:只在指定的位址上監聽。指定 0.0.0.0 時,會在所有 IPv4 介面上監聽。例如:192.168.0.5:9801 [IPv6 位址]:連接埠號碼:IPv6 位址必須以[]括住。指定 [::] 時,會在所有 IPv6 介面上監聽。例如:[::1]:9801 none:不監聽任何端點。省略監聽端點時也相同。 位址必須以數字指定(localhost 除外,不能使用主機名稱)。 格式錯誤或監聽失敗的端點會被忽略,並記錄在錯誤記錄中。即使發生這種情況,也不會還原為已儲存的設定。 請注意,若指定迴路位址以外的位址,其他電腦也會能夠連線至 SSTP。 範例: ssp.exe --option readonly --sstp-listen 9900,[::1]:9901 |
| --guifont フォント名 [2.8.75 以後] | 指定 GUI 使用的字型。並非所有部分都會完全替換,目前選單的部分項目和標題列等仍不會變更。 |
離線表面傾印
| 開關 | 功能 |
|---|---|
| --offline-dump 資料夾路徑 | 以離線傾印模式啟動。不實際啟動人格,讀取指定人格資料夾中的surfaces.txt,傾印表面圖像後立即結束。不會載入SHIORI/MAKOTO/PIRO,也不會建立視窗或訊息迴圈。 引數請指定人格資料夾的路徑(結尾的\可省略)。 自2.8.98起,離線傾印相關選項(此選項、--dump-output-dir、--dump-error-log)指定相對路徑時,會以啟動SSP時的目前目錄為基準解析。 範例: ssp.exe --offline-dump "C:\SSP\ghost\myGhost" --dump-surface-list "0,1" --dump-output-dir "C:\dump" |
| --dump-shell 資料夾名稱或名稱 [可省略] | 與 --offline-dump 搭配使用。以資料夾名稱(=shell以下的相對路徑)或名稱指定要傾印的外殼。省略時會使用descript.txt指定的預設外殼(通常是master)。 自2.8.98起,找不到指定的外殼時,不會改用預設外殼傾印,而是將Error記錄到錯誤記錄檔,且不輸出任何內容。 |
| --dump-scope (範圍ID) [可省略] | 與 --offline-dump 搭配使用。指定傾印圖像的範圍ID。省略時為0。 |
| --dump-surface-list 清單 [可省略] | 與 --offline-dump 搭配使用。以逗號分隔指定要傾印的表面。可省略surface編號的前綴(surface)。也可以使用surfaces.txt的表面ID指定擴充格式。 範例: --dump-surface-list "0,1,10"省略此選項時不會傾印表面(可搭配 --dump-error-log,只輸出剖析錯誤)。 自2.8.98起,前綴不只可在第一個項目省略,也可在各個項目省略(例如 "0,surface1")。此外,若指定的單一編號表面不存在,會將Warning記錄到錯誤記錄檔(範圍指定中缺少的編號不會記錄)。 |
| --dump-output-dir 目錄 [可省略] | 與 --offline-dump 搭配使用。指定傾印圖像的輸出目錄。省略時會使用目前目錄(2.8.97以前,省略時不會進行傾印)。 |
| --dump-output-prefix 前綴 [可省略] | 與 --offline-dump 搭配使用。指定輸出檔名中位於表面編號前面的部分。預設的「surface」會被此字串取代(不會附加在後)。省略時為「surface」。 範例:使用 --dump-output-prefix "x_" 時,表面0會輸出為 x_0.png(而非 x_surface0.png)。 |
| --dump-error-log 檔案路徑 [可省略] | 與 --offline-dump 搭配使用。將載入外殼時的錯誤記錄(例如surfaces.txt的剖析錯誤)寫入指定路徑。 省略 --dump-surface-list,只指定此選項,即可不進行傾印,只執行錯誤檢查。 範例: ssp.exe --offline-dump "C:\SSP\ghost\myGhost" --dump-error-log "C:\dump\error.csv"輸出格式:含BOM的UTF-8 CSV(換行符號為CRLF)。每行一筆資料,各欄以"括住,欄位中的"會以""跳脫。 "時刻","ゴースト名","レベル","内容"時間:HH:MM:SS格式。 等級:Info / Notice / Warning / Error / Critical / System 其中之一。 內容:記錄本文。自2.8.94起,SERIKO相關記錄會附上定義來源檔案(相對於人格資料夾的路徑)和行號,例如 [SERIKO] shell\master\surfaces.txt:Line=12:Surface=10 ...。重複定義的記錄也會一併列出先前定義的位置,格式為 (檔案名稱:Line=n)。自2.8.94起,指定此選項時,最多會保留10000筆記錄,也不會將相似內容的記錄彙整成摘要行(等級System),因此不會遺漏記錄。 若沒有任何記錄,不會建立檔案(即使指定路徑已有檔案,也不會覆寫或刪除)。 結束代碼:自2.8.94起,處理程序會依記錄中最嚴重的等級,以對應的結束代碼結束。 0:沒有記錄,或只有Info/Notice 1:有Warning(沒有Error/Critical) 2:有Error(沒有Critical) 3:有Critical 若人格本身載入失敗(例如無法讀取指定資料夾中的descript.txt),不會輸出記錄,結束代碼也會是0。 |
| --dump-surface-option 選項 [可省略] [2.8.57以後] | 指定離線傾印功能的選項。可指定以下項目。 backlog:裁切與回溯記錄功能相同的區域(臉部周圍)。但不會縮放,會直接輸出合成圖像。 collision:繪製碰撞判定的形狀和名稱後輸出。與開發用面板中的碰撞判定顯示相同,但名稱一律會顯示,且不會繪製表面外框、有效範圍、重疊判定範圍等外框矩形。[2.8.98以後] 自2.8.98起,可用逗號分隔指定多個選項(例如: --dump-surface-option backlog,collision)。若未透過此選項指定collision,無論使用者設定(開發用面板中的碰撞判定顯示)為何,都不會繪製碰撞判定。 |
| --dump-bind 換裝指定 [可省略] [2.9.05以後] | 與 --offline-dump 搭配使用。指定傾印時的換裝狀態。 可用分號分隔多組「類別名稱,零件名稱,ON/OFF」。意義與 \![bind]相同;在互斥類別中開啟某個零件時,同一類別中的其他零件會關閉。零件名稱留空或指定為 __ALL__ 時,會套用至該類別中的所有零件。ON/OFF指定為1或true時代表開啟,指定為0或false時代表關閉。省略時視為開啟( \![bind] 省略時會切換狀態,但此選項不會切換狀態)。範例: --dump-bind "頭,帽子;服,制服;アクセサリ,__ALL__,0"基準狀態是外殼的descript.txt所指定的各零件預設值( sakura.bindgroup*.default),不會使用使用者最後一次換裝的狀態(shell\profile中的儲存值)。只會從基準狀態變更指定的零件。換裝會套用至 --dump-scope 指定的範圍。 若指定不存在的類別或零件,會記錄Warning(--dump-error-log的結束代碼為1),並忽略該指定,繼續傾印。 類別名稱和零件名稱前後的空白不會移除,因此逗號後面請勿加入空白。 |
| --dump-animation 動畫ID [可省略] [2.9.05以後] | 與 --offline-dump 搭配使用。像\i[ID]一樣播放指定動畫,並依序輸出每個影格的圖像。只能指定一個ID(除了數字,也可像\i[ID]一樣使用surfaces.txt中為動畫設定的名稱)。每個表面會先輸出與一般傾印相同的圖像(runonce動畫播放一輪後的狀態)為 surface0.png,接著每當指定動畫的圖樣前進時,就依從0開始的4位數連號輸出 surface0_0000.png、surface0_0001.png…等圖像。--dump-output-prefix和 --dump-surface-option的指定也會套用至連號圖像。範例: ssp.exe --offline-dump "C:\SSP\ghost\myGhost" --dump-surface-list "0" --dump-animation 10 --dump-output-dir "C:\dump"runonce、always等動畫會像一般傾印一樣運作,指定動畫則會在其上播放。連號輸出的對象只有指定動畫本身的圖樣;即使always動畫前進,輸出張數也不會增加。 指定動畫播放至最後一個圖樣時即結束(always動畫則在播放一輪時結束)。即使因其他動畫的stop或互斥而停止,也會在此時結束。 以start、alternativestart、parallelstart啟動的其他動畫不會列入連號輸出。若指定動畫包含這些圖樣,會記錄Warning(但仍會繼續輸出)。 start、stop類型的圖樣不會改變圖像,因此不會計為連號中的一個影格。 若指定的ID不存在於該表面,或因換裝而失效、處於互斥狀態等原因而無法播放,會記錄Warning,該表面只會輸出一般的一張圖像。 連號圖像最多輸出10000張(至 _9999);達到上限時會記錄Warning並停止輸出。 |
離線工具
| 開關 | 功能 |
|---|---|
| --offline-tool 種別 [2.9.01以降] | 以離線工具模式啟動。不啟動人格,從 --target-dir 指定的資料夾建立 NAR、更新定義檔或壓縮檔後立即結束。不會觸發任何人格事件,也不會建立視窗或訊息迴圈。 處理方式與 Sakura Script 的 \![execute,createnar] / \![execute,createupdatedata] / \![execute,compressarchive] 相同,但沒有輸出位置限制(例如只能存放在 SSP 管理的資料夾),可自由指定。種類請指定下列其中一種(不區分大小寫)。 nar:建立 NAR 檔案。 developer_options.txt 中的 nonar 設定、.narignore 等排除規則,會與一般建立 NAR 時相同地套用。如果資料夾根目錄沒有 install.txt,會從 descript.txt(或 ghost\master\descript.txt)判斷種類與名稱,並在目標資料夾建立 install.txt 後一併收錄。若無法判斷種類與名稱,則會失敗。updatedata:建立更新定義檔。如果 --output 的檔名以 .dau 結尾,會建立與 updates2.dau 相同格式的檔案;否則會建立 updates.txt 格式的檔案,且只建立指定的單一檔案。既不會建立也不會刪除目標資料夾根目錄或 ghost\master 中的 updates2.dau / updates.txt。developer_options.txt 中的 noupdate 設定、.updateignore 等排除規則,會與一般情況相同地套用。archive:直接壓縮目標資料夾。不會讀取 .narignore 等排除規則(不會收錄隱藏檔案及隱藏資料夾)。格式由 --output 的副檔名決定,若為 .7z 則使用 7z 格式,否則使用 zip 格式。 無論指定哪種種類,若輸出檔案已存在,都會覆寫。若輸出位置位於目標資料夾內,則不會收錄該檔案本身。輸出資料夾必須事先存在。 若 --target-dir 或 --output 指定相對路徑,會以啟動 SSP 時的目前目錄為基準解析。 結束代碼: 0:成功 1:引數無效(種類不明、未指定 --target-dir 或 --output、--target-dir 不存在或不是資料夾) 2:建立失敗(無法寫入輸出位置、無法判斷 NAR 的種類與名稱、updatedata 遇到無法讀取的檔案或層級過深(超過 32 層)等)。失敗時也可能留下部分建立的檔案 範例: ssp.exe --offline-tool nar --target-dir "C:\src\myGhost" --output "C:\out\myGhost.nar"範例: ssp.exe --offline-tool updatedata --target-dir "C:\src\myGhost" --output "C:\out\updates2.dau"範例: ssp.exe --offline-tool archive --target-dir "C:\src\data" --output "C:\out\data.7z" --password "pass" |
| --target-dir 資料夾路徑 [2.9.01以降] | 與 --offline-tool 搭配使用(必填)。指定處理目標資料夾(結尾的 \ 可省略)。建立 NAR 或更新定義檔時,請指定人格等內容的根資料夾(包含 descript.txt、install.txt 或 ghost 資料夾的資料夾)。 |
| --output 檔案路徑 [2.9.01以降] | 與 --offline-tool 搭配使用(必填)。指定要建立的檔案路徑。 |
| --password 密碼 [省略可] [2.9.01以降] | 與 --offline-tool 的 nar 或 archive 搭配使用。使用指定的密碼建立 AES 加密 ZIP(若為 7z 格式,則使用 7z 加密)。updatedata 會忽略此設定。 密碼會以原文保留在命令列中,請妥善處理。 |
其他
| 開關 | 功能 |
|---|---|
initial_install.nar |
這不是啟動選項,但若在與 ssp.exe 相同的資料夾中放置名為 initial_install.nar 的 NAR 檔案,SSP 啟動時會以靜默方式(不顯示確認對話方塊)覆蓋安裝。安裝完成後,initial_install.nar 會自動刪除。可用於隨 SSP 一併附帶人格等內容進行散布。 [2.7.52~] |