AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory and RAG. Elasticsearch-compatible API; Corpus Hub serves hundreds of reference memory corpora.
Rust agent-memoryai-agentsbm25claude-codeclicode-searchcursordatabaseelasticsearchfull-text-searchhybrid-searchjsonllocal-firstmcpmcp-servermodel-context-protocolragrustsearch-enginevector-search
feat(dsh): add a DeepSeek Harness profile bundle (#2298)
xerj-orgdb25e8e63cc2
diff --git a/.gitignore b/.gitignoreindex d6fa768b1..3ba803f3b 100644--- a/.gitignore+++ b/.gitignore@@ -136,6 +136,11 @@ landing/resources/xerj-sales-kit.zip# documented everywhere and shipped nowhere).!tools/**/*.md+# Re-include the DeepSeek Harness bundle readme. The blanket *.md rule+# above would drop dsh/README.md on `git add`, and the catalog lists the+# committed file.+!dsh/**/*.md+# Re-include the public .github community files. The blanket *.md rule above# silently swallowed these: no pull-request template has ever existed in this# repo's history because `git add` refused it without anyone noticing, whilediff --git a/CHANGELOG.md b/CHANGELOG.mdindex 9b14502b4..d9d877801 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -9,6 +9,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0### Added+- A DeepSeek Harness profile bundle in `dsh/` (`xerj-dsh`, Apache-2.0)+ inserts the README's `mcp-xerj` stdio row via+ `@deepseek-ai/dsh-mcp-client`. The row is still untested on DSH.+ `landing/brandbook/xerj-mark-400.png` is a 400×400 PNG of the letter+ mark for directory submissions.+- MCP `xerj_def` exposes local definition lookup, completing #2080 after the`xerj_search` prefix support. It shares `xerj def --json` query construction,mapping guards, ranking and location deduplication; accepts `symbol`,diff --git a/README.ko.md b/README.ko.mdindex 52f1aa4d0..39291cf0b 100644--- a/README.ko.md+++ b/README.ko.md@@ -360,7 +360,7 @@ xerj mcp # 2. MCP stdio 서버 (클라이언트| Kiro | 워크스페이스의 `.kiro/settings/mcp.json`, 사용자는 `~/.kiro/settings/mcp.json` | `mcpServers` | `${VAR}` 확장은 승인 필요 | untested || Antigravity | `~/.gemini/config/mcp_config.json` 또는 워크스페이스의 `.agents/mcp_config.json` | `mcpServers` | 원격 서버는 `serverUrl` 사용 | untested || OpenClaw | `~/.openclaw/openclaw.json` (JSON5) | `mcp.servers` | `transport: "stdio"` | untested |-| DeepSeek Harness (dsh) | `$DSH_HOME/cordis.patch.yml` 또는 프로필 패치 | `@deepseek-ai/dsh-mcp-client`가 있는 `- insert:` | 서버당 플러그인 인스턴스 하나 | untested |+| [DeepSeek Harness (dsh)](dsh/) | `$DSH_HOME/cordis.patch.yml` 또는 프로필 패치 | `@deepseek-ai/dsh-mcp-client`가 있는 `- insert:` | 서버당 플러그인 인스턴스 하나 | untested || Warp | Settings > Agents > MCP servers 또는 `~/.warp/.mcp.json`과 프로젝트의 `.warp/.mcp.json` | `mcpServers` | `cwd`가 아닌 `working_directory` | untested || Augment Code | Auggie CLI는 `~/.augment/settings.json`; IDE는 자체 패널 사용 | `mcpServers` | 그 파일은 IDE를 구동하지 않음 | untested || Qwen Code | `~/.qwen/settings.json` 또는 프로젝트의 `.qwen/settings.json` | `mcpServers` | `mcp.allowed`가 조용히 숨길 수 있음 | untested |@@ -436,7 +436,7 @@ DeepSeek Harness는 `$DSH_HOME/cordis.patch.yml` 또는 프로필 패치 `$DSH_Hconfig:serverName: xerjtransport: stdio- command: /abs/path/to/xerj+ command: xerjargs:- mcpenv:diff --git a/README.md b/README.mdindex 9c3af12b7..a06755e2e 100644--- a/README.md+++ b/README.md@@ -368,7 +368,7 @@ has been run: v2.1.2 on Windows against `xerj` v1.0.0-rc.97, which answered `ini| Kiro | `.kiro/settings/mcp.json` in the workspace, `~/.kiro/settings/mcp.json` user | `mcpServers` | `${VAR}` expansion needs approval | untested || Antigravity | `~/.gemini/config/mcp_config.json`, or `.agents/mcp_config.json` in the workspace | `mcpServers` | remote servers use `serverUrl` | untested || OpenClaw | `~/.openclaw/openclaw.json` (JSON5) | `mcp.servers` | `transport: "stdio"` | untested |-| DeepSeek Harness (dsh) | `$DSH_HOME/cordis.patch.yml`, or a profile patch | `- insert:` with `@deepseek-ai/dsh-mcp-client` | one plugin instance per server | untested |+| [DeepSeek Harness (dsh)](dsh/) | `$DSH_HOME/cordis.patch.yml`, or a profile patch | `- insert:` with `@deepseek-ai/dsh-mcp-client` | one plugin instance per server | untested || Warp | Settings > Agents > MCP servers, or `~/.warp/.mcp.json` and `.warp/.mcp.json` in the project | `mcpServers` | `working_directory`, not `cwd` | untested || Augment Code | `~/.augment/settings.json` for the Auggie CLI; the IDE uses its own panel | `mcpServers` | that file does not drive the IDE | untested || Qwen Code | `~/.qwen/settings.json`, or `.qwen/settings.json` in the project | `mcpServers` | `mcp.allowed` can silently hide it | untested |@@ -434,7 +434,7 @@ context servers, and OpenClaw nests them under `mcp`:{mcp: {servers: {xerj: {command: "/abs/path/to/xerj", args: ["mcp"], transport: "stdio"}}}}```-DeepSeek Harness loads one MCP server as one plugin in `$DSH_HOME/cordis.patch.yml`, or in a profile patch at `$DSH_HOME/profiles/<profile>/cordis.patch.yml`. If that file is only `[]`, replace the array with the block below; appending under `[]` is not valid YAML. `env` and `cwd` are optional stdio fields (`args` defaults to `[]`, `env` to `{}`, `cwd` to `""`). When the node is not running `--insecure`, add `XERJ_AUTH: "ApiKey <key>"` under `env`:+DeepSeek Harness loads one MCP server as one plugin in `$DSH_HOME/cordis.patch.yml`, or in a profile patch at `$DSH_HOME/profiles/<profile>/cordis.patch.yml`. The same block is the profile bundle in [`dsh/`](dsh/), and its `command` is `xerj` on `PATH`. If that file is only `[]`, replace the array with the block below; appending under `[]` is not valid YAML. `env` and `cwd` are optional stdio fields (`args` defaults to `[]`, `env` to `{}`, `cwd` to `""`). When the node is not running `--insecure`, add `XERJ_AUTH: "ApiKey <key>"` under `env`:```yaml# $DSH_HOME/cordis.patch.yml@@ -444,7 +444,7 @@ DeepSeek Harness loads one MCP server as one plugin in `$DSH_HOME/cordis.patch.yconfig:serverName: xerjtransport: stdio- command: /abs/path/to/xerj+ command: xerjargs:- mcpenv:diff --git a/README.zh-CN.md b/README.zh-CN.mdindex 1587f8e68..6d8995482 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -257,7 +257,7 @@ xerj mcp # 2. MCP stdio server (your client runs| Kiro | 工作区内的 `.kiro/settings/mcp.json`,用户级为 `~/.kiro/settings/mcp.json` | `mcpServers` | `${VAR}` 展开需要批准 | 未测试 || Antigravity | `~/.gemini/config/mcp_config.json`,或工作区内的 `.agents/mcp_config.json` | `mcpServers` | 远程服务用 `serverUrl` | 未测试 || OpenClaw | `~/.openclaw/openclaw.json`(JSON5) | `mcp.servers` | `transport: "stdio"` | 未测试 |-| DeepSeek Harness (dsh) | `$DSH_HOME/cordis.patch.yml`,或某个 profile 补丁 | 带 `@deepseek-ai/dsh-mcp-client` 的 `- insert:` | 每个服务一个插件实例 | 未测试 |+| [DeepSeek Harness (dsh)](dsh/) | `$DSH_HOME/cordis.patch.yml`,或某个 profile 补丁 | 带 `@deepseek-ai/dsh-mcp-client` 的 `- insert:` | 每个服务一个插件实例 | 未测试 || Warp | Settings > Agents > MCP servers,或 `~/.warp/.mcp.json` 与项目内的 `.warp/.mcp.json` | `mcpServers` | `working_directory` 而非 `cwd` | 未测试 || Augment Code | Auggie CLI 用 `~/.augment/settings.json`;IDE 有自己的面板 | `mcpServers` | 该文件不控制 IDE | 未测试 || Qwen Code | `~/.qwen/settings.json`,或项目内的 `.qwen/settings.json` | `mcpServers` | `mcp.allowed` 可能悄悄隐藏它 | 未测试 |@@ -332,7 +332,7 @@ DeepSeek Harness 在 `$DSH_HOME/cordis.patch.yml`(或某个 profile 的 `$DSH_config:serverName: xerjtransport: stdio- command: /abs/path/to/xerj+ command: xerjargs:- mcpenv:diff --git a/dsh/README.md b/dsh/README.mdnew file mode 100644index 000000000..00eaf3400--- /dev/null+++ b/dsh/README.md@@ -0,0 +1,45 @@+# xerj-dsh++DeepSeek Harness ([dsh](https://github.com/deepseek-ai/deepseek-harness)) profile bundle for [xerj](https://github.com/xerj-org/xerj). It inserts one `@deepseek-ai/dsh-mcp-client` row that runs `xerj mcp` over stdio. Tools register as `mcp__xerj__*`.++This bundle is not yet tested on DSH.++## Prerequisites++- Node.js `>=22.12.0`. `dsh plugin` forwards to [pnpm](https://pnpm.io/installation).+- The `xerj` binary on `PATH` (`command: xerj` in the patch). The `sh` installer puts it in `~/.local/bin` and does not edit `PATH`.+- A xerj node already running. `xerj mcp` does not start one. The patch's `XERJ_URL` is `http://localhost:9200`.++## Install++The commands pin `@deepseek-ai/[email protected]`, the release that depends on `@deepseek-ai/[email protected]` (the version in `package.json`). `npm view @deepseek-ai/dsh-mcp-client version` still reports the `latest` tag `0.0.1-rc.1`; the published line this bundle pins is the `next` tag `0.2.1-rc.3`. With that `dsh` on `PATH`, drop the `npx` prefix.++```sh+git clone https://github.com/xerj-org/xerj.git+cd xerj+npx @deepseek-ai/[email protected] plugin --profile web add link:./dsh+```++Replace `web` with the profile name. A profile that does not exist yet is created. Restart the profile (`npx @deepseek-ai/[email protected] web`, or relaunch) so the row loads.++Remove: `npx @deepseek-ai/[email protected] plugin --profile web remove xerj-dsh`.++## Override++DSH strips credential-like environment variables from the process it spawns, so a shell export of `XERJ_AUTH` does not reach `xerj mcp`. When the node is not running `--insecure`, put `XERJ_AUTH` in the profile patch `$DSH_HOME/profiles/<profile>/cordis.patch.yml`. An override replaces the whole config, so restate every field:++```yaml+- id: mcp-xerj+ config:+ serverName: xerj+ transport: stdio+ command: xerj+ args:+ - mcp+ env:+ XERJ_URL: "http://localhost:9200"+ XERJ_AUTH: "ApiKey <key>"+ cwd: ""+```++The key is `<data-dir>/admin.key`. `serverName` must stay unique among live `@deepseek-ai/dsh-mcp-client` rows. To point `command` at an absolute path instead of `xerj` on `PATH`, use the same full-config override.diff --git a/dsh/cordis.patch.yml b/dsh/cordis.patch.ymlnew file mode 100644index 000000000..6532a5f20--- /dev/null+++ b/dsh/cordis.patch.yml@@ -0,0 +1,29 @@+# xerj-dsh bundle patch.+#+# The xerj node must already be running. `xerj mcp` proxies to XERJ_URL and+# does not start a node.+#+# DSH strips credential-like environment variables from spawned children, so+# put XERJ_AUTH in a profile override ($DSH_HOME/profiles/<profile>/cordis.patch.yml)+# when the node is not running --insecure. An override replaces the whole+# config: restate every field you want to keep, including serverName,+# transport, command, args, env and cwd.+#+# serverName must be unique across live @deepseek-ai/dsh-mcp-client instances.+# A duplicate serverName fails the later instance at load.+#+# The insert below is the README's DeepSeek Harness setup block.++# $DSH_HOME/cordis.patch.yml+- insert:+ - id: mcp-xerj+ name: '@deepseek-ai/dsh-mcp-client'+ config:+ serverName: xerj+ transport: stdio+ command: xerj+ args:+ - mcp+ env:+ XERJ_URL: "http://localhost:9200"+ cwd: ""diff --git a/dsh/package.json b/dsh/package.jsonnew file mode 100644index 000000000..9d81f5454--- /dev/null+++ b/dsh/package.json@@ -0,0 +1,33 @@+{+ "name": "xerj-dsh",+ "version": "1.0.0-rc.98",+ "description": "DeepSeek Harness (dsh) profile bundle that inserts the xerj MCP server over stdio.",+ "license": "Apache-2.0",+ "repository": {+ "type": "git",+ "url": "git+https://github.com/xerj-org/xerj.git",+ "directory": "dsh"+ },+ "keywords": [+ "deepseek-harness",+ "dsh",+ "mcp",+ "search"+ ],+ "engines": {+ "node": ">=22.12.0"+ },+ "dsh": {+ "bundle": {+ "patch": "./cordis.patch.yml"+ }+ },+ "dependencies": {+ "@deepseek-ai/dsh-mcp-client": "0.2.1-rc.3"+ },+ "files": [+ "cordis.patch.yml",+ "README.md"+ ],+ "private": false+}diff --git a/landing/brandbook/index.html b/landing/brandbook/index.htmlindex 0bccb74e3..d0570a317 100644--- a/landing/brandbook/index.html+++ b/landing/brandbook/index.html@@ -1690,15 +1690,14 @@<!-- 09 · DOWNLOADS --><section class="scene-section"><div class="kicker"><span>09</span><span class="dash">·</span><span>DOWNLOADS</span></div>- <h2 class="scene">VECTORS.<br><span class="accent">NO RASTERS.</span></h2>+ <h2 class="scene">VECTORS.<br><span class="accent">ONE PNG.</span></h2><p>- Every asset ships as SVG. We do not publish PNG or JPG variants- because a raster of the wordmark is either wrong size or wrong- compression — and both of those are easier to fix upstream by- using the SVG. If a partner's CMS cannot render SVG, the answer- is to upgrade the CMS, not to raster the logo. The full- brandbook is available as a print-ready PDF below.+ Every asset ships as SVG, plus one 400×400 PNG of the letter mark+ for directories that refuse SVG. A raster of the wordmark is still+ the wrong asset: the size or the compression is wrong, and both+ are easier to fix by using the SVG. The full brandbook is+ available as a print-ready PDF below.</p><div class="dl-row" style="border-top: 1px solid var(--z-line); padding-top: var(--sp-6); margin-top: var(--sp-6);">@@ -1732,6 +1731,11 @@<span class="desc">Yellow X on night. Favicon, app icon, social avatar.</span><span class="get"><a href="/brandbook/xerj-mark.svg" download>GET SVG →</a></span></div>+ <div class="dl-row">+ <span class="name">LETTER MARK · 400</span>+ <span class="desc">400×400 PNG of the letter mark, for directories that refuse SVG.</span>+ <span class="get"><a href="/brandbook/xerj-mark-400.png" download>GET PNG →</a></span>+ </div><div class="dl-row"><span class="name">LETTER MARK · INVERSE</span><span class="desc">Ink X on paper. Letterhead, print covers, debossed surfaces.</span>diff --git a/landing/brandbook/xerj-mark-400.png b/landing/brandbook/xerj-mark-400.pngnew file mode 100644index 000000000..43cb0ce67Binary files /dev/null and b/landing/brandbook/xerj-mark-400.png differdiff --git a/landing/docs/cli.html b/landing/docs/cli.htmlindex 186760bcd..acb252ca6 100644--- a/landing/docs/cli.html+++ b/landing/docs/cli.html@@ -523,7 +523,7 @@ Grok CLI | ~/.grok/config.toml or .grok/config.tomlconfig:serverName: xerjtransport: stdio- command: /abs/path/to/xerj+ command: xerjargs:- mcpenv: