前言¶
在 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 中的日常使用流程操作：
- 點擊會話頂部右側「旁邊記」，打開右側面板；按需切換「工作區 / 會話」範圍。
- 在面板中寫一條具體事項，按設置中的添加快捷鍵或點擊「添加」。
- 需要繼續處理時，點擊該條便箋的轉發按鈕，內容進入對話輸入框；自行補充後發送。
- 完成後點左側圓圈打勾；在「已完成」區展開回看。
- 點擊面板外部或按 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 開始即可。
