SHOPLINE 开发助手 lunw/shopline-ai-toolkit-dsh

SHOPLINE AI Toolkit for DeepSeek Harness (DSH)

🛍️ SHOPLINE AI Toolkit —— 一个 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 · 简体中文

What is this?

Shopify AI Toolkit 通过三层结构，让 AI 编程智能体获得 Shopify 相关的上下文：智能体技能、Dev MCP 服务器，以及按工具划分的插件。本项目把这套架构搬到了在 DeepSeek Harness (dsh) 里干活的 SHOPLINE 开发者面前：

| 层 | 你能拿到什么 |
| 🧠 智能体技能（skills/） | 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（应用开发文档缺口补充，官方文档覆盖后可撤下）—— 端点 URL、签名规则、错误码、重试策略，全部以 developer.shopline.com 文档和社区经验为依据 |
| 🔌 Dev MCP 桥接 | 官方 SHOPLINE Developer MCP（@shoplineos/shopline-developer-mcp，本地 stdio，无需鉴权）通过 dsh 原生 MCP 客户端接入 —— 工具以 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、mcp__sline__validate_theme 等（默认注释掉） |
| 📦 dsh 包 | cordis.patch.yml + lib/index.js，用 dsh plugin --profile <name> add shopline-ai-toolkit-dsh 安装 |

Install

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

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

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

兼容性：支持 dsh 0.1.x（rc.6+）和 0.2.x（rc.2+）运行时 —— peer 范围
^0.1.0-rc.6 || ^0.2.0-rc.2。MCP 桥接使用运行时自带的
@deepseek-ai/dsh-mcp-client。更新已有安装（git spec / npm / 本地路径）的说明见 docs/install.md。

Example

“在 SHOPLINE Admin REST 端点里搜一下 products，然后把更新商品变体的完整端点详情给我，包括请求参数和 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 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/中文)

许可证

MIT。与 SHOPLINE 无隶属关系；官方文档和 npm 包始终是权威来源。

这是什么？

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

| 层 | 内容 |
| 🧠 智能体技能（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/

兼容性：支持 dsh 0.1.x（rc.6+）与 0.2.x（rc.2+）运行时，peer 范围
^0.1.0-rc.6 || ^0.2.0-rc.2；MCP 桥接使用运行时自带的 @deepseek-ai/dsh-mcp-client。
已安装插件的更新方式（GitHub / npm / 本地路径）见 docs/install.md。

示例

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