前言¶
litman 是一款自託管的文獻管理工具，把讀過的論文存在你自己的機器上，由 AI 助手負責歸檔和檢索。如果你已經在 DeepSeek Harness（下面簡稱 DSH）裏寫代碼或跑任務，通常會有兩條路：要麼先在系統裏裝好 litman，再想辦法把它的命令和 skills 接進 agent；要麼手工維護一堆路徑和腳本。這兩種做法都要先打通環境，容易卡在安裝這一步。
下面介紹的 dsh-litman 插件走的不是這條路。它是 wqx1999 維護的一個 DSH 客戶端插件（當前版本 0.1.0，MIT 許可），作用是把這個流程壓成兩步：在側邊欄點一下 litman，就能看到你的文獻庫並建立工作區；如果機器上還沒有 litman，直接在會話裏說一句，agent 會檢查、確認後安裝並連接。插件本身不聯網、不存數據，litman 的能力仍然由 litman 自身提供。
這是什麼¶
一句話定位：dsh-litman 是 litman 的 DSH 集成插件，把 litman 的庫列表、工作區和 skills 掛到 DSH 的客戶端側邊欄與 agent 流程裏。
- 維護者：wqx1999（package.json 中的 author 爲 Qingxin Wang，主頁 litman.dev）
- 插件包名：
dsh-litman - 版本：0.1.0
- 插件許可證：MIT；litman 本體爲 AGPL-3.0
- 依賴：DSH 0.2 及以上（package.json 的 engines 爲
>=0.2.1-0 <0.3.0） - 分類：客戶端
它解決的是兩件事：一是從 UI 進入文獻庫，不用記命令；二是缺 litman 時由 agent 按官方流程安裝，不用自己先做環境準備。litman 的其他行爲（存儲、檢索、歸檔）都不屬於這個插件。
核心功能¶
插件的能力按用途拆成三組。
1、側邊欄入口與庫列表。在 DSH 客戶端左側邊欄點擊 litman，插件通過 lit vault list 列出本機的 litman 文獻庫。
2、以工作區打開庫。點擊 New session 時，插件會把這個庫作爲 DSH 工作區加入，litman 的 skills 隨之就緒。
3、缺失時自動安裝。在任意會話裏提出需求（例如 “set up litman”），agent 先檢查 litman 是否存在，安裝前會詢問；確認後運行 get.litman.dev 上的官方安裝腳本（uv 和 litman 會裝到用戶的 home 目錄下），再執行 lit install-skill --agent dsh，把 litman 的 skills 接到 DSH。
4、網絡與存儲邊界。插件自身不發送任何網絡請求，也不存儲數據；所有聯網動作都發生在 litman 的安裝腳本里。
安裝與啓用¶
安裝走 DSH 的插件管理界面，命令就是插件標識本身。Plugins → Add plugin 中輸入：
dsh-litman
然後點擊 Install、再點擊 Enable。也可以在 Add plugin 裏直接填 GitHub 地址：
https://github.com/wqx1999/dsh-litman
需要 DSH 0.2 或更高版本。這一步只添加插件，不會安裝 litman 本體——即使機器上還沒有 litman，也可以先啓用插件，後面再讓 agent 處理。
典型用法¶
以下兩種用法都來自 README，可以直接復現。
第一種，已有 litman 庫，想把庫帶進 DSH：
1、打開 DSH 客戶端，確認插件處於啓用狀態。
2、點擊左側邊欄的 litman，查看 lit vault list 列出的庫。
3、點擊某個庫的 New session，DSH 會添加工作區，並加載 litman 的 skills。
第二種，機器上還沒裝 litman：
1、在任意會話中直接說 “set up litman”，或者表達想讓 agent 幫你搭好 litman。
2、agent 檢查 litman 是否存在，若不存在會先詢問是否安裝。
3、確認後運行官方安裝腳本，並執行 lit install-skill --agent dsh。
4、DSH 可能因爲沙箱攔截下載而彈一次授權請求，允許一次即可。
安裝完成後回到側邊欄，就和上面的第一種用法一致了。
適用場景與注意¶
適合這幾類使用方式：
- 已經在本機用 litman 管理論文，希望在 DSH 裏直接打開庫、讓 agent 帶着文獻上下文工作。
- 想在 DSH 裏開始用 litman，但不希望先手動配環境，想讓 agent 走官方流程安裝。
- 需要明確的數據邊界：插件自身不聯網、不存數據，適合在意本地化存儲的用戶。
需要注意的點：
1、插件以當前 DSH 進程的權限運行，agent 發起的安裝腳本同樣如此。執行安裝前，先確認你信任腳本來源；官方安裝腳本來自 get.litman.dev，安裝內容爲 uv 和 litman，放置在 home 目錄下。
2、安裝前檢查源碼與許可。插件是 MIT，litman 本體是 AGPL-3.0，套用或分發 litman 時要按照 AGPL-3.0 處理。問題與 bug 走 litman 的 issue 渠道，而不是插件倉庫。
3、要求 DSH 0.2 或更高（engines 爲 >=0.2.1-0 <0.3.0），低版本上插件可能無法加載。
4、README 中的授權行爲描述是”可能詢問一次”，取決於沙箱配置；如果下載被攔，記得留意授權提示。
小結¶
dsh-litman 的價值不在替換 litman，而是消除接入成本：側邊欄的入口、lit vault list 的庫列表、以工作區打開庫、以及缺失時的一鍵安裝。如果你要在 DSH 裏用 litman，可以從插件目錄頁查看當前信息：https://www.skillhub.cn/plugins/wqx1999/dsh-litman ，源碼在 https://github.com/wqx1999/dsh-litman 。如需進一步瞭解 litman 本身的行爲，見 https://litman.dev 與 https://github.com/wqx1999/litman 。
