@jieai/dsh-malong-bridge

Official DSH (DeepSeek Harness) plugin for LiuHe / malong. One command puts all 44 malong__* MCP tools into dsh web, and malong's workspace automatically follows the current conversation's workspace — no need to pass a path manually.

dsh plugin --profile web add @jieai/dsh-malong-bridge
pkill -f "dsh web"
dsh web --port 3456 --host 0.0.0.0

Works out of the box: the bridge locates the bundled server/mcp-server.js (complete toolset backend; the only native dependency, better-sqlite3, ships cross-platform precompiled binaries), so no extra deployment is needed.

> pnpm 10 warns Ignored build scripts: better-sqlite3: that is pnpm's > default security policy (blocks dependency postinstall scripts). Run > pnpm approve-builds and check better-sqlite3 in the list (or edit > ~/.dsh/profiles/web/pnpm-workspace.yaml and add better-sqlite3 under > onlyBuiltDependencies, then pnpm rebuild better-sqlite3). > Without this, better-sqlite3 has no native binary and tool calls will fail. > > Native build fallback: better-sqlite3 ships prebuilt binaries for common > platforms (Node 20+); if your platform lacks a prebuilt and you have no build > toolchain (Windows: Visual Studio Build Tools for node-gyp), the server > automatically falls back to the vendored sql.js WASM backend > (malong/vendor/, zero native deps) — the startup log shows which backend is > active. Both backends use SQLite with compatible data files.

Uninstall

dsh plugin --profile web remove @jieai/dsh-malong-bridge
pkill -f "dsh web"
dsh web --port 3456 --host 0.0.0.0

Configuration (optional, zero-config by default)

You can also write a config: override on the malong-dsh-bridge entry in the profile's cordis.patch.yml (user layer, applied later).

How It Works

DSH Agent → malong__read_symbol(...) (no workspace_dir)
         → dsh-bridge injects workspace_dir = current session workspace
         → malong mcp-server (spawned subprocess) → per-path-hash isolated indexes

• Dynamic workspace follow: every tool invocation carries the session

workspace (exec.agent.session.header.cwd); the bridge injects it automatically; explicit paths from the model are respected (cross-workspace management).

• State isolation: indexes are hash-isolated by workspace path under

MALONG_STATE_DIR, unrelated to any project directory.

• Zero intrusion: does not touch dsh's node_modules; dsh upgrades are safe.

> Platform support (automatic): malong-parse (the Rust parsing service) > ships as esbuild-style platform subpackages — the main package declares > @jieai/malong-parse-linux-x64 / -darwin-x64 / -darwin-arm64 / > -win32-x64 in optionalDependencies, and npm/pnpm pulls only the binary for > the current os/cpu at install time. Other platforms / custom binaries can be > provided via the MALONG_PARSE_BIN env var.

Differences vs. the official dsh-mcp-client

The official dsh-mcp-client bridges a single MCP server; this plugin's bridge adds dynamic workspace injection (fills workspace_dir per invocation from the session workspace, so the model never needs to know the path) — a capability unique to LiuHe.

Troubleshooting

| Symptom | Fix | |---|---| | Log shows mcp tools/list timeout | Verify the install is complete (dsh plugin reports no node_modules errors); restart dsh | | No malong__* tools in the conversation | Confirm the bundle layer is attached (dsh web --dump-config \| grep malong); hard-refresh the browser | | Call fails with missing_parameter: workspace_dir | The conversation has no workspace (no cwd) to inject; pass a path in the prompt | | Plugin stops working after a dsh upgrade | The plugin lives at the profile layer, upgrades do not affect it; if the cordis interface changes, reinstall the plugin |

Index Rules (Transparency)

• Default ignored: node_modules, .git, dist, build, target,

coverage, __pycache__, .venv, .malong, .ai-transactions, vendor, etc.

• md/json not indexed: only code files are indexed; use a read tool for documents
• .malongignore customization: a .malongignore file at the project root

excludes directories allowlist-style (one per line; * wildcards supported; max 100 entries)

License

MIT