record_safer_pro_mcp 1.0.40 → 1.0.42

package/README.md

@@ -273,8 +273,9 @@ npx -y record_safer_pro_mcp@latest --doctor
 | 录音状态 | 获取通道、混音、健康状态、最小录音状态 |
 | 通道操作 | 重命名通道、调颜色、音量、声像、solo、mute、反相 |
 | 录音中管理 | 添加标记、列出轨道、列出标记、重命名标记 |
+| 说明书问答 | 检索内嵌用户手册 RAG，用于安装、模式、格式、位深、警报和 MCP 使用说明 |
 
-当前仅暴露 24 个高频核心工具，不通过 MCP 暴露以下能力：
+当前仅暴露 25 个高频核心工具，不通过 MCP 暴露以下能力：
 
 - 系统设置
 - 更新
@@ -673,8 +674,9 @@ The current MCP server is intentionally focused on high-frequency recording task
 | Recording status | retrieve channels, mix, health, and minimal status |
 | Channel operations | rename channel, set color, volume, pan, solo, mute, phase invert |
 | In-session management | add markers, list tracks, list markers, rename markers |
+| Manual Q&A | search the embedded user-manual RAG for install, mode, format, bit-depth, alert, and MCP usage guidance |
 
-Only 24 high-frequency core tools are exposed at this time. The following capabilities are intentionally not exposed through MCP:
+Only 25 high-frequency core tools are exposed at this time. The following capabilities are intentionally not exposed through MCP:
 
 - system settings
 - updates

package/dist/manual-rag.d.ts

@@ -0,0 +1,52 @@
+export type ManualRagAudience = "end_user" | "developer_support";
+export type ManualRagChunk = {
+    id: string;
+    source_path: string;
+    source_type: string;
+    audience: ManualRagAudience;
+    module: string;
+    authority?: string;
+    retrieval_priority?: number;
+    title: string;
+    heading_path?: string[];
+    start_line: number;
+    end_line: number;
+    text: string;
+};
+export type ManualRagSearchOptions = {
+    query: string;
+    top?: number;
+    audience?: ManualRagAudience;
+    module?: string;
+};
+export type ManualRagSearchResult = {
+    rank: number;
+    score: number;
+    matched: string[];
+    audience: ManualRagAudience;
+    module: string;
+    authority: string;
+    sourcePath: string;
+    startLine: number;
+    endLine: number;
+    title: string;
+    headingPath: string[];
+    text: string;
+};
+export type ManualRagSearchResponse = {
+    query: string;
+    generatedAt: string;
+    corpus: {
+        included: Array<"manual_chunks" | "support_chunks">;
+        evidenceIncluded: false;
+    };
+    resultCount: number;
+    guidance: string;
+    results: ManualRagSearchResult[];
+};
+export declare function getManualRagConfig(): unknown;
+export declare function getManualRagAnswerPolicy(): string;
+export declare function getManualRagPlaybook(): string;
+export declare function getManualRagGeneratedAt(): string;
+export declare function searchManualRag(options: ManualRagSearchOptions): ManualRagSearchResponse;
+//# sourceMappingURL=manual-rag.d.ts.map

package/dist/manual-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-rag.d.ts","sourceRoot":"","sources":["../src/manual-rag.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,QAAQ,EAAE,KAAK,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAC;QACpD,gBAAgB,EAAE,KAAK,CAAC;KACzB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC,CAAC;AAwCF,wBAAgB,kBAAkB,IAAI,OAAO,CAK5C;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AA2GD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,uBAAuB,CA2CxF"}

package/dist/manual-rag.js

@@ -0,0 +1,201 @@
+import { MANUAL_RAG_ANSWER_POLICY_MD, MANUAL_RAG_CONFIG_JSON, MANUAL_RAG_GENERATED_AT, MANUAL_RAG_MANUAL_CHUNKS_JSONL, MANUAL_RAG_PLAYBOOK_MD, MANUAL_RAG_SUPPORT_CHUNKS_JSONL, } from "./resources/manual-rag-content.js";
+const STOP_WORDS = new Set([
+    "about",
+    "after",
+    "all",
+    "also",
+    "and",
+    "are",
+    "but",
+    "can",
+    "for",
+    "from",
+    "get",
+    "has",
+    "have",
+    "into",
+    "not",
+    "record",
+    "recording",
+    "return",
+    "set",
+    "the",
+    "this",
+    "true",
+    "type",
+    "use",
+    "void",
+    "with",
+    "用户",
+    "使用",
+    "系统",
+    "软件",
+    "录音",
+    "功能",
+]);
+let chunkCache = null;
+let configCache = null;
+export function getManualRagConfig() {
+    if (configCache == null) {
+        configCache = JSON.parse(MANUAL_RAG_CONFIG_JSON);
+    }
+    return configCache;
+}
+export function getManualRagAnswerPolicy() {
+    return MANUAL_RAG_ANSWER_POLICY_MD;
+}
+export function getManualRagPlaybook() {
+    return MANUAL_RAG_PLAYBOOK_MD;
+}
+export function getManualRagGeneratedAt() {
+    return MANUAL_RAG_GENERATED_AT;
+}
+function parseJsonl(jsonl) {
+    return jsonl
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+function getChunks() {
+    if (chunkCache == null) {
+        chunkCache = [
+            ...parseJsonl(MANUAL_RAG_MANUAL_CHUNKS_JSONL),
+            ...parseJsonl(MANUAL_RAG_SUPPORT_CHUNKS_JSONL),
+        ];
+    }
+    return chunkCache;
+}
+function tokenize(text) {
+    const lower = text.toLowerCase();
+    const words = [];
+    const latinMatches = lower.match(/[a-z0-9][a-z0-9_-]{1,}/g) || [];
+    for (const token of latinMatches) {
+        for (const piece of token.split(/[_-]+/)) {
+            if (piece.length >= 2 && !STOP_WORDS.has(piece))
+                words.push(piece);
+        }
+        if (token.length >= 2 && !STOP_WORDS.has(token))
+            words.push(token);
+    }
+    const cjkMatches = text.match(/[\u3400-\u9fff]{2,}/g) || [];
+    for (const seq of cjkMatches) {
+        if (seq.length <= 12 && !STOP_WORDS.has(seq))
+            words.push(seq);
+        for (let i = 0; i < seq.length - 1; i++) {
+            const gram = seq.slice(i, i + 2);
+            if (!STOP_WORDS.has(gram))
+                words.push(gram);
+        }
+        for (let i = 0; i < seq.length - 2; i += 2) {
+            const gram = seq.slice(i, i + 3);
+            if (!STOP_WORDS.has(gram))
+                words.push(gram);
+        }
+    }
+    return words;
+}
+function scoreChunk(chunk, query, queryTokens) {
+    const haystack = [
+        chunk.source_path,
+        chunk.title,
+        ...(chunk.heading_path || []),
+        chunk.module,
+        chunk.audience,
+        chunk.authority,
+        chunk.text,
+    ].join("\n").toLowerCase();
+    const counts = new Map();
+    for (const token of tokenize(haystack)) {
+        counts.set(token, (counts.get(token) || 0) + 1);
+    }
+    let score = 0;
+    const matched = [];
+    for (const token of queryTokens) {
+        const count = counts.get(token) || 0;
+        if (count > 0) {
+            score += Math.min(8, 1 + Math.log2(count + 1));
+            matched.push(token);
+        }
+        if ((chunk.title || "").toLowerCase().includes(token))
+            score += 4;
+        if ((chunk.heading_path || []).join(" ").toLowerCase().includes(token))
+            score += 3;
+        if ((chunk.source_path || "").toLowerCase().includes(token))
+            score += 2;
+    }
+    const normalizedQuery = query.toLowerCase();
+    if (normalizedQuery.length >= 4 && haystack.includes(normalizedQuery))
+        score += 12;
+    const priority = Number(chunk.retrieval_priority || 40);
+    score *= 0.8 + Math.max(0, Math.min(priority, 100)) / 100;
+    if (chunk.module === "manual_playbook")
+        score += 12;
+    if (chunk.authority === "canonical_code_checked")
+        score += 8;
+    if (chunk.audience === "end_user")
+        score *= 1.35;
+    if (chunk.audience === "developer_support")
+        score *= 1.05;
+    return { score, matched: [...new Set(matched)] };
+}
+function excerpt(text, queryTokens, length = 1200) {
+    const lower = text.toLowerCase();
+    let best = 0;
+    for (const token of queryTokens) {
+        const idx = lower.indexOf(token.toLowerCase());
+        if (idx >= 0) {
+            best = Math.max(0, idx - 160);
+            break;
+        }
+    }
+    const snippet = text.slice(best, best + length).replace(/\s+/g, " ").trim();
+    return `${best > 0 ? "..." : ""}${snippet}${best + length < text.length ? "..." : ""}`;
+}
+function normalizeTop(rawTop) {
+    if (!Number.isFinite(rawTop))
+        return 5;
+    return Math.max(1, Math.min(12, Math.trunc(rawTop || 5)));
+}
+export function searchManualRag(options) {
+    const query = options.query.trim();
+    const queryTokens = [...new Set(tokenize(query))];
+    const top = normalizeTop(options.top);
+    const filtered = getChunks().filter((chunk) => {
+        if (options.audience && chunk.audience !== options.audience)
+            return false;
+        if (options.module && chunk.module !== options.module)
+            return false;
+        return true;
+    });
+    const results = filtered
+        .map((chunk) => ({ chunk, ...scoreChunk(chunk, query, queryTokens) }))
+        .filter((item) => item.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, top)
+        .map((item, index) => ({
+        rank: index + 1,
+        score: Number(item.score.toFixed(2)),
+        matched: item.matched,
+        audience: item.chunk.audience,
+        module: item.chunk.module,
+        authority: item.chunk.authority || "user_manual_source",
+        sourcePath: item.chunk.source_path,
+        startLine: item.chunk.start_line,
+        endLine: item.chunk.end_line,
+        title: item.chunk.title,
+        headingPath: item.chunk.heading_path || [],
+        text: excerpt(item.chunk.text, queryTokens),
+    }));
+    return {
+        query,
+        generatedAt: MANUAL_RAG_GENERATED_AT,
+        corpus: {
+            included: ["manual_chunks", "support_chunks"],
+            evidenceIncluded: false,
+        },
+        resultCount: results.length,
+        guidance: "Use manual_playbook/canonical_code_checked results first. This MCP RAG intentionally excludes implementation_evidence chunks by default; do not expose source paths unless the user asks for technical provenance.",
+        results,
+    };
+}
+//# sourceMappingURL=manual-rag.js.map

package/dist/manual-rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-rag.js","sourceRoot":"","sources":["../src/manual-rag.ts"],"names":[],"mappings":"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"}

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAuFlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAiIlD"}

package/dist/resources/index.js

@@ -3,6 +3,7 @@
  * MCP Resources — Read-only data sources
  */
 import { RecordSaferClient } from "../api-client.js";
+import { MANUAL_RAG_ANSWER_POLICY_MD, MANUAL_RAG_CONFIG_JSON, MANUAL_RAG_PLAYBOOK_MD, } from "./manual-rag-content.js";
 import { MIXING_GUIDE_MD } from "./mixing-guide-content.js";
 export function registerResources(server) {
     const client = new RecordSaferClient();
@@ -55,5 +56,29 @@ export function registerResources(server) {
                 text: MIXING_GUIDE_MD,
             }],
     }));
+    // recordsafer://docs/manual-answer-policy — 用户说明书回答规则
+    server.resource("manual-answer-policy", "recordsafer://docs/manual-answer-policy", { mimeType: "text/markdown", description: "AI answer policy for user-facing Record Safer Pro manual questions." }, async () => ({
+        contents: [{
+                uri: "recordsafer://docs/manual-answer-policy",
+                mimeType: "text/markdown",
+                text: MANUAL_RAG_ANSWER_POLICY_MD,
+            }],
+    }));
+    // recordsafer://docs/manual-playbook — 代码校准后的高优先级用户手册口径
+    server.resource("manual-playbook", "recordsafer://docs/manual-playbook", { mimeType: "text/markdown", description: "Code-checked manual answer playbook. Read first for user-facing product manual answers." }, async () => ({
+        contents: [{
+                uri: "recordsafer://docs/manual-playbook",
+                mimeType: "text/markdown",
+                text: MANUAL_RAG_PLAYBOOK_MD,
+            }],
+    }));
+    // recordsafer://rag/config — 内嵌 RAG 配置与统计
+    server.resource("manual-rag-config", "recordsafer://rag/config", { mimeType: "application/json", description: "Embedded manual RAG config and corpus statistics." }, async () => ({
+        contents: [{
+                uri: "recordsafer://rag/config",
+                mimeType: "application/json",
+                text: MANUAL_RAG_CONFIG_JSON,
+            }],
+    }));
 }
 //# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}