@abc12524/dsh-openviking
OpenViking 记忆集成：Web Settings 插件卡片 + 自动注入记忆上下文
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:abc12524/dsh-openviking#4faae8b235e62d3d30fe2721e171022d65accbdfOpenviking 以 @abc12524/dsh-openviking 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness (dsh) 的 OpenViking 长期记忆集成插件。
openviking 设置命名空间（服务地址、用户、密钥、相关性阈值、结果数量），并在每次用户提问后自动检索候选记忆（分数高于阈值、最多 maxResults 条）作为背景上下文注入。settings.plugin.item 槽按 openviking 命名空间接线）。检索是提示而非闸门（silent-by-design）：任何检索失败只记录警告，对话照常继续，不会阻塞。
# 在 dsh 检出目录执行（纯拷贝安装，无需构建/授权）
pnpm dsh plugin --profile web add github:abc12524/dsh-openviking
# 重启 dsh web
可锁定到具体提交以获得可复现安装：
...add github:abc12524/dsh-openviking#<commit>。安装后在 设置 → 插件 → OpenViking 填写服务地址与密钥即可，无需重启。
机制：仓库已预构建并提交 lib/（host lib/index.js + 浏览器 lib/client.js），且包不含 dependencies/devDependencies/prepare——dsh plugin add 只做纯拷贝接线，不触发任何 npm install 或构建，因此无需 allowBuilds 授权、无需 harness 检出。reconcile 检测到包的 dsh.bundle.patch 声明，自动把插件加入 profile 的 bundles 层栈并读取 cordis.patch.yml 接线（entry 为包名 @abc12524/dsh-openviking）——无需手动编辑任何文件。url/key 通过 Web 设置页配置（设置 → 插件 → OpenViking），或在你自己的 profile patch 层用同名 entry 覆盖 config。
@deepseek-ai/* 与 react），插件包本身不含任何需安装的 dependencies/devDependencies。http://<host>:1933，无需 /mcp 后缀）。tsconfig.json 已自包含（不 extends dsh 的 tsconfig base、无源码路径别名）。宿主端与客户端均由 tsdown 直接从 src 转译（@deepseek-ai/* peer 依赖 external，不打包），因此 git 安装的 prepare 不再需要 harness 检出：
pnpm run build # tsdown：lib/index.js（host）+ lib/client.js（浏览器 bundle）
pnpm run build:client # 同上但显式标注 client face（等价于 dsh Client pass）
类型检查（可选，开发者用）需要 DeepSeek Harness 的类型，按你本地的 harness 检出自行链好 @deepseek-ai/* 后 pnpm run build:types。
产物：lib/index.js + lib/client.js（banner 以 __ModuleLoader__.load({id:"@abc12524/dsh-openviking"}) 注册）。lib/ 已提交入库——git 安装直接复用，无需现场构建。本地改 src/ 后跑 pnpm run build 刷新 lib/ 并提交即可。
插件在 harness 中注册一组 openviking_* 工具，与自动记忆注入共用同一套 REST 客户端，直接调用 OpenViking REST API（v1），不经由 ov 的 MCP 端点。服务端根地址即设置项中的 url（自动兼容残留的 /mcp 后缀），鉴权复用同一 bearer token。
工具可见性（软披露）：九个工具在插件加载时无条件注册，因此始终出现在工具列表中（harness 在 agent 构造时从全局工具表快照，迟到的动态注册/注销无法可靠生效）。未配置 url/key 时，一个全局 guard 会以清晰原因（OpenViking 未配置…）拒绝任意 openviking_* 调用，而不是把工具藏起来；在「设置 → 插件 → OpenViking」填好地址与密钥后即可正常调用，无需重启（guard 读取实时配置，即时生效）。
| 工具 | 说明 | 关键参数 |
|---|---|---|
openviking_search | 语义搜索外置记忆 | query, limit?, min_score? |
openviking_remember | 保存长期记忆（写入 viking://user/<user>/memories/<category>/<name>.md） | category, name, content |
openviking_read | 读取单个 viking:// 文件 | uri |
openviking_list_dir | 列出目录（可递归） | uri, recursive? |
openviking_write_file | 写入 viking:// 文件 | uri, content, mode(create/replace/append) |
openviking_create_session | 创建对话 Session | session_id? |
openviking_add_message | 向 Session 追加消息 | session_id, role, content |
openviking_commit_session | 归档 Session 并提取长期记忆 | session_id, keep_recent_count? |
openviking_delete_file | 删除 viking:// 文件（不可撤销） | uri |
实现见 src/ov-client.ts（REST 客户端）与 src/ov-tools.ts（工具定义）。端点对齐 OpenViking v0.4.13 REST API：POST /api/v1/search/find（阈值字段为 score_threshold）、GET /api/v1/content/read、POST /api/v1/content/write、GET /api/v1/fs/ls、DELETE /api/v1/fs、/api/v1/sessions、/api/v1/sessions/{id}/messages、/api/v1/sessions/{id}/commit；remember 映射到在用户命名空间下写入 .md 文件。
插件检索是 silent-by-design：URL/Key 留空部署时检索自动禁用（不报错、不阻塞对话）。可以先完成上面安装流程，之后再在 Web 设置页填写 OpenViking 服务地址与密钥——设置 live 生效，无需重启。
浏览器侧把配置表单注册进 设置 → 插件（Plugins）→ OpenViking 卡片（settings.plugin.item 槽，以 key: 'openviking' 接线已注册的命名空间），与其他可配置插件（如 Bash、Web Search）并列显示。卡片组件自绘（折叠头、未保存徽标、只读横幅、逐字段「已覆盖」标记与重置），不 import 官方卡片 chrome —— client bundle-purity 门禁禁止跨插件 value import。命名空间不可用时卡片渲染为空（未接线的部署在设置页不留痕迹）。
| 字段 | 说明 |
|---|---|
| Server URL | OpenViking REST 服务端根地址（如 http://<host>:1933，不带 /mcp） |
| API Key | 完整 Bearer token（敏感字段，保存后不回显，以 **** 掩码显示）。用户标识从 token 第二段（base64url）自动解码，无需单独填写 |
| Relevance threshold | 只注入相关性高于此值的候选（0-1），默认 0.4 |
| Result count | 每次提问最多注入的候选记忆条数，默认 3 |
其余参数（单次 REST 超时、摘要截断长度）使用 host 端
Configschema 的默认值（8000ms / 400 字符），当前设置卡片不暴露，需要时可改 composition 配置或后续扩展卡片。
MIT