DeepSeek Harness 插件

dsh-experience-flywheel

dsh-experience-flywheel · DSH 经验飞轮插件 — agent cross-session experience memory + dual-acceptance gates (auto query/inject via agent/pre-step middleware; exit-1 gate scripts)(英文原文)

跳到安装方式

来源信息

GitHub 仓库
XZDYM/dsh-experience-flywheel
最近更新
2026年8月16日
分类
自动化与任务
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/XZDYM/dsh-experience-flywheel
插件名:dsh-experience-flywheel
作者:XZDYM

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-experience-flywheel · DSH 经验飞轮插件

> Give your DeepSeek Harness agent a cross-session "muscle memory": > it automatically queries past lessons before each step and injects hits, > automatically verifies claimed file writes, and wraps deterministic > exit-1 gate scripts (plan-gate / close-gate / verify-claims) as slash commands. > > 给 DeepSeek Harness agent 装上跨会话"经验肌肉记忆":每轮动手前自动查经验并注入命中, > 写完文件自动校核"声称写了"是否真写了,并把确定性的 exit-1 闸门脚本 > (plan-gate / close-gate / verify-claims)包成 slash 命令。 > > Status: v0.1.0 released — see [DESIGN.md](./DESIGN.md).

Why / 为什么造它

Pure-text LLM agents wake up fresh every session: yesterday's pitfalls, preferences, decisions are gone. This plugin turns "learn from experience" from "hope the model remembers" into server-side automation: the agent/pre-step middleware runs the experience query every turn without the model choosing to, the same seam dsh-repeat-tool-reminder already uses.

How / 怎么工作

  • ctx.on("agent/pre-step") → auto query store, inject top-K hits as a system message.
  • ctx.on("tools/post-execute") → after file-write tools, auto-run verify-claims.
  • Claims hygiene (F2/F3): per-agent claimed-write set is bounded — verified paths are

removed after a PASS, capped at maxClaimsPerAgent (default 50), and pruned by claimsTtlMs (default 24h), so long sessions never re-verify history forever. Claimed paths are extracted by tool-name whitelist + path-shape checks (extractClaimedPaths), so non-write tools (e.g. browser element refs) never trigger false-positive verifies.

  • Session-safety (F4): injected plugin messages carry a UUID message.id (local

createUserMessage factory mirroring @deepseek-ai/dsh-llm), because DSH session events of type user/message must satisfy assertMessageEventShape (data.message.id required, dsh-session lib/index.js:1248) — bare messages corrupt the whole session log.

  • Search quality (F1): markdown search is word-boundary aware — standalone tokens

(独立词) score 1.0, embedded-only matches (e.g. 经验 inside 经验库) are demoted to 0.3, so noisy substring hits rank below precise ones while recall is preserved.

  • slash commands /flywheel-search /flywheel-remember /plan-gate /close-gate /verify wrap exit-1 scripts.
  • Backend: local markdown folder by default (zero deps); set OPENVIKING_URL to upgrade to vector retrieval.
  • Honest limit (软硬): rc.6 event listeners that throw are warned, not fatal — a true

kernel-level "exit 1 prevents delivery" veto is not supported; the gate's exit 1 is injected as a hard blocking instruction + visible trajectory marker instead. See DESIGN §8.

Install / 安装

dsh plugin --profile web add github:<owner>/dsh-experience-flywheel

Then restart DSH web. GitHub topic: dsh-plugin.

Decoupled / 去私货

No OpenViking hard-binding, no hardcoded paths, no personal rules. The kernel is the flywheel protocol + gate contracts; your private AGENTS.md stays yours. An optional examples/agents.md.fragment is provided for users who want to wire the protocol into their own instructions.

License

MIT.