Back to home@sandersyao

dsh-workspace-bootstrap

deepseek harness 插件 增加默认工作区

Stars
0
Language
TypeScript
Created
Sep 5, 2026
Updated
Sep 5, 2026

Introduction

@sandersyao/dsh-workspace-bootstrap

dsh-workspace-bootstrap banner

Boot-time default-workspace plugin (Stage A) for DeepSeek Harness. Loads as a Cordis plugin and, on web-host startup, idempotently registers a configured directory as the default workspace — unblocking the first session in an empty, directory-picker-disabled distributed/container deployment.

Important design note — the default workspace is a temporary stopgap. Stage A registers a real local directory (default /opt/workspaces/default) as the default workspace to unblock the first session in an empty, directory-picker-disabled deployment. Anchoring session writes to a local directory is temporary: a later stage (B) is expected to replace this with a workspace plugin that does not depend on a local directory (logical workspaces where identity ≠ path, binding to OSS / knowledge bases, etc.), at which point this plugin would be superseded. See .agents/notes/2026-09-05-workspace-bootstrap-phase-a.md.

Companion plugins (distributed dsh deployment)

This plugin is built to run alongside three sibling plugins on a shared MySQL to form a distributed dsh deployment: dsh-storage-mysql, dsh-credentials-mysql, and dsh-session-persistence-mysql switch the default storage / credentials / session-persistence backends to shared MySQL, while this plugin declaratively bootstraps a default workspace so the first session can start on an empty database.

PluginGitHub repositorynpm package page
@sandersyao/dsh-storage-mysqlhttps://github.com/sandersyao/dsh-storage-mysqlhttps://www.npmjs.com/package/@sandersyao/dsh-storage-mysql
@sandersyao/dsh-credentials-mysqlhttps://github.com/sandersyao/dsh-credentials-mysqlhttps://www.npmjs.com/package/@sandersyao/dsh-credentials-mysql
@sandersyao/dsh-session-persistence-mysqlhttps://github.com/sandersyao/dsh-session-persistence-mysqlhttps://www.npmjs.com/package/@sandersyao/dsh-session-persistence-mysql

See README.zh.md (primary, Chinese), AGENTS.md, and docs/ (DESIGN.md, INTEGRATION.md, MANUAL_TEST_PLAN.md, TASKS.json).

Status: Stage A implemented and green — engineering skeleton, plugin source, and unit tests (T1, T2) pass pnpm typecheck / build / lint / test (coverage lines ≥ 90); integration into dsh-distributed-integration (T3) and doc finalization with README header image (T4) are complete. See docs/TASKS.json.