前言¶

在用 DeepSeek Harness（DSH）长期做智能体或项目开发时，侧边栏里的会话和工作区会越积越多。宿主默认能力往往侧重对话与工具调用，但对「彻底删掉一条会话」「把会话挪到另一个工作区」「误删后找回」以及「网页搜索/抓取走哪家 API」这类日常运维，不一定一次到位。Augmented DSH（npm 包名 augmented-dsh）是社区维护的 DSH 插件，在会话侧增加删除与迁移（含备份与记录），并通过 cordis.patch.yml 把 Web 侧的搜索与抓取 provider 换成可配置的优先—候补链。下面按安装、设置与典型操作说明其实际行为与注意事项。

这是什么¶

• 名称：Augmented DSH（npm：augmented-dsh）
• 维护者：AnbaoIy
• 分类：联网工具（SkillHub 目录归类）
• 版本（资料记载）：1.0.5，MIT 许可
• 定位：DSH 插件——对话删除、工作区迁移、搜索/抓取多平台优先—候补替换

插件不替代 DSH 本体；以当前 profile 的 bundle 形式加载，在 Web 客户端注入工作区与会话相关 UI，并 patch web 的 searchProvider / fetchProvider。

核心功能¶

删除会话¶

会话行与归档行的「…」菜单会多一项「删除会话」。二次确认后，会连同转录、工作区记账、归档标记与 spill 一并清理，避免留下半截数据。

删除前会自动备份完整会话历史。「设置 → Augmented DSH」→「删除记录」可按删除时间找回误删会话：

• 同一会话反复「删除 → 恢复 → 再删除」在列表里只显示一条，条目内按删除时间逐行展示，每行对应一次恢复按钮；
• 若期间改过会话名，会按改名分段，段与段之间有内缩分割线；
• 记录与备份保留 3 天，过期后一并清理。

关掉「会话删除」开关后，菜单不再出现「删除会话」，删除记录功能一并停用。

迁移会话与工作区¶

单条迁移（菜单）：会话「…」→「迁移会话」，选择目标工作区。

单条迁移（拖拽）：将会话行拖到目标工作区行上（落点有虚线高亮）；列表较长时，指针停在上下边缘可自动滚动。

整个工作区：工作区「…」→「迁移工作区」，选目标后一次迁走其下会话。

迁移会在目标路径下重建一份带完整历史的会话，再删除原会话（不进入归档）。工作区归属由会话 header 的 cwd 决定，且 header 不可改写，因此只能采用重建方式。

每次迁移前会自动备份完整会话。「设置 → Augmented DSH」→「迁移记录」列出历史（会话名、源工作区、目标工作区、时间），可一键恢复到迁移前的工作区。记录与备份同样保留 3 天，DSH 启动时自动清理过期项。

关掉「工作区迁移」开关后，拖拽、「迁移会话」与「迁移工作区」均不可用。

搜索 / 抓取替换¶

将网页搜索与抓取换成一串「优先 → 候补」平台；前一家不可用（无 key、限流、超时、未抓到正文等）时自动换下一家。选 DeepSeek 官方时请求原样交给宿主，key 与账号令牌由宿主管理，插件不复制、不另存。

搜索与抓取各三个槽位（优先、候补 1、候补 2），整条链 28 秒预算；页面确实 404/410 时不降级。

关掉「网页搜索/抓取替换」后，交还宿主内置 provider。

设置项总览¶

同页可配置各平台 key 与优先—候补链。密钥存入 DSH 凭据服务，不写设置文件、不进日志。宿主升级后插件会自检：某项在新版 DSH 上不可用时，对应开关及下属区域置灰，标题变红。

安装与启用¶

发布形态为 tgz 包；装进 profile 后是独立副本，源码目录之后可随意移动、改名或删除。

# 1. 打包
pnpm pack                                  # 产出 augmented-dsh-<version>.tgz
# 2. 放到一个固定位置
mkdir -p ~/.dsh/plugins && mv augmented-dsh-*.tgz ~/.dsh/plugins/
# 3. 在 profile 里安装
cd ~/.dsh/profiles/desktop
pnpm add file:C:/Users/<you>/.dsh/plugins/augmented-dsh-1.0.5.tgz

README 示例使用 Windows 路径；在 Linux 上请将 file: 指向本机 tgz 的绝对路径，目录结构可与上例对应为 ~/.dsh/plugins/ 与 ~/.dsh/profiles/desktop。

或直接编辑 ~/.dsh/profiles/desktop/package.json 后在该目录执行 pnpm install：

{
  "dependencies": { "augmented-dsh": "file:C:/Users/<you>/.dsh/plugins/augmented-dsh-1.0.5.tgz" },
  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "augmented-dsh"] } }
}

升级时重新 pnpm pack，覆盖同一目录下的 tgz，再执行 pnpm install --force（同名文件 pnpm 默认可能走缓存）。

开发期若希望改代码即时生效，可链到源码目录：

dsh plugin --profile desktop add link:C:/path/to/Augmented-DSH

插件自带 cordis.patch.yml。安装并重启 DSH 后，应出现「设置 → Augmented DSH」。

冲突提示：不要与 dsh-webenhance、@michengai/dsh-archive-manager 同时启用——三者争用同一会话菜单槽位与 web provider id。

运行环境要求 Node >= 20（见 package.json 的 engines）。

典型用法¶

1. 清理无用会话：侧边栏会话或归档行「…」→「删除会话」→ 确认；若误删，三天内到「设置 → Augmented DSH」→「删除记录」按时间点恢复。
2. 换项目目录继续聊：「迁移会话」或拖拽到目标工作区；若迁错，在「迁移记录」里恢复；原会话已删且不进归档。
3. 配置搜索抓取：打开总开关，为搜索链与抓取链分别选 Parallel / Tavily / Firecrawl 或 DeepSeek 官方的优先与候补，保存各平台 key；确认优先位与 key 已保存后再发起需要联网搜索或抓取的对话。

适用场景与注意¶

适合谁：长期在多个工作区之间切换、需要彻底删除会话或整区迁移、并希望用 Tavily / Firecrawl / Parallel 等做搜索抓取 failover 的 DSH 桌面 Web profile 用户。

权限与安全：插件与当前 DSH 进程同权限运行，会读写会话与工作区相关数据；安装前应阅读仓库源码与 MIT 许可证，自行判断是否纳入工作流。

生态说明：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，安装步骤以 GitHub README 为准。

常见问题（摘自 README）：

• 迁移后原会话已删除，不进归档；3 天内在「迁移记录」可恢复。
• 「恢复」为灰色：多为旧版插件留下的记录，无对应备份文件。
• 搜索未走所配平台：确认开关已开、该平台在优先位、key 已保存。

结尾¶

Augmented DSH 把会话删除（含短期可恢复）、工作区级迁移（含迁移前备份与 3 天记录）、以及多平台搜索抓取链集中在同一设置页，适合作为桌面 profile 的日常运维补充。查阅与安装请参考：

• 目录页：https://www.skillhub.cn/plugins/AnbaoIy/Augmented-DSH
• GitHub：https://github.com/AnbaoIy/Augmented-DSH