dsh-aside-note

dsh plugin --profile web add dsh-aside-note

旁边记 · AsideNote

让想法留在对话旁边

[English](README.en.md) | 中文

中文名 旁边记，英文名 AsideNote；包、插件 id 与仓库均为 dsh-aside-note。

轻量记录 · 按需打开 · 用完收起

旁边记是面向 DeepSeek Harness（DSH）的轻量会话便笺。临时的想法、稍后的待办，随手留在对话旁；需要时一键带回，用完收起，继续眼前的事。

界面与入口

暗色主题下外观保持一致，颜色全部取自 DSH 主题令牌：

会话顶部右侧的「旁边记」按钮，带未完成数量：

<img src="./docs/assets/preview-badge.png" width="460" alt="顶部右侧旁边记按钮">

暗色主题下的同一按钮：

<img src="./docs/assets/preview-badge-dark.png" width="460" alt="顶部右侧旁边记按钮（暗色）">

点击入口后在右侧打开固定面板。

快速安装

旁边记以 npm 包 dsh-aside-note 装进 DSH profile。两种方式选一个：把提示词交给 agent，或自己执行一条命令。

通过 agent 安装

把下面这段发给你的 agent：

帮我安装 DSH 插件 AsideNote（旁边记），在终端执行：npx -y dsh-aside-note install
装好后不用重启 DSH，会话右上角即可看到「旁边记」入口；如果没出现，
让我到「插件」页刷新，再把它手动关闭并开启一次。
如果提示找不到 DSH 或找不到 profile，转告我先安装并启动 DeepSeek Harness 再重试；
不要改仓库、不要手动拼装依赖、不要重启 DSH。

通过命令行安装

npx 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（找不到运行时才回退到 PATH 上的 pnpm，可用 DSH_RUNTIME_DIR 指定），最后校验装出来的 client/client.js。用宿主自己的工具链是为了让 profile 的 pnpm store 与宿主保持一致——换成另一个主版本的 pnpm 写入，宿主下次安装会报 ERR_PNPM_UNEXPECTED_STORE。

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 秒内重新组合，安装后会话右上角即可看到「旁边记」入口。如果入口没有出现，到侧边栏「插件」页刷新，把它关闭再开启一次，运行中的 Host 会重新组合，入口随即可见。

卸载：从 dsh.profile.bundles 移除 dsh-aside-note，在 profile 目录执行 pnpm remove dsh-aside-note，无需重启；右上角入口随之消失，若「插件」页里仍列着它，刷新该页即可。

为什么做旁边记

和 AI 一起做事时，总会冒出一些暂时顾不上的小事：这个细节等会儿改，那段结果还要核对，还有一个思路想留着继续讨论。

先发进对话，容易打断当前任务；记到别处，回来又得重新找。旁边记就在会话旁边，让你先把事情记下，继续手头的工作。

不必为几件小事建立一套管理方法。想到就记，需要就看，做完就放下。它只在你需要时打开，用完收起，尽量少打扰当前的工作。

从随手记，到继续做

想到就记，继续手头的事

点击会话顶部右侧的「旁边记」按钮，打开右侧面板，记录待办、补充想法或需要回看的细节。入口显示未完成数量，做完一条，勾掉一条。

留在工作区，下次接着做

同一个工作区默认共享一份清单。无论从哪个会话打开，看到的都是同一批事项；面板顶部还能在「工作区」与「会话」之间切换，工作区级汇总整个工作区，会话级只看当前会话。工作区之外的会话没有工作区级，始终按会话保存。第一次打开时，成员会话里已经记下的便笺会自动并入工作区清单，不会丢。

准备好了，一键带回对话

点击便笺上的转发按钮，内容就会以列表项追加到当前对话输入框。你可以继续补充、调整，再决定发送。前缀提示词支持自定义，且仅在输入框为空时添加；转发不会自动发送，也不会把便笺标记为完成。

日常使用的小细节，也准备好了

• 草稿自动保存：临时关闭面板，再打开接着写。
• 完成后可回看：未完成与已完成分区展示，保留创建与完成时间。
• 面板大小可调整：宽高按需拖动，记住你的习惯。
• 融入 DSH 界面：跟随明暗主题与中英文设置。
• 当前浏览器持久保存：刷新页面、重启 DSH 后仍可继续查看；同一浏览器的多个标签页同步更新。

便笺保存在当前浏览器，不跨设备或浏览器同步；清理站点数据会清除记录。详见[数据保存在哪里](#数据保存在哪里)。

[查看安装方法](#快速安装) · 反馈问题或建议

功能

• 工作区级便笺：同一个工作区默认共享一份清单，切换会话也能接着看；面板顶部可在「工作区 / 会话」之间切换，工作区之外的会话只有会话级。同一浏览器的多个标签页同步更新。
• 入口与面板：会话顶部右侧的图标按钮用角标显示未完成数；点击打开固定面板并与之对齐，DSH 右侧栏打开时自动左移，切换会话时收起。
• 条目操作：添加、打勾完成、复制、双击或铅笔编辑、删除；「清除已完成」需要二次确认，已完成的条目可展开回看。
• 一键转发：把便笺按 - 内容 追加到当前打开的会话输入框，仅当输入框为空时写入可自定义的前缀，不自动发送；转发后按钮显示勾选，按清单记住，再点一次取消。
• 状态记忆：新增与编辑的草稿按会话自动保存，关掉面板再打开会恢复；「未完成 / 已完成」的展开折叠状态与「工作区 / 会话」范围选择也会记住。
• 面板尺寸：拖左边缘调宽度、拖底部把手调高度，双击复位；宽高都保存在浏览器里。
• 列表分区：「未完成」「已完成」各有吸顶标题与独立滚动，展开已完成不会压缩未完成；已完成显示创建与完成时间，并按完成时间倒序。
• 设置：发送快捷键（Enter 或 ⌘/Ctrl+Enter）、转发前缀、关于（版本、检查更新、作者、源码），改动自动保存。
• 更新提示：有新版本时设置按钮出现提示点，设置 › 关于 可查看更新说明并更新；详见[更新提示](#更新提示)。
• 界面融入：颜色、圆角、阴影与滚动条全部复用 DSH 设计令牌，自动适配明暗主题与中英文；详见[设计规范](#设计规范)。

功能截图

五个主要状态的实拍，明暗同源（同一会话、同一批便笺，只切换主题）：

<table>

<tr>

<th width="130">功能</th>

<th>明色</th>

<th>暗色</th>

</tr>

<tr>

<td>面板总览<br>未完成 / 已完成分区</td>

<td><img src="./docs/assets/features/panel.png" width="300" alt="面板总览"></td>

<td><img src="./docs/assets/features/panel-dark.png" width="300" alt="面板总览（暗色）"></td>

</tr>

<tr>

<td>设置<br>发送快捷键、一键转发前缀、关于</td>

<td><img src="./docs/assets/features/settings.png" width="300" alt="设置"></td>

<td><img src="./docs/assets/features/settings-dark.png" width="300" alt="设置（暗色）"></td>

</tr>

<tr>

<td>行操作<br>悬浮显示复制 / 转发 / 编辑 / 删除</td>

<td><img src="./docs/assets/features/actions.png" width="300" alt="行操作"></td>

<td><img src="./docs/assets/features/actions-dark.png" width="300" alt="行操作（暗色）"></td>

</tr>

<tr>

<td>清除已完成<br>二次确认，避免误删</td>

<td><img src="./docs/assets/features/clear.png" width="300" alt="清除已完成确认"></td>

<td><img src="./docs/assets/features/clear-dark.png" width="300" alt="清除已完成确认（暗色）"></td>

</tr>

<tr>

<td>空状态<br>还没有记录时的引导</td>

<td><img src="./docs/assets/features/empty.png" width="300" alt="空状态"></td>

<td><img src="./docs/assets/features/empty-dark.png" width="300" alt="空状态（暗色）"></td>

</tr>

</table>

设计规范

面板与入口按钮的样式由 src/client/styles/panel.css 的令牌块统一驱动，改一处即可全站生效：

维度 · 令牌 · 取值

颜色 · --dsw-alias-* · 直接复用 DSH 语义别名（墨色 / 悬停 / 描边 / 状态 / 设置卡），插件不再自建灰阶

字号 · --an-fs-caption/row/title · 12 / 13 / 14，行高统一 20

字重 · 400 / 500 · 上限 500，强调靠字号与墨色

间距 · --an-space-1 … -6 · 4 / 8 / 12 / 16 / 24 / 32

圆角 · --dsw-radius-sm/md/lg/panel + 999 · 8（紧凑控件）/ 16（分组与字段）/ 28（浮动面板）/ 胶囊配 corner-shape:round

阴影 · --dsw-elevation-panel · 浮层 border:0，0.5px 发丝描边画在阴影第一层

材质 · --dsh-an-panelSurface（--dsw-alias-bg-layer-2） · 实心面板表面，与吸顶块共用同一颜色

动效 · --ds-transition-duration*、--ds-ease-in-out · 100 / 200ms，只动 opacity 与 transform

滚动条 · 主题共享 skin · 面板内只重绑 --dsh-scrollbar-* 到 l2，并为列表设置 9px 轨道 / 2px 内缩

反馈层同样复用产品能力：复制、转发、删除、清除完成与写失败都经 shell.overlay 的全局 Toast 报告，面板关闭后仍然可见；图标按钮用 ui-primitives 的 Tooltip。

使用

1. 点击会话顶部右侧的「旁边记」按钮，打开右侧面板；有未完成条目时，按钮角标显示数量。面板顶部的「工作区 / 会话」用来切换整个工作区与当前会话的清单。

2. 在面板里写一条具体的小事，按设置中的添加快捷键或点击「添加」。

3. 需要继续处理时，点击该条便笺的转发按钮，将内容追加到对话输入框，确认后自行发送。

4. 做完后点左侧圆圈打勾；点「已完成」展开回看。

5. 点面板外部或按 Esc 关闭。

数据保存在哪里

会话便笺保存在当前浏览器的 localStorage 中，键为 dsh.aside-note，保持原来的 v1 结构：

{
  "version": 1,
  "sessions": {
    "session-…": {
      "sessionId": "session-…",
      "updatedAt": 0,
      "items": []
    }
  }
}

同一个工作区共享的清单单独保存在 `dsh

…(truncated)