graycode-for-dsh DSH 插件

Gray Code for DeepSeek Harness 是将 Gray Code（原 VS Code 扩展）重构为 DeepSeek Harness (DSH) 插件的迁移项目。它提供设计/进度/评审/计划文档工作流、永久记忆、工作区检查点、树状分支、提示词模式编排和阶段性 diff 等工具。插件由三个包组成：bundle (graycode/dsh)、plugin (graycode/dsh-plugin) 和 client (graycode/dsh-client)，当前锁定 DSH 版本 0.1.0-rc.6。

developer-tools skills-workflows

如何安装 graycode-for-dsh DSH 插件

dsh plugin --profile graycode add @graycode/dsh

复制不会执行命令。安装 graycode-for-dsh DSH 插件前请核对仓库和版本。

graycode-for-dsh DSH 插件数据来源

graycode-for-dsh DSH 插件快照日期：2026年8月16日

discovered

graycode-for-dsh DSH 插件能做什么

工作流工具：创建、更新、验证、定稿和比较设计/进度/评审/计划文档。
永久记忆：支持唤醒、笔记、召回、压缩、缩放、遗忘和配置，自动注入上下文。
工作区检查点：基于内容寻址 Blob 的创建、列表、预览、恢复、删除、验证和垃圾回收。
树状分支：会话分叉与 sidecar，支持重做、编辑重试、切换、重命名、删除和恢复。
提示词模式编排（D-11=c 文本注入）：模式列表、设置和预览。
阶段性 diff：延迟文件审阅，支持暂存、列表、预览、接受和拒绝（默认关闭）。
活动统计：24 小时热力图、月度及连续会话聚合。
媒体处理：裁剪、缩放、旋转、生成图像和去除背景，使用 sharp 库，可选模型渠道。
文件删除：带 5MB 护栏和 staged-diff 钩子的批量行级删除。
待办更新：基于 DSH 整表快照的增量操作。
通知：Windows 原生 toast + 浏览器通知中心 / noop 降级。
子代理：跳数深度、父链寻址与并发守卫。
可选请求构造层（默认关闭）。
DSH 原生设置页中的「Gray Code」分区，包含 17 分类设置面板。
迁移工具：扫描和导入旧 Gray Code 1.5.4 数据，支持 dry-run。
客户端 UI：shell.overlay 插槽、本地化及 10 个可挂接表面（工作流、概览、记忆、检查点等）。

graycode-for-dsh DSH 插件适合哪些场景

在 AI 辅助开发中管理设计、进度、评审和计划文档。
跨会话保留永久项目上下文，使用记忆工具。
通过树状分支和检查点恢复同时探索多个解决方案。
使用阶段性 diff 和评审文档定稿进行代码审查。
将旧版 Gray Code 1.5.4 数据迁移到新的 DSH 插件格式。

graycode-for-dsh DSH 插件适合谁

使用 DeepSeek Harness 进行 AI 辅助编程，需要结构化工作流和记忆管理的开发者。
现有 Gray Code VS Code 扩展用户，希望迁移到 DeepSeek Harness 生态。

graycode-for-dsh DSH 插件的限制

当前为技术预览，尚未稳定；DSH 版本锁定为 0.1.0-rc.6（npm next）。
@graycode/* 包尚未发布到 npm registry，需要本地构建和打包安装。
阶段性 diff 默认关闭，需要编写工具适配后才能启用。
媒体工具（如 generate_image）若无模型渠道注入则会 fail-closed。
客户端 UI 在 rc.6 中存在上游 GAP 限制（管理视图挂载和浏览器远程通道）。
通知仅支持 Windows 原生 toast，其他平台使用浏览器通知中心或 noop 降级。

graycode-for-dsh DSH 插件的仓库 README 摘录

以下文字摘自 graycode-for-dsh DSH 插件的上游仓库 GrayCodeTeam/graycode-for-dsh 的 README，版权归原作者，仅作引用。

把 [Gray Code](https://github.com/Komeiji-Shiki/Gray-Code)（原 VS Code 扩展）重构为 [DeepSeek Harness (DSH)](https://deepseek-harness.github.io/deepseek-harness/) 插件的迁移项目。 DSH 负责 Agent 循环、会话、工具流水线、权限与 Web 宿主；本仓库只保留 Gray Code 的差异化能力。 > 技术预览：DSH 锁定 `0.1.0-rc.6`（npm `next`）。规划见 [`docs/PLAN_V2.md`](docs/PLAN_V2.md)， > 进度见 [`docs/PROGRESS.md`](docs/PROGRESS.md)，变更见 [`CHANGELOG.md`](CHANGELOG.md)。 ## 能力 | 领域 | 工具 | 说明 | | --- | --- | --- | | Workflows | `create_design` / `update_design` / `create_progress` / `update_progress` / `record_progress_milestone` / `validate_progress_document` / `create_review` / `record_review_milestone` / `finalize_review` / `reopen_review` / `validate_review_document` / `compare_review_documents` / `create_plan` / `update_plan` | Design / Progress / Review / Plan 文档工作流 | | Memory | `memory_wake/note/recall/compress/zoom/forget/config` | 永久记忆 + 自动注入 | | Checkpoints | `checkpoint_create/list/preview/restore/delete/verify/gc` | 工作区快照（内容寻址 Blob） | | Branches | `branch_list/create/reroll/edit_retry/switch/rename/delete/restore` | 树状分支（Session fork + sidecar） | | Prompt | `prompt_mode_list/set/preview` | 提示词模式编排（D-11=c 文本注入） | | Staged diff | `staged_diff_stage/list/prev

阅读完整 README仓库许可: MIT

graycode-for-dsh DSH 插件常见问题

如何安装 Gray Code for DeepSeek Harness？

目前包尚未发布到 npm registry，需要克隆仓库，执行 `pnpm install`、`pnpm build`、`pnpm pack` 生成 tarball，然后用 `dsh plugin --profile graycode add ./graycode-dsh-0.1.0.tgz` 安装，最后用 `dsh --profile graycode` 启动。发布后可直接使用 `dsh plugin --profile graycode add @graycode/dsh`。

需要哪个 DSH 版本？

Gray Code for DSH 锁定 DSH 0.1.0-rc.6（npm next）。如果升级 DSH，需要单独提交兼容性 PR 来更新插件。未经修改的插件无法在其他 DSH 版本上运行。

如何启用阶段性 diff 功能？

阶段性 diff 默认关闭。要启用，需要让写入工具适配 staged-diff 钩子。插件提供了 `staged_diff_*` 工具，但只有经过适配后才会激活。请查阅文档了解如何适配你的工具。

能用这个插件生成图像吗？

可以，插件包含 `generate_image` 工具，但需要配置图像生成模型渠道。如果没有配置渠道，工具会 fail-closed（不会回退到本地模型）。你需要在设置中配置合适的提供商。

如何迁移旧的 Gray Code 1.5.4 数据？

插件提供了两个迁移工具：`migration_scan` 用于预览将要导入的数据，`migration_apply` 用于实际执行导入。建议先以 dry-run 模式运行 `migration_scan` 查看变动。迁移支持导入旧版 Gray Code 1.5.4 格式的数据。