dsh-weknora-archive

dsh-weknora-archive

中文 · English

把 DSH（DeepSeek Harness）会话增量归档进 WeKnora 知识库的 host 端插件。是官方只读插件 @wxg-prc-cpg/dsh-weknora（4 个检索工具）的写入侧互补。

功能

工具名前缀可通过 toolPrefix 配置（默认 weknora_archive）。工具描述中英双语。

安装

node "/Applications/DSH Desktop.app/Contents/Resources/app/node_modules/@deepseek-ai/dsh/lib/bin.js" \
  plugin --profile web add /path/to/dsh-weknora-archive

配置

走 DSH 官方插件配置机制：插件 bundle 自带 cordis.patch.yml，默认从环境变量读取（key 不落地、不入库）：

LLM 精炼默认关闭：三个 llm* 字段必须同时提供才开启。开启后，归档时把启发式总结文本（非会话原文）发给该端点做一次精炼；任何失败都自动回退启发式总结，绝不影响归档本身。注意这意味着总结文本会发往你配置的模型服务商。

定时全自动归档（推荐配方）

在 DSH 里建一个每日提醒（如每晚 22:00），prompt 一句话即可：

调用 weknora_archive_auto 工具（不要带 dry_run），把返回的汇总原样转告我；有失败项目的列出失败原因。

去重按知识库内文档标题判定，重复执行是幂等的——漏跑、多跑都不会产生重复文档。改过 toolPrefix 的，提醒里的工具名用对应前缀（如 my_prefix_auto）。

精炼有最小长度门槛：启发式总结不足约 200 字符时直接采用原文、不发模型请求（派工型会话等低信息场景不值得花这次调用）。

也可把 cordis.patch.yml 的 insert 行拷进 profile 自己的 cordis.patch.yml 直接填值（注意文件权限）。

隐私说明

• 会话数据只发往你自己配置的 WeKnora 实例，插件不经过任何第三方服务。
• API key 只用于请求头 X-API-Key，绝不写入日志、异常信息、工具结果或本文档；日志输出前统一走 redactConfig() 脱敏（LLM key 同样脱敏）。
• 总结默认启发式规则生成（无 LLM 参与），凭据类内容不收录完整值；仅当你显式配置 llm* 三字段时，才会把总结文本发给你指定的模型服务商做精炼，且任何失败自动回退启发式结果。

API 兼容性

认证头为 X-API-Key（非 Bearer），路由中横线风格：GET/POST /knowledge-bases、GET /knowledge-bases/{id}/knowledge、POST /knowledge（multipart 上传 Markdown）、POST /knowledge/{id}/reparse。以你的 WeKnora 实际 API 为准；若有出入只需调整 lib/client.js。

本地单测

npm test   # node test/mock.test.mjs，mock 数据 + mock 客户端，无需网络与凭证

已知边界

• 总结默认是启发式抽取；配置 llm* 三字段后可自动精炼，仍不是全文重写。
• 正在运行的会话文件可能解压失败，会被跳过（下次归档自动补上）。
• 新建库的 embedding 配置需在 WeKnora 端完成（PUT 接口会静默丢弃 embedding 字段）。

---

dsh-weknora-archive (English)

A DeepSeek Harness host plugin that incrementally archives DSH sessions into a WeKnora knowledge base — the write-side complement to the official read-only @wxg-prc-cpg/dsh-weknora plugin (4 retrieval tools).

Tools

Prefix is configurable via toolPrefix (default weknora_archive). Tool descriptions are bilingual (EN/中文).

Install

node "/Applications/DSH Desktop.app/Contents/Resources/app/node_modules/@deepseek-ai/dsh/lib/bin.js" \
  plugin --profile web add /path/to/dsh-weknora-archive

Configuration

Uses DSH's official plugin-config mechanism: the bundle ships a cordis.patch.yml that reads environment variables by default (no key hardcoded anywhere):

LLM refinement is OFF by default: all three llm* fields must be provided together. When enabled, the heuristic summary text (not the raw transcript) is sent to that endpoint once per archived session for polishing; any failure silently falls back to the heuristic summary. Note this means summary text is sent to the model provider you configure.

Unattended auto-archive (recommended recipe)

Create a daily DSH reminder (e.g. 22:00) whose prompt is one line:

Call the weknora_archive_auto tool (no dry_run) and relay the returned summary verbatim; list any failed projects with their errors.

Deduplication keys on the document titles already in each KB, so the sweep is idempotent — missed or repeated runs never produce duplicates. If you changed toolPrefix, use the matching tool name in the reminder (e.g. my_prefix_auto).

Refinement has a minimum-length threshold: heuristic summaries under ~200 characters are uploaded as-is without a model call (low-information sessions like dispatch-only ones are not worth the call).

Alternatively copy the insert row into your profile's own cordis.patch.yml with literal values (mind file permissions).

Privacy

• Session data goes only to the WeKnora instance you configure — no third-party service involved.
• The API key is used solely in the X-API-Key header and is never logged, never embedded in errors, tool results, or this README; all log paths go through redactConfig() (the optional LLM key is redacted the same way).
• Summaries are produced by heuristic rules without any LLM by default, and credential-looking values are never recorded in full. Only when you explicitly configure the llm* fields is the summary text sent to the model provider you chose — and any refine failure falls back to the heuristic result.

API compatibility

Auth is the X-API-Key header (not Bearer); kebab-case routes: GET/POST /knowledge-bases, GET /knowledge-bases/{id}/knowledge, POST /knowledge (multipart Markdown upload), POST /knowledge/{id}/reparse. Defer to your actual WeKnora API; if it differs, only lib/client.js needs changes.

Tests

npm test   # mock data + mock client, no network or credentials required

Known limits

• Summaries are heuristic extractions by default; configure the llm* fields for automatic refinement — still not a full rewrite of the transcript.
• A live session file may fail to decompress and is skipped (picked up on the next run).
• Embedding configuration for newly created KBs must be done on the WeKnora side.

License

MIT