用量统计与提醒 my-dsh/oh-my-dsh

DeepSeek Harness

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。

它构建于一切皆插件的架构之上，由 Cordis 驱动，其设计参见论文 _A Programming Paradigm for Spatiotemporal Composability_。

文档：https://deepseek-harness.github.io/deepseek-harness/

在官方版本之上新增 —— 本仓库在标准 DeepSeek Harness 之外额外提供两项能力：Token 用量统计与会话提醒。

新增功能

本仓库在官方 DeepSeek Harness 之上新增了两项能力。

Token 用量统计

@deepseek-ai/dsh-token-usage 将每次模型调用的提供商用量落库到 SQLite，并按 (provider, model) 聚合成每日摘要——包括未命中缓存的输入、缓存读取、缓存写入、输出四类 token 用量，以及首 token 时延与耗时均值。内置 Web 仪表盘（packages/bundle/token-usage-dashboard）在 Web GUI 中展示这些跨会话统计。详见 token-usage 子系统文档。

Token 用量仪表盘：按提供方与模型分组的逐日跨会话统计

会话提醒

当某个后台会话正在等待用户（待审批 / 待计划审阅 / 待提问等 pendingInteraction，或已完成但尚未打开的 AI 回复）时，Web GUI 右上角会浮现一个浮动覆盖层。它会为标签页标题加上 (N) 前缀，并根据当前最高优先级的提醒种类播放四套不同的 Canvas2D 动画之一，让用户一眼分辨是哪种提醒。该插件在独立仓库 dsh-session-attention 中开发；安装方式见社区插件指南。

会话提醒覆盖层：提示有待用户处理的会话

开发者预览

DeepSeek Harness 处于 _开发者预览_ 阶段，正在快速迭代。未来将出现破坏兼容性的变更。

运行本项目前，请阅读安全说明。

运行

通过 npm 运行

安装 Node.js，然后运行：

npx @deepseek-ai/dsh web

该命令默认会在 http://127.0.0.1:3080 启动 Web UI，本机启动时还会用默认浏览器打开页面。通过 SSH 启动时只打印宿主机 URL，因为本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器。详见 Web UI 指南。

从源码运行

如需从仓库源码运行：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 会准备仓库产物。pnpm dsh web 会直接使用这些已构建产物，不会重新构建。

社区与支持

- 通过 GitHub Discussions 提交反馈或 bug 报告。
- 为你的插件仓库添加 dsh-plugin 话题，便于被发现。
- 欢迎加入 DeepSeek Harness 企微群：扫码添加企微小助手并填写入群问卷，完成后小助手会邀请你入群。

企微小助手入群问卷微信公众号

参与贡献

参见 CONTRIBUTING.md。

开发

请先阅读开发指南与架构文档。

pnpm run dev:web 会在一个终端里完成构建、启动，并在源码修改时重建 client bundle；make help 列出 Web 与 Desktop 对应的 Make target。完整表格见开发指南的「应用命令」一节。

面向 agent：请遵循 AGENTS.md。

引用

@misc{deepseek-harness2026,
title={DeepSeek Harness: Everything is a Plugin},
author={DeepSeek-AI},
year={2026},
publisher={GitHub},
howpublished=},
}

许可证

MIT

第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。