Skip to content

armgit / xerj

Public Imported from GitHub
0

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.

feat(dsh): add a DeepSeek Harness profile bundle (#2298)

xerj-orgdb25e8e63cc2
diff --git a/.gitignore b/.gitignore
index 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, while
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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.md
index 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_H
config:
serverName: xerj
transport: stdio
- command: /abs/path/to/xerj
+ command: xerj
args:
- mcp
env:
diff --git a/README.md b/README.md
index 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.y
config:
serverName: xerj
transport: stdio
- command: /abs/path/to/xerj
+ command: xerj
args:
- mcp
env:
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 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: xerj
transport: stdio
- command: /abs/path/to/xerj
+ command: xerj
args:
- mcp
env:
diff --git a/dsh/README.md b/dsh/README.md
new file mode 100644
index 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.yml
new file mode 100644
index 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.json
new file mode 100644
index 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.html
index 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.png
new file mode 100644
index 000000000..43cb0ce67
Binary files /dev/null and b/landing/brandbook/xerj-mark-400.png differ
diff --git a/landing/docs/cli.html b/landing/docs/cli.html
index 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.toml
config:
serverName: xerj
transport: stdio
- command: /abs/path/to/xerj
+ command: xerj
args:
- mcp
env: