DSH-Context-Pro

DSH Agent 的链感知系统 + 洞察引擎——让模型内化五维认知结构（因果/逻辑/操作/叙事/时间），在回复末尾通过一行 JSON 快照隐式标记，系统在后台提取并维护会话内链图，并对每轮回复做洞察分析（带归因档案），用户全程无感。

定位：不是记忆引擎，不是注入器，是认知结构层。
核心哲学：CoT 放权——系统只做三件事：注入图鉴到 System Prompt + 解析 JSON 快照 + 在 ChainGraph 上做归因洞察（超然层）。

核心机制

链协议模式（主模式）

System Prompt（已含五链图鉴 + 情绪底色 + 末尾 JSON 快照指令）
    │
    ▼
模型 CoT 自由推理 → 生成自然语言正文 + 末尾 JSON 快照行
    │
    ▼
session/event → hook.ts 解析快照 + 更新 ChainGraph + 剥离 JSON 行
    │
    ▼
用户看到纯自然语言回复

五链图鉴通过 ctx.systemPrompt.section() 注入 System Prompt，模型内化后自然运用。末尾 JSON 快照由 hook 自动剥离，用户不可见。

非链模式

当 chains.enabled=false 时，插件退化为简单的上下文整形器，通过 agent/pre-step 拦截消息流做 SELECT/INJECT/MEASURE。

五维认知图鉴

图鉴细节见 docs/Architectural-Thinking.md（已注册为技能 architectural-thinking，模型可发现）。

链间化学反应

五链可相互催化：因果×时间 → 深层归因动力学，逻辑×操作 → 抗脆弱执行手册，叙事×因果 → 沉浸式深度诊断，时间×叙事 → 变革蓝图。详见 docs/Integrated-Catalysis.md（已注册为技能 integrated-catalysis）。

洞察引擎

洞察引擎是链感知系统之上的超然层——只观察、只建议、不干预 CoT。它解决一个核心问题：让 AI 真的越来越懂用户。

它在做什么

每轮模型回复后，洞察引擎在 ChainGraph（会话内的全局结构）上做四步归因：

ChainGraph（会话内的累积知识）
   ↓
6 个分析器产出 InsightItem[]（链间化学反应/迁移预测/置信度趋势等）
   ↓
attributeInsightsPure() 在 ChainGraph 上做归因
   ↓
每条 InsightItem 附带 ConfidenceProfile：
   • nodeEvidence：基于哪些 ChainNode（primary / supporting / contradicting）
   • edgeEvidence：基于哪些结构化关系（parent-child / divergence / cross-chain-link 等）
   • contradictingEvidence：反向证据
   • attributionScore：综合评分 0-1
   • rationale：人类可读的归因路径
   ↓
get_insights 工具暴露归因洞察（模型按需调取，参考非约束）
   ↓
generateTopics() 基于归因洞察生成推荐话题（话术引用真实 ChainNode 内容）
   ↓
用户侧话题卡片（基于 basedOn 档案展示"为什么推荐这个话题"）

它解决的核心问题

关键设计原则

• 零新增存储：归因档案随返回值流转，不持久化
• 洞察千变万化，方法论稳定：评估方法（四步法）结构固定，洞察内容由 ChainGraph 实时生成
• 基于 ChainGraph 多轮对话：跨轮引用让"AI 真的懂我"的感受自然涌现，不需要额外机制
• 超然层纯粹：归因档案是"档案"，不参与 CoT 推理

完整设计文档

详细设计（契约、归因算法、话题生成、生命周期、配置、测试）：docs/insight-engine-design.md

安装与装配

方式 A：DSH Web Profile 安装（推荐，已验证）

# 1. 安装 dsh CLI 到项目（提供 node_modules/.bin/dsh）
pnpm add @deepseek-ai/dsh

# 2. 添加插件到 web profile（写入 ~/.dsh/profiles/web/package.json）
pnpm exec dsh plugin --profile web add @kiwifruit/dsh-context-pro

# 3. 验证已生效
pnpm exec dsh plugin --profile web list

⚠️ dsh 不在全局 PATH 时必须用 pnpm exec；--profile web 会把依赖写入用户级 profile（~/.dsh/profiles/web），不改动工作区 cordis.yml。

方式 B：npm 包手动装配（工作区级）

npm install @kiwifruit/dsh-context-pro

在 cordis.patch.yml 中添加：

- insert:
    - id: context-pro
      name: '@kiwifruit/dsh-context-pro'
      config:
        chains:
          enabled: true
          injectProtocol: true
          maxNodesPerChain: 20
          insight:
            enabled: true

方式 C：全局 CLI 安装（最简两步）

# 1. 全局安装 dsh CLI（需确保 pnpm global bin 在 PATH，或先运行 pnpm setup）
npm install -g @deepseek-ai/dsh

# 2. 直接添加插件到 web profile
dsh plugin --profile web add @kiwifruit/dsh-context-pro

⚠️ 若提示 dsh 命令未找到，请运行 pnpm setup 刷新 PATH，或改用方式 A（项目级 pnpm exec）。

配置完整参考

核心能力

HTTP API 端点

文档导航

目录结构

DSH-Context-Pro/
├── src/
│   ├── index.ts           入口（name/apply/inject）
│   ├── prestep.ts         agent/pre-step 拦截器（链协议模式零干预）
│   ├── config.ts          Config schema（契约先行）
│   ├── skills.ts          技能注册（7 个技能）
│   ├── session-id.ts      统一 session ID 获取工具
│   ├── metrics.ts         可观测性指标收集
│   ├── auth.ts            HTTP 鉴权/限流中间件
│   ├── openapi.ts         OpenAPI 3.1 规范生成
│   └── chains/
│       ├── types.ts       链契约（ChainNode/ChainGraph/ChainIndex/InsightReference）
│       ├── graph.ts       ChainGraph 演化实现（upsert/prune/supersede/ended）
│       ├── index.ts       ChainIndex 临时存储 + 生命周期
│       ├── hook.ts        session/event 监听（提取快照 + 链提取 + 洞察分析 + 话题注入）
│       ├── snapshot.ts    快照 JSON 解析（容错修复 + confidence/diverged/supersede）
│       ├── prompt.ts      五链图鉴提示词段（注入 System Prompt）
│       ├── guide.ts       脉络导览（GPS/轨道图/缺口探测）
│       ├── insight.ts     洞察引擎（5 分析器 + 话题生成 + LRU 内存保护）
│       └── candidate.ts   链节点 → SELECT 候选（仅非链模式）
├── scripts/
│   ├── verify-e2e.ts      端到端装配验证
│   ├── verify-chains.ts   链感知方案验证（40 用例）
│   ├── verify-protocol.ts 图鉴协议内容完整性验证
│   ├── verify-attribution.ts 归因算法验证（23 断言）
│   ├── verify-topics.ts   话题生成验证（13 断言）
│   └── diag-*.ts          会话日志/崩溃诊断工具链
├── docs/                  设计文档 / 技能源文件 / 公约
├── cordis.yml             装配示例（npm 包模式）
├── cordis.patch.yml       发布包自动应用的 patch
└── tsconfig.build.json    构建配置

验证

# 类型检查（用 harness 的 tsc）
cd D:/Git/github/deepseek-harness-master
node --import tsx/esm E:/Deepseek/DSH-Context-Pro/scripts/verify-e2e.ts

# 链感知（40 用例）
node --import tsx/esm E:/Deepseek/DSH-Context-Pro/scripts/verify-chains.ts

# 协议内容完整性
node --import tsx/esm E:/Deepseek/DSH-Context-Pro/scripts/verify-protocol.ts

# Cordis 配置校验（122 文件）
node --import tsx/esm scripts/verify-cordis-config.ts

设计决策

发布到 npm

npm run build
npm publish --access public

当前版本：0.3.0 | 协议：GPL-3.0 | 仓库：https://github.com/kiwifruit13/dsh-context-pro