GrayCodeTeam/graycode-for-dsh

面向 DeepSeek Harness 的 GrayCode

将 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）。