前言¶

在 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