前言¶
在 DeepSeek Harness(DSH)裏和模型來回討論,結論往往散在消息流裏:過幾天想找回某段話,只能翻會話;複製到外部筆記又丟了「來自哪條消息、哪段上下文」的錨點。常見做法是整段複製到 Notion 或本地 Markdown,但索引、回跳原文、和當前會話綁定都要自己維護。
下面介紹社區插件 dsh-memo-guojc(維護者 stellar-dream),分類爲「記憶」。它在 DSH 桌面端旁掛一層「對話切片 / 備忘錄 / 經驗庫」:劃詞即記,用 SQLite FTS5 做中文檢索,並能一鍵跳回原文;運行時零第三方依賴。插件目錄頁:https://www.skillhub.cn/plugins/stellar-dream/dsh-memo-guojc,源碼:https://github.com/stellar-dream/dsh-memo-guojc(MIT,當前發佈包版本 0.3.1)。
這是什麼¶
dsh-memo-guojc 是 DSH 的單體桌面端插件,不是獨立筆記應用。它在對話裏選中文字 → 存成「切片」→ 自動記住 session_id 與消息區間;原文不復制進庫,只記位置和引文,需要時從本機會話 transcript 取回並高亮。
收起時界面右側保留「大肥魚」入口(DeepSeek 藍鯨梗的二創),點一下展開面板;展開後可瀏覽全局樹、備忘錄、經驗庫並搜索。
核心功能¶
資料中列出的能力如下,安裝前可按需對照。
| 能力 | 說明 |
|---|---|
| 劃詞建切片 | 選中文字 → 浮動條「✂ 切片」→ 填標題 / 摘要 / 類型 / 標籤,自動掛到當前會話 |
| 全局樹 | 項目 → 會話 → 切片 → 子話題,可關鍵詞裁剪、按標籤過濾 |
| 備忘錄 | 只列 ★ 重點切片,可釘重點或取消 |
| 經驗庫 | 切片標爲「經驗候選」→ 人工確認後落庫(結論 / 情境 / 適用性 / 來源切片),可檢索並導出 Markdown |
| 全文檢索 | SQLite FTS5;中文寫入索引前切成二元組,兩字詞也能命中;單字查詢退化爲 LIKE |
| 跳回原文 | 按消息區間定位,或按引用文字在頁面查找並閃爍高亮 |
| AI 協同 | 可調 DeepSeek:消息區間 → 切片提議;切片 → 經驗提煉;一律先進確認界面,點了才落庫 |
| AI 工具 | 8 個工具:slice_write slice_search slice_list slice_tree slice_mark_key experience_write experience_search experience_export |
| 斜槓命令 | /slice list\|add\|search\|tree\|key、/exp list\|add\|search\|export |
| 數據遷移 | 從 v2 的 entries 表自動遷移:exp → 經驗庫、memo → 重點切片 |
HTTP API 掛在 /dsh-memo 下,僅接受迴環 Host 與同源請求;健康檢查、樹、切片 CRUD、FTS 搜索、經驗導出等路徑見倉庫 README 的「HTTP API」一節。
安裝與啓用¶
前提:DSH 桌面端 0.2.x,Node ≥ 22.5(插件使用 node:sqlite)。
方式一:插件面板(推薦)¶
插件面板 → 安裝 → 選擇 dsh-memo-guojc-0.3.1.tgz → 按提示確認 → 重啓一次桌面端。
方式二:一行命令¶
先完全退出 DSH 桌面端(CLI 會在 profile 目錄跑 pnpm,與桌面端佔用同一批文件),再執行:
dsh plugin --profile desktop add ./dsh-memo-guojc-0.3.1.tgz
這條命令等價於在 profile 目錄執行 pnpm add <spec>,成功後會同時寫入 dependencies 與 dsh.profile.bundles。
調試時可鏈本地源碼目錄(路徑換成你的絕對路徑):
dsh plugin --profile desktop add link:/absolute/path/to/dsh-memo-guojc
方式三:手工裝進 profile¶
離線或面板不可用時,可按 README 用 PowerShell 解包 tgz 到 node_modules、複製到 vendor、並改 package.json 的 dependencies 與 dsh.profile.bundles。手工裝後不要再跑 pnpm install;更細的安裝 / 升級 / 卸載見倉庫 docs/install.md。
裝完務必重啓桌面客戶端:宿主只在啓動時收集頁面注入行,插件模塊也在啓動時裝載。
典型用法¶
劃詞建切片¶
在對話裏選中一段文字 → 浮出「✂ 切片」或「✨ AI 切片」→ 填標題(摘要、類型、標籤可選)→ 保存。保存時自動掛到當前會話並記下消息區間。
面板與快捷鍵¶
- 全局樹:點切片行進詳情(局部樹 + 動作),「← 返回全局樹」回到頂層。
- 備忘錄:僅 ★ 重點切片。
- 經驗庫:上半爲經驗候選切片,下半爲已確認經驗;右上角可導出 Markdown。
- 頂部搜索框:搜標題 / 摘要 / 原文,切 Tab 保留關鍵詞。
- 標籤 chips:點一下按標籤過濾,再點取消。
- 置頂與拖動:釘住後面板外點擊不會自動收起;拖標題欄可挪位置(記在
localStorage)。
| 鍵 | 作用 |
|---|---|
Ctrl/Cmd + Shift + M |
展開 / 收起面板 |
Ctrl/Cmd + N |
面板內新建切片 |
Esc |
關彈窗 → 退出詳情 → 清搜索 → 收起面板(逐級) |
讓助手直接記¶
對助手用自然語言即可,由工具落庫,例如:
- 「把剛纔那段存成切片,標題叫……」→
slice_write - 「我之前記過關於 FTS5 的切片嗎」→
slice_search - 「我有哪些重點切片」→
slice_list或/slice list - 「導出經驗庫」→
experience_export或/exp export
斜槓命令示例:
/slice 列出最近切片
/slice add 標題 | 摘要 手動建一條切片
/slice search FTS5 全文檢索
/slice tree 打印全局樹
/slice key <id 前 8 位> 釘爲重點
/exp 列出經驗(含候選)
/exp add 結論 | 情境 手動寫一條經驗
/exp search 中文 檢索經驗
/exp export 導出 Markdown
數據、隱私與適用注意¶
- 庫文件:默認
$DSH_HOME/memo-guojc/memo.db(WAL);環境變量MEMO_GUOJC_DIR可改目錄。 - 會話原文:不復制進 memo 庫;切片存
session_id、message_start、message_end、quote_text,從$DSH_HOME/sessions/**/session.v4.jsonl.zstd現場解壓取回。 - 出網:除你自行配置的 DeepSeek API(僅在「AI 切片 / 提煉經驗」時)外,插件不向第三方發請求;無遙測、無賬號。API Key 存本機 SQLite
meta.settings,接口只回apiKeySet;也可用DEEPSEEK_API_KEY/DSH_DEEPSEEK_API_KEY。
適合誰:長期在 DSH 裏做方案推演、需要把對話裏的結論釘成可檢索切片、並偶爾沉澱成經驗 Markdown 的開發者。
安裝前注意:DSH 生態是「一切皆插件」;SkillHub 等社區目錄與 DeepSeek / 幻方無官方從屬關係。插件以當前 DSH 進程權限運行,安裝前應自行查看源碼與 MIT 許可證,確認數據路徑與 AI Key 策略可接受。
結尾¶
經過上面的步驟,dsh-memo-guojc 把「劃詞 → 索引 → 跳回原文 → 重點與經驗」收進 DSH 側邊,減少在會話與外部筆記之間來回搬運。若要進一步瞭解接口與架構,可直接讀 GitHub README 與 docs/。