dsh-im-companion

<h1 align="center">dsh-im-companion

中文 · English

dsh-im-companion 以助理和家的概念增强dsh-im的使用体验。

你的 ⭐是我夜空中最亮的星。

Give every agent a home — IM Companion handles the rest.

<strong>👇 有助理的工作区，一目了然。</strong> <br><img src="assets/工作区-有助理的工作区一目了然-深色.png" width="300" alt="左栏工作区：全部、有助理、无助理，在线绿灯"> <strong>👇 额外增强DSH原生会话状态。</strong> <br><img src="assets/工作区增强-显示工作区红色状态-内部也有执行中的会话.png" width="300" alt="工作区红色竖条，组内有异常会话">

装它，1 分钟（先装 dsh-im，再装辅助）。

<h2 align="center">_INSTALL<br>安装</h2>

前置要求：DSH（DeepSeek Harness）+ dsh-im（IM 机器人本体）。

# 1 安装 DSH CLI（已装跳过）
npm install -g @deepseek-ai/dsh

# 2 先装本体 dsh-im（已装跳过，同样 --profile 必填）
dsh plugin --profile desktop add dsh-im
#     或者
dsh plugin --profile web add dsh-im

# 3 再装辅助（--profile 必填，装进实际使用的入口）
dsh plugin --profile desktop add dsh-im-companion
#     或者
dsh plugin --profile web add dsh-im-companion

# 锁定版本更稳（当前 0.2.25）
dsh plugin --profile desktop add [email protected] --registry https://registry.npmjs.org

装完刷新页面即生效。若面板没有出现，请完全退出 DSH 后重新打开。

把安装交给你的 AI

复制下面这段发给你的 AI：

请帮我安装 DeepSeek Harness 插件 dsh-im-companion（IM 辅助）。
先读仓库 README：https://github.com/FeatherHunter/dsh-im-companion
先确认我实际使用的 DSH 入口对应哪个 profile（桌面应用走 desktop，自启 web 服务走 web），
先确认 dsh-im 本体已装进同一个 profile（没装先装），再把辅助装进正确的 profile。

更新不生效时怎么装

下面以 desktop 为例，web 用户请把 --profile desktop 换成 --profile web：

dsh plugin --profile desktop add [email protected] --registry https://registry.npmjs.org
npx --yes @deepseek-ai/dsh plugin --profile desktop add dsh-im-companion
dsh plugin --profile desktop add dsh-im-companion@latest --registry https://registry.npmjs.org

升级 · 卸载：

dsh plugin --profile desktop update dsh-im-companion
dsh plugin --profile desktop remove dsh-im-companion

<h2 align="center">_WHY<br>为什么要做 IM 辅助</h2>

dsh-im 掌管接入，dsh-im-companion 以助理和家的概念增强能力。

家：哪个工作区有助理在管、在不在线，尽收眼底；搬家拖一下就行。

<strong>👇 点“有助理”，只看已安家的。</strong>

<h2 align="center">_{IN ACTION}<br>真机演示</h2>

<strong>👇 进设置 → IM机器人增强：助理、渠道、在线状态一屏看尽。</strong>

<strong>👇 切按渠道：同渠道助理排一排。</strong>

<strong>👇 点“添加接入”：选家后扫码即绑定。</strong>

<strong>👇 点开助理卡：模式、状态、各渠道增强开关一目了然。</strong>

<strong>👇 舰队雷达：Agent × 渠道矩阵，全舰队谁在线一眼看清。</strong>

<strong>👇 会话状态一目了然（DSH增强）。</strong>

<strong>👇 蓝条代表有会话在执行。</strong> <br><img src="assets/会话状态-工作区-执行中.png" width="330" alt="工作区蓝色竖条，组内有执行中会话"> <strong>👇 橙条代表有消息等你确认。点开后自动熄灭。</strong> <br><img src="assets/工作区增强-轻松看到待用户确认的消息.png" width="330" alt="工作区橙色竖条，有待确认消息">

<strong>👇 悬停看双通道 + 最后检测时间</strong> <br><img src="assets/工作区-Header浮层-当前助理状态-呼吸感.png" width="330" alt="悬停卡与在线徽标同框"> <strong>👇 浅色主题同样可用</strong> <br><img src="assets/工作区-有助理-浅色.png" width="330" alt="浅色左栏同样有徽标和过滤">

<strong>👇 点工具栏机器人脸图标，进搬家面板</strong>

<strong>👇 串门搬家：把照片拖到另一家，二次确认。绿灯在岗，黄灯打盹，灰灯睡着。</strong>

<strong>👇 卡片拖到另一家上空，目标家高亮</strong>

<strong>👇 搬家前二次确认</strong>

<h2 align="center">_FAQ<br>常见问题</h2>

更新之后还是旧版本？

这是桌面端的应用市场缓存策略导致的：刚发布的版本几小时内更新会静默跳过。等几小时再更新；等不及就显式指定官方源装一次：

dsh plugin --profile desktop add dsh-im-companion@latest --registry https://registry.npmjs.org

<h2 align="center">_MORE<br>作者的其他作品</h2>

dsh-opencode-palette —— 38 款 opencode 经典配色 + 20+自定义主题 一键换装 DSH

…