lunw/shopline-ai-toolkit-dsh

🛍️ SHOPLINE AI Toolkit — a DeepSeek Harness (dsh) plugin that brings 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 <name> 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 bridge + shopline-toolkit plugin
├── lib/index.js          # Cordis plugin: registers skills/* on ctx.skills
├── skills/               # 8 SHOPLINE agent skills (SKILL.md bundles; app-dev-doc-gaps is withdrawable)
├── mcp/mcp.shopline.json # ready-to-use MCP client configs (Cursor/Claude/DSH)
├── docs/                 # architecture.md · install.md
└── examples/prompts.md   # copy-paste prompts (EN/中文)

License

MIT. Not affiliated with SHOPLINE; official docs and npm packages remain the source of truth.

---

简体中文

这是什么？

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 <name> 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 包始终是权威依据。