前言¶
DeepSeek Harness (DSH) 采用插件化架构，为智能体提供长期记忆是其中的关键环节。ZCode 提供了基于提取子代理和 markdown 记忆室的记忆模型，但 dsh-zcode-scribe 在此基础上做了进一步的安全加固。它不仅继承了记忆管理的架构理念，还引入了严格的路径安全规则，防止遍历攻击、Unicode 伪造和 NTFS 备用数据流。
插件定位¶
- 名称:
dsh-zcode-scribe - 作者: BOWLUNA
- 分类: 记忆
- 开源协议: MIT
- 核心价值: 为 DSH 提供一个只读的记忆房间、
scribe_recall工具，以及一套拒绝目录遍历、Unicode 欺骗和 NTFS 备用数据流注入的路径安全规则。
核心功能¶
- 只读记忆室: 基于 markdown 的持久化存储，索引不会静默截断。
- scribe_recall 工具: 已注册的工具，在宿主程序中真实执行，用于从记忆室检索信息。
- 路径安全规则: 包含 52 个测试用例，对路径进行严格校验，拒绝目录遍历、Unicode 欺骗以及 NTFS 备用数据流攻击。
安装与前置依赖¶
在安装之前，请确保已安装必要的前置依赖：
@deepseek-ai/dsh-tools(版本范围>=0.1.5-rc.2 <0.2.0 || >=0.1.6-alpha.1 <0.2.0)@deepseek-ai/schemastery(版本^3.18.2)
安装命令如下：
dsh plugin --profile web add dsh-zcode-scribe
典型用法¶
插件包含测试套件和启动检查工具，可用于验证安装和功能状态：
node test/run.mjs
node tools/boot-check.mjs --port 32050
适用场景与注意¶
- 当前状态: 插件处于早期阶段，目前为只读模式。
- 已实现:
scribe_recall工具已可用，且在真实会话中经过验证。 - 未实现: 写入、提取和窄化写入器功能尚未开放，受里程碑 M0 的限制。
- 功能影响: 当前安装仅改变模型能请求什么（通过注册工具），尚未改变模型知道什么（尚未注入提示词）。
- 架构继承: 记忆模型源自 ZCode，包括提取子代理和清单，但不需要依赖 ZCode 的完整安装。
结语¶
dsh-zcode-scribe 为 DeepSeek Harness 提供了一个安全、可扩展的长期记忆基础。它通过严格的路径安全检查和只读模式，降低了记忆注入和路径遍历的风险。随着里程碑 M0 的达成，后续将开放写入和提取能力。
