dsh-sag

dsh-sag 是 DeepSeek Harness 的 SAG 本地个人知识库插件，让 dsh 可以检索和阅读知识、上传文件、写入笔记并管理文档。

兼容版本

• dsh-sag：0.1.1（已发布的兼容修复版）；旧版 0.1.0 不适用于新版 dsh。
• DeepSeek Harness：已验证 0.1.5-rc.1 和 0.1.5-rc.2，复核日期为 2026-09-30。npm latest / next 目前均为 0.2.0-rc.2，不在本插件声明的宿主依赖范围内，也未验证兼容性。包声明最低支持 0.1.1-rc.2；依赖范围不代表所有 0.1.x 版本都已验证。
• Node.js：^22.19.0 或 >=24.0.0；dsh 和 pnpm 需要在 PATH 中。
• SAG：需要包含“连接 dsh”设置和本地连接器 API。

快速开始

先安装 dsh 和 pnpm，并启动 SAG。已安装旧插件的用户请先阅读下方“旧版升级与启动恢复”。安装插件时无需先启动 Web：

首次安装 dsh 时可使用 npm install --global @deepseek-ai/dsh@0.1.5-rc.1；已有上述已验证版本无需重装。已使用 dsh 0.2 的用户不要直接降级现有环境，请等待兼容支持，或使用独立环境验证。

dsh --version
dsh plugin --profile web add @zleap-ai/dsh-sag@0.1.1
dsh plugin --profile web exec dsh-sag doctor
dsh --profile web

doctor 显示“SAG 已连接”后，启动或重启 Web 才能使用新插件。插件会自动发现常见本机地址，正常使用不需要准备 Python 环境或手工填写密钥。

如果没有自动发现 SAG，运行 setup：

# 自动发现已经启动的 SAG
dsh plugin --profile web exec dsh-sag setup

# 使用 SAG 导出的连接文件
dsh plugin --profile web exec dsh-sag setup ./sag-dsh.json

# 显式指定 SAG 地址
dsh plugin --profile web exec dsh-sag setup --url http://127.0.0.1:8000

# 检查保存后的连接
dsh plugin --profile web exec dsh-sag doctor

使用方式

• 检查 SAG 状态
• 创建和查询知识源
• 检索知识并读取原文
• 上传本地文件或写入文本笔记
• 查询、重新处理和删除文档

SAG 会通过能力清单告诉插件当前可用的操作；插件不会调用 SAG 未启用的能力。

安装完成后，直接在 dsh 中提出知识库任务，例如：

• “在我的 SAG 知识库里查找 DW-2412P30 的上传限制，并给出原文依据。”
• “把 /Users/me/Documents/产品手册.pdf 上传到 SAG，处理完成后总结主要内容。”
• “把下面这段会议结论作为一篇笔记写入 SAG：……”

旧版升级与启动恢复

如果安装过 0.1.0，请在升级 dsh 前先停止 Web 并升级插件。旧插件引用了新版 dsh 已删除的 settingsNamespace 导出，会导致 Web 在加载插件时失败；0.1.1 已移除该引用，并放宽宿主依赖范围。

即使 Web 已无法启动，以下管理命令仍可运行，它们不需要先启动 Web：

# 显式替换旧版本，包括之前固定为 0.1.0 的安装
dsh plugin --profile web add @zleap-ai/dsh-sag@0.1.1
dsh plugin --profile web list @zleap-ai/dsh-sag --depth 0
dsh plugin --profile web exec dsh-sag doctor
dsh --profile web

确认列表显示 0.1.1 后重新启动 Web。不要只运行不带目标版本的 update：它会遵循已保存的版本范围，精确固定为 0.1.0 的安装可能仍停留在旧版。doctor 检查 SAG 连接；Web 能否正常启动还需单独确认。

如果暂时无法升级插件，先卸载它以恢复 Web：

dsh plugin --profile web remove @zleap-ai/dsh-sag
dsh --profile web

插件管理命令会同步移除组合包注册，不需要删除整个 dsh 配置目录。卸载插件不会调用 SAG 的文档删除 API；恢复使用时重新安装并执行 doctor。

所有命令必须使用原安装的 profile 和相同的 DSH_HOME（如果设置过）；自定义 profile 请替换命令中的 web。如果曾在 cordis.patch.yml 中手工添加 dsh-sag 配置，卸载时也要移除对应条目，保留其他插件配置。新版本不会自动替换其他 profile 中仍安装的旧插件。