前言¶

在 DSH 裏查資料、跑 /agent、跟模型討論方案時，結論往往停在會話裏；關掉窗口後，很難按當時的判斷再找到那條記錄。傳統筆記工具又常在「記」之前就要求選筆記本、起標題、打標籤，靈感很容易斷在這一步。

隨記是 DSH 生態裏的本地筆記插件：隨手寫一句先落進今日日記，再由 AI 提議歸檔到合適的筆記本；素材夠了，用 /agent 讀已有 Markdown 做合併、復盤或成文。筆記始終是普通 .md 文件，並可通過本機 MCP 讓 DSH 或其他 AI 客戶端直接讀寫。下面介紹它的定位、安裝方式與典型用法。

這是什麼¶

• 倉庫與包名：GitHub 爲 shallinta/dsh-agentic-notes，npm 包名爲 @suiji-ai/dsh-agentic-notes（README 中產品名稱爲「隨記」）。
• 維護者：shallinta；許可證 MIT；當前資料中的包版本爲 0.2.3。
• 分類：在社區目錄中歸類爲「記憶」。
• 一句話：DSH 的本地筆記插件，支持隨手記錄、AI 自動歸檔、日記、待辦與便箋，並通過 MCP 讓 AI 會話讀寫本地 Markdown。

README 註明：當前爲不穩定版本，正在進行邏輯重構，請定期備份筆記。

它解決什麼問題¶

多數筆記工具把「分類」放在「記錄」之前。隨記把順序反過來：

1. 先在頂部輸入框記下內容，按 Enter 進入今日日記，無需先選目錄。
2. AI 根據已有筆記本生成歸檔方案，確認後才寫入主題筆記本。
3. 歸錯了可用「修改筆記本」只改歸屬，不重寫正文。
4. 素材積累後，用 /agent 合併、改寫或成文。

查資料、對話裏得到的結論，也可以通過 MCP 在同一會話裏沉澱爲筆記，而不是事後憑記憶補記。

核心功能（資料已覈實部分）¶

快捷記錄與自動歸檔¶

• 首頁頂部輸入框：Enter 保存，Shift+Enter 換行；先寫當天日記，再異步分類並彈出歸檔確認。
• 日記條目上顯示歸檔狀態（歸檔中、已歸檔、待確認、失敗）；失敗可重試。
• 長記錄保留原文細節；短記錄允許模型潤色，必要時給出整篇改寫建議並經審閱後落盤。

日記、主題筆記本、便箋與待辦¶

• 日記：按日期分段的 Markdown，新月曆跳轉；一冊約滿 5000 行後下一天自動新開一冊。
• 主題筆記本：書本卡片式管理，可設隱私筆記本（界面隱藏，不加密文件）；筆記即文件名，支持拖動排序、廢紙簍與外部修改衝突提示。
• 便箋：獨立文件於 便箋/，首頁可拖動、縮放，位置尺寸會記住。
• 待辦：首頁右上角卡片；內容中含明確時間可生成提醒（一次性、間隔、每天、每週等），支持標籤篩選與系統通知。

斜槓命令¶

在頂部輸入框可使用：

不同頁面下 /agent 可見的上下文不同：首頁多爲筆記本與標題信息，筆記本頁讀該本筆記，筆記頁讀當前篇，日記頁讀最近幾冊。

/agent 能做什麼¶

除整理正文外，還可新建/移動/刪除筆記與筆記本、調整順序與標籤、管理待辦與便箋、讀取和修改部分設置（如關閉自動歸檔、隱私模式等）。大批量刪除、長篇改寫等操作需先確認；改動可整批撤銷，衝突時會拒絕覆蓋。

示例（咖啡筆記本內）：

/agent 把咖啡這本里關於手衝的筆記合併成一篇《手衝入門》，放到咖啡筆記本

MCP：讓 AI 讀寫隨記¶

隨記內置本機 HTTP MCP 服務。在設置頁「外部連接」可查看 MCP 地址、Token 與「安裝 Skill」。默認地址形態類似（以設置頁爲準）：

http://127.0.0.1:53152/dsh-agentic-notes/mcp

請求需攜帶：

Authorization: Bearer <Token>

點擊「安裝 Skill」會將 suiji-note 安裝到 ~/.agents/skills/suiji-note/。MCP 支持列出與搜索筆記、讀寫筆記與 frontmatter、管理待辦與便箋；MCP 寫入直接落盤，suiji-note 技能要求 Agent 寫入前先展示改動並等待你確認。Token 等同寫入權限，僅給可信客戶端，泄露時在設置頁重新生成。

數據與遷移¶

數據目錄由你首次使用時選擇，結構大致如下：

<你選擇的根目錄>/
  日記/
  <筆記本名>/
  便箋/
  todo.json
  .dsh-notebooks.json
  .dsh-notebooks/

根目錄路徑另存於 ~/.dsh/dsh-agentic-notes.json。複製整個 <你選擇的根目錄> 即可備份或遷移；勿把密鑰等敏感內容放進筆記後上傳到公開倉庫。

安裝與啓用¶

隨記依賴已安裝的 DSH 桌面端或 Web 端。

在 DSH 會話裏安裝（原文指令）：

安裝 npm 包：
請安裝這個隨記插件：@suiji-ai/dsh-agentic-notes

安裝 GitHub 倉庫：
請幫我安裝這個隨記插件：https://github.com/shallinta/dsh-agentic-notes

命令行：

dsh plugin add @suiji-ai/dsh-agentic-notes

指定 profile：

dsh plugin --profile desktop add @suiji-ai/dsh-agentic-notes

插件市場：先安裝市場插件 dshmarket，再在 DSH 插件頁搜索「隨記」安裝。

裝好後左側欄應出現「隨記」；若無，重啓 DSH 或讓模型檢查插件狀態。

第一次使用¶

1. 打開隨記，選擇空目錄或已有隨記數據目錄。
2. 頂部輸入框寫一句話，按 Enter。
3. 等待右下角歸檔確認，確認後點「查看」覈對位置。
4. 歸錯則點「修改筆記本」。
5. 試用 AI：打開筆記本，輸入 /agent 加具體指令。

典型用法：碎片到文章¶

1. 平時把句子、想法寫進輸入框，讓 AI 歸檔到主題筆記本。
2. 寫作前在 DSH 對話裏討論結構，或打開相關筆記本。
3. 用 /agent 讀取素材，生成大綱或初稿。
4. 在隨記內閱讀、修改後保存。

例如先建大綱：

/agent 讀一下這個筆記本里的素材，找三個能串起來的主題，新建筆記《手衝文章大綱》，把大綱寫進去

再按大綱成文：

/agent 按《手衝文章大綱》寫一篇 1500 字左右的文章，新建筆記《爲什麼我重新開始手衝》

經 MCP 在一次問答後落筆：

把剛纔關於向量數據庫選型的結論整理成一篇筆記，
標題叫《向量數據庫選型記錄》，
寫進 Agent 筆記本，並列出你參考過的來源。

適用場景與注意¶

適合誰：希望在 DSH 工作流裏「先記後理」、筆記本地可控、並願意用 /agent 或 MCP 把會話結論寫回 Markdown 的開發者或個人用戶。

權限與安全：插件以當前 DSH 進程權限運行，安裝前建議在 GitHub 查閱源碼與 MIT 許可證，確認可接受其訪問本機數據目錄與 MCP 監聽行爲。MCP 僅監聽本機；Token 不要公開泄露。

生態說明：DSH 奉行「一切皆插件」；SkillHub 插件目錄 爲社區站點，與 DeepSeek、幻方無官方從屬關係，並非官方應用商店。

結尾¶

隨記把記錄動作壓到一次 Enter，把分類與成文交給 AI 和本地 Markdown；與 DSH 的 /agent、MCP 組合後，查詢和討論更容易變成可檢索的筆記文件。

• 目錄頁：https://www.skillhub.cn/plugins/shallinta/dsh-agentic-notes
• 源碼與文檔：https://github.com/shallinta/dsh-agentic-notes