前言¶
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 仓库。
