Remove MPI_PROJECT_ROOT mentions

This commit is contained in:
iacore
2026-07-14 11:22:54 +08:00
parent eaa5e0bf4b
commit 8bf19a8d18
5 changed files with 17 additions and 14 deletions
+8 -8
View File
@@ -6,14 +6,14 @@ category: research
# Terms Search # Terms Search
Database: `$MPI_PROJECT_ROOT/toolkit/terms-database/termlib.duckdb` Database: `toolkit/terms-database/termlib.duckdb`
CLI: `$MPI_PROJECT_ROOT/toolkit/terms-database/search.py` CLI: `toolkit/terms-database/search.py`
Server: `$MPI_PROJECT_ROOT/toolkit/terms-database/server.py` Server: `toolkit/terms-database/server.py`
## CLI (preferred) ## CLI (preferred)
``` ```
$MPI_PROJECT_ROOT/toolkit/terms-database/search.py <query> [limit] toolkit/terms-database/search.py <query> [limit]
``` ```
Multi-word queries are ANDed. Searches both `zh` and `en` columns. Multi-word queries are ANDed. Searches both `zh` and `en` columns.
@@ -22,7 +22,7 @@ Multi-word queries are ANDed. Searches both `zh` and `en` columns.
```python ```python
import sys import sys
sys.path.insert(0, '$MPI_PROJECT_ROOT/terms-search') sys.path.insert(0, 'toolkit/terms-database')
from search import search from search import search
results = search("空性", limit=5, src="DoT定稿") results = search("空性", limit=5, src="DoT定稿")
# → list of {zh, en, loc, source} dicts # → list of {zh, en, loc, source} dicts
@@ -32,7 +32,7 @@ Use this inside `execute_code` scripts for batch lookups — no subprocess neede
## HTTP API (use only when CLI is insufficient) ## HTTP API (use only when CLI is insufficient)
Start: `python3 $MPI_PROJECT_ROOT/toolkit/terms-database/server.py` (port 8910) Start: `python3 toolkit/terms-database/server.py` (port 8910)
- `GET /` — plain HTML UI (form + results table, no CSS) - `GET /` — plain HTML UI (form + results table, no CSS)
- `GET /` — plain HTML UI (form + results table, no CSS) - `GET /` — plain HTML UI (form + results table, no CSS)
@@ -64,14 +64,14 @@ Errors return `{"error": "..."}` with HTTP 500 (API) or shown inline (UI).
## Direct DuckDB ## Direct DuckDB
``` ```
duckdb $MPI_PROJECT_ROOT/toolkit/terms-database/termlib.duckdb duckdb toolkit/terms-database/termlib.duckdb
``` ```
Key tables: `unified_terms_flat` (zh, en, loc, source), individual source tables, `unified_terms` view. Key tables: `unified_terms_flat` (zh, en, loc, source), individual source tables, `unified_terms` view.
## Rebuilding ## Rebuilding
Terms data comes from `$MPI_PROJECT_ROOT/guide/03 术语库/`. To rebuild: Terms data comes from `guide/03 术语库/`. To rebuild:
1. Convert source xlsx/ods → CSV+YAML in `_output/` 1. Convert source xlsx/ods → CSV+YAML in `_output/`
2. Rebuild DuckDB from CSVs 2. Rebuild DuckDB from CSVs
3. Materialize `unified_terms_flat` view → table for performance 3. Materialize `unified_terms_flat` view → table for performance
@@ -10,7 +10,7 @@ After producing a first-pass translation, or when the user asks to check termino
1. Read the full translated file. Extract all Chinese terms from `{% "TERM" (pinyin) = ENGLISH ... %}` blocks. 1. Read the full translated file. Extract all Chinese terms from `{% "TERM" (pinyin) = ENGLISH ... %}` blocks.
2. Start the search server: `python3 $MPI_PROJECT_ROOT/toolkit/terms-database/server.py &` (port 8910). It may already be running — check with `curl -s http://localhost:8910/`. 2. Start the search server: `python3 toolkit/terms-database/server.py &` (port 8910). It may already be running — check with `curl -s http://localhost:8910/`.
3. Batch-search each term via the HTTP API: 3. Batch-search each term via the HTTP API:
``` ```
@@ -8,7 +8,7 @@ Import directly in `execute_code` scripts — no subprocess, no server, no text
```python ```python
import sys import sys
sys.path.insert(0, '$MPI_PROJECT_ROOT/terms-search') sys.path.insert(0, 'toolkit/terms-database')
from search import search from search import search
results = search("三级修学", limit=5) results = search("三级修学", limit=5)
@@ -20,7 +20,7 @@ results = search("空性", loc="心经", src="DoT定稿", limit=5)
```python ```python
import sys import sys
sys.path.insert(0, '$MPI_PROJECT_ROOT/terms-search') sys.path.insert(0, 'toolkit/terms-database')
from search import search from search import search
terms = ["三无漏学", "八步三禅", "闻思修", ...] terms = ["三无漏学", "八步三禅", "闻思修", ...]
+2 -2
View File
@@ -9,10 +9,10 @@ Add to `~/.hermes/config.yaml`:
```yaml ```yaml
skills: skills:
external_dirs: external_dirs:
- $MPI_PROJECT_ROOT/toolkit/skills - /path/to/mpi/toolkit/skills
``` ```
{% Edit config.yaml directly — `hermes config set` stores list values as strings. %} {% Replace `/path/to/mpi` with the absolute path to this repository. Edit config.yaml directly — `hermes config set` stores list values as strings. %}
## Skills ## Skills
+4 -1
View File
@@ -1,4 +1,7 @@
#!/usr/bin/env python3 #!/usr/bin/env -S uv run --script
# /// script
# dependencies = ["duckdb"]
# ///
"""Full-text search over MPI term database. Queries unified_terms_flat via DuckDB LIKE. """Full-text search over MPI term database. Queries unified_terms_flat via DuckDB LIKE.
Module usage: Module usage: