旁边记 Rayle8/dsh-aside-note

旁边记 · AsideNote

让想法留在对话旁边

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

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

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

界面与入口

旁边记右侧面板

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

旁边记右侧面板（暗色）

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

暗色主题下的同一按钮：

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

快速安装

旁边记以 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 设计令牌，自动适配明暗主题与中英文；详见设计规范。

功能截图

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

功能明色暗色

面板总览未完成 / 已完成分区

设置发送快捷键、一键转发前缀、关于

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

清除已完成二次确认，避免误删

空状态还没有记录时的引导

设计规范

面板与入口按钮的样式由 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,json { "version": 1,
"sessions": {
"session-…": {
"sessionId": "session-…", "updatedAt": 0,
"items": []
}
}
}

同一个工作区共享的清单单独保存在 dsh.aside-note.workspaces： json { "version": 1,
"workspaces": {
"workspace-…": {
"workspaceId": "workspace-…", "updatedAt": 0,
"items": [],
"seededSessionIds": ["session-…"]
}
}
}

workspaces 是同一个工作区共享的清单；seededSessionIds 记住哪些会话的旧便笺已经并进来，避免重复合并，也避免删除后又复活。会话数据仍留在原来的 dsh.aside-note 键里，工作区数据不会写回这个键；没有工作区的会话只使用自己的 sessions 记录。面板顶部的范围选择单独保存在 dsh.aside-note.scope-mode（workspace 或 session，默认 workspace）。

因此：

- 刷新页面、重启 DSH、切换会话都不会丢。
- 不会写入项目文件，也不会同步到其他机器或其他浏览器。
- 清理浏览器站点数据会清除便笺。
- 读取旧数据时不会改写 dsh.aside-note 的结构；工作区清单从 dsh.aside-note.workspaces 读取，首次进入工作区时把成员会话的旧便笺合入一次。不会读取 dsh.aside-notes. 这类更早的键。如果本地数据仍在旧的 dsh.aside-notes..v2 键下，把键名改为对应的 dsh.aside-note. 后刷新页面即可继续使用。

更新提示

打开面板时，插件会静默检查一次 npm 上的最新版本（npmjs 不可用时回退到 npmmirror，再回退到 GitHub 的最新 Release）；结果缓存一小时。若最新版本更高，设置按钮右上角出现提示点，设置 › 关于 中出现更新卡片：

- 检查更新：立即重新读取 registry，绕过这一小时的缓存；按钮下方会显示「正在检查」「已是最新」或失败状态。
- 更新内容默认展示：有新版时直接在卡片里列出 GitHub Release 的更新说明，不需要再点开。说明由 Release 正文中 app-update-notes:zh / app-update-notes:en 标记之间的内容提供，统一压成纯文本渲染，不会执行或注入任何 HTML。
- 跨多个版本：如果线上版本领先本地好几个版本，说明区会按版本从新到旧逐条列出这段区间内的 Release；最新版本默认展开，更早的版本各自折叠、点标题单独展开。草稿与预发布不参与，最多列出 6 个版本，更多时给出「更早的版本请见完整更新说明」链接。
- 完整更新说明：链接位于「立即更新」右侧，点击在新标签页打开对应的 GitHub Release 页面。
- 立即更新：检测到插件市场（dshmarket）时，通过它的公开更新 API 排队升级 dsh-aside-note，显示实时进度；完成后提供「刷新页面」或「重启 DSH」。市场正被别的操作占用时会先等待重试。
- 更新方式兜底：市场不在、或等待后仍在忙时，卡片不再只说「请稍后再试」，而是直接给出命令 npx -y dsh-aside-note install（或到「插件」页更新），并提供「拷贝更新提示词」——一键复制可直接粘给智能体的更新指令。

更新始终需要手动点击：面板只负责检查、说明和排队，自己不执行任何命令，也从不改动本地便笺。版本检查与说明读取只访问公开的版本号与 Release 正文，不上报任何数据。

发布说明由 tools/release/notes.mjs 从 CHANGELOG.md 生成：中英文两段，各自带 app-update-notes 标记，外加安装链接与 Full Changelog 链接；打 tag 时发布流程会用它创建 Release 并附上 tgz。详见 发布与版本迭代。

开发

浏览器半侧在 src/client/，由 tsdown 打包成单个 client/client.js： bash
npm install
npm run check # lint + typecheck + 测试 + 构建
npm run build # 只重新生成 client/client.js

本地调试时把仓库 link 进 DSH 配置档（<path-to-repo> 换成克隆目录），再在配置档目录执行 pnpm install： json {
"dependencies": {
"dsh-aside-note": "link:<path-to-repo>"
},
"dsh": {
"profile": {
"bundles": ["dsh-aside-note"]
}
}
}

新增插件行后，在侧边栏「插件」页把该组合包关闭再开启，运行中的 Host 会在线重新组合，无需重启。

入口是 src/client/index.ts，导出 apply(ctx)；tsdown 负责套上 DSH 的加载壳： js
window.__ModuleLoader__.load({ id: 'dsh-aside-note', factory: (require) => { … } })

产物单独提交：CI 会重建并对比 client/，不一致就失败，因此不要手改 client/client.js。

index.js 是空的 Host 半侧；cordis.patch.yml 负责把包插入配置档的组合。界面依赖 slots 与 locale 两个服务：

- conversation.composer.dock：只用来捕获当前会话 ID，不渲染可见入口。
- 顶部右侧入口由 MutationObserver 注入宿主 header，因为宿主重渲染会回收 React portal。

面板用 react-dom/client 的独立 root 挂到 document.body，用 fixed 定位跟随入口；所有样式使用 DSH 的 --dsw-alias-* 主题变量，自动适配明暗主题。

修改源码后先 npm run build；开发模式下 DSH 会热替换新 bundle，否则刷新页面或重启 DSH。
截图与预览图的产出流程见 截图与预览图 SOP：在隔离配置档里造演示会话，一条命令重拍明暗两套；凭据默认不复制。

代码结构、数据模型与构建约定见 架构文档。

分支模型、版本策略与发版步骤见 发布与版本迭代。

验证

已在独立的 DSH 配置档中实际加载，并用无头 Chrome 走通：

- 会话顶部右侧出现「旁边记」按钮，角标显示未完成数；
- 点击按钮在右侧打开面板，面板右上角对齐入口；
- 添加后按钮角标与面板计数同步；
- 面板内可完成、编辑、复制、转发、删除、清除已完成；
- 刷新页面后记录仍在；面板头部可在工作区级与当前会话级清单之间切换；
- 版本检查的 npmjs → npmmirror → GitHub Release 回退、1 小时缓存与版本比较由契约测试覆盖；发布说明的标记提取、中英文回退、上限与 Markdown 压平有独立测试；jsdom 集成测试会驱动面板显示更新卡片、展开说明并通过模拟市场完成一次更新。真实更新提示需先发布到 npm 或创建 GitHub Release。

npm run check 通过：lint、类型检查、构建与 95 个测试（含 jsdom 里驱动完整面板流程的集成测试）。