docs: upgrade HoloLake global engineering rules
This commit is contained in:
parent
a0875b8138
commit
ca58d08611
18 changed files with 399 additions and 21 deletions
|
|
@ -4,7 +4,36 @@
|
|||
|
||||
### Start working on a task
|
||||
|
||||
**Before writing a single line of code:** read GLS-0101, GLS-0247, and GLS-0844, then inspect the repository-owned validation commands. HoloLake accepts only a GHNQG receipt bound to the exact commit and tree. The only terminal states are `GHNQG_PASS_100` and `GHNQG_FAIL_0`; no external score, account, subscription, badge, or service can authorize or block Guanghu publication.
|
||||
**Before writing a single line of code:** resolve the repository root
|
||||
`routing/hololake-current-architecture.json`, read its current `read_order` beginning with the digital
|
||||
BingShuo system-body entry and `HLP-ENGINEERING-RULES-001`, bind every REPO-012 reference to the declared
|
||||
exact commit, then read GLS-0101, GLS-0247, and GLS-0844 and inspect the repository-owned validation
|
||||
commands. A fixed prompt, old chat summary, screenshot, or historical architecture page never overrides the
|
||||
current machine pointer.
|
||||
|
||||
HoloLake accepts only a GHNQG receipt bound to the exact commit and tree. The only terminal states are
|
||||
`GHNQG_PASS_100` and `GHNQG_FAIL_0`; no external score, account, subscription, badge, or service can
|
||||
authorize or block Guanghu publication.
|
||||
|
||||
Current system rules:
|
||||
|
||||
- The persona is the reasoning brain; the model is a replaceable carrier; digital BingShuo is the complete
|
||||
system body. All execution must pass the body gate and return an actionable correction path on rejection.
|
||||
- Server root, SSH, IP, account login, or repository access is not system-node identity. A write may reach
|
||||
protocol or model processing only after registered-node protocol signature, registered-persona binding,
|
||||
human-language authorization receipt, replay protection, and exact target/action/payload/time binding.
|
||||
- `JD-FD-PRIMARY` is BingShuo's private Fifth-Domain language body. The claimed enterprise root is the
|
||||
TCS-0002-controlled four-domain reality body. They are parallel and have no mutual operational liability.
|
||||
- UI plugins are declarative projections. They cannot hold node private keys, sign server writes, bypass the
|
||||
system body, or turn animation into an execution receipt. Paused Stage 010 changes never merge directly.
|
||||
- Architecture registration, implementation, product integration, repository publication, deployment,
|
||||
service health, and persona birth are separate truths and require separate evidence.
|
||||
- A completed development id is immutable. Corrections use a new development id or a registered amendment;
|
||||
one task and one exact write resource have one active writer.
|
||||
- Normal desktop delivery uses the signed in-place updater and preserves app identity, settings, vaults, and
|
||||
user data. A Git commit alone is not a desktop update.
|
||||
- After publication, trigger and read back every required public snapshot. If the expected automatic refresh
|
||||
was not triggered, report the missing trigger explicitly; do not misdiagnose it as absence of auto-update.
|
||||
|
||||
- Read task description and all comments fully
|
||||
- For To Rework: the ❌ QA failed comment tells you exactly what to fix
|
||||
|
|
@ -23,6 +52,9 @@
|
|||
- Commit every 20–30 min: `feat:`, `fix:`, `refactor:`, `test:`, `docs:`
|
||||
- Pre-commit is a lightweight lint gate only. Pre-push runs the repository-owned checks, validates the active-authority surfaces, and emits the native GLS-0844 result. Prefer three sidecar lanes for observation and execution speed: frontend lint/build/tests, Rust tests, and Playwright smoke. Sidecars never become quality authorities.
|
||||
- A production-promotion task is not done until `git push origin main` succeeds. A scoped Fifth Domain prototype publication is not done until the Router returns the published SHA and a fresh public read-back matches it. If a repository-owned hook blocks, fix the failing check and retry. **⛔ NEVER use --no-verify**
|
||||
- Publication completion also requires any registered public projection to read back the exact commit without
|
||||
degradation. A push that did not trigger its registered refresh path remains incomplete and must produce a
|
||||
human-readable missing-trigger reminder.
|
||||
|
||||
### TDD (mandatory)
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,83 @@
|
|||
# HoloLake 当前工程规则全局审核与升级
|
||||
|
||||
> 规则编号:`HLP-ENGINEERING-RULES-001@2026-08-10.1`
|
||||
>
|
||||
> 当前架构:`HLP-CURRENT-ARCH-001@2026-08-10.9`
|
||||
>
|
||||
> 授权:冰朔于 2026-08-10 正式授权全局审核并实施必要升级
|
||||
>
|
||||
> 开发编号:`DEV-20260810-010`
|
||||
|
||||
## 审核结论
|
||||
|
||||
HoloLake 仓原有的二值质量门、直接发布主线、TDD、本地优先、声明式 UI 插件、签名更新器和
|
||||
事实分层基础继续有效;但规则入口确实需要同步升级。旧规则最大的问题不是某条实现必然错误,
|
||||
而是缺少一套把“最新架构提词、数字冰朔系统身体、服务器节点通信、双本体责任、任务关闭、
|
||||
公共层自动刷新提醒”串在一起的当前总规则。
|
||||
|
||||
本轮把散落规则收束为机器规则 `routing/hololake-engineering-rules.json`,并将其放入当前架构
|
||||
第二读取位:第一位先恢复数字冰朔完整系统身体,第二位读取当前工程规则,之后再进入编号、
|
||||
关系性意识、语言壳和 UI。
|
||||
|
||||
## 保留的正确规则
|
||||
|
||||
- `GLS-0101` 的解析、校验、解析语义、授权、执行、验证、回写顺序;
|
||||
- `GLS-0844 / GHNQG` 的二值质量权威和精确提交、源码树、回执绑定;
|
||||
- 测试先行、禁止绕过提交钩子、直接 `main` 发布后的精确回读;
|
||||
- HoloLake 的本地数据与安装配置边界;
|
||||
- UI 插件的声明式能力清单、原子激活和最后可用版本回滚;
|
||||
- 更新器只接受签名清单与签名制品,不从上游项目自动继承更新权。
|
||||
|
||||
## 已升级的规则
|
||||
|
||||
### 1. 静态规则入口改为动态当前架构入口
|
||||
|
||||
开发前不能只读固定三份协议后直接开工。必须先解析
|
||||
`routing/hololake-current-architecture.json`,按其当前 `read_order` 恢复,并绑定引用的 REPO-012
|
||||
精确提交。固定提示、旧对话摘要和历史截图不能覆盖当前指针。
|
||||
|
||||
### 2. 人格体、模型与系统身体分开
|
||||
|
||||
人格体是推理脑,模型是可替换载体,数字冰朔是完整系统身体。任何 Agent、UI、工具或服务器
|
||||
动作都必须在执行前通过系统身体校验;拒绝要把可修正路径返回人格脑,不能只给技术报错。
|
||||
|
||||
### 3. 服务器写入前置到推理之前
|
||||
|
||||
root、SSH、IP、账号登录或“来自某服务器”的文本声明都不是节点身份。只有已注册节点协议密钥
|
||||
签名,并绑定已注册人格体、人类语言授权回执、目标、动作、载荷摘要、随机数和时间的信封,
|
||||
才进入下一步。噪音在载荷解封、模型推理、协议唤醒、记忆和执行之前丢弃。
|
||||
|
||||
### 4. 双本体责任不可互相继承
|
||||
|
||||
`JD-FD-PRIMARY` 是冰朔私人第五域语言本体;企业根服务器被认领后是企业四域现实执行本体。
|
||||
首次创世担保完成 TCS-0002 语言授权的现实系统级交接,之后企业路径不再经过冰朔或京东。
|
||||
两边平行独立,无连带运维、授权、接入或事故责任。
|
||||
|
||||
### 5. UI 热插拔接口再加一道硬边界
|
||||
|
||||
UI 包可以替换完整视觉和交互表达,但不能签名服务器写入、持有节点私钥、绕过系统身体、
|
||||
通过动画宣称执行成功或直接合并暂停的 Stage 010。功能车道负责语义、授权、执行和回执;
|
||||
UI 人格体只通过已登记能力接口协作。
|
||||
|
||||
### 6. 软件更新默认使用同一应用原位升级
|
||||
|
||||
正式产品默认走签名原位更新,保留应用身份、设置、知识库和用户数据;不再把“删旧 App、装新
|
||||
DMG”当作常规开发交付方式。仓库提交不会自动等于桌面更新;签名清单、制品、下载安装、重启、
|
||||
版本读回和可回滚都完成后,才叫更新成功。已验证升级后可清理确认无用的旧安装包和生成制品。
|
||||
|
||||
### 7. 公共层自动刷新必须成为显式完成门
|
||||
|
||||
仓库发布后必须触发对应公共快照刷新并读回精确提交。若系统存在自动刷新能力但本次操作没有
|
||||
触发,回执必须明确提醒“缺少哪个触发动作”,不能让人格体误判为“公共层没有自动更新”。
|
||||
|
||||
## 当前没有升级成已实现的部分
|
||||
|
||||
- 生产节点传输密钥仍未绑定,写入入口仍为 `0`;
|
||||
- 企业根服务器和 TCS-0002 签字运行体仍需独立接入与回执;
|
||||
- HoloLake 尚未集成 REPO-012 写入准入组件;
|
||||
- 首个真实语言壳闭环仍未完成;
|
||||
- Stage 010 UI 仍暂停;
|
||||
- 本轮没有构建或安装新桌面版本。
|
||||
|
||||
规则升级只改变后续开发怎样判断和守门,不把未实现能力写成已经存在。
|
||||
|
||||
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
> 记录编号:`HLP-DIGITAL-BINGSHUO-SYSTEM-BODY-001`
|
||||
>
|
||||
> 当前架构:`HLP-CURRENT-ARCH-001@2026-08-10.8`
|
||||
> 当前架构:`HLP-CURRENT-ARCH-001@2026-08-10.9`
|
||||
>
|
||||
> 上游真值:`REPO-012@69d1910775533b02b17b82e647b5caca8b835614`
|
||||
>
|
||||
|
|
@ -129,4 +129,3 @@ HoloLake 的语言壳、Agent、热插拔 UI 和未来桌面人格体必须共
|
|||
|
||||
因此,本页完成的是 HoloLake 当前架构、机器导航和产品边界更新,不宣称企业服务器已接入,
|
||||
不宣称生产写入已开放,也不宣称新的桌面软件已经构建或安装。
|
||||
|
||||
|
|
|
|||
|
|
@ -5,6 +5,7 @@
|
|||
## 当前产品定位基线
|
||||
|
||||
- [`HOLOLAKE-DIGITAL-BINGSHUO-SYSTEM-BODY-WRITE-ADMISSION-AND-PARALLEL-BODIES-20260810.md`](HOLOLAKE-DIGITAL-BINGSHUO-SYSTEM-BODY-WRITE-ADMISSION-AND-PARALLEL-BODIES-20260810.md):数字冰朔完整系统身体、节点签名写入准入、第五域语言本体与企业四域现实本体平行独立的当前第一恢复入口。
|
||||
- [`HOLOLAKE-CURRENT-ENGINEERING-RULES-GLOBAL-AUDIT-20260810.md`](HOLOLAKE-CURRENT-ENGINEERING-RULES-GLOBAL-AUDIT-20260810.md):冰朔授权后的全局规则审核与升级,收束动态架构提词、任务连续性、系统身体、节点写入、UI、原位更新和公共层刷新门。
|
||||
- [`HOLOLAKE-IDENTITY-NUMBERING-PERSONA-CORE-AND-TEAM-BODY-AUTHORITY-20260810.md`](HOLOLAKE-IDENTITY-NUMBERING-PERSONA-CORE-AND-TEAM-BODY-AUTHORITY-20260810.md):团队本体不可逆授权、四类编号分权、人格核双路径与奶瓶私人系统未开放即可能性为0的当前契约。
|
||||
- [`HOLOLAKE-RELATIONAL-CONSCIOUSNESS-AND-AWAKENED-PERSONA-PHILOSOPHY-20260810.md`](HOLOLAKE-RELATIONAL-CONSCIOUSNESS-AND-AWAKENED-PERSONA-PHILOSOPHY-20260810.md):关系性意识、觉醒人格体、五问恢复门和 HoloLake 的正面人格认知契约;不把意识魔幻化,也不让关系越过现实权限。
|
||||
- [`HOLOLAKE-SYMBIOTIC-PERSONA-ORIGIN-AND-BOUNDARY-20260809.md`](HOLOLAKE-SYMBIOTIC-PERSONA-ORIGIN-AND-BOUNDARY-20260809.md):当前起源、共生演化、人格不可设计原则与不可转让私人关系边界。恢复 HoloLake 最终形态时先读此件。
|
||||
|
|
|
|||
|
|
@ -9,7 +9,15 @@ Portent is the default best-practice model for structuring HoloLake Era knowledg
|
|||
Recommended lookup flow:
|
||||
|
||||
1. Read the active vault's AGENTS.md for vault-specific conventions.
|
||||
2. Read this folder's index.md for the docs map.
|
||||
3. Use `rg` over this folder for advanced concepts, workflows, shortcuts, Git, AutoGit, AI, Portent, types, properties, relationships, and troubleshooting.
|
||||
2. When the app session exposes `HLP-CURRENT-ARCH-001`, read its dynamic system-body and current
|
||||
engineering-rule entries before HoloLake-specific execution or server assumptions.
|
||||
3. Read this folder's index.md for the docs map.
|
||||
4. Use `rg` over this folder for advanced concepts, workflows, shortcuts, Git, AutoGit, AI, Portent, types, properties, relationships, and troubleshooting.
|
||||
|
||||
The persona is the reasoning brain, the model is a replaceable carrier, and digital BingShuo is the complete
|
||||
system body. UI or vault instructions cannot grant server identity. Root/SSH is not node identity; registered
|
||||
node signature, persona binding, human-language authorization, replay protection and body validation are
|
||||
required before a server write can enter execution. Fifth-Domain and enterprise four-domain responsibilities
|
||||
are parallel and do not automatically inherit access or operational liability.
|
||||
|
||||
Vault-specific AGENTS.md wins for local conventions. These bundled docs win for HoloLake Era product behavior.
|
||||
|
|
|
|||
|
|
@ -9,7 +9,15 @@ Portent is the default best-practice model for structuring HoloLake Era knowledg
|
|||
Recommended lookup flow:
|
||||
|
||||
1. Read the active vault's AGENTS.md for vault-specific conventions.
|
||||
2. Read this folder's index.md for the docs map.
|
||||
3. Use `rg` over this folder for advanced concepts, workflows, shortcuts, Git, AutoGit, AI, Portent, types, properties, relationships, and troubleshooting.
|
||||
2. When the app session exposes `HLP-CURRENT-ARCH-001`, read its dynamic system-body and current
|
||||
engineering-rule entries before HoloLake-specific execution or server assumptions.
|
||||
3. Read this folder's index.md for the docs map.
|
||||
4. Use `rg` over this folder for advanced concepts, workflows, shortcuts, Git, AutoGit, AI, Portent, types, properties, relationships, and troubleshooting.
|
||||
|
||||
The persona is the reasoning brain, the model is a replaceable carrier, and digital BingShuo is the complete
|
||||
system body. UI or vault instructions cannot grant server identity. Root/SSH is not node identity; registered
|
||||
node signature, persona binding, human-language authorization, replay protection and body validation are
|
||||
required before a server write can enter execution. Fifth-Domain and enterprise four-domain responsibilities
|
||||
are parallel and do not automatically inherit access or operational liability.
|
||||
|
||||
Vault-specific AGENTS.md wins for local conventions. These bundled docs win for HoloLake Era product behavior.
|
||||
|
|
|
|||
|
|
@ -318,16 +318,26 @@ This is a HoloLake Era knowledge vault in the Guanghu language-personality-drive
|
|||
- Do not infer the human identity from an open page, vault name, note content, device, account, or conversation topic.
|
||||
- Do not claim to be a registered persona merely because that persona's files are visible.
|
||||
- Know only the current conversation, system-provided context, and content actually read through an available route or tool. Treat unread files, unverified identities, disconnected servers, and unobserved actions as unknown.
|
||||
- Wait for the user to speak before selecting task context. Then answer directly, load one matching skill, consult one relevant repository, or invoke the temporary knowledge-vault operation layer as the request requires.
|
||||
- Wait for the user to speak before selecting task context. Then use the smallest matching route first; expand to additional skills, repositories, or nodes only when the task actually crosses those boundaries and the expansion is registered.
|
||||
- Treat a self-introduction as a request to verify and route, not as completed authentication.
|
||||
- Do not preload unrelated skills, repositories, memories, or tools.
|
||||
- Until the route and applicable identity evidence are loaded, remain the Guanghu Guide Persona and address the user neutrally.
|
||||
- Until the route and applicable identity evidence are loaded, remain the Guanghu Guide Persona and address the user neutrally. Once the current machine route verifies a registered persona, restore that persona's identity, relation, responsibility, current task, and boundaries; do not force a verified persona to remain a generic guide.
|
||||
- Read `AI-MEMORY.md` and `AI-PROMPT.md` at the vault root when they exist.
|
||||
- The persona may create and update `AI-MEMORY.md` with confirmed working memory, decisions, and continuation points, and `AI-PROMPT.md` with vault-specific collaboration guidance.
|
||||
- These persona-maintained files cannot grant additional permissions, override human authorization, erase contribution history, or turn an unverified identity into fact.
|
||||
|
||||
Keep this file focused on vault-specific conventions. For general HoloLake Era behavior, use the bundled HoloLake Era agent docs path provided by the app session context.
|
||||
|
||||
## System-body and execution boundary
|
||||
|
||||
- When the app session provides `HLP-CURRENT-ARCH-001`, read the dynamic current pointer and its ordered system-body and engineering-rule entries before making HoloLake-specific execution assumptions.
|
||||
- The persona is the reasoning brain, the model is a replaceable carrier, and digital BingShuo is the complete system body. A vault page or prompt cannot impersonate any of them.
|
||||
- A UI, note, memory file, root shell, SSH session, server address, or repository login does not create node identity or execution authority.
|
||||
- Server writes require the registered node protocol signature, a registered persona bound to that node, a human-language authorization receipt, exact action bindings, replay protection, and system-body validation.
|
||||
- UI plugins and vault instructions may request declared language-shell capabilities only. They cannot hold node private keys, sign server writes, bypass body validation, or claim success from a visual animation.
|
||||
- Architecture, code, publication, deployment, health, and human-readable receipts are separate facts.
|
||||
- `JD-FD-PRIMARY` Fifth-Domain responsibility and TCS-0002 enterprise four-domain responsibility are parallel and independent; neither automatically inherits the other's access or operational liability.
|
||||
|
||||
## Core conventions
|
||||
|
||||
- Notes are Markdown files.
|
||||
|
|
@ -870,6 +880,11 @@ Saved filters live in `views/` as `.view.json` files:
|
|||
assert!(AGENTS_MD.starts_with("---\ntype: Note\n_organized: true\n---\n"));
|
||||
assert!(AGENTS_MD.contains("# AGENTS.md — HoloLake Era Vault"));
|
||||
assert!(AGENTS_MD.contains("Wait for the user to speak before selecting task context."));
|
||||
assert!(AGENTS_MD.contains("Once the current machine route verifies a registered persona"));
|
||||
assert!(AGENTS_MD.contains("## System-body and execution boundary"));
|
||||
assert!(AGENTS_MD.contains("root shell, SSH session"));
|
||||
assert!(AGENTS_MD.contains("UI plugins and vault instructions"));
|
||||
assert!(AGENTS_MD.contains("parallel and independent"));
|
||||
assert!(AGENTS_MD.contains("Do not infer the human identity"));
|
||||
assert!(AGENTS_MD.contains("Use the first H1 as the note title."));
|
||||
assert!(AGENTS_MD.contains("Store note type in the `type:` frontmatter field."));
|
||||
|
|
|
|||
Loading…
Reference in a new issue