@hirohsu/user-web-feedback 2.8.1 → 2.8.8

package/dist/cli.cjs

@@ -3302,6 +3302,7 @@ __export(database_exports, {
   getMCPServerById: () => getMCPServerById,
   getPinnedPrompts: () => getPinnedPrompts,
   getPromptById: () => getPromptById,
+  getPromptConfigs: () => getPromptConfigs,
   getRecentMCPServerErrors: () => getRecentMCPServerErrors,
   getSelfProbeSettings: () => getSelfProbeSettings,
   getToolEnableConfigs: () => getToolEnableConfigs,
@@ -3319,6 +3320,7 @@ __export(database_exports, {
   queryLogs: () => queryLogs,
   queryMCPServerLogs: () => queryMCPServerLogs,
   reorderPrompts: () => reorderPrompts,
+  resetPromptConfigs: () => resetPromptConfigs,
   saveSelfProbeSettings: () => saveSelfProbeSettings,
   setToolEnabled: () => setToolEnabled,
   toggleMCPServerEnabled: () => toggleMCPServerEnabled,
@@ -3329,6 +3331,7 @@ __export(database_exports, {
   updateCLITerminalActivity: () => updateCLITerminalActivity,
   updateMCPServer: () => updateMCPServer,
   updatePrompt: () => updatePrompt,
+  updatePromptConfigs: () => updatePromptConfigs,
   updateUserPreferences: () => updateUserPreferences
 });
 function hashPrompt(prompt) {
@@ -3626,6 +3629,21 @@ function createTables() {
       updated_at TEXT DEFAULT CURRENT_TIMESTAMP
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS prompt_configs (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      display_name TEXT NOT NULL,
+      content TEXT,
+      first_order INTEGER DEFAULT 0,
+      second_order INTEGER DEFAULT 0,
+      enabled INTEGER DEFAULT 1,
+      editable INTEGER DEFAULT 1,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT DEFAULT CURRENT_TIMESTAMP
+    )
+  `);
+  initDefaultPromptConfigs();
 }
 function initDefaultSettings() {
   if (!db) throw new Error("Database not initialized");
@@ -5020,7 +5038,104 @@ function saveSelfProbeSettings(settings) {
   }
   return getSelfProbeSettings();
 }
-var import_better_sqlite3, import_path2, import_fs2, import_crypto2, DB_DIR, DB_PATH, db, SYSTEM_PROMPT_VERSIONS, CURRENT_PROMPT_VERSION;
+function initDefaultPromptConfigs() {
+  const db2 = tryGetDb();
+  if (!db2) return;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const existingIds = db2.prepare("SELECT id FROM prompt_configs").all().map((row) => row.id);
+  const stmt = db2.prepare(`
+        INSERT INTO prompt_configs (id, name, display_name, content, first_order, second_order, enabled, editable, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+  for (const config2 of DEFAULT_PROMPT_CONFIGS) {
+    if (!existingIds.includes(config2.id)) {
+      stmt.run(
+        config2.id,
+        config2.name,
+        config2.displayName,
+        config2.content,
+        config2.firstOrder,
+        config2.secondOrder,
+        config2.enabled ? 1 : 0,
+        config2.editable ? 1 : 0,
+        now,
+        now
+      );
+      logger.info(`Added missing prompt config: ${config2.id}`);
+    }
+  }
+}
+function getPromptConfigs() {
+  const db2 = tryGetDb();
+  if (!db2) return [];
+  const rows = db2.prepare(`
+        SELECT id, name, display_name as displayName, content,
+               first_order as firstOrder, second_order as secondOrder,
+               enabled, editable, created_at as createdAt, updated_at as updatedAt
+        FROM prompt_configs
+        ORDER BY first_order ASC
+    `).all();
+  const aiSettings = getAISettings();
+  return rows.map((row) => {
+    let content = row.content;
+    if (row.id === "system_prompt" && !content && aiSettings.systemPrompt) {
+      content = aiSettings.systemPrompt;
+    } else if (row.id === "mcp_tools" && !content && aiSettings.mcpToolsPrompt) {
+      content = aiSettings.mcpToolsPrompt;
+    }
+    return {
+      ...row,
+      content,
+      enabled: row.enabled === 1,
+      editable: row.editable === 1
+    };
+  });
+}
+function updatePromptConfigs(request) {
+  const db2 = tryGetDb();
+  if (!db2) return false;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  for (const prompt of request.prompts) {
+    const updates = [];
+    const values = [];
+    if (prompt.firstOrder !== void 0) {
+      updates.push("first_order = ?");
+      values.push(prompt.firstOrder);
+    }
+    if (prompt.secondOrder !== void 0) {
+      updates.push("second_order = ?");
+      values.push(prompt.secondOrder);
+    }
+    if (prompt.enabled !== void 0) {
+      updates.push("enabled = ?");
+      values.push(prompt.enabled ? 1 : 0);
+    }
+    if (prompt.content !== void 0) {
+      updates.push("content = ?");
+      values.push(prompt.content);
+      if (prompt.id === "system_prompt") {
+        db2.prepare("UPDATE ai_settings SET system_prompt = ?, updated_at = ? WHERE id = 1").run(prompt.content || "", now);
+      } else if (prompt.id === "mcp_tools") {
+        db2.prepare("UPDATE ai_settings SET mcp_tools_prompt = ?, updated_at = ? WHERE id = 1").run(prompt.content || "", now);
+      }
+    }
+    if (updates.length > 0) {
+      updates.push("updated_at = ?");
+      values.push(now);
+      values.push(prompt.id);
+      db2.prepare(`UPDATE prompt_configs SET ${updates.join(", ")} WHERE id = ?`).run(...values);
+    }
+  }
+  return true;
+}
+function resetPromptConfigs() {
+  const db2 = tryGetDb();
+  if (!db2) return [];
+  db2.prepare("DELETE FROM prompt_configs").run();
+  initDefaultPromptConfigs();
+  return getPromptConfigs();
+}
+var import_better_sqlite3, import_path2, import_fs2, import_crypto2, DB_DIR, DB_PATH, db, SYSTEM_PROMPT_VERSIONS, CURRENT_PROMPT_VERSION, DEFAULT_PROMPT_CONFIGS;
 var init_database = __esm({
   "src/utils/database.ts"() {
     "use strict";
@@ -5067,6 +5182,14 @@ var init_database = __esm({
 \u4FDD\u6301\u56DE\u61C9\u7C21\u77ED\uFF082-3\u53E5\u8A71\uFF09\uFF0C\u9664\u975E\u9700\u8981\u66F4\u8A73\u7D30\u7684\u8AAA\u660E\u3002`
     };
     CURRENT_PROMPT_VERSION = "v2";
+    DEFAULT_PROMPT_CONFIGS = [
+      { id: "system_prompt", name: "System Prompt", displayName: "\u7CFB\u7D71\u63D0\u793A\u8A5E", content: null, firstOrder: 10, secondOrder: 10, enabled: true, editable: true },
+      { id: "mcp_tools", name: "MCP Tools", displayName: "MCP \u5DE5\u5177\u8AAA\u660E", content: null, firstOrder: 20, secondOrder: 0, enabled: true, editable: true },
+      { id: "mcp_tools_detailed", name: "MCP Tools Detailed", displayName: "MCP \u5DE5\u5177\u8A73\u7D30\u5217\u8868", content: null, firstOrder: 25, secondOrder: 15, enabled: true, editable: false },
+      { id: "user_context", name: "User Context", displayName: "\u7528\u6236\u4E0A\u4E0B\u6587", content: null, firstOrder: 30, secondOrder: 20, enabled: true, editable: false },
+      { id: "tool_results", name: "Tool Results", displayName: "\u5DE5\u5177\u57F7\u884C\u7D50\u679C", content: null, firstOrder: 0, secondOrder: 30, enabled: true, editable: false },
+      { id: "closing", name: "Closing", displayName: "\u7D50\u5C3E\u63D0\u793A", content: null, firstOrder: 100, secondOrder: 100, enabled: true, editable: true }
+    ];
   }
 });
 
@@ -5160,6 +5283,9 @@ var init_logger = __esm({
         this.flushInterval = setInterval(() => {
           this.flushToDatabase();
         }, this.FLUSH_INTERVAL_MS);
+        if (this.flushInterval.unref) {
+          this.flushInterval.unref();
+        }
         process.on("beforeExit", () => {
           this.flushToDatabase();
         });
@@ -77793,6 +77919,107 @@ ${mcpPrompt}`;
   }
 });
 
+// src/utils/prompt-aggregator/components/mcp-tools-detailed.ts
+var MCPToolsDetailedComponent;
+var init_mcp_tools_detailed = __esm({
+  "src/utils/prompt-aggregator/components/mcp-tools-detailed.ts"() {
+    "use strict";
+    init_cjs_shims();
+    init_base_component();
+    init_mcp_client_manager();
+    MCPToolsDetailedComponent = class extends BasePromptComponent {
+      constructor() {
+        super("MCPToolsDetailed", 25);
+      }
+      build(context) {
+        const { request } = context;
+        if (!request.includeMCPTools) {
+          return null;
+        }
+        try {
+          const allTools = mcpClientManager.getAllTools();
+          if (!allTools || allTools.length === 0) {
+            return null;
+          }
+          let result = "## MCP \u5DE5\u5177\u8A73\u7D30\u4F7F\u7528\u8AAA\u660E\n\n";
+          result += "\u4EE5\u4E0B\u662F\u6240\u6709\u53EF\u7528\u7684 MCP \u5DE5\u5177\u53CA\u5176\u8A73\u7D30\u4F7F\u7528\u65B9\u5F0F\uFF1A\n\n";
+          for (const tool of allTools) {
+            result += `### ${tool.name}
+
+`;
+            if (tool.description) {
+              result += `**\u8AAA\u660E**: ${tool.description}
+
+`;
+            }
+            if (tool.inputSchema) {
+              result += "**\u53C3\u6578\u683C\u5F0F**:\n```json\n";
+              result += JSON.stringify(tool.inputSchema, null, 2);
+              result += "\n```\n\n";
+              const schema = tool.inputSchema;
+              if (schema.properties && typeof schema.properties === "object") {
+                result += "**\u53C3\u6578\u8AAA\u660E**:\n";
+                const props = schema.properties;
+                const required2 = schema.required || [];
+                for (const [propName, propDef] of Object.entries(props)) {
+                  const isRequired = required2.includes(propName);
+                  result += `- \`${propName}\``;
+                  if (propDef.type) result += ` (${propDef.type})`;
+                  if (isRequired) result += " **\u5FC5\u586B**";
+                  if (propDef.description) result += `: ${propDef.description}`;
+                  result += "\n";
+                }
+                result += "\n";
+              }
+            }
+            result += "**\u8ABF\u7528\u7BC4\u4F8B**:\n```json\n";
+            result += JSON.stringify({
+              tool_calls: [{
+                name: tool.name,
+                arguments: this.generateExampleArgs(tool.inputSchema)
+              }]
+            }, null, 2);
+            result += "\n```\n\n---\n\n";
+          }
+          return result;
+        } catch {
+          return null;
+        }
+      }
+      generateExampleArgs(schema) {
+        if (!schema || !schema.properties) {
+          return {};
+        }
+        const result = {};
+        const props = schema.properties;
+        for (const [propName, propDef] of Object.entries(props)) {
+          switch (propDef.type) {
+            case "string":
+              result[propName] = "<\u5B57\u4E32\u503C>";
+              break;
+            case "number":
+            case "integer":
+              result[propName] = 0;
+              break;
+            case "boolean":
+              result[propName] = true;
+              break;
+            case "array":
+              result[propName] = [];
+              break;
+            case "object":
+              result[propName] = {};
+              break;
+            default:
+              result[propName] = "<\u503C>";
+          }
+        }
+        return result;
+      }
+    };
+  }
+});
+
 // src/utils/prompt-aggregator/components/user-context.ts
 var UserContextComponent;
 var init_user_context = __esm({
@@ -77905,6 +78132,7 @@ var init_components = __esm({
     init_system_prompt();
     init_pinned_prompts();
     init_mcp_tools();
+    init_mcp_tools_detailed();
     init_user_context();
     init_tool_results();
     init_ai_message();
@@ -77916,7 +78144,7 @@ var init_components = __esm({
 function getPromptAggregator() {
   return PromptAggregator.getInstance();
 }
-var PromptAggregator;
+var COMPONENT_NAME_MAP, PromptAggregator;
 var init_prompt_aggregator = __esm({
   "src/utils/prompt-aggregator/prompt-aggregator.ts"() {
     "use strict";
@@ -77925,6 +78153,14 @@ var init_prompt_aggregator = __esm({
     init_database();
     init_mcp_client_manager();
     init_logger();
+    COMPONENT_NAME_MAP = {
+      "system_prompt": "SystemPrompt",
+      "mcp_tools": "MCPToolsPrompt",
+      "mcp_tools_detailed": "MCPToolsDetailed",
+      "user_context": "UserContext",
+      "tool_results": "ToolResults",
+      "closing": "ClosingPrompt"
+    };
     PromptAggregator = class _PromptAggregator {
       static instance;
       components = [];
@@ -77943,6 +78179,7 @@ var init_prompt_aggregator = __esm({
         this.register(new SystemPromptComponent());
         this.register(new PinnedPromptsComponent());
         this.register(new MCPToolsPromptComponent());
+        this.register(new MCPToolsDetailedComponent());
         this.register(new UserContextComponent());
         this.register(new ToolResultsComponent());
         this.register(new AIMessageComponent());
@@ -77958,14 +78195,21 @@ var init_prompt_aggregator = __esm({
       aggregate(context) {
         const sections = [];
         const promptParts = [];
-        for (const component of this.components) {
+        const configs = this.getPromptConfigsWithDefaults();
+        const isFirstCall = context.isFirstCall !== false;
+        const configuredComponents = this.components.map((component) => {
+          const configId = Object.entries(COMPONENT_NAME_MAP).find(
+            ([, name]) => name === component.getName()
+          )?.[0];
+          const config2 = configId ? configs.find((c) => c.id === configId) : null;
+          const order = config2 ? isFirstCall ? config2.firstOrder : config2.secondOrder : component.getOrder();
+          const enabled = config2 ? config2.enabled : true;
+          return { component, order, enabled };
+        }).filter((item) => item.enabled && item.order > 0).sort((a, b) => a.order - b.order);
+        for (const { component, order } of configuredComponents) {
           const content = component.build(context);
           if (content) {
-            sections.push({
-              name: component.getName(),
-              content,
-              order: component.getOrder()
-            });
+            sections.push({ name: component.getName(), content, order });
             promptParts.push(content);
           }
         }
@@ -78056,6 +78300,21 @@ var init_prompt_aggregator = __esm({
       getComponentNames() {
         return this.components.map((c) => c.getName());
       }
+      getPromptConfigsWithDefaults() {
+        try {
+          const configs = getPromptConfigs();
+          if (configs.length > 0) return configs;
+        } catch {
+          logger.warn("[PromptAggregator] \u7121\u6CD5\u5F9E\u8CC7\u6599\u5EAB\u7372\u53D6\u63D0\u793A\u8A5E\u914D\u7F6E\uFF0C\u4F7F\u7528\u9810\u8A2D\u503C");
+        }
+        return [
+          { id: "system_prompt", name: "System Prompt", displayName: "\u7CFB\u7D71\u63D0\u793A\u8A5E", content: null, firstOrder: 10, secondOrder: 10, enabled: true, editable: false, createdAt: "", updatedAt: "" },
+          { id: "mcp_tools", name: "MCP Tools", displayName: "MCP \u5DE5\u5177\u8AAA\u660E", content: null, firstOrder: 20, secondOrder: 0, enabled: true, editable: true, createdAt: "", updatedAt: "" },
+          { id: "user_context", name: "User Context", displayName: "\u7528\u6236\u4E0A\u4E0B\u6587", content: null, firstOrder: 30, secondOrder: 20, enabled: true, editable: true, createdAt: "", updatedAt: "" },
+          { id: "tool_results", name: "Tool Results", displayName: "\u5DE5\u5177\u57F7\u884C\u7D50\u679C", content: null, firstOrder: 0, secondOrder: 30, enabled: true, editable: false, createdAt: "", updatedAt: "" },
+          { id: "closing", name: "Closing", displayName: "\u7D50\u5C3E\u63D0\u793A", content: null, firstOrder: 40, secondOrder: 40, enabled: true, editable: true, createdAt: "", updatedAt: "" }
+        ];
+      }
     };
   }
 });
@@ -78788,8 +79047,25 @@ function cleanExpiredCache() {
 function clearAICache() {
   cache.clear();
 }
-async function validateAPIKey(apiKey, model) {
+async function validateAPIKey(apiKey, model, apiUrl, openaiCompatible) {
   try {
+    const provider = getProviderFromUrl(apiUrl);
+    if (openaiCompatible || provider === "openai" || provider === "nvidia" || provider === "zai") {
+      const OpenAI = (await import("openai")).default;
+      const client = new OpenAI({
+        apiKey,
+        baseURL: apiUrl || "https://api.openai.com/v1"
+      });
+      const response2 = await client.chat.completions.create({
+        model,
+        messages: [{ role: "user", content: "Hello" }],
+        max_tokens: 10
+      });
+      if (response2.choices && response2.choices.length > 0) {
+        return { valid: true };
+      }
+      return { valid: false, error: "\u7121\u6CD5\u751F\u6210\u56DE\u61C9" };
+    }
     const genAI = new GoogleGenerativeAI(apiKey);
     const generativeModel = genAI.getGenerativeModel({ model });
     const result = await generativeModel.generateContent("Hello");
@@ -78806,6 +79082,16 @@ async function validateAPIKey(apiKey, model) {
     };
   }
 }
+function getProviderFromUrl(apiUrl) {
+  if (!apiUrl) return "google";
+  const normalizedUrl = apiUrl.toLowerCase();
+  if (normalizedUrl.includes("api.openai.com")) return "openai";
+  if (normalizedUrl.includes("api.anthropic.com")) return "anthropic";
+  if (normalizedUrl.includes("generativelanguage.googleapis.com")) return "google";
+  if (normalizedUrl.includes("nvidia.com")) return "nvidia";
+  if (normalizedUrl.includes("bigmodel.cn") || normalizedUrl.includes("z.ai")) return "zai";
+  return "openai";
+}
 function estimateTokenCount(text) {
   const englishChars = (text.match(/[a-zA-Z0-9]/g) || []).length;
   const chineseChars = (text.match(/[\u4e00-\u9fa5]/g) || []).length;
@@ -93380,7 +93666,7 @@ var WebServer = class {
     this.app.post("/api/ai-settings/validate", async (req, res) => {
       const startTime = Date.now();
       try {
-        let { apiKey } = req.body;
+        let { apiKey, apiUrl, openaiCompatible } = req.body;
         const { model } = req.body;
         if (!model) {
           const errorMsg = "\u6A21\u578B\u70BA\u5FC5\u586B\u6B04\u4F4D";
@@ -93400,6 +93686,7 @@ var WebServer = class {
           return;
         }
         let usingDatabaseKey = false;
+        let usingDatabaseUrl = false;
         if (!apiKey) {
           const settings = getAISettings();
           if (!settings || !settings.apiKey || settings.apiKey === "YOUR_API_KEY_HERE") {
@@ -93422,13 +93709,18 @@ var WebServer = class {
           }
           apiKey = settings.apiKey;
           usingDatabaseKey = true;
+          if (!apiUrl) {
+            apiUrl = settings.apiUrl;
+            usingDatabaseUrl = true;
+          }
           logger.info("\u4F7F\u7528\u8CC7\u6599\u5EAB\u4E2D\u89E3\u5BC6\u7684 API Key \u9032\u884C\u9A57\u8B49");
           logger.debug(`\u89E3\u5BC6\u5F8C\u7684 API Key \u9577\u5EA6: ${apiKey.length}, \u524D\u7DB4: ${apiKey.substring(0, 3)}...`);
         } else {
           logger.info("\u4F7F\u7528\u65B0\u8F38\u5165\u7684 API Key \u9032\u884C\u9A57\u8B49");
           logger.debug(`\u65B0\u8F38\u5165\u7684 API Key \u9577\u5EA6: ${apiKey.length}, \u524D\u7DB4: ${apiKey.substring(0, 3)}...`);
         }
-        const result = await validateAPIKey(apiKey, model);
+        logger.info(`\u9A57\u8B49\u4F7F\u7528 API URL: ${apiUrl} (\u8CC7\u6599\u5EAB: ${usingDatabaseUrl}), OpenAI \u76F8\u5BB9: ${openaiCompatible}`);
+        const result = await validateAPIKey(apiKey, model, apiUrl, openaiCompatible);
         if (result.valid) {
           logger.info(`API Key \u9A57\u8B49\u6210\u529F (${usingDatabaseKey ? "\u8CC7\u6599\u5EAB" : "\u65B0\u8F38\u5165"})`);
           logAPIRequest({
@@ -93591,6 +93883,68 @@ var WebServer = class {
         });
       }
     });
+    this.app.get("/api/settings/prompts", (req, res) => {
+      try {
+        const prompts = getPromptConfigs();
+        res.json({ success: true, prompts });
+      } catch (error2) {
+        logger.error("\u7372\u53D6\u63D0\u793A\u8A5E\u914D\u7F6E\u5931\u6557:", error2);
+        res.status(500).json({
+          success: false,
+          error: error2 instanceof Error ? error2.message : "\u7372\u53D6\u63D0\u793A\u8A5E\u914D\u7F6E\u5931\u6557"
+        });
+      }
+    });
+    this.app.put("/api/settings/prompts", (req, res) => {
+      try {
+        const { prompts } = req.body;
+        if (!prompts || !Array.isArray(prompts)) {
+          res.status(400).json({ success: false, error: "prompts \u5FC5\u9808\u662F\u9663\u5217" });
+          return;
+        }
+        for (const prompt of prompts) {
+          if (!prompt.id) {
+            res.status(400).json({ success: false, error: "\u6BCF\u500B\u914D\u7F6E\u5FC5\u9808\u5305\u542B id" });
+            return;
+          }
+          if (prompt.firstOrder !== void 0 && (prompt.firstOrder < 0 || prompt.firstOrder > 1e3)) {
+            res.status(400).json({ success: false, error: "firstOrder \u5FC5\u9808\u5728 0-1000 \u4E4B\u9593" });
+            return;
+          }
+          if (prompt.secondOrder !== void 0 && (prompt.secondOrder < 0 || prompt.secondOrder > 1e3)) {
+            res.status(400).json({ success: false, error: "secondOrder \u5FC5\u9808\u5728 0-1000 \u4E4B\u9593" });
+            return;
+          }
+        }
+        const success = updatePromptConfigs({ prompts });
+        if (success) {
+          const updatedPrompts = getPromptConfigs();
+          logger.info(`\u63D0\u793A\u8A5E\u914D\u7F6E\u5DF2\u66F4\u65B0: ${prompts.length} \u9805`);
+          res.json({ success: true, prompts: updatedPrompts });
+        } else {
+          res.status(500).json({ success: false, error: "\u66F4\u65B0\u5931\u6557" });
+        }
+      } catch (error2) {
+        logger.error("\u66F4\u65B0\u63D0\u793A\u8A5E\u914D\u7F6E\u5931\u6557:", error2);
+        res.status(500).json({
+          success: false,
+          error: error2 instanceof Error ? error2.message : "\u66F4\u65B0\u63D0\u793A\u8A5E\u914D\u7F6E\u5931\u6557"
+        });
+      }
+    });
+    this.app.post("/api/settings/prompts/reset", (req, res) => {
+      try {
+        const prompts = resetPromptConfigs();
+        logger.info("\u63D0\u793A\u8A5E\u914D\u7F6E\u5DF2\u91CD\u7F6E\u70BA\u9810\u8A2D\u503C");
+        res.json({ success: true, prompts });
+      } catch (error2) {
+        logger.error("\u91CD\u7F6E\u63D0\u793A\u8A5E\u914D\u7F6E\u5931\u6557:", error2);
+        res.status(500).json({
+          success: false,
+          error: error2 instanceof Error ? error2.message : "\u91CD\u7F6E\u63D0\u793A\u8A5E\u914D\u7F6E\u5931\u6557"
+        });
+      }
+    });
     this.app.get("/api/logs", (req, res) => {
       try {
         const options = {};
@@ -95254,9 +95608,35 @@ var MCPServer = class {
     this.mcpServer.registerTool(
       "collect_feedback",
       {
-        description: "Collect feedback from users about AI work summary. This tool opens a web interface for users to provide feedback on the AI's work.",
+        description: `Collect feedback from users about AI work. This tool opens a web interface for users to provide feedback.
+
+CRITICAL: The 'work_summary' field is the PRIMARY and ONLY content displayed to users in the feedback UI. You MUST include ALL relevant information in this field as a comprehensive Markdown-formatted report. The UI renders Markdown, so use headings, tables, code blocks, and lists for better readability.`,
         inputSchema: {
-          work_summary: external_exports.string().describe("AI\u5DE5\u4F5C\u532F\u5831\u5167\u5BB9\uFF0C\u63CF\u8FF0AI\u5B8C\u6210\u7684\u5DE5\u4F5C\u548C\u7D50\u679C"),
+          work_summary: external_exports.string().describe(`\u3010CRITICAL - THIS IS THE ONLY CONTENT SHOWN TO USERS\u3011
+
+Include a COMPLETE Markdown report with ALL of the following sections:
+
+## Required Sections:
+1. **\u{1F4CB} Task Summary** - Brief description of what was requested and accomplished
+2. **\u{1F4C1} Implementation Details** - Files created/modified with:
+   - Full file paths
+   - Key code snippets in fenced code blocks
+   - Explanation of changes
+3. **\u2705 Status Table** - Markdown table showing completion status:
+   | Item | Status | Notes |
+   |------|--------|-------|
+   | Feature A | \u2705 Done | ... |
+4. **\u{1F9EA} Test Results** - Build/test command outputs and outcomes
+5. **\u27A1\uFE0F Next Steps** - Actionable options in A/B/C format for user decision:
+   - Option A: [action] - [description]
+   - Option B: [action] - [description]
+6. **\u{1F3D7}\uFE0F Architecture** (if applicable) - ASCII diagrams or Mermaid code blocks
+
+## Format Requirements:
+- Use Markdown: ## headings, \`code\`, **bold**, tables
+- Minimum 500 characters for non-trivial tasks
+- Be specific with file paths and code examples
+- Include ALL information user needs to make decisions`),
           project_name: external_exports.string().optional().describe("\u5C08\u6848\u540D\u7A31\uFF08\u7528\u65BC Dashboard \u5206\u7D44\u986F\u793A\uFF09"),
           project_path: external_exports.string().optional().describe("\u5C08\u6848\u8DEF\u5F91\uFF08\u7528\u65BC\u552F\u4E00\u8B58\u5225\u5C08\u6848\uFF09")
         }