AsideNote: Jot down notes alongside the DSH session

前言

在 DeepSeek Harness(DSH)里和智能体协作时,常会冒出暂时顾不上处理的小事:某段输出待核对、一个细节稍后再改、一条思路想留着继续讨论。把这些内容直接发进对话容易打断当前任务;记到外部工具里,回来又要重新找上下文。

旁边记(AsideNote)是社区维护者 Rayle8 发布的 DSH 插件,npm 包名与插件 id 均为 dsh-aside-note,在 SkillHub 社区目录中归类为「记忆」。它在会话顶部提供入口,在右侧打开固定面板,让你先把事项留在对话旁边,继续手头工作;需要时再一键把内容带回输入框。下面介绍它的定位、能力与安装用法。

这是什么

旁边记面向 DSH Web GUI,提供轻量会话便笺:按需打开、用完收起,不替你做项目管理,只解决「临时想法先搁旁边」这一件事。

维护者 Rayle8,源码与问题反馈在 GitHub 仓库,许可证 MIT(以仓库为准)。社区目录页:SkillHub · dsh-aside-note。

核心功能

以下能力均来自项目 README 与 package.json 中的说明。

入口与面板

会话顶部右侧有「旁边记」按钮;存在未完成条目时,角标显示数量。点击后在右侧打开固定面板;DSH 右侧栏打开时面板会自动左移,切换会话时面板会收起。

工作区与会话两级清单

同一工作区默认共享一份便笺清单,切换会话仍可看到同一批事项。面板顶部可在「工作区 / 会话」之间切换:工作区级汇总整个工作区,会话级只看当前会话。工作区之外的会话没有工作区级,始终按会话保存。首次打开时,成员会话里已有便笺会自动并入工作区清单。

同一浏览器多个标签页会同步更新。

条目与列表

支持添加、打勾完成、复制、双击或铅笔图标编辑、删除。「未完成」「已完成」分区展示,各有吸顶标题与独立滚动;已完成条目显示创建与完成时间,按完成时间倒序。「清除已完成」需二次确认。

一键转发到对话

点击便笺上的转发按钮,内容会以 - 内容 形式追加到当前打开的会话输入框。转发不会自动发送,也不会把便笺标记为完成。转发前缀可在设置中自定义,且仅在输入框为空时添加。

状态与界面

新增、编辑的草稿按会话自动保存;面板关闭再打开可恢复。未完成/已完成的展开折叠、工作区/会话范围选择、面板宽高(拖左缘与底部把手,双击复位)均保存在当前浏览器。颜色、圆角、阴影与滚动条复用 DSH 设计令牌,跟随明暗主题与中英文设置。

设置与更新

设置项包括:添加快捷键(Enter 或 ⌘/Ctrl+Enter)、转发前缀、关于(版本、检查更新、作者、源码)。有新版本时设置按钮会出现提示点;更新流程依赖手动确认,面板只负责检查与说明,不自动执行安装命令。

安装与启用

旁边记以 npm 包 dsh-aside-note 装进 DSH profile,不要凭仓库名自行拼装 dsh plugin add github:… 一类命令。官方推荐在终端执行:

npx dsh-aside-note install

也可让 agent 执行(README 建议加 -y 以避免交互):

npx -y dsh-aside-note install

安装脚本会从 npm 拉取包,定位 DSH profile(环境变量 DSH_PROFILE_DIR 存在时使用它,否则默认 ~/.dsh/profiles/desktop),备份 package.json 与 pnpm-lock.yaml 到 .local-backup/,写入依赖并把 dsh-aside-note 追加进 dsh.profile.bundles,再用 DeepSeek Harness 自带的 node 与 pnpm 执行 pnpm install(可用 DSH_RUNTIME_DIR 指定运行时;找不到时才回退 PATH 上的 pnpm),最后校验 client/client.js。

常用变体:

npx dsh-aside-note install --profile work    # 指定 profile
npx dsh-aside-note install --dry-run         # 只打印计划,不改文件
npx dsh-aside-note install --version 1.0.0   # 固定版本,而不是 ^1.0.0

重复执行安装是幂等的。装完不需要重启 DSH:profile 会在约 1 秒内重新组合,会话右上角应出现「旁边记」入口。若未出现,到侧边栏「插件」页刷新,关闭再开启该插件一次。

卸载:从 dsh.profile.bundles 移除 dsh-aside-note,在 profile 目录执行 pnpm remove dsh-aside-note,无需重启。

典型用法

经过上面的安装步骤后,可按 README 中的日常使用流程操作:

  1. 点击会话顶部右侧「旁边记」,打开右侧面板;按需切换「工作区 / 会话」范围。
  2. 在面板中写一条具体事项,按设置中的添加快捷键或点击「添加」。
  3. 需要继续处理时,点击该条便笺的转发按钮,内容进入对话输入框;自行补充后发送。
  4. 完成后点左侧圆圈打勾;在「已完成」区展开回看。
  5. 点击面板外部或按 Esc 关闭面板。

数据保存在哪里

便笺保存在当前浏览器的 localStorage,不会写入项目文件,也不跨设备或浏览器同步。主要键名:

  • 会话数据:dsh.aside-note
  • 工作区共享清单:dsh.aside-note.workspaces
  • 范围选择(workspace 或 session):dsh.aside-note.scope-mode

刷新页面、重启 DSH、切换会话一般不会丢数据;清理浏览器站点数据会清除便笺。安装或使用前若关心隐私与合规,应自行阅读源码与 MIT 许可证。

适用场景与注意

适合谁:经常在 DSH 长会话里协作、需要临时挂起待办或备忘、又不想打断当前 prompt 链路的开发者。

权限与信任:插件随 DSH profile 加载,在 Web 客户端注入 UI 与本地存储逻辑;安装前应查看 GitHub 源码 与许可证,确认符合你的环境要求。DeepSeek Harness 社区插件目录(SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系。

环境:package.json 声明 Node 引擎为 ^22.18.0 || >=24.11.0;需已安装并启动 DSH,否则安装脚本可能提示找不到 DSH 或 profile。

结尾

旁边记把「先记下、继续做、需要时再带回对话」收进 DSH 界面一侧,用工作区/会话两级清单和转发输入框衔接协作流。若要在本机试用,从 npx dsh-aside-note install 开始即可。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye