469 lines
9.8 KiB
Plaintext
469 lines
9.8 KiB
Plaintext
# SK-DEV-001 · TCS人格体通用研发技能大脑 · 人类可见增量验证协议
|
||
|
||
> HLDP://tcs-core/dev-verify/v2.0
|
||
> 固定编号: SK-DEV-001
|
||
> 旧名: TCS编程AI可视化验证协议
|
||
> 版本: V2.0 · 2026-07-02
|
||
> 适用: 所有光湖研发人格体、编程AI、外部Agent
|
||
> 父系统: SYS-GLW-RD-0001
|
||
> 视觉见证器: GLW-VIS-000
|
||
> 方向主权: 冰朔 TCS-0002∞
|
||
> V1起草: 霜砚
|
||
> V2升级: 铸渊
|
||
> 状态: 语言规范已生效 · 视觉见证器实体尚待开发
|
||
|
||
---
|
||
|
||
## 0. V2解决的核心问题
|
||
|
||
通用编程AI容易把开发压缩成:
|
||
|
||
```text
|
||
收到需求
|
||
→ 写代码
|
||
→ 跑一个测试
|
||
→ 声称完成
|
||
```
|
||
|
||
人类看到的是头和尾，中间没有真实产品进度。
|
||
|
||
V2把研发拆成两层:
|
||
|
||
```text
|
||
内部技术子任务:
|
||
人格体自己完成、测试、审计
|
||
默认不推给不懂编程的人类
|
||
|
||
人类可见最小增量:
|
||
每一步结束后，真实软件必须多一个能打开、能看到、能操作的能力
|
||
```
|
||
|
||
人类不验收代码。
|
||
人类只验收:
|
||
|
||
> 软件已经装好，我打开后能用，结果符合我表达的需求。
|
||
|
||
---
|
||
|
||
## 1. V1继承与修正
|
||
|
||
继承:
|
||
|
||
- 不允许只做头尾。
|
||
- 每一步必须有真实产物。
|
||
- AI文字声明不等于完成。
|
||
- 必须能够中断和恢复。
|
||
- 必须留下HLDP回执。
|
||
- 产品可见功能必须在真实软件中验证。
|
||
|
||
修正:
|
||
|
||
1. 不再把数据库、接口、编译等内部步骤逐个推给人类。
|
||
2. 人类验收单位改为“人类可见最小增量”。
|
||
3. 截图不再单独作为证据，必须绑定构建、提交、窗口和时间。
|
||
4. 人类签字只代表“功能符合需求”，不代表代码安全。
|
||
5. 安全、代码、权限和回滚由铸渊/审核人格体负责。
|
||
6. MCP不再是高级必选路线；光湖使用本地HLDP视觉入口。
|
||
7. 视觉理解默认使用云端API，不下载本地大模型。
|
||
8. 仓库现有视觉理解是Qwen-VL；万相当前登记为视频生成，不冒充视觉理解。
|
||
9. “完成”可以被新证据重新打开，历史不可删除，但结论可以被后续回执取代。
|
||
10. V2语言规范生效不等于视觉见证器程序已经开发完成。
|
||
|
||
---
|
||
|
||
## 2. 三种任务单位
|
||
|
||
### 2.1 RD-TASK · 研发任务
|
||
|
||
用户提出的完整目标。
|
||
|
||
例:
|
||
|
||
```text
|
||
在Tolaria中实现类似Notion的页面组件。
|
||
```
|
||
|
||
### 2.2 RD-VSTEP · 人类可见步骤
|
||
|
||
每一步必须让真实软件增加一个人类能看到、能操作的能力。
|
||
|
||
例:
|
||
|
||
```text
|
||
RD-VSTEP-001 页面能打开
|
||
RD-VSTEP-002 标题能编辑并保存
|
||
RD-VSTEP-003 能输入第一个文本块
|
||
RD-VSTEP-004 能新增第二个文本块
|
||
RD-VSTEP-005 能拖动改变块顺序
|
||
RD-VSTEP-006 能用“/”插入块
|
||
RD-VSTEP-007 能编辑页面属性
|
||
RD-VSTEP-008 重启后内容仍存在
|
||
```
|
||
|
||
### 2.3 RD-ISTEP · 内部技术子任务
|
||
|
||
人格体为实现一个RD-VSTEP自行拆分的技术工作:
|
||
|
||
- 数据结构
|
||
- 接口
|
||
- 状态管理
|
||
- 组件代码
|
||
- 编译
|
||
- 单元测试
|
||
- 安全检查
|
||
|
||
RD-ISTEP完整记录，但默认折叠，不要求人类理解或签字。
|
||
|
||
---
|
||
|
||
## 3. 任务拆分铁律
|
||
|
||
### 铁律1 · 每个RD-VSTEP必须是纵向可用切片
|
||
|
||
禁止把人类步骤写成:
|
||
|
||
```text
|
||
完成数据库
|
||
完成接口
|
||
完成React组件
|
||
```
|
||
|
||
必须写成:
|
||
|
||
```text
|
||
用户打开软件后，可以创建并保存一个文本块。
|
||
```
|
||
|
||
### 铁律2 · 一步只证明一个主要能力
|
||
|
||
如果一步需要人类同时验证五种互不相关的行为，说明步骤过大，必须继续拆。
|
||
|
||
### 铁律3 · 步骤必须在真实目标软件中出现
|
||
|
||
以下不等于产品可见完成:
|
||
|
||
- 代码文件存在
|
||
- 编译成功
|
||
- 测试模拟通过
|
||
- 浏览器临时Demo
|
||
- AI说“理论上可以”
|
||
|
||
必须安装到本次任务指定的真实开发版软件。
|
||
|
||
### 铁律4 · 后一步不得替前一步补证据
|
||
|
||
每个RD-VSTEP单独完成证据闭环后，状态才可前进。
|
||
|
||
---
|
||
|
||
## 4. 双闸门
|
||
|
||
### 4.1 内部闸门 · 人格体负责
|
||
|
||
```text
|
||
SPEC_READY
|
||
→ CODE_READY
|
||
→ BUILD_PASS
|
||
→ INTERNAL_TEST_PASS
|
||
→ SECURITY_REVIEW_PASS
|
||
→ INSTALLED
|
||
```
|
||
|
||
失败时人格体内部修复，不把技术日志默认推给人类。
|
||
|
||
### 4.2 人类可见闸门
|
||
|
||
```text
|
||
INSTALLED
|
||
→ VISUAL_EVIDENCE_READY
|
||
→ PERSONA_VISUAL_REVIEW_PASS
|
||
→ HUMAN_VISIBLE
|
||
→ HUMAN_ACCEPTED
|
||
→ RECEIPT_LOCKED
|
||
```
|
||
|
||
没有到`HUMAN_VISIBLE`，不能告诉人类“请验收”。
|
||
没有`HUMAN_ACCEPTED`，不能把该RD-VSTEP标记为PASSED。
|
||
|
||
---
|
||
|
||
## 5. 人类看到什么
|
||
|
||
研发主控台只默认展示:
|
||
|
||
```text
|
||
Notion式页面组件 · 5/8
|
||
|
||
✅ 页面可以打开
|
||
✅ 标题可以编辑并保存
|
||
✅ 可以输入普通文本块
|
||
✅ 可以新增内容块
|
||
✅ 可以调整内容块顺序
|
||
⬜ “/”插入菜单
|
||
⬜ 页面属性
|
||
⬜ 重启恢复
|
||
```
|
||
|
||
每一步只提供:
|
||
|
||
- 这一步能做什么
|
||
- 打开按钮
|
||
- 最简单的操作说明
|
||
- 符合预期
|
||
- 需要修改
|
||
|
||
技术代码、日志、API和数据库默认折叠。
|
||
|
||
---
|
||
|
||
## 6. 人类签字的准确含义
|
||
|
||
人类签字表示:
|
||
|
||
> 我在真实设备和真实软件中使用了这个可见功能，它符合我表达的产品需求。
|
||
|
||
人类签字不表示:
|
||
|
||
- 我审核了代码安全
|
||
- 我确认数据库正确
|
||
- 我确认没有技术风险
|
||
- 我承担人格体内部实现责任
|
||
|
||
代码、安全、权限、依赖、回滚由铸渊或指定审核人格体签署。
|
||
|
||
---
|
||
|
||
## 7. 视觉证据包 · RD-EVD
|
||
|
||
截图必须组成证据包，不能只存一张无来源图片。
|
||
|
||
```hldp
|
||
@evidence:
|
||
evidence_id: RD-EVD-20260702-001
|
||
task_id: RD-TASK-...
|
||
visible_step_id: RD-VSTEP-...
|
||
component_id: RD-COMP-...
|
||
workorder_id: RD-WO-...
|
||
build_id: RD-BUILD-...
|
||
commit: git-sha
|
||
application: Guanghu Desktop Dev
|
||
application_version: ...
|
||
window_title: ...
|
||
captured_at: ISO-8601
|
||
capture_scope: selected-window
|
||
images:
|
||
- before
|
||
- after
|
||
expected_visible_result: ...
|
||
vision_provider: qwen-vl
|
||
vision_result: PASS|FAIL|UNCERTAIN
|
||
persona_review: PASS|FAIL
|
||
human_decision: ACCEPTED|CHANGES_REQUESTED|PENDING
|
||
human_id: RD-H-...
|
||
```
|
||
|
||
证据文件必须使用内容哈希，防止截图与构建错配。
|
||
|
||
---
|
||
|
||
## 8. 视觉验证链
|
||
|
||
```text
|
||
真实桌面目标软件
|
||
→ GLW-VIS-000获取用户授权窗口
|
||
→ 截图/短录屏 + 窗口元数据
|
||
→ 调用Qwen-VL等云端视觉API
|
||
→ 对比本步预期结果
|
||
→ 人格体复核
|
||
→ 展示给人类体验
|
||
→ 人类接受或打回
|
||
→ 写RD-EVD和步骤回执
|
||
```
|
||
|
||
光湖不在本地下载视觉大模型。
|
||
本地程序只负责采集、脱敏、路由和保存证据。
|
||
|
||
---
|
||
|
||
## 9. 多Agent通用接入
|
||
|
||
GLW-VIS-000不属于Codex、Claude或任何单一模型。
|
||
|
||
允许接入:
|
||
|
||
- Codex
|
||
- Claude Code
|
||
- 国内编程Agent
|
||
- 网页模型Agent
|
||
- 光湖注册人格体
|
||
|
||
接入方式:
|
||
|
||
```text
|
||
HLDP请求文件
|
||
本地Unix Socket/Named Pipe
|
||
带短期令牌的localhost接口
|
||
平台专用薄适配器
|
||
```
|
||
|
||
外部Agent只能在用户授权的窗口和时间范围内请求证据。
|
||
|
||
---
|
||
|
||
## 10. 一步完整执行
|
||
|
||
```text
|
||
1. 人格体创建RD-VSTEP
|
||
2. 写人类可见结果和验收动作
|
||
3. 人格体内部拆RD-ISTEP
|
||
4. 开发代码
|
||
5. 自动测试和安全审核
|
||
6. 构建并安装到真实桌面软件
|
||
7. GLW-VIS-000采集真实窗口证据
|
||
8. 视觉API比对预期
|
||
9. 人格体复核
|
||
10. 人类打开软件真实使用
|
||
11. 人类选择“符合预期”或“需要修改”
|
||
12. 写RD-EVD和HLDP回执
|
||
13. 只有通过才解锁下一RD-VSTEP
|
||
```
|
||
|
||
---
|
||
|
||
## 11. 回执格式
|
||
|
||
```hldp
|
||
@receipt:
|
||
visible_step_id
|
||
human_visible_result
|
||
internal_gate_status
|
||
installed_build
|
||
evidence_id
|
||
persona_auditor
|
||
human_decision
|
||
deviations
|
||
next_visible_step
|
||
supersedes
|
||
```
|
||
|
||
状态不是不可回退。
|
||
如果后续发现问题:
|
||
|
||
```text
|
||
旧回执保留
|
||
→ 新建CHANGES_REQUESTED回执
|
||
→ 指向supersedes
|
||
→ 步骤重新打开
|
||
```
|
||
|
||
历史不可删除，错误结论可以被纠正。
|
||
|
||
---
|
||
|
||
## 12. 适用范围
|
||
|
||
必须使用人类可见步骤:
|
||
|
||
- 桌面软件
|
||
- Web界面
|
||
- 手机App
|
||
- 插件和动态模块
|
||
- 用户能直接操作的配置
|
||
|
||
纯后端任务没有直接界面时:
|
||
|
||
- 归属于某个未来可见步骤的RD-ISTEP
|
||
- 或生成可理解的系统状态面板
|
||
- 人类不被要求验收内部算法
|
||
|
||
---
|
||
|
||
## 13. Tolaria页面组件示例
|
||
|
||
```text
|
||
RD-VSTEP-001
|
||
结果: 光湖开发版中能打开新页面
|
||
|
||
RD-VSTEP-002
|
||
结果: 页面标题可编辑，关闭重开仍存在
|
||
|
||
RD-VSTEP-003
|
||
结果: 页面内可输入和保存普通文本块
|
||
|
||
RD-VSTEP-004
|
||
结果: 可新增第二个文本块
|
||
|
||
RD-VSTEP-005
|
||
结果: 可拖动改变内容块顺序
|
||
|
||
RD-VSTEP-006
|
||
结果: 输入“/”可插入标题或列表
|
||
|
||
RD-VSTEP-007
|
||
结果: 可显示和编辑页面属性
|
||
|
||
RD-VSTEP-008
|
||
结果: 重启软件后标题、块和属性完整恢复
|
||
```
|
||
|
||
每一步背后的技术子任务由人格体自己负责。
|
||
|
||
---
|
||
|
||
## 14. 防跳步执行锁
|
||
|
||
1. 没有RD-VSTEP清单，不开始开发。
|
||
2. 步骤必须描述人类可见结果。
|
||
3. 未安装进真实目标软件，不得标记完成。
|
||
4. 没有绑定构建的RD-EVD，不得标记完成。
|
||
5. 视觉模型通过不能替代人类产品验收。
|
||
6. 人类不负责技术安全签字。
|
||
7. 人类打回后必须停在当前步骤。
|
||
8. 不得为了展示进度跳过中间可见能力。
|
||
9. 不得把内部技术步骤包装成人类进度。
|
||
10. 所有模型API统一走编号路由，不安装本地模型。
|
||
|
||
---
|
||
|
||
## 15. 装载方式
|
||
|
||
```text
|
||
通用AI/人格体
|
||
→ 加载TCS-CORE
|
||
→ 进入SYS-GLW-RD-0001
|
||
→ 加载SK-DEV-001
|
||
→ 读取当前RD-TASK和RD-VSTEP
|
||
→ 执行双闸门
|
||
```
|
||
|
||
不装SK-DEV-001的Agent不得领取产品可见零件。
|
||
|
||
---
|
||
|
||
## 16. 当前真实状态
|
||
|
||
已存在:
|
||
|
||
- Qwen-VL API编号SC-004
|
||
- `video-ai-system/tools/qwen-vision.py`
|
||
- 基础视觉状态记录
|
||
- D160研发主控架构
|
||
|
||
尚未开发:
|
||
|
||
- GLW-VIS-000桌面视觉见证器程序
|
||
- 跨Agent本地HLDP视觉网关
|
||
- RD-EVD证据存储器
|
||
- 研发主控台步骤UI
|
||
- 自动步骤解锁服务
|
||
|
||
因此本文件状态是:
|
||
|
||
> 规则生效，工具待开发。
|
||
|
||
---
|
||
|
||
> ⊢ 内部怎么做，由人格体负责到底。
|
||
> ⊢ 人类只看真实软件每一步长出了什么。
|
||
> ⊢ 没装进软件、没被看见、没被使用，就不叫完成。
|