DeepSeek HarnessHub
提交插件

gjnzsu/dsh-companion ↗★ 0

dsh-companion

A friendly status and context-pressure companion for DeepSeek Harness Web

Agent 协作开发工具
包名
dsh-companion
版本
0.1.1
许可证
MIT
最近更新
2026年8月17日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:gjnzsu/dsh-companion

说明文档

阅读完整 README ↗

DSH Companion

English | 简体中文

一个运行在 DeepSeek Harness Web 中的轻量 Agent Companion。它把当前会话的活动状态、上下文压力和用量信息，变成一个可以快速扫一眼就理解的 Living Data Orb。

状态优先，用量按需；友好，但不打扰。

DSH Companion 合成状态矩阵

上图是由生产组件和合成状态生成的视觉回归基线，覆盖无会话、空闲、工作、等待、上下文提醒、上下文警告和任务完成反馈。

一分钟了解它

DSH Companion 同时表达两个互相独立的信号：

  1. 活动状态：Agent 正在休眠、空闲、工作，还是等待你响应。
  2. 上下文压力：预计下一次请求会占用多少模型上下文窗口。

点击或悬停宠物后，才会进一步显示 Context、Billed input、Output、Cache hit 和 Steps。这样日常工作时只需要看状态，需要诊断时才查看数字。

视觉层回答的问题表现方式
表情与状态标签Agent 正在做什么？Sleeping、Idle、Working、Waiting、Done
压力环与文字标签上下文是否需要关注？Normal、Attention、Warning、Unknown
用量面板当前会话用了多少资源？只展示 DSH 已提供的可用指标

设计理念

状态优先，用量按需

默认界面只传达活动状态和上下文压力。详细数字不会持续占据注意力，只有在悬停、键盘聚焦或点击固定面板时出现。

安静陪伴，而非打扰

宠物可以表达工作、等待和完成，但不会闪烁、拦截整个页面或要求持续阅读。用户可以拖动它，也可以折叠成屏幕边缘的恢复标签。

友好，但不游戏化

Living Data Orb 使用表情和轻量动效帮助理解状态；MVP 不包含喂养、升级、奖励、皮肤、留存任务或多宠物系统。

对数据保持诚实

缺少 projection 时，指标会保持 Unknown 或直接省略。插件不会把未知数据显示为 0，也不会估算价格、余额或流式 token。

原生融入 DSH

插件通过 shell.overlay 以附加方式挂载，跟随当前选中的 session，读取 DSH 已有 projections，并遵循宿主的生命周期、语义样式和无障碍模式。

观察型、隐私优先

插件不会修改 prompt、tool、模型请求或 session event。它不读取对话内容、推理内容、工具输入输出、文件、凭证或供应商账户，也没有遥测和远程服务。

工作原理

flowchart LR
    DSH["DeepSeek Harness"] -->|"selected SessionSummary"| Adapter["DSH client adapter"]
    Adapter -->|"status + numeric projections"| Derive["Pure state derivation"]
    Derive --> ViewModel["CompanionViewModel"]
    ViewModel --> Orb["Living Data Orb"]
    ViewModel --> Panel["Usage panel"]
    Preferences["Browser-local position and collapse state"] --> Orb

DSH 负责维护事件日志和 projections。Companion 从 Web 客户端已经提供的当前 session summary 开始工作，不扫描事件日志，不轮询后端，也不重新实现上游统计逻辑。

更详细的设计资料：

状态说明

活动状态

状态含义
Sleeping当前还没有选中的 session
Idle当前 session 已准备好，没有正在执行
WorkingAgent 正在执行任务
WaitingAgent 正在等待问题、审批或其他用户交互
Celebration / Done同一个 session 从 Working 进入 Idle 后的短暂完成反馈

Waiting 的优先级高于 Working，因为需要用户响应通常是更重要的信息。

上下文压力

等级预计占用率含义
Unknown无法可靠计算projection 缺失或数据无效
Normal=24.0.0 和 pnpm 11.15.1。
pnpm install --frozen-lockfile
pnpm test
pnpm typecheck
pnpm build
pnpm gallery
pnpm test:visual
pnpm pack:check

针对 Harness 源码运行无 API Key 的真实 Web smoke：

$env:DSH_REPO='C:\SourceCode\deepseek-harness'
pnpm test:smoke

测试体系分为两层：

  • 合成状态测试负责覆盖状态、压力边界、视觉主题、窄屏、reduced motion 和交互组合。
  • 真实 Web smoke负责证明打包后的插件能安装进 DSH，并跟随真实选中 session 更新。

MVP 限制

0.1.0 只支持 DSH Web 和当前选中的 session。它暂不提供流式 token 估算、价格或成本、历史趋势、成长系统、多宠物、prompt/tool 内容分析或云同步。

License

MIT