v0.5.0

v0.5.0

这是经过 0.5.0-alpha.2 验证后晋升的正式版本，相对该预发布版不增加运行时代码改动。

主要更新

• 支持 DSH 0.1.2-alpha.1 的新版客户端上下文、Markdown 标签与浏览器鉴权接口。
• 创建新模板前保护未保存的模板草稿；取消确认后不会丢失编辑内容。
• 删除其他模板后同步当前模板的磁盘修订号，避免后续保存出现错误的 409 冲突。
• 写入继续采用磁盘内容派生的修订号、进程内串行队列和原子替换；未登录请求不能读取或修改私人指令。

兼容性

• DSH 0.1.2-alpha.1：使用插件 0.5.0。
• DSH 0.1.1-rc.2：继续固定使用插件 0.4.0。
• 更旧 DSH：使用插件 0.3.0。

验证

• 35 项自动化测试通过。
• Ubuntu / Windows Node 24 构建通过。
• DSH 0.1.2-alpha.1 源码兼容与隔离浏览器 E2E 通过。
• npm 打包预检、生产依赖审计与提交产物新鲜度检查通过。

完整变更记录：CHANGELOG.md

v0.5.0-alpha.1

v0.5.0-alpha.1

本预览版适配 DSH 0.1.2-alpha.1，仅供使用官方源码构建的测试者。npm 包发布在 next 标签；稳定版 latest 仍为 v0.4.0。

• 移除已删除的 dsh-client-runtime，改用 Cordis Context 与 UI Renderer slots
• 适配新版 Markdown labels，补齐中英文代码复制和脚注文案
• 所有自定义指令 API 接入 DSH Connection 的 Host/Origin 与浏览器 Cookie 鉴权
• CI 新增官方标签源码兼容检查、源码声明类型检查和带一次性登录的真实 E2E

安装（仅 DSH 0.1.2-alpha.1 官方源码构建）：

dsh plugin --profile web add @huanghai-lab/dsh-custom-instructions@next

验证：Ubuntu/Windows Node 24、32 项测试、官方 alpha 源码构建、隔离浏览器 E2E、tarball 内容检查全部通过。

完整变更

---

Preview release for DSH 0.1.2-alpha.1. It is published under npm next; stable latest remains v0.4.0.

v0.5.0-alpha.2

更新内容

• 创建新模板前保护尚未保存的模板草稿，取消确认后不再丢失编辑内容。
• 删除其他模板后同步当前模板修订号，避免后续保存出现错误的冲突提示。
• 首次加载改为一次一致性快照，同时返回全局内容、模板和历史，并减少模板目录重复扫描。
• 只读概览聚焦项目级 AGENTS.md，移除 Persona 解析和不再使用的兼容面。
• 删除未使用的移动端与 CSS Modules 构建分支、lightningcss 直接依赖和过期内部发布文档。
• 新增仓库级 screenshots.json，明确 Awesome DSH Plugin 商店截图顺序。

安装

这是面向 DSH 0.1.2-alpha.1 源码构建的预发布版本，将发布到 npm 的 next 标签。稳定版 latest 仍保持在 0.4.0。

dsh plugin --profile web add @huanghai-lab/dsh-custom-instructions@next

验证

• 35 项自动化测试通过。
• Windows 与 Ubuntu 的 Node 24 类型检查、构建和提交产物新鲜度检查通过。
• DSH 0.1.2-alpha.1 官方标签源码兼容和声明类型检查通过。
• 隔离 DSH_HOME、插件 tarball 安装和真实 Chromium 完整流程通过。
• 生产依赖审计未发现已知漏洞。

v0.4.0

v0.4.0

本版本把插件升级为可安全迁移的 DSH 指令管理中心，兼容 DSH 0.1.1-rc.2。

• 全局草稿、放弃、撤销与官方 Markdown 预览
• Unicode 模板、激活状态、历史预览与恢复
• revision 冲突保护、原子写入、严格导入与失败回滚
• 中英文界面、窄屏布局、键盘与 ARIA 支持
• Ubuntu/Windows Node 24 CI 与隔离 DSH 真实 E2E

安装：

dsh plugin --profile web add @huanghai-lab/dsh-custom-instructions

旧版 DSH 环境请继续使用 @huanghai-lab/dsh-custom-instructions@0.3.0。

完整变更：v0.3.0...v0.4.0

---

v0.4.0 turns the plugin into a migration-safe DSH instruction manager for DSH 0.1.1-rc.2, with drafts, Unicode templates, history, conflict protection, strict import rollback, bilingual UI, cross-platform CI, and isolated real DSH E2E.

v0.3.0 — 指令管理中心

从单文件编辑器升级为完整的指令管理中心。

新功能

• 多套指令模板：创建/删除/激活切换（激活即替换全局指令，切换前自动入历史）；模板名安全校验（防路径穿越）
• 版本历史：每次保存（含模板激活）自动留档到 instructions/history/，可恢复到任意版本
• 导入导出：模板 + 历史 + 当前内容打包为一个 JSON（dsh-instructions-v1 格式），跨机器迁移
• 项目级指令视图：列出各工作区及其根目录 AGENTS.md 存在性（只读）
• Persona 概览：读取 agentPresets 服务，展示默认 preset 与 persona 段落（只读，打通 system prompt 管理入口）
• 官方风格设置界面：分区卡片布局（全局指令/模板/历史/生效范围），主题变量配色，与 DSH 设置页一致

数据布局

/AGENTS.md.bak               # 单代回滚
/instructions/templates/*.md # 指令模板
/instructions/active.json    # 当前激活模板
/instructions/history/*.md   # 版本历史
```n
## 测试

- 单元测试 13 → 18（新增：模板 CRUD+激活、非法模板名、历史记录+恢复、历史 404、导入导出）

## 验证

- pnpm typecheck ✓
- pnpm test ✓ (18 passed)
- pnpm build ✓（无警告）

## 升级说明

安装方式不变（clone + link 挂载）；升级后重启 DSH 即可。旧数据（AGENTS.md）自动兼容。

v0.2.0

新功能

• 备份/撤销：每次保存把上一版轮转成 AGENTS.md.bak，「撤销上次保存」一键恢复（POST restore 路由 + 前端按钮）
• 字节上限提示：实时 字符数/字节数/上限（65KB）计数，90% 变黄、超限禁用保存；host 端 GET 返回 maxBytes

工程化

• GitHub Actions CI（.github/workflows/ci.yml）：push/PR 自动跑 install + typecheck + test + build；master 推送可选 e2e
• 预构建产物入库：lib/ 提交进仓库，clone 后无需本地构建即可挂载
• Playwright e2e（tests/e2e/instructions.spec.ts + playwright.config.ts）：真实 GUI 冒烟（打开设置页→编辑→保存→撤销），E2E_BASE_URL 驱动，未配置时自动跳过
• rc.6 依赖精确锁定：devDependencies 从 ^0.1.0-rc.6 改为 0.1.0-rc.6 精确版本，避免意外升级引入不兼容

测试

• 单元测试 8 → 13 个（新增：备份轮转、恢复成功/404、非法 action、maxBytes 返回）

验证

• pnpm install --frozen-lockfile ✓
• pnpm typecheck ✓
• pnpm test ✓ (13 passed)
• pnpm build ✓
• pnpm e2e ✓（无 E2E_BASE_URL 时正确跳过）

v0.1.1

修复

• 读写指令文件改用异步 node:fs（readFile/writeFile），不再阻塞事件循环
• GET 读取错误不再一律返回空内容：仅 ENOENT（文件不存在）返回空，其他错误（权限、EISDIR 等）返回 500 和错误信息，避免误覆盖
• 前端快捷键监听改用 useCallback，不再每次渲染重复注册/清理

新增

• 8 个路由测试（vitest）：路径解析、GET 空/有内容/EISDIR 错误、PUT 写入/建目录/无效 JSON/非字符串/405
• vitest 配置

验证

• pnpm install --frozen-lockfile ✓
• pnpm typecheck ✓
• pnpm test ✓ (8 passed)
• pnpm build ✓

v0.1.0

修复跨平台 AGENTS.md 路径处理，补充 DSH/Node.js 兼容性与 Web Server 安全说明。

验证：pnpm install --frozen-lockfile、pnpm typecheck、pnpm build、git diff --check。