dsh-fast：AI Agent 工具实践指南

准备试用dsh-fast之前，先别急着安装；这个项目提供的是DeepSeek Harness 的只读性能诊断：会话 load/restore 计时、溢出命中计数、压缩计数和触发器、上下文注入量（等相关能力。在日常自动化场景里，常见问题是输入边界、依赖和失败处理如果不清楚就很难稳定复用，这正是评估时需要盯住的地方。试跑可以从用一项范围明确的真实任务完成最小试跑开始，并把配置时间、输出质量、异常信息和维护痕迹写进验收记录。整体来看，它适合愿意先做小范围验证并复查原始文档的团队拿来做对照测试，最终决定仍应回到真实结果和维护状态。

⭐ 如果它帮到了你

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

英语： DeepSeek Harness 40 多个插件系列的一部分。如果它有用，一颗星星可以帮助下一个人找到它 - 它后面没有任何东西。

Compatibility

• DeepSeek Harness dsh-v0.2.1-alpha.1（于 2026 年 9 月 18 日调整）：通过可选的 sessionQuery 服务读取会话表面 — 已弃用的同步 Session.eventAt(seq) 访问器已消失，并以等效的同步读取作为后备 — 并且每个注册现在都存在于一个生命周期效果中，该效果会在相反的顺序。内部实施更改：同一日志的报告指标相同。 2026 年 10 月 4 日根据本地门链进行验证（三个类型检查标尺 + 71 次测试）； compat 工作流程针对已发布的引脚重新运行配置文件安装烟雾。
• Node ^22.19.0 || >=24.0.0, ESM only ("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-rc.1 <0.3.0-0 (devDependencies pin 0.2.0-rc.2); the 0.1.2-rc.1 line stays supported at runtime through a structural fallback to the pre-0.1.5 header.system.

What you get

• 会话加载计时 — 发布到首次请求的延迟，分类为 open（新鲜）与 restore (seeded/resumed)，加上恢复的种子事件计数。
• 溢出命中统计数据 — 有多少工具结果溢出到会话范围的工件（从持久溢出通知中检测到）。
• 压缩计数和触发 — 总压缩、拆分 manual（斜杠命令）与 automatic（压力）以及总影子令牌。
• 上下文注入量 — 系统提示（AGENTS.md + 技能 + 角色）、工具模式和表面代币及其占总数的份额；表面存储桶仅是对话历史记录（仪表的表面包括 0.1.5-alpha.1 上的系统节点，dsh-fast 将其减去）。
• LLM 缓存命中率 — 根据提供程序使用情况聚合的输入/缓存读取/缓存写入/输出令牌，加上派生的命中率。
• 优化建议 - 阈值驱动的注释（修剪技能、收紧工具架构、提前压缩、启用提示缓存、启用溢出策略……）。
• 异步采样 - 每个事件的指标都会折叠 O(1) 并在计时器上快照，而不是在附加路径上。

Quick start

git channel

# From a scratch profile (pins the commit; runs the self-contained `prepare` build)
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 channel

dsh plugin --profile demo add dsh-fast

两个通道都会将捆绑行（请参阅 cordis.patch.yml）安装到配置文件的 dsh.profile.bundles 堆栈中，并在重新启动时生效。

Install & uninstall

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

Verify the row mounts: dsh --profile demo --dump-config | grep dsh-fast.

Configuration

所有可调参数均为 Schemastery Config 字段；无效值会导致配置文件加载失败。

Tools & surfaces

• /fast — 一个人类斜杠命令，用于打印当前会话的运行状况报告：加载时间、溢出、压缩、上下文卷排名、缓存命中率和建议。
• fast_report — 模型工具返回与结构化 JSON 相同的报告（以便模型可以对其进行推理），并具有人类可读的文本渲染。

Permissions & data

dsh-fast 仅消耗公共接缝：session/* 和 agent/* 事件、可选的 ctx.tokenMeter、ctx.storageDomain、ctx.commands 和 ctx.tools。它在会话日志中是严格只读的——它永远不会改变模型请求、工具结果或会话表面。指标将持久保存到 dsh_fast 存储域（每个会话一个有限历史记录），而不是会话日志。在任何显示或持久写入之前，都会对报告标识和可选工作目录进行清理。

安全边界

• 只读，零模型路径开销 - 每个事件的折叠时间为 O(1)；采样在计时器上运行。
• 没有网络，没有凭据处理 - 该插件不会发出出站请求，也不会存储任何敏感内容。
• 失败大声配置 — 每个可调参数在安装时都经过验证；无效边界投掷。
• 净化的 display/durable 数据 - 控制字符被剥离，字符串被预算； 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）并且不携带每节令牌记帐，因此它们一起报告。
• 加载计时从发布时开始 - 恢复的磁盘读取部分发生在 session/created（由 sessionPersistence 所有）之前，并且从该插件允许的事件中无法观察到；报告的持续时间是发布到首次请求的持续时间。
• 降级被宣布一次 - 没有 tokenMeter 的主机回退到启发式令牌定价，没有 systemPrompt 的主机将整个提示归因于一个存储桶，并且忽略失败的 inspector 插座；现在，每个进程都会这样说一次，而不是默默地改变数字的含义。

发展

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

PerryLink DSH 插件系列

该项目是由 PerryLink 维护的 45 个 DeepSeek Harness 插件之一。如果这对您有帮助，其他人也可能会：

从 DSH 桌面市场安装

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