@sidleo3/dsh-chat 0.0.4

package/client/i18n.js

@@ -0,0 +1,371 @@
+/**
+ * dsh-chat 的文案。每个包用自己的命名空间注册，互不覆盖。
+ *
+ * @module dsh-chat/client/i18n
+ */
+
+export const LOCALE_NAMESPACE = 'dsh-chat';
+
+export const zh = {
+  'Chat机器人': 'Chat机器人',
+  '模型': '模型',
+  '默认模型': '默认模型',
+  '推理等级': '推理等级',
+  '这个模型没有可选的推理等级。': '这个模型没有可选的推理等级。',
+  '先选一个模型。': '先选一个模型。',
+  '模型默认': '模型默认',
+  '部分 provider 读取失败：': '部分 provider 读取失败：',
+  '当前 Host 读不到模型目录。': '当前 Host 读不到模型目录。',
+  '还没有会话时用哪个模型：选完对下一条消息新建的会话生效。会话内还能单独改（面板的模型下拉）。':
+    '还没有会话时用哪个模型：选完对下一条消息新建的会话生效。会话内还能单独改（面板的模型下拉）。',
+
+  'Chat机器人设置': 'Chat机器人设置',
+  '渠道导航': '渠道导航',
+  '未安装任何聊天软件插件': '未安装任何聊天软件插件',
+  '安装渠道插件后，这里会出现对应的聊天软件。': '安装渠道插件后，这里会出现对应的聊天软件。',
+  '已知渠道插件': '已知渠道插件',
+  '渠道正在启动': '正在启动',
+  '渠道已就绪': '已就绪',
+  '渠道启动失败': '启动失败',
+  '渠道已停止': '已停止',
+  '重新读取': '重新读取',
+  '读取中…': '读取中…',
+  '上下文增强': '上下文增强',
+  '任务过程展示': '任务过程展示',
+  '保存': '保存',
+  '保存中…': '保存中…',
+  '取消': '取消',
+  '保存失败，请重试。': '保存失败，请重试。',
+  // 主动投递（共享组件 delivery-targets.js）
+  '主动投递': '主动投递',
+    '让定时任务或 agent 把结果直接发到指定会话。': '让定时任务或 agent 把结果直接发到指定会话。',
+  '显示项': '显示项',
+  '控制面板显示项': '控制面板显示项',
+  '只影响 /menu 发出来的那张卡片：关掉的项不显示，功能照旧（私聊与群聊分别设置）。': '只影响 /menu 发出来的那张卡片：关掉的项不显示，功能照旧（私聊与群聊分别设置）。',
+  '模型与推理等级': '模型与推理等级',
+  '会话': '会话',
+  'Agent 预设与工作区': 'Agent 预设与工作区',
+  '上下文增强（本会话）': '上下文增强（本会话）',
+  '访问策略（本会话）': '访问策略（本会话）',
+  '渠道设置（任务过程展示等）': '渠道设置（任务过程展示等）',
+  '渠道动作按钮（重连等）': '渠道动作按钮（重连等）',
+  '命令按钮（新会话/状态/诊断…）': '命令按钮（新会话/状态/诊断…）',
+  '拖动可调整顺序': '拖动可调整顺序',
+  '在渠道自己的配置里完成接入后，机器人会出现在这里。': '在渠道自己的配置里完成接入后，机器人会出现在这里。',
+  '私聊': '私聊',
+  '群聊': '群聊',
+  '候选': '候选',
+  '保存为投递目标': '保存为投递目标',
+  '重命名': '重命名',
+  '自定义名称': '自定义名称',
+  '留空则用自动识别的名字': '留空则用自动识别的名字',
+  '已改名。': '已改名。',
+  '已恢复自动名字。': '已恢复自动名字。',
+  '删除': '删除',
+  '确认删除': '确认删除',
+  '当前渠道不支持主动投递。': '当前渠道不支持主动投递。',
+  
+  '已保存，现在可以主动发消息了。': '已保存，现在可以主动发消息了。',
+  '已删除。': '已删除。',
+  '还没有可添加的会话：在群里 @ 一次机器人，或与它私聊一次，会话就会出现在这里，保存后即可主动投递。': '还没有可添加的会话：在群里 @ 一次机器人，或与它私聊一次，会话就会出现在这里，保存后即可主动投递。',
+  '没有可添加的会话：在群里 @ 一次机器人，或与它私聊一次，该会话就会出现在这里。': '没有可添加的会话：在群里 @ 一次机器人，或与它私聊一次，该会话就会出现在这里。',
+  '上面标「候选」的会话还不能主动投递，点「保存为投递目标」后才行。': '上面标「候选」的会话还不能主动投递，点「保存为投递目标」后才行。',
+  '已保存': '已保存',
+  '可添加的候选': '可添加的候选',
+  '展开全部': '展开全部',
+  '收起': '收起',
+  '按名字或 id 过滤': '按名字或 id 过滤',
+  '没有匹配的目标。': '没有匹配的目标。',
+  '填入示例': '填入示例',
+  '清空': '清空',
+  '来源字段': '来源字段',
+  '启用': '启用',
+  '备注名（可选）': '备注名（可选）',
+  '张三': '张三',
+  '新增': '新增',
+  '还没有指定设置。': '还没有指定设置。',
+  '关闭': '关闭',
+  '增强提示词': '增强提示词',
+  '告诉模型如何使用来源字段。只填正文，插件会自动包成来源增强块。': '告诉模型如何使用来源字段。只填正文，插件会自动包成来源增强块。',
+  '叠加全局提示词（不勾选则只使用上面的专属提示词）': '叠加全局提示词（不勾选则只使用上面的专属提示词）',
+  '上下文增强': '上下文增强',
+  '未开启': '未开启',
+  '来源字段只在当前消息已提供时才会发送，不会额外查询平台接口。': '来源字段只在当前消息已提供时才会发送，不会额外查询平台接口。',
+  '上下文增强范围': '上下文增强范围',
+  '已开启': '已开启',
+  '从会话里选…': '从会话里选…',
+  '属主': '属主',
+  '属主不需要进白名单：消息与命令都直接放行。这里改完会重连一次，立刻生效。': '属主不需要进白名单：消息与命令都直接放行。这里改完会重连一次，立刻生效。',
+  '当前没有属主：没有人绕过访问策略，谁能用完全由下面的「访问策略」决定。': '当前没有属主：没有人绕过访问策略，谁能用完全由下面的「访问策略」决定。',
+  '从会话里选一个人设为属主': '从会话里选一个人设为属主',
+  '设为属主': '设为属主',
+  '没有可选的会话（先和机器人聊一次）': '没有可选的会话（先和机器人聊一次）',
+  '清空（无属主）': '清空（无属主）',
+  '清空后没有人绕过访问策略': '清空后没有人绕过访问策略',
+  // 机器人设置页的共享编辑块（bot-shared-settings.js）
+  '工作区': '工作区',
+  '机器人跑在哪个目录：能读写哪些文件、用哪份 AGENTS.md。只对新建会话生效。': '机器人跑在哪个目录：能读写哪些文件、用哪份 AGENTS.md。只对新建会话生效。',
+  '目录': '目录',
+  '下拉里是这台机器人用过的目录。': '下拉里是这台机器人用过的目录。',
+  'Agent 预设': 'Agent 预设',
+  '这个机器人用哪套 Agent 预设（人设与工具集）。只对新建会话生效。': '这个机器人用哪套 Agent 预设（人设与工具集）。只对新建会话生效。',
+  '当前 Host 读不到 Agent Preset 列表。': '当前 Host 读不到 Agent Preset 列表。',
+  '跟随 Host 默认': '跟随 Host 默认',
+  '访问策略': '访问策略',
+  '谁能跟机器人说话、谁能执行命令。改动立即生效；属主始终可用。': '谁能跟机器人说话、谁能执行命令。改动立即生效；属主始终可用。',
+  '访问模式': '访问模式',
+  '仅名单内可用': '仅名单内可用',
+  '任何人可用': '任何人可用',
+  '允许执行命令': '允许执行命令',
+  '可执行命令': '可执行命令',
+  '移除': '移除',
+  '添加': '添加',
+  '名单为空时只有属主可用。': '名单为空时只有属主可用。',
+  '对方的平台 id，回车添加': '对方的平台 id，回车添加',
+  // 版本与更新（version-panel.js）
+  '当前页面不支持渠道子槽。': '当前页面不支持渠道子槽。',
+  '设置': '设置',
+  '机器人': '机器人',
+  '每个机器人一行；点「设置」进入它的设置页（上下文增强、主动投递、工作区…）。':
+    '每个机器人一行；点「设置」进入它的设置页（上下文增强、主动投递、工作区…）。',
+  '这个渠道还没有机器人': '这个渠道还没有机器人',
+  '在渠道设置页完成接入（飞书填应用凭据、微信扫码）后，机器人会出现在这里。':
+    '在渠道设置页完成接入（飞书填应用凭据、微信扫码）后，机器人会出现在这里。',
+  '未命名机器人': '未命名机器人',
+  '这台机器人没有可用的身份标识，无法单独配置': '这台机器人没有可用的身份标识，无法单独配置',
+  '渠道设置': '渠道设置',
+  '打开渠道设置页': '打开渠道设置页',
+  '← 机器人列表': '← 机器人列表',
+  '已处理': '已处理',
+  '最近': '最近',
+  '运行正常': '运行正常',
+  '正在启动': '正在启动',
+  '重连中': '重连中',
+  '已停止': '已停止',
+  // 诊断面板（client/diagnostics.js）：出故障时的自助现场。
+  '诊断': '诊断',
+  '收起诊断': '收起诊断',
+  '出故障时先看这里：连接状态、最近错误、日志尾部。': '出故障时先看这里：连接状态、最近错误、日志尾部。',
+  '运行中': '运行中',
+  '启动中': '启动中',
+  '已连接': '已连接',
+  '未连接': '未连接',
+  '已处理': '已处理',
+  '去开通权限': '去开通权限',
+  '最近一次错误': '最近一次错误',
+  '这台渠道下还没有机器人。': '这台渠道下还没有机器人。',
+  '还没有日志': '还没有日志',
+  '看最后 40 行': '看最后 40 行',
+  '收起': '收起',
+  '版本与更新': '版本与更新',
+  '收起版本与更新': '收起版本与更新',
+  '升级插件后需要重启 dsh；只改设置页代码则刷新页面即可。':
+    '升级插件后需要重启 dsh；只改设置页代码则刷新页面即可。',
+  'Chat机器人内核': 'Chat机器人内核',
+  '渠道契约版本': '渠道契约版本',
+  '数据目录': '数据目录',
+  '日志目录': '日志目录',
+  '读取失败': '读取失败',
+  '更新方式：在仓库里拉取新代码后重新打包，再让 DSH 重新加载插件。':
+    '更新方式：在仓库里拉取新代码后重新打包，再让 DSH 重新加载插件。',
+  '发一条测试消息': '发一条测试消息',
+  '选择目标': '选择目标',
+  '发送': '发送',
+  '发送中…': '发送中…',
+  '测试消息内容': '测试消息内容',
+};
+
+export const en = {
+  '显示项': 'Section',
+  '控制面板显示项': 'Control panel sections',
+  '只影响 /menu 发出来的那张卡片：关掉的项不显示，功能照旧（私聊与群聊分别设置）。': 'Only affects the card sent by /menu: hidden items are not drawn, everything keeps working (direct and group are configured separately).',
+  '模型与推理等级': 'Model & reasoning',
+  '会话': 'Session',
+  'Agent 预设与工作区': 'Agent preset & workspace',
+  '上下文增强（本会话）': 'Context enhancement (this chat)',
+  '访问策略（本会话）': 'Access policy (this chat)',
+  '渠道设置（任务过程展示等）': 'Channel settings (step display etc.)',
+  '渠道动作按钮（重连等）': 'Channel actions (reconnect etc.)',
+  '命令按钮（新会话/状态/诊断…）': 'Command buttons (new session/status/diagnostics…)',
+  'Chat机器人': 'Chat bot',
+  '模型': 'Model',
+  '默认模型': 'Default model',
+  '推理等级': 'Reasoning effort',
+  '这个模型没有可选的推理等级。': 'This model has no reasoning efforts to choose from.',
+  '先选一个模型。': 'Pick a model first.',
+  '模型默认': 'Model default',
+  '部分 provider 读取失败：': 'Some providers failed to load: ',
+  '当前 Host 读不到模型目录。': 'The model catalog is unavailable right now.',
+  '还没有会话时用哪个模型：选完对下一条消息新建的会话生效。会话内还能单独改（面板的模型下拉）。':
+    'Model used before a conversation exists; it applies to the session created by your next message. You can still change it per conversation from the panel.',
+
+  'Chat机器人设置': 'Chat bot settings',
+  '渠道导航': 'Channel navigation',
+  '未安装任何聊天软件插件': 'No chat channel plugin installed',
+  '安装渠道插件后，这里会出现对应的聊天软件。':
+    'Install a channel plugin and its chat service appears here.',
+  '已知渠道插件': 'Known channel plugins',
+  '渠道正在启动': 'Starting',
+  '渠道已就绪': 'Ready',
+  '渠道启动失败': 'Failed to start',
+  '渠道已停止': 'Stopped',
+  '重新读取': 'Reload',
+  '读取中…': 'Loading…',
+  '上下文增强': 'Context enhancement',
+  '任务过程展示': 'Task progress display',
+  '保存': 'Save',
+  '保存中…': 'Saving…',
+  '取消': 'Cancel',
+  '保存失败，请重试。': 'Could not save. Try again.',
+  // 主动投递
+  '主动投递': 'Proactive delivery',
+  '让定时任务或 agent 把结果直接发到指定会话。':
+    'Let a scheduled job or an agent push results straight into a conversation.',
+  '拖动可调整顺序': 'Drag to reorder',
+  '在渠道自己的配置里完成接入后，机器人会出现在这里。': 'Once the channel is configured, its bots show up here.',
+  '私聊': 'Direct',
+  '群聊': 'Group',
+  '候选': 'Candidate',
+  '保存为投递目标': 'Save as target',
+  '重命名': 'Rename',
+  '自定义名称': 'Custom name',
+  '留空则用自动识别的名字': 'Leave empty to use the detected name',
+  '已改名。': 'Renamed.',
+  '已恢复自动名字。': 'Restored the detected name.',
+  '删除': 'Delete',
+  '确认删除': 'Confirm delete',
+  '当前渠道不支持主动投递。': 'This channel does not support proactive delivery.',
+  '已保存，现在可以主动发消息了。': 'Saved. You can now send proactively.',
+  '已删除。': 'Deleted.',
+  '还没有可添加的会话：在群里 @ 一次机器人，或与它私聊一次，会话就会出现在这里，保存后即可主动投递。':
+    'No conversation to add yet: mention the bot once in a group, or send it a direct '
+    + 'message — the conversation then shows up here and can be saved for proactive delivery.',
+  '没有可添加的会话：在群里 @ 一次机器人，或与它私聊一次，该会话就会出现在这里。':
+    'No conversation to add: mention the bot once in a group, or send it a direct message, and that conversation shows up here.',
+  '上面标「候选」的会话还不能主动投递，点「保存为投递目标」后才行。':
+    'A conversation marked "Candidate" cannot receive proactive messages yet — press "Save as target" first.',
+  '已保存': 'Saved',
+  '可添加的候选': 'Candidates',
+  '展开全部': 'Show all',
+  '收起': 'Collapse',
+  '按名字或 id 过滤': 'Filter by name or id',
+  '没有匹配的目标。': 'No target matches the filter.',
+  '填入示例': 'Fill with example',
+  '清空': 'Clear',
+  '来源字段': 'Source fields',
+  '启用': 'Enabled',
+  '备注名（可选）': 'Display name (optional)',
+  '张三': 'Alice',
+  '新增': 'Add',
+  '还没有指定设置。': 'Nothing configured yet.',
+  '关闭': 'Close',
+  '增强提示词': 'Prepended prompt',
+  '告诉模型如何使用来源字段。只填正文，插件会自动包成来源增强块。': 'Tell the model how to use the source fields. Write the body only — the plugin wraps it into a source block.',
+  '叠加全局提示词（不勾选则只使用上面的专属提示词）': 'Also stack the global prompt (unchecked: use only the prompt above)',
+  '上下文增强': 'Context enhancement',
+  '未开启': 'Off',
+  '来源字段只在当前消息已提供时才会发送，不会额外查询平台接口。': 'Source fields are sent only when the incoming message already carries them; no extra platform calls are made.',
+  '上下文增强范围': 'Context enhancement scope',
+  '已开启': 'On',
+  '从会话里选…': 'Pick a conversation…',
+  '属主': 'Owner',
+  '属主不需要进白名单：消息与命令都直接放行。这里改完会重连一次，立刻生效。': 'An owner does not need to be on the allowlist: their messages and commands always pass. Saving reconnects this bot once so the change takes effect immediately.',
+  '当前没有属主：没有人绕过访问策略，谁能用完全由下面的「访问策略」决定。': 'No owner right now: nobody bypasses the access policy, so who may use this bot is decided entirely by the access policy below.',
+  '从会话里选一个人设为属主': 'Pick a person from a conversation to make them the owner',
+  '设为属主': 'Make owner',
+  '没有可选的会话（先和机器人聊一次）': 'No conversation to pick yet (talk to the bot once first)',
+  '清空（无属主）': 'Clear (no owner)',
+  '清空后没有人绕过访问策略': 'After clearing, nobody bypasses the access policy',
+  // 机器人设置页的共享编辑块（bot-shared-settings.js）
+  '工作区': 'Workspace',
+  '机器人跑在哪个目录：能读写哪些文件、用哪份 AGENTS.md。只对新建会话生效。':
+    'Which directory the bot runs in: which files it may read and write, and which AGENTS.md'
+    + 'applies. Applies to new conversations only.',
+  '目录': 'Directory',
+  '下拉里是这台机器人用过的目录。': 'The suggestions are directories this bot has used before.',
+  'Agent 预设': 'Agent preset',
+  '这个机器人用哪套 Agent 预设（人设与工具集）。只对新建会话生效。':
+    'Which agent preset this bot uses (persona and tool set). Applies to new conversations only.',
+  '当前 Host 读不到 Agent Preset 列表。': 'This Host does not expose an agent preset list.',
+  '跟随 Host 默认': 'Follow the Host default',
+  '访问策略': 'Access policy',
+  '谁能跟机器人说话、谁能执行命令。改动立即生效；属主始终可用。':
+    'Who may talk to the bot and who may run commands. Changes apply immediately;'
+    + 'the owner always has access.',
+  '访问模式': 'Access mode',
+  '仅名单内可用': 'Allowlist only',
+  '任何人可用': 'Anyone',
+  '允许执行命令': 'Allow commands',
+  '可执行命令': 'Allow commands',
+  '移除': 'Remove',
+  '添加': 'Add',
+  '名单为空时只有属主可用。': 'An empty allowlist means only the owner can use it.',
+  '对方的平台 id，回车添加': 'Their platform id — press Enter to add',
+  '当前页面不支持渠道子槽。': 'This page does not support channel sub-slots.',
+  '设置': 'Settings',
+  '机器人': 'Bots',
+  '每个机器人一行；点「设置」进入它的设置页（上下文增强、主动投递、工作区…）。':
+    'One row per bot; click Settings to open its page (context enhancement, proactive delivery, workspace…).',
+  '这个渠道还没有机器人': 'No bot on this channel yet',
+  '在渠道设置页完成接入（飞书填应用凭据、微信扫码）后，机器人会出现在这里。':
+    'Finish onboarding on the channel page (Feishu app credentials, WeChat QR scan) and the bot shows up here.',
+  '未命名机器人': 'Unnamed bot',
+  '这台机器人没有可用的身份标识，无法单独配置':
+    'This bot has no usable identity, so it cannot be configured separately',
+  '渠道设置': 'Channel settings',
+  '打开渠道设置页': 'Open channel settings',
+  '← 机器人列表': '← Bot list',
+  '已处理': 'Handled',
+  '最近': 'Last',
+  '运行正常': 'Running',
+  '正在启动': 'Starting',
+  '重连中': 'Reconnecting',
+  '已停止': 'Stopped',
+  // 诊断面板（client/diagnostics.js）
+  '诊断': 'Diagnostics',
+  '收起诊断': 'Hide diagnostics',
+  '出故障时先看这里：连接状态、最近错误、日志尾部。':
+    'Start here when something breaks: connection state, latest errors, log tail.',
+  '运行中': 'Running',
+  '启动中': 'Starting',
+  '已连接': 'Connected',
+  '未连接': 'Disconnected',
+  '已处理': 'Handled',
+  '去开通权限': 'Grant the scope',
+  '最近一次错误': 'Last error',
+  '这台渠道下还没有机器人。': 'No bots on this channel yet.',
+  '还没有日志': 'No log yet',
+  '看最后 40 行': 'Show last 40 lines',
+  '收起': 'Hide',
+  '版本与更新': 'Version & updates',
+  '收起版本与更新': 'Hide version & updates',
+  '升级插件后需要重启 dsh；只改设置页代码则刷新页面即可。':
+    'Upgrading the plugin needs a dsh restart; settings-only changes just need a page refresh.',
+  'Chat机器人内核': 'Chat bot core',
+  '渠道契约版本': 'Channel contract version',
+  '数据目录': 'Data directory',
+  '日志目录': 'Log directory',
+  '读取失败': 'Failed to read',
+  '更新方式：在仓库里拉取新代码后重新打包，再让 DSH 重新加载插件。':
+    'To update: pull the repo, rebuild, then let DSH reload the plugin.',
+  '发一条测试消息': 'Send a test message',
+  '选择目标': 'Choose a target',
+  '发送': 'Send',
+  '发送中…': 'Sending…',
+  '测试消息内容': 'Test message',
+};
+
+/**
+ * 绑定一个命名空间的翻译函数。
+ *
+ * @param locale - DSH client 的 locale 服务。
+ * @returns (key) => string。
+ */
+export function bindTranslator(locale) {
+  const dictionary = { zh, en };
+  return (key) => {
+    const language = locale?.getSnapshot?.()?.locale ?? 'zh';
+    const table = dictionary[language] ?? zh;
+    return table[key] ?? zh[key] ?? key;
+  };
+}

package/client/index.js

@@ -0,0 +1,77 @@
+/**
+ * dsh-chat Hub：client 侧插件入口。
+ *
+ * 在设置页注册唯一的「Chat机器人」入口，向渠道插件发布两个服务：
+ * - `chatChannels`：渠道元数据注册表（驱动左栏）；
+ * - `chatUi`：共享组件、样式、RPC 助手。
+ * 并在 section 内声明 `chat.channel.page` 子槽，由渠道包注册自己的页面。
+ *
+ * @module dsh-chat/client/index
+ */
+
+import {
+  CHANNEL_PAGE_SLOT,
+  CLIENT_CHANNEL_SERVICE,
+  CLIENT_UI_SERVICE,
+  CONTRACT_VERSION,
+  SETTINGS_LABEL_KEY,
+  SETTINGS_SECTION_ID,
+  SETTINGS_SECTION_ORDER,
+  SETTINGS_SECTION_SLOT,
+} from '../shared/contract.mjs';
+import { createChannelRail } from '../shared/channel-rail.mjs';
+import { createChatUi } from './chat-ui.js';
+import { LOCALE_NAMESPACE, bindTranslator, en, zh } from './i18n.js';
+import { installSessionBadges } from './session-badges.js';
+import { ChatSettingsSection } from './section.js';
+import { installChatStyles } from './styles.js';
+
+export const name = 'dsh-chat-client';
+
+/** client 侧需要的浏览器服务。 */
+export const inject = ['slots', 'connection', 'locale'];
+
+function provideService(ctx, serviceName, value) {
+  if (typeof ctx?.reflect?.provide === 'function') return ctx.reflect.provide(serviceName, value);
+  if (typeof ctx?.provide === 'function') return ctx.provide(serviceName, value);
+  throw new TypeError(`dsh-chat 需要 Cordis 的 provide 能力来发布 ${serviceName} 服务。`);
+}
+
+/**
+ * Cordis client 插件入口。
+ *
+ * @param ctx - client 上下文。
+ */
+export function apply(ctx) {
+  ctx.effect(() => ctx.locale.register(LOCALE_NAMESPACE, { zh, en }),
+    'dsh-chat: 双语文案');
+  const t = typeof ctx.locale?.bind === 'function'
+    ? ctx.locale.bind(LOCALE_NAMESPACE)
+    : bindTranslator(ctx.locale);
+
+  const channels = createChannelRail();
+  const chatUi = createChatUi({ ctx, translate: t });
+
+  ctx.effect(() => provideService(ctx, CLIENT_CHANNEL_SERVICE, channels),
+    'dsh-chat: 渠道 rail 服务');
+  ctx.effect(() => provideService(ctx, CLIENT_UI_SERVICE, chatUi),
+    'dsh-chat: 共享 UI 套件');
+  ctx.effect(() => installChatStyles(), 'dsh-chat: 共享样式');
+  // 侧边栏会话行的渠道徽标：会话列表没有插槽，只能做纯装饰的 DOM 增强
+  // （保留「飞书 · 」文字前缀作为匹配依据与降级形态，卸载时全部还原）。
+  ctx.effect(() => installSessionBadges({ channels }), 'dsh-chat: 会话渠道徽标');
+
+  ctx.slots.inject(SETTINGS_SECTION_SLOT, () => ctx.slots.register({
+    name: SETTINGS_SECTION_SLOT,
+    id: SETTINGS_SECTION_ID,
+    order: SETTINGS_SECTION_ORDER,
+    label: () => t(SETTINGS_LABEL_KEY),
+    locale: LOCALE_NAMESPACE,
+    inject: () => ({
+      channels, chatUi, translate: t, contractVersion: CONTRACT_VERSION, connection: ctx.connection,
+    }),
+    children: {
+      [CHANNEL_PAGE_SLOT]: { kind: 'keyed', scope: 'root' },
+    },
+  }, ChatSettingsSection));
+}

package/client/list-order.js

@@ -0,0 +1,144 @@
+/**
+ * 界面列表顺序（左栏聊天软件、机器人列表）：纯显示偏好，存**浏览器** localStorage。
+ *
+ * 为什么不放 hub 的数据目录：它只影响"这台浏览器上怎么排"，不影响机器人的任何行为；
+ * 放浏览器里改完刷新即生效（不必重启 dsh），也不必为它加一套 RPC 与磁盘文档。
+ * 代价写在明处：换浏览器/换设备要重排一次；清掉站点数据会回到默认顺序。
+ *
+ * 未知键（新装的渠道、新加的机器人）排在**已排序的那些之后**，并保持它们之间的原有顺序
+ * ——默认顺序仍然由渠道注册的 `order` 与机器人的自然顺序决定。
+ *
+ * @module dsh-chat/client/list-order
+ */
+
+import * as React from 'react';
+
+const PREFIX = 'dsh-chat:order:';
+
+/** 渠道左栏的顺序键。 */
+export const CHANNEL_ORDER_KEY = `${PREFIX}channels`;
+
+/** 某个渠道下机器人列表的顺序键（每渠道一份）。 */
+export function botOrderKey(channelId) {
+  return `${PREFIX}bots:${channelId}`;
+}
+
+/** 安全拿一次 localStorage：无（Node/SSR）或抛异常（隐私模式）都当没有。 */
+function storageOf(storage) {
+  if (storage) return storage;
+  try {
+    return globalThis.localStorage ?? null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 读一份顺序。
+ *
+ * @param key - localStorage 键。
+ * @param storage - 可注入的 storage（测试用）。
+ * @returns 键数组；读不到/坏数据一律空数组（= 用默认顺序）。
+ */
+export function readOrder(key, storage = null) {
+  const store = storageOf(storage);
+  if (!store || typeof store.getItem !== 'function') return [];
+  try {
+    const raw = store.getItem(key);
+    if (!raw) return [];
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === 'string' && item) : [];
+  } catch {
+    // 坏数据不能让列表渲染不出来：当作"没排过"。
+    return [];
+  }
+}
+
+/**
+ * 写一份顺序（写失败就算了：这只影响显示顺序，不该弹错误）。
+ *
+ * @param key - localStorage 键。
+ * @param keys - 完整顺序。
+ * @param storage - 可注入的 storage（测试用）。
+ * @returns 是否写成功。
+ */
+export function writeOrder(key, keys, storage = null) {
+  const store = storageOf(storage);
+  if (!store || typeof store.setItem !== 'function') return false;
+  try {
+    store.setItem(key, JSON.stringify([...keys]));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 按已保存的顺序排列一批条目。
+ *
+ * 稳定排序：没记录过的条目保持各自原有相对顺序，排在已记录的那些之后。
+ *
+ * @param items - 待排列的条目。
+ * @param order - 已保存的键顺序。
+ * @param keyOf - 取键的函数。
+ * @returns 新数组（不修改入参）。
+ */
+export function orderedItems(items, order, keyOf) {
+  const list = Array.isArray(items) ? items : [];
+  if (!Array.isArray(order) || order.length === 0) return [...list];
+  const rank = new Map();
+  order.forEach((key, index) => rank.set(key, index));
+  return [...list].sort((left, right) => {
+    const a = rank.has(keyOf(left)) ? rank.get(keyOf(left)) : Number.MAX_SAFE_INTEGER;
+    const b = rank.has(keyOf(right)) ? rank.get(keyOf(right)) : Number.MAX_SAFE_INTEGER;
+    return a - b;
+  });
+}
+
+/**
+ * 把 `fromKey` 挪到 `toKey` 原来的位置。
+ *
+ * @param keys - 当前顺序（应包含这两个键）。
+ * @param fromKey - 被拖动的键。
+ * @param toKey - 落点键。
+ * @returns 新顺序；参数不合法时原样返回（不产生"半截顺序"）。
+ */
+export function moveKey(keys, fromKey, toKey) {
+  const list = Array.isArray(keys) ? [...keys] : [];
+  const from = list.indexOf(fromKey);
+  const to = list.indexOf(toKey);
+  if (from < 0 || to < 0 || from === to) return list;
+  list.splice(from, 1);
+  list.splice(to, 0, fromKey);
+  return list;
+}
+
+/**
+ * 某个列表的排序状态（读一次、拖动时写回）。
+ *
+ * @param key - localStorage 键（用 `CHANNEL_ORDER_KEY` / `botOrderKey(id)`）。
+ * @param keyOf - 取键的函数（用于把当前渲染顺序换算成"完整键序列"）。
+ * @returns `{ order, ordered, move, reset }`。
+ */
+export function useListOrder(key, keyOf) {
+  const [order, setOrder] = React.useState(() => readOrder(key));
+  // 换渠道（机器人列表的键变了）要重新读一份，否则会把上一个渠道的顺序套上来。
+  React.useEffect(() => {
+    setOrder(readOrder(key));
+  }, [key]);
+
+  const move = React.useCallback((items, fromKey, toKey) => {
+    const current = (Array.isArray(items) ? items : []).map(keyOf);
+    const next = moveKey(current, fromKey, toKey);
+    setOrder(next);
+    writeOrder(key, next);
+    return next;
+  }, [key, keyOf]);
+
+  const reset = React.useCallback(() => {
+    setOrder([]);
+    writeOrder(key, []);
+  }, [key]);
+
+  return { order, move, reset };
+}

package/client/rpc.js

@@ -0,0 +1,52 @@
+/**
+ * 浏览器侧 RPC 调用：所有渠道共用同一条 `/api/dsh-chat/<channelId>` 通道，
+ * 控制端点固定为 `control`。与 host 的 rpc.mjs 共享同一份线路格式。
+ *
+ * @module dsh-chat/client/rpc
+ */
+
+import { CONTROL_CHANNEL_ID, RPC_PREFIX } from '../shared/contract.mjs';
+
+/**
+ * @param channelId - 渠道 id（控制端点用 CONTROL_CHANNEL_ID）。
+ * @returns 端点名，如 `dsh-chat/feishu`。
+ */
+export function chatEndpoint(channelId) {
+  return `${RPC_PREFIX}/${channelId}`;
+}
+
+/**
+ * 调用一次聊天插件 RPC。
+ *
+ * @param connection - DSH client 的 connection 服务。
+ * @param channelId - 渠道 id 或 'control'。
+ * @param method - 方法名。
+ * @param payload - 载荷。
+ * @param signal - AbortSignal。
+ * @returns RPC 结果对象 `{ ok, value }` 或 `{ ok:false, error }`。
+ */
+export function callChatRpc(connection, channelId, method, payload = {}, signal) {
+  if (typeof connection?.rpc?.call !== 'function') {
+    throw new TypeError('当前页面缺少 DSH Connection RPC 能力。');
+  }
+  return connection.rpc.call('/api', chatEndpoint(channelId), { method, payload }, signal);
+}
+
+/** 便捷封装：只调用 hub 控制端点。 */
+export function callControlRpc(connection, method, payload, signal) {
+  return callChatRpc(connection, CONTROL_CHANNEL_ID, method, payload, signal);
+}
+
+/**
+ * 把 `{ ok:false, error }` 结果转成异常，便于在 UI 的 try/catch 里统一处理。
+ *
+ * @param result - RPC 结果。
+ * @returns 成功时的 value。
+ */
+export function unwrapRpc(result) {
+  if (result?.ok === true) return result.value;
+  const error = new Error(result?.error?.message ?? '聊天插件调用失败。');
+  error.code = result?.error?.code ?? 'chat/rpc-failed';
+  error.details = result?.error?.details ?? {};
+  throw error;
+}