@telosmaylx/dsh-session-notify 0.1.13 → 0.1.17

package/lib/core.js

@@ -30,11 +30,11 @@ function tableFor(language) {
  * 优先级：titleTemplates[kind] > titleTemplate（全局模板）> 本表。
  */
 const DEFAULT_TITLES = {
-  zh: { completed: '任务已完成', aborted: '任务已中止', blocked: '任务被阻塞', error: '任务出错', 'max-tokens': '任务达到上限' },
-  'zh-tw': { completed: '任務已完成', aborted: '任務已中止', blocked: '任務被阻塞', error: '任務出錯', 'max-tokens': '任務達到上限' },
-  en: { completed: 'Task completed', aborted: 'Task aborted', blocked: 'Task blocked', error: 'Task failed', 'max-tokens': 'Task hit the cap' },
-  ja: { completed: 'タスク完了', aborted: 'タスク中止', blocked: 'タスクがブロックされました', error: 'タスクエラー', 'max-tokens': '上限に到達' },
-  ko: { completed: '작업 완료', aborted: '작업 중단됨', blocked: '작업 차단됨', error: '작업 오류', 'max-tokens': '한도 도달' },
+  zh: { completed: '任务已完成', aborted: '任务已中止', blocked: '任务被阻塞', error: '任务出错', 'max-tokens': '任务达到上限', question: 'AI 正在向你提问' },
+  'zh-tw': { completed: '任務已完成', aborted: '任務已中止', blocked: '任務被阻塞', error: '任務出錯', 'max-tokens': '任務達到上限', question: 'AI 正在向你提問' },
+  en: { completed: 'Task completed', aborted: 'Task aborted', blocked: 'Task blocked', error: 'Task failed', 'max-tokens': 'Task hit the cap', question: 'AI is asking you a question' },
+  ja: { completed: 'タスク完了', aborted: 'タスク中止', blocked: 'タスクがブロックされました', error: 'タスクエラー', 'max-tokens': '上限に到達', question: 'AI からの質問が届きました' },
+  ko: { completed: '작업 완료', aborted: '작업 중단됨', blocked: '작업 차단됨', error: '작업 오류', 'max-tokens': '한도 도달', question: 'AI가 질문했습니다' },
 }
 
 /**
@@ -54,6 +54,7 @@ export function renderTitle(kind, opts = {}, titleValue = '') {
   const tpl = per || global || fallback
   // {image}/{icon} 是正文媒体的开关标签，标题里若误写则剥除；其余信息位（{duration}{usage}{error}{cache}{tps}）
   // 用会话数据替换（无数据则替换为空串），避免字面量泄漏到推送标题
+  // {question} 仅在提问原因（kind=question）下替换为实际提问文本（opts.questionText），其他原因剥除
   const out = String(tpl)
     .replace(/\{image\}/g, '')
     .replace(/\{icon\}/g, '')
@@ -64,6 +65,7 @@ export function renderTitle(kind, opts = {}, titleValue = '') {
     .replaceAll('{error}', opts.error ?? '')
     .replaceAll('{cache}', opts.cache ?? '')
     .replaceAll('{tps}', opts.tps ?? '')
+    .replaceAll('{question}', kind === 'question' ? (opts.questionText ?? '') : '')
     .trim()
   return out || fallback
 }
@@ -84,6 +86,7 @@ const DEFAULT_PHRASES = {
     blocked: '会话{titleBlock}被阻塞，请点击查看。',
     error: '会话{titleBlock}出错，请点击查看。',
     'max-tokens': '会话{titleBlock}达到上限，请点击查看。',
+    question: 'AI 向你提问：{question}',
     generic: '会话{titleBlock}已结束，请点击查看。',
   },
   'zh-tw': {
@@ -92,6 +95,7 @@ const DEFAULT_PHRASES = {
     blocked: '會話{titleBlock}被阻塞，請點擊查看。',
     error: '會話{titleBlock}出錯，請點擊查看。',
     'max-tokens': '會話{titleBlock}達到上限，請點擊查看。',
+    question: 'AI 向你提問：{question}',
     generic: '會話{titleBlock}已結束，請點擊查看。',
   },
   en: {
@@ -100,6 +104,7 @@ const DEFAULT_PHRASES = {
     blocked: 'Session {titleBlock} blocked. Click to view.',
     error: 'Session {titleBlock} failed. Click to view.',
     'max-tokens': 'Session {titleBlock} hit the cap. Click to view.',
+    question: 'AI is asking: {question}',
     generic: 'Session {titleBlock} ended. Click to view.',
   },
   ja: {
@@ -108,6 +113,7 @@ const DEFAULT_PHRASES = {
     blocked: 'セッション{titleBlock}がブロックされました。クリックして表示。',
     error: 'セッション{titleBlock}エラー。クリックして表示。',
     'max-tokens': 'セッション{titleBlock}上限に到達。クリックして表示。',
+    question: 'AI からの質問：{question}',
     generic: 'セッション{titleBlock}終了。クリックして表示。',
   },
   ko: {
@@ -116,6 +122,7 @@ const DEFAULT_PHRASES = {
     blocked: '세션{titleBlock} 차단됨. 클릭하여 확인.',
     error: '세션{titleBlock} 오류. 클릭하여 확인.',
     'max-tokens': '세션{titleBlock} 한도 도달. 클릭하여 확인.',
+    question: 'AI가 질문합니다: {question}',
     generic: '세션{titleBlock} 종료. 클릭하여 확인.',
   },
 }
@@ -302,6 +309,36 @@ export function tpsOf(usage, ms) {
   return `${Math.round(output / (ms / 1000))} tok/s`
 }
 
+/**
+ * 渲染提问提醒的正文：templates.question（自定义模板）> 语言默认短语。
+ * 模板占位符：{question}（问题文本，必需）、{title}（会话标题，投影无上下文时为空）。
+ * 渲染结果为空时回退问题文本本身。
+ * @param {string} questionText
+ * @param {{ language?: string; templates?: Record<string, string> }} [opts]
+ * @param {string} [titleValue]
+ * @returns {string}
+ */
+export function buildQuestionBody(questionText, opts = {}, titleValue = '') {
+  const language = LABELS[opts.language] ? opts.language : 'zh'
+  const q = typeof questionText === 'string' ? questionText : ''
+  const tpl = (opts.templates && typeof opts.templates.question === 'string' && opts.templates.question.trim() !== '') ? opts.templates.question : ''
+  const defaultPhrase = (DEFAULT_PHRASES[language] && DEFAULT_PHRASES[language].question) || (DEFAULT_PHRASES[language] && DEFAULT_PHRASES[language].generic) || ''
+  const out = String(tpl || defaultPhrase)
+    .replaceAll('{question}', q)
+    .replaceAll('{title}', typeof titleValue === 'string' ? titleValue : '')
+    .replace(/\{label\}/g, '')
+    .replace(/\{image\}/g, '')
+    .replace(/\{icon\}/g, '')
+    // 提问通道只有提问文本与会话标题两个数据源：误插其他信息位一律替换为空串，避免字面量泄漏
+    .replaceAll('{duration}', '')
+    .replaceAll('{usage}', '')
+    .replaceAll('{error}', '')
+    .replaceAll('{cache}', '')
+    .replaceAll('{tps}', '')
+    .trim()
+  return out || q
+}
+
 /**
  * 构建系统消息：可折叠行的 summary（= 正文渲染结果的截断，≤120 字符）
  * + 展开/模型可见的全文。
@@ -393,6 +430,8 @@ export function renderTemplate(template, vars) {
     .replace(/\{label\}/g, '')
     .replace(/\{image\}/g, '')
     .replace(/\{icon\}/g, '')
+    // {question} 仅提问通道（buildQuestionBody）有效：其他原因模板中误插一律剥除，防字面量泄漏
+    .replace(/\{question\}/g, '')
     .replaceAll('{title}', vars.title ?? '')
     .replaceAll('{duration}', vars.duration)
     .replaceAll('{usage}', vars.usage)

package/lib/index.js

@@ -32,11 +32,11 @@
  *             includeUsage: true
  */
 
-import { appendFileSync } from 'node:fs'
+import { appendFileSync, statSync, truncateSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 import { createRequire } from 'node:module'
-import { createTurnTracker, buildNotice, isSubagentSession, officialCacheRate, officialTps, renderTitle } from './core.js?v=1' // v=1: 缓存破坏——HMR 重载按 URL 键控
+import { createTurnTracker, buildNotice, buildQuestionBody, isSubagentSession, officialCacheRate, officialTps, renderTitle } from './core.js?v=1' // v=1: 缓存破坏——HMR 重载按 URL 键控
 
 /** Cordis loader 诊断用插件名。 */
 export const name = 'session-complete-notify'
@@ -47,6 +47,9 @@ const PLUGIN_ID = 'dsh-session-notify'
 /** 设置命名空间（官方「设置 → 插件」面板的键）。 */
 const SETTINGS_NS = 'session-complete-notify'
 
+/** 会话投影 key：正在等待用户回答的 ask_user_question 问题（客户端据此推送提问提醒）。 */
+const QUESTION_PROJECTION_KEY = 'session-complete-notify-question'
+
 /**
  * 本插件从仓库目录以 realpath 加载，裸导入（@deepseek-ai/*）无法解析；
  * 用 createRequire 锚定 profile 共享依赖枢纽（.dsh/profiles/node_modules），
@@ -72,10 +75,10 @@ const DEFAULT_OPTIONS = {
 /** 设置面板可见字段的默认值（与 Config 同构；仓库里的 schema 默认值与此一致）。 */
 const DEFAULT_SETTINGS = {
   language: 'zh',
-  templates: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '' },
+  templates: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '', question: '' },
   titleTemplate: '', // 空 = 未自定义全局标题，各原因使用语言默认标题（如「任务已完成」「任务出错」）
   /** 按原因定制推送标题（空 = 用 titleTemplate 或语言默认标题）。 */
-  titleTemplates: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '' },
+  titleTemplates: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '', question: '' },
   includeDuration: true,
   includeUsage: true,
   skipSubagents: true,
@@ -89,12 +92,12 @@ const DEFAULT_SETTINGS = {
   imagePreviewUrl: '',
   iconPreviewUrl: '',
   /** 按原因的自定义通知大图（{image} 标签开关对应的数据，本地文件压缩后的 data URI）。 */
-  images: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '' },
+  images: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '', question: '' },
   /** 按原因的自定义通知图标（{icon} 标签开关对应的数据，本地文件压缩后的 data URI，128×128 方形）。 */
-  icons: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '' },
+  icons: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '', question: '' },
   /** 按原因的完整预览版（等比 1024 未裁切），与 images/icons 一一对应。 */
-  imagePreviews: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '' },
-  iconPreviews: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '' },
+  imagePreviews: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '', question: '' },
+  iconPreviews: { completed: '', error: '', aborted: '', blocked: '', 'max-tokens': '', question: '' },
 }
 
 /** 从任意输入规整为设置形状（容忍缺失/多余字段）。 */
@@ -178,6 +181,7 @@ export function apply(ctx, config = {}) {
         aborted: Schema.string().default(''),
         blocked: Schema.string().default(''),
         'max-tokens': Schema.string().default(''),
+        question: Schema.string().default(''),
       }),
       titleTemplate: Schema.string().default(''),
       titleTemplates: Schema.object({
@@ -186,6 +190,7 @@ export function apply(ctx, config = {}) {
         aborted: Schema.string().default(''),
         blocked: Schema.string().default(''),
         'max-tokens': Schema.string().default(''),
+        question: Schema.string().default(''),
       }),
       includeDuration: Schema.boolean().default(true),
       includeUsage: Schema.boolean().default(true),
@@ -201,6 +206,7 @@ export function apply(ctx, config = {}) {
         aborted: Schema.string().default(''),
         blocked: Schema.string().default(''),
         'max-tokens': Schema.string().default(''),
+        question: Schema.string().default(''),
       }),
       icons: Schema.object({
         completed: Schema.string().default(''),
@@ -208,6 +214,7 @@ export function apply(ctx, config = {}) {
         aborted: Schema.string().default(''),
         blocked: Schema.string().default(''),
         'max-tokens': Schema.string().default(''),
+        question: Schema.string().default(''),
       }),
       imagePreviews: Schema.object({
         completed: Schema.string().default(''),
@@ -215,6 +222,7 @@ export function apply(ctx, config = {}) {
         aborted: Schema.string().default(''),
         blocked: Schema.string().default(''),
         'max-tokens': Schema.string().default(''),
+        question: Schema.string().default(''),
       }),
       iconPreviews: Schema.object({
         completed: Schema.string().default(''),
@@ -222,6 +230,7 @@ export function apply(ctx, config = {}) {
         aborted: Schema.string().default(''),
         blocked: Schema.string().default(''),
         'max-tokens': Schema.string().default(''),
+        question: Schema.string().default(''),
       }),
     })
     let attempts = 0
@@ -307,6 +316,43 @@ export function apply(ctx, config = {}) {
         } catch (err) {
           warn(ctx, `投影单元注册失败: ${err?.message ?? err}`)
         }
+
+        // 提问投影：ask_user_question 发起时让客户端立即推送，避免用户在其他页面错过提问。
+        // 状态是瞬时的：tool/result 或 turn/end 后清空，不写入会话内系统消息。
+        // title/body 由宿主按 5 语言默认文案/用户模板渲染后写入投影，客户端零文案逻辑。
+        try {
+          rootRegistry.register({
+            key: QUESTION_PROJECTION_KEY,
+            schema: z.object({ id: z.string(), text: z.string(), title: z.string(), body: z.string() }),
+            init: () => ({ id: '', text: '', title: '', body: '' }),
+            apply: (state, event) => {
+              if (event.type === 'tool/call' && event.data?.name === 'ask_user_question') {
+                const id = typeof event.data.callId === 'string' ? event.data.callId : ''
+                const text = extractQuestionText(event.data.arguments)
+                if (!id || !text) return state
+                return {
+                  id,
+                  text,
+                  title: renderTitle('question', { language: settings.language, titleTemplate: settings.titleTemplate, titleTemplates: settings.titleTemplates, questionText: text }),
+                  body: buildQuestionBody(text, { language: settings.language, templates: settings.templates }),
+                }
+              }
+              if (event.type === 'tool/result') {
+                if (!state.id) return state
+                return matchesQuestionResult(state.id, event.data) ? { id: '', text: '', title: '', body: '' } : state
+              }
+              if (event.type === 'turn/end' && state.id) {
+                return { id: '', text: '', title: '', body: '' }
+              }
+              return state
+            },
+            view: (state) => state,
+            stateVersion: 2, // 投影值升级：新增 body（宿主渲染好的提问正文）
+          })
+          fileLog('session-projections unit registered (key=session-complete-notify-question)')
+        } catch (err) {
+          warn(ctx, `提问投影单元注册失败: ${err?.message ?? err}`)
+        }
       })
     }
   } catch (err) {
@@ -326,7 +372,7 @@ export function apply(ctx, config = {}) {
         const state = tracker.end(key, event.time)
         const kind = event.data.reason?.kind
         if (!reasons.has(kind)) return
-        if (isSubagentSession(session)) return // 默认跳过子代理会话（子代理由父会话编排）
+        if (settings.skipSubagents !== false && isSubagentSession(session)) return // 跳过子代理会话（面板复选框可关闭）
         // 官方投影口径：tokenUsage（缓存命中率）+ sessionStats（tok/s 生成速度）
         // 与 dsh-web-ui 状态栏同源；投影由宿主维护，无插件内存状态，重载也不丢。
         // 用户以「标签是否插入」控制显示（用量/用时无独立开关）。
@@ -402,6 +448,48 @@ export function apply(ctx, config = {}) {
   }
 }
 
+/**
+ * 从 ask_user_question 的 arguments 中提取人类可读的问题文本。
+ * @param {unknown} raw - tool/call 的 arguments（通常是 JSON 字符串）。
+ * @returns {string}
+ */
+function extractQuestionText(raw) {
+  try {
+    const args = typeof raw === 'string' ? JSON.parse(raw) : raw
+    const questions = Array.isArray(args?.questions) ? args.questions : []
+    return questions
+      .map((q) => (q && typeof q.question === 'string' ? q.question : ''))
+      .filter(Boolean)
+      .join('\n')
+      .trim()
+  } catch {
+    return ''
+  }
+}
+
+/**
+ * 判断 tool/result 是否对应某个 ask_user_question 调用。
+ * tool/result 的 data.message.source.callId 与 content[].toolCallId 都携带调用 id。
+ * @param {string} id - 待匹配的 ask_user_question callId。
+ * @param {unknown} data - tool/result 的 event.data。
+ * @returns {boolean}
+ */
+function matchesQuestionResult(id, data) {
+  if (!id || !data || typeof data !== 'object') return false
+  const candidates = []
+  const source = data.message?.source
+  if (source && typeof source.callId === 'string') candidates.push(source.callId)
+  if (typeof data.callId === 'string') candidates.push(data.callId)
+  const blocks = data.message?.content
+  if (Array.isArray(blocks)) {
+    for (const block of blocks) {
+      if (block && typeof block.toolCallId === 'string') candidates.push(block.toolCallId)
+      if (block && typeof block.tool_call_id === 'string') candidates.push(block.tool_call_id)
+    }
+  }
+  return candidates.includes(id)
+}
+
 /** 把系统消息追加进会话日志（失败只记日志，绝不抛出破坏 event 火线）。 */
 function appendNotice(ctx, session, notice, kind, title) {
   try {
@@ -429,9 +517,15 @@ function appendNotice(ctx, session, notice, kind, title) {
 }
 
 /** 追加失败时落一个调试文件（~/.dsh/session-complete-notify.log），便于排查。 */
+const LOG_MAX_BYTES = 512 * 1024 // P2-8：超过 512KB 截断，避免长期运行无限增长
 function fileLog(line) {
   try {
-    appendFileSync(join(homedir(), '.dsh', 'session-complete-notify.log'), `${new Date().toISOString()} ${line}\n`, 'utf8')
+    const file = join(homedir(), '.dsh', 'session-complete-notify.log')
+    try {
+      const st = statSync(file)
+      if (st.size > LOG_MAX_BYTES) truncateSync(file, 0)
+    } catch { /* 文件不存在等，忽略 */ }
+    appendFileSync(file, `${new Date().toISOString()} ${line}\n`, 'utf8')
   } catch {
     /* 尽力而为 */
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telosmaylx/dsh-session-notify",
-  "version": "0.1.13",
+  "version": "0.1.17",
   "description": "DSH session completion notifier: appends a plugin system message to the session log on turn/end and pushes browser notifications (Web Notification + toast), with a fully customizable official settings panel (presets, 5-language templates, cache-hit rate & tok/s from official projections).",
   "private": false,
   "type": "module",