智能體在 DeepSeek Harness（DSH）會話中可以快速生成報告、圖表、圖片或 PDF。但要在對話歷史中定位這些產物並追溯其來源，通常需要離開當前會話或依賴外部工具。Artifact Harbor 專爲 DSH Web 設計，在會話頭部提供原生的“Artifacts”入口，將智能體生成的文件錨定在對應的 Workspace 中，實現安全的預覽與溯源。
核心能力¶
Artifact Harbor 作爲一個本地優先的產物瀏覽器，提供以下功能：
- 多格式支持：支持 Markdown、HTML、PNG/JPEG/WebP、SVG 和 PDF 的預覽。
- 完整元數據：展示文件的路徑、MIME 類型、大小、時間戳、SHA-256 校驗和以及 Git 狀態。
- 可解釋溯源：明確標註產物的歸屬關係（Session、Turn、Tool Call）及置信度（exact、temporal 或 unknown）。
- 安全邊界：基於 realpath 限制路徑訪問範圍、限制讀取大小、進行內容清洗、應用嚴格 CSP（禁止網絡請求、導航、腳本執行），並使用空 iframe 沙箱渲染。
- 會話原生體驗：UI 集成在 DSH Web 內部，不依賴桌面端獨立查看器。
- 實時索引：通過防抖的文件監聽器，實時更新文件列表，支持創建、編輯、重命名和刪除操作。
- 工作區隔離：僅在工作區範圍內進行發現，不掃描用戶主目錄。
安裝與啓用¶
Artifact Harbor 目前未發佈至公開 npm 倉庫，需從源碼構建並安裝。在開始之前，請確保你的環境滿足兼容性要求：DeepSeek Harness 版本爲 @deepseek-ai/dsh@0.1.1-rc.2，Node.js 版本爲 ^22.19.0 或 >=24.0.0，pnpm 版本爲 10.20.0。
- 克隆倉庫並進入目錄：
git clone https://github.com/bleakbelladonnals/dsh-artifact-harbor.git
cd dsh-artifact-harbor
- 啓用 Corepack 並安裝依賴、構建項目、打包爲 tarball：
corepack enable
pnpm install --frozen-lockfile
pnpm build
npm pack --ignore-scripts
- 將打包的插件添加到 DSH Web 配置中並啓動 Web 界面：
dsh plugin --profile web add "$PWD/dsh-artifacts-0.1.0.tgz"
dsh web
典型用法¶
安裝成功後，打開一個 cwd 指向已註冊 Workspace 的 Session。在會話頭部會出現 Artifacts 按鈕。點擊該按鈕即可查看當前會話生成的所有受支持文件。文件列表會隨着 Workspace 內文件的變化自動刷新。
適用場景與注意事項¶
- 適用對象：需要在會話上下文中管理和審查智能體生成內容的開發者或架構師。
- 社區項目：Artifact Harbor 是社區項目，非 DeepSeek 官方產品。
- 版本限制：v0.1 目前是開發者預覽版，固定兼容 DSH
0.1.1-rc.2。 - 內容信任：所有產物內容均被視爲不可信，即使是由智能體自身創建。在處理不可信 Workspace 時，請務必閱讀
SECURITY.md文檔。 - 安全機制：HTML 和 SVG 文件會在 Host 端進行清洗，並附帶嚴格的 CSP（禁止網絡、腳本、表單提交等），渲染時不執行腳本或允許跨域訪問。
- 路徑安全：絕對路徑、遍歷變體以及試圖逃逸 Workspace 的符號鏈接將被拒絕訪問（fail closed）。
卸載¶
如需移除插件，請執行以下命令：
dsh plugin --profile web remove dsh-artifacts
卸載將釋放路由、SSE 流、監聽器和內存索引。相關的相對元數據可能保留在 $DSH_HOME/state/dsh-artifacts 中，但產物內容和 Session 日誌不會被緩存。
Artifact Harbor 基於 MIT 許可證開源，旨在爲本地優先的智能體工作流提供安全、可追溯的文件管理能力。項目地址與詳細文檔可參考其 GitHub 倉庫。
