@yfwu2020/dsh-selection-explain 0.11.1 → 0.13.0

package/lib/types/host/types.d.ts

@@ -13,6 +13,19 @@ export interface AnalyzeBody {
     stage?: unknown;
     /** 'code' | 'text'：选中文字是不是代码（代码走「注释」提示词：代码块 + 逐句注释 + 小结）。 */
     kind?: unknown;
+    /**
+     * 截图提问的**第二次调用**：只取标题。
+     * 前缀与回答那次完全一致（system + 图 + 提问），只在最后追加一句"只输出标题"，
+     * 目的是让图那部分命中前缀缓存。
+     */
+    titleOnly?: unknown;
+    /**
+     * 截图取景范围：screen / window / margin / selection。
+     * 提示词据此换口径（仅选区没有红框，留白/全屏/整窗的"框外是什么"不同）。
+     */
+    shotScope?: unknown;
+    /** 截图最终图里有没有红框（仅选区为 false）。 */
+    shotFrame?: unknown;
     /** 本会话已用过的工具结果摘要（追问时带上，避免重复联网）。 */
     toolDigest?: unknown;
     /** 小窗对话历史（A′）：整段对话的持久化条目。 */
@@ -34,6 +47,10 @@ export interface AnalyzeBody {
     question?: unknown;
     /** 追问模式下的历史轮次：[{ role: 'user' | 'assistant', text }]。 */
     history?: unknown;
+    historyStart?: unknown;
+    contextState?: unknown;
+    materials?: unknown;
+    initialExplanation?: unknown;
     /**
      * 这一轮追问带的附件：[{ kind: 'image' | 'file', ref }]，ref 是 /api/attach 存好之后的持久引用。
      * 图片 → ImageBlock（模型直接看）；文件 → FileBlock（dsh-llm 投影成"名字 + 字节数 + 只读路径"一行）。

package/lib/types/prompts.d.ts

@@ -23,4 +23,25 @@ export declare const CODE_PROMPT: string;
 /** 只输出「详解」一节时用（第二阶段，带完整会话背景）。 */
 export declare const DETAIL_PROMPT: string;
 /** 追问模式（对话小窗）的系统提示词：不再要求两节结构，就是围绕这段文字聊天。 */
+/**
+ * 截图提问（独立模式）。
+ *
+ * 和"追问"不是一回事：那条路的前提是"用户选中了一段文字，前文是它的解读"；
+ * 这条路没有选中文字，只有**一张截图**（整窗 + 红框标出用户关心的那块）和一句问题。
+ * 所以：不要解读"这段文字"，不要复述翻译，直接看图回答；红框是"我指的东西"。
+ */
+/**
+ * 截图提问：取标题（第二次调用，紧跟在回答之后）。
+ *
+ * 为什么单独一次：把"起名字"塞进回答的格式里，模型经常不照做（实测）；
+ * 单独问一句它反而稳。而且这条请求的**前缀与回答那次逐字节相同**
+ * （同样的 system、同样的图、同样的提问），图那部分应当命中前缀缓存。
+ */
+export type ShotPromptScope = 'screen' | 'window' | 'margin' | 'selection';
+/** 按取景范围生成标题提示词（没有框时改用“这张图里的…”口径，不把注意力引到不存在的标记上）。 */
+export declare function shotTitlePromptFor(scope: ShotPromptScope, frame: boolean): string;
+export declare const SHOT_TITLE_PROMPT: string;
+/** 按取景范围生成回答用的 system prompt。 */
+export declare function shotPromptFor(scope: ShotPromptScope, frame: boolean): string;
+export declare const SHOT_PROMPT: string;
 export declare const CHAT_SYSTEM_PROMPT: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yfwu2020/dsh-selection-explain",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "DSH 划词解读：选中文字浮出按钮，点击弹窗流式显示专业中英翻译 + 该文字在当前上下文中的含义详解",
   "type": "module",
   "main": "./lib/index.js",
@@ -78,7 +78,9 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "inject": [],
+      "inject": [
+        "@deepseek-ai/dsh-client-shortcuts"
+      ],
       "platform": "web"
     }
   },