解析：安裝流程與卸載邊界如何工作)
deepseek-harness-desktop 插件市場Community Market架構(gòu)解析安裝流程與卸載邊界如何工作【免費下載鏈接】deepseek-harness-desktop為 DeepSeek Harness (DSH) 插件生態(tài)打造的現(xiàn)代化桌面端解決方案。萬物皆「插件」桌面本身也是「插件」。項目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop本文基于 deepseek-harness-desktop 倉庫內(nèi)的文檔與源碼拆解dsh-community-market包的插件市場架構(gòu)目錄來源如何歸一化、npmlatest如何成為安裝唯一信任錨、一次性確認令牌如何約束寫操作以及故障恢復的唯一入口幫助不熟悉項目內(nèi)部結(jié)構(gòu)的開發(fā)者理解其讀寫邊界并做二次開發(fā)。它要解決什么問題插件市場本質(zhì)上要回答三個問題插件從哪來、一次安裝憑什么被信任、卸載為什么不能直接執(zhí)行一條包名命令。從哪來目錄來源既可以是實現(xiàn)標準 cursor 分頁契約的匿名 JSON 服務(wù)也可以是內(nèi)置經(jīng)審查的 provider 適配器DSH 1024Store、dshfind還可以由用戶自行添加 manifest URL。各來源的 wire format 完全不同界面層只能消費一種歸一化形狀。憑什么信任安裝來源自己標注的版本、徽章、驗證標記都不算數(shù)。真正決定能否進入安裝預覽的是 npm 官方 registry 返回的latestmanifest 是否滿足一組最小條件。卸載為什么謹慎Installed 視圖列出的插件可能由本市場、其他市場或 DSH CLI 安裝。卸載前 Host 會兩次對照當前 Profile 清單復核目標而不是相信界面提交的字符串。職責與接口邊界只讀能力永遠可用寫操作只有在對應能力被注入時才存在——這是入口文件dsh-community-market/src/index.ts落地的分工契約。Market 擁有來源配置、來源適配器、歸一化發(fā)現(xiàn)normalized discovery、Client 界面、npmlatest預覽、圍繞 Profile 包操作的一次性確認。它不擁有Profile 存儲、包執(zhí)行、恢復 checkpoint、終端窗口docs/market-shell.md。依賴注入的形態(tài)如下依賴注入方式帶來的能力缺失時的降級行為webServer硬性注入inject [webServer]注冊全部/api/community-market/*路由包無法工作storageDomain軟注入按需動態(tài)import來源選擇持久化狀態(tài)僅存活于會話重啟不保留僅寫 warn 日志desktopActions可選注入失敗對話框里打開 DSH Terminal按鈕按鈕不顯示pluginManagerprofileContext可選注入二者同時在場才創(chuàng)建MarketInstallService安裝 / 卸載 / 啟停編排安裝類路由返回 503Discover、Sources 照常瀏覽npm registry 請求走一個獨立受限 client其代理例外主機名是編譯期常量而非用戶輸入const npmRegistryHttp createRestrictedHttpClient({ // This is a compiled-in official registry hostname, never provider input. syntheticProxyHostnames: [registry.npmjs.org], })一次完整操作的時間線從瀏覽到卸載選定一條插件走完全流程數(shù)據(jù)形態(tài)依次經(jīng)歷provider 原始 JSON →CatalogSnapshot歸一化條目 → 安裝候選candidate→ 一次性令牌previewId→ manager 變更結(jié)果。瀏覽標準 cursor 來源被 Host 掃描進有界本地索引掃描結(jié)果緩存 5 分鐘DEFAULT_CATALOG_SCAN_CACHE_TTL_MSdsh-community-market/src/catalog/service.ts第 74 行搜索、多分類 OR 篩選、50 條/頁的 UI 分頁都在本地執(zhí)行用戶的搜索詞從不發(fā)給 provider。dshfindadapter 固定per_page100DSHFIND_PAGE_SIZE條目上限 20000MAX_DSHFIND_ITEMS數(shù)據(jù)集必須帶sha256:前綴的 64 位 hexdata_version任一校驗失敗整批拒絕不發(fā)布部分索引dsh-community-market/src/adapters/dshfind.ts第 17-18、240-241 行。1024Storeprovider 的分頁 v2 API/api/v2/plugins直連每一次查詢頁大小上限 200 條BROWSE_PAGE_SIZE/MAX_PROVIDER_PAGE_SIZEInstallable 路由構(gòu)造limit: 200的查詢每批只物化一個 provider 頁dsh-community-market/src/host/routes.ts第 941-946 行。預覽POST /api/community-market/operations/preview只接受這兩種精確形狀字段經(jīng)boundedIdentifier校驗1–240 字符且不含\0{ action: install, sourceRecordId, itemId } { action: uninstall, packageName }Host 從本地候選表取回先前觀察到的條目observeCatalog在每次快照到達時登記請求https://registry.npmjs.org/package/latest核對包名一致、精確穩(wěn)定版本、dsh.bundle.patch安全相對路徑后簽發(fā)一個 32 字節(jié)隨機 token 作為previewId。 5.執(zhí)行POST /api/community-market/operations/execute只接受{ previewId }。令牌一次性消費Host 校驗 Profile 未變化再以精確nameversion目標調(diào)用installBundle(target, { enabled: true, saveExact: true })并斷言 manager 回報的已安裝包與驗證過的包名一致dsh-community-market/src/install/service.ts第 574-585 行。 6.卸載preview 階段調(diào)用removableBundle對照當前l(fā)istBundles復核removable標志執(zhí)行前再復核一次然后removeBundle——先取消選擇并卸載 bundle再由 pnpm 移除依賴。Renderer Host (market) pluginManager | GET catalog (cursor) | | |-------------------------| adapter - CatalogSnapshot | | POST preview {ids} | | |-------------------------| npm latest - verify - previewId | POST execute {previewId} | | |-------------------------| installBundle(nameversion) --| | |---------------- ChangeResult | |----- {packageName,version, application} |邊界與安全條件每一條為什么不能都對應一個具體常量或校驗函數(shù)而不是約定俗成。來源命令一律丟棄。1024Store 適配器只解析一種精確的惰性命令形狀dsh plugin --profile p add npm-package恰好 6 個 token提取 npm 包名后立即丟棄命令本身注釋明確 The command itself is never retained or executeddsh-community-market/src/adapters/dsh-1024store.ts第 120-139 行dshfind 只接受kind npm且verification verified的單個結(jié)構(gòu)化目標dshfind.ts第 142-167 行。來源不能聲明憑據(jù)或選擇權(quán)。標準來源 manifest URL 與目錄端點必須是無憑據(jù)的 HTTPS 443 端口readStandardSourceManifest顯式拒絕username、password、port、search、hashroutes.ts第 469-472 行provider 重定向最多 3 跳且逐跳校驗 origin 未漂移dsh-community-market/src/network/restricted-http.ts第 11、190-212 行。版本只認 npm 官方latest。stableExactVersion要求 semver 嚴格合法且無 prerelease 段manifest.name必須與候選包名完全相同來源列出的版本永不參與目標構(gòu)造service.ts第 197-201、258 行。令牌短時且一次性。關(guān)鍵常量service.ts第 25-33 行const INSTALL_INTENT_TTL_MS 5 * 60 * 1000 // 意圖 5 分鐘過期 const CANDIDATE_TTL_MS 30 * 60 * 1000 const MAX_INTENTS 256 const ACTIVATION_GRACE_MS 5000consumeIntent消費即刪除sameProfile在 preview 后 Profile 變化時拋conflict映射為 HTTP 409過期令牌映射 410見routes.ts第 90-96 行。入口僅限本機回環(huán)。marketAuthority要求源地址屬于127.0.0.0/8或::1、Host主機名恰好是127.0.0.1、端口與 webserver 一致、sec-fetch-site非cross-site寫操作額外要求Origin與 Host 完全同源routes.ts第 283-328 行。請求體上限 16 KiBMAX_BODY_BYTES。內(nèi)置 provider 的例外不擴散。兩個內(nèi)置 HTTP client 各自持有獨立體積上限——1024Store 2 MiBMAX_DSH_1024STORE_BODY_BYTES、dshfind 16 MiBMAX_DSHFIND_BODY_BYTES——主機名是編譯進 adapter 的常量用戶添加的來源絕不繼承這些本地代理例外routes.ts第 53-74 行。產(chǎn)品自有包被禁裝。BLOCKED_PRODUCT_PACKAGESdsh-plugin-desktop、dsh-plugin-desktop-beta、dsh-desktop-next、dsh-community-market在任何安裝入口都會被marketManagedPackage拒絕service.ts第 34-39、207-209 行。失敗與恢復市場自身不做回滾降級路徑與拒絕路徑被明確劃分恢復的唯一顯式入口是恢復頁面。觸發(fā)條件系統(tǒng)行為用戶可見結(jié)果pluginManager未注入安裝/卸載/啟停路由返回 503瀏覽路由不受影響Discover、Sources 可用安裝按鈕不可用routes.ts第 907-910 行目錄請求超時catalog-timeoutHTTP 504失敗附著在所選來源上提供 Retry不回退其他來源routes.ts第 104-118 行響應違反契約catalog-invalid-responseHTTP 502同上其他來源不可用catalog-unavailableHTTP 502同上preview 后 Profile 變化conflict409重復使用令牌返回intent-expired410需重新預覽manager 報告失敗或取消保留 manager 的有界 pnpm 輸出寫入 Desktop 日志絕不自動重試失敗對話框展示同一份診斷與精確命令可手動打開終端install-and-uninstall.md失敗行為表安裝結(jié)果與驗證包不符拋錯上報已裝依賴保留在 Installed 視圖供人工處理service.ts第 579-585 行條目仍可見啟用后行未即刻激活5 秒寬限期內(nèi)每 250 ms 輪詢行狀態(tài)全部 active 才判成功awaitActivationACTIVATION_GRACE_MS/ACTIVATION_POLL_MS寬限結(jié)束仍 pending 則維持失敗Renderer 在確認后關(guān)閉Host 持有g(shù)enerationController.signal繼續(xù)執(zhí)行僅響應可能丟失routes.ts第 1046-1048 行結(jié)果在下次讀取時可見恢復語義分兩層manager 負責還原它自己快照過的 Profile manifest 與 lockfile其余一切由 Desktop 的健康啟動 Profile checkpoint 覆蓋恢復永遠是恢復頁面中的顯式動作dsh-community-market/docs/market-shell.mdFailure boundary 一節(jié)。工程約束與延伸閱讀契約生成、類型檢查、單元測試、包構(gòu)建、export 驗證、Loader smoke test 必須全部 headless-safe任何一步都不得啟動 Electron——這是市場能穩(wěn)定進入 DSH Desktop 發(fā)布鏈的前提dsh-community-market/docs/market-shell.mdHeadless requirements 一節(jié)。dsh-community-market/tests/下的套件在同樣約束下運行覆蓋點包括無默認來源且不預選、顯式單來源選擇、來源失敗不回退、安裝候選 fail-closed、1024Store 命令丟棄、dshfind 數(shù)據(jù)集整批拒絕等驗收行為如contracts.spec.ts、host-routes.spec.ts、market-install.spec.ts、dshfind-adapter.spec.ts。如需本地閱讀可用git clone https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop獲取倉庫。延伸閱讀均為倉庫相對路徑dsh-community-market/docs/market-shell.md模塊歸屬、運行時形態(tài)與故障邊界的權(quán)威摘要。dsh-community-market/docs/install-and-uninstall.md安裝/卸載分步流程與完整失敗行為表。dsh-community-market/docs/catalog-provider-contract.md公開 v1 provider 契約、Schema 權(quán)威與安全邊界。dsh-community-market/src/install/service.ts驗證器、一次性令牌與 manager 編排的完整實現(xiàn)。dsh-community-market/src/host/routes.ts路由注冊、回環(huán)鑒權(quán)與錯誤碼映射?！久赓M下載鏈接】deepseek-harness-desktop為 DeepSeek Harness (DSH) 插件生態(tài)打造的現(xiàn)代化桌面端解決方案。萬物皆「插件」桌面本身也是「插件」。項目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 deepseek-harness-desktop 插件市場（Community Market）架構(gòu)解析：安裝流程與卸載邊界如何工作
deepseek-harness-desktop 插件市場Community Market架構(gòu)解析安裝流程與卸載邊界如何工作【免費下載鏈接】deepseek-harness-desktop為 DeepSeek Harness (DSH) 插件生態(tài)打造的現(xiàn)代化桌面端解決方案。萬物皆「插件」桌面本身也是「插件」。項目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop本文基于 deepseek-harness-desktop 倉庫內(nèi)的文檔與源碼拆解dsh-community-market包的插件市場架構(gòu)目錄來源如何歸一化、npmlatest如何成為安裝唯一信任錨、一次性確認令牌如何約束寫操作以及故障恢復的唯一入口幫助不熟悉項目內(nèi)部結(jié)構(gòu)的開發(fā)者理解其讀寫邊界并做二次開發(fā)。它要解決什么問題插件市場本質(zhì)上要回答三個問題插件從哪來、一次安裝憑什么被信任、卸載為什么不能直接執(zhí)行一條包名命令。從哪來目錄來源既可以是實現(xiàn)標準 cursor 分頁契約的匿名 JSON 服務(wù)也可以是內(nèi)置經(jīng)審查的 provider 適配器DSH 1024Store、dshfind還可以由用戶自行添加 manifest URL。各來源的 wire format 完全不同界面層只能消費一種歸一化形狀。憑什么信任安裝來源自己標注的版本、徽章、驗證標記都不算數(shù)。真正決定能否進入安裝預覽的是 npm 官方 registry 返回的latestmanifest 是否滿足一組最小條件。卸載為什么謹慎Installed 視圖列出的插件可能由本市場、其他市場或 DSH CLI 安裝。卸載前 Host 會兩次對照當前 Profile 清單復核目標而不是相信界面提交的字符串。職責與接口邊界只讀能力永遠可用寫操作只有在對應能力被注入時才存在——這是入口文件dsh-community-market/src/index.ts落地的分工契約。Market 擁有來源配置、來源適配器、歸一化發(fā)現(xiàn)normalized discovery、Client 界面、npmlatest預覽、圍繞 Profile 包操作的一次性確認。它不擁有Profile 存儲、包執(zhí)行、恢復 checkpoint、終端窗口docs/market-shell.md。依賴注入的形態(tài)如下依賴注入方式帶來的能力缺失時的降級行為webServer硬性注入inject [webServer]注冊全部/api/community-market/*路由包無法工作storageDomain軟注入按需動態(tài)import來源選擇持久化狀態(tài)僅存活于會話重啟不保留僅寫 warn 日志desktopActions可選注入失敗對話框里打開 DSH Terminal按鈕按鈕不顯示pluginManagerprofileContext可選注入二者同時在場才創(chuàng)建MarketInstallService安裝 / 卸載 / 啟停編排安裝類路由返回 503Discover、Sources 照常瀏覽npm registry 請求走一個獨立受限 client其代理例外主機名是編譯期常量而非用戶輸入const npmRegistryHttp createRestrictedHttpClient({ // This is a compiled-in official registry hostname, never provider input. syntheticProxyHostnames: [registry.npmjs.org], })一次完整操作的時間線從瀏覽到卸載選定一條插件走完全流程數(shù)據(jù)形態(tài)依次經(jīng)歷provider 原始 JSON →CatalogSnapshot歸一化條目 → 安裝候選candidate→ 一次性令牌previewId→ manager 變更結(jié)果。瀏覽標準 cursor 來源被 Host 掃描進有界本地索引掃描結(jié)果緩存 5 分鐘DEFAULT_CATALOG_SCAN_CACHE_TTL_MSdsh-community-market/src/catalog/service.ts第 74 行搜索、多分類 OR 篩選、50 條/頁的 UI 分頁都在本地執(zhí)行用戶的搜索詞從不發(fā)給 provider。dshfindadapter 固定per_page100DSHFIND_PAGE_SIZE條目上限 20000MAX_DSHFIND_ITEMS數(shù)據(jù)集必須帶sha256:前綴的 64 位 hexdata_version任一校驗失敗整批拒絕不發(fā)布部分索引dsh-community-market/src/adapters/dshfind.ts第 17-18、240-241 行。1024Storeprovider 的分頁 v2 API/api/v2/plugins直連每一次查詢頁大小上限 200 條BROWSE_PAGE_SIZE/MAX_PROVIDER_PAGE_SIZEInstallable 路由構(gòu)造limit: 200的查詢每批只物化一個 provider 頁dsh-community-market/src/host/routes.ts第 941-946 行。預覽POST /api/community-market/operations/preview只接受這兩種精確形狀字段經(jīng)boundedIdentifier校驗1–240 字符且不含\0{ action: install, sourceRecordId, itemId } { action: uninstall, packageName }Host 從本地候選表取回先前觀察到的條目observeCatalog在每次快照到達時登記請求https://registry.npmjs.org/package/latest核對包名一致、精確穩(wěn)定版本、dsh.bundle.patch安全相對路徑后簽發(fā)一個 32 字節(jié)隨機 token 作為previewId。 5.執(zhí)行POST /api/community-market/operations/execute只接受{ previewId }。令牌一次性消費Host 校驗 Profile 未變化再以精確nameversion目標調(diào)用installBundle(target, { enabled: true, saveExact: true })并斷言 manager 回報的已安裝包與驗證過的包名一致dsh-community-market/src/install/service.ts第 574-585 行。 6.卸載preview 階段調(diào)用removableBundle對照當前l(fā)istBundles復核removable標志執(zhí)行前再復核一次然后removeBundle——先取消選擇并卸載 bundle再由 pnpm 移除依賴。Renderer Host (market) pluginManager | GET catalog (cursor) | | |-------------------------| adapter - CatalogSnapshot | | POST preview {ids} | | |-------------------------| npm latest - verify - previewId | POST execute {previewId} | | |-------------------------| installBundle(nameversion) --| | |---------------- ChangeResult | |----- {packageName,version, application} |邊界與安全條件每一條為什么不能都對應一個具體常量或校驗函數(shù)而不是約定俗成。來源命令一律丟棄。1024Store 適配器只解析一種精確的惰性命令形狀dsh plugin --profile p add npm-package恰好 6 個 token提取 npm 包名后立即丟棄命令本身注釋明確 The command itself is never retained or executeddsh-community-market/src/adapters/dsh-1024store.ts第 120-139 行dshfind 只接受kind npm且verification verified的單個結(jié)構(gòu)化目標dshfind.ts第 142-167 行。來源不能聲明憑據(jù)或選擇權(quán)。標準來源 manifest URL 與目錄端點必須是無憑據(jù)的 HTTPS 443 端口readStandardSourceManifest顯式拒絕username、password、port、search、hashroutes.ts第 469-472 行provider 重定向最多 3 跳且逐跳校驗 origin 未漂移dsh-community-market/src/network/restricted-http.ts第 11、190-212 行。版本只認 npm 官方latest。stableExactVersion要求 semver 嚴格合法且無 prerelease 段manifest.name必須與候選包名完全相同來源列出的版本永不參與目標構(gòu)造service.ts第 197-201、258 行。令牌短時且一次性。關(guān)鍵常量service.ts第 25-33 行const INSTALL_INTENT_TTL_MS 5 * 60 * 1000 // 意圖 5 分鐘過期 const CANDIDATE_TTL_MS 30 * 60 * 1000 const MAX_INTENTS 256 const ACTIVATION_GRACE_MS 5000consumeIntent消費即刪除sameProfile在 preview 后 Profile 變化時拋conflict映射為 HTTP 409過期令牌映射 410見routes.ts第 90-96 行。入口僅限本機回環(huán)。marketAuthority要求源地址屬于127.0.0.0/8或::1、Host主機名恰好是127.0.0.1、端口與 webserver 一致、sec-fetch-site非cross-site寫操作額外要求Origin與 Host 完全同源routes.ts第 283-328 行。請求體上限 16 KiBMAX_BODY_BYTES。內(nèi)置 provider 的例外不擴散。兩個內(nèi)置 HTTP client 各自持有獨立體積上限——1024Store 2 MiBMAX_DSH_1024STORE_BODY_BYTES、dshfind 16 MiBMAX_DSHFIND_BODY_BYTES——主機名是編譯進 adapter 的常量用戶添加的來源絕不繼承這些本地代理例外routes.ts第 53-74 行。產(chǎn)品自有包被禁裝。BLOCKED_PRODUCT_PACKAGESdsh-plugin-desktop、dsh-plugin-desktop-beta、dsh-desktop-next、dsh-community-market在任何安裝入口都會被marketManagedPackage拒絕service.ts第 34-39、207-209 行。失敗與恢復市場自身不做回滾降級路徑與拒絕路徑被明確劃分恢復的唯一顯式入口是恢復頁面。觸發(fā)條件系統(tǒng)行為用戶可見結(jié)果pluginManager未注入安裝/卸載/啟停路由返回 503瀏覽路由不受影響Discover、Sources 可用安裝按鈕不可用routes.ts第 907-910 行目錄請求超時catalog-timeoutHTTP 504失敗附著在所選來源上提供 Retry不回退其他來源routes.ts第 104-118 行響應違反契約catalog-invalid-responseHTTP 502同上其他來源不可用catalog-unavailableHTTP 502同上preview 后 Profile 變化conflict409重復使用令牌返回intent-expired410需重新預覽manager 報告失敗或取消保留 manager 的有界 pnpm 輸出寫入 Desktop 日志絕不自動重試失敗對話框展示同一份診斷與精確命令可手動打開終端install-and-uninstall.md失敗行為表安裝結(jié)果與驗證包不符拋錯上報已裝依賴保留在 Installed 視圖供人工處理service.ts第 579-585 行條目仍可見啟用后行未即刻激活5 秒寬限期內(nèi)每 250 ms 輪詢行狀態(tài)全部 active 才判成功awaitActivationACTIVATION_GRACE_MS/ACTIVATION_POLL_MS寬限結(jié)束仍 pending 則維持失敗Renderer 在確認后關(guān)閉Host 持有g(shù)enerationController.signal繼續(xù)執(zhí)行僅響應可能丟失routes.ts第 1046-1048 行結(jié)果在下次讀取時可見恢復語義分兩層manager 負責還原它自己快照過的 Profile manifest 與 lockfile其余一切由 Desktop 的健康啟動 Profile checkpoint 覆蓋恢復永遠是恢復頁面中的顯式動作dsh-community-market/docs/market-shell.mdFailure boundary 一節(jié)。工程約束與延伸閱讀契約生成、類型檢查、單元測試、包構(gòu)建、export 驗證、Loader smoke test 必須全部 headless-safe任何一步都不得啟動 Electron——這是市場能穩(wěn)定進入 DSH Desktop 發(fā)布鏈的前提dsh-community-market/docs/market-shell.mdHeadless requirements 一節(jié)。dsh-community-market/tests/下的套件在同樣約束下運行覆蓋點包括無默認來源且不預選、顯式單來源選擇、來源失敗不回退、安裝候選 fail-closed、1024Store 命令丟棄、dshfind 數(shù)據(jù)集整批拒絕等驗收行為如contracts.spec.ts、host-routes.spec.ts、market-install.spec.ts、dshfind-adapter.spec.ts。如需本地閱讀可用git clone https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop獲取倉庫。延伸閱讀均為倉庫相對路徑dsh-community-market/docs/market-shell.md模塊歸屬、運行時形態(tài)與故障邊界的權(quán)威摘要。dsh-community-market/docs/install-and-uninstall.md安裝/卸載分步流程與完整失敗行為表。dsh-community-market/docs/catalog-provider-contract.md公開 v1 provider 契約、Schema 權(quán)威與安全邊界。dsh-community-market/src/install/service.ts驗證器、一次性令牌與 manager 編排的完整實現(xiàn)。dsh-community-market/src/host/routes.ts路由注冊、回環(huán)鑒權(quán)與錯誤碼映射?！久赓M下載鏈接】deepseek-harness-desktop為 DeepSeek Harness (DSH) 插件生態(tài)打造的現(xiàn)代化桌面端解決方案。萬物皆「插件」桌面本身也是「插件」。項目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考