docs: upgrade HoloLake global engineering rules

This commit is contained in:
冰朔 2026-08-10 20:23:40 +08:00
commit ca58d08611
18 changed files with 399 additions and 21 deletions

View file

@ -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 2030 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)

View file

@ -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 仍暂停;
- 本轮没有构建或安装新桌面版本。
规则升级只改变后续开发怎样判断和守门,不把未实现能力写成已经存在。

View file

@ -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 当前架构、机器导航和产品边界更新,不宣称企业服务器已接入,
不宣称生产写入已开放,也不宣称新的桌面软件已经构建或安装。

View file

@ -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 最终形态时先读此件。

View file

@ -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.

View file

@ -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.

View file

@ -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."));