mirror of
https://github.com/hansjone/dsh-im-ops.git
synced 2026-10-08 23:13:17 +08:00
feat: add native result-file delivery
This commit is contained in:
parent
2803bbcbab
commit
d472dd5a75
65 changed files with 10205 additions and 255 deletions
73
CONTEXT.md
Normal file
73
CONTEXT.md
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
# 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_: 直接替换、重写完成
|
||||
Loading…
Add table
Add a link
Reference in a new issue