dsh-instruct-manager

DSH 全局指令管理插件 —— 在 DSH Web 的「设置 → 通用设置」中新增一个「指令」面板，用于编辑 C:/Users/admin/.dsh/Agents.md，让 AI 在每次会话中遵循自定义全局指令。

功能

• 设置面板集成：在「语言」与「外观」之间插入可折叠的「指令」设置项。
• 折叠状态记忆：首次安装默认展开，收起/展开后会记住选择，刷新或重新打开设置仍保持。
• 实时字数统计：右下角显示 当前字数/1500；超过 1500 字后统计变红，保存按钮禁用。
• 保存反馈：保存成功后右上角显示绿色 已保存 ✓，3 秒后自动消失。
• 自动创建文件：插件加载时若 C:/Users/admin/.dsh/Agents.md 不存在，会自动创建该文件及目录。
• 空状态提示：textarea 为空时显示占位文案，引导用户写入指令。

文件结构

dsh-instruct-manager/
├── index.js            # 服务端入口：注册 /instruct/api/read|write 路由
├── client/
│   └── client.js       # 客户端入口：注册 settings.general.item 插槽 UI
├── cordis.patch.yml    # cordis bundle 补丁
├── assets/
│   └── screenshot.png  # 设置面板截图
└── README.md

安装

从 GitHub 安装（推荐）

dsh plugin add https://github.com/KeyboardPrince/dsh-instruct-manager

提示：git 源安装会执行仓库的 prepare 脚本；pnpm ≥10 可能需要你授权 allowBuilds。

从 npm registry 安装

dsh plugin --profile web add dsh-instruct-manager@latest

若插件以其他包名发布，替换为实际包名即可，例如 dsh-better-sidebar@latest。

技术要点

• 合法 cordis bundle：服务端使用 ctx.webServer.register 注册标准 Node HTTP 路由，不依赖 dynamic-package 的 harness 全局。
• 客户端插槽：客户端通过 settings.general.item 插槽注入设置项，使用原生 DOM + React.createElement 渲染。
• 安全限制：API 仅接受本机回环（localhost / 127.0.0.1）请求。

注意事项

• 字数上限为 1500 字（按 JavaScript 字符串长度计数）。
• 指令文件路径固定为 C:/Users/admin/.dsh/Agents.md，修改后对所有新会话生效。