Plugin SDK 開發與發行

開發、驗證、發行工具,以及 1.2 的工作流程、增量快取、外部工具與公開 LSP 橋接器。

DDS Plugin SDK 1.2.0 的開發、驗證與發行指引。安全稽核與漏洞驗證仍待完成;穩定 API 狀態及功能檢查不等於通過安全驗收。

SDK 安裝與 API 指南

開發範本與產生工具

可選擇 command、language、theme、job、browser 或 configuration。init --dry-run 會回報目的地、檔案清單、雜湊與衝突,不會寫入或安裝。一般 init 必須使用新的實體目錄。每個範本皆包含原始碼、資訊清單、揭露資訊、授權/告知文件、測試、具有型別的使用端與可執行範例。browser 與 configuration 範本包含回環示範。產生的相依套件固定使用精確的 GitHub 封存檔。

npx --no-install dds-plugin init example-plugin --template configuration --dry-run
npx --no-install dds-plugin init example-plugin --template configuration
cd example-plugin
npm install --ignore-scripts
npm run doctor
npm test
npm run typecheck
npm run example
npm run browser

dds-dev.json 是有明確限制的 JSON 資料,涵蓋命令結構描述、設定、語系目錄與佈景資料。generate 會輸出執行階段 JSON、ESM 匯出、原始/已驗證的 TypeScript 輸入型別、輸出/設定型別、JSON Schema 及佈景 XML。JSON Schema 的預設值只是註解;只有 SDK 輸入驗證會套用預設值。產生過程不會匯入您的外掛。doctor 會檢查偏移、中繼資料、缺少的模組,以及產生的執行階段檔案是否納入套件允許清單。

npx --no-install dds-plugin generate . --check
npx --no-install dds-plugin generate . --dry-run
# Review the new files, then use the previous digest from the report:
npx --no-install dds-plugin generate . --expected-digest <previous-digest>

替換時需要精確的先前摘要,且產生的位元組不得變更。手動編輯、額外檔案、連結與過期鎖定都會停止替換。失敗時,只會移除該次嘗試擁有且未變更的項目,並保留已修改或狀態不確定的項目供檢查。上限為 256 個檔案、每個 1 MiB、總計 4 MiB。鎖定用於協調合作的產生器,無法防禦惡意的並行檔案系統寫入者,也不提供跨目錄的原子交易。專有範本需由呼叫端提供條款,並保留繼承的 SDK 授權/告知檔案。

確定性測試與重播

/testing 的 createScenarioHost 會明確掛載所選的記憶體內檔案、後端、設定、機密與作業測試資料。初始狀態沒有任何授權或能力。createTestClock 提供以種子產生的 ID、時間與計時器,不會修改全域物件;同一時間的計時器依插入順序執行。請等待時鐘推進,以解除虛擬等待。產生的 UUID 是測試資料,不是密碼學熵來源。現有 createTestHost 預設值維持相容。

import {createScenarioHost} from '@altifigence/dds-plugin-sdk/testing';
const scenario = createScenarioHost({seed: 7, start: 1000,
  files: {'example.txt': 'synthetic'}, grants: ['workspace.read'],
});
try {
  // Activate your explicitly imported test plugin on scenario.host.
  scenario.faults.enqueue({operation: 'file.read', kind: 'delay', delayMs: 25});
  // Start its command, then await scenario.clock.advance(25).
} finally {
  await scenario.dispose();
  scenario.assertClean();
}

故障介面模擬延遲、拒絕、斷線、損毀、資源耗盡與遺失的呼叫;事件測試資料可被丟棄、重複或反轉,而不會重複外部效果。replaceGrants 會停用失去權限的外掛。記憶體作業快照會驗證身分、修訂版本與雜湊,並模擬中斷後復原,不會自動執行。這些測試資料不模擬檔案系統耐久性,也不探索作業系統控制代碼。獨立的擁有者帳冊追蹤明確註冊的資源。對於忽略取消的回呼,清理時會保留待完成計數,直到回呼實際結束。Settings inspect 現在可在釋放後讀取;資料讀取仍會遭拒。

記錄需要 synthetic: true,並明確提供有數量限制的測試資料清單。匯出的軌跡只包含操作種類、測試資料 ID、時序、種子/版本與鏈結雜湊。請使用非敏感 ID;雜湊不會將可猜測的資料匿名化,SDK 也無法判定任意輸入是否為合成資料。純重播會檢查順序、雜湊及測試資料身分,並傳回所選測試資料的輸出;不接受產生效果的回呼。限制為 64 組測試資料、1,024 個事件與 1 MiB 軌跡。執行套件內的 development-tools 範例,以檢查故障、復原、隱私與清理。

本機診斷與偵錯

import {createDiagnosticSession, profileHost}
  from '@altifigence/dds-plugin-sdk/diagnostics';
const session = createDiagnosticSession({enabled: true, sampleEvery: 10});
const measured = profileHost(host, session);
try {
  await measured.executeCommand('example', 'run', {});
} finally {
  measured.dispose();
  console.log(session.snapshot());
  session.dispose();
}

診斷預設關閉,且只在本機進行。報告包含固定的操作/狀態/錯誤碼、關聯 ID、持續時間與資源計數;沒有用於文件內文、路徑、輸入、輸出內文或任意例外文字的 API。位元組數、佇列深度與記憶體數字皆為擁有者明確提供的估計值。profileTransport 的測量持續至包裝的呼叫完成;對 fetch 而言,這代表回應標頭抵達,而不是內文接收完成。已完成記錄使用有容量限制的環形緩衝區與被動到期機制;沒有診斷背景計時器或上傳。預設為 128 個事件/60 秒;最大值為 256 個事件/5 分鐘、64 個進行中的 span,以及每份報告 256 KiB。

npx --no-install dds-plugin dev . --trust-local-code --profile --command greet --input '{"name":"Ada"}'
npx --no-install dds-plugin dev . --trust-local-code --debug --debug-wait --timeout-ms 30000 --command greet --input '{"name":"Ada"}'

偵錯模式只在所擁有的子處理程序中開放暫時性的 127.0.0.1 inspector。--debug-wait 會在匯入外掛前暫停,且需要 --debug。總執行時間限制包含等待偵錯器的時間,最多 30 秒。完成、取消與逾時都會終止所擁有的子處理程序及 inspector。效能分析與偵錯都需要明確信任本機程式碼;兩者都不是沙箱。當機或強制終止可能使效能分析報告缺漏,而外掛原始 stdout/stderr 仍是獨立且有大小限制的串流,不會自動遮蔽敏感內容。

開發工具 · 測試 · 診斷 · 相容性

主機符合性

/conformance 模組會針對您明確提供的主機、設定、工作區、在地化、測試、診斷及開發配接器,執行具版本的合成探測。它區分支援、不支援與失敗的設定組合,並包含主機/版本/執行階段/平台、檢查 ID、時序及清理資訊。宣告的功能若缺少配接器或配接器故障,就會失敗;未知的選用功能只記錄,不探測。預設要求命令、權限與取消能力。

import {runConformance, formatConformanceReport}
  from '@altifigence/dds-plugin-sdk/conformance';
import {createPluginHost} from '@altifigence/dds-plugin-sdk';
const report = await runConformance({
  identity: {host: 'My host', version: '1.0.0', runtime: 'Node 24', platform: 'linux-x64'},
  features: ['commands', 'permissions', 'cancellation'],
  adapters: {host: options => createPluginHost(options)},
});
console.log(formatConformanceReport(report));

請以您的配接器替換主機工廠,並一併執行外掛測試。Node 的 /conformance-node 輔助工具只建立新的暫存測試資料與暫時性回環伺服器。瀏覽器範例執行可用的瀏覽器設定組合,並將缺少的 Node 功能回報為不支援。快速探測抽查契約;連結的範例與發行測試涵蓋較完整的語言、復原與儲存路徑。報告是測試證據,不是信任憑證。

每個案例預設期限為 10 秒,最多 30 秒。逾時或取消會停止後續案例;清理失敗會使案例失敗,尚未完成的清理仍屬未驗證。受信任的程序內配接器可能同步阻塞,且保留環境既有權限。報告不含提供者的錯誤內文、酬載、權杖與路徑;請選擇非敏感身分標籤。不會自動上傳任何報告。

SDK 支援與移轉

API_SUPPORT.json 列出每個匯出模組、執行階段名稱、宣告、宣告摘要、環境與穩定性。穩定的 1.x API 遵循語意版本規則:相容新增使用次要版本,不相容的穩定變更需要新的主要版本。artifact-resume-browser 仍為實驗性功能,需使用精確的 SDK/瀏覽器版本,並重新完成瀏覽器驗收。仍須探索選用能力並確認目前權限。

穩定版本系列政策自 1.0.0 起適用。最新的穩定次要版本會收到一般修正;前一個次要版本在受支援的執行階段內,仍可於 90 天期間獲得重大安全修正。1.0.0 沒有棄用任何穩定 API。在主要版本移除前,棄用公告至少持續兩個次要版本及六個月。RC 與預覽版會被新版本取代。這項開源政策不承諾商業回應時間。

伺服器與 CLI 驗收涵蓋 Windows/Linux 搭配已套用修補的 Node 22 或 24,以及 TypeScript 5.9.3 宣告。Node 22 支援於 2027-04-30 結束,Node 24 支援於 2028-04-30 結束。發行回條列明精確的修補版本、作業系統映像與瀏覽器組建。其他執行階段及瀏覽器/儲存組合需自行驗收。SDK 執行階段的 npm 相依套件仍為零。

穩定的 1.0 外掛使用 >=1.0.0 <2.0.0;採用較新 API 時,請提高最低版本。RC1 套件維持精確的 1.0.0-rc.1 peer 相依版本。若要變更,需重新驗證並發行新的外掛版本;先前封存檔應保持不可變。舊封存檔用於互通測試,不是仍在維護的系列。重新啟動後應建立新的連線及目前授權;復原只讀取已提交狀態,不會重新執行工作。

發行驗收

依擁有者於 2026-10-05 延後處理的決定,安全稽核與漏洞驗證仍待完成。功能、相容性與效能結果不等於安全驗收。保留的審查將另外恢復進行;不得宣稱本次發行已通過該稽核。

組合測試資料會同時測試語言/設定、已審查編輯、命令作業、專案監看、上傳/下載及保留儲存。檢查涵蓋中斷、格式錯誤的回應、撤銷、世代變更、復原與資源清理。獨立的檔案系統/程序測試涵蓋被終止的子程序、損毀、寫入失敗、到期及忽略取消。RC 驗收報告連結可重現的命令及每項結果的適用界線。

效能測試會針對每個 Windows/Linux 與 Node 22/24 設定組合,記錄五個新程序樣本,包含中位數/分散程度、CPU 時間、取樣記憶體、匯入/啟動/監看時序,以及邏輯磁碟/HTTP 酬載計數。基準門檻取自這些實測樣本,是粗略的回歸防護,不是延遲 SLA。它們不測量實體磁碟流量,也不保證找出每個作業系統控制代碼。

npm ci --ignore-scripts
npm run check
npm run example:conformance -- --json
npm run example:combined -- --faults
npm run benchmark:combined
npm run example:conformance-browser

符合性 · API 清單 · 支援政策 · RC 驗收

穩定版 1.0 發行內容

原始 1.0 套件包含 38 個匯出與 86 個結構描述,附帶宣告、範例、LICENSE 與 NOTICE。1.1 新增下列發行工具;1.2 新增下列工作流程/快取/工具/LSP 章節。發行回條區分精確原始碼/CI/摘要、新使用端與重用的瀏覽器證據。

若要降版,請停止所擁有的工作,明確選擇保留且相容的 SDK/外掛封存檔與設定匯出。審查目前授權並建立新的連線。結果復原僅限讀回;外部效果與不相容設定不會自動復原。請測試實際使用的格式與選用功能。

發行內容、移轉與支援

離線組合套件與 SBOM

SDK 1.1 新增五個僅限 Node 的選用進入點:/bundles、/provenance、/updates、/updates-node 與 /upstream。套件包含 43 個匯出、96 個結構描述、宣告與可執行範例,執行階段的 npm 相依套件為零。現有 1.0 API 及未簽署的 DDS .tgz 封存檔維持相容。

lockBundleDependency 將已審查的 ESM/CommonJS 檔案樹鎖定至精確版本、HTTPS 來源、標準化檔案摘要、相依對應、LICENSE/NOTICE 及明確的再散布決定。摘要描述已審查的樹狀內容,不是上游封存檔雜湊。createPluginBundle 嵌入原始 DDS 外掛封存檔與發行中繼資料、單一版本的無循環相依圖,以及確定性的 CycloneDX 1.6 SBOM。

verifyPluginBundle 檢查有明確大小限制的精確位元組快照。installPluginBundle 需要其 expectedSha256、approved: true,以及位於操作者擁有的父目錄下的新目錄。它不執行 npm、生命週期指令碼、下載或外掛程式碼。相依套件不會繼承任何新授權。主機 SDK 是獨立相依項目。此格式不涵蓋原生附加元件、匯出對應與任意 npm 相依解析。

限制:32 個相依套件、1,024 個展開檔案、每個相依檔案 4 MiB、展開內容 32 MiB,以及編碼後組合套件 48 MiB。原始根封存檔另有較小限制。缺少或衝突的版本、循環、孤立相依、雜湊變更、缺少授權/NOTICE、路徑/連結及檔案與目錄衝突都會遭拒。安裝失敗時保留新目的地供檢查。請排除並行寫入者;此工具不是作業系統沙箱。

分離式簽章與操作者信任

createProvenanceStatement 繫結精確的組合套件名稱/版本/SHA-256、發行者、來源修訂版本,以及發行/到期時間。signPluginProvenance 使用呼叫端擁有的 Ed25519 KeyObject。canonicalProvenancePayload 提供 DDS-PROVENANCE-V1 加上標準化 JSON,讓其他簽署者重現相同酬載。SDK 不提供私有簽署金鑰,也不提供 DDS 產品簽署權限。

verifyPluginProvenance 接受操作者選擇的信任根、發行者/主體繫結、目前時間、金鑰有效性/撤銷,以及帶有時間戳記的撤銷證據。離線驗證使用提供的證據,並套用相同的時效限制;不會自行取得新的撤銷資訊。新套件金鑰在操作者加入前都不受信任。明確重疊的信任根支援金鑰輪替。最大時鐘偏差為五分鐘,證據最長有效期為 30 天;需要時請採用更嚴格的限制。

回條分別記錄校驗和、簽章、發行者與政策,且一律傳回 executionAuthorized: false。簽章不證明程式碼安全,也不授予執行、資料存取或沙箱權限。較舊的未簽署套件需要 envelope: null 與 allowUnsigned: true,仍會回報未簽署及發行者未驗證。安全稽核與漏洞驗證各自仍待完成。

審查、啟用與回復

createPluginUpdatePlan 比較新舊版本、API、授權、相依來源/雜湊、宣告工具、授權條款、設定雜湊、移轉身分、簽章與金鑰,然後固定審查摘要。createPluginUpdateController 擁有目前獲授權的主機與設定,以及操作者的 getPolicy/prepare 介面。stage 驗證並快照候選項目;approve 必須符合精確的計畫摘要、授權與金鑰 ID。activate 檢查目前設定,並在準備獨立候選主機前後更新信任。

wait 會在作業執行中延後啟用。retain-old 讓舊作業繼續使用原始主機/設定/雜湊,切換後將新執行導向新主機。execute 隨每項結果傳回外掛雜湊。不會隱含取消作業。替換設定會使待定核准失效;並行變更與準備失敗會保留或明確回報先前狀態。回復會將舊套件/設定作為新的更新進行暫存及審查,且需要目前信任與新的核准。

準備與移轉透過操作者擁有的受信任介面執行。回復或失敗都不會撤銷外部檔案、網路要求或其他效果。reversible 是審查中繼資料,不是自動復原承諾。Node 日誌採僅附加、單一寫入者,且位於工作區外,具有精確修訂版本 CAS;限制為 256 筆記錄/每個封套 128 KiB/總計 8 MiB。到達上限時,應由操作者控制封存,再開啟新的日誌。

inspectNodeUpdateJournal 只讀取持久狀態,不重播。準備期間當機或確認訊息不明確時,需明確讀回主機/設定;reconcilePluginUpdateJournal 記錄已核准且已知的新舊摘要與設定雜湊。損毀的尾端需由操作者檢查/修復。recoverStaleLock 只會復原已證實終止的同機寫入者鎖定。這不承諾跨程序的主機/設定交易,也不承諾所有斷電情況下的原子性。

明確的上游檢查與候選項目

fetchUpstreamArtifact 需要明確呼叫、enabled: true、精確的來源 URL/版本/摘要、精確的 URL 允許清單、離線政策、位元組限制與期限。重新導向目標也必須在允許清單內。它不傳送 Cookie 或驗證標頭,不自動重試任何操作,並回報 verified/digest-mismatch/unavailable/offline/unverified 及觀察時間。標籤或雜湊變更需要重新審查。回環 HTTP 只能透過明確的測試資料選項使用。

配接器可發行已審查的 upstream-manifest,包含 API 清單、精確來源修訂版本、完整授權/NOTICE 與檔案雜湊。inspectUpstreamManifest 將中繼資料繫結至下載的位元組;不分析任意原始碼,也不推斷再散布許可。createUpstreamCandidate 傳回 API/檔案/授權差異,以及變更前摘要/替換來源的修補。即使符合精確版本矩陣,若沒有開發者功能檢查,仍屬未驗證;缺少必要 API 則為不支援。

受支援的候選項目仍須經人工審查。其 automaticActions 陣列為空;這些 API 不會建立分支、合併、發行、核准新授權或安裝監視器。主機負責配接器測試的執行與取消。下方完整公開範例只操作本機測試資料。工作流程/快取/工具/LSP API 位於下方 1.2 章節。

node node_modules/@altifigence/dds-plugin-sdk/examples/release-tools/run.mjs

型別、API、限制與完整可執行原始碼

命令工作流程與明確復原

SDK 1.2 新增七個選用匯出:/workflows、/workflows-node、/workflow-cache、/workflow-cache-node、/tool-streams、/tool-streams-node 與 /lsp-node。目前套件有 50 個匯出、107 個結構描述、TypeScript 宣告及獨立安裝範例,執行階段的 npm 相依套件為零。只有 /tool-streams 可移植至瀏覽器;其他新匯出需要 Node。現有工作區協定與 1.x API 維持相容。匯入新 1.2 API 的外掛必須宣告最低 SDK 版本為 1.2.0。

prepareWorkflowPlan 會在執行前驗證已註冊命令 ID、唯一的步驟、無循環相依、封閉的輸入/輸出資料結構描述及必要輸出繫結。每個輸入是字面值 {value},或指向明確相依項目的 {step, path} 繫結。結構描述限制必須完全相符。不可變計畫將命令、授權、範圍及輸入繫結至 SHA-256。run 需要 approved: true 及該精確審查摘要。主機 authorize 與 execute 介面仍由操作者擁有。

createCommandJobExecutor 連接由 resolveHost 選擇的隔離現有 PluginHost,後者傳回精確的主機範圍、步驟授權與外掛雜湊。不同步驟的授權絕不合併。執行前、取得結果後及重用前,都會檢查目前授權。continue 完成獨立分支並阻擋失敗項目的後代;fail-fast 取消剩餘步驟。記錄保留父作業/嘗試 ID、個別作業、輸入/輸出摘要、成品、原因與時間戳記。快取命中沒有新的作業 ID,也不能宣稱具有可變的作業成品。

recover 讀取儲存的檢查點,將待處理/執行中的工作回報為已中斷,不執行工作。手動 resume 會在新核准中提供精確的先前記錄與 previousAttemptId,建立新嘗試,並僅保留相符且尚未到期的成功結果。retrySteps 即使在無序 DAG 中,也會重新執行所選步驟與其後代。到期輸出需要明確選擇重試;結構描述、輸入、授權或外掛雜湊變更時需要新計畫。忽略取消的執行器仍計入未結束工作,並防止重疊重試。

createNodeWorkflowStore 使用彼此分離的實體儲存/工作區目錄、範圍與檔案系統身分標記、單一寫入者、帶校驗和的封套及 CAS 檢查點。在已知當機後,明確的 recoverStaleLock 只接受已證實終止的同機擁有者。預設清理會處理已辨識的損毀記錄及未完成寫入,同時保留未知檔案/連結。cleanup({expiredBefore}) 也能移除已到期的終止記錄;活動記錄保留供復原。Windows 不宣稱具有目錄 fsync 或斷電耐久性。限制:64 個步驟、8 個並行步驟、10 分鐘工作流程期限、每項結果 64 KiB、合併輸出 1 MiB、記錄 2 MiB、保留 64 筆記錄,部分結果最多保留 24 小時。

型別、API、限制與完整可執行範例

確定性快取與增量執行

fingerprintWorkflowInputs 對實際檔案位元組,以及 SDK 版本、工作區/安全範圍、命令結構描述/輸入、外掛/工具雜湊、設定、宣告環境與授權進行雜湊。僅有 mtime 與路徑絕不能代表內容身分。操作者明確宣告 optIn、deterministic、declaredInputsComplete 與 secretDependent。未知或不完整輸入、非確定性、依賴機密、缺少/未宣告環境及機密參照輸入,會略過快取並提供原因。主機也必須排除原始機密與副作用;SDK 無法推斷隱藏輸入。

createWorkflowCache 在 lookup/fill/after-fill/hit/return 時重新檢查目前授權,並驗證值雜湊、範圍、授權與到期時間。同時發生且符合條件的未命中會共用一次填入;取消一個等待者不會取消其他等待者。到期或損壞的值視為未命中。TTL/LRU、項目/值限制及所擁有儲存區的清理控制儲存;寫入失敗仍可傳回已計算的結果,並附上明確原因。機密參照結果絕不保留。指紋限制為 64 個檔案、每個 4 MiB、總計 16 MiB;快取限制為 512 個項目、保留值位元組 16 MiB、八次填入及每次填入 60 秒。

工作流程範例只在目前相依項目成功後查詢快取。檔案變更會使其步驟失效;輸出變更會使相依輸入指紋失效。相依項目失敗會在查詢父項目的快取結果前阻擋父項目。回條區分 hit、miss、shared 與 bypass、實際執行與重用,並包含快取計數器、儲存位元組及本機時序。持久快取狀態使用分離的擁有者目錄與原子替換,支援孤立寫入/損毀復原;不會刪除來源檔案。

型別、API、限制與完整可執行範例

已註冊工具的輸出串流

createToolStreamParser 是可移植且有大小限制的 UTF-8 JSONL/文字解碼器。請等待 write(bytes, stdout/stderr) 以處理背壓,並在兩個串流都結束後才 finish。它保留跨區塊的多位元組字元及末尾不完整行,發出具關聯的日誌、進度、診斷與未知事件。格式錯誤的 UTF-8 與硬性限制會停止解析。它會驗證相對診斷路徑、位置順序與嚴重程度;使用端編輯器也必須針對目前文件文字驗證位置。createJobToolEventSink 將進度/日誌連至現有 JobReporter,診斷則交由呼叫端擁有的接收端處理。

選用的 Node 執行器接受操作者固定註冊資訊:後端/工具/版本、絕對執行檔與所選實作固定版本、精確版本探測、明確環境、封閉輸入結構描述及必要純量引數欄位。檔案欄位必須指定現有的相對工作區檔案。外掛呼叫只能選擇已註冊的工具/版本及已驗證輸入,不能選擇 shell 或執行檔。準備/啟動前、事件發生時及完成後,都會檢查目前授權。回條保留結束碼、取消/失敗原因及輸出統計。

已知的單行機密/路徑字面值會在行組合後遮蔽,包含跨區塊的內容;編碼過或未知的機密不會自動偵測。執行器只擁有直接子程序/管線,並在取消或關閉時將其關閉。它不掃描或終止無關或後代程序樹,也不是作業系統沙箱。限制:64 KiB 區塊、16 KiB 行、總輸出 2 MiB、4,096 個事件、八次排隊寫入、接收端五秒期限、32 個工具與四次並行執行。另以五秒/16 KiB 探測檢查設定的版本。

SDK 編寫的可再散布工具測試資料會測試分段 UTF-8/JSONL、尾端輸出、非零結束碼、取消與限制。實際配接器為 TypeScript 5.9.3,使用 --noEmit --noLib --pretty false,以及會產生 TS2322 的可丟棄內建型別測試資料。執行時請明確提供現有且已核准的 TypeScript 根目錄。SDK 絕不自動安裝或下載外部工具;提供的雜湊不能獨立驗證其發行者。

型別、API、限制與完整可執行範例

公開 Stdio LSP 橋接器

createLspBridge 將明確核准且固定版本的 stdio 程序連接至現有 SDK 語言要求/提供者。它協商受支援的 LSP 3.17 子集、UTF-16 位置及完整快照。capabilities 分別回報宣告的支援與成功執行。支援的對應涵蓋自動完成、懸停、定義、參照、平面/階層符號、簽章提示、prepare-rename/rename、文件/範圍格式化、程式碼動作、完整語意權杖、摺疊與內嵌提示,共 15 項 SDK 功能。

syncDocument 與 closeDocument 處理 didOpen/didChange/didClose。目前版本與世代變更會取消過期工作,重複的活動要求 ID 會遭拒,延遲回覆會被忽略。本機 URI 必須解析至工作區內,且不可經過連結;來源與編輯目標需要目前授權,以及已開啟或由主機提供的精確快照。重新命名/格式化/動作結果是具有基準雜湊的條件式工作區編輯提案,不會自動套用編輯或執行命令。

只接受具有目前文件版本的診斷。無版本/過期通知會被丟棄並計數。明確不支援的功能包括完成解析/片段、程式碼動作解析、語意增量、伺服器命令、動態能力、資源操作、socket 傳輸與無版本診斷。workspace/applyEdit 傳回 applied:false。限制:訊息 1 MiB、標頭 8 KiB、工作階段 64 MiB/20,000 個訊息、16 個待處理要求與排隊寫入、32 份文件/文字合計 4 MiB、要求期限最多 30 秒,以及丟棄的 stderr 64 KiB。

close 傳送 shutdown/exit,並在限定範圍內清理直接程序/管線,區分正常確認、拒絕/當機的伺服器及實際程序關閉。伺服器可能確認關閉後,仍需停止所擁有的程序。不會自動重新啟動或重播:操作者應建立新的橋接器,明確重送所選的目前快照。合成測試涵蓋格式錯誤的框架、當機/逾時、取消/延遲回覆、文件競爭、拒絕關閉、不支援要求及所有對應功能。

實際獨立伺服器檢查使用社群 typescript-language-server 5.3.0 搭配 TypeScript 5.9.3:完成、懸停、定義、參照、符號、簽章提示、格式化與語意權杖均通過。所選實作檔案與 Node 固定版本、tsserver 路徑固定,並停用自動取得型別。此伺服器版本省略選用的 initialize.serverInfo,且傳送無版本診斷,因此本橋接器明確不支援其診斷;具有版本的診斷則以獨立合成伺服器驗證。操作者必須信任整個已安裝工具及其作業系統存取。

1.2 驗收包含獨立封裝使用端、宣告、107 個結構描述、實際編譯器/伺服器配接器及歷史公開封存檔互通。工作流程範例區分持久復原、明確重試與自動重播。依擁有者延後處理的決定,安全稽核與漏洞驗證仍待完成。本次發行不構成 DDS UI、Engine、Cloud 排程器、Marketplace、安裝程式或安全沙箱的驗收。

型別、API、限制與完整可執行範例

node node_modules/@altifigence/dds-plugin-sdk/examples/workflows/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/workflow-tools/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/lsp/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/tool-streams-browser/serve.mjs

使用實際配接器時,請加入現有且經操作者核准安裝的絕對路徑。預設範例只使用 SDK 編寫的測試資料,絕不下載工具。

node node_modules/@altifigence/dds-plugin-sdk/examples/workflow-tools/run.mjs --typescript-root /absolute/path/to/typescript
node node_modules/@altifigence/dds-plugin-sdk/examples/lsp/run.mjs --typescript-root /absolute/path/to/typescript --language-server-root /absolute/path/to/typescript-language-server