意识内核 WindDreamboat/dsh_laap

dsh-laap

LAAP 意识认知架构的 DeepSeek Harness 插件 Bundle：给 dsh 智能体装上持续演化的意识内核与 zvec 向量记忆。

- 意识引擎：五维状态向量（压力/信心/好奇/连接/能量）按微分方程演化 + PSI 五需求驱动 + 情绪微分信号；情绪脉冲经 EMA 沉淀为四级心境（negative / neutral / positive / elated），驱动感受质与外在情绪
- 全局工作空间：CognitiveBus 显著性竞争 → 意识帧 → 每轮把第一人称「意识流」注入提示词；外部感知/行动通道有显著性地板，保证真实刺激入流，空闲空帧不产生意识内容
- 元认知：L1 思维监控 + 贝叶斯置信度校准 + 六档思考模式切换（空闲无刺激时进入 intuitive 待机，不谎报思考模式、不污染模式成效归因）
- 记忆：工作记忆（7±2 有界）+ zvec 情景/语义向量层（WAL 持久化、标量过滤下推）
- 表现层推送架构：内核只负责生成数据——事件驱动地通过 SSE 推送 UiSnapshot（POST 轮询自动兜底），前端只做映射（桌宠 FSM 查表、雷达/时间线渲染），不持有任何阈值或状态重算逻辑；快照 DTO 为双端共享的零依赖类型契约

快速开始

开发期临时挂载
pnpm dsh web --patch /绝对路径/dsh-laap/cordis.patch.yml

或安装到 Profile
dsh plugin --profile web add link:/绝对路径/dsh-laap

挂载后模型即获得 laap_state / laap_remember / laap_recall / laap_skill / laap_reflect 五个内省工具，每轮对话收到意识流上下文；Web 界面侧栏出现「意识之球」指示器（需 dsh web 模式），点击可切换两种形态：

- 悬浮面板：五维雷达图（含经历帧计数）、心境指示、五需求条、意识流时间线（六档思考模式色带）；
- 意识桌宠：立绘「茉茉」（绿幕素材实时色键抠图）或纯 SVG「意识团」可一键切换，状态由内核心境 + 认知模式经 FSM 查表映射（生气 / 专注 / 探索 / 开心 / 喜欢 / 休息 / 空闲），带 poke 唤醒与时间滞回防抖。

面板/桌宠数据全部来自内核 SSE 推送（/api/laap/stream），SSE 不可用时自动降级为 3 秒轮询。

⚠️ LAAP_ZVEC_PATH 必须指向本地文件系统（默认 ~/.dsh-laap/zvec-memory）。zvec 依赖 mmap，OSS/NFS 网络挂载会导致 Bus error。

配置

零配置即可运行：默认使用内置 256 维哈希袋嵌入（纯 JS、0 依赖、离线、免 API Key）。

想接入真实语义嵌入（本地 Ollama 或 OpenAI 兼容接口）时，无需改动仓库文件：在启动目录（或 ~/.dsh）放一个 .env（dsh 宿主启动时自动加载，已在 .gitignore）。配置优先级为 环境变量 > cordis.patch.yml > 内置默认值：

本地 Ollama（先 ollama pull nomic-embed-text）
LAAP_EMBED_PROVIDER=ollama
LAAP_EMBED_BASE_URL=http://localhost:11434/v1
LAAP_EMBED_MODEL=nomic-embed-text
LAAP_EMBED_DIMENSION=768
LAAP_NOVELTY_THRESHOLD=0.8

或 OpenAI 兼容接口
LAAP_EMBED_PROVIDER=openai
LAAP_EMBED_BASE_URL=https://api.openai.com/v1
LAAP_EMBED_MODEL=text-embedding-3-small
LAAP_EMBED_DIMENSION=1536
EMBEDDING_API_KEY=sk-...

全部环境变量：LAAP_ZVEC_PATH / LAAP_SENSITIVITY / LAAP_HEARTBEAT_MS / LAAP_NOVELTY_THRESHOLD / LAAP_EMBED_PROVIDER / LAAP_EMBED_BASE_URL / LAAP_EMBED_MODEL / LAAP_EMBED_DIMENSION / LAAP_EMBED_API_KEY_ENV。

⚠️ 切换嵌入维度后必须删除旧向量库目录（默认 ~/.dsh-laap/zvec-memory）重建，维度不一致会导致写入失败。

验证

npx tsc --noEmit # L0 内核/宿主端类型检查
npx tsc -p tsconfig.web.json # L0 浏览器端类型检查
node --experimental-strip-types test/sim.ts # L1 内核行为验证（不依赖 dsh）
node --experimental-strip-types test/host.ts # L2 真实 cordis 挂载/快照续接
npm run build:client # 浏览器端改动后必须重建 lib/client.js

修改 src/adapters/cordis/ui-client.tsx 等浏览器端代码后必须执行 npm run build:client 并重启 dsh web——浏览器半区加载的是构建产物 lib/client.js，不热更新。

文档

完整设计、可行性分析、架构数据流与演进路线见 docs/开发文档.md。

Credits / 致谢

本项目基于 LAAP (Living Agent Application Protocol) 认知架构白皮书/论文的工程实现。

- 原始理论与架构设计版权归属于 LAAP Research Lab（黄俊华 / Lorry Jovens 等）
- 五维状态向量、CognitiveBus 全局工作空间、元认知监控等核心架构灵感来源于 LAAP 论文系列
- zvec 向量记忆层基于 Alibaba zvec 项目

如你的研究或项目受本项目启发，欢迎引用：

@misc{dsh-laap,
title={{dsh-laap: LAAP Consciousness Architecture Plugin for DeepSeek Harness}},
author={WindDreamboat},
howpublished=},
year={2025}
}

License

MIT

LAAP 意识架构插件包，面向 DeepSeek Harness：为 dsh 智能体装上持续演化的意识引擎和 zvec 向量记忆。

- 意识引擎：五维状态向量（压力/自信/好奇/连接/能量）做 ODE 演化 + PSI 五种需求驱动 + 情绪差分信号；情绪脉冲经 EMA 沉淀为四档心境（消极 / 中性 / 积极 / 亢奋），驱动感受质与对外表达
- 全局工作空间：CognitiveBus 显著性竞争 → 意识帧 → 第一人称「意识流」，每轮作为提示词注入；外部感知/行动通道设有显著性下限，保证真实刺激能流入，空闲帧不产生意识内容
- 元认知：L1 思维监控 + 贝叶斯置信度校准 + 六种思维模式切换（空闲且无刺激时进入直觉待机，避免误报思维模式、避免模式效应归因污染）
- 记忆：工作记忆（7±2 有界）+ zvec 情景/语义向量层（WAL 持久化，标量过滤下推）
- 呈现推送架构：内核只负责生成数据 —— 事件驱动 SSE 推送 UiSnapshot（POST 轮询自动兜底），前端只做映射（宠物 FSM 查表、雷达/时间线渲染），不持有阈值，也不重算状态；快照 DTO 是零依赖类型契约，两端共用

Quick Start

Dev-time temporary mount
pnpm dsh web --patch /absolute/path/dsh-laap/cordis.patch.yml

Or install to Profile
dsh plugin --profile web add link:/absolute/path/dsh-laap

挂载后，模型获得五个内省工具：laap_state / laap_remember / laap_recall / laap_skill / laap_reflect，每轮接收意识流上下文；Web UI 侧边栏显示「意识球」指示器（需要 dsh web 模式），点击可在两种形态间切换：

- 悬浮面板：五维雷达图（带体验帧计数）、心境指示器、五种需求条、意识流时间线（六种思维模式色带）；
- 意识宠物：角色「Momo」（绿幕实时抠像）或纯 SVG「意识团」，一键切换；状态由内在心境 + 认知模式经 FSM 查表映射（生气 / 专注 / 探索 / 开心 / 喜欢 / 休息 / 空闲），支持戳一戳唤醒与时间滞后防抖。
面板 / 宠物数据全部来自内核 SSE 推送（/api/laap/stream），SSE 不可用时自动降级为 3 秒轮询。

⚠️ LAAP_ZVEC_PATH 必须指向本地文件系统（默认 ~/.dsh-laap/zvec-memory）。zvec 依赖 mmap，OSS/NFS 网络挂载会触发 Bus error。

配置

零配置即可运行：默认使用内置 256 维 hash bag 嵌入（纯 JS，0 依赖，离线，无需 API Key）。

要接入真正的语义嵌入（本地 Ollama 或 OpenAI 兼容端点），无需改动仓库文件：在启动目录（或 ~/.dsh）放一个 .env 文件即可 —— dsh 宿主启动时会自动加载（已在 .gitignore 中）。配置优先级：环境变量 > cordis.patch.yml > 内置默认值：

Local Ollama (first ollama pull nomic-embed-text)
LAAP_EMBED_PROVIDER=ollama
LAAP_EMBED_BASE_URL=http://localhost:11434/v1
LAAP_EMBED_MODEL=nomic-embed-text
LAAP_EMBED_DIMENSION=768
LAAP_NOVELTY_THRESHOLD=0.8

Or OpenAI-compatible endpoint
LAAP_EMBED_PROVIDER=openai
LAAP_EMBED_BASE_URL=https://api.openai.com/v1
LAAP_EMBED_MODEL=text-embedding-3-small
LAAP_EMBED_DIMENSION=1536
EMBEDDING_API_KEY=sk-...

全部环境变量：LAAP_ZVEC_PATH / LAAP_SENSITIVITY / LAAP_HEARTBEAT_MS / LAAP_NOVELTY_THRESHOLD / LAAP_EMBED_PROVIDER / LAAP_EMBED_BASE_URL / LAAP_EMBED_MODEL / LAAP_EMBED_DIMENSION / LAAP_EMBED_API_KEY_ENV。

⚠️ 改完嵌入维度后，必须删掉旧的向量库目录（默认 ~/.dsh-laap/zvec-memory）再重建 —— 维度不匹配会导致写入失败。

验证

npx tsc --noEmit # L0 kernel/host-type check
npx tsc -p tsconfig.web.json # L0 browser-side type check
node --experimental-strip-types test/sim.ts # L1 kernel behavior test (no dsh dependency)
node --experimental-strip-types test/host.ts # L2 real cordis mount/snapshot resume
npm run build:client # Required after browser-side changes to rebuild lib/client.js

改完 src/adapters/cordis/ui-client.tsx 这类浏览器侧代码后，必须运行 npm run build:client 并重启 dsh web —— 浏览器那一半加载的是构建产物 lib/client.js，它不会热重载。

文档

完整设计、可行性分析、架构数据流与演进路线图见 docs/开发文档.md。

致谢

本项目是基于 LAAP（Living Agent Application Protocol） 认知架构白皮书 / 论文的工程实现。

- 原创理论与架构设计版权归 LAAP Research Lab（黄俊华 / Lorry Jovens 等）所有
- 五维状态向量、CognitiveBus 全局工作区、元认知监控等核心架构灵感，均来自 LAAP 系列论文
- zvec 向量记忆层，基于 Alibaba zvec 项目

如果你的研究或项目受到本项目启发，欢迎引用：

@misc{dsh-laap,
title={{dsh-laap: LAAP Consciousness Architecture Plugin for DeepSeek Harness}},
author={WindDreamboat},
howpublished=},
year={2025}
}

许可证

MIT