DeepSeek Harness IM

本上下文描述 dsh-im 如何把不同即时通信平台中的用户意图和 DeepSeek Harness 的工作过程连接起来。项目的核心价值不是渠道数量，而是让用户在所在渠道中自然、可靠地完成 Harness 任务。

Language

语义消息（Semantic Message）：不依赖具体 IM 平台、能够完整表达用户输入及其上下文的一条消息，包括内容、引用关系和会话位置。 Avoid: 统一文本、通用消息体

语义交互（Semantic Interaction）： Harness 等待用户完成的一次有状态操作，例如审批、单选、多选或补充输入。 Avoid: 按钮事件、命令回复

产物（Artifact）： Harness 任务读取或产生、需要在 Harness 与用户所在渠道之间安全传递的文件或媒体。 Avoid: 附件路径、下载地址

产物来源（Artifact Provenance）：证明一个现有或新建的出站产物由当前 Harness Session/Turn 通过受信工具结果显式登记的可验证记录；它证明交付意图和路由，不要求文件必须由当前 Turn 创建。 Avoid: 回答里的路径、最新文件

会话路由（Conversation Route）：唯一确定消息所属机器人、聊天及话题或线程的会话位置。 Avoid: Chat ID、会话 Key

投递目标（Delivery Target）：由 botId + targetId 稳定标识、并绑定到可更新会话路由的主动投递位置；它不依赖当前 Harness Session 或最近一条入站消息。 Avoid: Session ID、ChatRef、临时 Webhook

渠道能力（Channel Capability）：某个机器人实例在当前权限和运行条件下可以可靠提供的原生输入、交互或呈现能力。 Avoid: 平台支持、SDK 功能

原生呈现（Native Presentation）：渠道依据自身交互习惯呈现同一语义，例如卡片、按钮、消息编辑、流式回复或输入状态。 Avoid: 特殊适配、渠道特例

呈现意图（Presentation Intent）： Harness 输出在进入渠道前必须保留的内容结构和格式含义，例如纯文本、Markdown、进度、交互或产物；它不指定某个平台的控件或语法。 Avoid: 回答字符串、Telegram Rich Message、统一富文本

渠道原生动作（Native Channel Action）：渠道为承载一次语义任务而执行的平台专属操作，例如创建 Discord Thread、更新飞书卡片或上传附件；它属于渠道边界，不要求其他渠道提供同名操作。 Avoid: 公共命令、通用渠道方法

选择呈现（Selection Presentation）：单选或多选在渠道中的实际实现形态，只能表述为原生控件、组合交互或文字降级；判断能力时必须同时说明呈现形式和已经验证的范围。 Avoid: 支持多选、能力允许时、统一选择器

明确降级（Explicit Fallback）：渠道缺少所需能力时，保持业务语义并向用户说明限制的替代体验。 Avoid: 兼容模式、静默忽略

能力切片（Capability Slice）：围绕一个完整用户价值，从统一语义、安全策略到各渠道原生呈现和验收的端到端建设单元。 Avoid: 渠道任务、接口改造

标杆渠道（Reference Channel）：一项能力切片中最先完成真实客户端闭环、其原生机制最适合验证该语义和体验的渠道。标杆渠道按能力选择，不是永久主渠道。 Avoid: 主渠道、默认渠道

用户价值优先级（User Value Priority）：依据核心任务完成度、语义准确性、移动端操作成本以及安全与可靠性，决定能力切片的建设先后顺序。 Avoid: 功能数量排序、渠道用户量排序

渠道适配性（Channel Fit）：某项语义能力与渠道原生机制、权限覆盖、接口稳定性和可测试性之间的匹配程度，用于选择标杆渠道并决定原生实现或明确降级。 Avoid: 渠道排名、平台先进程度

渠道行为基线（Channel Behavior Baseline）：语义迁移开始前，某个渠道已经向用户提供的任务流程、控制能力、状态语义和原生体验的可验证集合；后续实现可以改善它，但不能使其中任何能力消失或退化。 Avoid: 当前代码、旧实现、测试现状

等价接管（Parity Cutover）：新语义路径在覆盖渠道行为基线、通过回归并具备回滚能力后，才取得某项消息或能力的唯一处理权。 Avoid: 直接替换、重写完成