前言¶

在 DeepSeek Harness（DSH）里做长期协作时，常见痛点是：关掉会话后，上周定的流程、踩过的坑、阶段性约定（例如「这两周先用旧接口」）不会自动进入下一轮上下文。多数记忆方案把内容切块、检索、注入，但难以区分「现在为真」与「曾经为真」，也缺少每轮固定可见、可过期的工作准则。

下面介绍社区插件 dsh-cognition-engine（维护者 1720198650，GitHub 仓库 1720198650/dsh-cognition-engine，SkillHub 分类为「记忆」）。它在 DSH 上提供双时态记忆、人定主题、准则本（Playbook）、可选三段式反思引擎，以及挂在主题下的长程待办；状态默认落在本地 JSON，纯 TypeScript、无数据库。插件以当前 DSH 进程权限读写本机文件，安装前请自行查看源码与 MIT 许可证。

这是什么¶

dsh-cognition-engine 是 DSH 的认知与记忆插件：记住事实并标注有效区间，把记忆蒸馏成一页「准则本」并在每轮对话注入（预算约 600 字符），阶段性约定可设 validTo，到期停止注入。与「只堆检索结果」的做法相比，项目强调准则可作废、矛盾可暴露、写入可审计。

入口在输入框上方状态条，点开为浮层面板（记忆 / 主题 / 准则 / 设置等），不挤压对话框。持久化默认使用 cognition-state.json（路径可在配置中指定）。

核心功能¶

双时态记忆¶

记忆带世界时间与事务时间：validFrom / validTo 表示事实何时成立，recordedAt / supersededAt 表示何时录入与被新版本取代；旧版本不硬删，仍可按「当前真值 / 那时为真 / 那时已知 / 联想」等口径召回。长期未被使用的条目会归档（衰减与激活量相关，可通过配置调节半衰期）。写入前有「记忆体检」：废话、敏感信息、注入话术、低权威覆盖高权威等检查，各道可单独关闭。

主题（人定适用范围）¶

主题不是自动聚类，而是由人命名、说明、别名，记忆与准则多对多挂载。注入时可按主题分组，模型先判断任务属于哪类主题再采用相关准则；待办也挂在主题下，而非独立跨天台账。同主题下可查看 memoryConflicts、topicTensions，召回时可 expand 带出同主题其他记忆。

准则本¶

从记忆中半自动蒸馏出 6–12 条短准则，形如 [ctxt-00001] helpful=2 harmful=0 :: 正文，每轮注入；helpful / harmful 可回写，误导过多会退场。候选进待审队列，人工确认后才生效；可设有效期，过期自动停用并分组复核。与现有准则疑似矛盾时打 conflictWith，由人工裁决。

反思引擎与长程任务¶

反思为 THESIS → ANTITHESIS → SYNTHESIS 三段式，默认关闭；开启后可选用本地占位或真实模型。工具 cognition_reflect 的 action: playbook 可触发准则蒸馏（需真实模型）。

长程任务通过 manage_long_task 管理；未完成事项在 cognition_context 的 ongoing 中按主题分组，新会话可先读取跨会话摘要（≤400 字）。

Agent 工具一览¶

数据与安全¶

变更追加 JSONL 审计日志；覆盖前保留快照（最多 5 份）；落盘带 .sha256 校验；跨进程写锁。可选「记忆读取锁」自设口令（无默认口令）。整库可导出 / 导入 JSON。

安装与启用¶

环境要求：DeepSeek Harness、Node.js ≥ 22（package.json 中 dsh 引擎要求 >=0.2.1-rc.2 <0.3.0-0）。当前 npm 包版本为 0.10.0。

推荐从 npm 安装（桌面 profile）：

dsh plugin --profile desktop add dsh-cognition-engine

网页版将 desktop 换为 web。包名见 npm：dsh-cognition-engine。

Windows 一键脚本（资料原文）：

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/1720198650/dsh-cognition-engine/main/scripts/install.ps1 | iex"

Android / dsh-go 本机引擎：

curl -fsSL https://raw.githubusercontent.com/1720198650/dsh-cognition-engine/main/scripts/install-dshgo.sh | sh

安装后重启 DSH，输入框上方应出现认知引擎状态条。默认面板与接口不上锁；需在设置页自行开启记忆读取锁。

可选配置片段位于插件自带的 cordis.patch.yml，例如：

- insert:
    - id: cognition-engine
      name: 'dsh-cognition-engine'
      config:
        decayHalfLifeHours: 168
        assimilateThreshold: 0.55
        overlapThreshold: 0.42
        communityThreshold: 0.3
        maxClusterSize: 8
        tasksFile: ./tasks.json
        stateFile: ./cognition-state.json
        heartbeatHours: 6
        patrolIntervalHours: 3
        recordOnly: true

典型用法¶

1、新会话开场：让 Agent 先调用 cognition_context，拿到摘要与按主题分组的未完成待办。

2、写入与更正：用 cognition_remember 记事实；事实变更时对旧条使用 supersedes；用户纠正使用 kind: correction。

3、召回：按任务需要调用 cognition_recall，选择 strict（当前真值）或 historical / belief；需要同主题上下文时加 expand。

4、准则维护：在面板「准则」页签中「重新蒸馏」（需反思引擎切到真实模型）、手动新增、或在待审队列中逐条接受 / 拒绝；为阶段性约定设置有效期。

5、长程工作：用 manage_long_task 创建与更新任务；设置页可配置巡逻间隔（默认 3 小时），默认仅记录超期提示而不自动调模型复盘。

适用场景与注意¶

适合需要在 DSH 中长期保留项目约定、发版流程、环境偏好，并希望过期约定自动失效、矛盾记忆被显式标记的开发者。若你只需要简单会话内笔记、不需要双时态与准则审计，功能会偏重，可按需在设置中关闭反思、巡逻等选项。

务必注意：插件读写本地 cognition-state.json 及审计日志，与 DSH 同机同用户权限；敏感内容仍应谨慎写入，并善用体检与读取锁。社区目录 SkillHub 插件页 与 GitHub 无 DeepSeek / 幻方官方从属关系，属 DSH「一切皆插件」生态中的第三方条目。

结尾¶

dsh-cognition-engine 把「记得住」和「知道什么时候该作废」拆开处理：双时态记忆管事实沿革，准则本管每轮可见的执行约定，主题与待办把范围与长程工作对齐。若要进一步了解设计与工具细节，可直接阅读仓库 README 与 docs/ 下的主题调研文档。

• 目录页：https://www.skillhub.cn/plugins/1720198650/dsh-cognition-engine
• GitHub：https://github.com/1720198650/dsh-cognition-engine