性能诊断仪PerryLink/dsh-fast

⚡ dsh-fast
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-fast（会计入 deepseek1024.com 的安装排名）。
Gitee

DeepSeek Harness 的只读性能诊断工具。

观察会话事件流——绝不触碰模型热路径——并报告延迟和上下文预算实际消耗在哪里。

官方仓库。 这是 dsh-fast 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库均与本项目无关。

License
DSH plugin
dsh-doctor
Node
CI
Version
npm version
npm downloads

English · 简体中文 · Español · Português · हिन्दी

兼容性

- DeepSeek Harness dsh-v0.1.5-rc.1（适配于 2026-09-09；公开标签提交 183f08e9c6）：系统提示词是表面节点 0（一个 system/message），而非请求信封字段，因此报告从表面读取它，并在计量器的表面净值中扣除它。已于 2026-09-10 使用已发布的 0.1.5-rc.1 对等依赖验证（完整本地门禁链）；每月兼容性工作流会针对相同的固定版本重新运行 profile 安装冒烟测试。
- Node ^22.19.0 || >=24.0.0，仅支持 ESM（"type": "module"）。
- 对等依赖：@deepseek-ai/cordis ^4.0.2、@deepseek-ai/schemastery ^3.18.2，以及 @deepseek-ai/dsh-session、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-commands、@deepseek-ai/dsh-compaction、@deepseek-ai/dsh-storage-domain，版本为 >=0.1.2-rc.1 =0.1.5-alpha.1 "
The profile's pnpm-workspace.yaml gains an allowBuilds entry for dsh-fast on first add.

npm 渠道
sh
dsh plugin --profile demo add dsh-fast

两个渠道都会将 bundle 行（见 cordis.patch.yml）安装到配置文件的 dsh.profile.bundles 栈中，并在重启后生效。

安装与卸载
sh
dsh plugin --profile demo add dsh-fast       # install
dsh plugin --profile demo remove dsh-fast    # uninstall

验证该行已挂载：dsh --profile demo --dump-config | grep dsh-fast。

配置

所有可调项均为 Schemastery Config 字段；无效值会导致配置文件加载时大声报错。

| Key | Default | Description |
| --- | --- | --- |
| enabled | true | 主开关；false 时不挂载任何内容。 |
| privacy.includeCwd | false | 在报告中包含经过脱敏的会话工作目录。 |
| sampling.snapshotIntervalMs | 60000 | 对活跃会话进行采样的频率（毫秒）。 |
| sampling.maxHistorySamples | 20 | 每个会话在持久历史中保留的样本数。 |
| thresholds.systemPromptTokens | 20000 | 当系统提示超过此 token 数时发出警告。 |
| thresholds.toolSchemaTokens | 8000 | 当工具 schema 超过此 token 数时发出警告。 |
| thresholds.surfaceTokens | 60000 | 当对话 surface 超过此 token 数时发出警告。 |
| thresholds.cacheHitRateFloor | 0.1 | 当缓存命中率低于此值（0..1）时发出警告。 |
| thresholds.compactionCountWarn | 10 | 当触发压缩达到此次数时发出一次警告。 |
| thresholds.compactionShadowTokens | 40000 | 当每个摘要的平均遮蔽 token 数超过此值时发出警告。 |
| spill.detectSpilledResults | true | 从持久通知标记中检测溢出的工具结果。 |

工具与 surface
- /fast — 一个人类斜杠命令，用于打印当前会话的健康报告：加载耗时、溢出、压缩、上下文容量排名、缓存命中率以及建议。
- fast_report — 一个模型工具，以结构化 JSON 返回相同的报告（以便模型可以对其推理），并附带人类可读的文本渲染。

权限与数据

dsh-fast 仅使用公开接缝：session/ 和 agent/ 事件、可选的 ctx.tokenMeter、ctx.storageDomain、ctx.commands 和 ctx.tools。它对会话日志严格只读——从不修改模型请求、工具结果或会话表面。指标持久化到 dsh_fast 存储域（每个会话一份有界历史），而非会话日志。报告标识和可选的工作目录在任何显示或持久写入之前都会被脱敏处理。

安全边界

- 只读，零模型路径开销 — 折叠为每个事件 O(1)；采样按定时器运行。
- 无网络，无凭据处理 — 该插件不发起任何出站请求，也不存储任何敏感信息。
- 配置失败即报错 — 每个可调参数在挂载时都会校验；无效边界会抛出异常。
- 显示/持久数据已脱敏 — 控制字符会被剥离，字符串有预算限制；cwd 默认关闭，启用时会截断路径。
- 可逆注册 — 每一项贡献都通过 ctx.effect() / ctx.on() / register() 进行，因此卸载和热重载都是干净的。

已知限制

- 存储域，而非会话事件 — rc.2 的 Session.append 不提供 ignorable 标记，也没有外部事件注册接口，因此自定义的 fast/* 会话事件会导致持久化协调器在恢复时拒绝该日志。因此指标被持久化到存储域；原始事件仍是可重建的事实来源。
- 溢出检测是启发式的 — 它读取持久溢出通知（Full … stored at:）；不存在专用的会话事件。
- 系统提示词是一个桶 — AGENTS.md、技能目录和角色设定都属于组装后的系统提示词；自 0.1.5-alpha.1 起，它是表面节点 0（一个 system/message），不携带按分段的 token 核算，因此它们被一起报告。
- 加载耗时从发布时开始 — 恢复过程中的磁盘读取部分发生在 session/created 之前（由 sessionPersistence 拥有），无法从该插件被允许的事件中观察到；报告的时长是从发布到首次请求。

开发
sh
pnpm install
pnpm run typecheck && pnpm run typecheck:ci
pnpm test
pnpm run build
pnpm run verify:self-contained && pnpm run verify:artifacts
node scripts/check-readme-sync.mjs
pnpm pack

主题

dsh、dsh-plugin、deepseek-harness、deepseek、cordis、performance、diagnostics、profiling、context-engineering、llm-cache

贡献者

感谢所有为 dsh-fast 做出贡献的人：
- PerryLink — 作者兼维护者：设计并构建了只读诊断功能（会话加载耗时、溢写命中次数、压缩指标、上下文注入量、LLM 缓存命中率）、/fast 命令与 fast_report 工具、dsh_fast 存储域，以及五种语言的文档。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 37 个 DeepSeek Harness 插件之一。如果这个插件对你有帮助，其他的很可能也会：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认故障关闭 | |
| dsh-background-agents | 持久化后台子代理，带 Web UI 侧边栏、消息传递与中断 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排与延迟集于一个面板。 | |
| dsh-checkpoint-rewind | 等同于 Claude Code 的 /rewind：快照、会话分叉、一键恢复 | |
| dsh-claude-move | 将 Claude Code 的会话、记忆、技能和 CLAUDE.md 迁移到 DSH | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 编辑器的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查与引用交叉核验（此处消费的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱与密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入均需审批 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 通过语言服务器提供 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置标签页，显示状态、工具和错误 | |
| dsh-memento | 需审批的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 和 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 与 Claude Code outputStyles 等价的运行时样式切换 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） | |
| dsh-plugin-guide | 以按需智能体技能形式提供的插件开发知识库 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本和密封版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | 面向 DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖和供应链审查 | |
| dsh-talk | 面向 DeepSeek Harness 的语音优先会话循环：对它说话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试驱动。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 | |
| dsh-translate | 面向 DeepSeek Harness 的供应商参数转换和确定性 JSON 修复。 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 |
从 DSH 桌面市场安装

所有 PerryLink 插件均可在内置的 DSH 桌面市场中浏览：市场 → 源 → 添加源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选择它。安装仍需经过市场的 npm 身份验证和你的确认。

许可证

Apache-2.0 — 参见 LICENSE。