性能诊断仪 PerryLink/dsh-fast

⚡ dsh-fast

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

dshfind

DeepSeek Harness 的只读性能诊断。

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

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

dsh-doctor
DSH Market

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

dsh plugin --profile <name> add dsh-fast

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

dsh plugin --profile demo add dsh-fast # install
dsh plugin --profile demo remove dsh-fast # uninstall

确认条目已挂载：dsh --profile demo --dump-config | grep dsh-fast。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-fast 是什么？

DeepSeek Harness 的只读性能诊断。

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

dsh-fast 的工作流示意图：请求 → 策略 / 审查 → 判定。

工作流概览：请求 → 策略 / 审查 → 判定。下面的示例使用真实的命令接口。

兼容性

- DeepSeek Harness dsh-v0.2.1-alpha.1（适配于 2026-09-18）：会话接口通过可选的 sessionQuery 服务读取——已废弃的同步访问器 Session.eventAt(seq) 被移除，回退方案是等价的同步读取——所有注册现在都放在一个生命周期 effect 里，按相反顺序释放。内部实现有变：同一份日志，上报的指标完全一致。2026-10-04 已针对本地门禁链验证（三道类型检查关卡 + 71 个测试）；compat 工作流会针对已发布的版本锁定重跑配置档安装冒烟测试。
- Node ^22.19.0 || >=24.0.0，仅支持 ESM（"type": "module"）。
- 对等依赖：@deepseek-ai/cordis ^4.0.2、@deepseek-ai/schemastery ^3.18.4，以及 @deepseek-ai/dsh-session、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-commands、@deepseek-ai/dsh-compaction、@deepseek-ai/dsh-session-query、@deepseek-ai/dsh-storage-domain，版本范围 >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0（devDependencies 锁定 0.2.0-rc.2）；0.1.2-rc.1 这条线在运行时仍受支持，通过结构化回退到 0.1.5 之前的 header.system。

你能得到什么

- 会话加载耗时——从发布到首次请求的延迟，按 open（全新）与 restore（预置/恢复）分类，外加恢复的种子事件数。
- 溢出命中统计——有多少工具结果被溢出到会话级产物（从持久化的溢出通知中识别）。
- 压缩次数与触发方式——压缩总数，拆分为 manual（斜杠命令）与 automatic（压力触发），以及被遮蔽的 token 总量。
- 上下文注入量——系统提示词（AGENTS.md + 技能 + 人设）、工具 schema、界面各自的 token 数及其占总量的比例；界面这一桶只含对话历史（在 0.1.5-alpha.1 上计量器的界面包含系统节点，dsh-fast 会把它减掉）。
- LLM 缓存命中率——从服务商用量汇总的输入 / 缓存读 / 缓存写 / 输出 token，以及推导出的命中率。
- 优化建议——阈值驱动的提示（精简技能、收紧工具 schema、更早压缩、启用提示词缓存、启用溢出策略……）。
- 异步采样——每个事件 O(1) 折叠指标，定时快照，绝不在追加路径上做。

快速开始

dsh plugin --profile web add github:PerryLink/dsh-fast

git 渠道

From a scratch profile (pins the commit; runs the self-contained prepare build)sh
dsh plugin --profile demo add "github:YOUR_ORG/dsh-fast#<sha>"

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 栈，重启后生效。

/fast 命名空间冲突

/fast 是宿主命令。如果另一个插件也注册了名为 fast 的客户端 commandUi 贡献，宿主命令菜单可能丢掉整个 / 来源。这个冲突出在宿主的客户端命令命名空间里，本插件无法在运行时改名。绕开办法：禁用或重命名另一个插件的 fast 客户端命令，或者删掉其中一个插件。只要没有重复的客户端贡献，/fast 本身和 fast_report 都照常工作。

示例

下面是插件真实的入口；装一次，然后调用其中一个。

详细示例

命令

~~~sh
/fast

输出

~~~text
dsh-fast 0.1.0 — performance report session: abc

Session load
kind: open
seed events: 0
time to first request: 150 ms

Spill
detected spilled results: 0 (heuristic)

Compaction
count: 0 (manual: 0, automatic: 0)
shadowed tokens: 0

Context volume
total: 1000 tokens
system (AGENTS.md/skills/persona): 400 (40%)
tool schema: 200 (20%)
surface: 400 (40%)

System prompt breakdown
persona: 100 tokens / 400 chars (25%)
skills: 0 tokens / 0 chars (0%)
AGENTS.md: 0 tokens / 0 chars (0%)
other (harness identity + tool guidance): 300 tokens / 1200 chars (75%)

LLM cache
input: 800, cache read: 200, cache write: 50, output: 100
hit rate: 20%

Suggestions
- none

观察自 plugins/dsh-fast/src/analyze.ts:88-131；基线 fixture 见 test/analyze.spec.ts:12-35, 82-100

失败分支

输入

~~~text
/fast --history nope

输出

~~~text
Usage: /fast [--history [n]]

观察自 plugins/dsh-fast/src/index.ts:241-245

简要示例

- fast_report

配置

所有可调项都是 Schemastery 的 Config 字段；值不合法会让配置档加载直接报错。

| 键 | 默认值 | 说明 |
| enabled | true | 总开关；设为 false 不挂载任何东西。 |
| privacy.includeCwd | false | 在报告里带上脱敏后的会话工作目录。 |
| sampling.snapshotIntervalMs | 60000 | 活跃会话的采样间隔（ms）。 |
| 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 | 根据持久化通知标记检测溢出的工具结果。 |

工具与界面

- /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 负责），从本插件允许的事件里观察不到；上报的时长是发布到首次请求。
- 降级只提示一次 —— 宿主没有 tokenMeter 时，回退到启发式 token 计价；宿主没有 systemPrompt 时，把整段提示词归入同一个桶；inspector 出口报错时直接忽略。这些情况现在每个进程只提示一次，不再悄悄改变数字的含义。

开发 sh
pnpm install
pnpm run typecheck && pnpm run typecheck:ci && pnpm run typecheck:checkout
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 的 DeepSeek Harness 插件家族。下方名册默认折叠，让每个 README 的首屏都保持简短；展开即可查看每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 —— 见仓库 README |
| dsh-claude-move | 🧊 已冻结 —— 见仓库 README |
| dsh-defend | 🧊 已冻结 —— 见仓库 README |
| dsh-draw | 🧊 已冻结 —— 见仓库 README |
| dsh-reach | 🧊 已冻结 —— 见仓库 README |
| dsh-background-agents | 🚫 已退役 —— 见仓库 README |
| dsh-session-pin | 🚫 已停用 — 见仓库 README |
| dsh-team-rooms | 🚫 已停用 — 见仓库 README |

License

Apache-2.0 — 见 LICENSE。