fix: sdk issue

tombcato · tombcato · commit 7b23b5c0d412 · 2026-02-12T21:54:53.000+08:00
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,6 @@
+
+node_modules/
+.npmrc
+dist/
+.DS_Store
+.env
diff --git a/README.md b/README.md
@@ -52,9 +52,15 @@ import { get, search } from 'china-zipcode-adcode';
 const region = await get('110101');
 console.log(region);
 
-// 2. 模糊搜索
-const results = await search('朝阳');
-console.log(results);
+// 2. 搜索 (支持组合条件)
+// 搜索 "朝阳"
+const res1 = await search('朝阳'); 
+
+// 搜索 "朝阳" 且城市包含 "北京"
+const res2 = await search('朝阳', '北京');
+
+// 搜索 "朝阳" 且省份包含 "吉林"
+const res3 = await search('朝阳', null, '吉林');
 ```
 
 ### 使用 (浏览器 CDN)
diff --git a/index.d.ts b/index.d.ts
@@ -15,10 +15,12 @@ export interface Region {
 export function get(code: string): Promise<Region | null>;
 
 /**
- * 模糊搜索 (匹配名称、拼音、邮编)
- * @param keyword 关键词
+ * 组合条件搜索
+ * @param name 必需，区县名称或关键词
+ * @param city 可选，城市名称
+ * @param province 可选，省份名称
  */
-export function search(keyword: string): Promise<Region[]>;
+export function search(name: string, city?: string, province?: string): Promise<Region[]>;
 
 /**
  * 获取所有数据
diff --git a/index.html b/index.html
@@ -1,49 +1,76 @@
 <!DOCTYPE html>
 <html lang="zh-CN">
+
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>China Zipcode SDK Demo</title>
     <style>
-        body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; max-width: 800px; margin: 2rem auto; padding: 0 1rem; }
-        input { padding: 8px; width: 300px; font-size: 16px; }
-        button { padding: 8px 16px; font-size: 16px; cursor: pointer; }
-        #results { margin-top: 20px; }
-        .item { border-bottom: 1px solid #eee; padding: 10px 0; }
-        .code { color: #666; font-size: 0.9em; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+            max-width: 800px;
+            margin: 2rem auto;
+            padding: 0 1rem;
+        }
+
+        input {
+            padding: 8px;
+            width: 300px;
+            font-size: 16px;
+        }
+
+        button {
+            padding: 8px 16px;
+            font-size: 16px;
+            cursor: pointer;
+        }
+
+        #results {
+            margin-top: 20px;
+        }
+
+        .item {
+            border-bottom: 1px solid #eee;
+            padding: 10px 0;
+        }
+
+        .code {
+            color: #666;
+            font-size: 0.9em;
+        }
     </style>
 </head>
+
 <body>
-    <h1>中国行政区划查询 Demo</h1>
+    <h1>中国邮编数据</h1>
     <p>仅需加载 JS SDK，数据自动从 jsDelivr CDN 获取。</p>
-    
+
     <div>
         <input type="text" id="searchInput" placeholder="输入地名、拼音或邮编">
         <button onclick="doSearch()">搜索</button>
     </div>
 
     <div id="results"></div>
 
-    <!-- 模拟 UMD 引用 (实际开发中应使用打包后的文件) -->
+    <!-- 使用发布后的 CDN 版本 -->
     <script type="module">
-        // 由于没有构建步骤，这里直接 import 源码演示 ESM 模块加载
-        // 注意：浏览器直接运行 ESM 需要 http服务器
-        import { search, get } from './src/index.js';
+        // 引用 NPM 包中的源码 (也可以引用打包后的 dist 文件如果做了打包)
+        import { search, get } from 'https://cdn.jsdelivr.net/npm/@tombcato/china-zipcode-data@1.0.0/src/index.js';
 
         // 挂载到 window 方便演示
-        window.doSearch = async function() {
+        window.doSearch = async function () {
             const keyword = document.getElementById('searchInput').value;
             if (!keyword) return;
 
             document.getElementById('results').innerHTML = '查询中...';
-            
+
             try {
                 const start = performance.now();
                 const list = await search(keyword);
                 const end = performance.now();
 
                 let html = `<p>找到 ${list.length} 条结果 (耗时 ${(end - start).toFixed(2)}ms)</p>`;
-                
+
                 list.slice(0, 50).forEach(item => {
                     html += `
                         <div class="item">
@@ -52,7 +79,7 @@ <h1>中国行政区划查询 Demo</h1>
                         </div>
                     `;
                 });
-                
+
                 if (list.length > 50) {
                     html += '<p>...仅显示前 50 条...</p>';
                 }
@@ -65,4 +92,5 @@ <h1>中国行政区划查询 Demo</h1>
         }
     </script>
 </body>
-</html>
+
+</html>
diff --git a/package.json b/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "china-zipcode-adcode",
-  "version": "1.0.0",
+  "name": "@tombcato/china-zipcode-data",
+  "version": "1.0.1",
   "description": "本项目包含中国省市区县的 Adcode 和 Zipcode 对应数据。\r 数据来源于网络整理。",
   "main": "src/index.js",
   "types": "index.d.ts",
-  "type": "commonjs",
+  "type": "module",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
diff --git a/src/data-loader.js b/src/data-loader.js
@@ -6,16 +6,24 @@ let data = null;
 // CDN 地址模板，发布时请替换用户名和仓库名
 const CDN_URL = "https://cdn.jsdelivr.net/gh/tombcato/china-zipcode-data@main/china_zipcode_adcode.json";
 
-async function loadData() {
+export async function loadData() {
     if (data) return data;
 
     if (isNode) {
         // Node.js 环境：读取本地文件
         try {
-            const fs = require('fs');
-            const path = require('path');
+            // 在 ESM 中使用 fs 需要 import
+            const fs = await import('fs');
+            const path = await import('path');
+            const { fileURLToPath } = await import('url');
+
+            // 获取 __dirname 的 ESM 写法
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = path.dirname(__filename);
+
             // 假设数据文件在 SDK 根目录下
             const filePath = path.join(__dirname, '../china_zipcode_adcode.json');
+
             if (fs.existsSync(filePath)) {
                 const raw = fs.readFileSync(filePath, 'utf-8');
                 data = JSON.parse(raw);
@@ -49,11 +57,6 @@ async function fetchFromCDN() {
  * 手动设置数据（用于预加载或自定义数据源）
  * @param {Array} customData 
  */
-function setData(customData) {
+export function setData(customData) {
     data = customData;
 }
-
-module.exports = {
-    loadData,
-    setData
-};
diff --git a/src/index.js b/src/index.js
@@ -1,47 +1,59 @@
-const { loadData, setData } = require('./data-loader');
+import { loadData, setData as _setData } from './data-loader.js';
 
 /**
  * 根据 adcode 精确查找
  * @param {string} code 行政区划代码
  * @returns {Promise<Object|null>}
  */
-async function get(code) {
+export async function get(code) {
     const list = await loadData();
     if (!list) return null;
     return list.find(item => item.code === String(code)) || null;
 }
 
 /**
- * 模糊搜索
- * @param {string} keyword 省/市/区/拼音 关键词
+ * 组合条件搜索
+ * @param {string} name 必需，区县名称或关键词
+ * @param {string} [city] 可选，城市名称(包含即可)
+ * @param {string} [province] 可选，省份名称(包含即可)
  * @returns {Promise<Array>}
  */
-async function search(keyword) {
-    if (!keyword) return [];
+export async function search(name, city, province) {
+    if (!name) return [];
     const list = await loadData();
     if (!list) return [];
 
-    const key = String(keyword).toLowerCase();
-    return list.filter(item =>
-        (item.name && item.name.includes(key)) ||
-        (item.province && item.province.includes(key)) ||
-        (item.city && item.city.includes(key)) ||
-        (item.pinyin && item.pinyin.includes(key)) ||
-        (item.zipCode && item.zipCode.includes(key))
-    );
+    const keyName = String(name).toLowerCase();
+    const keyCity = city ? String(city).toLowerCase() : null;
+    const keyProvince = province ? String(province).toLowerCase() : null;
+
+    return list.filter(item => {
+        // 1. name 必须包含
+        const matchName = (item.name && item.name.includes(keyName)) ||
+            (item.pinyin && item.pinyin.includes(keyName));
+
+        if (!matchName) return false;
+
+        // 2. 如果传了 city，city 必须包含
+        if (keyCity && (!item.city || !item.city.includes(keyCity))) {
+            return false;
+        }
+
+        // 3. 如果传了 province，province 必须包含
+        if (keyProvince && (!item.province || !item.province.includes(keyProvince))) {
+            return false;
+        }
+
+        return true;
+    });
 }
 
 /**
  * 获取所有数据
  * @returns {Promise<Array>}
  */
-async function getAll() {
+export async function getAll() {
     return await loadData();
 }
 
-module.exports = {
-    get,
-    search,
-    getAll,
-    setData // 暴露给需要手动注入数据的场景
-};
+export const setData = _setData;
diff --git a/test.js b/test.js
@@ -1,20 +1,28 @@
 
-const { get, search } = require('./src/index');
+import { get, search } from './src/index.js';
 
 async function test() {
-    console.log('--- 测试 SDK ---');
+    console.log('--- 测试 SDK (ESM) ---');
 
-    // 1. 测试精确查找
+    // 1. 精确查找
     const dongcheng = await get('110101');
-    console.log('精确查找 110101:', dongcheng ? '成功' : '失败', dongcheng);
+    console.log('[测试1] 精确查找 110101:', dongcheng ? '✅' : '❌', dongcheng?.name);
 
-    // 2. 测试模糊搜索
-    const results = await search('朝阳');
-    console.log('搜索 "朝阳":', results.length > 0 ? `成功 (${results.length}条)` : '失败');
+    // 2. 基础搜索
+    const res1 = await search('朝阳');
+    console.log(`[测试2] 搜索 "朝阳": ${res1.length}条`);
 
-    if (results.length > 0) {
-        console.log('第一条结果:', results[0]);
-    }
+    // 3. 组合搜索 (带城市)
+    const res2 = await search('朝阳', '北京');
+    console.log(`[测试3] 搜索 "朝阳" + City="北京": ${res2.length}条`);
+
+    // 4. 组合搜索 (带省份)
+    const res3 = await search('朝阳', null, '吉林');
+    console.log(`[测试4] 搜索 "朝阳" + Province="吉林": ${res3.length}条`);
+
+    // 5. 组合搜索 (不存在的)
+    const res4 = await search('朝阳', '上海');
+    console.log(`[测试5] 搜索 "朝阳" + City="上海": ${res4.length}条 (预期0)`);
 }
 
 test();

-Original file line number
+Diff line change
@@ @@ -0,0 +1,6 @@ @@
++
 +node_modules/
 +.npmrc
 +dist/
 +.DS_Store
 +.env