前言¶
在 DeepSeek Harness（DSH）里跑长对话时，上下文窗口会不断被系统提示、工具定义和消息历史占满。窗口快满时，往往只能靠体感判断要不要手动 /compact，也不清楚压缩前后各块 token 各占多少、这一轮会话大概花了多少钱。
Claude Code 有 /context 命令，能把上下文组成摊开给你看。DSH 生态里，context-vista 由维护者 GooodWei 发布，定位为客户端插件：提供 /context 斜杠命令，并在对话区右侧常驻一张可拖动的迷你悬浮卡，用环形图实时展示 token 用量、压缩收益与估算费用。
这是什么¶
context-vista 是为 DeepSeek Harness 编写的 DSH 插件，分类为客户端。它解决的核心问题是：在长会话中，让你随时看到上下文窗口的占用结构与估算成本，而不必翻日志或自己心算。
插件当前版本为 0.1.0，采用 MIT 许可证，在 GitHub 上开源（截至资料抓取时约 12 stars）。SkillHub 目录页：https://www.skillhub.cn/plugins/GooodWei/context-vista。
核心功能¶
下面按 README 已写明的能力逐项说明。
/context 斜杠命令¶
在 DSH Web 客户端输入 /context 并回车，会展示一张卡片，内容包括：
- 上下文组成环形图：系统、工具、消息、剩余空间
- 占用进度条
- 会话累计用量与估算费用
右侧悬浮卡¶
对话区右侧有一张迷你环形图悬浮卡，无需输入命令即可实时更新。按住标题栏可上下拖动，位置会自动记忆；点右上角箭头可收起或展开。
悬浮卡底部有「压缩上下文」按钮，点击即触发 /compact，效果与手动输入该命令相同。压缩进行中会显示「压缩中…」，按钮在此期间禁用。
费用估算与自定义定价¶
插件内置 DeepSeek 官方定价（人民币 ¥，含峰谷时段）。金额仅为估算，不代表实际账单。
要覆盖或新增定价，可编辑 ~/.dsh/settings.yaml，修改后热加载，无需重启 DSH。货币单位与峰谷定义跟随 API 路由，每个路由可各自指定。
安装与启用¶
安装前需本机已有 pnpm（dsh plugin add 内部会调用它）。若已全局安装 dsh，下面命令里的 npx @deepseek-ai/dsh 可简写为 dsh。
npx @deepseek-ai/dsh plugin --profile web add github:GooodWei/context-vista
npx @deepseek-ai/dsh web
第一条命令把插件加入 Web 配置；第二条启动 DSH Web 客户端。
典型用法¶
查看上下文组成¶
启动 DSH Web 后，在输入框输入：
/context
回车即可打开环形图卡片，对照系统、工具、消息各块占比，判断是否需要压缩。
从悬浮卡触发压缩¶
当右侧悬浮卡显示占用率偏高时，直接点底部「压缩上下文」。插件会调用 /compact，压缩期间按钮显示「压缩中…」并禁用，避免重复触发。
自定义定价（最简示例）¶
在 ~/.dsh/settings.yaml 中为某个 API 路由写入模型单价（每百万 tokens）：
context-vista:
pricing:
"https://api.deepseek.com":
models:
deepseek-v4-pro:
peak: { hit: 0.3, miss: 9, output: 27 }
offpeak: { hit: 0.15, miss: 4.5, output: 13.5 }
外层键可用 provider 路由名或 baseURL；模型价格可写平坦价 { hit, miss, output }，或峰谷分档 { peak, offpeak }。未匹配到的模型按内置默认处理（模型名含 flash 走 flash 档，否则 pro 档）。支持 * 作为路由名或模型名的通配符。
适用场景与注意¶
适合谁
- 经常在 DSH Web 里跑长对话、需要盯上下文窗口占用的开发者
- 想对照 Claude Code
/context体验、在 DSH 里做同类可视化的用户 - 需要按路由和模型粗略估算会话费用的场景
使用前注意
DSH 的理念是「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，安装前请自行查看源码与许可证。
插件以当前 dsh 进程权限运行。费用数字来自配置与内置默认定价，仅供参考；多路由、多模型并存时，建议在 settings.yaml 里把常用路由写全，避免估算偏差。
结尾¶
context-vista 把上下文窗口的 token 分配、压缩入口和费用估算集中到 /context 命令与右侧悬浮卡里，适合在 DSH Web 长会话中持续观察窗口占用。目录页：https://www.skillhub.cn/plugins/GooodWei/context-vista；源码与完整配置说明：https://github.com/GooodWei/context-vista。
