前言¶
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 。
