dsh-functions
给 DeepSeek Harness 客户端顶端加一个可扩展的 「功能」 标签：
插件注册进来的一键功能都在这儿，用户不用再记着「去哪儿点 / 输入什么口令」。
[▢] 应用 编辑 功能 3 ▾
┌──────────────────────────────────────┐
│ 功能 │
│ 插件在这里挂上自己的一键功能 │
│ 加载功能 让会话去找非官方插件… │
│ 读取中文房间 让当前窗口的会话读一次… │
│ 换会话 > 真交接或演练，展开选一条│
│ 插件市场 逛社区插件、一键装 │
│ 重启 DSH 重启 DSH，让设置生效 │
└──────────────────────────────────────┘
不 patch DSH 本体，不 require React，不引任何 Harness 客户端包 ——
它就是一个普通插件：一行 Loader 条目 + 宿主半边 + 一个自带样式的客户端 bundle。
装
DSH → 插件 → 添加插件，填这个包的路径（tarball 或解包目录都行），然后重启 DSH
（服务端不热更新；客户端那半边刷新页面就有）。
手动装也行：profile 的 package.json 里加一条依赖 + dsh.profile.bundles 一行，
再在 node_modules 里放一个指向它的 Junction/软链。
五行加一条功能（宿主半边，推荐）
// 你自己的插件 index.js
export const inject = ['functions'];
export function apply(ctx) {
ctx.functions.register({
id: 'my.tool',
title: '干点什么',
description: '一句话说明\n它调用的插件名', // 第二行惯例：写它依赖的插件
group: '我的',
order: 10,
confirm: { title: '干点什么', message: '现在跑？' },
async run() { return { message: '干完了' }; },
});
}
run() 返回的 message 会弹在界面上；返回 { warnAfterMs, warnMessage } 的话，
到点还活着就再弹一条（给「重启这种会把自己关掉的功能」兜底）。
字段表
| 字段 | 类型 | 说明 |
|---|
id | string | 必填，唯一。 |
title | string | 必填，菜单显示名。 |
description | string | 说明。可以带换行：第一行讲做什么，第二行写它调用的插件（面板渲染两行，右对齐）。 |
group | string | 分组，默认「通用」。只参与排序，标签默认不画。 |
order | number | 组内排序，小在前，默认 100。 |
pinned | boolean | 置顶：永远排最上面（不受分组与 order 影响）。 |
parent | string | 挂到某个父项的子菜单里（二级菜单）。写了它就不出现在顶层。 |
submenu | boolean | 标记这一条是二级菜单的父项（容器）：自己没有动作，run 可以不写。 |
icon | string | 预留（2026-10 之后面板不再显示单字图标，写了不报错）。 |
confirm | object | 一级确认窗：{ title, message, detail, confirmText, cancelText }。 |
confirms | array | 多级确认（静态）。只有第 0 级用得到。 |
prepare(stage, context) | function | 动态确认：第 N 级的文案在第 N-1 级点掉之后才算（「有没有任务在跑」这种话隔一次就会过期）。返回 null = 没有更多确认。 |
run(job) | function | 执行。job = { id, ctx, log, session, confirm, alert, toast, get, post }。不写 run 就必须写 shell 或 submenu: true。 |
shell | object | 只想跑命令：{ command, args, cwd }，结果整理成一句话显示。 |
hidden | boolean | 不进菜单（仍可用 API 调）。 |
二级菜单长这样（照 Windows 右键菜单的逻辑：悬停 120ms 展开、离开 180ms 收起，点父项也能展开）：
ctx.functions.register({ id: 'family', title: '换会话', submenu: true, group: '会话' });
ctx.functions.register({ id: 'family.go', title: '真交接', parent: 'family', run() {...} });
三条路由（自己写客户端时才用）
GET /api/dshFunctions/list 列宿主注册的功能
POST /api/dshFunctions/prepare { id, stage, sessionId } -> 确认窗
POST /api/dshFunctions/run { id, confirm: 'yes', sessionId }
sessionId 是「用户正在看哪个会话」，浏览器那半边会自动带上（读客户端服务 uiSession）。
需要往会话里送东西的功能用它 —— 拿不到就拒，别猜（指令发错窗口代价太大）。
客户端半边
功能本质上是「打开某个界面」时（打开设置里某一节、打开某个面板）才用客户端注册：
window.__ModuleLoader__.load({
id: 'my-plugin',
factory(require) {
return {
inject: ['functions'],
apply(ctx) {
ctx.functions.register({
id: 'my.open', title: '打开某面板',
run: async (job) => { /* job.post / job.confirm / job.toast */ },
});
},
};
},
});
面板是纯 DOM（shadow root 隔离），升级后最坏是外观退化，不会白屏。
内置的「加载功能」
这个插件自己内置了一条置顶功能 加载功能：dsh 没有「在工作区新开会话」的能力，
所以它走「把一段指令当成用户消息送进当前会话」这条路 ——
让会话里的 dsh 去插件库里找非官方插件、列出数字编号给用户挑，再读 README 把它们接进「功能」栏。
指令里点名了下面这一节。
严谨猜测插件接口形式
插件自己多半没为「功能」写接口。接它的时候，最常遇到的不是「接不上」，而是对方没写文档。
纪律一句话：
推断可以，但必须留下证据链；证据不够就照实说「没找到」，不要编。
找接口的优先级（从上往下，找到就停）：
- 作者写的 README / README.zh.md / TESTING.md —— 最权威
- 类型定义与注释（
*.d.ts、JSDoc）
- 注册现场源码：
slots.inject / slots.register / ctx.provide / ctx.layout.selectPanel /
commands / shortcuts / settings.section / connection.fetch.register
- 运行时事实：
ctx.registry 里有没有它的 fiber、ctx.get('服务名') 拿不拿得到、
ctx.slots.entries('槽位') 里有没有它注册的条目
- 它导出的东西（
exports.*）—— 导出即承诺
- 界面结构（DOM / 截图）—— 最后手段，只能写成「只能点界面」
三条禁令：不许按名字猜、不许按别的插件套、不许按截图猜。
每条推断写全四样：接口形式 / 证据（文件:行）/ 反证检查（有没有更官方的路）/ 拿不到时怎么办。
验证方式：先写只读探针（列服务、列 slot 账本、列 DOM），别改代码试；改完留下可复现的自检；
推错了别删，把错的痕迹写下来 —— 错的痕迹比正确的结论值钱。
自检
node test/selftest.mjs
用真 cordis 起一个 Context，把插件挂上去，验：注册表 / 确认窗归一化 / 分级确认 /
三条路由 / 冻结顺序（历史上「注册完菜单是空的」就是这个）/ 内置加载功能的行为。
不需要别的插件，也不需要 DSH 在跑。
License
MIT
