dsh-im-ops/CONTEXT.md

# 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

**渠道能力（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_: 直接替换、重写完成