前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在開發或演示智能體應用時，往往需要一套標準化的數據展示或業務模擬環境。guannan1031/dsh-commerce-cockpit 插件正是爲此設計，它提供了一個可運行的電商經營駕駛艙，支持 Demo 數據演示與 CSV 數據導入兩種模式，解決了從無到有搭建電商數據看板的需求。
插件簡介¶
這是一個由 guannan1031 維護的 DeepSeek Harness 客戶端插件。它主要用於展示經營看板、進行數據完整性檢查以及提供規則式問數能力。插件目前發佈在 GitHub，採用 MIT 許可證。
核心功能¶
插件包含以下已覈實功能：
- 經營總覽：展示銷售額、推廣花費、訂單數、轉化率、客單價及趨勢。
- 模式支持：
- Demo 模式：使用內置種子快照，支持估算經營貢獻利潤、模擬庫存和演示行動清單。
- Imported 模式：讀取本地 CSV 文件，展示 CSV 實際提供的指標。 - 數據完整性檢查：識別缺失字段和不可計算項。
- Markdown 導出：生成一頁經營簡報。
- 規則式問數：通過
cockpit_ask接口支持趨勢分析、渠道對比和投放產出比計算。
安裝與啓用¶
使用 DeepSeek Harness 官方插件機制安裝：
dsh plugin --profile web add @guannan1031/dsh-commerce-cockpit@0.1.2
dsh plugin --profile desktop add @guannan1031/dsh-commerce-cockpit@0.1.2
安裝完成後，重啓對應的 Harness profile，在會話頂部找到“駕駛艙”入口即可使用。
典型用法¶
插件提供兩種運行模式，根據數據來源選擇。
Demo 模式¶
默認模式，無需額外配置。系統使用固定種子快照，適合快速查看看板效果和測試 cockpit_ask 規則。
Imported 模式¶
將 CSV 文件放置在 $DSH_HOME/imports/commerce-cockpit/ 目錄下（DSH_HOME 未設置時使用 ~/.dsh）。插件僅讀取該目錄下的文件，不回退到 Demo 數據。
CSV 字段要求¶
文件需爲 UTF-8 編碼，最大 5MB，最多 50000 行。最小字段集如下：
business_date,platform,store_id,channel,gmv,orders,visitors,ad_spend
唯一鍵爲 business_date + platform + store_id + channel。注意：空值與 0 視爲不同，訂單爲 0 時無法計算客單價，訪客爲 0 時無法計算轉化率，推廣費爲 0 時無法計算整體投放產出比。
適用場景與注意¶
使用該插件時需注意以下事實與限制：
- 口徑說明：
- Demo 模式中的“估算經營貢獻利潤”是演示公式，不包含真實退款、倉儲和物流口徑。
- “整體投放產出比”僅代表GMV / 推廣費，不代表廣告歸因 ROI。
- Imported 模式只回答有源數據支持的問題；缺少必要字段時會明確拒答。 - 功能邊界：
- 不連接真實電商平臺，無 API 調用、自動任務執行、真實庫存或競品監控。
- Demo 中的庫存與競品僅爲模擬。
- 不處理消費者個人信息。
總結¶
該插件是一個功能完整的演示層，適合開發者用來搭建電商數據分析的基準環境。更多細節可參考項目目錄或 GitHub 倉庫。
