上下文环形图 GooodWei/context-vista

English · 中文

context-vista

Awesome DSH Plugin

一眼看清你的上下文窗口 —— token 用量、压缩收益、成本估算，尽收眼底。

为 DeepSeek Harness 提供 /context 斜杠命令，用环形图实时展示当前上下文 token 用量与分配。对话区右侧还常驻一张迷你悬浮卡，实时显示占用率与估算费用，可拖动、可收起。

安装

npx @deepseek-ai/dsh plugin --profile web add github:GooodWei/context-vista
npx @deepseek-ai/dsh web

需先安装 pnpm（dsh plugin add 内部会调用它）。已全局安装 dsh 时，npx @deepseek-ai/dsh 可简写为 dsh。

使用

输入 /context 回车，展示一张卡片：上下文组成环形图（系统 / 工具 / 消息 / 剩余）、占用进度条、会话累计与估算费用。

右侧的迷你环形图悬浮卡实时更新、无需输入命令；按住标题栏可上下拖动（位置自动记忆），点右上角箭头可收起/展开。悬浮卡底部还有「压缩上下文」按钮，点击即触发 /compact（效果等同输入命令），压缩进行中会显示「压缩中…」并禁用。

自定义定价

内置 DeepSeek 官方定价（人民币 ¥，含峰谷）。要覆盖或新增，编辑 ~/.dsh/settings.yaml（热加载，无需重启）。货币单位与峰谷定义都跟随 API（路由），每个路由可各自指定。

最简示例

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 }

完整示例（DeepSeek ¥ + OpenAI $，标注全部键值对）

context-vista:
pricing: # 定价表：外层键 = 路由名 或 baseURL "https://api.deepseek.com": # 路由①：DeepSeek，人民币 + 北京时间峰谷 currency: "¥" # 本 API 的计价货币单位（省略默认 "¥"） timezone: 8 # 峰谷时段所在时区（UTC 偏移；省略默认 8） peakWindows: # 高峰窗口，HH:MM，含起点不含终点；start > end 表示跨午夜
- start: "09:00" # 高峰起点 end: "12:00" # 高峰终点
- start: "14:00" # 第二段高峰起点 end: "18:00" # 第二段高峰终点 models: # 本 API 下的模型（必填） deepseek-v4-pro: # 模型名 peak: # 写法一（峰谷分档）· 高峰价 hit: 0.3 # 输入 · 命中缓存，每百万 tokens miss: 9 # 输入 · 未命中缓存，每百万 tokens output: 27 # 输出，每百万 tokens offpeak: # 空闲价 hit: 0.15 # 输入 · 命中缓存 miss: 4.5 # 输入 · 未命中缓存 output: 13.5 # 输出

"https://api.openai.com/v1": # 路由②：OpenAI（ChatGPT），美元 + 无峰谷 currency: "$" # 本 API 的计价货币单位 models: # 无 timezone/peakWindows → 直接走平坦价 "gpt-5.5": # 模型名 hit: 2.5 # 输入 · 命中缓存，每百万 tokens miss: 10 # 输入 · 未命中缓存，每百万 tokens output: 30 # 输出，每百万 tokens

价格为每百万 tokens 的单价，按各 API 实际币种填写；currency 只控制显示符号、不换算汇率；无峰谷的 API 省略 timezone / peakWindows 即可。上表数字仅示意。

- 外层键可用 provider 路由名（如 deepseek-official）或 baseURL（含 : 需加引号）。
- 每个路由可带 currency / timezone / peakWindows（各自覆盖全局默认），models 为必填。
- 模型价格条目二选一：平坦 { hit, miss, output }，或峰谷 { peak, offpeak }。
- 支持 * 作为路由名或模型名的通配符。
- 未匹配到的模型按内置默认（模型名含 flash 走 flash 档，否则 pro 档）。
- 金额仅为估算，非账单。

License

MIT