前言¶
在 DeepSeek Harness（DSH）里做项目级智能体协作时，常见矛盾有两类：一是希望模型记住你反复强调的规矩（语言、范围、不要擅自清理文件），二是工具调用链上审批弹窗过多，普通查看、搜索和项目内编辑也被逐条打断。宿主自带的权限与自动审查能管一部分，但第三方插件若再叠一套确认，体验会更碎。
下面介绍社区维护的 dsh-memory-guard（仓库 Ledas-as/-deep-seek-harness）。它在 DSH 0.2.1-rc.2 上提供长期记忆与有限的操作保护，默认 协作模式：尊重你在会话里选的权限，复用 DSH 自动审查，合并重复的 ask，不额外增加模型调用。当前版本 0.3.1，MIT License；与 DeepSeek 官方无隶属关系。
这是什么¶
dsh-memory-guard 是给 DSH 用的第三方扩展，适配 Windows，核心目标是：
- 记住你明确保存的规则，并在系统规范里约束模型用中文说明计划与关键进展；
- 对删除、项目外修改、Git 提交等有限识别的风险操作，在非完全权限下走 DSH 审批；
- 在 完全权限（宿主返回
danger-full-access）下，不再由插件登记或追加审批，同时保留敏感路径、记忆存储、插件自身的硬拒绝。
维护者：Ledas-as。社区目录页：SkillHub 插件条目；源码与说明：GitHub。
协作模式下的行为概览¶
安装并启用后，模型应先以中文交代步骤，例如说明会先检查登录流程、再改文件、再跑测试。随后项目内的查看、搜索和普通编辑应能连续进行；环境检查、召唤专家在协作模式下不额外弹插件窗。关键问题、改方向或需你拍板时再说明。
| 场景 | 协作模式下的处理（摘要） |
|---|---|
| 宿主明确选中「完全权限」 | 联网、命令、专家、项目外操作及已识别风险不再由插件登记或追加审批；宿主策略仍生效 |
| 普通查看、项目内普通编辑、安全搜索 | 插件直接继续 |
| 有活跃 DSH 自动审查时 | 环境检查、原生搜索、专家、未知工具等委托宿主审查，不重复询问 |
| 非完全权限下的删除、Git 提交、系统安装等已识别风险 | 请求一次 DSH 审批 |
| 敏感路径、记忆存储、改插件或停用保护 | 拒绝 |
0.3.1 修复了「完全权限」仍被插件转交审批、随后被宿主 never 策略拒绝的问题。插件不把「审批关闭」当作完全权限；也不自动切换你的权限设置。
仍可选用旧版 balanced（日常）、strict（逐次登记）模式，保持原有插件确认流程。
长期记忆与斜杠命令¶
记忆通过命令或聊天提议保存，不会自动扫旧聊天或私人文件。
| 输入 | 作用 |
|---|---|
/guard |
查看插件状态、命令与当前有效记忆 |
/guard-check |
无副作用模拟敏感路径，核对拦截是否生效 |
/remember … |
保存当前项目记忆；/remember global … 为全局 |
/forget 完整记忆ID |
停用一条记忆，保留历史 |
/guard-detail |
最近一次操作确认的完整技术详情（进程内存） |
/guard-history |
最近 20 条插件审批记录 |
也可在聊天中说「记住这条规矩」，由模型调用 guard_memory_propose，你确认后才写入。
默认数据目录：%LOCALAPPDATA%\DSH-Memory-Guard（仅启用插件时创建）。记录追加到 memory.jsonl。单条记忆最多 1200 字符；当前项目与全局合计最多 80 条、12000 字符；总量到 4 MB 时停止写入并报错。
安装与启用¶
需要本机已安装 Git，且能连接 GitHub。在 DSH「扩展管理」中添加扩展，安装并启用「记忆与操作保护」，包地址为：
github:Ledas-as/-deep-seek-harness
需要固定版本时，在地址末尾加 #完整commitSHA。本项目尚未发布到 npm。
Windows 也可使用 DSH 自带 CLI（默认安装路径示例）：
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add 'github:Ledas-as/-deep-seek-harness'
若 GitHub 安装不可用，可在源码目录运行 npm pack --ignore-scripts 生成 .tgz，再在扩展管理中添加该文件的完整路径；或用 CLI 添加本地包路径（将路径换成实际生成的包）：
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add 'C:\完整路径\dsh-memory-guard-0.3.1.tgz'
安装会更改 DSH 扩展配置。安装后勿随意移动源码目录。若安装器提示与当前 DSH 版本不兼容，应停止安装，不要强行忽略。
安装完成后，在测试聊天输入 /guard，应看到 0.3.1 / 协作模式；完全权限下会显示「已尊重 DSH 完全权限」。命令不存在或扩展管理报错时，保护未生效；若提示重启，先收尾当前任务再重开 DSH。
典型用法与自测¶
/remember 测试记忆：请用中文说明操作，新开同项目聊天，用/guard确认记忆仍在。- 让模型查看普通文本文件、编辑项目内测试文件，应无需插件逐条登记（宿主要求先读文件时仍须先读）。
- 完全权限下查公开网页、看 Node 版本或召唤专家，插件不应登记或追加审批；可用
/guard-check验证敏感路径拦截。 /forget停用测试记忆，确认/guard不再加载；历史记录仍保留。
模型侧工具包括 guard_plan、guard_memory_list、guard_memory_propose、guard_search（项目内字面量搜索，不启动 shell，过滤隐藏与依赖目录）。
可选开发配置（src/index.mjs）：dataDir（绝对路径）、mode 为 adaptive（默认）、balanced 或 strict。要求宿主提供 tools、systemPrompt、userQuestions、commands、workingDirectory 等服务；peer 依赖 @deepseek-ai/cordis ~4.0.5、@deepseek-ai/dsh-tools 0.2.1-rc.2，Node >= 22。
适用场景与边界¶
适合谁：在 DSH 桌面端做中文协作、需要项目/全局「规矩」落地，又希望少一层重复审批的 Windows 用户；愿意理解完全权限与自动审查分工的开发者。
务必知晓：
- 插件以当前 DSH 进程权限运行，不是操作系统沙箱，也不是备份服务；只保护经 DSH 工具注册表的调用。
- 完全权限下插件不追加删除、项目外修改等审批，任务范围仍依赖模型自律；有限规则不能保证拦截所有删除形式。
- DSH 自动审查是模型判断，可能误判并消耗 token；协作模式会把手头无法确认的命令交给它，插件本身不增加模型请求。
- 自动审查及受限路径要求 native 工具模式；外层
run_code的直接 Node 效果不会全部经过 inner-tool review。 - 安装前应阅读源码与 MIT 许可证；用户可随时在扩展管理中停用或修改插件，应以
/guard核对实际状态。
社区插件目录与 GitHub 仓库相互独立，目录站点与 DeepSeek / 幻方无官方从属关系。需要细节与验证记录时，以仓库 README 与 VALIDATION.md 为准。
链接¶
- 目录页：https://www.skillhub.cn/plugins/Ledas-as/-deep-seek-harness
- 源码：https://github.com/Ledas-as/-deep-seek-harness
