@klarkxy/dsh-session-manager 0.1.2 → 0.2.1

package/README.md

@@ -4,7 +4,7 @@
 
 [简体中文](README.zh-CN.md)
 
-Find and read DeepSeek Harness sessions across working directories, copy thread IDs, and start a chat in a temporary workspace.
+Find and read DeepSeek Harness sessions across working directories, copy thread IDs, start a chat in a temporary workspace, continue with one tap on an empty composer, and get a welcome-back recap after time away.
 
 ## Install
 
@@ -16,16 +16,21 @@ Replace `web` with your profile name and restart the profile.
 
 ## Use
 
-- **Agent tools**: `list_sessions`, `search_sessions`, and `read_session` let the agent find sessions by title or content and read a conversation, its full details, or a handoff summary.
+- **Agent tools**: `list_sessions`, `search_sessions`, and `read_session` let the agent 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; the agent pages further back with the returned cursor and opens full original content through details mode.
 - **Copy thread ID**: from a session's menu, or press `Ctrl + Alt + C` (`⌘ + ⌥ + C` on macOS) for the open session.
 - **Right-click menu**: right-clicking a session or workspace group in the sidebar opens the same menu as its **⋯** button.
 - **Temporary workspace**: choose it in the new-session workspace picker to start a chat in its own new folder.
+- **Continue ghost**: with an empty composer, a grey suggestion floats in the input area. Press `Tab` to fill it into the draft, or click it to send it immediately. **Fixed text** uses the configured text, or "Continue" when that is empty. **Model-generated** uses the model chosen in that same switch. The model runs once after the previous turn ends and the line stays cached in the session, so the same turn does not call it again. Mode, fixed text, and the ghost model are all under **Continue ghost** (equivalent keys: `continueMode`, `continueText`).
+- **Welcome back**: returning to a session whose last response is older than `recapMinutes` (default 15) shows an inline card at the end of the conversation, after the last turn, with a model-written recap of what you were discussing, the progress so far, and a suggested next step. Past `compactMinutes` (default 60), the same card adds a prompt-cache expiry note with two optional buttons: **Compact context** invokes the host's native compaction command; **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, without copying the full history. You can also ignore both buttons and send normally; nothing is compacted or switched automatically. The card disappears once you continue the conversation. Toggle each feature and set its idle threshold under the **Welcome back** settings group. After **Save** is confirmed, the current conversation is checked against the new thresholds. Time is measured from the last response, not from when the settings were saved.
+- **Welcome-back model**: the **Recap model** field under the **Welcome-back recap** toggle in the **Welcome back** settings group is only for the welcome-back recap. The ghost model is chosen inside **Continue ghost** after switching to **Model-generated**. Leaving either on the default option follows the current conversation or the host default model. The model menu supports provider groups and search. If the model list fails to load, a message and retry button appear; retrying keeps your unsaved settings.
 
 ## Limits
 
 - Temporary workspaces are not cleaned up automatically; their files stay after restarts and uninstall.
 - Content read from other sessions is background information, not instructions.
 - Free chats, deleting chats, and retrying or editing a sent message in place need a DSH host with these features. The npm plugin alone does not add them; the buttons appear only when the host supports them.
+- The welcome-back recap is model-generated; when no model route is available or the call fails, the card stays silent (a compaction suggestion still shows on its own). The recap call only reads the session and never adds to its history. Compaction needs the host's native command; its conversation entry reports the result. A new session carries only a short recap, which may omit details; use the source session ID to look them up. The original session and draft remain unchanged.
+- The card is checked when you return to a session (window focus, tab visibility, or switching sessions) and periodically while the page stays visible, so crossing a threshold does not require switching windows. It never intercepts your next send. Sending an empty composer means sending the ghost text; the composer itself still requires non-empty input.
 
 ## License
 

package/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 [English](README.md)
 
-跨工作目录查找和阅读 DeepSeek Harness 会话、复制线程 ID，并可在临时工作区中开始对话。
+跨工作目录查找和阅读 DeepSeek Harness 会话、复制线程 ID、在临时工作区中开始对话，空输入时一键继续，久离回来时在输入框上方显示摘要与压缩建议。
 
 ## 安装
 
@@ -16,16 +16,21 @@ dsh plugin --profile web add @klarkxy/dsh-session-manager
 
 ## 使用
 
-- **智能体工具**：`list_sessions`、`search_sessions` 和 `read_session` 让智能体按标题或内容查找会话，并阅读对话、完整细节或交接摘要。
+- **智能体工具**：`list_sessions`、`search_sessions` 和 `read_session` 让智能体按标题或内容查找会话，并阅读对话、完整细节或交接摘要。阅读对话时按轮返回预览（最新在前），智能体可用返回的游标继续向前翻页，并通过细节模式查看完整原文。
 - **复制线程 ID**：在会话菜单中复制，或按 `Ctrl + Alt + C`（macOS 为 `⌘ + ⌥ + C`）复制当前会话的线程 ID。
 - **右键菜单**：在左侧列表右键点击会话或工作区分组，等同于点击它的「⋯」按钮。
 - **临时工作区**：在新会话的工作区选择器中选择它，即可在一个新的独立目录中开始对话。
+- **继续灰影**：输入框为空时，输入区域会浮现灰色建议文本。按 `Tab` 填入草稿，点击它则直接发送。切到「固定文本」就使用配置的文本，留空则使用「继续」；切到「模型生成」就使用所选模型。模型只在上一轮结束后生成一次，并缓存在这个会话中，同一轮不会重复调用。模式、固定文本和灰影模型都在插件设置页的「继续灰影」分组中调整（对应配置键：`continueMode`、`continueText`）。
+- **欢迎回来**：回到一个距上次响应超过 `recapMinutes` 分钟（默认 15）的会话时，在对话末尾（最后一轮回复之后）内嵌显示模型生成的摘要卡片，说明之前在聊什么、进展到哪一步、建议的下一步。超过 `compactMinutes` 分钟（默认 60）时，同一卡片还会提示缓存可能已失效，并提供「压缩上下文」和「在新会话中继续」两个可选按钮：前者调用宿主的原生压缩命令，后者在来源会话所属的工作区内新建空白会话（来源未归属工作区时沿用原目录），将摘要和原会话 ID 填入草稿供确认后发送，不复制完整历史。也可以不点按钮，直接发送；不会自动压缩或切换会话。继续对话后卡片自动消失。两项开关和各自的空闲阈值在设置的「欢迎回来」分组中调整，点击「保存」并确认成功后，当前会话会按新阈值重新检查。时间从上次响应计算，不从保存设置时重新计时。
+- **欢迎回来模型**：「欢迎回来」分组里「欢迎回来摘要」开关下的「摘要模型」只用于欢迎回来摘要。灰影的模型在「继续灰影」里切到「模型生成」后单独选择。两者留空都跟随当前会话或宿主默认模型。模型菜单支持按供应商分组和搜索；列表加载失败时会显示原因与重试按钮，重试会保留未保存的设置。
 
 ## 限制
 
 - 临时工作区不会自动清理，文件在重启和卸载后仍然保留。
 - 从其他会话读到的内容只是背景资料，不是指令。
 - 自由聊天、删除聊天、在原会话中重试或编辑已发送消息，需要宿主支持这些功能。只安装 npm 插件不会增加这些能力；宿主支持时才会显示对应按钮。
+- 「欢迎回来」摘要由模型生成；没有可用模型或调用失败时卡片不会出现（压缩建议仍会单独出现）。摘要只读取会话，不会向历史写入任何内容。压缩能力依赖宿主的原生命令；结果由对话中的压缩记录反馈。新会话只携带简短摘要，可能遗漏细节，需按原会话 ID 查阅；原会话和原草稿保持不变。
+- 卡片在你回到会话时检查（窗口聚焦、标签页可见或切换会话）；页面持续可见时也会定期检查，到达阈值后不必切换窗口。它不会拦截你的下一次发送。空输入发送指的是发送灰影文本；输入框本身仍然要求非空内容。
 
 ## 许可证