xiaohj233 / dsh-magic-context

Magic Context for DSH

---

项目定位

一个把 Magic Context 移植到 DeepSeek Harness 的适配层：让 DSH 会话使用 Magic Context 的知识注入、上下文管理与记忆能力，并与 OpenCode/Pi 的 Magic Context 共享同一 SQLite 记忆库（harness='dsh' 行隔离）， OpenCode/Pi 行为保持不变。

适合这些场景：

• 在 DSH 中复用已有的 Magic Context 记忆（与 OpenCode/Pi 共享）。
• 希望 DSH 会话获得 m0/m1 知识注入、§N§ 标签、historian 压缩、 Dreamer 定时任务等能力。
• 想要 /ctx-* 工具族（search/memory/note/expand/reduce/embed/recomp/wrapup） 与 todowrite 的 DSH 用户。

能力对齐：注入（m0/m1 双消息、首轮即见、§N§ 首轮打标）、压缩（低上下文 窗口 chunk 预算、historian 独立模型路由、发布后 <session-history> 折叠）、 nudge 双通道、heuristic cleanup、配置桥接——均与 Magic Context 0.36.1 （Pi/OpenCode）语义对齐。

安装

在 DSH profile 的 package.json 中（profile 目录即 $DSH_HOME/profiles/<name>/， dsh plugin --profile <name> install 会自动在该目录执行）：

{
  "dependencies": {
    "dsh-magic-context": "github:xiaohj233/dsh-magic-context#v0.1.0&path:/packages/dsh-plugin"
  },
  "dsh": {
    "profile": {
      "bundles": ["dsh-magic-context"]
    }
  }
}

⚠️ dsh.profile.bundles 请保留你 profile 现有的条目（如 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app、@deepseek-ai/dsh-headless 等），只追加 "dsh-magic-context"。

然后安装依赖并重启 dsh：

dsh plugin --profile <name> install
# 或：cd $DSH_HOME/profiles/<name> && pnpm install

重启后初始化：

dsh-magic-context setup    # 生成 magic-standard 薄 preset
dsh-magic-context doctor   # 验证安装

为新会话选择 magic-standard preset（Web UI: Settings → Agent preset，或 settings.yaml: agent-presets.default: magic-standard）。

⚠️ 使用前提：Magic 的 agent 能力（知识注入、ctx_* 工具、/ctx-* 命令、 historian、Dreamer、Magic 压缩策略）只在新会话选择 magic-standard 预设时 加载。未选择该预设的会话完全按官方语义运行——仅 host 半侧常驻 （共享库初始化 + 状态卡/诊断端点），不会有任何 Magic 干预。想让插件默认 生效，把 settings.yaml 的 agent-presets.default 设为 magic-standard。

依赖包（dsh-magic-context-adapter）由主包的 github: 依赖自动解析，无需单独安装。

首次会话自动创建共享 SQLite（~/.local/share/cortexkit/magic-context/context.db）。

功能一览

• 知识模式：m0/m1 baseline 注入（含 Mural 图像）、auto-search、§N§ tags
• 上下文管理：DshTranscript + SurfaceMutationCoordinator（CAS + outbox saga）、 historian 后台 compartment、Magic 压缩策略、缓存分类 SOFT+/SOFT/HARD
• 自动化：Dreamer 全部任务、Sidekick /ctx-aug、/ctx-recomp /ctx-wrapup /ctx-session-upgrade、/ctx-embed、feedback 桥接
• 维护：setup/doctor、升级契约门、无写回安全（shipped preset 只读挂载）
• Web：状态卡 + Remote 诊断端点

完整对照见 docs/FEATURES.md。

验证状态

• 177/177 测试全绿（dsh-plugin）+ adapter-api 14/14 + typecheck 0 错误
• 已在隔离的非全局 DSH 验证安装：npm 安装 → setup（薄 preset）→ doctor 6/6 → 薄 preset 挂载 → 知识注入（m0/§N§ tags）→ 真实模型链路（本地中转 deepseek-v4-flash 响应 Magic 注入的上下文）→ 共享 SQLite harness='dsh' 行写入
• OpenCode/Pi 零改动（共享 DB 兼容）

约束与边界

• 不修改 DSH 源码；不拦截/改写 llm/stream messages[]；OpenCode/Pi 行为不变。
• 兼容基线：DSH 0.1.0-rc.6（升级先跑契约门）。
• 已知边界见 docs/FEATURES.md（差异记录）。

许可证

MIT（与 Magic Context、DSH 一致）。上游版权声明见各包 NOTICE。