@klarkxy/dsh-session-manager 0.3.4 → 0.4.1

package/README.md

@@ -16,14 +16,16 @@ Replace `web` with your profile name and restart the profile.
 
 ## Use
 
+Open **Settings → Session Management** to change the Continue ghost, Auto-continue, and welcome-back options.
+
 - **Agent tools**: `list_sessions`, `search_sessions`, and `read_session` find sessions by title or content and read a conversation, its full details, or a handoff summary. Reading a conversation returns one preview per turn, newest first; page back with the returned cursor and open full content in details mode.
 - **Session context menu**: right-click a session row or use its **⋯** button to open its actions menu while staying in the current conversation; left-click the row to open that session. The menu appears on saved session rows in the sidebar.
 - **Edit and resend**: an icon below each message opens an editor at the original message, with images and files above the text box. Change text, remove attachments, paste images, or drop files; cancelling restores the original message. Before sending, the editor explains that the conversation continues from the edited message, the previous version moves to the archive, and file, command, and external changes already made remain in place. After confirmation, the reply is regenerated in a session that keeps the chat's title and sidebar position, while the earlier version stays recoverable from the archive list. This requires a host that can read and fork sessions and read attachments; it keeps original attachments in their original order while editing text, and relies on host attachment support for new or replaced files.
 - **Temporary workspace**: pick it in the new-session workspace picker to chat in its own new folder.
 - **Continue ghost**: after a turn ends and the composer is empty, a grey suggestion floats in the input area. Press `Tab` to fill it into the draft, or click it to send it at once. While a turn is running, the composer's own placeholder stays. **Fixed text** uses the configured text, or "Continue" when empty. **Model-generated** uses the model chosen in that same switch; it runs once after the previous turn ends and caches the line in the session. Mode, fixed text, and ghost model live under **Continue ghost** (keys: `continueMode`, `continueText`).
-- **Auto-continue**: on the new-session page, pick **Off**, **Cautious**, or **Bold** from the Auto-continue chip above the composer before sending the first message; the choice locks once the session starts. When a reply stops early, one judge pass on the ghost model (default: the conversation or host default model) decides whether the host sends a follow-up message, shown in the conversation as an "auto-continue" notice. The sent text follows the Continue ghost source: fixed text (or the "Continue" default) in **Fixed text** mode, the judge's suggested message in **Model-generated** mode. It continues at most `autoContinueMax` times (default 3) after each message you send, and stops on abort, error, a pending question or approval, no progress, or when the human is needed. The default mode and limit live under **Auto-continue** (keys: `autoContinueMode`, `autoContinueMax`).
+- **Auto-continue**: on the new-session page, pick **Off**, **Cautious**, or **Bold** from the Auto-continue chip above the composer before sending the first message; the choice locks once the session starts. When a reply stops early, one judge pass decides whether the host sends a follow-up message, shown in the conversation as an "auto-continue" notice. The sent text follows the Continue ghost source: fixed text (or the "Continue" default) in **Fixed text** mode, the judge's suggested message in **Model-generated** mode. It continues at most `autoContinueMax` times (default 3) after each message you send, and stops on abort, error, a pending question or approval, no progress, or when the human is needed. The default mode, limit, and judge model live under **Auto-continue** (keys: `autoContinueMode`, `autoContinueMax`).
 - **Welcome back**: returning to a session whose last response is older than `recapMinutes` (default 15) shows an inline card after the last turn, recapping what you were discussing, the progress, and a suggested next step. Past `compactMinutes` (default 60), the same card adds a prompt-cache expiry note and two optional buttons: **Compact context** invokes the host's native compaction; **Continue in a new session** creates a blank session in the source session's workspace (or keeps the original directory when the source is ungrouped) and fills its draft with the recap and source session ID for you to review and send. You can also send your next message directly; compaction and session switching happen only when you click their buttons, and the card disappears once you continue the conversation. Toggle each feature and set its idle threshold under **When you return**; after **Save** is confirmed, the current conversation is rechecked against the new thresholds. Idle time is measured from the last response.
-- **Welcome-back model**: the **Recap model** field under the **Show session recap** toggle in **When you return** applies to the welcome-back recap. The ghost model is chosen inside **Continue ghost** after switching to **Model-generated**. Leaving either on the default follows the current conversation or the host default model. The model menu supports provider groups and search; when the list fails to load, a message and retry button appear while keeping your unsaved settings.
+- **Feature models**: the welcome-back recap, the generated ghost, the auto-continue judge, and `read_session` handoff summaries each have their own model selector in **Session Management**. Leaving one on the default follows the shared **default auxiliary model** (a row on this same page), then the current conversation or host default model. A judge choice saved before the separate judge field existed keeps applying through migration. The model menu supports provider groups and search; when the list fails to load, a message and retry button appear while keeping your unsaved settings.
 
 ## Limits
 

package/README.zh-CN.md

@@ -16,14 +16,16 @@ dsh plugin --profile web add @klarkxy/dsh-session-manager
 
 ## 使用
 
+展开「设置 → 会话管理」可调整继续灰影、自动继续和欢迎回来的选项。
+
 - **智能体工具**：`list_sessions`、`search_sessions` 和 `read_session` 按标题或内容查找会话，并阅读对话、完整细节或交接摘要。阅读对话时按轮返回预览（最新在前），可用返回的游标向前翻页，并通过细节模式查看完整原文。
 - **会话右键菜单**：右键点击左侧会话行或它的「⋯」按钮，可在保持当前对话的同时打开该会话的操作菜单；左键点击仍直接打开对话。该菜单显示在侧栏已保存的会话行上。
 - **编辑并重发**：消息下方的图标会在原消息位置展开编辑框，图片和文件放在文本框上方。可修改文字、删除附件、粘贴图片或拖入文件，取消会恢复原消息。发送前会明确提示：对话将从这条消息继续，之前的版本会移入归档，已执行的文件、命令和外部修改保持现状。确认后新会话沿用原聊天的标题和位置并重新生成回复，之前的版本可在归档列表中找回。这需要宿主提供会话读取、会话分叉和附件读取能力；当前版本支持保留原附件及其排列顺序并编辑文字，新增或替换附件依赖宿主提供对应能力。
 - **临时工作区**：在新会话的工作区选择器中选择它，即可在一个新的独立目录中开始对话。
 - **继续灰影**：上一轮结束后，输入框为空时会浮现灰色建议文本。按 `Tab` 填入草稿，点击则直接发送。一轮仍在运行时保持输入框原有的占位提示。切到「固定文本」使用配置的文本，留空则用「继续」；切到「模型生成」使用所选模型，模型在上一轮结束后生成一次并缓存在会话中。模式、固定文本和灰影模型都在「继续灰影」分组中调整（配置键：`continueMode`、`continueText`）。
-- **自动继续**：在创建会话页，发送第一条消息前，在输入框上方的「自动继续」按钮中选择「关闭」「谨慎」或「奔放」；选择在会话开始后锁定。回复提前结束时，由灰影模型（默认跟随当前会话或宿主默认模型）判断是否自动发送一条继续消息，在对话中显示为「auto-continue」通知。发送文本沿用「继续灰影」的内容来源：「固定文本」使用配置文本（留空为「继续」），「模型生成」使用判断模型给出的消息。你每发一条消息之后最多自动继续 `autoContinueMax` 次（默认 3），遇到中止、出错、待回答问题或审批、无进展或需要人工时会停止。默认形态与次数上限在「自动继续」分组中调整（配置键：`autoContinueMode`、`autoContinueMax`）。
+- **自动继续**：在创建会话页，发送第一条消息前，在输入框上方的「自动继续」按钮中选择「关闭」「谨慎」或「奔放」；选择在会话开始后锁定。回复提前结束时，由判定模型判断是否自动发送一条继续消息，在对话中显示为「auto-continue」通知。发送文本沿用「继续灰影」的内容来源：「固定文本」使用配置文本（留空为「继续」），「模型生成」使用判定模型给出的消息。你每发一条消息之后最多自动继续 `autoContinueMax` 次（默认 3），遇到中止、出错、待回答问题或审批、无进展或需要人工时会停止。默认形态、次数上限与判定模型都在「自动继续」分组中调整（配置键：`autoContinueMode`、`autoContinueMax`）。
 - **欢迎回来**：回到距上次响应超过 `recapMinutes` 分钟（默认 15）的会话时，在最后一轮回复之后内嵌显示模型生成的摘要卡片，说明之前在聊什么、进展和建议的下一步。超过 `compactMinutes` 分钟（默认 60）时，同一卡片还会提示缓存可能已过期，并提供「压缩上下文」和「在新会话中继续」两个可选按钮：前者调用宿主原生压缩命令，后者在来源会话所属工作区内新建空白会话（来源未归属工作区时沿用原目录），把摘要和原会话 ID 填入草稿供确认后发送。你也可以直接发送下一条消息；仅在点击对应按钮时才执行压缩或切换会话，继续对话后卡片自动收起。两项开关和各自的空闲阈值在「回到会话时」分组中调整，点击「保存」并确认成功后，当前会话按新阈值重新检查。空闲时间从上次响应起算。
-- **欢迎回来模型**：在「回到会话时」的「显示会话摘要」开关下，「摘要模型」专用于欢迎回来摘要。灰影的模型在「继续灰影」切到「模型生成」后单独选择。两者留空都跟随当前会话或宿主默认模型。模型菜单支持按供应商分组和搜索；列表加载失败时显示原因与重试按钮，同时保留未保存的设置。
+- **各功能模型**：欢迎回来摘要、灰影生成、自动继续判定和 `read_session` 交接摘要各有独立的模型选择，都在「会话管理」页中调整。留空时使用共享的「默认辅助模型」（同在本页的全局行），再跟随当前会话或宿主默认模型。在独立的判定模型字段出现之前保存过的灰影模型选择会通过迁移继续生效。模型菜单支持按供应商分组和搜索；列表加载失败时显示原因与重试按钮，同时保留未保存的设置。
 
 ## 限制