@p-dsh-market/conversation-knowledge-map 0.1.16 → 0.1.17

package/README.md

@@ -19,7 +19,7 @@ DSH 的“知识视图”插件，把同一工作路径下用户明确选择的
 
 ## 生成失败诊断
 
-Host 和生成编排器会输出带 `[conversation-knowledge-map]` 前缀的诊断日志。日志包含路由、Provider / Model、Agent Session、实时事件类型、surface/session 读取次数、提取文本长度、输出形状和错误原因，不记录 Prompt、对话正文或模型返回正文。优先查看 DSH Web Runtime 的终端日志；若 Runtime 提供 logger 服务，则同时写入该 logger。重点关注 `agent event`、`agent idle`、`agent turn failure`、`agent surface read`、`agent session read` 和 `agent output parse failed`。Runtime 在 `turn/end.reason.kind = error` 时会优先显示其 `code/message`；只有未发现 turn 错误且确实没有助手输出时，才会报告“模型没有返回 JSON 对象”。
+Host 和生成编排器会输出带 `[conversation-knowledge-map]` 前缀的诊断日志。日志包含路由、Provider / Model、Agent Session、实时事件类型、surface/session 读取次数、提取文本长度、输出形状和错误原因，不记录 Prompt 或原始对话正文。为诊断结构化输出失败，当前还会记录模型实际返回文本：不超过 32000 字符时完整记录，超过时保留首尾各 16000 字符；该内容可能包含模型整理出的对话信息，排障完成后应按运行环境的日志策略清理。解析失败日志会额外列出 Markdown JSON 围栏、首末大括号位置以及每个候选对象属于未闭合、JSON 语法错误、合法但结构不符或合法目标结构。优先查看 DSH Web Runtime 的终端日志；若 Runtime 提供 logger 服务，则同时写入该 logger。重点关注 `agent output content`、`agent output parse failed`、`agent event`、`agent idle`、`agent turn failure`、`agent surface read` 和 `agent session read`。Runtime 在 `turn/end.reason.kind = error` 时会优先显示其 `code/message`；只有未发现 turn 错误且确实没有助手输出时，才会报告“模型没有返回 JSON 对象”。
 
 ## 本地验证
 

package/lib/generation-orchestrator.js

@@ -128,6 +128,73 @@ function findJsonObject(text, kind = '') {
   return null
 }
 
+function modelOutputText(value) {
+  const text = textFromContent(value)
+  if (text) return text
+  if (value && typeof value === 'object') {
+    try { return JSON.stringify(value) } catch { /* fall through to a printable scalar */ }
+  }
+  return String(value ?? '')
+}
+
+function loggableModelOutput(value, max = 32000) {
+  const text = modelOutputText(value)
+  if (text.length <= max) return { text, loggedText: JSON.stringify(text), truncated: false }
+  const half = Math.floor(max / 2)
+  const bounded = `${text.slice(0, half)}\n…[中间 ${text.length - max} 个字符因日志长度限制被省略]…\n${text.slice(-half)}`
+  return { text, loggedText: JSON.stringify(bounded), truncated: true }
+}
+
+function jsonParseDiagnostics(value, kind = '') {
+  const text = modelOutputText(value).replace(/^\uFEFF/, '').trim()
+  const starts = []
+  for (let index = 0; index < text.length && starts.length < 12; index += 1) if (text[index] === '{') starts.push(index)
+  const candidates = []
+  for (const start of starts) {
+    let depth = 0
+    let inString = false
+    let escaped = false
+    let end = -1
+    for (let index = start; index < text.length; index += 1) {
+      const char = text[index]
+      if (inString) {
+        if (escaped) escaped = false
+        else if (char === '\\') escaped = true
+        else if (char === '"') inString = false
+        continue
+      }
+      if (char === '"') inString = true
+      else if (char === '{') depth += 1
+      else if (char === '}' && --depth === 0) { end = index; break }
+    }
+    if (end < 0) {
+      candidates.push({ start, status: 'unclosed-object' })
+      continue
+    }
+    const fragment = text.slice(start, end + 1)
+    try {
+      const parsed = JSON.parse(fragment)
+      candidates.push({
+        start,
+        end,
+        status: expectedObject(parsed, kind) ? 'valid-expected-shape' : 'valid-json-wrong-shape',
+        keys: parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? Object.keys(parsed).slice(0, 20) : []
+      })
+    } catch (error) {
+      candidates.push({ start, end, status: 'invalid-json', error: shortText(errorMessage(error), 300) })
+    }
+  }
+  return {
+    kind,
+    textLength: text.length,
+    fencedJson: /```(?:json)?\s*[\s\S]*?```/i.test(text),
+    firstBrace: text.indexOf('{'),
+    lastBrace: text.lastIndexOf('}'),
+    candidateCountInspected: candidates.length,
+    candidates
+  }
+}
+
 export function parseStructuredOutput(value, kind = '') {
   const object = asObject(value)
   if (object && expectedObject(object, kind)) return object
@@ -976,13 +1043,15 @@ export class KnowledgeGenerationOrchestrator {
 
   async runModel(input) {
     const parseModelOutput = (value, source, diagnostics = {}) => {
+      const output = loggableModelOutput(value)
+      logMessage(this.logger, 'info', 'agent output content kind=%s source=%s length=%d truncated=%s content=%s', input.kind, source, output.text.length, output.truncated, output.loggedText)
       try {
         const result = parseStructuredOutput(value, input.kind)
         logMessage(this.logger, 'info', 'agent output parsed kind=%s source=%s value=%s result=%s', input.kind, source, diagnosticSummary(value), diagnosticSummary(result))
         return result
       } catch (error) {
         const surfacedError = diagnostics.agentLimit || error
-        logMessage(this.logger, 'error', 'agent output parse failed kind=%s source=%s value=%s diagnostics=%s error=%s', input.kind, source, diagnosticSummary(value), JSON.stringify(diagnostics), errorMessage(surfacedError))
+        logMessage(this.logger, 'error', 'agent output parse failed kind=%s source=%s value=%s parseDiagnostics=%s runtimeDiagnostics=%s error=%s', input.kind, source, diagnosticSummary(value), JSON.stringify(jsonParseDiagnostics(value, input.kind)), JSON.stringify(diagnostics), errorMessage(surfacedError))
         throw surfacedError
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p-dsh-market/conversation-knowledge-map",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "DSH 多对话思维导图与静态知识图谱",
   "keywords": [
     "dsh",