前言¶
在 DeepSeek Harness（DSH）裏和模型長聊，結論往往散在對話歷史裏：待辦、分工、表格草稿很難單獨整理成可編輯、可搜索的文檔。外接雲筆記又和對話脫節，還要擔心數據出本機。社區插件 隨記 Jot（dsh-jot）把筆記面板嵌在對話右側，支持清單、表格、附件與導入導出；可選開啓 AI 協作，讓模型在你說清楚需求後再讀、寫筆記，改過的位置可標記並撤回。下面介紹它是什麼、能做什麼，以及如何安裝與典型用法。
這是什麼¶
隨記 Jot 是維護者 Totoro-qaq 發佈的 DSH 插件，npm 包名 dsh-jot，當前版本 0.2.14（MIT 許可證）。SkillHub 分類爲「記憶」；GitHub 倉庫 totoro-qaq/dsh-jot 簡介爲：Human-editable notes, todos and documents for DeepSeek Harness, with search, tables, attachments, export and optional agent collaboration.
定位可以概括爲：對話旁邊的筆記本——邊聊邊記，也能在開啓協作後讓 AI 把討論結果寫入指定筆記；數據默認保存在本機 DSH 數據目錄，不上傳雲端。
核心功能¶
以下能力均來自項目 README 與 package.json 描述，可按需選用。
邊聊邊記與完整編輯¶
- 隨記開在對話右側；輸入
/jot可打開、新建或定位一篇筆記。長文可從左側導航進入完整頁面。 - 支持標題、清單、表格、鏈接、圖片和附件；空行輸入
/插入內容，按?查看快捷鍵（README 說明不必會 Markdown 也能寫）。
搜索、整理與進度¶
- 標題與正文均可搜索；常用筆記可置頂，按文件夾歸類；清單在列表中顯示完成進度。
AI 協作（默認關閉）¶
- 在筆記列表底部打開「AI 協作」後，可在對話中用自然語言讓 AI 查找、新建或修改筆記。
- AI 只改需要改的部分；對已有筆記的修改會標「AI 修改」，可撤回該輪修改。
- 協作關閉時，隨記不會出現在對話可用工具中；開啓後，AI 也只在用戶提出需求時纔讀筆記。
導入導出與本機存儲¶
- 可導入 Obsidian 等 Markdown 筆記庫（列表「排序與選項」→「導入筆記」，選中整個文件夾，圖片與附件一併導入）。
- 整個筆記庫可導出爲 Word、PDF 或 Markdown；導出壓縮包可原樣導回。
- 默認路徑：
~/.dsh/jot；若設置了DSH_HOME，則爲$DSH_HOME/jot。桌面版與 Web 版指向同一目錄時筆記共用。卸載插件不會刪除筆記。
兼容性說明（節選）¶
- 0.2.14：修復舊 profile 中 PDF 依賴損壞導致插件無法啓動的問題；PDF/Word 導出異常時提前提示並僅停用對應格式。
- 0.2.13：支持官方 DSH 0.2.1-alpha.3 Web；此前已驗收 macOS 桌面 0.2.0-rc.2 等版本。完整驗收範圍見倉庫
docs/VALIDATION.md。
插件聲明的 DSH 引擎範圍：^0.2.0-rc.2 || ^0.2.1-alpha.1；Node.js：^22.19.0 || >=24.0.0。
安裝與啓用¶
DSH 生態採用「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝前建議查看 GitHub 源碼 與 MIT 許可證；插件以當前 dsh 進程權限運行，請自行評估信任邊界。
npm / CLI¶
尚未安裝 dsh 命令時，可在官方桌面應用菜單「管理 dsh 命令…」中安裝（需 Node.js 滿足上述版本要求）。
桌面客戶端與 Web 需分別安裝；裝好後重啓 DSH，左側導航會出現「隨記」。
# 桌面客戶端
dsh plugin --profile desktop add dsh-jot
# DSH Web
dsh plugin --profile web add dsh-jot
README 註明：DSH 0.2.1-alpha.3 Web 升級時需先移除隨記再重新安裝，筆記與附件保留；CLI 操作前先停止對應 Host。升級、卸載與備份細節見倉庫 使用指南（中文）。
Discover（DSH 0.2.1-alpha.4 起）¶
- 打開 插件 → 實驗性插件 → 更多，啓用 自定義插件市場。
- 發現（Discover）→ 添加索引源，粘貼：
https://raw.githubusercontent.com/Totoro-qaq/dsh-plugin-index/main/index.json
- 選擇 隨記 Jot，覈對包名
dsh-jot、版本及 npm 來源https://registry.npmjs.org/，確認後 立即啓用。
該索引爲作者維護的第三方源，不代表 DSH 官方認證；看不到 Discover 時仍可用上面的 npm 方式安裝。
典型用法¶
對話內快速打開筆記¶
在會話中輸入 /jot，打開或切換到目標筆記，在右側面板繼續編輯。
與 AI 協作寫待辦（協作已開啓）¶
README 示例話術：
把剛纔定的三件事記到隨記「週會」，寫上負責人。
把「週會」裏的第一條待辦勾掉。
從 Obsidian 遷入¶
在隨記列表使用「排序與選項」→「導入筆記」，選擇 Obsidian 筆記庫根目錄即可。
導出備份¶
通過導出 Word、PDF 或 Markdown（及可回導的壓縮包）做離線備份；PDF/Word 依賴異常時插件會隔離對應格式，Markdown 等仍可用（見 0.2.14 說明）。
適用場景與注意¶
適合誰： 希望在 DSH 內完成「討論 → 結構化記錄 → 待辦跟蹤」、且偏好本地優先存儲的開發者與用戶；需要表格、附件、全文搜索與可選 Agent 改筆記的場景。
注意：
- 桌面與 Web 各裝一次；兩端共用目錄需配置指向同一
jot路徑。 - AI 協作默認關，避免模型無意讀取筆記；開啓後仍建議用明確指令限定範圍。
- 社區插件星標與驗收範圍以 README 爲準（當前 GitHub 1 star）；未在資料中聲明的組合環境（如任意插件混裝、熱替換等）勿視爲已認證。
結尾¶
隨記 Jot 把可編輯筆記、待辦與文檔能力放進 DSH 對話流，並保留本機存儲與導入導出鏈路；需要 AI 寫筆記時再打開協作即可。更多細節見 SkillHub 目錄頁、GitHub 倉庫 與 npm 包 dsh-jot。
