harmonyos-guides-mcp 0.1.0 → 0.2.0

package/README.md

@@ -37,6 +37,31 @@
 |------|------|------|
 | `BP_DOCS_DIR` | 包内 `data/docs` | 文档目录(一般无需改) |
 
+## 更新
+
+指南文档和服务器会持续更新(版本号见 `package.json`)。
+
+**更新服务器**:
+
+```bash
+# npx -y 方式:无需手动操作,每次启动自动拉最新版
+# 全局安装方式:手动更新
+npm update -g harmonyos-guides-mcp
+# 或锁定最新版
+npm install -g harmonyos-guides-mcp@latest
+```
+
+更新后**重启 AI 客户端**(Claude Code / opencode / Cursor 等),让新进程加载新版 MCP。
+
+**更新文档**:5489 篇指南随包内置(`data/docs/`),更新 npm 包即同步更新,无需单独操作。guides 为纯文档,无代码包。
+
+**查看版本**:
+```bash
+npm view harmonyos-guides-mcp version   # 最新发布版
+npm ls -g harmonyos-guides-mcp          # 本地已装版本
+```
+或看客户端 MCP 面板里服务器的 `version` 字段。
+
 ## 与 best-practices 并列使用(opencode 示例)
 
 ```json

package/dist/data.js

@@ -32,7 +32,7 @@ function parseCrawlLog(docsDir) {
         const segs = fullPath.split(SEP).map((s) => s.trim()).filter(Boolean);
         const topic = segs[0] || "未分类";
         const title = segs.length ? segs[segs.length - 1] : docId;
-        docs.set(docId, { docId, title, path: fullPath, topic });
+        docs.set(docId, { docId, title, path: fullPath, topic, headings: "" });
     }
     return docs;
 }
@@ -53,9 +53,38 @@ export function getStore() {
         arr.push(meta.docId);
         topics.set(meta.topic, arr);
     }
+    // Preload all markdown headings — section-level signal for search (covers full doc).
+    for (const meta of docs.values()) {
+        meta.headings = extractHeadings(docsDir, meta.docId);
+    }
     _store = { docs, topics, docsDir };
     return _store;
 }
+/** Extract all markdown heading texts from a doc, joined by space. Light & full-text. */
+export function extractHeadings(docsDir, docId) {
+    const file = path.join(docsDir, `${docId}.md`);
+    let text;
+    try {
+        text = fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return "";
+    }
+    const heads = [];
+    for (const line of text.split(/\r?\n/)) {
+        const m = line.match(/^#{1,6}\s+(.+?)\s*#*\s*$/);
+        if (m) {
+            const clean = m[1]
+                .replace(/\*\*/g, "")
+                .replace(/`([^`]+)`/g, "$1")
+                .replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
+                .trim();
+            if (clean)
+                heads.push(clean);
+        }
+    }
+    return heads.join("  ");
+}
 /** Read a guide's full markdown body. Returns null if missing. */
 export function readDoc(docsDir, docId) {
     const file = path.join(docsDir, `${docId}.md`);

package/dist/search.js

@@ -56,6 +56,8 @@ export function search(store, query, limit = 8) {
         let score = 0;
         score += scoreAgainst(qTf, tokenize(meta.title), 5);
         score += scoreAgainst(qTf, tokenize(meta.path), 3);
+        // All markdown headings — section-level signal, covers full doc (not just first 200 lines).
+        score += scoreAgainst(qTf, tokenize(meta.headings), 3);
         score += scanBody(store.docsDir, meta.docId, qTf, 200);
         if (score <= 0)
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmonyos-guides-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server exposing HarmonyOS official development guides for API/Kit usage retrieval during development.",
   "type": "module",
   "main": "dist/index.js",