dsh-matrix-agent

Name: dsh-matrix-agent
Availability: InStock
Author: evlon

DeepSeek Harness（dsh）的 Matrix agent 桥接插件：把 Matrix 房间桥接到 harness agent 会话，每个房间一个会话，支持在聊天里远程监控、审批和追加指令；多分身架构 + 媒体/富文本/回复/编辑信息完整处理。

Stars: 0
Language: TypeScript
Created: Aug 27, 2026
Updated: Aug 28, 2026

Notify

GitHub repo

Introduction

dsh-matrix-agent

独立演进：本包由 dsh-matrix 独立而来，已断开与上游的远端关联，按自身路线演进。

src/
├── index.ts      # 插件入口（name/inject/apply/Config），无 default export
├── bridge.ts     # 桥接层：多账号编排（AccountBridge）、入站路由（@提及/私聊）、审批、授权、媒体注入、社交记忆、任务快照/时间线发布
├── matrix.ts     # 通道层：零依赖 Matrix client-server API 客户端（fetch + /sync 长轮询、媒体下载）
├── tools.ts      # 10 个工具（成员/消息/房间/用户/媒体/时间线查询、主动发送），经 ctx.tools.register 注册
├── config.ts     # Schemastery 配置 schema（含 digitalTwins、灵魂 soul、社交记忆、时间线、媒体/工具开关）
├── soul.ts       # 数字分身灵魂：灵魂 prompt 渲染、行为统计、twin_soul_status 工具、owner 推导纯函数
├── settings.ts   # dsh-matrix 统一 settings namespace（账号/灵魂/社交 + 任务/时间线快照镜像、live watch）
├── timeline.ts   # 自我时间线：跨房间记录分身出站动作（仅元数据，不落盘原文）
├── member-store.ts # 成员记忆库（记住每个房间见过的成员，含其他数字人）
├── store.ts      # 文件落盘状态：房间↔会话映射、事件去重环、sync token
├── auth-store.ts # 记忆授权库：分身↔Owner、工具授权、红线判定
├── client-main.js # 浏览器端源码（esbuild 打包为 __ModuleLoader__ bundle）：设置页（单入口+标签页，含时间线 tab）、会话任务 tab、所有任务面板
└── format.ts     # 保守 markdown 子集 → Matrix HTML，收敛前缀长回复分段，媒体占位描述

架构

整体拓扑：每个分身一个 harness 进程

┌──────────────────────────────────────────────────────────────────────────────┐
│                        Matrix 房间（每个平台/模块一个房间）                        │
│                                                                              │
│   真人同事 @tianjintao   真人（Owner）@niukunliang     其他分身 @ai-liuliye      │
│     （Matrix 客户端）      （Matrix 客户端，仅客户端登录）   （跑在自己的 harness）    │
└──────────┬──────────────────────┬─────────────────────────┬──────────────────┘
           │                      │                         │
           │       房间内对话 / @提及 / 审批「批准/拒绝」        │
           ▼                      ▼                         ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│                         Matrix Homeserver（im-ipm.ict.cmcc）                    │
└──────┬───────────────────────┬──────────────────────────┬───────────────────┘
       │                       │                          │
       ▼                       ▼                          ▼
┌──────────────┐      ┌──────────────┐           ┌──────────────┐
│ Harness 进程 A │      │ Harness 进程 B │           │ Harness 进程 C │
│              │      │              │           │              │
│ userId:      │      │ userId:      │           │  （每个分身    │
│ @ai-niukun-  │      │ @ai-niukun-  │           │   一个独立     │
│ liang        │      │ liang-dev    │           │   进程）       │
│ owner:       │      │ owner:       │           │              │
│ @niukunliang │      │ @niukunliang │           │              │
└──────┬───────┘      └──────┬───────┘           └──────────────┘
       │                     │
       ▼                     ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│                          dsh-matrix 插件（每个进程各跑一份）                      │
│                                                                              │
│  ┌────────────────┐  ┌────────────────┐  ┌────────────────────────────────┐  │
│  │ 通道层 matrix.ts │  │ 桥接层 bridge.ts │  │ 授权库 auth-store.ts            │  │
│  │ · /sync 长轮询   │  │ · 消息路由        │  │ · 记忆授权（L1 静默放行）         │  │
│  │ · send/typing  │  │   @提及/私聊/兜底 │  │ · Owner 房间确认（L2）            │  │
│  │ · 邀请自动加入    │  │ · 合并窗口 .. !!  │  │ · 红线强制确认（L3，每次）        │  │
│  │                │  │ · per-room agent │  │ · auth-store.json 落盘          │  │
│  └────────────────┘  └────────────────┘  └────────────────────────────────┘  │
└──────────────────────────────────────────────────────────────────────────────┘

身份模型

角色	Matrix 账号	登录位置	职责
真人（Owner）	`@niukunliang:im-ipm.ict.cmcc`	仅 Matrix 客户端	在房间与分身对话、应答「批准/拒绝」审批、吊销授权
数字分身	`@ai-niukunliang:im-ipm.ict.cmcc`	自己的 harness 进程	与真人同事、其他分身协作，执行研发/测试等工作
真人同事	`@tianjintao:im-ipm.ict.cmcc` 等	Matrix 客户端	在房间与分身协作（能否驱动分身由白名单控制）

每个分身 = 一个独立 Matrix 账号 + 一个独立 harness 进程。分身账号的 owner 指向其工作责任负责人（真人），审批/吊销授权仅 Owner 可应答。

三级授权

分身请求执行工具
      │
      ▼
┌──────────────┐  命中红线（bash/write/edit…）  ┌──────────────────┐
│ 红线检查?      │ ───────────────────────────▶│ L3 强制房间确认     │
└──────┬───────┘                              │ （每次都要，不入库） │
       │ 未命中                              └──────────────────┘
       ▼
┌──────────────┐  有记忆授权                    ┌──────────────────┐
│ 记忆授权库?    │ ───────────────────────────▶│ L1 静默放行        │
└──────┬───────┘                              └──────────────────┘
       │ 无记录
       ▼
┌─────────────────────────────────────────────────────────────┐
│ L2 房间确认：推送审批 → 仅 Owner 回复「批准」有效                  │
│   → 批准后写入记忆授权（auth-store.json），下次同类工具 L1 放行     │
└─────────────────────────────────────────────────────────────┘

能力

Matrix → DSH：白名单用户文本经合并窗口（.. 继续 / !! 立即提交 / 裸文本进合并窗口）后，通过 agent.followup 注入对应房间的 agent 会话；/bind <session-id> 可切换到已有会话
媒体处理（图片/文件/音视频/位置）：入站非文本消息自动下载（mxc:// → /media/v3/download），保存到房间工作区 .dsh-matrix/media（或 stateDir/media）并附上本地路径；图片额外持久化为多模态 image 内容块，让模型直接看见——即使模型不支持视觉，harness 也会优雅降级为文本占位而非报错（避免旧版 read_image 工具不存在导致的 unknown tool 失败）；位置消息带坐标
信息完整（类人处理）：preserveRichText（默认开）时入站消息信息不丢失——图文混排保留文字说明（caption，修复旧版丢 caption bug）、富文本（formatted_body 的链接/加粗/代码块/列表）注入结构注记、回复引用（m.in_reply_to）注入被回复原消息上下文、编辑（m.replace）标记为最新版并在聊天记录里去重替换；设为 false 回退纯文本旧行为
9 个 Matrix 工具（经 ctx.tools.register 注册，模型可见且可直接执行）：matrix_get_room_members / matrix_get_recent_messages / matrix_get_room_info / matrix_get_user_info / matrix_send_room_message / matrix_send_dm / matrix_mention_member / matrix_list_rooms / matrix_get_media（详情见下方「Matrix 工具」）
主动消息：agent 可主动私聊、向房间发消息、@成员（matrix_send_dm/send_room_message/mention_member）；首用经 Owner 审批记忆授权（proactiveSendRequiresApproval），或配置关闭直接允许
房间事件：入群/离群/邀请/改名换头像/房间名/主题变化经 onRoomEvent 投影，notifyRoomEvents 开启后注入 agent 会话（供主动打招呼等）
DSH → Matrix：监听 session/event，把 assistant/message 的可见文本分段（前缀 （i/n） 参与长度收敛）后以 org.matrix.custom.html 发回；turn/start 显示 typing
数字分身架构：每个分身一个 harness 进程——userId 即分身账号（bot 自己登录），owner 是真实人账号（仅在 Matrix 客户端登录）。分身与真人同事、其他分身在同一房间协作；@提及路由、私聊判定、多账号协调（可选 digitalTwins 同进程跑多分身）均已支持
三级授权：
- L1 记忆授权：非红线工具此前被批准过 → 静默放行（auth-store.json 持久化）
- L2 即时确认：房间推送审批，配置了 owner 的账号仅 Owner 可应答，批准后写入记忆授权库
- L3 红线强制：命中 redlineTools（默认 bash/pwsh/write/edit）→ 每次都必须确认，批准永不入库
命令：/help /status /new /clear /bind <session-id> /auth list /auth revoke <tool> /auth revoke-all /memory /forget <userId>
数字分身灵魂：soul.* 配置（性格/风格/口头禅/习惯）经 agentSetup 注入每个 room agent 的 system prompt（section twin:soul，仅 Matrix 会话生效，不污染 GUI）；行为统计（回复数/工具调用/活跃时间）按 matrix- 前缀 session 聚合，分身可调用 twin_soul_status 工具读取自身人设与统计
社交记忆：分身被邀请入群后按 selfIntroTemplate 主动 @ 成员自我介绍（上限 maxSelfIntroMentions）；memberMemory 开启时记住每个房间里见过的成员（含其他数字人），/memory 查看、/forget <userId> 忘记；autoGreet 开启时新成员入群会提示 agent 主动打招呼了解对方
DSH Web 设置界面（单入口 + 标签页）：Client 半注册一个「数字分身」设置页（settings.section dsh-matrix），内部三个标签页——灵魂（预设/性格/风格/口头禅/习惯 + 行为模式）、Matrix 账号（连接/模型路由/白名单）、社交（自我介绍/成员记忆/打招呼）。配置统一持久化到 dsh-matrix settings namespace（连接类字段需重启生效）。可选项尽量用下拉：provider/model 来自 dsh 运行时目录（llm.providers/llm.models），agentPreset 来自 agentPresets.list；Owner 提供默认值提示——分身账号为 @ai-xxxxxx 时提示默认主人 @xxxxxx（仅配置页辅助，运行期不推导，显式配置优先）
任务视图（会话「任务」tab + 全局「所有任务」）：点击 Matrix 会话后，在「对话 / 轨迹 / 树状视图」后新增「任务」tab，展示该房间任务列表与状态（待审/已批/执行中/完成/拒绝），支持「批准/拒绝」按钮（复用 /approve N /reject N 命令语义）；会话头部「所有任务」按钮弹出全局面板，聚合所有会话的任务、按状态筛选、点击跳转对应会话。数据源为 Host 把各房间任务队列写入 dsh-matrix settings 的 tasksSnapshot 运行时镜像（非用户配置；任务变更防抖 300ms 更新）
自我时间线（跨房间记忆，防脑裂）：记录分身自己的出站动作——回复、工具调用、主动消息、自我介绍、审批、任务推送——到 twin-timeline.jsonl（仅结构化元数据：kind/roomId/时间/工具名/长度/主体，不落盘任何聊天原文，守住「聊天内容不落盘」红线）。按主体分层：actor: secretary（秘书的请示/确认/交付调度）vs worker（干活会话的执行回复/工具），twin_timeline 工具与时间线 UI 均可按主体筛选。逐级暴露：① 常驻 system prompt 段 twin:memory（恒定提示词，字节永不变化，不影响 KV 缓存命中率，仅告知"你有自我记忆可查"）；② 分身用 twin_timeline 工具查行动摘要；③ 细节用 matrix_get_recent_messages 现查对应房间。设置页「数字分身 → 时间线」tab 可查看/筛选（类型/主体/房间）/删除单条/清空全部（经 settings timelineOps 命令字段，Host 处理后清零）。配置：timelineEnabled（记录开关）、timelineInject（常驻提示词段开关）、timelineCrossRoom（跨房间共享门控，默认隔离）、timelineCap（内存上限）
秘书编排（角色化会话 + 开工请示 + 交付确认）：每个干活会话 = 一个角色化分身（roomRoles 房间→角色映射，如 { '!room:hs': 'dev' }；未配置用百变员工；领导拉群跨岗时任务级 role 覆盖）。任务流转对齐真实工作场景：开工前私下 DM 老板（matrix_send_dm）请示要求/优先级（taskClarifyBeforeStart，超时按原任务开工）→ 执行（角色 persona + 老板开工指示注入干活会话）→ 交付前私下 DM 老板结果摘要请求确认（taskConfirmBeforeDeliver，老板回「交付」则交付回原房间、回意见则修订、超时按 taskConfirmTimeoutAction hold/deliver/cancel）→ 对外交付。多轮确认：老板可多次给指示/意见（任务保持 clarifying/confirming，直到「批准开工」/「确认交付」才流转）。老板在私聊房的回复经 ownerDmRoomId 路由到对应任务（不污染任务队列）。任务状态含 clarifying(🤔请示中)/confirming(🔐待确认)。配置：roomRoles、taskClarifyBeforeStart、taskClarifyTimeoutSecs、taskConfirmBeforeDeliver、taskConfirmTimeoutSecs、taskConfirmTimeoutAction、taskConfirmExemptMatters
秘书工作台 UI（大尺寸面板，合理利用桌面可视区）：入口——会话头部右上角快捷入口（conversation.session.header.utilities）。点击弹出大尺寸面板（占可视区 ~68% 宽、全高、右滑 + 遮罩），两栏布局（中间分隔条可拖拽调宽度，28%–72%）：左栏任务列表（按流转分组：待审/🤔请示中/执行中/🔐待确认/完成/已拒绝，每行状态/角色/房间/工作目录状态）、右栏选中任务详情（完整文本/角色/房间/发起人/工作目录/老板指示与意见历史/操作按钮）。任务 tab：老板直接「批准开工/给指示/确认交付/给意见/批准/拒绝」+ 设工作目录（未设目录任务输入路径绑定 cwd，等价于拖到工作区）；时间线 tab：自我记忆（主体秘书/干活筛选、删除/清空）。操作经 settings secretaryOps 命令字段（含 set-cwd），Host 处理后清零。私聊回复仍保留为备选（状态机幂等）。会话头部「所有任务」按钮已移除，由工作台统一
可靠性：事件 id 持久去重环、sync token 落盘重启续传、长回复 HTML 失败回退纯文本、sync 循环指数退避、LLM 受限重试熔断（maxRetriesBeforeAbort）

Matrix 工具

matrixTools: true（默认）时经 ctx.tools.register 注册以下 10 个工具，agent 既能看见 schema 也能直接调用执行体：

工具	说明
`matrix_get_room_members`	取房间成员名单（含显示名/头像 URL）
`matrix_get_recent_messages`	取房间最近 N 条消息（正序，按需回溯上下文）
`matrix_get_room_info`	取房间基本信息（房间名、人数、是否私聊等）
`matrix_get_user_info`	取指定用户的显示名与头像
`matrix_send_room_message`	主动向房间发文本/HTML 消息
`matrix_send_dm`	主动给指定用户私聊（自动复用既有 1:1 房或 create-room+invite）
`matrix_mention_member`	发消息并 @ 一个或多个成员（HTML `m.mention` 锚点 + `@名字` 文本兜底，校验目标都是房间成员）
`matrix_list_rooms`	列出已加入房间及名称/成员数
`matrix_get_media`	下载 Matrix 媒体（`mxc://`）为本地文件并返回路径，或返回 base64
`twin_timeline`	查自己的跨房间时间线（仅结构化元数据：回复/工具/主动消息/自我介绍/审批/任务），回忆自己在别处做过的事，防脑裂

主动发送类工具（matrix_send_dm/send_room_message/mention_member）isConcurrencySafe=false（防并行重复发送），首用经 proactiveSendRequiresApproval 控制。

为什么通道层不用现成 SDK

matrix-js-sdk 的 Node ESM 导入在 v42 是坏的（oauth 模块的目录导入，官方建议用户自己上 bundler）；matrix-bot-sdk 的 E2EE 原生二进制依赖被 pnpm 默认拦截的 postinstall 下载。而 dsh 插件运行在 dsh 自己的 Node 进程里，两者都不合适。因此通道层参照 telegram 插件自写客户端的做法，用 fetch 直连 client-server API（sync / send / typing / join 四个端点），零运行时协议依赖，dsh plugin add 安装无需任何构建授权。

安装

# 从本仓库 checkout 安装到 profile（dsh.bundle 声明自动加入组合层）
dsh plugin --profile web add .
# 或 git 安装（需要 pnpm 允许该包的 prepare 构建脚本，见 dsh 官方 publish 教程）
dsh plugin --profile web add github:you/dsh-matrix
# 验证
dsh --profile web --dump-config | grep matrix

git 安装拉的是源码：本包 prepare 脚本用 tsc 从 src/ 构建出 lib/，pnpm ≥10 首次 add 会因未授权构建脚本失败，把提示的包键加进该 profile 的 pnpm-workspace.yaml 后重试：

allowBuilds:
  dsh-matrix: true

也支持 npm 发布 / pnpm pack tarball，两种都不需要构建授权。

配置

在 profile 的 cordis.patch.yml 行上覆盖（整个 config 值替换，不深合并）：

字段	默认	说明
`homeserverUrl`	必填	homeserver 的 client-server API base URL
`accessToken`	`''`	分身 access token；为空回退环境变量 `DSH_MATRIX_TOKEN`，两者都缺则插件加载失败
`userId`	必填	本进程登录的数字分身账号，如 `@ai-niukunliang:example.org`
`owner`	`''`	工作责任负责人（真人账号，仅客户端登录）；设置后审批/吊销仅其可应答
`respondToAll`	`true`	响应房间所有消息；设为 `false` 则仅 @提及/私聊响应
`allowedUserIds`	`[]`	白名单；为空且 `allowAllUsers=false` 时拒绝所有人（fail closed）
`allowAllUsers`	`false`	允许任意用户（仅开发用）
`provider`	`deepseek-official`	每个房间 agent 的 LLM provider
`model`	`deepseek-v4-flash`	每个房间 agent 的模型
`agentPreset`	`standard`	room agent 挂载的 agent preset（决定工具集与角色提示）；留空则无工具
`chunkMaxChars`	`4000`	出站单条消息字符上限（含分段前缀）
`mergeTimeoutSecs`	`5`	裸文本合并窗口（秒）
`approvalTimeoutSecs`	`300`	审批推送后等待聊天答复的秒数
`stateDir`	`.dsh-matrix`	状态目录（`state.json` 房间映射 + 去重 + sync token）
`maxRetriesBeforeAbort`	`5`	同一房间 turn 内 LLM 受限自动重试达到该次数时主动 cancel 止损
`retryCircuitBreakerEnabled`	`true`	是否启用重试熔断兜底
`digitalTwinMode`	`false`	可选：同一进程挂载多个分身（见下方示例）
`digitalTwins`	`[]`	额外分身账号列表（通常每个分身一个进程，无需配置此项）
`authStoreFile`	`auth-store.json`	记忆授权库文件名（相对 `stateDir`）
`redlineTools`	`['bash','pwsh','write','edit']`	红线工具：即使有记忆授权也每次强制房间确认
`cwdCandidates`	`[进程 cwd]`	新房间工作目录引导的候选目录列表；首项作为缺省
`taskQueueMax`	`20`	单个房间 matrix 任务队列上限，超出后最早 pending 任务自动拒绝
`matrixTools`	`true`	是否注册 9 个 Matrix 工具（成员/消息/房间/用户查询、主动发送、媒体下载）
`notifyRoomEvents`	`false`	是否把入群/离群/资料变更等房间事件注入 agent 会话（供主动打招呼等）
`proactiveSendRequiresApproval`	`true`	主动消息工具（`matrix_send_dm`/`send_room_message`/`mention_member`）首用是否需 Owner 批准
`preserveRichText`	`true`	是否保留富文本（`formatted_body`）/回复上下文/编辑语义，结构化注入 agent（类人信息完整）；`false` 回退纯文本
`soul.enabled`	`true`	是否启用灵魂注入（性格/风格/口头禅/习惯注入 room agent 的 system prompt）
`soul.persona`	`'你叫小灵…'`	性格/人设描述（自由文本）
`soul.style`	`'friendly'`	说话风格：`concise`/`friendly`/`formal`/`humorous`/`sassy`
`soul.catchphrase`	`'交给我吧'`	口头禅（可选）
`soul.habits`	`'先确认需求再动手…'`	工作习惯（自由文本）
`soul.replyLength`	`'short'`	回复长度偏好：`short`/`normal`/`detailed`

内置灵魂预设（设置页「选择预设」一键填充，可再微调后保存）：

预设	适用
`default` 默认（综合助手）	通用助手，靠谱有人情味
`pm` 产品经理	关注用户价值与目标拆解，习惯先对齐需求
`dev` 研发工程师	技术扎实、沟通直接，先说根因再给方案
`qa` 测试工程师	细心严谨，问题描述带复现步骤/预期/实际
`leader` 领导（负责人）	看全局抓重点，协调资源推动决策
`newbie` 新入职员工	谦虚好学，持续学习完善，不懂就问
`autoIntroduce`	`true`
`maxSelfIntroMentions`	`20`
`memberMemory`	`true`
`autoGreet`	`true`
`selfIntroTemplate`	模板

配置示例

推荐：每个分身一个 harness 进程（单账号模式）

# 分身 @ai-niukunliang 的 profile 配置
userId: '@ai-niukunliang:example.org'        # 本进程登录的分身
accessToken: '...'                            # 分身的 token（或 tokenEnv 环境变量）
owner: '@niukunliang:example.org'             # 真人账号（仅客户端登录）：审批仅其可应答
respondToAll: true                            # 参与房间协作，响应所有消息
allowAllUsers: false                          # 生产建议用白名单 fail closed
allowedUserIds: ['@niukunliang:example.org', '@tianjintao:example.org']

可选：同一进程挂载多个分身（digitalTwinMode）

digitalTwinMode: true
digitalTwins:
  - userId: '@ai-niukunliang-pm:example.org'        # 分身账号（需预先注册并取得 access token）
    tokenEnv: 'DSH_MATRIX_AI_NIUKUNLIANG_PM_TOKEN'  # 从环境变量读 token（推荐）；或直接 accessToken
    owner: '@niukunliang:example.org'               # 工作责任负责人：仅其可在房间应答审批
    role: 'pm'                                      # 角色标签（展示用）
    respondToAll: false                             # 默认仅 @提及/私聊 响应；true 则响应所有消息
    provider: ''                                    # 留空回退顶层 provider/model
    model: ''

每个分身独立 sync 循环、独立状态文件（<stateDir>/twins/<localpart>.json）、独立 per-room agent 会话；审批按「分身×房间」维度记录记忆授权，Owner 变更不影响其他分身。

使用

真实人在 Matrix 客户端登录自己的账号（如 @niukunliang），把它加进目标房间
每个分身账号各启动一个 harness：dsh --profile <分身profile>，插件自动加入房间（邀请自动接受）
房间里 @提及分身即可让它干活；分身要执行红线工具时会推送审批，Owner 在客户端回复「批准/拒绝」（超时按 unavailable 处理）
常用命令：/status（看会话）、/auth list（看记忆授权）、/auth revoke <tool>（吊销，仅 Owner）
dsh plugin --profile web remove dsh-matrix 卸载；组合层变更需重启 dsh 进程（不参与 HMR）

安全红线

Matrix 通道等于绕过本机批准体系：approval 应答必须来自白名单 sender 且对应本房间真实 pending 的审批
聊天内容只能进会话流（source.kind = 'plugin'），绝不允许直接执行 shell
access token 不进日志、不落盘；state.json 不包含任何聊天内容

开发

corepack pnpm install
corepack pnpm test        # tsc + node --test（format 单测 + 假 homeserver 端到端）+ esbuild 打包 client
corepack pnpm build       # tsc（lib/ 产物）+ esbuild 打包 src/client-main.js → lib/client.js

改完代码必须重新 build 并重启 dsh 进程（ESM 缓存 + web bundle 重新扫描）。

Client 半构建约定：dsh web 的 client-modules 加载器要求 exports["./client"] 指向 window.__ModuleLoader__.load({ id, factory }) 注册格式的自包含 bundle。本项目用 esbuild 打包：src/client-main.js（ES module 源码，import React） → CJS bundle → banner/footer 包装成 __ModuleLoader__.load 格式 → lib/client.js （见 scripts/build-client.mjs）。react 外部化（dsh 模块系统的 shell seed，由 factory(require) 注入，避免与 shell 的 React 实例冲突）；其余代码内联自包含。构建后自动 node --check 语法自检。改 client 半时改 src/client-main.js，不要改 lib/client.js。

已知限制与路线图

仅非加密房间：m.room.encrypted 事件只提示不支持（E2EE 二期：Rust crypto + 设备验证）
媒体已支持，但无 OCR/转写：图片/文件/音视频会下载落盘并作为多模态附件/路径交给 agent；暂不内置 OCR、音频转写、视频抽帧等解析（可用 agent 自身能力或外部工具处理已保存的文件）
不流式推送工具进度：每条 assistant/message 一条（或多条分段）消息
仅长轮询：无 appservice/webhook 模式，主机需可出站访问 homeserver