前言¶

在 DeepSeek Harness（DSH）裏做 SHOPLINE 開發時，助手需要經常處理 SHOPLINE 平臺上下文：Admin REST 端點、GraphQL schema、OAuth、webhook、Sline 模板，以及應用開發文檔裏容易踩坑的部分。

lunw/shopline-ai-toolkit-dsh 是一個 DSH 插件。它把官方 SHOPLINE Developer MCP 工具與 SHOPLINE 平臺知識技能帶入 AI 編程助手，架構參照 Shopify AI Toolkit：Skills + Dev MCP Server + Agent Plugin。

插件定位¶

這是一個面向 SHOPLINE 開發者的 DSH 插件，倉庫由 lunw 維護，許可證爲 MIT。

它主要解決兩件事：

1. 把 SHOPLINE 平臺知識整理成 agent 技能。
2. 把官方 SHOPLINE Developer MCP 通過 DSH 原生 MCP 客戶端接入。

核心功能¶

8 個 SKILL.md 技能¶

插件包含 8 個 SKILL.md 技能：

• shopline-onboarding-dev
• shopline-admin-rest
• shopline-graphql
• shopline-oauth
• shopline-webhook
• shopline-sline
• shopline-dev-mcp
• shopline-app-dev-doc-gaps

其中，shopline-app-dev-doc-gaps 是應用開發文檔盲區補充。官方文檔補齊後，可以撤回對應內容。

接入官方 SHOPLINE Developer MCP¶

插件通過 DSH 原生 MCP 客戶端接入官方 SHOPLINE Developer MCP：

• 包名：@shoplineos/shopline-developer-mcp
• 運行方式：本地 stdio
• 鑑權方式：免鑑權

接入後，相關工具會以 MCP 工具形式出現在助手中，例如：

mcp__shopline__search_shopline_docs
mcp__shopline__get_admin_rest_endpoint_detail
mcp__shopline__get_graphql_schema
mcp__shopline__validate_graphql_codes
mcp__shopline__search_admin_rest_endpoints

可選社區 MCP¶

插件還提供一個可選社區 MCP：sline.dev，對應包名爲 @shopline/dev-mcp。

它提供類似以下工具：

mcp__sline__introspect_admin_schema
mcp__sline__validate_theme

該部分默認註釋，按需開啓。

DSH bundle¶

這個插件作爲 DSH bundle 使用，由以下文件組成：

cordis.patch.yml
lib/index.js

安裝與啓用¶

package.json 要求 node >=18.0.0。

安裝完整插件¶

先執行：

dsh plugin --profile web add shopline-ai-toolkit-dsh

然後確認 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中加入：

"shopline-ai-toolkit-dsh"

最後運行：

dsh web

只使用技能¶

如果只想使用技能，可以把技能目錄複製到 DSH 技能目錄：

cp -R skills/* ~/.dsh/skills/

典型用法¶

下面是一個可復現的用法。

1、在 DSH 會話中提出需求：

搜索 SHOPLINE Admin REST 端點中商品相關接口，並給出更新商品變體的完整端點詳情、請求參數和 curl 示例。

2、助手加載相關技能：

shopline-admin-rest
shopline-dev-mcp

3、助手調用官方 SHOPLINE Developer MCP 工具：

mcp__shopline__search_admin_rest_endpoints
mcp__shopline__get_admin_rest_endpoint_detail

經過上面的步驟，助手可以先搜索端點，再讀取具體端點詳情。

適用場景與注意¶

適合在 DSH 中進行 SHOPLINE 開發的人使用，尤其是需要處理以下內容的場景：

• SHOPLINE Admin REST
• SHOPLINE GraphQL
• OAuth
• webhook
• Sline
• SHOPLINE Developer MCP 工具調用
• 應用開發文檔盲區補充

使用前注意：

• 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
• 本項目與 SHOPLINE 無隸屬關係。
• 官方文檔與 npm 包始終是權威依據。
• 可選社區 MCP 默認註釋，需要時再開啓。
• shopline-app-dev-doc-gaps 是文檔盲區補充，官方文檔補齊後可撤回。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

項目鏈接¶

• GitHub：https://github.com/lunw/shopline-ai-toolkit-dsh
• 目錄頁：可在插件目錄中搜索 shopline-ai-toolkit-dsh