GrayCodeTeam/graycode-for-dsh
把 Gray Code（原 VS Code 扩展）重构为 DeepSeek Harness (DSH) 插件的迁移项目。 DSH 负责 Agent 循环、会话、工具流水线、权限与 Web 宿主；本仓库只保留 Gray Code 的差异化能力。
catalog 简介 / catalog descriptioncatalog description：—
安装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.0-rc.6（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 |
| File | delete_code |
批量行级删除（5MB 护栏 + staged-diff 钩子） |
| Todo | todo_update |
DSH 整表快照上的增量 ops 薄适配 |
| Notifications | notify |
Windows 原生 toast + 浏览器通知中心/noop 降级 |
| Subagents | — | hop 深度、父链寻址与并发守卫 |
| Thoughts | — | 可选请求构造层（默认关闭，非契约适配） |
| Settings | — | DSH 原生设置页「Gray Code」分区（settings.section）：Gray-Code 17 分类设置面板，ctx.settings 持久化 + /graycode 配置通道 |
| Migration | migration_scan/apply |
旧 Gray Code 1.5.4 数据导入（dry-run 优先） |
| Client | shell.overlay slot + locale + 10 个可挂接表面 |
workflow/overview/memory/checkpoint/restore/staged diff/settings/activity/scope/notifications UI；rc.6 管理视图挂载与浏览器 Remote 通道仍受上游 GAP 限制 |
包结构
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 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.0-rc.6（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 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）。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…