dsh-worktree

DSH PLUGIN开发与运行时

仓库 FlashingChen/dsh-worktree · npm dsh-worktree

开发与运行时 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

为 DeepSeek Harness 提供 Codex 风格的永久 git worktree 管理,支持创建、列出、打开和删除 worktree,并持久化记录于仓库清单中。

一句话选型结论

按资料字段整理

dsh-worktree 是开发与运行时类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 6 复刻 0 · 未关闭 issue 未标注
最近更新 2026-08-13 创建于 2026-08-13
README 6.1 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-worktree@0.1.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.1.1-rc.2;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.1.1-rc.2版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-worktree可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-worktree:DeepSeek Harness 的永久 git worktree 插件

  • 创建永久 worktree
  • 列出 worktree 状态
  • 打开/删除 worktree
  • 持久化清单记录

适用场景

GitHub 集成

上游标签

deepseek-harnessdshdsh-plugingitpluginworktree

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度稳定按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✕ 未通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 插件目录树加载失败
  • L5.3_HTTP_SERVED HTTP 服务响应

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.1.1-rc.2),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-worktree当前 L4 · 沙盒安装通过 低风险 6 0.1.1-rc.2 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方FlashingChen仓库 dsh-worktree · 默认分支 未标注
分类开发与运行时dev
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue6 / 0 / 未标注收录时的数值,非实时
创建 / 更新2026-08-13 · 2026-08-13最后推送 未标注
本站收录2026-08-21首次进入本站目录的时间

README 全文

6.1 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-worktree

English | 中文

Codex-style permanent git worktrees for DeepSeek Harness — a Cordis
plugin that gives a DSH profile the same durable-worktree workflow as
codex worktree create --permanent.

A permanent worktree is a real git worktree add --detach checkout that
survives sessions and restarts. You (or the agent) create it once, and
any later session can be opened inside it to keep working where the previous
one left off — without ever touching your main working tree.

What you get

Codex CLI dsh-worktree equivalent
codex worktree create --permanent [] agent tool worktree_create, or /worktree create []
codex worktree list agent tool worktree_list, or /worktree / /worktree list
codex worktree open /worktree open (registers the worktree as a DSH workspace; start a new session there)
codex worktree close/delete agent tool worktree_remove, or /worktree remove
worktree shown in session context one-shot context note when a session runs inside a registered worktree

On top of the CLI parity, the model itself gets the tools, so it can fork
its own permanent workspace mid-task — create a worktree at a specific
commit, work there with the normal file tools, and clean up afterwards.

How it works

  • Worktrees live at /.dsh-worktrees/ — the same hidden
    directory pattern as Codex's .codex/worktrees/ — so they stay inside the
    repository (and, when the session workspace is the repo root, inside the
    session's workspace-write sandbox).
  • Every worktree is recorded in a per-repository manifest,
    /.dsh-worktrees/manifest.json (name, path, base commit,
    created-at, creator session). The manifest is what makes worktrees
    permanent: they survive DSH restarts, are listed by the tools/command,
    and are recognized when a new session is opened inside one.
  • Creating a worktree also registers it in ctx.workspaceRegistry, so it
    appears in the DSH workspace list — the native way to "open" it later.
  • Removing a worktree runs git worktree remove (with --force when
    requested), deletes the manifest entry, and unregisters the workspace.
    It refuses to remove the worktree the current session is running inside.

Requirements

  • git ≥ 2.31 (uses git rev-parse --path-format=absolute --git-common-dir).
  • A DSH profile with the tools, commands, and subprocess services
    (the web profile has all three via dsh-base).

Installation

# 1. make the plugin available to your profile (installs from npm)
dsh plugin --profile web add dsh-worktree

# 2. activate it in the profile's patch layer
#    add to ~/.dsh/profiles/web/cordis.patch.yml:
#
#    - insert:
#        - id: worktree
#          name: 'dsh-worktree'

# 3. restart the profile (e.g. restart the `dsh web` process)

Installing from source (development, or to match a different harness version):

git clone https://github.com/FlashingChen/dsh-worktree.git
cd dsh-worktree
npm install            # self-contained deps, pinned to the harness versions
dsh plugin --profile web add "$PWD"
# ... then the patch row and restart as above

> The plugin's dependencies are pinned to the harness versions it was built
> against (@deepseek-ai/* 0.1.0-rc.6). If your DSH installation is a
> different version, install from source and run npm install <matching > versions> in the plugin directory (or adjust package.json) so the
> plugin loads against your harness.

Configuration (all optional):

- insert:
- id: worktree
name: 'dsh-worktree'
config:
dirName: .dsh-worktrees   # directory inside each repo root (default)

Usage

Agent tools

  • worktree_create {name, baseCommit?} — create a permanent detached
    worktree of the repository containing the current session (default base:
    current HEAD). Returns the worktree path, repo root, and base commit.
  • worktree_list — list registered worktrees with live git state
    (exists, HEAD, branch).
  • worktree_remove {name, force?} — remove a registered worktree
    (--force also discards uncommitted changes). Refuses to remove the
    worktree the current session is working inside.

Chat command

/worktree                          # list (same as /worktree list)
/worktree list
/worktree create  []
/worktree open               # print path/state + register as workspace
/worktree remove             # (close/delete accepted as aliases)

Session context

When a session's workspace is inside a registered permanent worktree, the
agent is told once: which worktree, of which repo, at which base commit,
plus the management commands.

Sandbox note

The git operations run through DSH's own ctx.subprocess seam (not the
agent bash tool), like other harness-managed processes. With the default
workspace-write permission mode, worktree files are writable by the agent
when the worktree lives under the session's workspace root — which is the
case whenever the session was started at the repository root (the normal
setup). If a session starts from a subdirectory of the repo, .dsh-worktrees
lands outside that session's workspace; open a new session with the worktree
as its workspace to work inside it.

Development

  • node test/smoke.js — standalone end-to-end test of the git logic against
    a scratch repository (no DSH boot needed).
  • Activation check: boot a minimal cordis tree
    (system-prompt, tools, commands, subprocess, dsh-worktree) from
    the profile's node_modules and assert registration + a real
    create/list/remove round trip.

Layout

lib/manager.js   WorktreeManager: repo discovery, git worktree lifecycle,
per-repo manifest (pure logic over ctx.subprocess)
lib/index.js     Cordis plugin: Config, tools, /worktree command,
one-shot session context note, ctx.worktree service
test/smoke.js    standalone smoke test

License

MIT — see LICENSE.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-worktree 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-worktree@0.1.0` 即可。对应的 npm 包名是 `dsh-worktree`。

dsh-worktree 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-worktree 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-worktree 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-worktree 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.1.1-rc.2。

dsh-worktree 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-worktree 有哪些功能?

创建永久 worktree、列出 worktree 状态、打开/删除 worktree、持久化清单记录。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

8 条
不同作者的仓库分开列,请确认你要装的是哪一个
开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

FlashingChen 的其它插件

1 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。