前言¶

在 DSH 里用 meow-memory 存记忆时，条目落在工作区下的 SQLite 文件里，层级和字段都齐，但默认没有「一眼看全局」的视图。查某条记忆往往要靠搜索或翻库，七层 soul / user / rules / project / topic / fact / lesson 之间的分布也不容易直观感受。

dsh-meow-constellation（记忆星图）是社区维护者 yuyun-git 提交的 DSH 客户端插件：宿主只读 <workspace>/.dsh-meow/memory.db，浏览器里用 Canvas 2D 把七层记忆画成可旋转、可拖拽、可点击的 3D 星图；点开光点即可看全文与元数据。数据来自你自己的库，不是演示用的假数据（宿主内运行时）。

下面介绍插件定位、能力、安装方式与典型用法。插件目录见 SkillHub，源码与说明见 GitHub（当前 README 标注 v0.1.0 tag，npm 包名 dsh-meow-constellation）。DSH 社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

一句话：把 meow-memory 的七层 SQLite 记忆实时可视化，在 DSH 桌面端右下角悬浮球（或独立 URL）里打开面板。

• 维护者：yuyun-git
• 分类：客户端（dsh.client.platform: web）
• 依赖生态：需已安装 meow-memory；宿主读各工作区 .dsh-meow/memory.db
• 许可：MIT（© 2026，见仓库 LICENSE）

核心功能¶

以下均来自仓库 README，未在资料中出现的细节不写。

七层星图与交互¶

• 七层各占一条同心环、一个纵深平面，颜色与左侧图例对应；图例可单独隐藏某一层。
• 拖拽：拖空白处旋转 3D 视角；拖住某个光点可挪位置（位置记在内存里，「重置视角」还原）。
• 滚轮缩放、自动旋转开关、层级标签、中心「此刻」核心。
• 点击光点：右侧玻璃风格面板展示层级 / 状态徽章、更新时间、重要性星级、项目、子类、目标、命中次数、关键词、全文、关联记忆、记忆 ID（可复制）。

视觉为深蓝星空、发光光点、层环与关联线；README 称灵感来自「记忆星图」静态原型。

实时同步与筛选¶

• 每 4 秒带 mtime 轮询：库未变时只回约 100 字节标记；有变化才重绘，用户拖过的光点位置会保留。
• 面板使用不透明深色背景，避免逐帧毛玻璃在 iframe 里拖慢渲染。
• 筛选：全文 / 关键词 / 项目搜索、「包含归档 / 已完结」开关。
• 左下角可切换工作区；下拉标出各记忆库条数，可选「全部工作区」合并多库。默认打开有效条数最多的主库（避免误选刚写入的空库）。
• API 默认只展示 active 条目；all=1 才包含 archived / stale。

离线演示¶

不在 DSH 宿主内打开页面时（例如直接打开 HTML），自动切到内置演示数据，界面仍可操作；README 说明截图中的示例数据为虚构，不含真实记忆。

安装与启用¶

环境（资料原文）：

• DSH ≥ 0.2.0-rc.1
• Node ≥ 22.5（使用 node:sqlite）
• 已安装 meow-memory

安装命令（来自 README，勿自行拼接 github:owner/repo）：

# 从 npm（发布后）
dsh plugin --profile desktop add dsh-meow-constellation --config.minimumReleaseAge=0

# 本地开发目录 / tarball
dsh plugin --profile desktop add file:/path/to/dsh-meow-constellation --config.minimumReleaseAge=0

装完后重启 DSH 桌面端生效。

启用后右下角会出现发光小圆球：点击或 Alt+M 打开星图；Esc 关闭；面板上有「刷新 / 新窗口 / 关闭」。

也可在浏览器单独访问：

http://127.0.0.1:<DSH端口>/meow-constellation/app

将 <DSH端口> 换成当前 DSH 进程实际监听端口。

典型用法¶

1. 确认目标工作区已通过 meow-memory 写入 .dsh-meow/memory.db。
2. 按上一节安装插件并重启桌面端。
3. 打开星图后，在左下角选择工作区或「全部工作区」；用图例隐藏不需要的层，用搜索框缩小范围。
4. 点击光点阅读详情；需要时复制记忆 ID 或查看关联记忆。
5. 库在其他工具中更新后，等待轮询刷新或点面板「刷新」。

宿主暴露的路由（仅 loopback / localhost，见下文安全说明）：

dir 仅接受宿主自己发现的工作区路径，拒绝任意路径读取。

数据与安全¶

宿主端只做三件事：读 <workspace>/.dsh-meow/memory.db、列出工作区、返回静态页面。

• 数据库以 readOnly 打开，只执行 SELECT *，不写、不改、不注册任何工具。
• 路由只对 loopback / localhost 开放，记忆内容不会暴露给局域网。

插件以当前 DSH 进程权限运行；安装前建议阅读 源码 与 MIT 许可证，确认符合你的安全策略。

代码结构（便于二次开发）¶

lib/index.js            宿主：路由 + SQLite 只读查询
lib/client.js           浏览器：悬浮球 + iframe 面板（shadow DOM 隔离）
lib/constellation.html  星图页面：Canvas 2D 渲染、交互、详情面板
cordis.patch.yml        profile bundle 挂载行

仓库提供：

npm run check     # node --check
npm run smoke     # 用真实 memory.db 跑数据层与三个路由的冒烟测试

适用场景与注意¶

适合：已在 DSH 桌面端使用 meow-memory、希望用空间布局浏览七层记忆、对比项目 / 主题分布、快速点开单条全文与关联关系的开发者。

注意：

• 必须先满足 DSH、Node、meow-memory 版本要求；无 memory.db 的工作区不会出现在列表里。
• 光点拖拽位置仅会话内内存，重置视角会还原布局；持久化布局不在 README 承诺范围内。
• SkillHub 上该插件星标为 0，不代表功能不可用，仅反映社区关注度；版本以 npm / GitHub tag（v0.1.0）为准。

结尾¶

dsh-meow-constellation 把 meow-memory 的 SQLite 记忆从表格/搜索模式换成可操作的 3D 星图，读库只读、路由限本机，适合作为 DSH 客户端里的「记忆仪表盘」。需要安装命令与预览图时，以 GitHub README 为准。

• 目录页：https://www.skillhub.cn/plugins/yuyun-git/dsh-meow-constellation
• GitHub：https://github.com/yuyun-git/dsh-meow-constellation