前言¶

DeepSeek Harness (DSH) 作为一个开发者预览工具，通过插件化架构提供灵活性。在智能体开发中，区分“记忆机制是否真正生效”与“模型泛化能力的提升”往往很困难。dsh-memoryos 旨在解决这一问题，通过证据优先的策略，为项目提供长期记忆，并提供严格的基线对比能力。

这是什么¶

这是一个为 DeepSeek Harness (DSH) 提供证据优先长期项目记忆的插件，底层由 MemoryOS 驱动。它是一个纯 JavaScript Bundle，由 tianhao8687 维护，旨在在 DSH 进程中增加作用域内的项目记忆工具和精确的 Provider 使用记录，而不改变 MemoryOS 的持久化、检索、真值解析或上下文编译逻辑。

核心功能¶

• 证据优先的长期项目记忆：专注于围绕记忆主张的可控真实智能体证据。
• 作用域项目记忆工具：提供针对特定项目的记忆访问。
• 精确的 Provider 使用收集：精确记录输入/输出/缓存使用，与估计的 MemoryOS 组件归因分离。
• 严格的 no_memory 基线：在 no_memory 条件下，整个组件（包括控制工具）完全缺失，仅保留使用收集器。
• 控制工具：允许在聊天中开启或关闭 MemoryOS，状态持久化。
• 上下文模式：支持紧凑、渐进、解释和增量上下文模式。
• 显式写入配置文件：支持 supersede、keep_both、reject 等策略。
• 默认只读：默认情况下为只读；写入和受控上下文驱逐需要显式 opt-in。

安装与启用¶

该 Bundle 是 DSH 适配器，不是数据库。必须先启动本地 MemoryOS 服务。

1. 启动 MemoryOS 服务
   在 MemoryOS 源代码目录中运行：

    python -m memoryos --data-dir ./data serve --port 8000 --no-open

2. 安装 DSH Bundle
   使用发布标签以获得可重现性：

    dsh plugin --profile memoryos add github:tianhao8687/dsh-memoryos#v0.2.0
    dsh --profile memoryos --dump-config

3. 配置环境变量
   启动 DSH 时设置相关变量（以 PowerShell 为例）：

    $env:MEMORYOS_BASE_URL = 'http://127.0.0.1:8000'
    $env:MEMORYOS_AUTH_TOKEN = '<local-memoryos-token>'
    $env:MEMORYOS_CONDITION = 'msc_context_only'
    $env:MEMORYOS_BUDGET_TOKENS = '512'
    $env:MEMORYOS_MAX_CONTEXT_CALLS = '1'
    $env:MEMORYOS_RESPONSE_FORMAT = 'deepseek-compact'
    dsh --profile memoryos

典型用法¶

插件提供了通过聊天控制 MemoryOS 的能力，无需桌面快捷方式或 shell 命令：

• 开启/关闭：输入 关闭 OS 或 开启 OS。模型必须调用 memoryos_control 工具。
• 查询状态：输入 OS 现在开着吗？
• 安装命令：

    dsh plugin --profile memoryos add github:tianhao8687/dsh-memoryos#v0.2.0

• 配置环境变量：

    $env:MEMORYOS_BASE_URL = 'http://127.0.0.1:8000'

适用场景与注意¶

• 适用场景：需要严格证据、基线对比以及精细控制记忆上下文范围的开发者。
• 兼容性：已固定在 DeepSeek Harness 0.1.0-rc.5（commit 47f943859bef60e4160492346772ded9b24f765a）。
• 架构注意：Bundle 是 DSH 适配器，不是数据库。SQLite、迁移、检索、当前真值、冲突关系和上下文编译逻辑保留在 MemoryOS 中。
• 默认只读：默认情况下为只读。评估写入和受控上下文驱逐需要显式 opt-in。
• 严格基线：当 MEMORYOS_CONDITION=no_memory 时，整个组件（包括控制工具）完全缺失，仅保留使用收集器。
• 安全提示：插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。

短结尾¶

dsh-memoryos 通过提供严格的 no_memory 基线和精确的追踪，帮助开发者验证记忆机制的有效性。更多细节请参考官方目录：https://www.skillhub.cn/plugins/tianhao8687/dsh-memoryos 或 GitHub 仓库：https://github.com/tianhao8687/dsh-memoryos。