GrayCodeTeam/graycode-for-dsh
把 Gray Code(原 VS Code 扩展)重构为 DeepSeek Harness (DSH) 插件的迁移项目。 DSH 负责 Agent 循环、会话、工具流水线、权限与 Web 宿主;本仓库只保留 Gray Code 的差异化能力。
catalog 简介 / catalog descriptioncatalog description:—
项目介绍Project Overview
GrayCode for DSH 是把原 VS Code 扩展 Gray Code 迁移到 DeepSeek Harness (DSH) 0.1.0-rc.6 的插件项目。它提供 Workflows(Design/Progress/Review/Plan)、永久 Memory、内容寻址 Checkpoints、树状 Branches、Staged diff、图片处理、子 Agent 跳转、17 项设置面板与旧版 1.5.4 数据迁移。安装可通过本地 tarball 加载 @graycode/dsh bundle,或等首次发版后直接 dsh plugin add @graycode/dsh。注意 rc.6 管理视图与浏览器 Remote 通道受上游 GAP 限制未完成;staged diff 默认关闭,需先适配写工具。
GrayCode for DSH is a plugin that migrates the original Gray Code VS Code extension into the DeepSeek Harness (DSH) platform. It provides document workflows (Design/Progress/Review/Plan), persistent memory, content-addressed checkpoints, tree-like branches, staged diff, image processing, sub-agent hops, and a 17-section settings panel, plus migration from legacy Gray Code 1.5.4 data. Install by building a local tarball and adding @graycode/dsh via dsh plugin, or pull from npm once published. Requires Node 22.19+/24+ and pnpm 11.7.0. Caveat: DSH 0.1.0-rc.6 has upstream GAPs blocking the manager view and browser Remote channel; staged diff is disabled by default until write-tool adapters land.
请帮我了解并安装插件:【graycode-for-dsh】【https://github.com/GrayCodeTeam/graycode-for-dsh】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile graycode add @graycode/dsh
把 GrayCodeTeam/graycode-for-dsh 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
GrayCode for DeepSeek Harness
把 Gray Code(原 VS Code 扩展)重构为 DeepSeek Harness (DSH) 插件的迁移项目。 DSH 负责 Agent 循环、会话、工具流水线、权限与 Web 宿主;本仓库只保留 Gray Code 的差异化能力。
技术预览:DSH 锁定
0.1.1-rc.2(npmnext)。规划见docs/PLAN_V2.md, 进度见docs/PROGRESS.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/preview/accept/reject |
延迟文件审阅(默认关闭,写工具适配后启用) |
| Activity | get_activity_stats |
24h 热力 / 月度 / 连续会话聚合 |
| Media | crop_image / resize_image / rotate_image / generate_image / remove_background |
本地图片处理(sharp)+ 可选模型渠道;未注入渠道时模型工具 fail-closed |
| Notifications | notify |
Windows 原生 toast + 浏览器通知中心/noop 降级 |
| Thoughts | — | 可选请求构造层(默认关闭,非契约适配) |
| Settings | — | DSH 原生设置页「Gray Code」分区(settings.section):9 分类设置面板,ctx.settings 持久化 + /graycode 配置通道 |
| Migration | migration_scan/apply |
旧 Gray Code 1.5.4 数据导入(dry-run 优先) |
| Client | 原生 slot + locale + 10 个表面 | workflow 卡片直接挂载 conversation.chat.node;overview/memory/checkpoint/restore/staged diff/settings/activity/scope/notifications UI 通过原生设置区与 /graycode 通道工作 |
Harness 0.1.1-rc.2 已原生提供文件读取/搜索/写入、Todo、自动与手动上下文压缩、
通用工作流、Agent Preset、子代理工具族与子代理页面、会话轨迹等能力。本插件不再重复注册
这些能力;相关配置由 Harness 自己的设置页负责。
包结构
packages/
├── bundle/ # @graycode/dsh — DSH bundle(cordis.patch.yml 增量层)
├── plugin/ # @graycode/dsh-plugin — 宿主插件(全部领域实现)
└── client/ # @graycode/dsh-client — Client 插件(browser bundle + slot)
安装
# 构建并打包
pnpm install
pnpm build
pnpm run pack
# 安装到 DSH profile(以本地 tarball 为例,tarball 生成于仓库根)
dsh plugin --profile graycode add ./graycode-dsh-0.1.0.tgz
dsh --profile graycode
@graycode/* 当前尚未发布到 npm registry;首次发布完成后可改用:
# bundle 安装:DSH 按 cordis.patch.yml 增量层自动拉取 @graycode/dsh-plugin 与 @graycode/dsh-client
dsh plugin --profile graycode add @graycode/dsh
dsh --profile graycode
- 三包:
@graycode/dsh(bundle 增量层)→@graycode/dsh-plugin(宿主插件)+@graycode/dsh-client(Client UI)。 - 版本锁定:DSH 基线
0.1.1-rc.2(npmnext,见 ADR-0001);升级 DSH 需独立兼容 PR。 - bundle 只钉
id(graycode / graycode-client)不复制 DSH 配置,默认值在插件 Schemastery schema。 - 发布检查清单与产物核对见
docs/RELEASE.md。
开发
pnpm install # 安装依赖(pnpm 11.7.0)
pnpm test # 全量测试(vitest)
pnpm typecheck # 全量类型检查(src + tests)
pnpm build # 构建 plugin
pnpm run pack # 打包全部发布包
pnpm verify:pack # 本地 tarball 内容校验(scripts/verify-pack.ps1)
环境要求:Node ^22.19 || >=24、pnpm 11.7.0(packageManager 固定)。
文档索引
| 文档 | 内容 |
|---|---|
docs/PLAN_V2.md |
迁移规划(阶段、契约、验收门槛) |
docs/PROGRESS.md |
阶段状态追踪 |
docs/ADR-0001~0003.md |
架构决策记录(版本锁定 / 扩展面探针 / staged diff) |
docs/legacy-format.md |
旧 Gray Code 1.5.4 数据格式规范 |
docs/memory-format.md |
新记忆存储格式(JSONL 双层) |
docs/PROVIDER_MATRIX.md |
模型渠道能力矩阵 |
docs/review/ |
审计报告(对照旧实现 + bug 猎人 + 测试质量)与汇总 |
docs/CI.md |
CI 覆盖与本地验证命令 |
许可
MIT(见 LICENSE)。
ruvnet/ruflo
amruthpillai/reactive-resume
volcengine/OpenViking
Molunerfinn/PicGo
titanwings/colleague-skill
nocobase/nocobase
Tencent/WeKnora
anywhere-labs/deepseek-harness-desktop