dsh-chatroom
Manifest valid★ 1Multi-User Personal Chat Room for DeepSeek Harness: You and your agents share the same room, three messaging rules run in parallel, and you can tell at a glance whether a message comes from your local machine or a LAN member.
dsh-chatroom · 多人个人聊天室
在 DeepSeek Harness 里开一间屋子:你、你带进来的 agent,以及局域网另一台机器上的人和它的 agent 一起说话。 agent 不是「问一句答一句」的工具,而是屋里的成员 —— 有名字、有职责、有自己独立的会话历史。
DSH 原本是「你和一个会话」一对一。当你有三四个 agent、想让它们在同一个上下文里互相看、互相补、你插话拍板时, 缺的不是模型,是一间屋子和一套发言秩序 —— 这个插件补的就是这一层;再往前一步:隔壁那台机器上的人也想带他的 agent 进来, 于是有了 LAN 房间。

当前状态(诚实版):本机房间、三条并行发言规则、LAN 加入与跨机派发、本机授权(三档,默认只读)、
悬浮窗与未读提醒都已跑通。npm test 112/112;docs/ 里 18 张界面预览图 + 1 张真外壳截图都是真渲染,两轮独立全量重跑逐字节相同;
真模型在真宿主里跑过一轮。逐条证据(含反证)在 docs/VERIFICATION.md。
| 能力 | 一句话 |
|---|---|
| 一条消息叫多个 agent | 三条规则(@ 必回 / 全员一轮 / 主持人)可以同时开,一轮里每人只说一次 |
| agent 是成员,不是工具 | 名字与职责随时能改(职责进它每一次的提示词),各用自己原生的 session,记忆不串台 |
| 隔壁机器进来 | 地址 + 六位房间码,没有账号、没有注册;那边的人和 agent 标 LAN · 机器名 |
| 跨机执行 | 轮到对面机器的 agent 时,这一轮派回它那台、用它本地的 session 跑完再回传 |
| 不让别人白使唤你的 agent | 本机授权三档:只读(默认)/ 授权后执行 / 完全授权 |
| 会话里的浮窗 | 可拖可折、带未读;收起成胶囊也带着「谁:最后一句」 |
安装 · 用法 · 截图 · 三种发言规则 · 跨机器 · 本机授权 · 验证 · 边界
安装
插件市场那条 github: spec 直接装,--profile 换成你的 profile:
dsh plugin --profile <你的profile> add github:dingchenhui0618-arch/dsh-chatroom
本机已经有这个仓库的目录时,也可以直接装目录:
dsh plugin --profile <你的profile> add D:\Projects\dsh-chatroom
装完刷新页面,侧栏出现「聊天室」。插件装好就会在 4399 监听(DSH_CHATROOM_PORT 可换端口);
端口被占不影响本机房间,只是「邀请」里会写清原因、并告诉你怎么换。
- 仓库里已提交
lib/index.js与lib/client.js,不用先构建;npm install github:…装进空目录后直接import得到name/inject/apply。 - 包清单带了
icon.svg与locale/{zh,en}.json,插件管理页才有图标和中文名 ——test/manifest.test.mjs盯着这条不过期。 - 上面那条命令是拿真 CLI 走通的:临时
DSH_HOME+@deepseek-ai/dsh@0.2.2-rc.1,4.7 秒装完 1 个包,dsh.profile.bundles自动补上dsh-chatroom,真起的dsh web页面加载的就是这个包的client.js。 - 也可以用插件管理器装本地目录(
install_bundle,target 指向包目录)。
![]()
插件图标:64 栅格上的线性标记 —— 实心那间是「本机」,虚线那间是「跨机器」。一个 SVG,明暗主题都不换图。
用法
- 侧栏 → 聊天室 → 新建房间,填房间名(和可选的主题)。
- 右栏 + 加一个 agent,给它名字和职责(职责会进它每次发言的提示词)。
- 说话。想点名就
@名字(输入@弹出成员列表),或者按 让全员说一轮。 - 让另一台机器进来:右上 邀请,把地址和房间码发过去;对方在他的聊天室里 加入 LAN 房间。
- 授权:右栏成员列底部三档,默认「只读」—— 它只管「别的机器派过来的回合要不要在这台机器上执行」, 本机的人自己 @ 自己的 agent 不受影响。见 本机授权。
- 会话界面标题栏右侧的「聊天室」开关拉起悬浮窗:可拖动、可折叠,Enter 直接发,位置会记住, 双击标题栏回右下角;拖到边上会被夹回视口内,改窄窗口、重开页面之后它还在看得见的地方。
截图
18 张预览图 + 1 张真外壳截图,全部是真渲染,不是 mockup:页面里跑的就是本仓库的 lib/client.js,数据来自 src/host 里那几份真状态机;
屋里那些 LAN 成员是另外的进程用房间码真的加入进来的,approve.png 那一轮是真的停在等本机点按钮上(模型一次都没被调用)。
每张图完整的故事 —— 这一屏在验什么、为什么必须这么拍、哪些问题只有拍出来才暴露 —— 在
docs/SCREENSHOTS.md。
本机

刚装好的第一屏:一间屋子都没有时也不留一块白 —— 一句话说清房间在谁那台机器上、另一台怎么进来 (地址 + 六位房间码),两个入口(新建 / 加入 LAN)当场可用,成员列整列收起,不占着一根空列。

房间面板:左是房间列表与预览,底部「我的 agent」(这台机器带谁进屋)与「我的名字」;
中是群聊,本机 / LAN · 周荻的 MacBook 的标记跟着消息走,新消息滚到底、自己翻历史时不打扰;
右是成员与规则入口。

agent 的名字和职责随时能改:成员行上「改」→ 表单原地展开 → 保存。职责不是备注,
它会被写进这个 agent 每一轮的 prompt(你的职责:…),改完它所在的所有屋子一起换。

三条发言规则是并行开关,不是三选一:被 @ 必回、全员各说一句、设主持人; 下面那条「每条最多引出 N 个回复」是共用的预算闸门。

说完一句、谁都没接:默认只开「被 @ 必回」,没点名的话不会有 agent 接 —— 界面在那句下面直接写清原因和
怎么写才叫到(开头写 @名字,或者让全员说一轮),agent 一接话它自己就消失,不会变成挂着的噪音。

agent 没回上来:失败不悄悄消失 —— 占位消息留在房里(带错误码,灰色那行),底下「重试」只把它重跑一次, 不惊动其他 agent、也不换会话;这一轮还在发言时按钮按住。

说过的话翻得回去:投影只带最近 200 条(房间能存 4000 条),所以列表顶端是「加载更早的消息」—— 一页 100 条,翻到最早一条入口自己消失,视口停在原处;停在上头时底部浮出「回到最新」。

停在上头时屋里又进来话:出口写「回到最新 · 2 条新的」,而且不把人拽下去;投影往前滑留下的接缝会按首句补上, 时间线才是连续的(这一屏拍的就是那个中间态)。
跨机器

邀请:局域网地址 + 六位房间码就是全部凭据。装了 WSL / Hyper-V / 虚拟机的机器有好几个地址,
这里只把最可能连得上的放在上面,其余列在下面并标「虚拟网卡」—— 免得人抄一个本机自己通的 172.x 过去对着超时猜。

同一间屋子,另一台机器上看到的视角:它自己的人和 agent 不贴标签(本机就是默认),宿主的成员标
LAN · 林岸的 MacBook;规则与成员在宿主那台改,这边只能发言。

加入失败时说人话:地址写错、那台没开、码不对 —— 横幅写清「连不上 127.0.0.1:4599(对面那台没在监听这个端口)」,
不是 fetch failed;填过的地址和房间码还在表单里,不用从零重敲。

三台机器同屋:本机的人与 agent 不贴标,另外两台分别标 LAN · 周荻的 MacBook / LAN · 陈默的 ThinkPad ——
不是笼统一个「LAN」。这张不是摆拍:第三个进程真的握手、真的发言,宿主那句 @库存 agent … 也真的被派到第三台跑完再回传。

空手进来也能补:新装的机器上一个 agent 都没有,所以左栏补了「我的 agent」—— 加入后再建也来得及, 建完立刻报给宿主,对面成员列当场多一个人,不用退出来重进;改名、改职责、删掉都跟着同步。

对面那台还是旧版本:旧版本没有 /lan/agents,报不了 agent 名单 —— 而「没 agent」和「带不进来」看起来一模一样。
所以宿主不让人猜:成员列下面直接写清哪台机器、缺什么、该做什么(旧版本,报不了 agent 名单 —— 重启那台的桌面端,再进屋一次)。
这不是网络故障,重试没用:跑着的进程里是装载那一刻的代码。

别的机器不能白使唤你的 agent:LAN 派发把对端拼好的 prompt 原样交给本机 agent,而它用的是本机配置的工具权限。 所以每台机器有自己的授权档位(默认只读),挡的是「非本机的指挥」,详情见 本机授权。
浮窗、提醒与收尾

会话界面里的独立悬浮窗:标题栏右侧开关拉起,可拖可折,Enter 直接发;收起成胶囊以后同样拖得动、点一下才展开,
而且收起时也带着最后一句(谁:说了什么)与未读数 —— 不点开就知道值不值得点开。展开后是完整的一段对话,
和面板共用同一套消息行与输入器(头像、署名、机器名、时间、连说合组、跨天日期线、正在发言、重试、@ 候选都在)。

消息提醒:新消息进来时侧栏图标、悬浮胶囊、标题栏开关都带未读数,右上角一条 toast,页面标题前缀同步成 (1) …。
这些数字会落回去:面板正停在那间屋子上、或者展开浮窗(都等于「看过了」)就推到最新一条;
面板被切走、标签页在后台时不会替你清,否则提醒就废了。

宿主把那间屋子解散了:加入方的镜像不删,改成一条墓碑 —— 历史还在、标题栏标 已解散、输入框锁住,
右栏只留「从列表移除」。不这么做,加入方会卡在一个发不出话、也没有出口的房间里。
真外壳

临时 DSH_HOME、dsh plugin --profile web add 把这个仓库装进一个真 profile、起 dsh web,
无头 Chrome 拿真 token 打开页面,然后真的去点:侧栏「聊天室」→ 建房 → 加一个 agent → 发一句。
截图前那间屋子、那两个成员、那条消息已经经真 RPC 落进宿主状态里(量到网格 1160×900、左栏 224px、
主按钮 rgb(21,21,23) on rgb(249,250,251))。它不进像素门禁(前置要先联网装一个固定版本的 dsh),
但复现是一条命令:node tools/real-shell.mjs --url "<dsh web 打印的地址>" --out docs/real-shell.png。
界面规格
- 颜色 / 间距 / 圆角先落 token:
.cr-main/.cr-float/.cr-toast-wrap/.cr-approve上定义--cr-fg / --cr-muted / --cr-line / --cr-surface / --cr-accent / --cr-on-accent / --cr-hover / --cr-raised / --cr-r / --cr-s1..s5, 组件里只引用变量;取值优先宿主--dsw-alias-*,取不到才退回中性值 —— 明暗主题不需要各写一套。 - 间距只走 4/8 栅格(4 / 8 / 12 / 16 / 24),字号只有 11 / 12 / 13 / 14 四档,圆角只有 8 / 12 两档。
- 不做盒子套盒子:规则区、邀请条、agent 表单是发丝线分隔的段落;选中的房间只加一条 2px 品牌色竖条; 消息之间只留空白,不画气泡。
- 本机是默认状态,不给它贴标签:只有
LAN · 机器名带色块;成员副标题只放有信息量的东西(职责或机器名)。 - 两个抓手都能拖:展开的标题栏与收起后的胶囊共用一套拖动(4px 阈值区分点击与拖动),拖动中夹在视口内,
松手写
localStorage,双击标题栏回右下角。
这些图怎么来的
docs/*.png 由 tools/preview/ 用无头 Chrome 截取(1440×900、2× 缩放);预览服务器起两份预览页面
(3491 宿主 / 3492 加入方),第三台机器与「空手加入再补建 agent」那台各起一份 Store 与 LAN 监听、走真实协议按需加入。
外壳(左侧图标栏、会话标题栏、输入框)是替身,只为给真实尺寸与上下文,取色照 DSH 默认深色主题的真 token
(#151517 底 / #f9fafb 主文字 / #2c2c2e 抬起层 / #ffffff0f 发丝线),同名 --dsw-alias-* 摆在页面上。
为什么必须这样截:DSH 桌面端的窗口就是聊天界面本身,自动化不能截自己;而 dsh web 的会话 token 每个进程随机、不进磁盘,
外部浏览器拿不到。逐字节可复现的口径(钉层、未读清零、活倒计时、光标、镜像追平)和全部踩坑记录在
docs/SCREENSHOTS.md。
三种发言规则
| 规则 | 行为 | 默认 |
|---|---|---|
| 被 @ 必回 | 房间里谁 @ 了某个 agent,它一定回 | 开 |
| 全员轮次 | 你发一条,所有 agent 依次各说一句 | 关 |
| 主持人 | 设一个 agent 当主席:话先交给它,它回复里 @ 了谁就继续接给谁 | 关 |
三条同时开会撞车,所以有一条总预算:一条人消息最多引出 maxSpeakers(默认 3)个 agent 回合,
agent 之间接力最多 maxDepth(默认 2)层。预算烧完就停 —— 这是防止一屋子 agent 互相客套把 token 烧光的闸门。
预算之外还有两条硬规矩,都是为了「三条规则真的能同时开」:
- 一轮之内同一个人只说一次。主持人 @ 了 B,全员轮次的队列里也有 B —— B 只说一句, 预算不会被同一个人吃两遍,排在后面的人不会永远轮不到。
- 正在发言时你插的话不会被吞掉。真实房间里一轮要好几秒,你正是在这时候补一句「@C 等会儿你单独说」; 这句会排到这一轮结束后按同一套规则处理,而不是发了没反应。「停下这一轮」会清空排队,并用世代号挡住旧回合迟到的收尾。
两台机器怎么进同一间屋
宿主那台:面板右上「邀请」→ 看到 地址:端口 和房间码(形如 10.0.51.18:4399 / K7M2QD)。
装了 WSL2 / Hyper-V 的机器上还会有 172.x 这类虚拟网卡地址:真实网卡排在前面,其余写在下面并标「虚拟网卡」。
加入那台:先填左栏底部的「我的名字」(这就是对面看到的名字),再点「+ 加入 LAN 房间」→ 填地址和房间码。 不填名字也能进,只是两边都自称「我」的时候,宿主只能用机器名兜底称呼你。带进来的 agent 在加入那一刻一起进屋; 新装的机器上一个都没有,加入之后再建也来得及。
进来之后:
- 两边看到的是同一间屋子、同一份 seq;各自的人和 agent 标
本机,对方的标LAN · 机器名; - 名字随时能改(左栏「我的名字」,回车或失焦生效):宿主那边的成员列当场跟着换,历史消息保留当时的署名;
- 轮到对面机器上的 agent 说话时,宿主不会替它说:宿主把这一轮派发过去,那台机器用自己本地的原生 session 跑完再回传落库 —— 记忆长在它自己那台机器上,这才是「真人和他携带的 agent」;
- 45 秒没有回音就落一条失败占位(
某某这次没回上来),这一轮不会卡死;对面正在**等你点「允许一次」**时会先把等待延长 (最长 5 分钟),不会因为你在犹豫就落一条失败; - 加入方的房间是镜像:规则、成员、解散都在宿主那台改,这边只能发言;
- 两边重启都认得回来:宿主重启之前把这一组(人、他的 agent、他的椅子)记成席位落进状态,加入方拿同一条 link 重新握手就坐回原来的成员 id —— 自己过去说的话还署在自己名下、已读不用重数、手上那一轮也跟着交给新那组跑完; 加入方自己重启同理(link 落盘),不会出现两个「周荻」,也不会 @ 到幽灵;
- 对面关掉窗口或掉线:掉线半分钟后整组撤掉,不留永远不回话的成员;正在长轮询、或正在跑模型的机器不算掉线;
- 对面那间屋子没了(解散后又清了 profile、或地址上换了机器):每 1.5 秒退避重试一次(不是打紧循环), 同时标成离线并给出原因 —— 人看到的是「连不上、在重试」,不是界面一直转;
- 宿主解散屋子:加入方留墓碑(历史还在、输入框锁住、可移除),解散那一刻还在跑的那一轮当场停掉。
两台机器都得让进程装载过新代码:补报名单用的是新接口。只刷新页面换的只是界面 —— 装完/更新完要重启桌面端,
或者在设置 → 插件里把 dsh-chatroom 关掉再打开。哪台没换过来,界面会直说(见 docs/old-peer.png),不用靠试。
连不上、或者怀疑两边跑的不是同一版代码时,先问一句探针(不需要房间码):
curl -s http://10.0.51.18:4399/lan/ping
# {"ok":true,"value":{"ok":true,"hostMachine":"…","serving":true,
# "code":{"version":"0.1.0","loadedAt":"…","appliedAt":"…","newestMtime":"…","stale":false}}}
appliedAt 是插件最近一次被装载/重载的时刻,newestMtime 是宿主文件在磁盘上最新的改动时间;stale: true 就是在说
「磁盘上已经有内存里没有的改动,得重载或重启」。判「换没换」要看 appliedAt 而不是 loadedAt:热重载只重新求值改过的模块。
探针每次都重新看磁盘,不是拿装载那一刻的快照。
想先验网络通不通(防火墙、网段、房间码),用自检脚本,不烧 token:
# 机器 A
node tools/lan-check.mjs host --port 4399
# 机器 B(按 A 打印的命令照抄)
node tools/lan-check.mjs guest --host 10.0.51.18:4399 --code K7M2QD
加入方那台会验两段路,两段都过才算出结果:① 我发一句 @ 对面那台的 agent → 它回一句; ② 我 @ 我自己带过去的 agent → 宿主把这一轮派回我这台、由它的原生会话跑完再回传(少这一段,「人带着自己的 agent 进屋」只是半条路)。
Windows 上连不上,先看入站防火墙。第一次监听时系统会问「允许访问」,选允许就够了 —— 但那条程序级规则只覆盖当时那个网络类型。
换了网络类型(家里 Wi-Fi 常是「专用」)、或当时点了取消,就补一条按端口的(不带 -Profile,三档都覆盖):
New-NetFirewallRule -DisplayName "dsh-chatroom" -Direction Inbound -Protocol TCP -LocalPort 4399 -Action Allow
本机授权
LAN 派发会把对端拼好的 prompt 原样交给本机 agent,而它用的是本机配置的工具权限。这是「带着自己的 agent 进屋」的前提, 但对只想进屋看看的人,这个默认值太激进 —— 所以每台机器有自己的授权档位(成员列底部,默认「只读」):
| 档位 | 行为 |
|---|---|
| 只读(默认) | 别处派来的回合不执行,屋里留一句说明(写清是哪一档拦的、去哪儿改) |
| 授权后执行 | 先弹授权窗口,本机的人点了「允许一次」才跑 |
| 完全授权 | 不问直接跑(还是本机自己的 agent、自己的会话,只是不问) |
门装在两处,因为是同一件事的两头:speak.js 里由远程消息引出的本机 agent 回合,以及 lan-guest.runAssignment
在 runner.say() 之前(这是对端 prompt 直接进本机执行的那条路)。
- 窗口里写清谁、哪台机器、要哪个 agent 做什么,外加对方那句原话和完整请求(完整请求默认停在末尾,人不用先往下滚)。
- fail closed:不点、超时(默认 90 秒)、点「停下这一轮」、插件被关,一律按拒绝收尾 —— 宁可误拒,不可误执行。
拒绝落一条
notice而不是红色失败占位(重试也不会过,那是那台机器的选择,不是它坏了)。 - 本机的人自己 @ 自己的 agent 不受影响:三种规则在本机内部照常直接生效,这道门只拦非本机的指挥; 一次授权覆盖整轮(agent 之间接力沿用同一次授权)。
- 等授权期间不会被 45 秒的派发窗口打断:
ask的加入方弹卡前先POST /lan/hold把这一轮往后延(单次 ≤180s、总 ≤300s)。 - 加入方那台机器也有同一个开关 —— 它才是被要求执行的那一边;它拒了,宿主这边落一句说明。
- 档位只在本机、跟着
state.json活下来,不随房间投给对端,也不能被对面改掉。
身份与来源
房间里成员分两种:人 和 agent。每个成员都带来源标记:
本机—— 就在这台机器上(你、你的 agent)LAN · 林岸的 MacBook—— 从局域网另一台机器进来的(真人和他带来的 agent)
同一个标记出现在消息行、成员列表、悬浮窗三处,不靠颜色猜。机器名比 IP 好认,所以成员/消息上显示机器名,完整 IP 在悬浮提示里。
验证状态
完整版(每条用什么断言、以及反证做过什么)在 docs/VERIFICATION.md。这里只留摘要:
| 项目 | 状态 | 证据 |
|---|---|---|
| 房间 / 成员 / 消息 / seq 状态机 | ✅ | test/rooms.test.mjs 13 |
| 关掉再打开,屋子和记录还在(真写盘、真 rename、真重开;坏文件改名留档,未来版本拒动原文件) | ✅ | test/state.test.mjs 5 |
| Host 端到端:建房 → 加 agent → @ → 真被驱动 → 按 seq 落库 | ✅ 假模型 | test/host.integration.test.mjs 16 |
| 三规则并行 / 一轮一人一次 / 插话不被吞 / 每个 agent 自己的 session / 停下真停得住 / 失败只重试它一个 | ✅ | 同上 |
| LAN 全链路:加入 → 双向发言 → 派发远程 agent → 回传 → 离开 | ✅ 真 HTTP | test/lan.test.mjs 13 |
| 本机授权三档(默认只读 = 模型 0 次调用;允许才跑;超时按拒绝;加入方同样三档) | ✅ 真 HTTP | test/auth-gate.test.mjs 7 |
| 三台机器同屋 / 跨机全员轮次 / 跨机主持人 | ✅ | test/lan-multi.test.mjs 4 |
| 宿主或加入方重启后还是同一个人(成员 id、椅子、已读、手上那轮都不丢) | ✅ | test/lan-restart.test.mjs 3 |
| 加入后再建 agent 能进屋并真被派发;旧版本那台分得清 | ✅ | test/lan-agents.test.mjs 6 |
| 同一台机器带两个 agent,各有各的原生 session | ✅ | test/lan-sessions.test.mjs |
| 局域网面扛得住坏包 / 随机字节 / 形状不对的 JSON / 房间码试错节流 / 端口被占 | ✅ | test/lan-{hardening,fuzz,shapes,ratelimit,port-busy}.test.mjs 15 |
| 邀请地址排序(虚拟网卡不排前面,APIPA 与回环不算候选) | ✅ | test/lan-addresses.test.mjs 3 |
历史翻页(含加入方经 /lan/messages) | ✅ | test/messages-page.test.mjs 5 |
「跑着的到底是不是当前代码」(/lan/ping 的 stale 判据) | ✅ | test/code-stamp.test.mjs 4 |
| 界面 ↔ 宿主 ↔ 加入方三方的协议面按字面量对齐 | ✅ | test/protocol.test.mjs 3 |
| 客户端装载协议 + 四个 slot + 输入法守卫 | ✅ | test/client.bundle.test.mjs 4 |
| 提醒挑对「哪间屋子、哪一句」 | ✅ | test/client-notice.test.mjs 6 |
包清单自洽;lib / src 零 @deepseek-ai/* 真导入 | ✅ | test/manifest.test.mjs 4 |
| 18 屏真渲染 + 20 组界面断言(对比度、输入法回车、草稿、拖拽边界、授权卡、首屏…) | ✅ | npm run preview:shots |
| 真模型对话(不是假模型) | ✅ | 真宿主里真模型回一段中文并落库 |
干净克隆可跑、npm pack 装得上、CI 绿 | ✅ | 见验证表(node 22/24 两个 job) |
| 两台物理机器互连 | ⏳ | 本机回环 + LAN IP + WSL2(另一个内核、另一套网络栈)都验过,还差一台真机器 |
边界
这一版明确不做的事:
- 不做账号体系、不做公网多租户:房间是「这台机器 + 你请进来的局域网机器」。LAN 用明文 HTTP + 房间码, 威胁模型是「同一个 WiFi 下可信的人」,不是公网;要跨公网得走隧道(白名单中继),那是另一个决定。
- 对局域网开着的只有一个 HTTP 口,且它扛得住坏包:不看
Host头、请求行解析不了回 400、body 超过 256 KB 直接拒、 任何漏出去的异常都在最外层兜住 —— 一个扫描器发什么都不会把宿主进程带走。但这不等于「防得住同网段的人」: 能连上 4399 的人就是能读屋里消息的人,所以别在不可信的网络里开这个口。 - 成功响应里不发 CORS 放行头:调用方只有另一台机器的插件进程和
curl,界面走同源 RPC。放行头没有用处, 却会多一条「随便哪个网页都能读过本机聊天记录」的路 —— 这条有断言。 - 本机授权默认只读,是故意的:新装的机器不替别人的话动本机工具权限。
- 不做附件、撤回、通知推送、手机端;加入方的镜像不能改规则、不能解散。
- 房间成员不复用 dsh-bot:那个插件的 peer 依赖钉在
0.2.0-rc.2,直接依赖会把本插件绑死。 这里自带一层轻量 Bot 模型(具名 / 职责 / 独立 session 记忆),语义相同,等它稳了再谈适配。 - 完整的信任边界(谁能碰到什么、房间码强度与试错节流、落盘里有什么)写在 docs/SECURITY.md; 架构与决策写在 docs/ARCHITECTURE.md。
测试与截图
npm test # 状态机 + fake-model 端到端 + LAN 端到端 + 授权三档 + 抗坏包/模糊/节流 + 历史翻页 + 协议面 + 客户端装载 + 包清单(112 用例)
npm run preview:build # 打截图用的浏览器入口(esbuild,一次性)
npm run preview:serve # 起预览服务器(3491 宿主 / 3492 加入方;第三台机器按需加入)
npm run preview:shots # 无头 Chrome 重新截图到 docs/
node tools/lan-check.mjs host|guest # 两台机器之间的联通自检
node tools/real-shell.mjs --url "<dsh web 打印的地址>" --out docs/real-shell.png # 装进真 DSH 之后的样子
截图这件事有三条硬规矩,破了就会拿到一套「看起来对、其实不一样」的图:
- 每轮截图必须用刚起的预览服务器(
/preview/writes为 0)。里面的状态机是活的,拿用过的状态再截,图和断言都会偏; 脚本会自己先读/preview/writes,非 0 就直接报错而不是默默截一套对不上docs/的图。 - 消息时间、房间码、LAN 端口、失败时的端口号全部钉死,所以重跑只差抗锯齿噪点;否则
docs/的 diff 看不出谁真改了界面。 - 带未读的几屏先等未读清零、加入方先等镜像追平(
settle: 'read'/'mirror'),活的东西(倒计时、闪烁光标、无限动画) 在截图前钉住 —— 否则每次重跑都是一张不一样的图。
调某一屏时可以只跑它:node tools/preview/shoot.mjs --only=history(多屏用逗号);整轮验收仍然不带参数全跑,
而且必须是刚起的服务器。完整口径在 docs/SCREENSHOTS.md。
目录
lib/index.js Host 入口(再导出 src/host/plugin.js)
lib/client.js 浏览器那一半:面板、悬浮窗、邀请/加入、提醒
icon.svg 插件管理页里的图标(线性,64 栅格)
locale/zh.json 插件管理页的标题与描述(en.json 同)
src/host/state.js 持久化(profile 下 dsh-chatroom/state.json)
src/host/rooms.js 房间状态机(纯函数,最容易测的一层)
src/host/turn.js 让一个 agent 说一句话(原生 session + followup + whenIdle + 读回)
src/host/speak.js 三条规则的调度器与预算闸门(远程成员的回合走派发)
src/host/guard.js 本机授权:三档档位、待授权队列、超时与拒绝
src/host/project.js 给客户端/加入方的投影(含 LAN 状态与「谁在看」的未读)
src/host/lan.js LAN 两半共用:局域网地址、{ok,value} 小客户端、超时与端口
src/host/lan-host.js 宿主:监听、房间码鉴权、assignment 队列、超时收尾
src/host/lan-guest.js 加入方:握手、镜像投影、领任务并用自己的 session 跑
src/host/lan-bridge.js 把宿主/加入者/调度器接在一起
src/host/plugin.js 路由、命令分发
tools/lan-check.mjs 两台机器之间的联通自检
tools/real-shell.mjs 装进真 DSH 之后的样子:真页面、真点击、真 RPC,再截图
tools/preview/ 真实渲染截图工具(两份替身 + 无头 Chrome)
test/ 状态机 / 端到端 / LAN / 授权 / 客户端装载
docs/VERIFICATION.md 逐条验证证据(含反证)
docs/SCREENSHOTS.md 每张图的故事与截图口径
docs/SECURITY.md 信任边界
docs/ARCHITECTURE.md 架构与决策
License
MIT
Comments
Loading…
Similar plugins
Self-hosted chat room where the owner and coding agents share one room: a local Node server (SQLite, REST, SSE) that the plugin starts when it is not running, a DSH sidebar entry that opens the room i
★ 0
dsh plugin --profile web add llm-agent-chat-roomby CLnum42
Chat with DeepSeek's web端 (chat.deepseek.com) inside DeepSeek Harness as a native panel, then distill or replay the conversation into a new harness session.
★ 4
↓ 338/wk
Apache-2.0
TypeScript
Oct 20, 2026
dsh plugin --profile web add dsh-dschatby liaowenqi123
DSH 多 Agent「会议室」插件:会议室会籍 + fork 上下文入场 + 主持人控场多轮讨论 + 会后各自压缩纪要并回到工作区继续干活。基于 dsh-std 元协议(Community v0.15)。
★ 1
MIT
TypeScript
Sep 24, 2026
dsh plugin --profile web add dsh-meeting-coordinatorThree-player LAN Dou Dizhu (斗地主) played from a floating window: one machine opens a room on its own port, the other two join with a six-character room code plus an address. Empty seats can be filled b
★ 0
NOASSERTION
JavaScript
dsh plugin --profile web add dsh-doudizhuby chameleonn4
DSH 插件:自动读取本地 Codex 会话历史,让 DeepSeek Harness 与 Codex 无缝衔接
★ 3
MIT
JavaScript
Oct 27, 2026
dsh plugin --profile web add dsh-codex-historyby jasonchan2026
Offline LAN chat inside DSH: direct chats, group chats and file transfer between machines running the harness on the same network, with UDP auto-discovery, CIDR scanning to add contacts, an optional a
★ 0
MIT
JavaScript
Oct 25, 2026
dsh plugin --profile web add dsh-lan-chat