dsh-ov-memory
面向 DeepSeek Harness 的 OpenViking 记忆与上下文套件：自动召回、会话捕获、阈值提交、离线发件箱重放、自包含 MCP 工具桥接、viking:// URI 防护。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiaono1/dsh-ov-memory#d7b8c72db336a7394991a4d871960b05e5bb7779Ov Memory 以 dsh-ov-memory 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 OpenViking 持久记忆接入 DeepSeek Harness（DSH）的插件。 OpenViking 负责「记住」，本插件负责把记忆在合适的时候送进对话、把对话送回去沉淀。
简体中文 | English
dsh-<会话id> 会话流，供后台抽取为长期记忆pending_tokens 达到阈值自动 commit（保留最近 N 条为活跃消息）；会话关闭时兜底提交mcp__openviking__* 暴露；服务器工具表变化自动同步viking:// 虚拟路径当成本地文件ov-memory 使用指南，不污染默认技能目录@deepseek-ai/* peer 包，无额外 npm 依赖@deepseek-ai/* 0.1.x（≥ 0.1.0-rc.6）release 线^22.19.0 或 >=24openviking-server，或远程实例）# 从 GitHub 源码安装（lib/ 已预构建提交，无需本机构建）
dsh plugin --profile <profile> add github:xiaono1/dsh-ov-memory
# 本地开发安装
dsh plugin --profile <profile> add /path/to/dsh-ov-memory
插件通过自带的 cordis.patch.yml 注册为一个隔离的 cordis group（服务命名空间 ovMemory）。
若 profile 中已存在其它占用
mcp__openviking__*命名空间的桥接插件，请先移除再启用本插件，两者不能共存。
默认连接 http://127.0.0.1:1933。凭据沿用 OpenViking 生态的统一解析顺序：
OPENVIKING_* 环境变量 → ~/.openviking/ovcli.conf → ~/.openviking/ov.conf。
如需显式覆盖，在 profile 的 cordis.patch.yml 中写入：
- insert:
- id: ov-memory
config:
- id: ov-memory-runtime
config:
endpoint: 'http://127.0.0.1:1933' # REST base
apiKey: 'your-user-key' # 留空则走 env / ovcli.conf
account: ''
user: ''
recall:
enabled: true
budgetTokens: 2000 # 每次召回的注入预算（服务端 context 模式）
scoreFloor: 0.35 # 相关度下限
refreshEverySteps: 0 # >0 时按步数周期强制刷新；0=仅查询变化时
capture:
toolResults: false # 是否把工具结果也镜像进记忆流
skipSubagentSessions: false
commit:
thresholdTokens: 20000 # pending_tokens 达到即提交
keepRecentCount: 10 # 提交后保留为活跃的最近消息数
常用环境变量：
| 变量 | 作用 |
|---|---|
OPENVIKING_URL / OPENVIKING_BASE_URL | 服务器地址 |
OPENVIKING_API_KEY / OPENVIKING_BEARER_TOKEN | 鉴权凭据 |
OPENVIKING_ACCOUNT / OPENVIKING_USER | 租户/用户（trusted 模式） |
OPENVIKING_PEER_ID | 固定 actor peer |
OPENVIKING_MCP_URL | MCP 端点覆盖（默认 <url>/mcp） |
OPENVIKING_PENDING_DIR | outbox 目录（默认 ~/.openviking/pending） |
DSH agent 钩子 本插件（进程内） OpenViking 服务器
───────────────── ───────────────── ──────────────────
agent/session-start ──► 建档 + outbox 重放 ───────────► POST /api/v1/sessions
agent/pre-step ──► 召回注入（plugin user 消息）──► POST /api/v1/search/search (mode=context)
session/event ──► 会话镜像 ──服务器不可达──► outbox(本地持久化) ──重放──► POST .../messages
turn/end ──► pending_tokens ≥ 阈值 → commit
session/flush ──► 兜底提交
工具面 mcp__openviking__* ◄── dsh-mcp-client ◄── stdio ── 自研 MCP 代理 ──► POST /mcp (streamable HTTP)
设计决策与实现说明见 docs/DESIGN.md，验证手册见 docs/E2E.md。
npm ci
npm run typecheck # tsc --noEmit
npm run build # TypeScript → lib/（已随仓库提交）
npm test # node --test（内置 mock OpenViking 服务器，无需真实服务）
测试不依赖真实服务器：test/*.test.mjs 用自建 node:http 模拟 OpenViking REST 与 MCP 端点，
覆盖捕获/提交/outbox/凭据链/peer 解析/MCP 会话与工具调用/URI 守卫等路径。
可选真实服务器端到端验证见 docs/E2E.md。