dsh-im-ops/FORK.md

dsh-im-ops（运维 fork）

本仓库是 @xmanrui/dsh-im@4.9.1 的 完整 fork（九渠道 + AI Office 均保留），用于 Netx / 运维场景下自控：

• 访问控制（入站白名单 / 群策略）
• 会话策略（群聊按发言人拆分 Session，可配置）
• 通告 / 投递默认与文案

上游 remote 名为 upstream。不要与社区包 @xmanrui/dsh-im 同时装进同一 profile。

与已删除的薄壳 ops-im 的关系

曾尝试只做 ops_im__send 适配层；因 入站权限/会话仍在 dsh-im，无法满足所有权诉求，已删除该薄仓库，改为本 fork。

安装（替换社区 im）

其他电脑 / 只跑插件（推荐）

仓库已提交 lib/ 产物时：不必在插件目录执行 pnpm install / npm install。

# 拉代码（含 lib/）后，只让 DSH profile 安装本包的生产依赖（qqbot/wecom/…）
dsh plugin --profile web add -w "D:\path\to\dsh-im-ops"
# 或：
dsh plugin --profile web add -w "github:hansjone/dsh-im-ops"
# 重启 dsh web

说明：这里的 -w 是 pnpm 的 workspace-root（装到 profile 根），不是「先手动 install 插件仓库」。Host 侧 @deepseek-ai/* 由 DSH 提供，插件 不得 再声明/安装它们（公共 registry 会 404，例如 dsh-type-meta）。

本机改源码再发版

cd D:\path\to\dsh-im-ops
pnpm install          # 只装公开包：baileys/esbuild/…；不要指望能装 @deepseek-ai/*
pnpm run build        # 写出 lib/
# 再 push；或本机：
dsh plugin --profile web add -w "D:\path\to\dsh-im-ops"

若已安装社区包 @xmanrui/dsh-im，先从 profile 移除再 add 本 fork。

扫码态一般仍在 ~/.dsh/integrations/…；换包后若异常，在 IM 设置里重新关联设备。

包名：dsh-im-ops（cordis id：dsh-im-ops）。

已落地的运维改动

1. 群 Session 策略（对齐 oclaw user_in_chat）

   • 默认：user_in_chat → 群会话 key 为 group:<chatId>:user:<senderId>
   • 可选：chat → 整群共享 group:<chatId>（上游行为）
   • 在「访问设置」页可改；RPC：bot.group-session-scope.set
   • 当前对 WhatsApp / Telegram / Slack / Discord（TextHarness 路径）生效；其它渠道的同策略接线后续补齐

2. 访问控制仍由本 fork 持久化（workspaces.json 的 accessPolicies），设置 UI 与上游同构，运维可直接改白名单 / open 模式

3. WhatsApp LID：群参与者常为不透明 @lid，白名单只填手机号时会被静默拒绝。4.9.1-ops.3 用 Baileys LID→PN 映射扩展 sender 别名，并在 @ 提及匹配时同样解析；若仍被拒绝会回一句白名单提示

4. 主动群通告继续用既有 delivery（botId + targetId），与入站 Session 策略独立

同步上游

git fetch upstream --tags
git merge v4.9.x   # 或 cherry-pick；冲突自行解决后再 build

改源码后务必 npm run build 并推送含 lib/ 的提交，否则 GitHub 安装会加载过期 bundle。