前言¶

用 DeepSeek Harness（DSH）跑长对话时，需求、约束和待办往往散落在多轮消息里；要对照某段说明继续改 prompt 或看模型输出，只能来回滚聊天记录，或把内容粘到外部记事本。DSH 客户端支持插件扩展界面行为。下面介绍维护者 kkomia 提供的客户端插件 dsh-session-note：在 Web UI 会话窗口上以浮层形式放一块可拖动、可缩放的便签，对话怎么滚它都停在原处，且按会话分别保存文本。

这是什么¶

dsh-session-note（DSH 会话便签）是面向 DSH Web 客户端的插件（package.json 中 dsh.client.platform 为 web）。它在会话界面旁增加一块便签卡片，用来在同一会话上下文中记录临时备忘，不替代 DSH 本身的配置或服务端存储。

分类上属于 客户端 类插件；当前包版本为 1.0.0，许可证 MIT。社区目录页见 skillhub 上的 dsh-session-note，源码与说明见 GitHub：kkomia/dsh-session-note。该目录为社区站点，与 DeepSeek / 幻方无官方从属关系。

核心功能¶

依据项目 README，能力可概括为以下几点。

• 钉住不滚：便签通过 shell.overlay 挂在窗口上，不随对话 transcript 滚动。
• 可拖动、可调整大小：拖标题栏移动；拖右下角改宽高。位置与尺寸会记住；窗口缩放时会收进可视区域，避免跑出屏幕。
• 跟随会话：每个会话一份便签，切换会话自动换内容；正文按会话持久化，刷新页面后仍在。
• 键盘微调：聚焦标题栏后可用方向键移动；按住 Shift 步长更大。调整大小时聚焦右下角后同样可用方向键微调。
• 主题适配：沿用 DSW 设计变量，亮/暗主题自动匹配。
• 与其它面板共存：打开设置、文件等面板时便签自动隐藏，回到会话再显示。
• 干净卸载：停用或移除插件时，卡片与注入样式一并移除；localStorage 里已存文本默认仍保留，重新启用后可恢复。

数据只写在浏览器 localStorage，不上传服务端。

安装与启用¶

安装前请确认本机已能正常使用 DSH CLI，且打算给 web profile 装客户端插件。官方 README 给出的步骤是：先取得包含 package.json 的插件目录，再执行 add（路径必须指向该目录，不能凭空用 github:owner/repo 拼命令）。

git clone https://github.com/kkomia/dsh-session-note.git
dsh plugin --profile web add ./dsh-session-note

若使用其它 profile（例如 desktop），将命令中的 web 换成对应 profile 名称即可。

装好后刷新 DSH Web 页面，打开任意会话，窗口一侧会出现便签卡片。插件在 package.json 中声明对 @deepseek-ai/dsh-client-ui-layout 与 @deepseek-ai/dsh-client-ui-session 的注入，并设置 immediately: true，随客户端加载生效。

典型用法¶

1. 拖动便签顶部标题栏，把卡片放到不挡对话的位置。
2. 拖动右下角调整大小；需要精细对齐时聚焦调整角，用方向键微调（Shift 加大步长）。
3. 在正文区输入或粘贴文本；修改会即时自动保存到当前会话。
4. 清空正文即删除该会话下的便签内容（逻辑上不再保留该会话文本）。
5. 在不同会话间切换时，便签内容自动切换为各会话各自保存的正文。

数据存放与卸载¶

浏览器 localStorage 使用如下键（README 原文）：

在 Plugins 页面停用或移除本插件即可完成卸载；已保存文本仍留在本机浏览器，重新启用插件后可再次读取。

适用场景与注意¶

适合需要在同一会话里对照模型输出、维护临时 checklist、粘贴 API 片段或约束说明的 DSH Web 用户。便签不跨设备同步，也不做版本管理；敏感信息请勿依赖仅存在 localStorage 的明文备忘。

DSH 插件以当前 DSH 进程权限运行，客户端插件会参与 Web UI 的加载与 DOM 行为。安装前建议通读 仓库源码 与 MIT 许可证，确认与本地安全策略一致。

结尾¶

dsh-session-note 用一小块始终贴在会话旁的浮层便签，把「对照聊天写备忘」留在 DSH 窗口内，并按会话自动保存。需要安装步骤与行为说明时，可查阅 社区目录页 与 GitHub README。