- DSH
- 0.2.1-rc.5
- 系统
- Windows / macOS / Linux
- 风险
- high
本页目录(13)
先查看功能、兼容性、权限和同类选择,再按本文操作。
当前默认 DSH 0.2.2-rc.1 提醒(2026-11-06)
npm 默认版本已改为 DSH 0.2.2-rc.1。本页固定的 dsh-context 0.78.2 通过它的版本声明检查(engines.dsh 为 >=0.2.0-rc.2 || >=0.2.1-rc.2),但下方命令仍固定 DSH 0.2.1-rc.5,本站没有在 0.2.2-rc.1 上复核源码或运行。0.2.2-rc.1 调整了多项插件接口,并要求 Node.js ≥24.9.0;通过声明检查只说明不会被安装门禁拦截,不代表能加载。作者已发布 0.82.0,本站已于 2026-11-06 静态复核其源码与发行物(结论为可带风险说明升级);因本站插件索引的本地样例绑定 0.78.2,本页暂不替换安装目标。0.82.0 新增全会话快照接口与每 30 秒轮询、推荐卡失败时改走第三方代理 gh-proxy.org、启动时原地改写投影缓存,升级前需另行备份。升级宿主前先看0.2.2-rc.1 升级检查。
B2 固定版本说明(2026-11-01)
本页从 0.64.0 升级至 0.78.2,配套 DSH 0.2.1-rc.5。已重新核对精确发行包、完整性、registry 签名、gitHead、发行标签和固定源码;provenance 只核对声明,未验证完整 Sigstore 信任链,未独立重建产物。
读取会话正文、路径、工具输出、技能目录与子 Agent 记录;补写缺失消息 ID、持久化投影缓存,并为图片附件创建预览链接或副本。promptPrefix/promptSuffix 可改变系统提示;余额路由由宿主读取 API Key,HTTP 路由依赖 Connection 认证,不能当作多租户会话隔离。
以下步骤是读者可执行的隔离验证清单;本站没有安装或运行插件,没有登录、联网查询余额、导入技能或触发迁移。升级前按下文备份与回退说明保护旧数据。
依据:固定证据 1(外部链接,在新标签页打开)、固定证据 2(外部链接,在新标签页打开)。
dsh-context 0.78.2 展示上下文组成、命令/文件活动、跨会话统计与 Agent 编队,新增附件预览和技能目录;可注入自定义提示词并查询平台余额,不能当作纯只读面板。
如果你的目标是查看上下文、历史和附件,并控制余额请求与提示词注入,本教程会说明如何在 DeepSeek Harness(DSH)中准备、安装、配置、验证和回退 dsh-context。本文锁定作者仓库提交 32982aa6aa2c;已复核固定提交的原始资料,未进行运行实测。
对应插件:查看 dsh-context 的功能、权限与兼容性说明。先确认它适合你的工作流,再执行安装。
0.64.0 → 0.78.2:从统计面板到会话工作台
本页固定 dsh-context 0.78.2 + DSH 0.2.1-rc.5。除上下文趋势与洞察外,新版还展示命令、编队、技能和附件,并支持自定义系统提示词前后缀。先在不含敏感记录的独立 Profile 查看当前测试会话,保持提示词为空;统计和费用是插件的计算结果,不是平台账单或模型实际上下文的完整证明。
先确认是否适合你
- 分类:知识与记忆
- 风险等级:high
- 核验证据:source_reviewed
- 兼容性边界:0.78.2 声明的 engines.dsh 为 >=0.2.0-rc.2 || >=0.2.1-rc.2,按官方 engines 优先规则接受 0.2.1-rc.5;作者兼容表仅明确列出 rc.2 组合,不代表本站验证 rc.5。Node.js 要求 ^22.19.0 || >=24.0.0。仅完成固定源码与发行包静态复核,未运行验证。
- 主要权限关注:读取会话正文、路径、工具输出、技能目录与子 Agent 记录;补写缺失消息 ID、持久化投影缓存,并为图片附件创建预览链接或副本。promptPrefix/promptSuffix 可改变系统提示;余额路由由宿主读取 API Key,HTTP 路由依赖 Connection 认证,不能当作多租户会话隔离。
如果你准备在重要工作区使用,先阅读插件详情页的权限和数据流说明;“源码已审阅”或“资料已整理”都不等于安全认证。
安装前准备
本页 DSH 命令版本: 0.2.1-rc.5。B2 固定 0.78.2 与 DSH 0.2.1-rc.5,已复核发行包和源码;声明通过不等于加载或运行验证。旧 0.64.0 + 0.2.0-rc.2 仅用于识别升级前备份。
- DSH 0.2.1-rc.5 与 Node.js:0.78.2 声明的 engines.dsh 为 >=0.2.0-rc.2 || >=0.2.1-rc.2,按官方 engines 优先规则接受 0.2.1-rc.5;作者兼容表仅明确列出 rc.2 组合,不代表本站验证 rc.5。Node.js 要求 ^22.19.0 || >=24.0.0。仅完成固定源码与发行包静态复核,未运行验证。
- 独立测试环境与状态备份:使用独立 web Profile、不含敏感数据的测试工作区;升级前停止 DSH,备份 Profile、插件状态与受影响文件。
- 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认
pnpm可用。 - 使用独立的
webProfile 和可丢弃测试工作区,不直接连接生产目录。 - 备份当前 Profile 配置,并记录安装前的
--dump-config输出。 - 核对固定来源中的外部服务、账号、运行时和平台限制。
- 需要凭据时只准备测试凭据;本页识别到的候选变量包括
DEEPSEEK_API_KEY。
安装 dsh-context
52DSH 使用目录中记录的精确安装目标,避免直接跟随可能变化的默认分支:
npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]
GitHub 源码插件如果被 pnpm 拦截构建脚本,先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项,不要全局放行未知依赖。
插件专属配置
配置目标
$DSH_HOME/profiles/web/cordis.patch.yml:同一 Profile 的插件 Loader 行配置;备份整个配置和依赖/锁文件。
环境变量
DEEPSEEK_API_KEY(可选),敏感:余额经宿主凭据服务解析提供方的 apiKeyEnv 引用;不是插件必须的新凭据,不在插件配置明文填写。
先隐藏跨会话入口,保持提示词为空
证据:固定来源(外部链接,在新标签页打开)。按上方配置目标使用本段内容;如有占位符,替换为测试值。
- id: dsh-context
config:
insightsEntry: hide
fleetTab: hide
promptPrefix: ""
promptSuffix: ""
安装后设置
- 下列为待执行的隔离验证步骤,52DSH 本轮未安装或运行插件。
- 停止旧进程,按精确版本命令更新,再导出同一 web Profile 的组合配置。
- 保持 promptPrefix/promptSuffix 为空;在 Plugin 配置核对 insightsEntry、fleetTab 与旧偏好。
- 先查看当前测试会话的上下文;核对余额接收端点后再决定是否显示洞察入口,隐藏入口不关闭后端 API。
旧偏好与提示词迁移
停止 DSH 后,备份 Profile 的 package.json、锁文件、cordis.patch.yml 和 DSH 会话/投影存储,再升级固定版本。现行 Loader 行仍是 dsh-context,新增 fleetTab、overviewAutoSteps、defaultOverviewRange、promptPrefix、promptSuffix 等字段。默认文件排序已为 lines;有旧配置覆盖时以实际保存值为准,不批量重置偏好。config 是整块替换,复制示例前合并要保留的字段。
promptPrefix / promptSuffix 会注册系统提示词段落,默认空字符串;它们会影响后续模型行为,不能把任意下载的说明粘贴进去当显示配置。想停用此能力,应清空两项并核对实际组合。
配置验证与成功结果
先导出配置,再启动同一版本的 DSH Web:
npx --yes @deepseek-ai/[email protected] --profile web --dump-config
npx --yes @deepseek-ai/[email protected] web
-
核对包版本、宿主和唯一挂载行;导出配置不算运行验证。
npx --yes @deepseek-ai/[email protected] --profile web --dump-config期望结果:出现 dsh-context 对应插件行,未重复挂载。
-
在测试会话打开上下文标签,查看一个分类与一次工具调用,不启用余额或提示词注入。
期望结果:可看到当前测试会话的组成和事件;若历史数据未回填,界面明确显示缺失,不据估算认定平台账单。
第一次使用
- 查看测试会话中系统提示、工具与用户消息的占比,比较一个步骤的上下文变化。
冷读、附件与余额边界
首次打开洞察会请求历史投影回填;它会读取符合条件的历史会话,跳过活跃会话,按内存水位与工作预算暂停,不保证一次补齐全部记录。详情、编队与附件也可能触发冷读。图片预览会在 DSH 缓存下创建硬链接或副本,已有消息的缺失 ID 也可能写入日志,所以卸载不能简单等同于撤销所有写入。
insightsEntry: hide 隐藏洞察入口,可避免正常界面触发对应余额/回填请求,但没有关闭服务端余额路由,不是安全开关。余额按配置 baseURL 的 origin 拼 /user/balance,忽略路径前缀;未配置时落到 https://api.deepseek.com。只设 DEEPSEEK_BASE_URL 的网关部署仍须逐项核对,不能据此推断余额走相同网关。
数据、权限与凭据
数据流: DSH 会话/技能/附件 → 本机投影与预览缓存 → 通过宿主认证的 Web 页面。余额凭据发送至 DeepSeek 配置 baseURL 的 origin + /user/balance,缺省为 api.deepseek.com;不直接读取 DEEPSEEK_BASE_URL。推荐卡由宿主读取作者 raw.githubusercontent.com/main 数据,浏览器还可能请求外部图标及 npm 版本号;固定插件版本不固定推荐卡内容。
权限关注: 读取会话正文、路径、工具输出、技能目录与子 Agent 记录;补写缺失消息 ID、持久化投影缓存,并为图片附件创建预览链接或副本。promptPrefix/promptSuffix 可改变系统提示;余额路由由宿主读取 API Key,HTTP 路由依赖 Connection 认证,不能当作多租户会话隔离。
数据存储: 显示偏好与提示词在 Profile Loader 行;投影由 DSH 会话缓存持久化,图片预览可在 cache/dsh-context/previews 建链接或副本,消息 ID 可进入会话日志;余额数字保存在浏览器本地存储。
真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。
卸载、回退与清理
停止 DSH 后,从同一个 Profile 移除包:
npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-context
- 停止 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-context,重启并检查入口已消失。
- 回退恢复升级前整套 Profile 与插件状态/文件备份;卸载不自动撤销文件写入或外部授权。
外部推荐、权限与回退
推荐卡会读取作者 main 分支的远程 JSON,其内容和图标可在不升级插件时变化;未看到源码把会话正文随此请求发送,但这不意味着完全离线。当前固定 API 路由经 Connection 注册,由宿主认证准入;跨会话视图面向同一可信宿主用户,不提供工作区之间的独立授权。回退恢复升级前整套 Profile 与会话/缓存备份;不为清理投影直接删除原会话或附件。本站没有运行余额请求、提示词注入、附件预览或历史迁移。
常见问题
余额走错网关或不显示
核对配置 baseURL 的 origin 与凭据引用;插件不直接读取 DEEPSEEK_BASE_URL,且不保留 URL 路径前缀。未确认前隐藏洞察入口。
历史统计不完整或内存压力暂停回填
回填会跳过活跃会话并受内存/预算限制;保留原会话,先查看当前会话,不为补齐统计删除日志或反复刷新。
安装成功但页面或命令没有出现
先运行 --dump-config 确认 Bundle 已进入 web Profile,再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。
插件运行后没有得到预期结果
把问题缩小到本页的最小验证任务,检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文,并核对当前安装目标是否仍对应本页固定提交。
作者固定资料中未识别到独立故障章节。遇到插件特有错误时,应先停止 DSH、保留日志并回退插件。
固定来源证据
以下资料是本文配置结论的依据:
继续查看:返回 dsh-context 插件详情页,重新核对兼容性、权限、同类插件和来源状态。
来源与维护信息
本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。
- GitHub:bowenliang123/dsh-context(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 package.json(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 LICENSE(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 cordis.patch.yml(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 compatibility.md(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 index.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 config.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 connection.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 balance.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 attachment.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 skills.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 fleet.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 backfill.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 coldRead.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 promptInjection.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 stepIdentity.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 recoms.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 recoms.ts(外部链接,在新标签页打开)
- GitHub:deepseek-ai/deepseek-harness 固定提交 plugin-compatibility.ts(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 README.md(外部链接,在新标签页打开)
- GitHub:bowenliang123/dsh-context 固定提交 README_zh.md(外部链接,在新标签页打开)