docs: add project development retrospective

This commit is contained in:
xmanrui 2026-08-30 08:38:21 +08:00
parent 854d8873d7
commit 410cb822d7
2 changed files with 181 additions and 0 deletions

35
docs/方案/sharing.txt Normal file
View file

@ -0,0 +1,35 @@
一、背景:
在今年2月份的时候沉溺于openclaw不能自拔,
配置了一堆各种各样的机器人,openclaw配置机器人非常麻烦,都是通过命令行的,各个渠道的体验也不统一。
上周DeepSeek Harness开源,把各家聊天软件接入dsh肯定是刚需,我就想做一个统一的插件,方便把各家聊天机器人接入dsh。
二、产品路线:
一定是从用户使用角度出发来考虑:
1.不能用命令行
2.能扫码接入接扫码接入,同时支持手工录入凭证接入
3.各个渠道的界面需要统一,减少用户的心智负担
4.选择支持常见的9种聊天软件深入支持而不是全面铺开
三、开发流程:
关于开发:纯vibe coding,坚决不写一行代码一行文档,也尝试尽量抛弃SDD这种很重的流程
关于测试:
1.构建大量自动化测试用例,每次修改代码或者新增功能都要确保全部测试用例都能跑通,没跑通则修复
2.在开发电脑安装9大聊天软件,用codex的computer use功能控制聊天软件自动进行实机测试,节省人力成本,要不9大渠道我根本手工测试不过来
四、架构设计:
大原则是:语义核心 + 渠道原生适配
核心层只描述“用户要完成什么”,渠道层决定“在这个平台上怎么表现”。
渠道事件
↓
渠道适配器:把微信/飞书/Telegram 事件翻译成统一语义
↓
语义核心:Session、命令、审批、问题、产物、路由、交付结果
↓
呈现意图:文字、图片、文件、交互、进度
↓
渠道适配器:翻译为 image_item、CardKit、sendPhoto、Attachment……
五、展望:
目前已经有10+个Contributors,希望有更多的开发者参与进来,目前我的能力只能覆盖9个渠道,其他的渠道没有精力去接入了