dsh-cyber-dept: Turn Agent Teams into a Pixel Office on the Right Side of the Conversation

前言

在 DSH 里用 Agent Teams 协作时,成员状态、任务进度和沟通往往分散在对话与各类面板里,要同时看清「谁在做什么、卡在哪、怎么派活」需要来回切换。下面介绍社区插件 dsh-cyber-dept(赛博 IT):它在当前会话右侧渲染可交互的像素办公室,把成员工牌、任务看板和团队沟通收进同一视图,且不遮挡中间对话区。

这是什么

dsh-cyber-dept 由维护者 Master-chai 发布,分类为工作流,在 SkillHub 插件目录 可查到条目;源码托管于 GitHub,MIT 开源,属社区插件,非 DeepSeek 官方产品。当前版本 0.2.0(见仓库 package.json)。

插件通过 DSH 客户端注入布局,在当前会话右侧显示像素卡座办公室:人物动作表达思考、输出、工具执行、审批、阻塞、完成、空闲和离线;工位、任务与员工工牌联动。浅色 / 深色主题跟随 DSH 设置。

核心功能

经 README 与 package.json 核对,能力包括:

  • 布局:右侧显示,不遮挡中间对话;不提供额外历史会话选择器。
  • 办公室 UI:加长桌面与隔板组成像素卡座;办公室、员工介绍、任务看板、团队成员可独立折叠。
  • 任务看板:筛选、搜索、完成进度、依赖显示与按需加载;按会话保留视图状态。支持删除任务、通知成员立即执行;派活时可勾选「指派后立即执行」。不提供单个任务的估算百分比。
  • 操作与确认:发消息、重开任务、派活和打断;进行中任务可标记完成。写入前需要确认。
  • 性能与同步:本地预览先显示、后台验证快照;隐藏面板暂停同步,离屏或静止场景停止动画循环。

侧栏入口为 IT;右侧栏新标签页也可选「赛博 IT 部门」。无团队或任务时显示空状态。

安装要求

安装前请确认环境:

  • 已安装 DSH,插件声明兼容 >=0.2.1-rc.5 <0.3.0-0(其他版本尚未验证)。
  • Node.js:^22.19.0 || >=24.0.0(README 亦写明 Node.js 24 等满足范围的版本),以及 npm。
  • 安装时需联网执行 npm ci 下载依赖;运行时使用 DSH 自带的 React,不访问素材或脚本 CDN。
  • 可从 GitHub Code → Download ZIP 解压得到源码目录;请保留该目录,本地链接安装后 DSH 仍从这里加载插件。

安装与启用

1. 下载并构建

在插件目录(ZIP 解压后或你已有的仓库副本)打开终端,执行:

npm ci
npm run build
npm test

README 中亦给出自 GitHub 克隆后同样从 npm ci 起的完整流程;无论来源,构建产物需与上述命令一致。

2. 添加到正在使用的 DSH profile

终端可用 dsh 时,将 desktop 改为实际 profile 名,路径改为插件目录的绝对路径:

dsh plugin --profile desktop add "link:D:/Plugins/dsh-cyber-dept"

macOS / Linux 示例:

dsh plugin --profile desktop add "link:/home/you/plugins/dsh-cyber-dept"

项目 README 注明当前主要在 Windows 验证路径与 CLI 行为。

Windows 桌面版没有 dsh 命令时,在插件目录用 PowerShell 调用应用内置 CLI(需按本机修改 DSH 可执行文件路径与 profile):

$dshExe = 'D:\DSH\DeepSeek Harness.exe' # 改为实际可执行文件路径
$dshProfile = 'desktop'                 # 改为当前使用的 profile
$pluginPath = (Get-Location).Path.Replace('\', '/')
$dshCli = Join-Path (Split-Path $dshExe) 'resources\app.asar\dsh\node_modules\@deepseek-ai\dsh\lib\bin.js'
$previousElectronMode = $env:ELECTRON_RUN_AS_NODE
try {
    $env:ELECTRON_RUN_AS_NODE = '1'
    $arguments = @(('"' + $dshCli + '"'), 'plugin', '--profile', $dshProfile, 'add', ('"link:' + $pluginPath + '"'))
    $installer = Start-Process -FilePath $dshExe -ArgumentList $arguments -WindowStyle Hidden -Wait -PassThru
    if ($installer.ExitCode -ne 0) { throw "安装失败,退出码:$($installer.ExitCode)" }
} finally {
    $env:ELECTRON_RUN_AS_NODE = $previousElectronMode
}

若 DSH 升级后内置 CLI 路径变化,请改用新版提供的插件安装入口或 CLI。

3. 打开插件

完整退出并重启 DSH,打开会话后点击侧栏 IT。安装到其他 profile 时,当前窗口不会出现插件;运行的 DSH 必须与 dsh plugin --profile … 使用同一 profile。

插件未发布 npm(package.json 中 private: true),仅通过 GitHub 与本地 link: 安装。

典型用法

经上面的步骤启用后,可按 README 建议操作:

  1. 在像素办公室中选择成员。
  2. 展开「员工介绍」。
  3. 在「沟通」区使用发消息、重开任务、派活、打断等操作(细节与失败恢复见仓库 docs/AGENT_ACTIONS.md)。

任务看板侧可筛选、搜索任务,查看依赖与进度;需要时可删除任务或让成员立即执行。凡会写入 DSH 状态的操作,界面会先要求确认。

更新:退出 DSH,在插件目录执行 git pull --ff-only(若使用 Git)、npm ci、npm run build、npm test,再启动 DSH。ZIP 用户更新原目录并重新构建;目录变更需重新 link: 添加。

卸载:

dsh plugin --profile desktop remove dsh-cyber-dept

然后重启 DSH。仅桌面内置 CLI 时,用与安装相同的 PowerShell 启动方式,将末尾参数改为 remove、dsh-cyber-dept。

适用场景与注意

适合已在 DSH 中使用 Agent Teams、希望在同一窗口内可视化团队状态并做任务级沟通的工作流场景。DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文介绍的插件同样为社区维护。

使用前请注意:

  • 插件以当前 DSH 进程权限运行,安装前建议阅读源码与 MIT LICENSE,人物素材授权见 THIRD_PARTY_NOTICES.md。
  • 自动测试(v0.2.0 含 249 项通过项)不能替代真实 DSH 上的写操作、完整动画观感或会话切换耗时验收。
  • 本地黑白界面整合版的变化与验证边界见 docs/MONOCHROME_IMPLEMENTATION.md。

结尾

dsh-cyber-dept 把 Agent Teams 收成会话右侧的像素办公室:工牌、看板与沟通在同一视图,写操作带确认,并针对隐藏面板与离屏场景做了同步与动画上的节制。若要在本机试用,按 README 构建后以 link: 挂到对应 profile 即可。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye