dsh-nexus

Nexus — DeepSeek Harness 的记忆层：零配置、成本自保。

安装（30 秒，就三步）

dsh plugin --profile web add github:chenqiuyushuang/dsh-nexus    # 或发布后：add @chenqiuyushuang/dsh-nexus
dsh web

完成。 首个会话自动注入记忆索引；直接说『记住 X』即可使用。无需任何配置、无需外部服务、无需手改任何文件。

前提一行：装过 DSH（CLI 在 PATH）并已用过 web profile。你只需要上面一条命令。 更傻瓜的路径：在 dsh-plugin.org 市场里点安装（等价命令 + 一键），后续跟进收录。

可选增强（不做也能用）

• 开启 LLM 收尾提炼（默认关 = 纯确定性零 token 档）：在 ~/.dsh/profiles/web/cordis.patch.yml 加一段 extractorLlm（见下方安装节）。
• 使用说明/设计/路线图见文档索引。

安装（发布后）

dsh plugin --profile web add @chenqiuyushuang/dsh-nexus
dsh web

零配置：首个会话开始注入记忆索引；对话说『记住 X』即可零 token 入库。可选增强（最多 5 项、均有默认）：sqlite 后端 / 向量检索 / 严格度。

设计文档

• docs/NEXUS-DESIGN.md —— 主设计稿（§1-16：定位、四层证据、架构、数据模型、管线、评审处理、排障）
• docs/RELEASE-LADDER.md —— 版本阶梯（v0.2 MVP → v0.3 聪明版 → v1.0 证明版）
• docs/DEVELOPMENT-PLAN.md —— 开发计划（Phase 0-6 + 里程碑）
• docs/NEXUS-DESIGN-BRIEF.md —— 对外评审简报（一页纸）
• 证据链：reference-analysis.md（162 插件普查）· flagship-memory-study.md（五家厂商）· brain-memory-study.md（脑科学）· design-v0.2.md（决策工作簿）

用户如何安装（对外）

前置：已安装 DSH（dsh CLI 在 PATH，建议 dsh --version 确认）+ pnpm 在 PATH；web 或其他 profile 已存在。

# 方式一（GitHub 源，未发布 npm 前就可用）：
dsh plugin --profile web add github:chenqiuyushuang/dsh-nexus

# 方式二（npm 发布后）：
dsh plugin --profile web add @chenqiuyushuang/dsh-nexus

# 验证与启动：
dsh plugin --profile web list | grep nexus
dsh web

零配置：无需任何外部服务；web profile 自带存储栈；dsh.bundle 声明会自动挂载插件行（无需手改 profile patch）。重启后首个会话即注入 ## 记忆 索引。

可选增强（~/.dsh/profiles/<name>/cordis.patch.yml）：

- id: nexus
  name: '@chenqiuyushuang/dsh-nexus'
  config:
    extractorLlm:              # 开启 LLM 收尾提炼（默认无 = 纯确定性零 token）
      provider: deepseek
      model: deepseek-chat

备注：git 源安装时 pnpm 可能会提示 allowlist prepare 构建（@chenqiuyushuang/dsh-nexus），按提示把该 key 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 即可——这是 pnpm 对 git 依赖的标准安全流程。

开发

npm install      # deps 与 DSH peer 包（rc 版，本地以 DSH 源码为准校对 API）
npm run typecheck
npm test
npm run build    # esbuild → lib/index.js（宿主依赖外部化）

已知缺口：lib/types/*.d.ts 声明产物待与 DSH 一致的 tsdown 管线接入（v0.2 发布前置项，见 RELEASE-LADDER）。

命名与市场识别

• npm：@chenqiuyushuang/dsh-nexus（插件名 'nexus'，域 nexus_memory，事件 nexus/memory/*）
• keywords 含 dsh-plugin —— dsh-plugin.org 市场按此识别插件（不是按名字）

安装与配置（pub 后）

dsh plugin --profile web add @chenqiuyushuang/dsh-nexus
dsh web

# 可选：使用 sqlite 后端与 LLM 收尾提炼（web profile 默认 json 即可运行）
- id: nexus
  name: '@chenqiuyushuang/dsh-nexus'
  config:
    mode: standard            # strict | standard | loose
    indexBudgetBytes: 1024    # 冻结索引预算
    extract: reminder         # deterministic | reminder | off
    extractorLlm:             # 可选：提醒提炼的模型路由
      provider: deepseek
      model: deepseek-chat
    autoDegradeDays: 7        # 注入 7 天零使用 → 自动只写不读

零依赖底座：不需要外部服务、无需原生编译；存储跟随宿主后端（web=json），sqlite 为一行升级。

bundle 声明：本包通过 package.json 的 dsh.bundle + cordis.patch.yml 声明组合包层（社区插件标准），dsh plugin add 后自动进入 profile 的 dsh.profile.bundles 并挂载插件行——若曾以旧版（无声明）安装，重跑一次 add 即可。

License

MIT