维脑 Agent (Weinao) — dsh-weinao
维脑 Agent 是面向 DeepSeek Harness 的 HEMA（历史欧洲武术）文献检索工具插件。
它为 dsh agent 提供 Wiktenauer 文献检索能力：搜索并阅读 Wiktenauer 武术古籍文库、维护本地双语（中↔德/英）术语表。安装后，任何会话仍保持原本的角色和对话策略，只是在遇到 HEMA 相关问题时多了一套可用的查询工具。
一切运行在你的 dsh 进程本地——没有服务器、没有额外 API key（除了 dsh 本身的模型凭据）、没有第三方服务。插件直接对接 Wiktenauer 公共 MediaWiki API。
安装
dsh plugin --profile web add @ghogiel/dsh-weinao
或者不通过 plugin 命令，把下面这几行加进你的 profile 的 cordis.patch.yml：
- insert:
- id: dsh-weinao
name: '@ghogiel/dsh-weinao'
功能
四个工具
| 工具 | 作用 | 什么时候用 |
|---|
wiki_search | Wiktenauer 全文搜索，返回标题 + 摘要 | 每个问题的第一步 |
wiki_get_page | 读取某页完整纯文本（精确标题匹配） | 搜索后，读最佳命中页 |
wiki_prefix_search | 前缀标题搜索 | 术语消歧、拼写变体、空搜索结果兜底 |
wiki_get_links | 获取某页的内部链接 | 发现关联古籍/概念 |
每个工具返回结构化规范值（不是散文），模型看到的是渲染后的文本，程序化调用方拿到的是干净数据。
工具使用指引（prompt 分区）
插件注册 hema-workflow prompt 分区，它只做一件事——告诉模型这些 wiki 工具何时用，不改动会话原本的角色或对话策略：
- 说明工具用于查询 Wiktenauer 武术古籍库，在用户问 HEMA 相关问题（或需要查古籍、技术、大师）时使用
- 给出查找方法：先
wiki_search（可翻译中文/现代术语为历史术语）→ 读最相关结果 wiki_get_page → 空结果时回退 wiki_prefix_search / wiki_get_links
- 要求引用来源时注明页面
- 不声明模型是 HEMA 助手、不强制所有问题走检索流程、不拒绝非 HEMA 问题
- 注入当前术语表上下文（已确认映射标为可信，推断映射标为待确认）
本地术语表
双语术语映射存储（如 交击 → Zwerchhau），以纯 JSON 文件持久化在 $DSH_HOME/wiktenauer/glossary.json（或 ~/.dsh/wiktenauer/）。
- 模型推断出新翻译时自动追加（
llm_inferred）
- 用户确认的映射
confidence +0.3 并标记可信
- 用户拒绝的映射扣置信度；累计 3 次拒绝后移除
- prompt 上下文把已确认映射显示为「已确认术语映射（可信）」，推断映射显示为「LLM 推断映射（待确认，可用但必须告知用户）」
配置
| 键 | 默认值 | 含义 |
|---|
glossaryDir | $DSH_HOME/wiktenauer | 术语表 JSON 文件所在目录 |
sectionOrder | 1000 | prompt 分区顺序（越小越靠前；persona 是 0） |
示例：
- insert:
- id: dsh-weinao
name: '@ghogiel/dsh-weinao'
config:
glossaryDir: /data/hema
sectionOrder: 900
项目起源
这是 HEMA Question Agent（原为 FastAPI + Claude Code CLI 包装）的 agent 核心移植，变成一个自包含的 dsh 插件。四个 wiki 工具和术语表逻辑直接移植自 wiktenauer_mcp.py / glossary_store.py；FastAPI / 付费 / 认证 / 限流层有意去掉——dsh 提供运行时、会话日志和工具执行管线。
开发
pnpm install
pnpm run typecheck
pnpm run build
pnpm test
wiki 客户端和术语表零依赖（Node 内置 + 全局 fetch），纯逻辑部分无需完整 dsh 安装即可冒烟测试：
node --experimental-strip-types -e "import('./src/wiktenauer.ts').then(m => m.wikiSearch('Liechtenauer', 2)).then(r => console.log(r))"
已对 Wiktenauer 真实 API 验证（搜索 / 读页 / 前缀搜索 / 链接 / 缺失页错误），并对照已发布的
@deepseek-ai/dsh-tools@0.1.0-rc.7 / @deepseek-ai/dsh-session@0.1.0-rc.7 /
@deepseek-ai/cordis@4.0.1 类型定义做过类型检查（即 @deepseek-ai/dsh 随附的版本）。
注意：全文搜索只匹配 Wiktenauer 上的精确拼写——历史变体（如 Zwerchhau 对应 Wiktenauer 的 Zwerchhaw）会返回空，这正是模型应该回退到 wiki_prefix_search 的时刻（工具使用指引已提示模型）。
许可
MIT
