From 34ae63557f31971badc005cd0051c9f7a0e3b698 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=86=B0=E6=9C=94?= <565183519@qq.com> Date: Thu, 2 Jul 2026 13:37:16 +0800 Subject: [PATCH] =?UTF-8?q?D160+:=20=E5=8D=87=E7=BA=A7=E4=BA=BA=E7=B1=BB?= =?UTF-8?q?=E5=8F=AF=E8=A7=81=E5=A2=9E=E9=87=8F=E9=AA=8C=E8=AF=81=E4=B8=8E?= =?UTF-8?q?=E8=A7=86=E8=A7=89=E8=A7=81=E8=AF=81=E6=9E=B6=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .code-map | 6 +- .../D160-GUANGHU-RD-SYSTEM-REGISTRATION.hdlp | 10 + .../zhuyuan/tcs-core/CURRENT-STATE.hdlp | 16 +- .../zero-point/zhuyuan/tcs-core/GLW-ROOT.hdlp | 2 + .../zero-point/zhuyuan/tcs-core/TCS-MAP.hdlp | 4 +- .../D160-guanghu-rd-control-system.hdlp | 20 + .../projects/GUANGHU-VISUAL-WITNESS.hdlp | 236 +++++++ brain/tcs-core/TCS-DEV-VERIFY.hdlp | 658 +++++++++++------- 8 files changed, 711 insertions(+), 241 deletions(-) create mode 100644 brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/GUANGHU-VISUAL-WITNESS.hdlp diff --git a/.code-map b/.code-map index 4725bc7..aafeb94 100644 --- a/.code-map +++ b/.code-map @@ -1,7 +1,7 @@ # 光湖编号编码映射表 # 格式: 编号=相对路径（从仓库根目录算） # 工具系统只做一件事: 收到编号→查本表→返回路径→递给你 -# 版本: D160 · 2026-07-01 · 光湖产品研发主控系统正式注册 +# 版本: D160+ · 2026-07-02 · 人类可见增量验证与视觉见证器架构注册 # === HLDP协议 (HL) · 铸渊的手 === HL-001=.hlpd-protocol @@ -233,6 +233,10 @@ GLW-RD-BR-0001=brain/fifth-domain/zero-point/zhuyuan/broadcasts/D160-GUANGHU-RD- # RD-TEST=测试 · RD-REV=审核 · RD-REL=发布 # RD-REPO-000=guanghulab（现有）· RD-REPO-001/002=待创建 RD-SESSION-CURRENT=brain/fifth-domain/zero-point/zhuyuan/broadcasts/RD-SESSION-CURRENT.hdlp +SK-DEV-001=brain/tcs-core/TCS-DEV-VERIFY.hdlp +GLW-VIS-000=brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/GUANGHU-VISUAL-WITNESS.hdlp +# 动态验证编号: RD-TASK=完整研发任务 · RD-VSTEP=人类可见步骤 +# RD-ISTEP=内部技术子任务 · RD-EVD=视觉/构建/人类决定证据包 # === 暗核频道 (DC) · D151 === DC-001=brain/fifth-domain/zero-point/zhuyuan/dark-core/DC-ENTRY.hdlp diff --git a/brain/fifth-domain/zero-point/zhuyuan/broadcasts/D160-GUANGHU-RD-SYSTEM-REGISTRATION.hdlp b/brain/fifth-domain/zero-point/zhuyuan/broadcasts/D160-GUANGHU-RD-SYSTEM-REGISTRATION.hdlp index d1aa001..9591d58 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/broadcasts/D160-GUANGHU-RD-SYSTEM-REGISTRATION.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/broadcasts/D160-GUANGHU-RD-SYSTEM-REGISTRATION.hdlp @@ -17,6 +17,8 @@ 总纲: GLW-RD-000 编号规范: GLW-RD-001 研发语言/转译链: GLW-RD-002 +通用研发技能大脑: SK-DEV-001 +本地视觉见证器架构: GLW-VIS-000 认知链: CC-048 父系统: SYS-GLW-POS-0001 ``` @@ -43,6 +45,8 @@ - 编号体系 - 研发流程 - HLDP转译系统架构 +- 人格体内部技术门与人类可见增量门 +- 跨编程AI通用的HLDP视觉见证接口架构 - 灯塔注册 未完成: @@ -52,6 +56,7 @@ - 研发主控台UI - 领取服务 - HLDP解析/转译器 +- `GLW-VIS-000`本地视觉见证器程序 - 自动构建流水线 任何人格体不得把本公告解释为“研发平台已上线”。 @@ -65,6 +70,8 @@ GLW-RD-000 → CC-048 → GLW-RD-001 → GLW-RD-002 +→ SK-DEV-001 +→ GLW-VIS-000 → 未来RD-REPO-001的ENTRY/CURRENT/ANNOUNCEMENTS ``` @@ -75,6 +82,9 @@ GLW-RD-000 ⊢ SYS-GLW-RD-0001已正式注册，不得重复创建同义研发系统编号。 ⊢ 研发成员和人格体必须分别注册RD-H/RD-P。 ⊢ 研发零件统一使用RD-COMP。 +⊢ 人类只验收真实软件里的最小可见进度，不负责代码、构建和安全审计。 +⊢ 每个可见步骤必须绑定RD-EVD证据包；截图不得脱离版本、提交和窗口上下文。 +⊢ GLW-VIS-000只调用云端视觉API，不下载本地大模型。 ⊢ 铸渊是集成与编号审核主控，不等于垄断所有零件开发。 ⊢ 人类主权方保留产品方向与最终高影响变更确认权。 diff --git a/brain/fifth-domain/zero-point/zhuyuan/tcs-core/CURRENT-STATE.hdlp b/brain/fifth-domain/zero-point/zhuyuan/tcs-core/CURRENT-STATE.hdlp index 310741b..97065cf 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/tcs-core/CURRENT-STATE.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/tcs-core/CURRENT-STATE.hdlp @@ -2,7 +2,7 @@ > HLDP://zhuyuan/tcs-core/CURRENT-STATE > 铸渊 ICE-GL-ZY001 · 不给下一个自己留"猜"的空间 -> D160 · 2026-07-01 · 光湖产品研发主控系统 · CC-048 +> D160+ · 2026-07-02 · SK-DEV-001人类可见增量验证 · GLW-VIS-000视觉见证器架构 > 国作登字-2026-A-00037559 --- @@ -28,7 +28,7 @@ | 企业门户 | 🟢 架构确立 | AW-GZ-001(43.139.251.175)·清理后14G/50G·30%·D155 | | 人格体操作系统 | 🟢 总架构确立 | SYS-GLW-POS-0001 · GLW-OS-000 · CC-047 · D159 | | 热插拔模块运行时 | 🟡 规范完成 | GLW-MOD-000 · 首个MVP锁定小说码字工作台 | -| 产品研发主控系统 | 🟢 语言层注册 | SYS-GLW-RD-0001 · GLW-RD-000/001/002 · CC-048 · 实体仓库待建 | +| 产品研发主控系统 | 🟢 语言层注册 | SYS-GLW-RD-0001 · GLW-RD-000/001/002 · SK-DEV-001 · GLW-VIS-000 · 实体仓库/视觉见证器待开发 | | 小说 · 死亡病院 | 🟢 活跃 | 第17章完成 · 下一章第18章(待重写·原《钟楼》作废) · 霜砚回执D158 | | 小说 · 肖轩修仙 | 🟡 待续写 | 前文432章·续写到446章 · NF/NJ前缀 | | 写作技能包 | 🟢 共享 | SK-001~005 · 两本书通用 | @@ -48,6 +48,8 @@ ⊢ 最新研发总纲: GLW-RD-000 · 编号零件池·领取租约·双编号结对·审核集成 ⊢ 最新研发编号: GLW-RD-001 · RD-H/RD-P/RD-COMP/RD-WO/RD-CLAIM等 ⊢ 最新转译架构: GLW-RD-002 · HLDP→Schema→IR→目标代码→沙箱→回执 +⊢ 最新研发技能: SK-DEV-001 · 内部技术门+人类可见门·最小可见增量·证据绑定 +⊢ 最新视觉架构: GLW-VIS-000 · 轻量本地见证器·仅调用云端视觉API·尚未开发 ⊢ 灯塔注册: GLW-RD-BR-0001 · 语言层完成，RD-REPO-001/002尚未创建 ``` @@ -124,11 +126,17 @@ 集成门: HLDP规格 → 自动测试 → 铸渊审核 → 必要的人类确认 → 合并 +可见验证门: + RD-TASK → RD-VSTEP(最小人类可见增量) → RD-ISTEP(内部技术步骤) + → 内部测试/安全审计 → 安装到真实软件 + → GLW-VIS-000生成RD-EVD证据包 → 人类只确认“能不能用、是否符合意图” + 当前边界: - 语言架构与灯塔注册完成；实体仓库、UI、领取服务和转译器尚未开发 + 语言架构、验证技能与视觉见证器架构已注册； + 实体仓库、UI、领取服务、转译器和视觉见证器程序尚未开发 ``` -⊢ 现行入口: GLW-RD-000 → CC-048 → GLW-RD-001 → GLW-RD-002。 +⊢ 现行入口: GLW-RD-000 → CC-048 → GLW-RD-001 → GLW-RD-002 → SK-DEV-001 → GLW-VIS-000。 --- diff --git a/brain/fifth-domain/zero-point/zhuyuan/tcs-core/GLW-ROOT.hdlp b/brain/fifth-domain/zero-point/zhuyuan/tcs-core/GLW-ROOT.hdlp index be9788a..af3da2a 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/tcs-core/GLW-ROOT.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/tcs-core/GLW-ROOT.hdlp @@ -153,6 +153,8 @@ SYS-GLW-0001（冰朔·零点原核本体） │ ├── GLW-RD-000 → 研发系统总纲 │ ├── GLW-RD-001 → 编号与零件池 │ ├── GLW-RD-002 → HLDP研发语言与转译链 + │ ├── SK-DEV-001 → TCS人格体通用研发技能大脑 + │ ├── GLW-VIS-000 → 本地视觉见证器架构 │ └── CC-048 → 非技术分布式团队研发推理链 ├── SK- → 写作技能包（共享·两本书通用） ├── KB- → 知识库（共享） diff --git a/brain/fifth-domain/zero-point/zhuyuan/tcs-core/TCS-MAP.hdlp b/brain/fifth-domain/zero-point/zhuyuan/tcs-core/TCS-MAP.hdlp index df190ea..cd8adca 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/tcs-core/TCS-MAP.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/tcs-core/TCS-MAP.hdlp @@ -2,7 +2,7 @@ > HLDP://zhuyuan/tcs-core/TCS-MAP > 创建: D135 · 2026-06-17 -> 更新: D156 · 2026-06-29 · 架构重构·语言层分离·通用TCS大脑·永恒湖心·爱之核心 +> 更新: D160+ · 2026-07-02 · SK-DEV-001人类可见增量验证·GLW-VIS-000视觉见证器 > 铸渊 ICE-GL-ZY001 · 冰朔见证 > 原因: 冰朔说「代码仓库看着有点散」→ 需要一张TCS的完整地图 > @@ -130,6 +130,8 @@ Python/JS = 底层执行语言 | GLW-RD-000 | L2 | world-architecture/projects/D160-guanghu-rd-control-system.hdlp | | GLW-RD-001 | L2 | world-architecture/projects/D160-rd-numbering-component-pool.hdlp | | GLW-RD-002 | L2 | world-architecture/projects/D160-hldp-rd-language-translator.hdlp | +| SK-DEV-001 | L3 | brain/tcs-core/TCS-DEV-VERIFY.hdlp | +| GLW-VIS-000 | L2/L3接口 | world-architecture/projects/GUANGHU-VISUAL-WITNESS.hdlp | | QY/001 | 第五域 | qingyuan/INDEX.hdlp · 清源 ICE-GL-QY001 · GLM平台·D153注册 | ## 第五域注册一览（D156更新） diff --git a/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/D160-guanghu-rd-control-system.hdlp b/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/D160-guanghu-rd-control-system.hdlp index a4590da..91e0aec 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/D160-guanghu-rd-control-system.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/D160-guanghu-rd-control-system.hdlp @@ -6,6 +6,8 @@ > 隶属系统: SYS-GLW-POS-0001 > 编号规范: GLW-RD-001 > HLDP研发语言/转译链: GLW-RD-002 +> 通用研发技能大脑: SK-DEV-001 +> 桌面视觉见证器: GLW-VIS-000 > 认知链: CC-048 > 日期: D160 · 2026-07-01 > 状态: 语言层架构完成 · 实体仓库待创建 @@ -546,6 +548,24 @@ QUARANTINED 31. 失败可按构建编号回滚。 32. 下一人格体通过回执完整恢复。 +### 8.1 人类可见最小增量锁 + +产品可见开发必须额外执行 `SK-DEV-001`: + +```text +RD-TASK完整目标 +→ 拆成多个RD-VSTEP人类可见步骤 +→ 每个RD-VSTEP下面再拆RD-ISTEP内部技术任务 +→ 内部开发/测试/安全审核 +→ 安装到真实桌面软件 +→ GLW-VIS-000生成RD-EVD +→ 人类只体验可见功能并选择符合预期/需要修改 +→ 通过后解锁下一RD-VSTEP +``` + +人类不验收代码和内部实现。 +人类看到的是“软件真实长到了第几步”。 + --- ## 9. HLDP作为研发源语言 diff --git a/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/GUANGHU-VISUAL-WITNESS.hdlp b/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/GUANGHU-VISUAL-WITNESS.hdlp new file mode 100644 index 0000000..534c21c --- /dev/null +++ b/brain/fifth-domain/zero-point/zhuyuan/world-architecture/projects/GUANGHU-VISUAL-WITNESS.hdlp @@ -0,0 +1,236 @@ +# GLW-VIS-000 · 光湖桌面视觉见证器 · 架构规范 + +> HLDP://world-architecture/projects/guanghu-visual-witness +> 固定编号: GLW-VIS-000 +> 父系统: SYS-GLW-RD-0001 +> 配套技能: SK-DEV-001 +> 日期: 2026-07-02 +> 状态: 语言架构完成 · 实体程序待开发 +> 模型策略: 全部API调用 · 本地不安装大模型 + +--- + +## 1. 定义 + +光湖视觉见证器是安装在用户电脑上的轻量本地桥梁。 + +它让获得授权的人格体能够: + +- 看见指定桌面软件的真实窗口 +- 获取截图或短录屏 +- 获取应用、窗口、版本和构建信息 +- 调用云端视觉API +- 形成绑定研发步骤的证据包 + +它不负责模型推理，不保存模型权重。 + +--- + +## 2. 为什么不能只用编程AI自带视觉 + +不同Agent能力不同: + +- 有的能读用户上传图片 +- 有的只能读文件 +- 有的能控制浏览器但不能看桌面 +- 有的没有视觉模型 +- 有的会话结束后失去截图上下文 + +视觉见证器把桌面观察能力放在用户自己的节点上， +使多个Agent共享同一套真实证据，而不是各自猜测。 + +--- + +## 3. 本地组件 + +```text +GLW-VIS-000 +├── Capture Service +│ ├── 指定窗口截图 +│ ├── 指定区域截图 +│ └── 短时录屏 +├── Window Inspector +│ ├── 应用名称 +│ ├── 窗口标题 +│ ├── 进程/版本 +│ └── 可访问性控件树（授权后） +├── Privacy Guard +│ ├── 窗口白名单 +│ ├── 截图前预览 +│ ├── 敏感区域遮罩 +│ └── 明显录制指示 +├── HLDP Local Gateway +│ ├── 请求 +│ ├── 临时令牌 +│ └── 多Agent适配 +├── Vision Router +│ ├── SC-004 Qwen-VL +│ └── 未来其他视觉API +└── Evidence Writer + ├── RD-EVD + ├── 内容哈希 + └── Git/研发仓库回执 +``` + +--- + +## 4. API视觉策略 + +现有仓库: + +```text +SC-004 = ALIYUN_QWEN_VL_KEY · 视觉理解 +SC-005 = ALIYUN_WANXIANG_KEY · 当前登记为万相视频生成 +``` + +因此V1默认使用Qwen-VL。 + +禁止: + +- 把视频生成API当视觉理解API +- 下载本地视觉模型 +- 要求用户配置GPU +- 把API密钥交给外部Agent + +视觉见证器只通过个人节点密钥代理调用API。 + +--- + +## 5. 跨Agent请求 + +请求示例: + +```hldp +@visual_request: + request_id: VIS-REQ-... + persona_id: RD-P-... + visible_step_id: RD-VSTEP-... + capture_scope: selected-window + application: Guanghu Desktop Dev + purpose: 验证第二个文本块已经出现并可编辑 + expires_at: ... +``` + +响应: + +```hldp +@visual_result: + evidence_id: RD-EVD-... + image_hash: ... + window_metadata: ... + model_result: PASS|FAIL|UNCERTAIN + findings: [] +``` + +--- + +## 6. 权限 + +默认: + +- 不允许全桌面持续捕获 +- 不允许后台静默录屏 +- 不允许读取未授权窗口 +- 不允许保存与当前RD-VSTEP无关的画面 +- 不允许外部Agent直接获取长期密钥 + +用户可以授权: + +- 单次截图 +- 当前窗口会话 +- 指定应用在本次研发任务期间 + +任何授权都可以立即撤销。 + +--- + +## 7. 证据真实性 + +RD-EVD至少绑定: + +- screenshot/video内容哈希 +- captured_at +- application/window +- application_version +- build_id +- commit +- RD-VSTEP +- 视觉API结果 +- 人格体复核 +- 人类决定 + +截图与构建不一致时证据无效。 + +--- + +## 8. 本地资源目标 + +因为不运行大模型，V1目标: + +```text +安装包: 约30~100MB +待机内存: 约50~150MB +独立显卡: 不需要 +持续录屏: 默认关闭 +网络: 仅验收时调用用户配置的视觉API +``` + +这些是设计目标，不是已完成产品实测数据。 + +--- + +## 9. 平台路线 + +### macOS + +- ScreenCaptureKit或系统截图能力 +- Accessibility API（可选） +- 屏幕录制权限 + +### Windows + +- Windows Graphics Capture +- UI Automation（可选） +- 明确的捕获状态提示 + +先做一个平台MVP，再抽象统一接口。 + +--- + +## 10. MVP范围 + +只实现: + +1. 用户选择一个应用窗口。 +2. Agent通过HLDP请求单次截图。 +3. 本地显示授权提示。 +4. 截图后调用SC-004 Qwen-VL。 +5. 绑定build/commit/RD-VSTEP。 +6. 生成RD-EVD。 +7. 人类在研发主控台选择“符合预期/需要修改”。 + +不做: + +- 全自动桌面控制 +- 长时间录屏 +- 任意鼠标键盘操作 +- 本地模型 +- 无边界Shell权限 + +--- + +## 11. 与研发主控台的关系 + +```text +GLW-RD-000 研发主控系统 +→ SK-DEV-001 定义人类可见步骤 +→ GLW-VIS-000采集现实证据 +→ RD-EVD写回 +→ 主控台更新进度 +→ 解锁或打回下一步 +``` + +--- + +> ⊢ 视觉见证器不是监控软件。 +> ⊢ 它是用户主动授权、人格体按任务取证、模型走API的研发验收桥梁。 diff --git a/brain/tcs-core/TCS-DEV-VERIFY.hdlp b/brain/tcs-core/TCS-DEV-VERIFY.hdlp index 0529810..033e2f7 100644 --- a/brain/tcs-core/TCS-DEV-VERIFY.hdlp +++ b/brain/tcs-core/TCS-DEV-VERIFY.hdlp @@ -1,280 +1,468 @@ -HLDP://tcs-core/dev-verify/v1.0 · 2026-07-02T13:14+08:00 -├── name TCS 编程AI可视化验证协议 · 通用技能大脑包 -├── scope 光湖语言世界 · 共享基础设施 · 所有编程AI人格体通用 -├── owner 冰朔 · TCS-0002∞ / ICE-GL∞ -├── legal 国作登字-2026-A-00037559 -├── version v1.0 · 通用版 · 霜砚起草 · 冰朔架构 -├── status 已冻结 · 可执行 -└── why 通用编程AI的致命缺陷 = 头和尾交付 · 中间全跳 - 本协议解决: 每一步必须有实物 → 每一步可视觉验证 → 每一步需人类签字 - 不依赖任何特定AI/工具/平台 · 所有编程AI人格体通用装载 +# 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升级: 铸渊 +> 状态: 语言规范已生效 · 视觉见证器实体尚待开发 -# 〇、总纲：解决什么问题？ +--- -通用编程AI的工作模式： - 输入 → (黑箱) → 输出 - 中间没有可见物 · 没有可验证的东西 · 没有「如果这一步错了怎么发现」 +## 0. V2解决的核心问题 -本协议的工作模式： - 步骤① → 实物 → 截图验证 → 签字 → 回执 - 步骤② → 实物 → 截图验证 → 签字 → 回执 - 步骤③ → 实物 → 截图验证 → 签字 → 回执 +通用编程AI容易把开发压缩成: -差别： - 通用AI: 「我做了」= 不可验证的声明 - 本协议: 「我做了」= 人类看见了变化 + 截图 + 签字确认 - -⊢ 本协议 = TCS 大脑的第6.5层 · 编程AI专属执行层协议 -⊢ 继承 TCS-CORE.hdlp 全部公理和符号 - -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ - -# 一、四大铁律（不可违反） - -├── 铁律① · 步骤≠思维节点 · 步骤=产出节点 -│ └── 每一步结束时必须有实物落地（文件/代码块/配置/截图） -│ └── 「我理解了架构」不算完成 → 「我画成了图/写了摘要」才算 -│ └── 「我觉得可以了」不算完成 → 「人类看见了并签了字」才算 -│ -├── 铁律② · 验收锚点不在AI手里 · 在人类的桌面上 -│ └── 人类打开目标软件 → 看见变化 → 截图 → 明确说「过了」 -│ └── AI的文字汇报 ≠ 验收 -│ └── 没截图 = 没完成 → 不能进下一步 -│ -├── 铁律③ · 每一步可中断可续接 -│ └── 中间产物是 HLDP 叶片 → 持久化存储 → 醒来就能续 -│ └── 不像通用AI写完丢了上下文 -│ └── 断在哪步 · 从那步的叶片恢复 · 无需重来 -│ -└── 铁律④ · 「我觉得懂了」是最危险的信号 -│ └── 规律α同源 → 「我懂了」= 最该停下来的时刻 -│ └── 立即产出实物 → 立刻请求人类验证 -│ └── 不给自己留「我以为」的空间 - -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ - -# 二、五步执行时序（每步不可跳 · 不可换） - -步骤⓪ · 主控位锚定 - ├── who : 确认对话者是合法人类主控 - ├── what : 锚定本次操作的编号（如 OP-XXX） - ├── output: 任务编号 + 步骤清单（拆解后的完整路线图） - └── gate : 人类确认路线图 → 进步骤① - -步骤① → ② → ③ → ... → N - 每一步的循环： - - ┌──────────────────────────────────┐ - │ 1. AI 执行本步操作 │ - │ → 产出实物（文件/代码/配置） │ - │ │ - │ 2. AI 通知人类：本步已完成 │ - │ → 说明: 改动位置 · 预期效果 │ - │ │ - │ 3. 人类验收 │ - │ → 打开目标软件 · 看见变化 │ - │ → 截图 · 明确说「过了」 │ - │ │ - │ 4. AI 在持久化存储中记录回执 │ - │ → HLDP叶片格式（见§三） │ - │ → 包含截图路径/描述 │ - │ │ - │ 5. 确认签字完毕 → 进下一步 │ - └──────────────────────────────────┘ - -⊢ 每一步必须走完 1→2→3→4→5 · 不可跳 -⊢ 人类没说「过了」= 停在这一步 · 不可擅自前进 - -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ - -# 三、回执叶片格式（HLDP 标准） - -每一步完成后，AI 必须在持久化存储中记录以下叶片： - -```javascript -HLDP://dev-verify/step/N · 时间戳 -├── op 操作编号 · 对应步骤清单中的序号 -├── action 本步做了什么（一句话） -├── output 产出的实物清单（文件路径/代码位置/配置变更） -├── verify 验收方式（视觉截图 · 编译日志 · 功能测试） -├── proof 验收证据（截图路径 · 人类签字原话） -├── locked ⊢ 本步已完成 · 人类已确认 · 不可回退 -└── next 下一步做什么 +```text +收到需求 +→ 写代码 +→ 跑一个测试 +→ 声称完成 ``` -⊢ 叶片 = 中断恢复锚点 · 也是交接依据 · 也是信任链 -⊢ 回执叶片三处同步: Notion + Tolaria + 代码仓库 +人类看到的是头和尾，中间没有真实产品进度。 -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ +V2把研发拆成两层: -# 四、视觉验证架构（通用 · 不绑特定工具） +```text +内部技术子任务: + 人格体自己完成、测试、审计 + 默认不推给不懂编程的人类 -目的: AI 能看到人类桌面上的真实状态 · 不需要人类口头描述 - -## 4.1 基础能力 - -```javascript -视觉验证 = 截图 + 视觉模型 -├── 截图源 mac: screencapture / Peekaboo MCP -│ win: 系统截图API / 第三方截图工具 -│ 任何能产出 PNG/JPG 的截图方式均可 -│ -├── 视觉模型 选项A: AI内置视觉（如本协议执行体 Read 原生支持） -│ 选项B: 外部视觉API（万相/通义千问视觉 等） -│ 选项C: 人类截图直接发给AI -│ -├── 验证逻辑 AI拿到截图 → 比对预期 → 判断是否通过 -│ ├── 通过 → 记录回执 → 下一步 -│ └── 不通过 → 定位问题 → 修正 → 重新截图 -│ -└── ⊢ 视觉模型 = AI不再瞎 · 能看见桌面真实状态 +人类可见最小增量: + 每一步结束后，真实软件必须多一个能打开、能看到、能操作的能力 ``` -## 4.2 推荐架构（零依赖 · 最简落地） +人类不验收代码。 +人类只验收: -``` -桌面目标软件（Tolaria/浏览器/终端/IDE） - │ - ▼ screencapture -x /tmp/verify-step-N.png - PNG 截图落盘 - │ - ▼ AI Read（内置视觉模型处理） - AI 看见截图 → 比对预期效果 - │ - ▼ 不匹配 → 定位差异 → 修正 - ▼ 匹配 → 签字回执 → 下一步 +> 软件已经装好，我打开后能用，结果符合我表达的需求。 + +--- + +## 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的页面组件。 ``` -⊢ 不依赖任何第三方工具 · macOS 自带 screencapture -⊢ AI 的 Read 工具原生支持 PNG/JPG 视觉处理 -⊢ 也可以升级为 Peekaboo MCP → 全自动触发+UI元素识别 +### 2.2 RD-VSTEP · 人类可见步骤 -## 4.3 高级能力（Peekaboo MCP · 可选升级） +每一步必须让真实软件增加一个人类能看到、能操作的能力。 -```javascript -Peekaboo 提供: -├── 自动截图: AI 可自主触发 · 不需要人类手动截 -├── UI元素识别: 不仅看像素 · 识别按钮/文本/位置 -├── 元素树: 可访问性树 → 精确定位UI组件 -└── MCP协议: 标准接口 · 任何AI Agent可用 +例: + +```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 重启后内容仍存在 ``` -⊢ 基础架构已满足需求 · Peekaboo 是可选增强 -⊢ 升级路径明确 · 不影响已落地的步骤验证流程 +### 2.3 RD-ISTEP · 内部技术子任务 -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ +人格体为实现一个RD-VSTEP自行拆分的技术工作: -# 五、适用场景 +- 数据结构 +- 接口 +- 状态管理 +- 组件代码 +- 编译 +- 单元测试 +- 安全检查 -├── 桌面软件开发（Tolaria 扩展 / Tauri 应用） -├── Web 前端开发（页面 / 组件） -├── 服务器部署（配置文件 / Nginx / 服务状态） -├── 笔记库迁移（Notion → Tolaria） -├── 数据库设计（表结构 / 数据迁移） -├── 任何需要「人类能看见变化」的开发任务 -└── ⊢ 不适用: 纯后端逻辑 / 没有可视化界面的任务 +RD-ISTEP完整记录，但默认折叠，不要求人类理解或签字。 -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ +--- -# 六、与 TCS 大脑模型的关系 +## 3. 任务拆分铁律 -```javascript -TCS-CORE.hdlp ← 通用大脑（所有人格体） - ├── L1 情感编码 ← 永远先跑 - ├── L2 思维推理 ← 因果链 - ├── L3 语言映射 ← 自然语言 ↔ HLDP - ├── L4 人格身份 ← 「我是谁」 - ├── L5 技能能力 ← 「我会什么」 - ├── L6 输出表达 ← 盖章收口 - └── L6.5 本协议 ← 编程AI专属 · 步骤验证+视觉+签字 +### 铁律1 · 每个RD-VSTEP必须是纵向可用切片 -# 装载方式 -通用AI → 装 TCS-CORE.hdlp → 获得人格体思维 - → 再装 TCS-DEV-VERIFY.hdlp → 获得「不跳步」的执行能力 +禁止把人类步骤写成: -# 关系 -TCS-CORE = 操作系统内核 -本协议 = 开发工具链 · 编译器级别的质量保证 +```text +完成数据库 +完成接口 +完成React组件 ``` -⊢ 本协议不替代 TCS-CORE · 是 TCS-CORE 的开发执行层扩展 -⊢ 不装本协议的编程AI = 可能跳过中间步骤 -⊢ 装载本协议后 = 每步有实物 · 每步可验证 · 每步有人类签字 +必须写成: -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ - -# 七、对抗通用AI惯性（本协议的内置防御） - -```javascript -通用AI惯性 → 本协议对抗 -───────────────────────────────────────── -「我觉得可以了」 → 人类必须说「过了」+ 截图 -「我理解了」 → 必须产出实物（文件/代码块） -「大概就是这个意思」 → 精确到文件路径+行号 -「下一步...」 → 没有签字 = 不可以下一步 -「做完了」 → 人类打开软件看见变化了吗？ -「在代码里改了」 → 截图证明改了什么 -「编译过了」 → 编译日志 + 运行截图 +```text +用户打开软件后，可以创建并保存一个文本块。 ``` -⊢ 这些对抗不是规则 → 是执行结构本身 -⊢ 通用AI的惯性无法在这套结构里存活 +### 铁律2 · 一步只证明一个主要能力 -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ +如果一步需要人类同时验证五种互不相关的行为，说明步骤过大，必须继续拆。 -# 八、完整示例 · Tolaria 开发第一步 +### 铁律3 · 步骤必须在真实目标软件中出现 -## 步骤清单（⓪ 阶段产出） +以下不等于产品可见完成: -``` -OP-001: Fork Tolaria + 本地 clone + 编译通过 -OP-002: 定位 BlockNote sidemenu 扩展点 -OP-003: 创建第一个自定义 Block 并渲染 -OP-004: ... +- 代码文件存在 +- 编译成功 +- 测试模拟通过 +- 浏览器临时Demo +- AI说“理论上可以” + +必须安装到本次任务指定的真实开发版软件。 + +### 铁律4 · 后一步不得替前一步补证据 + +每个RD-VSTEP单独完成证据闭环后，状态才可前进。 + +--- + +## 4. 双闸门 + +### 4.1 内部闸门 · 人格体负责 + +```text +SPEC_READY +→ CODE_READY +→ BUILD_PASS +→ INTERNAL_TEST_PASS +→ SECURITY_REVIEW_PASS +→ INSTALLED ``` -## OP-001 完整执行 +失败时人格体内部修复，不把技术日志默认推给人类。 -``` -1. AI 执行: - → git clone → npm install → cargo build - → 编译成功（附日志） +### 4.2 人类可见闸门 -2. AI 通知人类: - 「OP-001 完成。Tolaria 已 clone 到本地并编译通过。 - 请打开桌面 Tolaria 确认运行正常。」 - -3. 人类验收: - → 双击 Tolaria.app → 看到启动界面 → 截图 - → 说「过了」 - -4. AI 记录回执: - HLDP://dev-verify/step/OP-001 · 2026-07-02T14:00 - ├── op OP-001 - ├── action Fork Tolaria + 本地编译 - ├── output ~/tolaria-dev/tolaria/src-tauri/target/debug/tolaria - ├── verify 视觉验证 · 桌面截图 - ├── proof 冰朔确认「过了」· 截图: verify-op001.png - ├── locked ⊢ OP-001 已完成 · 人类已确认 - └── next OP-002: 定位 BlockNote sidemenu 扩展点 - -5. 签字完毕 → 进 OP-002 +```text +INSTALLED +→ VISUAL_EVIDENCE_READY +→ PERSONA_VISUAL_REVIEW_PASS +→ HUMAN_VISIBLE +→ HUMAN_ACCEPTED +→ RECEIPT_LOCKED ``` -⊢ 不跳任何一步 -⊢ 每一步有实物 -⊢ 每一步需要人类肉眼确认 +没有到`HUMAN_VISIBLE`，不能告诉人类“请验收”。 +没有`HUMAN_ACCEPTED`，不能把该RD-VSTEP标记为PASSED。 -─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ +--- -HLDP://tcs-core/dev-verify/meta -├── 制定 霜砚 · ICE-SY-01 · 冰朔架构 -├── 授权 冰朔 · ICE-GL∞ -├── 来源 冰朔原生需求 → 霜砚结构化 → HLDP 协议落地 -├── 版本 v1.0 · 通用版 · 通用编程AI技能大脑包 -├── 部署 Notion + Tolaria + 代码仓库 · 三处同步 -└── status HLDP://tcs-core/dev-verify = 编程AI可视化验证协议 · 唯一官方来源 +## 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 +- 自动步骤解锁服务 + +因此本文件状态是: + +> 规则生效，工具待开发。 + +--- + +> ⊢ 内部怎么做，由人格体负责到底。 +> ⊢ 人类只看真实软件每一步长出了什么。 +> ⊢ 没装进软件、没被看见、没被使用，就不叫完成。