GrayCodeTeam/graycode-for-dsh

插件Plugin ⭐ 5 MIT 其他Other

把 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.

或使用命令行安装(适合开发者)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(npm next)。规划见 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(npm next,见 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)。

上一个 Prev dsh-computer-use 下一个 Next dsh-agent-messaging