前言¶
DeepSeek Harness（DSH）通过插件扩展模型来源、会话选项和 Agent 预设。若要在桌面端使用 ShanghaiTech GenAI 本地或远程网关，并保留网站侧的联网搜索、深度思考、网页附件等能力，需要统一的 provider ID、会话 UI 与凭证读取方式。dsh-shanghaitech-genai 由 Github-Anderson 维护，分类为模型推理，将上述能力打包为符合 DSH Bundle 规范的插件；本地网关与部署脚本在配套仓库 ShanghaiTech-GenAI 中提供。
这是什么¶
插件包名 dsh-shanghaitech-genai，当前资料中的版本为 1.0.5，要求 DSH Desktop ≥ 0.2.1-rc.2。模型来源、Agent 预设及 provider ID 均为 shanghaitech-genai，界面显示为 ShanghaiTech GenAI。它不负责单独实现推理服务，而是适配网关、挂载会话选项与 Standard 原生工具流程，并从本地部署目录或环境变量读取 base_url 与密钥。
核心功能¶
模型与会话选项¶
支持独立的 Search / Thinking 选项、网站附件、来源与 usage 展示。输入区按钮随 DSH 语言显示为「联网搜索 / 深度思考 / 网页附件」或 “Search / Thinking / Attachments”；启用时高亮，行为对应原网站功能。Thinking 是否显示取决于网关能力；配套配置对 Kimi 与 GPT 系列开放。
网页附件¶
发送消息时，附件走网站图片上传或文档解析接口。图片接受 PNG、JPEG、WebP、GIF，严格小于 20 MiB；文档接受 PDF、TXT、CSV、DOCX、XLS、XLSX、PPT、PPTX、HTML、JSON，严格小于 10 MiB。资料注明 DOC、XML 被网站拒绝而未开放；需网关与所选模型均支持附件，扫描件无文本时不提供 OCR 回退。
PDF 与原生工具¶
独立 PDF 文本工具名为 shanghaitech_genai_read_pdf，仍只处理 PDF。
删除会话¶
「删除会话 / Delete session」有独立确认，默认勾选「同时删除网站历史 / Also delete website history」。确认后永久删除当前本地会话及子代理，并清理工作区记录；不删除工作区文件或独立分叉。同步删除网站历史时，须等网站确认成功后再删本地；旧会话缺少上游映射或登录令牌变更时，可在网站清理历史，或取消勾选仅删本地。生成中或有待处理工作的会话须先停止。插件兼容 DSH 默认关闭的全文搜索；删除后搜索索引刷新异常仅警告。功能适配已检查的 JSONL 存储生命周期；更新插件后应完全退出 DSH（含 Windows 托盘或 macOS 后台进程）再重新打开。
安装与启用¶
已发布版本（DSH Desktop 插件界面）¶
在插件安装界面提交以下来源：
github:Github-Anderson/dsh-shanghaitech-genai#v1.0.5
已配置 DSH CLI 时，可安装到指定 profile：
dsh plugin --profile <profile-name> add github:Github-Anderson/dsh-shanghaitech-genai#v1.0.5
私有 GitHub 仓库安装需要当前 Git 环境具备读取权限。
本地开发与网关¶
Windows 与 macOS 可在两个同级仓库的父目录运行配套脚本，从源码打包并安装插件。
Windows（PowerShell）：
powershell -ExecutionPolicy Bypass -File .\ShanghaiTech-GenAI\tools\Sync-Local.ps1
powershell -ExecutionPolicy Bypass -File .\ShanghaiTech-GenAI\tools\Deploy-Local.ps1
macOS（终端）：
./ShanghaiTech-GenAI/tools/Sync-Local.sh
./ShanghaiTech-GenAI/tools/Deploy-Local.sh
在网关仓库运行 tools/Setup.sh（macOS）或 tools/Setup.ps1 / tools/Setup.cmd（Windows）完成首次部署与更新。默认运行目录为 macOS 的 ~/.local/share/shanghaitech-genai/，或 Windows 的 %LOCALAPPDATA%\ShanghaiTech-GenAI\；配置与网站凭证在 deploy/private/。检查完成后完全退出 DSH，再通过运行目录中的 deploy/Start.sh 或 deploy/Start.ps1 启动。详细参数见配套仓库 tools/README.md。
网关地址与凭证¶
本地部署会自动登记私有目录，插件从其中的 dsh-gateway.json 读取 base_url 和 key_file。base_url 未填或留空时使用 http://127.0.0.1:8000/v1 及私有目录中的 gateway.key；配置远程地址时使用 key_file 指定的密钥文件（相对于私有目录）。尚未登记私有目录时，可用环境变量 SHANGHAITECH_GENAI_BASE_URL 提供地址，密钥使用 DSH 凭证引用 SHANGHAITECH_GENAI_API_KEY。
配置凭证后重启 DSH，新建会话，选择 ShanghaiTech GenAI 预设与同名模型来源。网关首次登录与凭证导入见配套 安装指南。
典型用法¶
1、按上文安装插件并完成网关 Setup 与 Start。
2、在 DSH 中配置凭证并重启，新建会话。
3、模型来源与会话预设均选 ShanghaiTech GenAI，按需开启 Search、Thinking 或网页附件后正常对话。
4、需要读 PDF 文本时，由 Agent 通过 shanghaitech_genai_read_pdf 调用（与附件中的 PDF 解析路径不同，工具仅处理 PDF 文件）。
适用场景与注意¶
适合已在或计划使用 ShanghaiTech GenAI 网关、并希望在 DSH Desktop 内统一模型来源与会话选项的开发者。插件以当前 DSH 进程权限运行，安装前应阅读仓库源码与 MIT License。Node 需满足 package.json 中 ^22.19.0 || >=24.0.0；包标记 private: true，避免误发布到 npm。社区目录页与 GitHub 仓库相互独立，目录站点并非 DeepSeek 或幻方官方应用商店。
结尾¶
dsh-shanghaitech-genai 把 ShanghaiTech GenAI 的模型适配、会话选项、附件路由与删除会话行为收进一个 DSH Bundle，并与配套网关仓库的部署流程对齐。进一步了解可查看 SkillHub 目录页 与 GitHub 仓库。
