前言¶
在 DeepSeek Harness (DSH) 中管理全局上下文或系统提示词,通常涉及手动在每条消息中输入,或者维护本地的 Markdown 文件。dsh-custom-instructions 插件提供了一个类似 Codex 的全局指令编辑入口,允许通过图形界面直接修改生效文件,无需在每条对话中重复输入相同的背景信息或指令。
插件定位¶
- 名称:dsh-custom-instructions
- 维护者:lyke-61
- 功能:提供全局指令编辑面板,将指令写入
~/.dsh/AGENTS.md,该文件会被 DSH 内置机制读取并应用到所有会话。 - 协议:MIT
核心功能¶
- Codex 风格编辑:在设置面板的“Custom Instructions”区域编辑指令,内容直接保存到
~/.dsh/AGENTS.md。 - 全局生效:基于 DSH 内置的
dsh-agent-instructions机制,配置对当前机器上所有会话和所有模型生效。 - 所见即所得:使用等宽字体编辑器实时预览文件内容,保存操作会立即反馈成功或失败。
- 零构建:客户端 Bundle 为手写代码,Host 为纯 Node ESM,无需构建步骤。
安装与启用¶
通过官方 CLI 安装插件到 web profile:
dsh plugin --profile web add github:lyke-61/dsh-custom-instructions
安装完成后,重启 dsh web 进程以加载插件层。
使用方法¶
- 打开 DSH 设置,进入 General(通用)页面。
- 在“Permissions”下方找到 Custom Instructions 面板。
- 在编辑器中编写或粘贴指令内容,点击保存。
- 生效时机:
- 新会话:新对话在第一条消息时会自动读取全局指令。
- 当前会话:当前会话会在执行下一次文件操作(如 read、write、edit)后更新指令内容。
兼容性与依赖¶
- DeepSeek Harness 版本:0.1.0-rc.6 (web profile)
- 依赖机制:必须依赖 DSH 内置的
dsh-agent-instructions机制。标准预设默认包含该机制;如果 profile 禁用了dsh-agent-instructions,指令将不会被注入。
总结¶
dsh-custom-instructions 是一个轻量级的全局指令管理工具。它通过简单的设置面板操作,替代了手动维护文件或重复输入指令的方式,适合需要在多会话或多模型间保持统一行为规范的场景。
- GitHub 仓库:https://github.com/lyke-61/dsh-custom-instructions
- 插件目录:https://www.skillhub.cn/plugins/lyke-61/dsh-custom-instructions