@liangjiehappy/dsh-plugin-mj7 0.1.0 → 0.1.2

package/README.md

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

@@ -22,7 +22,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mj7_search',
-    description: '搜索模极社（mj7.cn）：标准、产品、材料。返回总数与分组摘要，含站内详情标识。',
+    description: '搜索模极社（mj7.cn）：标准、产品、材料。返回总数与分组摘要，含站内详情标识。当用户要查某个标准/材料/产品关键词时使用。',
     parameters: {
       kw: { type: 'string', required: true, description: '关键词，如“法兰”“ISO 4703”' },
       limit: { type: 'number', description: '每组返回条数，默认 6' },
@@ -37,7 +37,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mj7_hot',
-    description: '模极社热门品类/关键词列表。',
+    description: '模极社热门品类/关键词列表。当用户想了解平台热门制造品类时使用。',
     parameters: {},
     output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
     isConcurrencySafe: () => true,
@@ -48,7 +48,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mj7_hs',
-    description: '按 HS 编码联想相关标准（mj7.cn HS 检索）。',
+    description: '按 HS 编码联想相关标准（mj7.cn HS 检索）。当用户给出 HS 编码要找关联标准时使用。',
     parameters: {
       code: { type: 'string', required: true, description: 'HS 编码，如 73181500' },
       limit: { type: 'number', description: '返回条数，默认 10' },
@@ -63,7 +63,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mj7_terms',
-    description: '查 Incoterms 贸易术语（EXW/FOB/CIF 等）的责任划分。',
+    description: '查 Incoterms 贸易术语（EXW/FOB/CIF 等）的责任划分。当用户问贸易术语责任时使用。',
     parameters: { q: { type: 'string', description: '关键词，留空返回全部' } },
     output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
     isConcurrencySafe: () => true,
@@ -74,7 +74,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mj7_docs',
-    description: '查外贸单证清单（商业发票、装箱单、原产地证等）。',
+    description: '查外贸单证清单（商业发票、装箱单、原产地证等）。当用户问出口需要哪些单证时使用。',
     parameters: { q: { type: 'string', description: '关键词，留空返回全部' } },
     output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
     isConcurrencySafe: () => true,
@@ -85,7 +85,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mj7_fx',
-    description: '查人民币汇率（基准 CNY，默认 USD）。',
+    description: '查人民币汇率（基准 CNY，默认 USD）。当用户问人民币兑某币种汇率时使用。',
     parameters: { currency: { type: 'string', description: '目标币种，默认 USD' } },
     output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
     isConcurrencySafe: () => true,

package/package.json

@@ -1,21 +1,25 @@
 {
   "name": "@liangjiehappy/dsh-plugin-mj7",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "模极社 mj7.cn 只读数据工具：标准/产品搜索、HS 联想、Incoterms、贸易单证、人民币汇率。只访问 www.mj7.cn。",
   "type": "module",
   "main": "lib/index.js",
   "files": [
     "lib",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md"
   ],
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
-    }
+    },
+    "permissions": [
+      "network"
+    ]
   },
   "engines": {
-    "dsh": ">=0.2.0"
+    "dsh": ">=0.2.0-rc.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "*",