English | 中文

dsh-explorer-agent

Unofficial community plugin, independently maintained and not affiliated with DeepSeek.

A reusable read-only directory Explorer Agent for DeepSeek Harness.

The plugin registers the explorer tool. A calling agent supplies one or more directories and a natural-language question. The plugin starts a child Explorer Agent limited to read, glob, grep, explore_paths, and explore_semantics, then returns its structured, evidence-backed findings.

directories + question
  -> read-only Explorer child agent
  -> path and semantic evidence
  -> concise answer returned to the calling agent

Installation

Install directly from GitHub into a DSH Profile:

dsh plugin --profile web add github:ganfabo123-cmyk/dsh-explorer-agent

Git installs run the package's prepare build. When pnpm asks for build-script approval, allow only this repository if you trust the source, then repeat the add command.

The included Bundle layer inserts dsh-explorer-agent into the Profile. Use --dump-config to confirm the explorer-agent row is present before starting the Profile.

Usage

Ask the main agent to explore one or more directories:

Explore packages/fs and packages/subagent and explain how a model-facing filesystem search tool is registered.

The main agent calls:

{
  "directories": ["packages/fs", "packages/subagent"],
  "question": "How is a model-facing filesystem search tool registered?"
}

The tool returns # Explored paths, # Semantic findings, or both, containing the original structured submissions from the child agent.

Requirements

• DeepSeek Harness 0.1 release-candidate packages. The source originated on rc.5 and the standalone package accepts compatible newer 0.1 releases.
• A subagents provider with toolFilter support; the in-process spawn and fork providers qualify.
• read, glob, and grep tools in the same composition.
• An LLM provider configured for child-agent runs.

Model Experience

Each explorer call creates a fresh child-agent conversation. The child uses only the five allowed read/submission tools. Its formatted evidence is returned to the main agent and becomes part of the main conversation context. The plugin adds no fixed system-prompt section.

Known Limitations and Deferred Work

• The directory scope is enforced by the Explorer persona and tool allowlist, not by a filesystem policy fence. A composed read tool that accepts arbitrary paths can still be pointed outside the requested directories.
• Results are matched by the exact question string. Concurrent runs with the same question on one workflow can collide.
• Results are process-local and are not cached across runs.
• The plugin provides the Explorer workflow only; filesystem tools, subagent providers, and model providers remain the Profile's responsibility.

Development

pnpm install
pnpm run check
pnpm pack

License

MIT. See LICENSE and NOTICE.

See VERIFICATION.md for standalone package and fresh DSH Profile evidence.