@liangjiehappy/dsh-plugin-mj7 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# dsh-plugin-mj7
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Read-only mj7.cn data tools for DeepSeek Harness: standards/product search, HS lookup, Incoterms, trade documents, and CNY FX rates.
+
+中文说明见 [README.zh-CN.md](README.zh-CN.md).
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `mj7_search` | Search standards, materials and industrial products by keyword |
+| `mj7_hot` | Hot categories on mj7.cn |
+| `mj7_hs` | Look up standards related to an HS code |
+| `mj7_terms` | Incoterms responsibilities |
+| `mj7_docs` | Export/trade document checklist |
+| `mj7_fx` | CNY FX rates (default USD) |
+
+## Install
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-plugin-mj7
+```
+
+## Config
+
+```yaml
+- insert:
+    - id: dsh-plugin-mj7
+      name: "@liangjiehappy/dsh-plugin-mj7"
+      config:
+        baseUrl: "https://www.mj7.cn"
+```
+
+Zero-config works; the default base URL is `https://www.mj7.cn`.
+
+## Permissions
+
+- Outbound HTTPS GET to `www.mj7.cn` only (configurable `baseUrl`)
+- No file reads or writes, no credential access, no shell
+- Read-only: no login, no orders, no writes
+
+## Limitations
+
+- Depends on public mj7.cn APIs (`/api/search`, `/api/hot`, `/api/hs`, `/api/terms`, `/api/docs`, `/api/fx`)
+- API changes can break a tool; failures surface the real HTTP error
+- Results are summaries with filters; open the site for full content

package/README.zh-CN.md

@@ -0,0 +1,46 @@
+# dsh-plugin-mj7
+
+模极社（mj7.cn）只读数据插件：在 DSH 里查标准、产品、HS 关联、贸易术语、单证和汇率。
+
+English docs: [README.md](README.md).
+
+## 工具
+
+| 工具 | 作用 |
+|---|---|
+| `mj7_search` | 关键词搜索标准/产品/材料 |
+| `mj7_hot` | 热门品类 |
+| `mj7_hs` | HS 编码联想标准 |
+| `mj7_terms` | Incoterms 术语 |
+| `mj7_docs` | 外贸单证清单 |
+| `mj7_fx` | 人民币汇率 |
+
+## 安装
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-plugin-mj7
+```
+
+## 配置
+
+```yaml
+- insert:
+    - id: dsh-plugin-mj7
+      name: "@liangjiehappy/dsh-plugin-mj7"
+      config:
+        baseUrl: "https://www.mj7.cn"
+```
+
+零配置可用，默认 https://www.mj7.cn。
+
+## 权限声明
+
+- 只对 `www.mj7.cn` 发 HTTPS GET（可配置 baseUrl）
+- 不读写文件、不读凭证、不执行 shell
+- 只读：不登录、不下单、不写数据
+
+## 限制
+
+- 依赖 mj7.cn 公开 API（`/api/search`、`/api/hot`、`/api/hs`、`/api/terms`、`/api/docs`、`/api/fx`）
+- API 变更可能导致工具失败；失败会返回真实 HTTP 错误
+- 结果只做摘要与筛选，完整内容请打开站内页面

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+- insert:
+    - id: dsh-plugin-mj7
+      name: "@liangjiehappy/dsh-plugin-mj7"
+      config:
+        baseUrl: "https://www.mj7.cn"

package/lib/core.js

@@ -0,0 +1,71 @@
+// dsh-plugin-mj7 · 纯函数：URL 构造与 API 结果摘要（无副作用、不依赖网络）
+export const DEFAULT_BASE = 'https://www.mj7.cn'
+
+export function normalizeBase(base) {
+  const b = (base || DEFAULT_BASE).trim().replace(/\/+$/, '')
+  if (!/^https?:\/\//i.test(b)) throw new Error('baseUrl 必须以 http(s):// 开头')
+  return b
+}
+
+export function buildUrl(base, path, params = {}) {
+  const u = new URL(path, base + '/')
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== undefined && v !== null && v !== '') u.searchParams.set(k, String(v))
+  }
+  return u.toString()
+}
+
+export function asLimit(n, def = 6, max = 50) {
+  const v = Number(n)
+  if (!Number.isFinite(v) || v <= 0) return def
+  return Math.min(Math.floor(v), max)
+}
+
+function pickItem(it) {
+  const out = {}
+  for (const k of ['id', 'standard_no', 'org', 'title', 'title_cn', '_title', 'name', 'code', 'cn', 'en', 'url', 'type']) {
+    if (it && it[k] !== undefined) out[k] = it[k]
+  }
+  return out
+}
+
+export function summarizeSearch(json, limit = 6) {
+  if (!json || json.code !== 200) throw new Error((json && json.msg) || 'mj7 search 失败')
+  const groups = (json.groups || []).map((g) => ({
+    key: g.key,
+    name: g.name,
+    total: g.total,
+    items: (g.items || []).slice(0, limit).map(pickItem),
+  }))
+  return { total: json.total ?? 0, kw: json.kw || '', groups }
+}
+
+export function summarizeHot(json, limit = 30) {
+  if (!json || json.code !== 200) throw new Error((json && json.msg) || 'mj7 hot 失败')
+  return { items: (json.items || []).slice(0, limit) }
+}
+
+export function summarizeHs(json, limit = 10) {
+  if (!json || json.code !== 200) throw new Error((json && json.msg) || 'mj7 hs 失败')
+  return {
+    hs: json.hs || '',
+    chapter: json.chapter || '',
+    total: (json.data || []).length,
+    items: (json.data || []).slice(0, limit).map(pickItem),
+  }
+}
+
+export function summarizeList(json, limit = 10) {
+  if (!json || json.code !== 200) throw new Error((json && json.msg) || 'mj7 查询失败')
+  return {
+    total: json.total ?? (json.data || []).length,
+    items: (json.data || []).slice(0, limit),
+  }
+}
+
+export function summarizeFx(json, currency = 'USD') {
+  if (!json || json.code !== 200) throw new Error((json && json.msg) || 'mj7 fx 失败')
+  const cur = String(currency || 'USD').toUpperCase()
+  const rates = json.rates || {}
+  return { base: json.base || 'CNY', currency: cur, rate: rates[cur] ?? null, rates }
+}

package/lib/index.js

@@ -0,0 +1,97 @@
+// dsh-plugin-mj7 · 模极社 mj7.cn 只读数据工具
+import { defineTool } from '@deepseek-ai/dsh-tools'
+import {
+  buildUrl, normalizeBase, asLimit, summarizeSearch, summarizeHot,
+  summarizeHs, summarizeList, summarizeFx,
+} from './core.js'
+
+export const name = 'dsh-plugin-mj7'
+export const inject = ['tools']
+
+const text = (value) => [{ type: 'text', text: JSON.stringify(value, null, 2) }]
+const headers = { 'user-agent': 'dsh-plugin-mj7/0.1', accept: 'application/json' }
+
+export function apply(ctx, config = {}) {
+  const base = normalizeBase(config.baseUrl)
+
+  async function getJson(path, params, signal) {
+    const r = await fetch(buildUrl(base, path, params), { headers, signal })
+    if (!r.ok) throw new Error(`mj7 API HTTP ${r.status} (${path})`)
+    return r.json()
+  }
+
+  ctx.tools.register(defineTool({
+    name: 'mj7_search',
+    description: '搜索模极社（mj7.cn）：标准、产品、材料。返回总数与分组摘要，含站内详情标识。',
+    parameters: {
+      kw: { type: 'string', required: true, description: '关键词，如“法兰”“ISO 4703”' },
+      limit: { type: 'number', description: '每组返回条数，默认 6' },
+    },
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      const json = await getJson('/api/search', { kw: args.kw }, exec.signal)
+      return summarizeSearch(json, asLimit(args.limit))
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'mj7_hot',
+    description: '模极社热门品类/关键词列表。',
+    parameters: {},
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(_args, exec) {
+      return summarizeHot(await getJson('/api/hot', {}, exec.signal))
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'mj7_hs',
+    description: '按 HS 编码联想相关标准（mj7.cn HS 检索）。',
+    parameters: {
+      code: { type: 'string', required: true, description: 'HS 编码，如 73181500' },
+      limit: { type: 'number', description: '返回条数，默认 10' },
+    },
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      const json = await getJson('/api/hs', { code: args.code }, exec.signal)
+      return summarizeHs(json, asLimit(args.limit, 10))
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'mj7_terms',
+    description: '查 Incoterms 贸易术语（EXW/FOB/CIF 等）的责任划分。',
+    parameters: { q: { type: 'string', description: '关键词，留空返回全部' } },
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      return summarizeList(await getJson('/api/terms', { q: args.q || '' }, exec.signal), 10)
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'mj7_docs',
+    description: '查外贸单证清单（商业发票、装箱单、原产地证等）。',
+    parameters: { q: { type: 'string', description: '关键词，留空返回全部' } },
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      return summarizeList(await getJson('/api/docs', { q: args.q || '' }, exec.signal), 10)
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'mj7_fx',
+    description: '查人民币汇率（基准 CNY，默认 USD）。',
+    parameters: { currency: { type: 'string', description: '目标币种，默认 USD' } },
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      return summarizeFx(await getJson('/api/fx', { from: (args.currency || 'USD') }, exec.signal),
+        args.currency || 'USD')
+    },
+  }))
+}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@liangjiehappy/dsh-plugin-mj7",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "模极社 mj7.cn 只读数据工具：标准/产品搜索、HS 联想、Incoterms、贸易单证、人民币汇率。只访问 www.mj7.cn。",
+  "type": "module",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "dsh": ">=0.2.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-tools": "*"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "mj7",
+    "standards",
+    "manufacturing",
+    "trade"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "test": "node --test"
+  }
+}