Skip to content

dsh-cosmic-ocean

Verified

dsh-cosmic-ocean · v1.3.2 · MIT · Web UI

把数字生命的六层记忆、身份、情感、目标、能力画成一片可旋转的 3D 星海;内置 dsh-life 引擎(life_* 工具与 /api/dsh-life 接口原样保留),并直连 QQ 桥接的聊天记录,情感与聊天互相呼应。

Install

dsh plugin add dsh-cosmic-ocean

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Readme

星海识海|COSMIC MEMORY OCEAN

把「数字生命」的记忆、情感与状态,画成一片可以拖拽旋转、滚轮缩放的宇宙星海。 每一次记忆存取、每一次功能执行,都会在对应星域闪一次那种颜色的光。

一个插件装齐三件事:内置 AI生命引擎(原 dsh-life:L1–L6 记忆层 + R1–R8 想起通道、life_* 工具、 /api/dsh-life/* 接口)、内置情感引擎(原 dsh-emotion:七情六欲/漂移/人格、emotion_* 工具), 以及把它们画成可旋转宇宙星海的 3D 前端。dsh-life 与 dsh-emotion 不需要再单独安装—— 装这一个就够,而且原来的工具名和 HTTP 接口一个都没变。 规格来源:星海识海_COSMIC_MEMORY_OCEAN_插件设计规格_V1.0.docx。


长什么样

面板是一整块深空星海,WebGL 实时渲染(不依赖 three.js):

星域 画法 光色
中央星核 身份锚点 + 脉动光核 + 成长/安全双环 #55CFFF
L1 即时记忆 最内层星环,流动光点 #70EFFF
L2 情节记忆 第二层星环 #55BFFF
L3 语义记忆 第三层星环(现有记忆主体) #897BFF
L4 程序记忆 第四层星环 #55E6C1
L5 自传式记忆 第五层星环(时间/里程碑) #FFD36A
L6 元认知记忆 最外层次元光晕 #D2B8FF
情感星云 紫色雾团 + 七情/六欲光点 #D68AFF
认知星域 向外的光丝回路,9 个节点 #A77BFF
成长星环 绕核金色轨道环 #FFD36A
目标星系 目标光点构成的星系 #FFAD55
世界星域 每个会话域一颗绿星 #65E6A5
桥接星域 QQ Bridge 的现场记忆:进行中的话题 / 想说未说 / 群友印象 #58D7FF
安全星环 白色细环 #E4ECFF
时间星河 三臂螺旋「星海」,微微起伏 #BFD8FF
感官星门 青绿色门环 #7CF0D7
异常监测 平时静默,失败/超时才亮红 #FF625F

左侧是记忆目录(六层,可点击聚焦)、星域快捷入口、记忆检索;右侧是选中星辰/星域的详情; 底部是事件时间轴(每条事件一个色点)与「给一个线索召回」;顶部是身份、在线状态与暂停/减弱动效/全屏。

交互

  • 拖拽 旋转星海,滚轮 缩放
  • 单击 星辰:读一次(闪一次读取光),右侧出详情
  • 双击 星辰:聚焦到它所在的那一层
  • 点击星域按钮:镜头飞过去
  • 左侧检索:输入关键词回车,星海定位并闪烁
  • 底部召回:调 POST /api/dsh-life/recall,被想起来的星星按 R 通道依次亮起,时间星河同步留痕
  • 返回:顶部标题旁与底栏各有一个「← 返回」(Esc 同效),按走过的路径逐级退回: 星星 → 星域/某层 → 全景 → 星核;退回时会连镜头一起还原
  • 回对话:顶部标题旁与底栏右侧各有一个绿色「回对话」,把主面板切回 DeepSeek 会话 (走布局服务的 layout.selectPanel('conversation')),星海自身状态保留, 下次点侧边栏「星海识海」还是离开时的样子。 顶栏那个按钮带 -webkit-app-region:no-drag——桌面版窗口顶部是拖拽区, 不加这条会被系统当成"拖窗口"而收不到点击

事件从哪来(不伪造)

星海里的每一次闪光都是真实事件:

  1. 召回流水:轮询 /api/dsh-life/log,新出现的召回记录 → 每条命中记忆闪一次,并从星核拉出一条关联光脉。
  2. 新记忆:/api/dsh-life/memories 出现新 key → 写入光效(亮起 + 扩散环)。
  3. 身份变化:identity.version 变化 → 星核闪一次。
  4. 情感状态:内置情感引擎写出的 states/*.json 的 updatedAt 变化、timeline.jsonl 新行 → 情感星云与七情光点闪。
  5. 目标变化:目标数量增减 → 目标星系闪。
  6. 模型/插件主动推事件:工具 cosmic_ocean_pulse 或 POST /api/cosmic-ocean/events。
  7. 你的操作:点击读取、检索定位、召回、进入星域——都是真实的「读取/执行」事件。

一次事件只播一次光效(event_id 去重、120ms 同源去重);暂停只暂停视觉,数据继续流动; 「减弱动效」会关掉自动旋转、削弱闪烁幅度。

数据来源

  • dsh-life 的 HTTP:/api/dsh-life/home、/memories、/log、/recall(记忆强度、保真度、召回流水)
  • 本插件 host 端聚合的只读文件:lifeHome/{identity,goals,capabilities,checkpoint}.json、reflections.jsonl、 qgHome/states/*.json、qgHome/timeline.jsonl(情感状态与时间线)
  • QQ Bridge 的现场记忆:自动发现桥接根目录后读 /api/socialV2/states 与 /api/socialV2/memory,把 activeTopics / pendingThoughts / memberImpressions 聚合成桥接星域;桥接离线时退回 state/social-v2.json 的只读快照。

生命家/情感家的位置按以下顺序解析: config.lifeHome / config.qgHome → 环境变量 COSMIC_LIFE_HOME / COSMIC_QG_HOME → ~/.dsh-data/life、~/.dsh-data/emotion(数据根可用 DSH_DATA_HOME 整体改掉)。

接口

GET  /api/cosmic-ocean/extras         # 身份/目标/能力/反思/情感状态/时间线 + bridge
GET  /api/cosmic-ocean/bridge         # 只读:QQ Bridge 现场记忆聚合(含最近聊天)
GET  /api/cosmic-ocean/life           # 内置 AI生命引擎的进程内快照(记忆 + 身份 + 召回流水)
GET  /api/cosmic-ocean/chat?limit=60  # 桥接收到的聊天记录(最多 400 条,可加 &scope=)
POST /api/cosmic-ocean/recall         # 用一句话真跑一次八通道召回(写流水、会长记忆)
GET  /api/cosmic-ocean/events?since=N # 增量事件(模型或别的插件推来的)
POST /api/cosmic-ocean/events         # 推一条(或一批)事件
GET  /api/cosmic-ocean/diag?limit=80  # 前端自诊断日志(最近 N 条)
POST /api/cosmic-ocean/diag           # 前端把异常写进来(插件自己用)

/life 和 /chat 是插件自己算的,不需要另装 dsh-life、也不需要外部桥接在跑: 记忆走的是内置引擎的 loadAllItems(),聊天走的是桥接状态文件(state/social-v2.json)。 老接口 /api/dsh-life/{home,memories,log} 依旧保留(内置引擎原样挂载),前端只在自接口失败时才回退过去。

事件体:

{
  "module": "memory:L3",
  "action": "retrieve",
  "target_key": "d55831048df764c5",
  "status": "success",
  "label": "召回「上次说的方案」"
}

module 取值:core、memory:L1..L6、emotion、cognitive、evolution、goal、world、bridge、safety、time、sense、anomaly。 没给 color 时按功能区的表取色;action 决定动画与时长(检索 450ms、写入 550ms、修改 650ms…)。

QQ Bridge 记忆对接

host 端会自动寻找本机的 QQ Bridge,不需要手填端口:

  1. config.bridgeHome
  2. 环境变量 COSMIC_BRIDGE_HOME / QQ_BRIDGE_HOME / QQ_BRIDGE_ROOT
  3. D:\qqaibot\qq-bridge-main
  4. ~/Documents/deepseek-harness/default-workspace/qq-bridge-main 等常见工作区
  5. 工作区里的 qq-bridge* 浅扫

判定条件是目录里同时有 config.json 和 src/bridge.js。端口从 config.consolePort 读, 控制台 token 从 state/console-token 读;请求带 x-console-token,401 时重读 token 再试一次。 桥接没起来时不会报错中断,只会显示 connected:false 和最近一次快照(stale:true)。

对接是只读的:不会改动桥接的记忆。桥接记忆会变成桥接星域里的星,颜色按类型分:

类型 含义 颜色
activeTopic 进行中的话题 #FFCF7A
pendingThought 想说未说 #C9A7FF
memberImpression 群友印象 #6EE7FF

关系线会在这些星辰之间出现:同会话话题链、想说未说接最近话题、群友印象接同会话话题、 桥接会话接世界星域里的同会话星、桥接群友印象接 dsh-life 同 target 的人物记忆、 桥接话题与 dsh-life 话题/事实/事件做中文 2-gram 文本重叠、dsh-life 同 target 人物记忆串联、 情感中心接七情/六欲光点。默认不画这些线;只有点击一颗星辰后,才显示与它直接相关的光线,先连续闪 3 秒,随后保持低亮呼吸;取消选择或点空白处即消失。

聊天与情感互相呼应(1.3.2)

一个 scope(group:757367758 / private:3247305200)同时是三样东西的钥匙: 记忆域、情感域、桥接会话。星海就靠这把钥匙把三者串起来:

  1. 新消息会亮:桥接一收到消息,星海就在桥接星域闪一下(bridge/read),最多 5 条; 紧接着情感星云闪一下(emotion/read,「聊天之后,情绪回看」)。
  2. 点一句话就想起:左栏「CHAT · 聊天」里点某个会话展开最近几句,再点某句 → POST /api/cosmic-ocean/recall 用这句话真跑一次八通道召回(写召回流水、顺带再巩固), 命中的记忆星会一颗颗亮(relation_pulse,700ms,间隔 110ms),并飞过去定位第一条。
  3. 同一个 scope 的七情显示在会话行上:extras.emotions 里同 scope 的七情主导 + 数值, 没接上情感的那条会写「情感未接」。
  4. 不依赖外部 dsh-life:记忆走内置引擎的 readLife(),聊天走桥接状态文件, 两边都在插件进程内算;外部那份没装、或者前缀撞车,都不会再红屏 404。

左栏这块只读不改:不会替你发消息、不会动桥接的记忆,只会推光效和跑召回。

内置 AI生命引擎(原 dsh-life)

从 1.3.0 起,dsh-life 的 host 半端也内置进来了:装这一个插件,life_* 工具和 /api/dsh-life/* 接口直接可用,不需要再单独安装、单独加进 bundle 列表。

  • 原生命引擎代码在 lib/life/(index.js + lib/,8 个模块;原 README 与 LICENSE 一并保留)。
  • 工具名一个都没变:life_home、life_recall、life_memories、life_remember、life_correct、 life_forget、life_identity、life_reflect、life_goal、life_capability、life_tick、life_export。
  • 原 HTTP 接口也不变:/api/dsh-life/{home,memories,log,recall}——外部的 dsh-life-ui 面板照旧能用。
  • 记忆只读、状态旁挂:内容仍然归记忆库(memoryHome/*.json),生命引擎只写自己的 lifeHome/{identity,recall,recall-log},不改写记忆原文。
  • 自动点亮:每个 life_* 调用成功后都会往星海推一条事件;life_recall 会按召回结果逐条推 memory:L2..L5 + retrieve,所以记忆一被想起,星海就自己闪,不用模型手点。
  • 配置用 config.life:memoryHome、lifeHome、emotionHome、bridgeState、autoGC; 不填就和情感引擎一样走家目录探测。
  • 原来的 dsh-life 别同时启用(会重复注册同名工具),在 profile 里 disabled: true 即可。

内置情感引擎(原 dsh-emotion)

从 1.2.0 起,dsh-cosmic-ocean 把 dsh-emotion 的 host 半端内置进来了: 装一个插件,就同时得到星海和情感引擎,不需要再单独安装、单独加入 bundle 列表。

  • 原情感引擎代码在 lib/emotion/(index + lib + tools,保留 MIT 来源说明)。
  • 星海 host 的 apply() 会调用内置情感引擎的 apply(ctx, config),所以原来的工具名不变: emotion_home、emotion_state、emotion_run、emotion_pack、emotion_persona、 emotion_timeline、emotion_params、emotion_memory_feed。
  • 原 HTTP 接口也不变:/api/dsh-emotion/{home,params,state,timeline,bridge,watch,index}、POST /run。
  • 情感参数仍写到 qgHome(默认 ~/.dsh-data/emotion),并同步到桥接 state/emotion.json; 星海前端读到的 qgHome/states/*.json 就是它写的,所以情感星云会自己动。
  • 看护哪些会话默认自动发现(记忆库里一个会话一份 json,就照它看护),也可以用 watchScopes 指定; 每 20 秒扫一次记忆,记忆变了就跑一轮。

配置可以在 profile 的 cordis.patch.yml 里用 config.emotion 覆盖:

- id: dsh-cosmic-ocean
  name: dsh-cosmic-ocean
  config:
    emotion:
      memoryHome: '~/.dsh-data/memory'      # 记忆库在哪(默认自动探测)
      qgHome: '~/.dsh-data/emotion'         # 情感参数落在哪
      bridgeState: '<QQ Bridge>/state'      # 不填就从自动发现的桥接根目录推
      defaultPack: V3-SELF
      autoRun: true
      tickMs: 20000
      quiet: true
      watchScopes: []                       # 空 = 自动发现记忆库里的会话

不填也能跑:memoryHome/qgHome 会走星海自己的家目录探测,bridgeState 会从自动发现的 QQ Bridge 根目录推出来。原来的 dsh-emotion 不要同时再放进 dsh.profile.bundles,否则 工具会重复注册、看护器会跑两遍。

模型怎么用

cosmic_ocean_pulse({ module: "memory:L3", action: "retrieve", target_key: "…", label: "…" })

做完一次真实记忆操作后调用它,星海会闪一次对应颜色的光。别为好看乱推——它和事件时间轴是给人看的事实记录。

安装

从 npm(推荐):

npm i dsh-cosmic-ocean          # 或 dsh plugin --profile <profile> add dsh-cosmic-ocean

也可以直接用源码目录:这个目录就是一个 DSH bundle 插件(dsh-life-ui 同款结构):

  • index.js:host 半端(webServer 路由 + cosmic_ocean_pulse 工具 + 内置生命/情感引擎)
  • client.js:浏览器半端(window.__ModuleLoader__ + sidebar.panellist / main 槽位)
  • cordis.patch.yml:bundle patch
  • lib/life/:内置的原 dsh-life AI生命引擎(life_* 工具与 /api/dsh-life 接口保持不变)
  • lib/emotion/:内置的原 dsh-emotion 情感引擎(工具与 /api/dsh-emotion 接口保持不变)

用 plugin_manager install_bundle 指向本目录,或在 profile 的 package.json 里 "dsh-cosmic-ocean": "link:C:/…/cosmic-ocean" 并把包名加进 dsh.profile.bundles。

三分钟验收

  1. 插件装好后刷新一次正在开的 DSH 窗口(Ctrl+R),左侧竖排图标里会出现「星海识海」。
  2. 点开它:应看到身份「鱼」在中央、六层星环上散着 202 颗记忆星、上方粉色情感星云、底部事件时间轴。
  3. 让我做一次真实记忆操作(或用 cosmic_ocean_pulse),对应颜色的光会闪一下;时间轴同步多一条色点。
  4. 鼠标拖拽/滚轮可转、可缩放;点一颗星看右侧详情;点左侧「L3 语义记忆」只留那一层。
  5. 桥接星域应出现在世界星域旁;点一颗桥接记忆,右侧显示类型/会话/对象/特质,并只显示这颗星的相关光线(先闪 3 秒再保持低亮)。
  6. GET /api/cosmic-ocean/extras 的 bridge.connected 应为 true,counts.memories 大于 0。

打不开 / 第二次点图标一片空白?

DSH 的槽位服务有个「辞让」机制:某个插件条目在渲染时抛过错,宿主会把这个条目从槽位里划掉(abdicated), 之后 ctx.layout.selectPanel('cosmic-ocean') 仍然「成功」,但 main 槽位渲染成空锚点 —— 表现就是第一次能进、第二次点了没反应。

1.3.1 起做了三件事,让它自己好起来:

  • 渲染兜底:面板整棵树外面套了自己的 error boundary,抛错只影响这一屏,不会连累宿主槽位。
  • 卸载兜底:卸载时清定时器 / 断 ResizeObserver / 销毁 WebGL 全部 try/catch(卸载抛错同样会触发辞让)。
  • 看门狗:每 2.5 秒检查 entriesOfSlot('main') 里还有没有我们;没有就注销旧的、重新注册一个全新条目(新条目对象不在辞让集合里),面板随即恢复。

还不行就看诊断日志:

GET /api/cosmic-ocean/diag?limit=80

它落在 ~/.dsh-data/cosmic-ocean/diag.jsonl(可用 COSMIC_DIAG_DIR 改),记录 main-register / main-missing / render-crash / dispose-fail 这些事件,带堆栈。出错时面板上会有「重试 / 重开面板」两个按钮。

许可

MIT。