DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-workspace-charter

b

dsh-workspace-charter

Manifest valid
UI (client)hasBundlePatch

dsh-workspace-charter

给每个工作区写一份「前提声明」,新开会话时自动带上——不用每次重复交代环境路径、目标和范围。

它解决什么

同一个工作区里反复开新会话时,下面这些事实每次都要重说一遍:

  • 环境和软件在哪(Python/Anaconda、ffmpeg、Photoshop、Unity、GPU 档位……)
  • 这个工作区长期要交付什么
  • 研究/实现范围的边界(在范围内 / 明确不做)
  • 数据与交付物放在哪
  • 命令约定、已知失败模式与绕过方式

本插件把它们落到工作区内的一个 Markdown 文件里,并在该工作区每个新会话开始时注入给模型。

文件位置

<workspace>/.dsh/workspace-charter.md
  • 纯 Markdown,可手改、可提交到 git。
  • 空文件或不存在时不注入任何内容。
  • 单个文件上限 64 KiB(超过会拒绝保存并提示)。

怎么用

  1. 侧边栏底部会多一个「▤」按钮,点开面板。
  2. 选工作区 → 编辑内容 → 保存。
  3. 在该工作区新开一个会话;前提声明会作为上下文注入。

面板里「插入模板段落」会追加一份空白结构(环境与软件路径 / 整体目标 / 研究范围限定 / 数据与资产位置 / 约定与已知坑)。

注入行为

  • 时机:agent/created,即新会话创建、首轮之前;每会话一次。
  • 形态:一条 user 角色的上下文消息,包在 <workspace-charter path="…"> 里,并声明「与当次用户指令冲突时以用户指令为准」。
  • 只影响新会话:改完文件后,已在运行的会话不会热更新(与 DSH 的 AGENTS.md 注入语义一致)。

配置

cordis.patch.yml 里该行支持:

config:
  injectCharter: true   # false = 只保留编辑面板,不注入

与项目 AGENTS.md 的关系

DSH 原生已经支持项目级 AGENTS.md / CLAUDE.md(从项目根到会话目录逐级加载)。两者不冲突:

  • 项目 AGENTS.md:团队共享的工程约定,通常进仓库根目录。
  • 本插件:更偏「这台机器 + 这个工作区」的前提(本机软件路径、当前研究范围),放在 .dsh/ 下,不污染项目根,且有图形化编辑入口。

如果更希望写进 AGENTS.md,也可以直接把内容粘贴过去——本插件不会读写该文件。

限制

  • 仅 Web/Desktop profile 的图形界面提供面板;headless profile 没有客户端,但注入逻辑与文件约定仍然有效(可直接手写文件)。
  • 面板只列出「会话目录里出现过的工作区」;从未开过会话的工作区需要先在该目录开一次会话。
  • Host 路由只监听回环地址,只允许读写 <workspace>/.dsh/workspace-charter.md,拒绝工作区之外的路径。

验证记录

  • node --check lib/index.js、node --check lib/client.js 通过。
  • GET /dsh-workspace-charter/health 返回 {ok:true}。
  • 见仓库内 docs/VERIFICATION.md(安装后补充)。

Comments

Loading…