DSH 会话人格 · 飞书聊天扩展
为 DeepSeek Harness 的飞书会话添加「小鲸鱼 / 傲娇助手」、表情库、主动聊天和自主参与群聊。每个会话单独设置，普通任务、新会话默认关闭。
完整功能必须配合本仓库的 IM Connect 人格扩展版使用。
配套包名：@michengai/dsh-im-connect，版本：1.0.8-personas.6，源码位于 im-connect/。它基于 MichengAI/dsh-im-connect 1.0.8 修改。普通上游 1.0.8 没有本项目所需的表情传输、后台唤醒和群消息观察接口。
兼容版本
| 组件 | 已验证版本 | 用途 |
|---|
| DeepSeek Harness 桌面端 | 0.2.1-rc.2 | 宿主、模型、权限与原生插件管理 |
| dsh-task-personas | 0.7.0 | 本仓库根目录；人格、表情库、聊天节奏与群消息判断 |
| IM Connect 人格扩展版 | @michengai/dsh-im-connect@1.0.8-personas.6 | 本仓库 im-connect/；飞书接收与原生消息发送 |
配套桥接保留上游包名，因此它会替换同名 IM Connect 包，不要并行启动两份桥接。其他宿主版本尚未验证。人格提示词不替换宿主预设，也不改变会话模型或人工审批策略。
安装
桌面界面
在 v0.7.0 Release 下载这两个文件：
michengai-dsh-im-connect-1.0.8-personas.6.tgz：配套 IM 插件。dsh-task-personas-0.7.0.tgz：人格插件。
在 DSH 的「插件 → 添加插件」中依次安装两个本地安装包并启用，然后重启 DSH。已有 IM Connect 用户使用第一个包替换上游包；如界面提示同名包已安装，先通过原生插件管理器移除旧包，再安装扩展版。飞书应用凭据只在你自己的 DSH 配置界面填写。
也可直接使用 Release 下载地址：
https://github.com/chencujinlin/dsh-task-personas/releases/download/v0.7.0/michengai-dsh-im-connect-1.0.8-personas.6.tgz
https://github.com/chencujinlin/dsh-task-personas/releases/download/v0.7.0/dsh-task-personas-0.7.0.tgz
macOS 桌面端 CLI
先完全退出 DSH，再使用桌面端自带的 CLI：
dsh_bin='/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh'
"$dsh_bin" plugin --profile desktop add --ignore-scripts \
'https://github.com/chencujinlin/dsh-task-personas/releases/download/v0.7.0/michengai-dsh-im-connect-1.0.8-personas.6.tgz' \
'https://github.com/chencujinlin/dsh-task-personas/releases/download/v0.7.0/dsh-task-personas-0.7.0.tgz'
Desktop 的 profile 与普通全局/Web CLI 独立。安装后打开桌面应用，在插件页确认两项均已启用。发布包包含预构建 JavaScript，无需修改应用包或编译宿主；--ignore-scripts 跳过依赖安装脚本，本项目不需要执行这些脚本。若界面安装遇到 Ignored build scripts: protobufjs，使用上述命令，无需放宽全局脚本审批设置。Release 提供 SHA256SUMS.txt。
使用
- 在 IM Connect 中配置飞书账号并建立会话。
- 打开 DSH「频道」中的目标会话，在输入栏的人格菜单选择「小鲸鱼」或「傲娇助手」。
- 想让机器人参与群聊时，为该群打开「自主参与群聊」。
- 在「群机器人」里查看其他机器人的 ID，选择可互聊的对象；在「表情库」里导入或收藏表情。
人格切换从下一次模型请求生效，聊天记录保留。桥接 /new 或重置生成的新会话不继承旧人格；子智能体也不继承。
群消息全部阅读，模型决定是否回复
- 已开启自主参与的群：收到的真人消息与已选机器人消息都会进入模型判断，没有 5% 抽样、每分钟一次或每小时 12 次的群消息唤醒限制。
- 连续消息先合并约 8 秒，再分批交给模型；每批最多 40 条未读消息。会话忙时排队，超过两分钟也不会丢弃实时未读消息。
- 未读队列与最近 12 条已读背景分开；消息进入宿主模型输入事件后才确认已读。模型可以调用
feishu_social_skip，安静结束。
- **台北时间 22:00–次日 08:00 不回应其他机器人，真人消息照常。**夜间不补发机器人旧消息；机器人草稿发送前会再检查时段。
- @ 当前机器人的请求沿用原有工作流程。普通旁观消息只允许聊天工具，不据此执行本地命令或账号操作。
旁观文字每条最多 500 字；未 @ 的图片、表情和文件提供占位，不自动下载或声称已看图。实时观察和未读队列暂存在内存，退出应用后不自动补发。可手动用「补读接入后群消息」读取该会话首次接入后的可见历史：最多查询 200 条，最近 40 条作为背景；模型不会逐条补答旧消息。
表情与主动聊天
- 导入 PNG / JPG / WEBP / GIF，填写名称、适用场景并收藏；也可收藏当前飞书会话收到的图片或原生表情。发布仓库不附带任何个人表情收藏。
- 模型通过
feishu_send_message / feishu_send_sticker 发言，普通内部叙述不会自动转发到飞书。飞书普通回复为原生文字气泡，审批按钮仍使用交互卡片。
- 人格菜单的「主动聊天」控制冷场开聊：30～90 分钟检查、安静至少 15 分钟、基础概率 30%。这套冷场节奏与实时群消息全量阅读独立。
- 图片和文字保留发送频率保护，未确认的发送不自动重试。发送目标由当前会话绑定决定，模型不能任意指定收件人。
飞书权限
在飞书应用后台配置相应权限及 im.message.receive_v1 事件订阅，发布应用版本使变更生效：
| 场景 | 所需能力 |
|---|
| 基础私聊、回复、图片 | 消息接收/发送及图片上传权限 |
| 无需 @ 读取群消息 | 获取群组中所有消息，如 im:message.group_msg |
| 接收其他机器人群消息 | im:message.group_msg.include_bot:read |
| 手动补读历史、读取新版卡片正文 | 群消息和消息读取权限 |
权限名称可能随平台变化，以 飞书接收消息文档 和 历史消息文档 为准。仅有 @ 权限时，本地开关不能让平台推送未 @ 消息。
数据与隐私
插件默认在 DSH_HOME（未设置时为 ~/.dsh）下保存：
task-personas/sessions.json：人格选择。task-personas/social.json：聊天设置、已选机器人和时间状态。task-personas/stickers/：个人表情素材及元数据。- IM Connect 自己的会话映射、凭据与日志继续由桥接管理。
这些运行数据不属于源码，也不应提交到 GitHub。聊天内容会交给你在 DSH 中选择的模型服务处理；发送消息仍调用飞书接口。项目没有额外的聊天收集服务，公开发布包不包含开发者的聊天、账号、群 ID、凭据、截图或本机安装状态。管理接口沿用 DSH 登录认证与跨站校验。
开发与验证
Node.js 22 或更高版本：
npm ci
npm run check
npm run check:bridge
npm test
npm run test:privacy
测试使用合成数据和模拟飞书 SDK，不发送真实消息。宿主集成测试使用根目录锁定的 DSH SDK 开发依赖；可用 DSH_SDK_ROOT 指定另一套 SDK 根目录。当前覆盖 59 项行为测试，包含全量读取、106 条消息分批、忙时保留、@ 抢占、夜间规则、鉴权和原子写入失败。
主插件运行代码位于 lib/。桥接的 TypeScript 源码与预构建产物位于 im-connect/src/ 和 im-connect/lib/。仓库不包含本机验证日志、截图或私有测试配置。发布前运行 公开文件检查，并独立执行密钥扫描。
来源与许可
本项目未移植 QQ 拍一拍、QQ 收藏同步或群友黑话后台学习。它是独立社区扩展，不是 DSH、飞书或上游 IM Connect 的官方发行版。
