lunw/shopline-ai-toolkit-dsh

面向 DeepSeek Harness (DSH) 的 SHOPLINE AI 工具包

🛍️ SHOPLINE AI 工具包 — 一个 DeepSeek Harness (dsh) 插件，将
SHOPLINE 开发者 MCP 官方工具与 SHOPLINE 平台知识技能 带入你的 AI 编程助手。
架构参照 Shopify AI Toolkit：Skills + Dev MCP Server + Agent Plugin。

dsh-plugin · SHOPLINE · MCP · AI Toolkit · DeepSeek Harness

English · 简体中文

English

What is this?

The Shopify AI Toolkit gives AI coding agents Shopify-aware context through three layers:
agent skills, a Dev MCP server, and per-tool plugins. This project brings the same
architecture to SHOPLINE developers working inside DeepSeek Harness (dsh):

| Layer | What you get |
| --- | --- |
| 🧠 Agent skills (skills/) | 8 SKILL.md bundles: shopline-onboarding-dev, shopline-admin-rest, shopline-graphql, shopline-oauth, shopline-webhook, shopline-sline, shopline-dev-mcp (documented behavior) + shopline-app-dev-doc-gaps (app-dev doc-gap supplement, withdrawable once official docs cover it) — endpoint URLs, signing rules, error codes, retry policies, all grounded in developer.shopline.com docs and community experience |
| 🔌 Dev MCP bridge | The official SHOPLINE Developer MCP (@shoplineos/shopline-developer-mcp, local stdio, no auth) is wired through dsh's native MCP client — tools appear as mcp__shopline__search_shopline_docs, mcp__shopline__get_admin_rest_endpoint_detail, mcp__shopline__get_graphql_schema, mcp__shopline__validate_graphql_codes, … |
| 🎛️ Optional community MCP | sline.dev server (@shopline/dev-mcp) adds mcp__sline__introspect_admin_schema, mcp__sline__validate_theme, … (commented out by default) |
| 📦 dsh bundle | cordis.patch.yml + lib/index.js, installable with dsh plugin --profile  add shopline-ai-toolkit-dsh |

Install

See docs/install.md. Quick start (full bundle):

dsh plugin --profile web add shopline-ai-toolkit-dsh
add "shopline-ai-toolkit-dsh" to dsh.profile.bundles in ~/.dsh/profiles/web/package.json
dsh web

Skills-only: cp -R skills/* ~/.dsh/skills/

Example

"Search the SHOPLINE Admin REST endpoints for products, then give me the full endpoint
detail for updating a product variant, including request parameters and a curl example."

The agent loads shopline-admin-rest + shopline-dev-mcp skills and calls
mcp__shopline__search_admin_rest_endpoints → mcp__shopline__get_admin_rest_endpoint_detail.

More prompts: examples/prompts.md · Design: docs/architecture.md

Repo layout

├── package.json          # dsh bundle manifest (dsh.bundle.patch)
├── cordis.patch.yml      # bundle patch：mcp-shopline 桥接 + shopline-toolkit 插件
├── lib/index.js          # Cordis 插件：将 skills/* 注册到 ctx.skills
├── skills/               # 8 个 SHOPLINE agent 技能（SKILL.md 包；app-dev-doc-gaps 可撤回）
├── mcp/mcp.shopline.json # 开箱即用的 MCP 客户端配置（Cursor/Claude/DSH）
├── docs/                 # architecture.md · install.md
└── examples/prompts.md   # 可复制粘贴的提示词（EN/中文）

许可证

MIT。与 SHOPLINE 无关联；官方文档和 npm 包仍是唯一权威来源。

简体中文

这是什么？

Shopify AI Toolkit 通过三层结构让 AI 编程助手获得 Shopify 平台上下文：agent 技能 (skills)、
Dev MCP 服务器、以及各 AI 工具的插件。本项目把同样的架构带给在 DeepSeek Harness (dsh)
中开发的 SHOPLINE 开发者：

| 层 | 内容 |
| --- | --- |
| 🧠 Agent 技能（skills/） | 8 个 SKILL.md 技能：shopline-onboarding-dev（入门）、shopline-admin-rest（REST API）、shopline-graphql（GraphQL）、shopline-oauth（授权与签名）、shopline-webhook、shopline-sline（模板引擎）、shopline-dev-mcp（MCP 工具用法，均为官方已文档化行为）+ shopline-app-dev-doc-gaps（应用开发文档盲区补充，官方文档补齐后逐条撤回）。端点、签名规则、错误码、重试策略均来自 developer.shopline.com 官方文档与 community.shoplineapp.cn 社区实践 |
| 🔌 Dev MCP 桥接 | 通过 dsh 原生 MCP 客户端接入官方 SHOPLINE 开发者 MCP（@shoplineos/shopline-developer-mcp，本地 stdio、免鉴权）。工具以 mcp__shopline__search_shopline_docs、mcp__shopline__get_admin_rest_endpoint_detail、mcp__shopline__get_graphql_schema、mcp__shopline__validate_graphql_codes 等形式直接可用 |
| 🎛️ 可选社区 MCP | sline.dev 服务器（@shopline/dev-mcp）提供 mcp__sline__introspect_admin_schema（Admin GraphQL Schema 内省）、mcp__sline__validate_theme（Sline 模板校验）等，默认注释、按需开启 |
| 📦 dsh 插件包 | cordis.patch.yml + lib/index.js，一条命令安装：dsh plugin --profile  add shopline-ai-toolkit-dsh |

安装

详见 docs/install.md。快速开始（完整插件）：

dsh plugin --profile web add shopline-ai-toolkit-dsh
在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中加入 "shopline-ai-toolkit-dsh"
dsh web

只想用技能：cp -R skills/* ~/.dsh/skills/

示例

「搜索 SHOPLINE Admin REST 端点中商品相关接口，然后给出更新商品变体的完整端点详情，
包括请求参数和 curl 示例。」

助手会加载 shopline-admin-rest 与 shopline-dev-mcp 技能，并依次调用
mcp__shopline__search_admin_rest_endpoints → mcp__shopline__get_admin_rest_endpoint_detail。

更多示例： examples/prompts.md · 设计文档：docs/architecture.md

仓库结构

├── package.json          # dsh bundle 清单（dsh.bundle.patch）
├── cordis.patch.yml      # bundle patch：mcp-shopline 桥接 + shopline-toolkit 插件
├── lib/index.js          # Cordis 插件：将 skills/* 注册到 ctx.skills
├── skills/               # 8 个 SHOPLINE 技能（SKILL.md 包；app-dev-doc-gaps 可撤回）
├── mcp/mcp.shopline.json # 开箱即用的 MCP 客户端配置（Cursor/Claude/DSH）
├── docs/                 # architecture.md · install.md
└── examples/prompts.md   # 可直接复制的提示词（中/英）

许可证

MIT。本项目与 SHOPLINE 无隶属关系；官方文档与 npm 包始终是权威依据。