b
dsh-workspace-charter
Manifest validUI (client)hasBundlePatch
dsh-workspace-charter
给每个工作区写一份「前提声明」,新开会话时自动带上——不用每次重复交代环境路径、目标和范围。
它解决什么
同一个工作区里反复开新会话时,下面这些事实每次都要重说一遍:
- 环境和软件在哪(Python/Anaconda、ffmpeg、Photoshop、Unity、GPU 档位……)
- 这个工作区长期要交付什么
- 研究/实现范围的边界(在范围内 / 明确不做)
- 数据与交付物放在哪
- 命令约定、已知失败模式与绕过方式
本插件把它们落到工作区内的一个 Markdown 文件里,并在该工作区每个新会话开始时注入给模型。
文件位置
<workspace>/.dsh/workspace-charter.md
- 纯 Markdown,可手改、可提交到 git。
- 空文件或不存在时不注入任何内容。
- 单个文件上限 64 KiB(超过会拒绝保存并提示)。
怎么用
- 侧边栏底部会多一个「▤」按钮,点开面板。
- 选工作区 → 编辑内容 → 保存。
- 在该工作区新开一个会话;前提声明会作为上下文注入。
面板里「插入模板段落」会追加一份空白结构(环境与软件路径 / 整体目标 / 研究范围限定 / 数据与资产位置 / 约定与已知坑)。
注入行为
- 时机:
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…