beijingwahw/dsh-companion

DeepSeek Companion — DeepSeek Harness 官方伴侣插件:对话导出/交接摘要/成本优化/全局检索 + 执行轨迹分析、Prompt 工程工作台、多模型竞技场、任务编排、安全与审计(E–J 九大模块,Cordis 插件化)。

Project Overview项目介绍

This is a native DeepSeek Harness (DSH) plugin, built specifically for DSH using the Cordis framework and DSH plugin SDK. It ships with seven independent sub-plugins that cover a range of productivity and management features for DSH conversations, each of which can be enabled or disabled individually without impacting other modules. To install the plugin, users need to meet a few prerequisites: DSH v0.1.0 or newer, Node.js version 22.19 or higher, and the pnpm package manager installed globally. Once prerequisites are met, a single CLI command dsh plugin add beijingwahw/dsh-companion --profile web installs the plugin automatically.

This plugin is designed for DSH users who want to better organize their conversation history, reduce unnecessary API costs, and speed up finding information in past conversations. A typical workflow starts with enabling only the modules you need via the configuration panel, then using the built-in tools to export selected conversations, generate concise handoff summaries for context inheritance across sessions, and monitor API spending against set monthly or daily budgets. Users can also run semantic or keyword searches across all past conversations, and synthesize new answers from existing knowledge across multiple sessions.

The plugin is released under the open-source MIT license, so it is free to use, modify, and distribute for any purpose. It prioritizes user privacy and security: all user data is stored only locally in the DSH plugin sandbox, and API keys are encrypted with AES-256-GCM before being saved to disk. There is no telemetry or tracking code built into the plugin, and no user data is sent to any third-party servers. Before first run, users should verify that their DSH and Node.js versions meet the stated requirements to avoid installation errors.

这是一款专为 DeepSeek Harness(DSH)开发的原生 Cordis 插件,基于 DSH 插件 SDK 构建,提供对话智能导出、上下文交接摘要、API 成本优化、全局对话检索、本地语义检索、对话知识资产管理、跨会话知识合成共七大核心功能。所有模块都是独立的 Cordis 子插件,可任意组合启停,互不干扰。用户可通过 DSH CLI 一键安装,命令为 dsh plugin add beijingwahw/dsh-companion --profile web。

本插件面向需要系统化管理 DeepSeek 对话历史、优化 API 调用成本、提升知识检索效率的 DSH 用户。典型工作流包括:导出需要留存的对话、生成历史对话的交接摘要用于上下文继承、监控 API 调用成本避免超支、通过本地混合检索快速定位历史对话、从历史对话中聚合生成新知识回答新问题。每个模块都支持独立开关,用户可按需启用功能。

本插件遵循 MIT 开源许可,可免费使用和修改。所有用户数据仅存储在 DSH 插件沙箱本地,API Key 通过 AES-256-GCM 加密存储,不上传第三方服务器,无遥测追踪,安全性较高。使用前需要满足前置要求:DSH 版本 ≥ 0.1.0,Node.js 版本 ^22.19 或 ≥24,需要安装 pnpm 包管理器。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin add beijingwahw/dsh-companion --profile web

把 beijingwahw/dsh-companion 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek Companion(精简版)

License: MIT dsh-plugin DeepSeek Harness

English | 中文

版本说明:本仓库为精简版,包含 A–G 七大模块(对话导出 / 交接摘要 / 成本优化 / 全局检索 / 本地语义检索 / 对话知识资产 / 跨会话知识合成)。 开发者版(A–J 九大模块,含执行轨迹分析、Prompt 工作台、多模型竞技场、任务编排、安全审计)请见 beijingwahw/dsh-companion-dev。

DeepSeek Harness 官方伴侣插件 —— 基于 Cordis 框架与 Harness Plugin SDK 构建,为 DeepSeek Harness 平台提供对话智能导出、上下文交接摘要、API 成本优化、全局对话检索、本地语义检索、对话知识资产与跨会话知识合成七大能力。

  • 开发语言:TypeScript(strict: true,ESM)
  • 运行框架:DeepSeek Harness(Cordis ≥ 4.0,一切皆插件)
  • API 直连:DeepSeek 官方 API(https://api.deepseek.com)
  • 数据安全:所有用户数据仅存于 Harness 插件沙箱本地,API Key 以 AES-256-GCM 加密落盘

功能总览

模块 能力 独立开关
A · 对话智能导出 Markdown / PDF / JSON / PNG 长图导出、回合级勾选导出(角色徽章 + 内容预览 + 全选/全不选,仅导出选中回合)、时间戳开关、隐私脱敏(手机号/邮箱/身份证/银行卡/IP 地址/API 密钥/JWT 自动打码)、批量可视化多选(筛选 + 全选 + 已选计数)、多会话批量 ZIP 打包、导出进度实时显示与一键中止;含中文的 PDF 由客户端 canvas 光栅化为免打印多页 PDF(无 window.print() 对话框冻结) enableExport
B · 上下文交接摘要(上下文工程 2.0) 会话选择面板(当前会话徽章 / 筛选 / 选中任意历史会话)、一键生成 ≤500 字四段式交接摘要、map-reduce 分层摘要(超长对话分块压缩,突破单次字符预算,段级缓存复用)、查询聚焦(输入主题定向保留相关内容)、上下文血缘图谱(追踪摘要跨会话传播链路:来源/后代 + 深度)、上下文压力监测(token 估算 + 耗尽预测 + 四级健康建议,交接前一眼看清"还能聊多久")、可编辑、复制到剪贴板、保存为模板、导入摘要作为新对话的 system 首条消息实现上下文继承、摘要质量体检(纯本地评分:词元覆盖 / 四段式结构 / 长度纪律 / 压缩比 + 漏词清单——摘要丢了什么一眼可见) enableHandoff
C · API 成本优化(开发者模式 + 预测性成本智能) API Key 加密托管、官方动态计价引擎(每小时抓取 DeepSeek 与国产厂商官方定价页,新模型/调价自动导入,抓取失败静默降级内置快照)、峰谷分时计价(高峰时段按高峰价计费)、峰谷自动调度(高峰窗口实时解析自官方定价页)、模型智能路由、日/月双档预算 80%/100% 预警并自动暂停非必要调用、缓存命中折扣计费、每日/每周 Token 消耗与费用报表;预测性成本智能:支出预测(OLS 线性回归外推 + 月末投影)、异常检测(中位数 + MAD 鲁棒 z 分数)、what-if 模拟(调用量倍数 / 缓存命中率 / 模型迁移场景沙盘)、变化归因(按模型分解费用变化,定位"这个月多花的钱去哪了");节能顾问(GET /cost/advice:把用量数据翻译成按优先级排序的行动建议——预算刹车摊平日预算、峰谷迁移节省估算、缓存命中率提升潜力、模型迁移候选,每条附月度节省估算) enableCost
D · 全局对话检索 + 对话内搜索 关键词模糊搜索、时间范围筛选、自定义标签增删与按标签过滤、结果点击直达对话、自然语言时间过滤(range=近7天 / 上周 / 本月 等中文与英文表达直接翻成时间窗,未识别静默降级);对话内搜索(Ctrl+F 浮动查找栏,CSS Custom Highlight API 无侵入高亮,大小写/全词开关、查询历史、流式输出期间自动重同步) enableSearch
E · 本地语义检索(自适应检索系统) 纯本地混合检索引擎:BM25 词法 + 字符 trigram 哈希向量语义近似 + RRF 倒数排名融合 + 时序感知加成,检索质量显著超越关键词匹配且零外部依赖;查询智能(拼写纠错 + 从你的语料学到术语关联的共现扩展,响应携带溯源注记)、质量诊断(相关度强度 + 双通道覆盖率 + 可执行建议)、相关性反馈学习(点击即反馈:查询词并入会话点击画像,后续检索温和上浮你最终打开过的会话——饱和计数 + 90 天半衰 + 35% 封顶三重防漂移,越用越懂你)、MMR 多样性重排(λ=0.7 贪心选择,头部结果从"最优的重复"变成"最优且互补的组合")、知识地图(全部会话质心贪心聚类为主题簇,发现"重复解决过哪些问题",点击簇标签直达深入检索)、查询建议(输入框自动补全:语料前缀补全 + 共现续写 + 点击画像加权,"你的语料告诉你该搜什么")、命中解释(每条命中携带透明账本:词法命中词 × 频次、语义形状相似度、新近/反馈加成分解 + 一句话人话摘要——"为什么是这个会话"一目了然)、零命中救援(检索失败自动放宽查询:宽阈值纠错 0.35 + 噪声词剔除后重试,救援过程全溯源可回退)、检索盲区分析(零命中查询自动入日志,词元级聚合挖掘"反复搜索但历史无覆盖"的主题——次数 × 停留跨度 × 新近度评分,告诉你该补什么知识)、主动脉搏(主动洞察引擎:盲区缺口 + 反馈学习画像 + 索引健康三类信号源即时聚合为洞察卡片,按严重度排序、封顶 6 条,推送克制)、在线学习排序(轴线 28,FTRL-Proximal:点击即训练——skip-above 正负例配对 + 逐坐标自适应学习率 + L1/L2 正则,学到的乘数温和上浮你更可能点开的会话(±30% 封顶、warmup 渐进),模型持久化重启不丢);语义/关键词模式一键切换、语义排名徽章(词法/语义名次)、命中摘要片段;惰性增量索引(updatedAt 漂移检测 + 5 秒节流),语料统计与倒排表增量维护(无过滤查询免全语料扫描,实测提速 37 倍);负向词排除(-词 修饰符:docker 网络 -k8s 把含排除词的会话整体出局——排除是硬约束不是降权,判定与索引同源分词,响应附 negations 溯源);命令面板 find <词> / map [minSize] / blindspots / pulse enableRetrieval
F · 对话知识资产 把对话升级为可积累的知识资产:实体抽取(纯本地规则抽取命令 / 路径 / 技术专名 / 代码标识符 / 中文术语 / 版本号六类实体,零 LLM 调用)、自动标签建议(freq × 类型权重 × IDF 打分推荐标签,一键应用,尊重用户判断)、关联会话推荐(实体重叠 + IDF 加权 + 余弦式归一,回答"还有哪些对话在谈同一件事")、全局实体图谱(点击实体直接发起检索,知识变检索入口)、主题趋势演化(实体动量:近窗口 vs 上一窗口频次变化率,rising / falling / stable 三向判定 + 最近 8 周逐周覆盖时间线,一眼看出"最近在火什么、什么在退烧")、认知引擎(前瞻记忆 / 间隔重复 / 类比检索 / 遗忘预测 / 节律自适应 / 认知负荷调度,轴线 20–25)、图认知引擎(知识大陆:实体共现图上的 Louvain 社区发现,知识域自然聚块 + 骨架实体,轴线 26;星图导航:个性化 PageRank 从查询实体多跳浮现隐性关联,轴线 27;主题漂移:BOCPD 贝叶斯变点检测定位"注意力何时从 A 切到 B",轴线 30;记忆固化:MinHash-LSH 近重复聚类——同一问题的多次出现折叠为强化度,重复从污染变资产,轴线 31);知识考古(轴线 32):会话流时间切片 + 逐纪元 Louvain 社区发现——相邻纪元社区血脉匹配产出板块事件(新生 / 延续 / 分裂 / 合并 / 消亡),回放知识版图的地质史;回声雷达(轴线 33):会话级 MinHash 复发检测——回声簇 + 平均复发周期("你每 12 天重新问一次 docker 网络")+ 近窗回声率,复发 ≥3 次的主题建议固化为交接模板;知识暗物质(轴线 34):实体共现图上的链路预测——CN / Adamic-Adar / Resource Allocation 三指数给"从未同场出现但共享强邻居结构"的实体对打分,检测该连而未连的知识对(你的历史暗示相关、却没有任何一场对话同时谈到的暗区) enableKnowledge
G · 跨会话知识合成(Deep Research) 面向全部历史对话的深度研究引擎:块级检索(会话按回合分块,词法命中率 + trigram 余弦双通道打分)、证据选择(次模组合优化:设施选址目标 = 块相关分 + 问题方面覆盖,惰性贪婪逼近 (1−1/e) 最优——互补证据优先、冗余证据边际增益自动归零,防单一会话垄断证据)、契约式合成(只用证据作答 + [编号] 引用标注 + 证据不足时明确声明,结论先行、矛盾明示)、知识演化追踪(跨会话信念版本化:同一主题的版本号/数值随时间变化即演化事件,语义化版本比较判定升级/回退,生成"你现在应该相信什么"的信念时间线——答案不是错的,只是旧了)、证据来源一键跳回原会话;研究预演(POST /synthesis/preview:零 LLM 证据预演——先看将采用的证据、方面覆盖与 token 预算占用,再决定是否花钱合成);命令面板 research <问题> 同通道 enableSynthesis

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-mcp-diff 下一个 Next dsh-retrace →