前言¶
在使用 DSH Web GUI 进行开发或任务处理时，智能体可能会在专注于当前任务时产生“等等，那个其他东西可能……”的即时想法。如果这些想法与当前任务无关，直接打断可能会分散注意力；如果相关，智能体在后续处理中可能会遗忘。dsh-insight-dock 解决了这个问题，它允许智能体停放简短、严格受限的侧边观察，而不干扰当前工作流。
插件介绍¶
dsh-insight-dock 是一个 DSH Web GUI 客户端插件，由 POPCORNBOOM 维护。其核心价值在于为智能体提供一个“上下文锚点”，允许停放简短、严格受限的侧边观察。
安装与启用¶
插件通过 DSH 的插件系统安装。执行以下命令：
dsh plugin --profile <profile> add dsh-insight-dock
安装后，需要重启 dsh，插件才会出现在界面中。
核心功能与用法¶
安装并重启后，composer（输入框）上方会出现一个单行 dock，显示为 💡 3 条见解。点击可展开当前笔记，使用箭头切换到其他笔记。针对每个笔记，提供以下操作：
- 说来听听：让智能体从它锚定的日志窗口中讨论这条笔记。
- 关闭：移除这条笔记。
- 关闭并告诉 agent 为什么：移除笔记，并注入一条包含你理由的单行通知。
在 DSH 的设置页面中，找到“见解”部分，可以配置以下选项：
- 启用/禁用：控制插件是否运行。
- 提示强度：决定智能体何时以及如何生成见解。
- 并发打开上限：允许同时打开的笔记数量，范围 1-50。
- 生命周期：笔记在未被处理前的存活时间，单位为分钟，范围 1-1440，默认为 5 分钟。
技术细节与限制¶
上下文锚点¶
每条笔记都记住它创建时的会话序列。insight_load 函数可以从那个时刻的真实对话日志中读取内容。这是利用持久化的会话日志实现的，因此即使智能体自己的上下文被压缩掉，笔记依然有效。
数据与生命周期¶
- 无归档：笔记在结束时即被删除，没有归档记录。
- 重启清空：由于笔记仅存在于内存中，重启
dsh会清空 dock。 - 持久化设置：插件会持久化保存设置（文件位于
~/.dsh/insight-settings.json），但不会持久化笔记内容。
UI 与本地化¶
插件的用户界面文本为中文，包括 说来听听、关闭并告诉 agent 为什么 以及所有设置标签。插件不支持 locale 绑定。
总结¶
dsh-insight-dock 提供了一种在 DSH 中管理非任务相关想法的结构化方式，通过上下文锚点确保观察结果在智能体上下文丢失后依然可读。
