deepseekplugins

DeepSeek Harness plugin

dsh-custom-instructions-huanghai

Custom instructions editor for the DSH web GUI: a settings page (side bar → 设置 → 自定义指令) that edits the global instruction file ~/.dsh/AGENTS.md, applied to every chat on the machine. Hot-pluggable —

Tools & Capabilities
Jump to install

Source facts

Repository
huanghai-lab/dsh-custom-instructions
Latest update
Aug 15, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/huanghai-lab/dsh-custom-instructions
Plugin: dsh-custom-instructions-huanghai
Author: huanghai-lab

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-custom-instructions

> DSH Web GUI 的「指令管理中心」 —— 在设置页可视化管理对所有聊天生效的全局指令、多套指令模板、版本历史，并一览项目级指令与当前 persona。

![CI](https://github.com/huanghai-lab/dsh-custom-instructions/actions/workflows/ci.yml) ![License](LICENSE)

这是什么

在 DSH（DeepSeek Harness）Web GUI 的侧边栏 设置 → 自定义指令 提供完整的指令管理界面：

  • 全局指令：一个大文本框，内容就是 ~/.dsh/AGENTS.md（用户全局指令文件，每次会话自动加载），保存即生效
  • 指令模板：保存多套指令集（写作规范、代码规范、研究规范……），一键激活切换，支持导入导出
  • 版本历史：每次保存自动留档，可回退任意历史版本
  • 生效范围与 Persona：一览各工作区的项目级 AGENTS.md 与当前默认 agent preset 的 persona 概览

和 ChatGPT 的 Custom Instructions 一样，你可以在这里写"每次聊天都该遵守的规则"——现在还能按场景切换多套规则。

功能

功能说明
全局指令编辑直接编辑 ~/.dsh/AGENTS.md 全文，Ctrl+S 保存
撤销保存每次保存把上一版轮转成 AGENTS.md.bak，「撤销上次保存」一键恢复
指令模板多套指令集的创建、激活切换、删除；激活即替换全局指令（自动入历史）
版本历史每次保存（含模板激活）自动留档，可恢复到任意版本
导入导出模板 + 历史 + 当前内容打包为一个 JSON 文件，跨机器迁移
项目级指令视图列出各工作区及其根目录 AGENTS.md 存在性（只读）
Persona 概览展示默认 agent preset 及 persona 段落（只读，打通 prompt 管理入口）
长度提示实时字符数 / 字节数 / 上限（65 KB），接近变色、超限禁用保存
路径自适应通过 $DSH_HOME/settings.yaml 定位 AGENTS.md，支持 DSH_HOME 覆盖
热插拔dsh plugin add link: 一键挂载，无需改动 DSH 源码

安装

预构建版（推荐）：仓库直接带 lib/ 构建产物，clone 后无需本地构建：

# 1. 克隆
git clone https://github.com/huanghai-lab/dsh-custom-instructions.git
cd dsh-custom-instructions

# 2. 挂载到 DSH 的 web profile（<profile> 通常是 web）
dsh plugin --profile <profile> add link:~/dsh-custom-instructions

源码构建版（开发/定制）：

pnpm install
pnpm build
# 然后同上挂载

卸载：dsh plugin --profile <profile> remove custom-instructions

兼容性

  • 按 DSH 0.1.0-rc.6 客户端接口构建（类型层面，devDependencies 精确锁定）；运行时只依赖 DSH 提供的 webServer 服务与 react peer，不内联任何 @deepseek-ai/* 运行时代码。DSH 升级后若接口变化，用 pnpm build 重新构建即可适配。
  • Node.js 要求：^22.19.0 || >=24.0.0。
  • 编辑器通过 DSH Web Server 写当前用户的全局 AGENTS.md；不要把 Web GUI 暴露给不可信网络（访问控制由 DSH Web Server 负责）。

使用

1. 打开 DSH Web GUI，点侧边栏底部的设置（齿轮） 2. 左侧导航点「自定义指令」 3. 在文本框里写或改指令（比如把 humanizer-zh 的规则贴进去） 4. 点「保存」或按 Ctrl+S 5. 新开聊天会话，指令自动生效；改错了点「撤销上次保存」恢复上一版

开发

pnpm install --frozen-lockfile  # 安装
pnpm typecheck                  # 类型检查
pnpm test                       # 单元测试（13 个路由用例）
pnpm build                      # 构建 lib/
pnpm e2e                        # 真实 GUI e2e（需 E2E_BASE_URL 指向运行中的 DSH）

CI：.github/workflows/ci.yml 在 push/PR 时跑 install + typecheck + test + build。

工作原理

浏览器设置页 (src/client)
   │  GET/PUT /api/dsh-custom-instructions
   ▼
Host 路由 (src/index.ts)
   │  读写
   ▼
~/.dsh/AGENTS.md  ← 每次会话由 dsh-agent-instructions 自动加载
  • Host 端 src/index.ts：注册 /api/dsh-custom-instructions 路由族（GET 读 / PUT 写 / POST 恢复备份），文件路径通过 settings 文档目录解析，直接走 node:fs（绕开沙箱 workspace-write 限制）。
  • Client 端 src/client/：注册 settings.section 列表项（id custom-instructions，order 25），渲染编辑器页面（字节统计、撤销、快捷键）。

常驻指令示例

把以下内容保存进去，所有聊天都会自动带上"去除 AI 写作痕迹"规则（配合 humanizer-zh 效果最佳）：

在回复前检查一遍文字渲染是否正常。
默认将 humanizer-zh 用于中文写作、润色、改写以及普通中文回复，
使表达自然、具体、简洁，避免公式化的 AI 写作痕迹。
不得因此改动事实、数据、公式、代码、逐字引用或用户指定的格式。
回答简洁明了并且逻辑清晰，每次回答都要审视，确保不存在逻辑漏洞。

目录结构

├── src/
│   ├── index.ts                 # Host 端：/api/dsh-custom-instructions 路由
│   ├── invariant.ts             # 无断言 invariant（占位）
│   └── client/
│       ├── index.ts             # Client 端：注册 settings.section
│       ├── InstructionsSection.tsx  # 编辑器页面组件
│       └── api.ts               # fetch 客户端
├── tests/
│   ├── routes.spec.ts           # 单元测试（13 用例：GET/PUT/POST/错误/备份）
│   └── e2e/instructions.spec.ts # 真实 GUI e2e（E2E_BASE_URL 驱动）
├── shared/                      # tsdown client-bundle 构建 preset
├── .github/workflows/ci.yml     # CI：install + typecheck + test + build
├── cordis.patch.yml             # DSH 插件清单（bundle patch）
├── lib/                         # 预构建产物（入库，clone 即用）
├── package.json                 # @huanghai-lab/dsh-custom-instructions
├── tsdown.config.ts             # 构建配置
└── README.md

许可证

Apache-2.0

Back to searchOpen GitHub repository

More related plugins

View category