前言¶

在 DSH 裏做智能體工作流時，常見做法是自己寫插件、或手工把某個本地工具倉庫接進 Profile。前者重複勞動多，後者又容易在掃描源碼、許可證和完整性校驗上踩坑。DeepSeek Harness 社區把插件當一等公民維護，目錄站點與 DeepSeek / 幻方無官方從屬關係；若你希望從已有本地源碼裏挑出可複用能力、生成候選插件並走校驗流程，而不是讓 Host 直接 import 項目代碼，可以看一下 BioAIEvolu 維護的工作流類插件 aios-plugin-forma（GitHub：BioAIEvolu/aios-plugin-forma，當前包版本 0.2.1，簡介標明 DSH 0.1.3+ 兼容）。

這是什麼¶

aios-plugin-forma 是 AIOS 體系下的 Forma 自構建 DSH 插件（Bundle）：給定本地源碼工程，通過版本化的 forma_* DTO 工具掃描來源、識別可複用能力、在人工審覈選擇後生成候選插件，並導出候選插件倉庫。源碼檢視與候選生成由 Supervisor 持有的子 Worker 完成；Host 不會 import 或執行源碼工程裏的代碼。

倉庫在 core/ 內嵌 Forma Core，不依賴 workspace 的 core-root 環境變量、完整 AIOS 或開發態 forma/ 樹。經 DSH Profile 進入的只有 workRoot 與調用方選定的 source root：Worker 只讀配置的 source root，只寫受管的 work root。

核心功能¶

下面介紹 README 中已寫明、且與合約文件（specs/tools.json、specs/dto.json 等）一致的能力邊界。

掃描與候選生成¶

1. 對配置的本地 source root 做能力識別與候選插件生成（默認路徑爲 proposal-only：生成 tarball 與報告，不會把生成的插件自動裝進當前運行中的 Profile）。
2. 直接基於未審覈源碼的候選生成需要顯式的 reviewed-source-root 記錄；捆綁 CLI 不會寫入此類批准，因此普通用戶選中的源碼可被掃描，但會被擋在 direct-source 生成之外。

校驗、許可證與篡改防護¶

• 內置校驗與完整性相關流程；雲安裝會在執行任何 DSH 命令前校驗 Release 資產的 SHA-256。
• 許可證掃描是工程啓發式信號，不是法律意見：GPL/LGPL/AGPL、未知或衝突的許可證證據會保持「需審覈」或阻斷，不能自動通過構建門，除非獨立構造 LicenseReviewRecord。
• 安裝記錄與 CLI 輸出會對簽名 URL、token 等敏感查詢參數做脫敏。

進程邊界與安全模型¶

• Worker 是進程邊界，不是 OS 級惡意代碼沙箱；Node permission 與子進程邊界屬於縱深防禦。不要把 Forma 指向你不願自己運行的源碼。
• 可選本地運行時設置 FORMA_NODE_PERMISSION=1 以啓用 Node 24 permission flags；兩種模式下子進程邊界與路徑檢查仍爲強制項。

當前明確不支持的能力¶

本版本 README 列出的非目標包括：自動創建/發佈 GitHub 倉庫、真實的人機 GPL/AGPL 審批工作流、已安裝 bundle 的自動更新、生產部署（僅 disposable local Profiles）。

安裝與啓用¶

插件通過包內二進制 aios-plugin-forma 安裝到指定 DSH Profile，不是隱式使用 %USERPROFILE%\.dsh：--dsh-home、--profile、--work-root、--source-root 在 CLI 中始終顯式且必填。npm install 只獲取包，npx 運行該二進制；DSH 在常規 Profile 重啓後激活 bundle，無 lifecycle 腳本改寫 Profile。DSH 插件管理依賴 pnpm；CLI 會在每次 install/uninstall 前在 caller 指定的 DSH_HOME 內解析 pnpm（PATH 上已有則直接用，否則經 corepack 在 <dsh-home>/.forma/shims 放置 shim，pinned pnpm 12.3.4），兩者都不可用則退出碼 10（PNPM_REQUIRED）。

本地 tarball 安裝（示例）¶

README 給出的 PowerShell 示例（將路徑替換爲你的 disposable 目錄與 fixture）：

npx --yes --package .\aios-plugin-forma-0.2.1.tgz aios-plugin-forma install `
  --dsh-home <disposable-dsh-home> `
  --profile forma-test `
  --work-root <disposable-work-root> `
  --source-root <fixture-root>\m1\repo-tool-mit

install 完成的是包安裝與 Profile 配置（寫入的 runtimeDigest 與當前 CLI 一致），不會連接正在運行的 DSH Host；工具是否激活需在啓動或重啓 DSH 後通過 health check 確認（JSON 輸出中 runtime_health: not_checked）。重複安裝冪等，already-installed 表示版本與配置未變且不再調用 DSH。

雲安裝（固定 Release 資產）¶

僅接受 pinned 的 GitHub Release 資產 URL（https://github.com/<owner>/<repo>/releases/download/<tag>/<asset>.tgz），不接受 main、latest 或分支歸檔：

npx --yes --package .\aios-plugin-forma-0.2.1.tgz aios-plugin-forma install `
  --dsh-home <absolute-disposable-dsh-home> --profile forma-test `
  --work-root <absolute-disposable-work-root> --source-root <absolute-source-root> `
  --package-url https://github.com/BioAIEvolu/aios-plugin-forma/releases/download/v0.2.1/aios-plugin-forma-0.2.1.tgz `
  --sha256 <64-hex-sha256-of-the-release-asset> --max-download-bytes 52428800

具體 tag 與 SHA-256 以 GitHub Release notes 爲準；摘要不匹配或響應過大時，在任何 DSH 命令運行前即失敗。

檢查與卸載¶

npx --yes --package .\aios-plugin-forma-0.2.1.tgz aios-plugin-forma inspect `
  --dsh-home <disposable-dsh-home> --profile forma-test

npx --yes --package .\aios-plugin-forma-0.2.1.tgz aios-plugin-forma uninstall `
  --dsh-home <disposable-dsh-home> --profile forma-test

CLI 默認輸出爲簡短中文狀態行（[OK]/[INFO]/[WARN]/[ERROR]，無顏色、無 emoji）；需要自動化時可加 --json（stdout 單文檔 schema_version: 1），診斷細節用 --verbose（stderr）。

典型用法¶

經過上面的安裝步驟，在 disposable Profile 中配置 work-root 與 source-root 後，通過 DSH 會話調用插件暴露的 forma_* DTO 工具完成：掃描本地倉庫、在審覈後的選擇集上生成候選插件、導出候選倉庫並附帶校驗與許可證相關報告。默認不會把候選物直接裝進當前 Profile；若要從本地 Python/JS/Go 工具倉庫把能力「帶進」會話，應把整條鏈路理解爲：掃描 → 人工選擇/許可證審查 → 生成 tarball/報告 → 再按你的發佈流程接入，而不是一鍵信任任意源碼。

本地 CLI 的 inspect 用於在不改 Profile 的前提下查看當前安裝與配置狀態；正式驗收流程見倉庫內 FORMAL-ACCEPTANCE.md 與 provenance/README.md。

適用場景與注意¶

適合誰： 需要在隔離的 disposable DSH Profile 裏，從自有或可控的本地源碼倉庫提煉 DSH 候選插件、並依賴內置校驗與許可證啓發式審查的開發者；分類上屬於社區目錄中的「工作流」類插件（目錄頁：https://www.skillhub.cn/plugins/BioAIEvolu/aios-plugin-forma）。

務必注意：

1. 插件與子 Worker 以當前 DSH/Node 進程權限運行；安裝前自行審查源碼與許可證，勿指向不可信倉庫。
2. source root 是讀邊界，不等於源碼已批准；direct-source 生成額外需要 reviewed-source-root 記錄。
3. 許可證掃描不能替代法務判斷；GPL 系與未知許可證默認不能自動過門。
4. 本版本面向本地 disposable Profile，非生產部署；Release 通過 GitHub Release 固定資產分發，不用 npm publish 作爲主通道。

結尾¶

aios-plugin-forma 把 Forma 自構建能力打成自包含 Bundle：Host 不碰源碼執行，Worker 在配置的讀寫邊界內完成掃描、候選生成與校驗，CLI 則把安裝、完整性校驗和 pnpm 解析接到明確的 DSH Profile 上。若要覈對工具合約與版本，請直接查看 GitHub 倉庫 README（含 簡體中文）與 Release 說明。

• 社區目錄：https://www.skillhub.cn/plugins/BioAIEvolu/aios-plugin-forma
• 源碼與文檔：https://github.com/BioAIEvolu/aios-plugin-forma