product-spec-mcp 0.3.19 → 0.3.21

package/README.md

@@ -19,11 +19,6 @@
 
 **不确定用哪个工具？** 先用 `product_spec_assist`，它会自动识别场景并调用合适的工具。
 
-## 维护索引
-
-- 更新 MCP 本体前，先看 [product-spec-mcp 更新经验索引](docs/product-spec-mcp-update-lessons.md)。
-- WorkBuddy 接入、运行环境和副本同步问题仍记录在 [WorkBuddy 坑点记录](docs/workbuddy-mcp-pitfalls.md)。
-
 ## Features
 
 This MCP Server provides 7 tools for product development workflow:
@@ -130,6 +125,16 @@ Add to `~/.config/opencode/opencode.json`:
 
 > Note: opencode uses the `mcp` key. `mcpServers` is a Claude-style config key and will fail schema validation in current opencode versions.
 
+## FAQ
+
+### Where are maintainer notes?
+
+If you plan to modify this MCP server itself, read the maintainer notes first:
+
+- [product-spec-mcp update lessons](https://github.com/georgelue0321-vibe/product-spec-mcp/blob/main/docs/product-spec-mcp-update-lessons.md)
+
+Client-specific integration notes are intentionally kept out of the main user flow. They live under `docs/` in the GitHub repository for maintainers who need them.
+
 ## Tools Documentation
 
 ### product_spec_assist (推荐入口)

package/dist/index.cjs

@@ -7,7 +7,11 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -6936,7 +6940,6 @@ function $constructor(name, initializer3, params) {
   Object.defineProperty(_, "name", { value: name });
   return _;
 }
-var $brand = Symbol("zod_brand");
 var $ZodAsyncError = class extends Error {
   constructor() {
     super(`Encountered Promise during synchronous parse. Use .parseAsync() instead.`);
@@ -9440,8 +9443,6 @@ function en_default() {
 }
 
 // node_modules/zod/v4/core/registries.js
-var $output = Symbol("ZodOutput");
-var $input = Symbol("ZodInput");
 var $ZodRegistry = class {
   constructor() {
     this._map = /* @__PURE__ */ new Map();
@@ -16838,7 +16839,7 @@ ZodNaN.create = (params) => {
     ...processCreateParams(params)
   });
 };
-var BRAND = Symbol("zod_brand");
+var BRAND = /* @__PURE__ */ Symbol("zod_brand");
 var ZodBranded = class extends ZodType2 {
   _parse(input) {
     const { ctx } = this._processInputParams(input);
@@ -17247,7 +17248,7 @@ function isTerminal(status) {
 }
 
 // node_modules/zod-to-json-schema/dist/esm/Options.js
-var ignoreOverride = Symbol("Let zodToJsonSchema decide on which parser to use");
+var ignoreOverride = /* @__PURE__ */ Symbol("Let zodToJsonSchema decide on which parser to use");
 var defaultOptions = {
   name: void 0,
   $refStrategy: "root",
@@ -20223,7 +20224,7 @@ var Server = class extends Protocol {
 };
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
-var COMPLETABLE_SYMBOL = Symbol.for("mcp.completable");
+var COMPLETABLE_SYMBOL = /* @__PURE__ */ Symbol.for("mcp.completable");
 function isCompletable(schema) {
   return !!schema && typeof schema === "object" && COMPLETABLE_SYMBOL in schema;
 }
@@ -23537,6 +23538,79 @@ var SpecCompileOutputSchema = external_exports.object({
   })
 });
 
+// src/core/localToolSignals.ts
+function buildLocalToolSignalProfile(text) {
+  const recordObject = extractRecordObject(text);
+  const fieldLabels = buildFieldLabels(text, recordObject);
+  const featureHints = buildFeatureHints(text, recordObject);
+  const acceptanceItems = buildAcceptanceItems(text, recordObject, fieldLabels);
+  return {
+    recordObject,
+    fieldExample: fieldLabels.join("\u3001"),
+    featureHints,
+    acceptanceItems
+  };
+}
+function extractRecordObject(text) {
+  if (/药品|药箱|药/.test(text)) return "\u836F\u54C1";
+  const patterns = [
+    /(?:做一个|做个|开发一个|创建一个|想做一个|想做个)([^，。,.；;]{1,16}?)(?:管理工具|提醒工具|记录工具|清单|小工具|页面|网页|HTML)/i,
+    /记录(?:家里有哪些)?([^，。,.；;、和]{1,12})/
+  ];
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    const value = cleanObjectLabel(match?.[1]);
+    if (value) return value;
+  }
+  return "\u8BB0\u5F55";
+}
+function cleanObjectLabel(value) {
+  if (!value) return "";
+  return value.replace(/^(家庭|个人|家里|我的|一个|一款)/, "").replace(/(管理|提醒|记录|清单|工具|页面|网页|HTML)$/i, "").trim();
+}
+function buildFieldLabels(text, recordObject) {
+  const labels = [`${recordObject}\u540D`];
+  addIf(labels, "\u6570\u91CF/\u5E93\u5B58", /数量|库存|余量|剩余|补货/.test(text));
+  addIf(labels, "\u6709\u6548\u671F/\u5230\u671F\u65E5", /有效期|过期|临期|到期|截止|保质期|续费|提醒/.test(text));
+  addIf(labels, "\u5206\u7C7B", /分类|类别|标签|类型/.test(text));
+  addIf(labels, "\u5B58\u653E\u4F4D\u7F6E", /位置|存放|放在|地点|地址/.test(text));
+  addIf(labels, "\u72B6\u6001", /状态|进度|已完成|未完成|正常|异常/.test(text));
+  addIf(labels, "\u91D1\u989D/\u4EF7\u683C", /金额|价格|费用|预算|保费/.test(text));
+  addIf(labels, "\u94FE\u63A5", /链接|网址|URL/i.test(text));
+  labels.push("\u5907\u6CE8");
+  return Array.from(new Set(labels));
+}
+function buildFeatureHints(text, recordObject) {
+  const hints = [];
+  if (/记录|管理|保存|清单|列表/.test(text)) hints.push(`${recordObject}\u8BB0\u5F55\u7BA1\u7406`);
+  if (/新增|添加|编辑|删除|增删改查|CRUD/i.test(text)) hints.push("\u65B0\u589E/\u7F16\u8F91/\u5220\u9664");
+  if (/搜索|筛选|分类|标签|查询/.test(text)) hints.push("\u641C\u7D22/\u7B5B\u9009/\u5206\u7C7B");
+  if (/提醒|到期|过期|临期|快过期|截止|倒计时|保质期|续费/.test(text)) hints.push("\u5230\u671F/\u8FC7\u671F\u63D0\u9192");
+  if (/数量|库存|余量|剩余|补货/.test(text)) hints.push("\u6570\u91CF/\u5E93\u5B58\u7BA1\u7406");
+  if (/高级|好看|美观|视觉|界面|页面|UI|ui|响应式/.test(text)) hints.push("\u9AD8\u7EA7\u754C\u9762\u4E0E\u54CD\u5E94\u5F0F\u5E03\u5C40");
+  return Array.from(new Set(hints));
+}
+function buildAcceptanceItems(text, recordObject, fieldLabels) {
+  const items = [];
+  if (/记录|管理|保存|清单|列表/.test(text)) {
+    items.push(`${recordObject}\u8BB0\u5F55\u80FD\u4FDD\u5B58${fieldLabels.join("\u3001")}`);
+  }
+  if (/提醒|到期|过期|临期|快过期|截止|保质期|续费/.test(text)) {
+    items.push("\u63D0\u9192\u5217\u8868\u80FD\u6309\u65E5\u671F\u6392\u5E8F\uFF0C\u5DF2\u8FC7\u671F\u3001\u5373\u5C06\u5230\u671F\u548C\u6B63\u5E38\u72B6\u6001\u6E05\u6670");
+    items.push("\u7F16\u8F91\u6216\u5220\u9664\u8BB0\u5F55\u540E\uFF0C\u63D0\u9192\u5217\u8868\u540C\u6B65\u66F4\u65B0");
+  }
+  if (/数量|库存|余量|剩余|补货/.test(text)) {
+    items.push("\u6570\u91CF\u6216\u5E93\u5B58\u53D8\u5316\u540E\uFF0C\u5217\u8868\u3001\u8BE6\u60C5\u548C\u63D0\u9192\u72B6\u6001\u540C\u6B65\u66F4\u65B0");
+  }
+  if (/高级|好看|美观|视觉|界面|页面|UI|ui|响应式/.test(text)) {
+    items.push("\u9875\u9762\u89C6\u89C9\u98CE\u683C\u4E00\u81F4\uFF0C\u684C\u9762\u7AEF\u548C\u79FB\u52A8\u7AEF\u90FD\u4E0D\u80FD\u51FA\u73B0\u6587\u5B57\u6EA2\u51FA\u6216\u63A7\u4EF6\u91CD\u53E0");
+  }
+  return items;
+}
+function addIf(items, label, condition) {
+  if (condition) items.push(label);
+}
+
 // src/core/promptBuilder.ts
 function buildSpec(rawIdea, context, readiness) {
   const assumptions = [];
@@ -23582,7 +23656,8 @@ function buildSpec(rawIdea, context, readiness) {
     assumptions.push("\u76EE\u6807\u7528\u6237\uFF1A\u9ED8\u8BA4\u4E3A\u4E2A\u4EBA\u7528\u6237");
   }
   const platform = normalizedContext.platform || extractPlatform(rawIdea) || "web";
-  const coreFeatures = hasStructuredAnswers ? buildGenericCoreFeatures(normalizedContext, extractFeatures(rawIdea)) : toArray(normalizedContext.core_features, extractFeatures(rawIdea));
+  const extractedFeatures = personalLocalTool ? buildLocalFirstExtractedFeatures(rawIdea) : extractFeatures(rawIdea);
+  const coreFeatures = hasStructuredAnswers ? buildGenericCoreFeatures(normalizedContext, extractedFeatures) : toArray(normalizedContext.core_features, extractedFeatures);
   const isGenericFeatures = coreFeatures.length === 1 && coreFeatures[0] === "\u6838\u5FC3\u529F\u80FD";
   if (isGenericFeatures) {
     assumptions.push("\u6838\u5FC3\u529F\u80FD\uFF1A\u672A\u8BC6\u522B\u5230\u5177\u4F53\u529F\u80FD\uFF0C\u9700\u8981\u7528\u6237\u8865\u5145");
@@ -24745,6 +24820,12 @@ function extractFeatures(text) {
   }
   return features.length > 0 ? features : ["\u6838\u5FC3\u529F\u80FD"];
 }
+function buildLocalFirstExtractedFeatures(text) {
+  const genericFeatures = extractFeatures(text).filter((feature) => feature !== "\u6838\u5FC3\u529F\u80FD");
+  const signalProfile = buildLocalToolSignalProfile(text);
+  const features = [...genericFeatures, ...signalProfile.featureHints];
+  return features.length > 0 ? Array.from(new Set(features)) : ["\u6838\u5FC3\u529F\u80FD"];
+}
 function isNegatedKeyword(text, keyword) {
   const escaped = keyword.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return new RegExp(`(\u4E0D\u63A5|\u4E0D\u505A|\u4E0D\u7528|\u65E0\u9700|\u4E0D\u9700\u8981|\u6682\u4E0D|\u5148\u4E0D|\u4E0D\u8981|\u6CA1\u6709).{0,8}${escaped}`, "i").test(text);
@@ -26649,7 +26730,7 @@ function buildLocalFirstAcceptanceCategories(technicalProfile, productType, feat
 }
 function buildGenericToolAcceptanceItems(productType, features) {
   const text = buildFeatureText(productType, features);
-  const items = [];
+  const items = [...buildLocalToolSignalProfile(text).acceptanceItems];
   if (/地图|景点|酒店|美食|点位|坐标|路线/.test(text)) {
     items.push("\u5730\u56FE provider\u3001\u5750\u6807\u6765\u6E90\u548C API Key \u4F7F\u7528\u65B9\u5F0F\u5DF2\u660E\u786E\uFF1BKey \u4E0D\u5E94\u786C\u7F16\u7801\u5230\u516C\u5F00\u4ED3\u5E93");
     items.push("\u7528\u6237\u4FDD\u5B58\u7684\u7F8E\u98DF\u3001\u9152\u5E97\u3001\u666F\u70B9\u80FD\u6309\u7C7B\u578B\u7B5B\u9009\u5E76\u6B63\u786E\u663E\u793A\u5728\u5730\u56FE\u6216\u5217\u8868\u4E2D");
@@ -27222,7 +27303,7 @@ function buildProductQuickQuestions(message, knownContext) {
   const domain = classifyProductDomain(contextText, knownContext || {}).domain;
   const technicalProfile = buildTechnicalProfile(message, knownContext || {});
   if (domain === "generic" && isLocalFirstProfile(technicalProfile)) {
-    return withQuestionExamples(buildLocalFirstQuickQuestions(technicalProfile));
+    return withQuestionExamples(buildLocalFirstQuickQuestions(technicalProfile, message));
   }
   if (domain === "crm") {
     return withQuestionExamples(buildCrmQuickQuestions());
@@ -27466,13 +27547,16 @@ function buildProductQuickQuestions(message, knownContext) {
     }
   ]);
 }
-function buildLocalFirstQuickQuestions(technicalProfile) {
+function buildLocalFirstQuickQuestions(technicalProfile, message = "") {
   const storageDefault = technicalProfile.shape === "static_json_data_page" ? "static_json" : technicalProfile.shape === "local_json_import_export" ? "local_file" : "local_storage";
+  const signalProfile = buildLocalToolSignalProfile(message);
+  const recordObject = signalProfile.recordObject;
+  const fieldExample = signalProfile.fieldExample;
   const questions = [
     {
       id: "record_object",
-      question: "\u4F60\u60F3\u8BB0\u5F55\u6216\u5C55\u793A\u4EC0\u4E48\u4E1C\u897F\uFF1F",
-      example: "\u6BD4\u5982\u98DF\u6750\u3001\u836F\u54C1\u3001\u6E38\u620F\u3001\u88C5\u5907\u3001\u4FDD\u5355\uFF0C\u6216\u666F\u70B9\u3001\u9152\u5E97\u3001\u7F8E\u98DF\u3002",
+      question: `\u4F60\u60F3\u8BB0\u5F55\u6216\u5C55\u793A\u4EC0\u4E48\u4E1C\u897F\uFF1F`,
+      example: recordObject === "\u8BB0\u5F55" ? "\u6BD4\u5982\u98DF\u6750\u3001\u836F\u54C1\u3001\u6E38\u620F\u3001\u88C5\u5907\u3001\u4FDD\u5355\uFF0C\u6216\u666F\u70B9\u3001\u9152\u5E97\u3001\u7F8E\u98DF\u3002" : `\u6BD4\u5982\u5148\u56F4\u7ED5\u201C${recordObject}\u201D\u505A\u4E2A\u4EBA\u8BB0\u5F55/\u6E05\u5355\u3002`,
       whyImportant: "\u5148\u786E\u8BA4\u6838\u5FC3\u5BF9\u8C61\uFF0C\u907F\u514D\u88AB\u6269\u6210\u540E\u53F0\u7CFB\u7EDF\u3002",
       priority: "P0",
       defaultValue: "personal_records",
@@ -27485,8 +27569,8 @@ function buildLocalFirstQuickQuestions(technicalProfile) {
     },
     {
       id: "record_items",
-      question: "\u6BCF\u6761\u8BB0\u5F55\u8981\u4FDD\u5B58\u54EA\u4E9B\u4FE1\u606F\uFF1F",
-      example: "\u6BD4\u5982\u540D\u79F0\u3001\u6570\u91CF\u3001\u65E5\u671F\u3001\u72B6\u6001\u3001\u5206\u7C7B\u3001\u5907\u6CE8\u3002",
+      question: `\u6BCF\u6761${recordObject === "\u8BB0\u5F55" ? "\u8BB0\u5F55" : recordObject}\u8BB0\u5F55\u8981\u4FDD\u5B58\u54EA\u4E9B\u4FE1\u606F\uFF1F`,
+      example: `\u6BD4\u5982${fieldExample}\u3002`,
       whyImportant: "\u51B3\u5B9A\u9875\u9762\u8868\u5355\u3001\u5217\u8868\u5217\u540D\u548C\u672C\u5730 JSON \u6570\u636E\u7ED3\u6784\u3002",
       priority: "P0",
       defaultValue: "name_date_status_note",
@@ -27514,7 +27598,7 @@ function buildLocalFirstQuickQuestions(technicalProfile) {
     {
       id: "operations",
       question: "\u9700\u8981\u54EA\u4E9B\u64CD\u4F5C\uFF1F",
-      example: "\u6BD4\u5982\u65B0\u589E\u3001\u7F16\u8F91\u3001\u5220\u9664\u3001\u641C\u7D22\u3001\u7B5B\u9009\u3001\u5206\u7C7B\u3002",
+      example: signalProfile.featureHints.length > 0 ? `\u6BD4\u5982${signalProfile.featureHints.join("\u3001")}\u3002` : "\u6BD4\u5982\u65B0\u589E\u3001\u7F16\u8F91\u3001\u5220\u9664\u3001\u641C\u7D22\u3001\u7B5B\u9009\u3001\u5206\u7C7B\u3002",
       whyImportant: "\u51B3\u5B9A\u7B2C\u4E00\u7248\u529F\u80FD\u8303\u56F4\u548C\u9A8C\u6536\u6807\u51C6\u3002",
       priority: "P0",
       defaultValue: "crud_search_filter",
@@ -28302,7 +28386,7 @@ function registerProductSpecAssist(server) {
 function createServer() {
   const server = new McpServer({
     name: "product-spec-mcp",
-    version: "0.3.19"
+    version: "0.3.21"
   });
   registerSpecInterrogate(server);
   registerSpecCompile(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "product-spec-mcp",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "MCP Server for product specification - requirement interrogation, architecture decision, UI translation, debug guidance, and acceptance generation",
   "type": "commonjs",
   "main": "dist/index.cjs",