前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。随着开发需求的增加，用户往往需要在 profile 中安装多个插件来扩展功能。手动逐个管理这些插件不仅繁琐，还容易在依赖管理上出现冲突。
weibaohui/dsh-fde-tools 是一个聚合型插件，旨在解决上述问题。它将 19 个常用的 DSH 插件打包成一个插件安装，通过统一的「FDE 工具箱」面板进行批量管理。安装一次即可获得 Git 服务器、知识库、定时任务、Agent 团队协作等全套能力。
插件概览¶
- 名称：
weibaohui/dsh-fde-tools - 定位：DSH 插件全家桶，批量管理 19 个常用插件。
- 维护者：weibaohui
- 许可证：MIT
核心功能¶
安装本插件后，会在 DSH 设置面板中生成「FDE 工具箱」。该面板列出了全家桶的所有成员及其安装状态：
- 登录门禁 (user-management)：未登录时弹窗，支持用户/角色/审计及 TOTP 验证。
- Git 服务器 (dsh-git-server)：内嵌 ts-gogs，支持 HTTP 克隆推送、网页端操作及 issue/PR 管理。
- WebDAV 挂载盘 (dsh-webdav-server)：将共享目录转为挂载盘，支持三平台挂载与令牌认证。
- 团队知识库 (dsh-kb)：支持浏览、全文检索，并支持 raw 入料自动蒸馏。
- 定时任务 (dsh-tasks)：通过 cron 表达式设置定时任务，自动开启新 Agent 会话。
- 自动续跑 (dsh-continue)：会话中断后自动退避重试，支持切换模型或压缩上下文。
- 界面微调 (dsh-settings-ui)：调整设置窗口大小、透明度及背景。
- 自动复盘 (hermes-loop)：在对话收尾时自动蒸馏经验，生成可复用技能。
- 会话工作区文件管理 (dsh-file-share)：提供文件树、预览、上传下载及打包功能，支持
@给 Agent。 - 会话智能标题 (dsh-smart-title)：使用 LLM 自动改写会话标题。
- Agent 优先的任务看板 (dsh-taskboard)：任务账本与独立会话结合。
- 可视化插件市场 (dshmarket)：浏览并安装插件。
- 上下文仪表盘 (dsh-context)：通过
/context命令查看上下文组成。 - IM 渠道接入 (@xmanrui/dsh-im)：接入 11 种 IM 渠道。
- VSCode 式侧边栏 (dsh-better-sidebar)：右侧边栏，按会话隔离资源管理器、编辑器、终端等。
- 本地 QA 工作台 (dsh-qa)：需求/用例/缺陷全流程管理，支持实时看板与日历。
- 多代理团队组建 (@nanmicoder/dsh-agent-teams)：一句话组建多代理团队，支持持久成员协作与 DAG 面板。
- 执行流程图 (dsh-flow)：将会话执行过程绘制为四泳道流程图。
- 使用量仪表盘 (dsh-dashboard)：统计 token/费用/模型/工具，支持拖拽编排与自定义公式。
安装与启用¶
通过以下命令将全家桶插件安装到指定 profile 中：
dsh plugin --profile web add @weibaohui/dsh-fde-tools
安装完成后，重启 DSH。在设置中找到「FDE 工具箱」面板，可以查看成员安装状态，点击「补装」或「安装」即可将缺失成员加入。
重启生效的注意事项：
* 本机直连：如果通过 http://127.0.0.1:3080 访问，面板会提示「立即重启」，点击后 DSH 会自动拉起新进程并刷新页面。
* 局域网/服务管理器：出于安全考虑，局域网或通过 HTTPS 网关访问时不显示重启按钮，需在终端手动重启；如果 DSH 由 launchd 或 systemd 守护，也建议在终端重启。
工作原理¶
本插件通过引导器在宿主侧执行操作，确保依赖与配置的正确性。
-
快照还原机制
pnpm 在 profile 中执行add命令时，有时会清除link:或file:依赖。安装前，引导器会将依赖和 bundles 快照到<profile>/.fde-tools-install-snapshot.json。安装完成后，通过 diff 检查并补回丢失的依赖，防止依赖丢失。 -
构建脚本拦截
部分包（如 better-sqlite3、node-pty）带有安装期构建脚本，pnpm 默认会拦截。引导器识别ERR_PNPM_IGNORED_BUILDS错误，自动在pnpm-workspace.yaml中添加allowBuilds配置项，重试安装。 -
成员去重
如果某个成员已经存在于 profile 的依赖中（无论是 npm 包、link 还是 github spec），引导器会自动跳过，不会覆盖现有的安装方式。
环境变量¶
可以通过以下环境变量调整安装行为：
DSH_FDE_TOOLS_PROFILE：手动指定所属 profile 的名称或绝对路径（默认自动扫描~/.dsh/profiles）。DSH_FDE_TOOLS_PNPM：手动指定 pnpm 可执行文件路径（默认按 PATH →~/.local/bin/pnpm→ 宿主同前缀的 pnpm.cjs 顺序探测）。DSH_HOME：指定 DSH 的主目录（默认~/.dsh）。
兼容性与注意事项¶
- 版本要求：仅支持 DeepSeek Harness >= 0.1.7-rc.2，需要 Node.js >= 22.5。
- 权限与安全：插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。
- 生态背景：DSH 及其插件生态与 DeepSeek 或幻方官方无从属关系，社区目录（如 SkillHub）为独立站点。
总结¶
weibaohui/dsh-fde-tools 通过插件聚合的方式，大幅降低了 DSH 用户扩展工作流的门槛。无论是基础的服务搭建、文件管理，还是进阶的 Agent 团队协作与流程可视化，都能在一个面板中一站式管理。
