前言¶
在用 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 与账号令牌由宿主管理，插件不复制、不另存。
| 平台 | 搜索 | 抓取 | 免费额度（资料记载） |
|---|---|---|---|
| Parallel | ✅ | — | 每月 5,000 次 |
| Tavily | ✅ | ✅ | 每月 1,000 credits |
| Firecrawl | ✅ | ✅ | 每月 1,000 credits |
搜索与抓取各三个槽位（优先、候补 1、候补 2），整条链 28 秒预算；页面确实 404/410 时不降级。
关掉「网页搜索/抓取替换」后，交还宿主内置 provider。
设置项总览¶
| 开关 | 作用 |
|---|---|
| 会话删除 | 控制删除菜单与删除记录 |
| 工作区迁移 | 控制迁移相关入口 |
| 网页搜索/抓取替换 | 控制是否使用插件 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）。
典型用法¶
- 清理无用会话：侧边栏会话或归档行「…」→「删除会话」→ 确认；若误删，三天内到「设置 → Augmented DSH」→「删除记录」按时间点恢复。
- 换项目目录继续聊：「迁移会话」或拖拽到目标工作区；若迁错，在「迁移记录」里恢复；原会话已删且不进归档。
- 配置搜索抓取：打开总开关，为搜索链与抓取链分别选 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
