PerryLink/dsh-fast

⚡ dsh-fast

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

DeepSeek Harness 的只读性能诊断插件。

观察会话事件流——绝不触碰模型热路径——并报告延迟与上下文预算究竟花在哪里。

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

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

---

⭐ 如果它帮到了你

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

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

Compatibility

• DeepSeek Harness dsh-v0.1.7-rc.2（2026-09-18 已适配）：会话表面改经可选的 sessionQuery 服务读取——已弃用的同步 Session.eventAt(seq) 访问器退役，改由等价的同步回退读兜底；所有注册收进同一个 lifecycle effect 并按逆序释放。属内部实现变更：同一日志下上报指标逐字相同。已于 2026-09-24 核验本地门控链（双 typecheck 尺子 + 70 项测试）；compat workflow 用已发布钉号重跑 profile 安装冒烟。
• Node ^22.19.0 || >=24.0.0，纯 ESM（"type": "module"）。
• peer 依赖：@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；devDependencies 钉 0.1.7-rc.2）；0.1.2-rc.1 旧线仍通过结构式回退读取 pre-0.1.5 的 header.system 在运行时受支持。

What you get

• 会话加载耗时 —— 发布到首次请求的延迟，按 open（全新）/restore（带 seed/恢复）分类，并给出恢复时的 seed 事件数。
• spill 命中统计 —— 有多少工具结果被溢出到会话级工件（从持久化的 spill 提示标记检测）。
• compaction 次数与触发原因 —— 总次数，按 manual（斜杠命令）/automatic（压力）区分，以及总 shadow token 数。
• 上下文注入体量 —— 系统提示词（AGENTS.md + 技能 + 人设）、工具 schema、会话表面的 token 数及其占比；其中“会话表面”只含对话历史（0.1.5-alpha.1 的 meter surface 含系统节点，dsh-fast 已扣除）。
• LLM 缓存命中率 —— 由 provider usage 聚合的 input / cache-read / cache-write / output token 与命中率。
• 优化建议 —— 阈值驱动的建议（精简技能、收紧工具 schema、更早压缩、启用提示词缓存、启用 spill-policy 等）。
• 异步采样 —— 每个事件 O(1) 折叠，定时器采样，绝不在追加路径上执行。

Quick start

git 通道

# 在临时 profile 上（钉住 commit；运行自包含的 `prepare` 构建）
dsh plugin --profile demo add "github:YOUR_ORG/dsh-fast#<sha>"
# 首次 add 后，profile 的 pnpm-workspace.yaml 会新增针对 dsh-fast 的 allowBuilds 项。

npm 通道

dsh plugin --profile demo add dsh-fast

两条通道都会把 bundle 行（见 cordis.patch.yml）装进 profile 的 dsh.profile.bundles 栈，重启后生效。

Install & uninstall

dsh plugin --profile demo add dsh-fast       # 安装
dsh plugin --profile demo remove dsh-fast    # 卸载

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

Configuration

所有可调参数都是 Schemastery Config 字段；非法值会在 profile 加载时响亮失败。

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	会话表面超过该 token 数时告警。
thresholds.cacheHitRateFloor	0.1	缓存命中率低于该值（0..1）时告警。
thresholds.compactionCountWarn	10	触发这么多 compaction 后告警。
thresholds.compactionShadowTokens	40000	每次 summary 平均 shadow token 超过该值时告警。
spill.detectSpilledResults	true	从持久化提示标记检测被溢出的工具结果。

Tools & surfaces

• /fast —— 人类斜杠命令，打印当前会话的健康报告：加载耗时、spill、compaction、上下文体量排名、缓存命中率与建议。
• fast_report —— 模型工具，以结构化 JSON 返回同一份报告（供模型推理），并带人类可读的文本渲染。

Permissions & data

dsh-fast 只消费公开接缝：session/* 与 agent/* 事件、可选的 ctx.tokenMeter、ctx.storageDomain、ctx.commands 与 ctx.tools。它对会话日志严格只读——绝不改动模型请求、工具结果或会话表面。度量持久化到 dsh_fast 存储域（每会话一段有界历史），不写会话日志。报告身份与可选的工作目录在任何展示或持久化写入前都会脱敏。

Security boundaries

• 只读、零模型路径开销 —— 每个事件 O(1) 折叠，定时器采样。
• 无网络、无凭据处理 —— 插件不发任何出站请求，也不存储敏感信息。
• 配置响亮失败 —— 每个可调参数在挂载时校验；非法边界抛错。
• 展示/持久化数据脱敏 —— 剥离控制字符、限制字符串长度；cwd 默认关闭，开启时按路径截断。
• 注册可逆 —— 一切贡献都经 ctx.effect() / ctx.on() / register()，卸载与热重载干净。

Known limitations

• 用存储域而非会话事件 —— rc.2 的 Session.append 没有 ignorable 标记能力，也没有外部事件注册面，写自定义 fast/* 会话事件会让持久化协调器在恢复时拒绝日志。因此度量改为持久化到存储域；原始事件仍是可重建的事实来源。
• spill 检测是启发式 —— 读取持久化的 spill 提示（Full … stored at:）；没有专门的会话事件。
• 系统提示词是单个桶 —— AGENTS.md、技能目录与人设都属于组装后的系统提示词；自 0.1.5-alpha.1 起它是 surface 节点 0（system/message），本身不携带分段 token 统计，因此合并上报。
• 加载耗时从发布时刻起算 —— 恢复时的磁盘读取发生在 session/created 之前（由 sessionPersistence 负责），本插件允许的事件观察不到；上报的时长是发布到首次请求的延迟。
• 降级路径只播报一次 —— 无 tokenMeter 的宿主回退到启发式 token 计价，无 systemPrompt 的宿主把整段提示词并入一个桶，inspector 出口失败则被忽略；这三者现在各在每进程播报一次，而不是静默改变数字的含义。

Development

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

Topics

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

Contributors

感谢所有为 dsh-fast 做出贡献的人：

• PerryLink —— 作者与维护者：设计并实现了只读诊断（会话加载耗时、spill 命中统计、compaction 指标、上下文注入体量、LLM 缓存命中率）、/fast 命令与 fast_report 工具、dsh_fast 存储域以及五语文档。

PerryLink DSH Plugin Family

This project is one of the 45 DeepSeek Harness plugins maintained by PerryLink. If this one helps you, the others likely will too:

Plugin	One-liner
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here)
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.
dsh-fast	Read-only performance diagnostics for DeepSeek Harness.
dsh-fund-research	Deterministic research reports for Chinese public mutual funds
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-industry-research	Industry research orchestration that seals its deliverables through this plugin's ctx.researchReport.assemble
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools
dsh-library	Local document knowledge base for DeepSeek Harness.
dsh-local-ai	Local-model (Ollama) integration for DeepSeek Harness.
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-observe	OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-upgrade	One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card
dsh-plugin-upgrade-015	Merged 0.1.3-alpha.1 → 0.1.5-rc.1 upgrade corridor card plus a zero-dependency seam scanner
dsh-reach	Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console
dsh-research-report	Verifiable research-report engine: content-addressed evidence ledger and sealed versions
dsh-score	Multi-dimensional quality scoring for DeepSeek Harness plugins.
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering
dsh-session-sync	Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-talk	Voice-first session loop for DeepSeek Harness: talk to it, hear it answer.
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline
dsh-test-drive	Isolated install-and-smoke test drives for DeepSeek Harness plugins.
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel + 11 tools
dsh-translate	Vendor parameter translation and deterministic JSON repair for DeepSeek Harness.

License

Apache-2.0 —— 见 LICENSE。

从 DSH Desktop 市场安装

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