左侧栏面板,实时查看、修改并保存 ~/.dsh/AGENTS.md;保存带版本校验,写入是原子替换。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:AikawaNaya/dsh-agents-md-editor
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
该插件的 README 只有英文版本。
A DSH bundle: one left-sidebar entry that opens an editor page for the Agent
instructions file, ~/.dsh/AGENTS.md.
- Left sidebar entry — registered in
sidebar.panellist; the matchingmainkeyed panel is the page the entry opens. - Live — the page polls the file's sha1 version every 2s. An edit made elsewhere (the agent, another editor) appears automatically while the buffer is clean; with unsaved text it raises a banner instead of overwriting.
- Safe save —
POST /agents-md-editor/api/savecarries the version the page loaded and is refused withconflict(409) if the file changed meanwhile. Writes go to a temp sibling and are renamed into place, so a crash never leaves a truncated instructions file. - Draft survives panel switches — switching to the conversation and back restores unsaved text.
- Follows the host type scale — every size reads the theme's own variables
(
--dsh-content-font-size,--dsh-content-font-size-secondary), so Settings → General → body font size resizes this page too; no px values are hardcoded.
Install
From the registry:
dsh plugin --profile desktop add dsh-agents-md-editor
From a local checkout (development):
dsh plugin --profile desktop add ./dsh-agents-md-editor
Either way the bundle lands in the profile, and the left sidebar grows one entry (「代理说明编辑器」/「Agent Instructions Editor」).
Configuration
filePath (default ~/.dsh/AGENTS.md) is the only file the plugin reads and
writes. ~ and ~/ are expanded; a relative value resolves against the Host
process working directory.
- id: agents-md-editor
name: 'dsh-agents-md-editor'
config:
filePath: '~/.dsh/AGENTS.md'
Routes
Both routes are gated by ctx.connection.requestRejection — the same
browser-trust fence the shipped plugins use — and neither accepts a path:
| Route | Method | Body / result |
|---|---|---|
/agents-md-editor/api/state |
GET | { exists, path, content, version, mtimeMs, size } |
/agents-md-editor/api/save |
POST | { content, baseVersion } → { path, version, mtimeMs, size, savedAt } |
version is the sha1 of the file's UTF-8 bytes.
Notes
The Host half writes with node:fs rather than the file sandbox, because the
target deliberately lives outside the session workspace and a UI action has no
approval channel. The route table takes no user-supplied path, so the reachable
surface is the single configured file.
Verifying
node test/host.test.mjs # or: npm test
22 checks against a throwaway file in the OS temp directory: missing file,
first create, normal save, stale baseVersion → 409 with the file untouched,
405/404/400, the trust fence → 403, and ~ expansion. The real
~/.dsh/AGENTS.md is never opened.
License
MIT — see LICENSE.
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10172
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10172
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7101
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 6959
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 4959
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
Devin-AXIS/deepseek-design#deepseek-idesign★ 1744
可视化设计工作室,支持网站、App 原型、海报、信息卡、报告和杂志的模板创建、元素编辑、选区级 AI 草稿衔接与导出。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。