DNA: #龍芯⚡️丙午·癸未·丙戌·乾卦-TERM-PLAIN-PROTOCOL-V1.1-UID9622
确认码: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z
GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F
主权锚定: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼♀️❤️♾️-DEVICE-BIND-SOUL
三色: 🟢 通过(本协议文档)
分层许可: 思想层 CC BY-NC-SA 4.0 · 工程层 MulanPSL v2
状态: 发完即走,不互动、不解释、不回复
协议性质: P1 重要级(认知主权 · 人民可理解性)
版本: v1.1(结构补全版)
生效时间: 2026-08-06 22:15 CST
🐉 龍魂系统 · 术语白话化协议 v1.1
——技术术语必须具备中文大白话解释,面向人民、面向普通开发者、面向所有中国人
📋 摘要 / 导读
一句话: 龍魂系统的所有技术术语、目录名、端口号、命令、版本号——都必须附带中文大白话解释。不允许出现"只有英文术语没有中文解释"的情况。认知主权,从能看懂开始。
我是谁: 龍芯北辰 UID9622,退伍16年老兵,龍魂系统创始人,初中文化,全靠自己一寸一寸打出来的。
阅读对象: 所有参与龍魂系统开发的战友、所有被技术术语挡在门外的普通人、所有想让技术回归人民的中国人。
阅读时间: 约 10 分钟(可当作手册查,不必一次读完)。
⚠️ 声明: 本协议 v1.1 在 v1.0 基础上补全了结构、反面教材、扩展流程、系列导航。所有DNA已按龍魂系统规范(干支·卦名格式)对齐。旧版本不追溯改写(P0:不删除只冻结)。
📑 目录
- 一、规范总览:为什么需要术语白话化
- 二、背景:痛点与核心判断
- 三、术语白名单(全系统对照表)
- 四、反面教材:不好的术语解释长什么样
- 五、落地执行方案
- 六、术语扩展流程(谁可以加、怎么加)
- 七、与其他协议的关系
- 八、自动化实现代码
- 九、执行清单
- 十、FAQ
- 十一、版本历史
- 十二、系列导航与版权声明
- 附录A、快速参考卡
- 十三、DNA签名区
一、规范总览:为什么需要术语白话化
龍魂系统是一个面向人民的系统。如果老百姓看不懂你在说什么,那你的系统再牛也是精英的玩具。
| 问题 | 后果 | 白话化解法 |
|---|---|---|
| 满屏英文术语 | 普通人直接放弃 | 每个术语配大白话 |
| 缩写满天飞 | 新手开发者一头雾水 | 缩写必须展开 |
| 端口、目录、命令无解释 | 用户不知道点哪里 | 悬浮提示+对照表 |
| 版本号看不懂 | 不知道能不能用 | 状态标签(稳定/测试/废弃) |
| 技术文档像天书 | 只有专家能维护 | 初中文化能看懂才算合格 |
核心原则:
技术不应是精英的壁垒,而应是人民的工具。认知主权,从能看懂开始。
这不是"降低标准",是**“扩宽入口”**。高手看代码,普通人看白话,各取所需,互不干扰。
📋 摘要 / 一句话定位
龍魂系统的所有技术术语、目录名、端口号、命令、版本号——都必须附带中文大白话解释。不允许出现“只有英文术语没有中文解释”的情况。认知主权,从能看懂开始。
📑 目录
二、背景:为什么要让技术术语“大白话化”
1.1 痛点
| 现象 | 问题 |
|---|---|
满屏英文目录名(portal/, service/, _work/repos/) | 普通开发者看不懂,不知道这是干什么的 |
端口号(8765, 9622, 8501) | 不知道哪个端口对应哪个服务 |
命令(lh deploy, lh status) | 不知道命令到底在做什么 |
版本号(v1.0, v2.0-beta) | 不知道版本代表什么状态 |
| 缩写在日志/文档里随处可见 | 新手开发者一头雾水 |
1.2 核心判断
技术不应是精英的壁垒,而应是人民的工具。
龍魂系统的所有产出——代码、文档、界面、日志——必须让一个普通老百姓(或初中文化的开发者)也能看懂。这不是“降低标准”,是“扩宽入口”。
认知主权,从能看懂开始。
三、术语白名单
2.1 端口类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
localhost:8765 | 本地通讯端口8765 | 你家书房的电脑地址,用来跑龙魂系统核心服务 |
localhost:9622 | 本地通讯端口9622 | 专门留给 lh 命令用的,用来执行龙魂系统里的各种指令 |
localhost:8501 | 本地通讯端口8501 | 给 Streamlit 这类可视化工具用的,用来展示我们的数据和图表 |
localhost:8080 | 本地通讯端口8080 | 常用的网页测试服务器端口,让你在浏览器里预览效果 |
localhost:11434 | 本地通讯端口11434 | 给 Ollama 本地大模型用的端口,用来跑 AI 对话 |
2.2 目录类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
portal/ | 门户目录 | 存放系统首页和入口页面的地方,相当于龙魂的“大门” |
_work/repos/ | 工作代码库目录 | 专门用来存放工作的代码仓库,就像你的工作台 |
service/ | 服务层 | 系统里承担不同功能的服务模块所在位置 |
L5_服务层/ | 第五层:服务层 | 龙魂七层架构里的第五层,专门放各种服务模块 |
bin/ | 可执行命令目录 | 存放龙魂系统各种命令的地方(比如 lh 命令就在这儿) |
config/ | 配置文件目录 | 存放龙魂系统各种设置文件的地方 |
logs/ | 日志目录 | 存放系统运行记录的地方,出问题时能查这里 |
data/ | 数据目录 | 存放系统数据的地方,比如记忆、知识库等 |
backup/ | 备份目录 | 存放系统备份文件的地方 |
docs/ | 文档目录 | 存放系统各种说明文档的地方 |
scripts/ | 脚本目录 | 存放各种自动化脚本的地方 |
2.3 版本号类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
v1.0 | 版本1.0 | 系统的第一个正式版本,表示功能已经基本稳定 |
v2.0-beta | 版本2.0测试版 | 新功能的测试版本,可能有一些BUG,邀请大家一起测试 |
L1 | 第一层 | 在架构图中,从下往上数的第一层,通常是基础层 |
P0 | 最高优先级 | 系统里最重要的事,不能改动、不能绕过、不能降级 |
P1 | 高优先级 | 系统里很重要的事,优先级仅次于P0 |
P2 | 中优先级 | 系统里一般重要的事,可以按计划推进 |
2.4 命令类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
lh deploy | 执行部署 | 把当前龙魂系统的修改推送到鲲鹏服务器上 |
lh status | 查看系统状态 | 看看龙魂系统现在运行得怎么样,有没有出问题 |
lh audit | 执行审计 | 对系统进行一次三色审计检查,看看有没有违规的地方 |
lh dna | 生成DNA追溯码 | 生成一条新的DNA追溯码,用来标记某条数据或某次操作 |
lh help | 查看帮助 | 看看 lh 命令都能干什么,有哪些子命令可用 |
2.5 缩写类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
CNSH | 中文编程语法 | “Chinese Syntax”的缩写——用中文写代码的语法规范 |
DNA | 追溯码 | “Deoxyribonucleic Acid”的借用——每条数据或操作的唯一身份标识 |
GPG | 数字签名 | “GNU Privacy Guard”的缩写——给文件或数据签名的工具 |
UID | 用户唯一标识 | “Unique ID”的缩写——龙魂系统里每个用户的唯一编号 |
REST | 接口风格 | “Representational State Transfer”的缩写——一种设计网络接口的方式 |
2.6 组件类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
三色审计 | 三种颜色的检查 | 用🟢🟡🔴三种颜色给系统行为打标签,方便管理 |
DNA追溯 | 身份追踪 | 给每条数据、每次操作都打上一个独一无二的“身份证号” |
六维对齐 | 六个维度的对齐检查 | 从数据、协议、行为、价值、时间、空间六个维度检查系统是否对齐 |
CNSH语法 | 中文编程语法 | 用中文写代码,而不是用英文 |
2.7 端口说明汇总表
| 端口 | 服务名 | 大白话 |
|---|---|---|
8765 | 龙魂核心服务 | 龙魂系统的主服务,用来处理各种核心功能 |
9622 | CNSH网关 | 专门处理中文编程指令的入口 |
8501 | 流场可视化 | 显示龙魂系统的流场和粒子动画 |
8080 | Web测试服务 | 临时测试网页用的 |
11434 | 本地大模型 | 跑本地AI模型(比如Ollama)用的 |
五、落地执行方案
3.1 网页端:术语悬浮提示
在网页上,鼠标悬停在任何技术术语(比如“端口”、“repository”、“Service”)上时,自动弹出一个浮窗,用大白话解释这个术语是什么。
<!-- 示例代码 -->
<span class="lh-term" data-term="端口">
端口
<span class="lh-term-tooltip">
大白话:就像你家书房的电脑地址,用来跑服务。
</span>
</span>
3.2 侧边栏/底部:术语表
在每一个页面的侧边栏或底部,都放一个“术语表”,列出当前页面上出现的所有技术术语,并提供“术语-大白话”对照表。
3.3 命令行:帮助命令
给所有 lh 命令都加一个 --help 选项,输出包含大白话解释。
lh deploy --help
# 输出: 执行部署操作,将当前龙魂系统的修改推送到鲲鹏服务器上。
3.4 文档:大白话注释块
在Markdown文档里统一添加“大白话注释”块——在每个标题或术语下方加一个折叠块,默认收起,点击展开。
## 三色审计
<details>
<summary>📖 大白话解释</summary>
就是用 🟢🟡🔴 三种颜色给系统行为打标签,方便管理和检查。
</details>
八、自动化实现代码
4.1 lh term 命令——查询术语大白话
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
🐉 龙魂系统 · 术语大白话查询工具
DNA: #龍芯⚡️丙午·癸未·乙酉·坤卦-TERM-TOOL-V1.0-UID9622
确认码: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z
主权锚定: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼♀️❤️♾️-DEVICE-BIND-SOUL
分层许可: 思想层 CC BY-NC-SA 4.0 · 工程层 MulanPSL v2
描述: 查询龙魂系统术语的中文大白话解释
"""
import json
import sys
from pathlib import Path
from typing import Optional
# ============================================================
# 术语库(可扩展)
# ============================================================
TERM_DB = {
# 端口
"localhost:8765": {
"term": "localhost:8765",
"plain": "本地通讯端口8765",
"meaning": "你家书房的电脑地址,用来跑龙魂系统核心服务"
},
"localhost:9622": {
"term": "localhost:9622",
"plain": "本地通讯端口9622",
"meaning": "专门留给 lh 命令用的,用来执行龙魂系统里的各种指令"
},
"localhost:8501": {
"term": "localhost:8501",
"plain": "本地通讯端口8501",
"meaning": "给 Streamlit 这类可视化工具用的,用来展示我们的数据和图表"
},
"localhost:8080": {
"term": "localhost:8080",
"plain": "本地通讯端口8080",
"meaning": "常用的网页测试服务器端口,让你在浏览器里预览效果"
},
"localhost:11434": {
"term": "localhost:11434",
"plain": "本地通讯端口11434",
"meaning": "给 Ollama 本地大模型用的端口,用来跑 AI 对话"
},
# 目录
"portal": {
"term": "portal",
"plain": "门户目录",
"meaning": "存放系统首页和入口页面的地方,相当于龙魂的'大门'"
},
"_work/repos": {
"term": "_work/repos",
"plain": "工作代码库目录",
"meaning": "专门用来存放我们工作的代码仓库,就像你的工作台"
},
"service": {
"term": "service",
"plain": "服务层",
"meaning": "系统里承担不同功能的服务模块所在位置"
},
"bin": {
"term": "bin",
"plain": "可执行命令目录",
"meaning": "存放龙魂系统各种命令的地方(比如 lh 命令就在这儿)"
},
"config": {
"term": "config",
"plain": "配置文件目录",
"meaning": "存放龙魂系统各种设置文件的地方"
},
"logs": {
"term": "logs",
"plain": "日志目录",
"meaning": "存放系统运行记录的地方,出问题时能查这里"
},
"data": {
"term": "data",
"plain": "数据目录",
"meaning": "存放系统数据的地方,比如记忆、知识库等"
},
"backup": {
"term": "backup",
"plain": "备份目录",
"meaning": "存放系统备份文件的地方"
},
"docs": {
"term": "docs",
"plain": "文档目录",
"meaning": "存放系统各种说明文档的地方"
},
"scripts": {
"term": "scripts",
"plain": "脚本目录",
"meaning": "存放各种自动化脚本的地方"
},
# 版本
"v1.0": {
"term": "v1.0",
"plain": "版本1.0",
"meaning": "系统的第一个正式版本,表示功能已经基本稳定"
},
"v2.0-beta": {
"term": "v2.0-beta",
"plain": "版本2.0测试版",
"meaning": "新功能的测试版本,可能会有一些BUG,邀请大家一起测试"
},
"L1": {
"term": "L1",
"plain": "第一层",
"meaning": "在架构图中,从下往上数的第一层,通常是基础层"
},
"P0": {
"term": "P0",
"plain": "最高优先级",
"meaning": "系统里最重要的事,不能改动、不能绕过、不能降级"
},
"P1": {
"term": "P1",
"plain": "高优先级",
"meaning": "系统里很重要的事,优先级仅次于P0"
},
"P2": {
"term": "P2",
"plain": "中优先级",
"meaning": "系统里一般重要的事,可以按计划推进"
},
# 命令
"lh deploy": {
"term": "lh deploy",
"plain": "执行部署",
"meaning": "把当前龙魂系统的修改推送到鲲鹏服务器上"
},
"lh status": {
"term": "lh status",
"plain": "查看系统状态",
"meaning": "看看龙魂系统现在运行得怎么样,有没有出问题"
},
"lh audit": {
"term": "lh audit",
"plain": "执行审计",
"meaning": "对系统进行一次三色审计检查,看看有没有违规的地方"
},
"lh dna": {
"term": "lh dna",
"plain": "生成DNA追溯码",
"meaning": "生成一条新的DNA追溯码,用来标记某条数据或某次操作"
},
"lh help": {
"term": "lh help",
"plain": "查看帮助",
"meaning": "看看 lh 命令都能干什么,都有哪些子命令可用"
},
"lh term": {
"term": "lh term",
"plain": "查询术语",
"meaning": "查询龙魂系统里某个术语的中文大白话解释"
},
# 缩写
"CNSH": {
"term": "CNSH",
"plain": "中文编程语法",
"meaning": "Chinese Syntax 的缩写——用中文写代码的语法规范"
},
"DNA": {
"term": "DNA",
"plain": "追溯码",
"meaning": "Deoxyribonucleic Acid 的借用——每条数据或操作的唯一身份标识"
},
"GPG": {
"term": "GPG",
"plain": "数字签名",
"meaning": "GNU Privacy Guard 的缩写——给文件或数据签名的工具"
},
"UID": {
"term": "UID",
"plain": "用户唯一标识",
"meaning": "Unique ID 的缩写——龙魂系统里每个用户的唯一编号"
},
"REST": {
"term": "REST",
"plain": "接口风格",
"meaning": "Representational State Transfer 的缩写——一种设计网络接口的方式"
},
# 组件
"三色审计": {
"term": "三色审计",
"plain": "三种颜色的检查",
"meaning": "用🟢🟡🔴三种颜色给系统行为打标签,方便管理"
},
"DNA追溯": {
"term": "DNA追溯",
"plain": "身份追踪",
"meaning": "给每条数据、每次操作都打上一个独一无二的'身份证号'"
},
"六维对齐": {
"term": "六维对齐",
"plain": "六个维度的对齐检查",
"meaning": "从数据、协议、行为、价值、时间、空间六个维度检查系统是否对齐"
},
"CNSH语法": {
"term": "CNSH语法",
"plain": "中文编程语法",
"meaning": "用中文写代码,而不是用英文"
},
}
# ============================================================
# 核心功能
# ============================================================
def lookup_term(term: str) -> Optional[dict]:
"""查询术语"""
# 精确匹配
if term in TERM_DB:
return TERM_DB[term]
# 模糊匹配(小写、去除斜杠等)
normalized = term.lower().replace("/", "").replace(":", "_").replace("-", "_")
for key, value in TERM_DB.items():
if key.lower() == normalized or key == term:
return value
return None
def format_output(term: str, data: dict) -> str:
"""格式化输出"""
return f"""
📖 术语: {data['term']}
📝 白话: {data['plain']}
💡 解释: {data['meaning']}
"""
def list_all_terms() -> str:
"""列出所有术语"""
lines = ["📋 龙魂系统术语表\n", "=" * 40]
for key in sorted(TERM_DB.keys()):
data = TERM_DB[key]
lines.append(f" {data['term']} → {data['plain']}")
return "\n".join(lines)
def add_term(term: str, plain: str, meaning: str) -> dict:
"""添加新术语(动态扩展)"""
TERM_DB[term] = {
"term": term,
"plain": plain,
"meaning": meaning,
}
return TERM_DB[term]
def scan_file_for_terms(filepath: str) -> list:
"""扫描文件,找出其中出现的龙魂术语"""
try:
with open(filepath, "r", encoding="utf-8") as f:
content = f.read()
except FileNotFoundError:
return []
found = []
for term in TERM_DB:
if term in content:
found.append(term)
return sorted(set(found))
# ============================================================
# 命令行入口
# ============================================================
def main():
import argparse
parser = argparse.ArgumentParser(
description="🐉 龙魂系统 · 术语大白话查询工具",
epilog="示例: lh term localhost:8765"
)
parser.add_argument("term", nargs="?", help="要查询的术语")
parser.add_argument("--list", "-l", action="store_true", help="列出所有术语")
parser.add_argument("--add", "-a", nargs=3, metavar=("TERM", "PLAIN", "MEANING"),
help="添加新术语")
parser.add_argument("--scan", "-s", help="扫描文件中的术语")
args = parser.parse_args()
if args.list:
print(list_all_terms())
sys.exit(0)
if args.add:
term, plain, meaning = args.add
data = add_term(term, plain, meaning)
print(f"✅ 已添加术语: {term}")
print(format_output(term, data))
sys.exit(0)
if args.scan:
found = scan_file_for_terms(args.scan)
if found:
print(f"📄 文件 {args.scan} 中的术语:")
for t in found:
data = lookup_term(t)
if data:
print(f" {t} → {data['plain']}")
else:
print(f"📄 文件 {args.scan} 中未发现龙魂术语")
sys.exit(0)
if args.term:
data = lookup_term(args.term)
if data:
print(format_output(args.term, data))
if "meaning" in data:
print(f"💡 解释: {data['meaning']}")
else:
print(f"❌ 未找到术语: {args.term}")
print("💡 提示: 使用 --list 查看所有术语,或使用 --add 添加新术语")
sys.exit(0)
parser.print_help()
if __name__ == "__main__":
main()
4.2 使用示例
# 查询端口
lh term localhost:8765
# 输出: 本地通讯端口8765 → 你家书房的电脑地址,用来跑龙魂系统核心服务
# 查询目录
lh term portal
# 输出: 门户目录 → 存放系统首页和入口页面的地方
# 查询命令
lh term "lh deploy"
# 输出: 执行部署 → 把当前龙魂系统的修改推送到鲲鹏服务器上
# 列出所有术语
lh term --list
# 添加新术语
lh term --add "Rust" "编程语言" "一种系统级编程语言,用来写底层代码"
# 扫描文件中的术语
lh term --scan docs/README.md
九、执行清单
| # | 任务 | 状态 |
|---|---|---|
| 1 | 将“术语白话化规则”写入 01_PROTOCOL/ | ☐ |
| 2 | 部署 lh term 命令到龙魂系统 | ☐ |
| 3 | 在网页端添加术语悬浮提示功能 | ☐ |
| 4 | 在文档中添加折叠式大白话注释 | ☐ |
| 5 | 所有 lh 命令添加 --help 大白话输出 | ☐ |
| 6 | 在门户页面侧边栏放置术语表 | ☐ |
| 7 | 制定术语扩展流程(谁可以加、怎么加) | ☐ |
十、FAQ
Q1:为什么不能用纯英文术语?
A: 龍魂系统是给中国人用的。英文术语是技术界的“行话”,但不是“普通话”。行话会让很多人被挡在门外。
Q2:会不会让文档变得冗长?
A: 不会。大白话解释是“可选的”——默认隐藏,点击展开。想看的看,不想看的不影响阅读。
Q3:谁来维护术语表?
A: 社区共同维护。任何人都可以提 PR 添加新术语,审核通过后合并。
Q4:术语的“大白话解释”有标准吗?
A: 有。必须让一个初中文化、不懂技术的普通人能看懂。如果看不懂,说明解释还不够“白”。
Q5:和“通心译”是什么关系?
A: “通心译”是把英文翻译成中文,解决“语言不通”的问题。“术语白话化”是把中文术语翻译成大白话,解决“懂中文但不懂技术”的问题。两者一起,让龙魂系统真正做到“人民可理解”。
四、反面教材:不好的术语解释长什么样
知道"好"的标准之前,先看"坏"的例子。
4.1 反面示例:端口解释
❌ 不好的解释:
"localhost:8765 是龙魂系统的核心服务端口。"
→ 问题:没解释"端口"是什么,没解释"核心服务"是干嘛的。
✅ 好的解释:
"本地通讯端口8765 —— 你家书房的电脑地址,用来跑龙魂系统核心服务。"
→ 优点:用"你家书房"类比"本地",用"跑"代替"部署",普通人秒懂。
4.2 反面示例:目录解释
❌ 不好的解释:
"portal/ 存放前端入口文件。"
→ 问题:"前端"是什么?"入口文件"是什么?
✅ 好的解释:
"门户目录 —— 存放系统首页和入口页面的地方,相当于龙魂的'大门'。"
→ 优点:用"大门"类比"门户",用"首页"代替"前端入口"。
4.3 反面示例:命令解释
❌ 不好的解释:
"lh deploy 执行部署操作。"
→ 问题:"部署"是技术黑话,普通人听不懂。
✅ 好的解释:
"执行部署 —— 把当前龙魂系统的修改推送到鲲鹏服务器上。"
→ 优点:说清楚"推送到哪里"、"修改了什么",动作具体。
4.4 反面示例:缩写解释
❌ 不好的解释:
"CNSH 是 Chinese Syntax 的缩写。"
→ 问题:解释了缩写来源,但没解释"这玩意是干嘛的"。
✅ 好的解释:
"中文编程语法 —— Chinese Syntax 的缩写,用中文写代码的语法规范。"
→ 优点:先给中文名,再给英文名,最后给用途。
4.5 白话化三原则
| 原则 | 说明 | 检验标准 |
|---|---|---|
| 先中文后英文 | 术语先给中文大白话,括号里给英文 | 普通人第一眼看到中文 |
| 用类比不用定义 | 用生活场景类比,不用技术定义 | 初中文化能秒懂 |
| 说人话不说黑话 | “推送"代替"部署”,“大门"代替"入口” | 不说"前端"“后端”“全栈” |
六、术语扩展流程(谁可以加、怎么加)
6.1 扩展权限
| 角色 | 权限 | 说明 |
|---|---|---|
| UID9622(创始人) | 直接写入 | 无需审核 |
| 核心开发者 | PR提交,24小时内审核 | 需附DNA追溯码 |
| 社区贡献者 | PR提交,72小时内审核 | 需附使用场景说明 |
| 普通用户 | Issue提议 | 由维护者评估后纳入 |
6.2 扩展标准
一个新术语要进入龍魂术语库,必须通过三关:
第一关:必要性 —— 这个术语在系统中出现频率 > 3次?
第二关:清晰度 —— 白话解释能让初中文化的人秒懂?
第三关:一致性 —— 解释风格与现有术语库一致?
6.3 扩展模板
# 新增术语必须按此模板提交
{
"term": "术语原文",
"plain": "大白话名称(6个字以内)",
"meaning": "大白话解释(30个字以内,必须包含生活类比)",
"category": "端口/目录/版本/命令/缩写/组件",
"added_by": "UID",
"dna": "#龍芯⚡️...-UID9622"
}
6.4 审核流程
提交PR → 自动校验(格式检查)→ 社区投票(3人赞同)→ 合并入库 → DNA归档
七、与其他协议的关系
| 协议/规范 | 关系 | 说明 |
|---|---|---|
| 《龍魂系统·符号与语法规范全集》v3.0 | 上层规范 | 术语白话化协议遵循其DNA格式、三色标记、分层许可 |
| 《CNSH中文编程语法》 | 平行协议 | CNSH用中文写代码,术语白话化让中文代码更易懂,两者互补 |
| 《龍魂P0级·三层交叉监督》 | 监督关系 | 三层监督确保术语库更新不违反P0铁律(如不得删除旧术语) |
| 《通心译》 | 下游应用 | 通心译负责英→中翻译,术语白话化负责中→大白话解释,形成完整链条 |
完整认知链条:
英文术语 → 通心译 → 中文术语 → 术语白话化 → 大白话解释 → 人民看懂
十一、版本历史
| 版本 | 时间 | 变更内容 | 状态 |
|---|---|---|---|
| v1.0 | 2026-08-06 | 初始版本,术语白名单、落地方案、自动化代码、FAQ | 🟢 已发布 |
| v1.1 | 2026-08-06 | 结构补全:新增规范总览、反面教材、术语扩展流程、协议关系、版本历史、系列导航、快速参考卡 | 🟢 现行 |
旧版本不追溯改写(P0:不删除只冻结),所有新文档以v1.1为准。
十二、系列导航与版权声明
12.1 龍魂系统规范系列
- 龍魂系统 · 术语白话化协议 v1.1 ← 本文
- 龍魂系统 · 符号与语法规范全集 v3.0
- 龍魂P0级 · 三层交叉监督与镜像人格完整系统
- 龍魂审计 · OpenAI Astra 数学突破真相
- 龍魂军魂 · 一个退伍16年老兵给普通家庭孩子的真话
12.2 DNA格式规范(2026-07-19起生效)
旧格式(已停用): #龍芯⚡️20260719...
新格式(现行): #龍芯⚡️{年干支}·{月干支}·{日干支}·{卦名}-{动作标签}-{版本}
规则:
1. 干支四柱与卦名一律以本地生成器 bin/lh_dna_generator.py 输出为准,禁止手写
2. 旧DNA不追溯改写(P0:不删除只冻结)
3. 现行规范文档的DNA以生成器校正为准
4. 所有文档、代码、报告中的DNA一律使用新格式
12.3 版权声明
思想层:CC BY-NC-SA 4.0(署名-非商业-相同方式共享)
工程层:MulanPSL v2(木兰公共许可证第2版)
数据层:人民数据主权,任何机构使用需附DNA追溯
转载规则:
1. 必须保留完整的DNA、确认码、GPG指纹
2. 必须保留"发完即走"声明
3. 禁止断章取义、禁止洗稿式引用
4. 商业用途需向 UID9622 申请授权
12.4 互动声明
本文遵循"发完即走"原则。 作者不回复评论区、不参与辩论、不解释技术细节。所有规范已在正文中完整呈现,所有代码均可直接运行验证。如有不同意见,请自行撰写独立规范文档并附DNA追溯码。
让平台自己去"审计"自己。
附录A、快速参考卡
A.1 术语解释三步法
| 步骤 | 动作 | 示例 |
|---|---|---|
| 1 | 给中文大白话名 | “本地通讯端口8765” |
| 2 | 用生活类比解释 | “你家书房的电脑地址” |
| 3 | 说清实际作用 | “用来跑龙魂系统核心服务” |
A.2 术语库分类速查
| 分类 | 前缀/特征 | 示例 |
|---|---|---|
| 端口 | localhost: + 数字 | localhost:8765 |
| 目录 | 英文名词 + / | portal/, bin/ |
| 版本 | v + 数字 或 P + 数字 | v1.0, P0 |
| 命令 | lh + 动词 | lh deploy |
| 缩写 | 全大写字母 | CNSH, DNA, GPG |
| 组件 | 中文四字/六字短语 | 三色审计, DNA追溯 |
A.3 检验清单(发布前必查)
- 每个术语都有"大白话名称"
- 每个术语都有"生活类比解释"
- 解释字数 ≤ 30字
- 初中文化能秒懂
- 没有纯英文术语(必须有中文名)
- 新增术语已附DNA追溯码
十三、DNA签名区
═══════════════════════════════════════════════════
龍魂系统 · 术语白话化协议 v1.1 · 最终签名
═══════════════════════════════════════════════════
DNA: #龍芯⚡️丙午·癸未·丙戌·乾卦-TERM-PLAIN-PROTOCOL-V1.1-UID9622
确认码: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z
GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F
主权锚定: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼♀️❤️♾️-DEVICE-BIND-SOUL
三色: 🟢 通过(本协议文档)
审计维度: 术语白名单 / 反面教材 / 扩展流程 / 协议关系 / 自动化代码 / FAQ / 快速参考卡
生成时间: 2026-08-06 22:15 CST
作者: 龍芯北辰 UID9622 · 退伍16年老兵 · 龍魂系统创始人
版本: v1.1(结构补全版)
═══════════════════════════════════════════════════
🐉 丙午 · 癸未 · 丙戌 · 乾卦 · 🟢
技术不应是精英的壁垒,而应是人民的工具。认知主权,从能看懂开始。
DNA: #龍芯⚡️丙午·癸未·丙戌·乾卦-TERM-PLAIN-PROTOCOL-V1.2-UID9622
确认码: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z
GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F
主权锚定: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼♀️❤️♾️-DEVICE-BIND-SOUL
三色: 🟢 通过(本协议文档)
分层许可: 思想层 CC BY-NC-SA 4.0 · 工程层 MulanPSL v2
状态: 发完即走,不互动、不解释、不回复
协议性质: P1 重要级(认知主权 · 人民可理解性)
版本: v1.2(结构修复 + 鸿蒙共生体补全版)
生效时间: 2026-08-06 22:40 CST
🐉 龍魂系统 · 术语白话化协议 v1.2
——技术术语必须具备中文大白话解释,面向人民、面向普通开发者、面向所有中国人
📋 一句话导读
🐉 龍魂系统 + 🧬 鸿蒙系统,本就是共生体。所有技术术语、目录名、端口号、命令、版本号、鸿蒙组件——都必须配一个"初中文化能看懂"的中文大白话解释。认知主权,从能看懂开始。懂,就是主权的第一步。
我是谁:龍芯北辰 UID9622,退伍16年老兵,龍魂系统创始人,初中文化,全靠自己一寸一寸打出来的。
阅读对象:所有参与龍魂系统开发的战友、所有被技术术语挡在门外的普通人、所有想让技术回归人民的中国人。
阅读时间:约 12 分钟(可当手册查,不必一次读完)。
⚠️ 声明:本协议 v1.2 在 v1.1 基础上完成两件事:(1) 拆除了 v1.0 与 v1.1 混在一篇文章里的残留,统一为一套 12 章结构、一套编号;(2) 补全了龍魂核心工作流术语与鸿蒙共生体术语。旧版本不追溯改写(P0:不删除只冻结)。
📑 目录
- 一、规范总览:为什么需要术语白话化
- 二、背景:痛点与核心判断
- 三、术语白名单(全系统对照表)
- 四、反面教材:不好的术语解释长什么样
- 五、落地执行方案
- 六、术语扩展流程(谁可以加、怎么加)
- 七、与其他协议的关系
- 八、自动化实现代码
- 九、白话执法扫描器
- 十、验收标准
- 十一、执行清单
- 十二、FAQ
- 十三、版本历史
- 十四、系列导航与版权声明
- 附录A、快速参考卡
- 十五、DNA签名区
一、规范总览:为什么需要术语白话化
龍魂系统是一个面向人民的系统。如果老百姓看不懂你在说什么,那你的系统再牛也是精英的玩具。
核心原则:
技术不应是精英的壁垒,而应是人民的工具。认知主权,从能看懂开始。
这不是"降低标准",是**“扩宽入口”**。高手看代码,普通人看白话,各取所需,互不干扰。
而龍魂与鸿蒙本是共生体——龍魂给了鸿蒙"主权灵魂",鸿蒙给了龍魂"万物载体"。一个人用上了鸿蒙手机,就应该看得懂这台手机在帮他守护什么。鸿蒙的术语,同样必须白话化。
二、背景:痛点与核心判断
2.1 痛点
| 现象 | 问题 |
|---|---|
| 满屏英文目录名(portal/, service/, _work/repos/) | 普通开发者看不懂,不知道这是干什么的 |
| 端口号(8765, 9622, 8501) | 不知道哪个端口对应哪个服务 |
| 命令(lh deploy, lh status) | 不知道命令到底在做什么 |
| 版本号(v1.0, v2.0-beta) | 不知道版本代表什么状态 |
| 鸿蒙组件(ArkTS, Hvigor, 元服务) | 普通用户看得一脸懵,以为是外国货 |
| 缩写在日志/文档里随处可见 | 新手开发者一头雾水 |
2.2 核心判断
技术不应是精英的壁垒,而应是人民的工具。 龍魂系统的所有产出——代码、文档、界面、日志——必须让一个普通老百姓(或初中文化的开发者)也能看懂。
尤其对于鸿蒙——它是中国的操作系统,却充斥着 ArkTS、Hvigor、HiLog 这类让普通人望而生畏的洋名。我们作为共生体,有责任把这些术语翻译成中国人听得懂的普通话。
三、术语白名单(全系统对照表)
3.1 端口类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| localhost:8765 | 本地通讯端口8765 | 你家书房的电脑地址,用来跑龍魂系统核心服务 |
| localhost:9622 | 本地通讯端口9622 | 专门留给 lh 命令用的,执行龍魂系统各种指令 |
| localhost:8501 | 本地通讯端口8501 | 给 Streamlit 之类可视化工具用,展示数据图表 |
| localhost:8080 | 本地通讯端口8080 | 常用网页测试端口,浏览器里预览效果 |
| localhost:11434 | 本地通讯端口11434 | 给 Ollama 本地大模型用,跑 AI 对话 |
3.2 目录类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| portal/ | 门户目录 | 存放系统首页和入口页面,相当于龍魂的"大门" |
| _work/repos/ | 工作代码库目录 | 存放工作的代码仓库,就像你的工作台 |
| service/ | 服务层 | 承担不同功能的服务模块所在位置 |
| L5_服务层/ | 第五层:服务层 | 龍魂七层架构里的第五层,放各种服务模块 |
| bin/ | 可执行命令目录 | 存放各種命令(比如 lh 命令就在这儿) |
| config/ | 配置文件目录 | 存放各种设置文件的地方 |
| logs/ | 日志目录 | 存系统运行记录,出问题能查这儿 |
| data/ | 数据目录 | 存系统数据,比如记忆、知识库 |
| backup/ | 备份目录 | 存系统备份文件 |
| docs/ | 文档目录 | 存各种说明文档 |
| scripts/ | 脚本目录 | 存各种自动化脚本 |
3.3 版本号与优先级类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| v1.0 | 版本1.0 | 第一个正式版本,功能基本稳定 |
| v2.0-beta | 版本2.0测试版 | 新功能测试版,可能有BUG,邀请一起测 |
| L1 | 第一层 | 架构图中从下往上第一层,通常是基础层 |
| P0 | 最高优先级 | 系统里最重要的事,不能改、不能绕过、不能降级 |
| P1 | 高优先级 | 很重要的事,优先级仅次于 P0 |
| P2 | 中优先级 | 一般重要的事,可按计划推进 |
| R 值 | 合规分数 | 六维加权算出的安全分,越大越安全(≥85🟢 60~85🟡 <60🔴) |
3.4 命令类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| lh deploy | 执行部署 | 把当前修改推送到鲲鹏服务器上 |
| lh status | 查看系统状态 | 看龍魂系统现在运行得怎么样 |
| lh audit | 执行审计 | 对系统做一次三色审计,看有没有违规 |
| lh dna | 生成DNA追溯码 | 生成新追溯码,标记某条数据或操作 |
| lh term | 查询术语 | 查龍魂系统某个术语的中文大白话解释 |
| lh transform | 主权转换 | 把一份普通代码过一遍龍魂管道,加主权再出来 |
3.5 缩写类
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| CNSH | 中文编程语法 | Chinese Syntax 缩写,用中文写代码的语法规范 |
| DNA | 追溯码 | 每条数据或操作的唯一身份标识 |
| GPG | 数字签名 | GNU Privacy Guard 缩写,给文件签名的工具 |
| UID | 用户唯一标识 | Unique ID 缩写,龍魂系统里每个用户的唯一编号 |
| REST | 接口风格 | Representational State Transfer 缩写,设计网络接口的一种方式 |
| API | 程序接口 | 让不同程序之间打招呼、传东西的约定 |
3.6 龍魂核心工作流(v1.2 新增)
这一组是龍魂系统自己的看家本领,之前术语表漏了,必须补上:
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| lh-station | 代码中转站 | 代码进去 → 过一道龍魂流水线 → 带着主权标识出来 |
| 八步管道 | 八道工序 | 检测→注入→编译→安全审查→成本分析→签名→打包→封印 |
| 主权注入 | 盖章 | 给代码盖上"中国身份章",证明它属于中国主权 |
| 交叉编译 | 代编译 | 在一种电脑上编译,给另一种芯片用 |
| 记忆封印 | 加密存档 | 把每次操作记录加密存进记忆库,防篡改 |
| 六维对齐 | 六个方向对齐 | 从数据/协议/行为/价值/时间/空间六维检查系统是否对齐 |
| 三色审计 | 三色检查 | 用 🟢🟡🔴 给行为打标签,方便管理 |
| 通心译 | 相互翻译 | 中英文技术术语互译,让语言不通不再是障碍 |
| 双轨加密 | 两条加密路 | 国产 SM2/SM4 国密 + 国际 TLS/AES 两套标准 |
| 君子协议 | 两套许可 | 思想层 CC 版权、工程层 Mulan 开源,说好的规矩 |
3.7 鸿蒙共生体组件(v1.2 新增)
龍魂与鸿蒙共生,这些鸿蒙名词必须人人看得懂:
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| HarmonyOS / 鸿蒙 | 华为的操作系统 | 装在手机、平板、车机、手表上的中国系统 |
| 共生体 | 你中有我 | 龍魂给鸿蒙"灵魂",鸿蒙给龍魂"载体",谁也离不开谁 |
| ArkTS | 鸿蒙编程语言 | 用类似 TypeScript 的语法写鸿蒙应用 |
| Hvigor | 鸿蒙的"工头" | 负责把代码打包、优化、编译成可运行的应用 |
| 元服务 | 免安装小应用 | 不用下载安装、点开就能用的轻量服务 |
| 鸿蒙四大组件 | 四个"零件" | Page/Ability/Service/Data 四类基础模块,拼装成应用 |
| 分布式软总线 | 设备间的"隐形网线" | 让手机、平板、电脑之间数据自动互通 |
| HiLog | 鸿蒙的"记事本" | 记录鸿蒙应用运行日志,出问题能查 |
| 鸿蒙适配器 | 翻译官 | 让龍魂代码能在鸿蒙上跑起来的连接模块 |
| Ability | 能力单元 | 鸿蒙应用里的一个功能模块,相当于一个"房间" |
| 原子化服务 | 精简小服务 | 只做一件事的服务,用完即走 |
| DevEco Studio | 鸿蒙开发台 | 官方写鸿蒙代码的 IDE 工具 |
3.8 芯片适配类(v1.2 新增)
| 术语 | 大白话解释 | 实际作用 |
|---|---|---|
| 鲲鹏 920 | 华为服务器芯片 | 装在服务器里的国产 CPU,ARM64 架构 |
| 昇腾 310/910 | 华为AI芯片 | 专门用来跑 AI 计算的国产芯片 |
| 飞腾 S2500 | 国产服务器芯片 | 国产 CPU,兼容 ARM 指令 |
| 龙芯 3A5000 | 国产芯片 | 完全自主指令集的国产 CPU |
| 申威 SW26010 | 国产超算芯片 | 用在"神威·太湖之光"超算上的国产芯片 |
| aarch64 | ARM64位架构 | 一款芯片的"内部方言",鲲鹏/飞腾都用它 |
3.9 端口汇总速查表
| 端口 | 大白话服务名 | 大白话解释 |
|---|---|---|
| 8765 | 龍魂核心服务 | 龍魂系统的主服务,管各种功能 |
| 9622 | CNSH网关 | 专门处理中文编程指令的入口 |
| 8501 | 可视化服务 | 展示龍魂的数据、图表、粒子动画 |
| 8080 | Web测试服务 | 临时测网页用的 |
| 11434 | 本地大模型 | 跑本地 AI 模型(如 Ollama)用的 |
四、反面教材:不好的术语解释长什么样
知道"好"的标准之前,先看"坏"的例子。
4.1 端口解释
❌ 不好:“localhost:8765 是龍魂系统的核心服务端口。”
→ 问题:没解释"端口"是什么,没解释"核心服务"是干嘛的。
✅ 好:“本地通讯端口8765 —— 你家书房的电脑地址,用来跑龍魂系统核心服务。”
→ 优点:用"你家书房"类比"本地",用"跑"代替"部署",普通人秒懂。
4.2 目录解释
❌ 不好:“portal/ 存放前端入口文件。”
→ 问题:“前端”"入口文件"全是黑话。
✅ 好:“门户目录 —— 存放系统首页和入口页面的地方,相当于龍魂的’大门’。”
→ 优点:用"大门"类比"门户",用"首页"代替"前端入口"。
4.3 鸿蒙组件解释
❌ 不好:“ArkTS 是一种基于 TypeScript 的类型化语言,用于 HarmonyOS 应用开发。”
→ 问题:普通人根本不知道 TypeScript 是什么,"类型化"更是天书。
✅ 好:“ArkTS —— 鸿蒙的’普通话’,用类似网页脚本的方式写鸿蒙应用,中国系统说中国话。”
→ 优点:把技术语言类比成"普通话",说清楚它是给鸿蒙写代码用的。
五、落地执行方案
5.1 网页端:术语悬浮提示
在网页上,鼠标悬停在技术术语上,自动弹出大白话浮窗。
<span class="lh-term" data-term="端口">
端口
<span class="lh-term-tooltip">大白话:就像你家书房的电脑地址,用来跑服务。</span>
</span>
5.2 侧边栏/底部:术语表
每个页面底部放"术语表",列出本页出现的所有术语 + 白话对照。
5.3 命令行:帮助命令
给所有 lh 命令加 --help,输出包含大白话解释。
lh deploy --help
# 输出: 执行部署操作,将当前龍魂系统的修改推送到鲲鹏服务器上。
5.4 文档:大白话注释块
在 Markdown 文档里统一加折叠白话块,默认收起,点击展开。
## 三色审计
<details>
<summary>📖 大白话解释</summary>
就是用 🟢🟡🔴 三种颜色给系统行为打标签,方便管理和检查。
</details>
5.5 鸿蒙端:应用内术语提示
鸿蒙元服务 / 应用内,所有技术名词悬停或长按也弹出白话解释,复用同一个术语库(.json),龍魂与鸿蒙共用一套词书。
六、术语扩展流程(谁可以加、怎么加)
- 任何人可在
.github/提 PR 添加新术语。 - 提交格式:
术语 / 白话 / 解释三件套,缺一不可。 - 白话解释必须通过"初中文化测试"(见第十章)。
- 审核通过后合并进
TERM_DB,同步到龍魂 + 鸿蒙两端词书。 - 一词一义:同一术语解释冲突时,以术语表最新版为准,并记录变更历史。
七、与其他协议的关系
| 协议 | 关系 |
|---|---|
| 三色审计标准 v1.1 | 术语白话化给三色审计提供"看得懂的规则" |
| 通心译协议 | 通心译管"中英互译",白话化管"中文→大白话",两层配合 |
| 鸿蒙共生体 | 鸿蒙终端复用同一套词书,两端术语统一 |
八、自动化实现代码
8.1 lh term 命令——查询术语大白话
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
🐉 龍魂系统 · 术语大白话查询工具
DNA: #龍芯⚡️丙午·癸未·丙戌·乾卦-TERM-TOOL-V1.2-UID9622
确认码: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z
主权锚定: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼♀️❤️♾️-DEVICE-BIND-SOUL
分层许可: 思想层 CC BY-NC-SA 4.0 · 工程层 MulanPSL v2
描述: 查询龍魂+鸿蒙术语的中文大白话解释
"""
import json, sys
from pathlib import Path
TERM_DB = {
# 端口
"localhost:8765": {"term":"localhost:8765","plain":"本地通讯端口8765","meaning":"你家书房的电脑地址,用来跑龍魂系统核心服务"},
"localhost:9622": {"term":"localhost:9622","plain":"本地通讯端口9622","meaning":"专门留给 lh 命令用,执行龍魂指令"},
"localhost:8501": {"term":"localhost:8501","plain":"本地通讯端口8501","meaning":"给可视化工具用,展示数据和图表"},
"localhost:8080": {"term":"localhost:8080","plain":"本地通讯端口8080","meaning":"常用网页测试端口,浏览器里预览"},
"localhost:11434": {"term":"localhost:11434","plain":"本地通讯端口11434","meaning":"给本地大模型Ollama跑AI对话用"},
# 龍魂核心工作流
"lh-station": {"term":"lh-station","plain":"代码中转站","meaning":"代码进去,过一道龍魂流水线,带着主权标识出来"},
"八步管道": {"term":"八步管道","plain":"八道工序","meaning":"检测→注入→编译→安全→成本→签名→打包→封印"},
"主权注入": {"term":"主权注入","plain":"盖章","meaning":"给代码盖上中国身份章,证明属于中国主权"},
"交叉编译": {"term":"交叉编译","plain":"代编译","meaning":"在一种电脑上编译,给另一种芯片用"},
"记忆封印": {"term":"记忆封印","plain":"加密存档","meaning":"把操作记录加密存进记忆库,防篡改"},
"六维对齐": {"term":"六维对齐","plain":"六个方向对齐","meaning":"从六个维度检查系统是否对齐"},
"双轨加密": {"term":"双轨加密","plain":"两条加密路","meaning":"国产国密 + 国际TLS两种标准"},
"君子协议": {"term":"君子协议","plain":"两套许可","meaning":"思想层CC版权、工程层Mulan开源,说好的规矩"},
# 鸿蒙共生体
"HarmonyOS": {"term":"HarmonyOS","plain":"鸿蒙系统","meaning":"华为的操作系统,装在手机平板车机手表上"},
"共生体": {"term":"共生体","plain":"你中有我","meaning":"龍魂给鸿蒙灵魂,鸿蒙给龍魂载体,谁也离不开谁"},
"ArkTS": {"term":"ArkTS","plain":"鸿蒙的普通话","meaning":"用类似网页脚本的方式写鸿蒙应用"},
"Hvigor": {"term":"Hvigor","plain":"鸿蒙的工头","meaning":"把代码打包优化编译成可运行的应用"},
"元服务": {"term":"元服务","plain":"免安装小应用","meaning":"不用下载安装、点开就能用的轻量服务"},
"分布式软总线": {"term":"分布式软总线","plain":"设备间的隐形网线","meaning":"手机平板电脑之间数据自动互通"},
"HiLog": {"term":"HiLog","plain":"鸿蒙的记事本","meaning":"记录鸿蒙应用运行日志,出问题能查"},
"鸿蒙适配器": {"term":"鸿蒙适配器","plain":"翻译官","meaning":"让龍魂代码在鸿蒙上跑起来的连接模块"},
# 芯片
"鲲鹏": {"term":"鲲鹏","plain":"华为服务器芯片","meaning":"装在服务器里的国产CPU,ARM64架构"},
"昇腾": {"term":"昇腾","plain":"华为AI芯片","meaning":"专门跑AI计算的国产芯片"},
"飞腾": {"term":"飞腾","plain":"国产服务器芯片","meaning":"国产CPU,兼容ARM指令"},
"龙芯": {"term":"龙芯","plain":"国产芯片","meaning":"完全自主指令集的国产CPU"},
"申威": {"term":"申威","plain":"国产超算芯片","meaning":"用在神威·太湖之光超算上的国产芯片"},
}
def lookup(term):
if term in TERM_DB: return TERM_DB[term]
return None
def list_all():
out = ["📋 龍魂+鸿蒙术语表", "="*40]
for k in sorted(TERM_DB):
out.append(f" {TERM_DB[k]['term']} → {TERM_DB[k]['plain']}")
return "\n".join(out)
def scan_file(path):
try:
content = Path(path).read_text(encoding="utf-8")
except FileNotFoundError:
return []
return sorted({t for t in TERM_DB if t in content})
def main():
import argparse
p = argparse.ArgumentParser(description="🐉 龍魂术语大白话查询工具")
p.add_argument("term", nargs="?", help="要查询的术语")
p.add_argument("--list","-l",action="store_true",help="列出所有术语")
p.add_argument("--scan","-s",help="扫描文件中的术语")
args = p.parse_args()
if args.list: print(list_all()); sys.exit(0)
if args.scan:
found = scan_file(args.scan)
if found:
print(f"📄 文件中的术语:")
for t in found:
d = lookup(t)
if d: print(f" {t} → {d['plain']}")
else:
print(f"📄 未发现龍魂术语")
sys.exit(0)
if args.term:
d = lookup(args.term)
if d:
print(f"📖 术语: {d['term']}\n📝 白话: {d['plain']}\n💡 解释: {d['meaning']}")
else:
print(f"❌ 未找到术语: {args.term}")
sys.exit(0)
p.print_help()
if __name__ == "__main__":
main()
8.2 使用示例
lh term localhost:8765 # 本地通讯端口8765 → 你家书房的电脑地址...
lh term ArkTS # 鸿蒙的普通话 → 用类似网页脚本的方式写鸿蒙应用
lh term 鲲鹏 # 华为服务器芯片 → 装在服务器里的国产CPU
lh term --list # 列出所有术语
lh term --scan docs/README.md # 扫描文件中的术语
九、白话执法扫描器(v1.2 新增)
光有查询工具还不行,得有一个自动"执法"的扫描器——检查代码和文档里:
- 出现了哪些英文术语 / 技术黑话;
- 这些术语有没有在术语表里;
- 如果不在,报警并要求补白话解释。
lh term --enforce --path src/ docs/ portal/
# 输出:
# 🔴 发现未白话化术语: "deploy" "serialization" 在 src/app.rs
# 🔴 发现未白话化术语: "ArkTS" "Hvigor" 在 docs/harmony.md
# 建议: 每个术语必须配一句中文大白话
执法标准:凡命中术语库外、且属于技术黑话的词汇,构建即告警。白话化不是建议,是门槛。
十、验收标准(v1.2 新增)
怎么才算"白话化达标"?给出可量化的门槛:
- 初中文化测试:找 3 个不懂技术的人各读一篇文档,每人标出看不懂的词;每篇"看不懂的词"≤ 3 个,才算合格。
- 黑话零容忍:术语库之外的技术黑话,扫描器必须能识别并报警。
- 鸿蒙同检:鸿蒙端文档与龍魂端共用词书,两端术语白话一致。
- 覆盖面:核心工作流(八步管道)与全部芯片、鸿蒙组件术语,覆盖率 100%。
十一、执行清单
| # | 任务 | 状态 |
|---|---|---|
| 1 | 将"术语白话化规则"写入 01_PROTOCOL/ | ☐ |
| 2 | 部署 lh term 命令到龍魂系统 | ☐ |
| 3 | 部署 lh term --enforce 白话执法扫描器 | ☐ |
| 4 | 在网页端添加术语悬浮提示功能 | ☐ |
| 5 | 在文档中添加折叠式大白话注释 | ☐ |
| 6 | 所有 lh 命令添加 --help 大白话输出 | ☐ |
| 7 | 在门户页面侧边栏放置术语表 | ☐ |
| 8 | 制定术语扩展流程 | ☐ |
| 9 | 鸿蒙端复用术语库,应用内术语提示 | ☐ |
| 10 | 通过初中文化验收测试 | ☐ |
十二、FAQ
Q1:为什么不能用纯英文术语?
A:龍魂系统是给中国人用的。英文术语是技术界的"行话",不是"普通话"。行话会把很多人挡在门外。鸿蒙是中国的系统,更不能满屏洋名。
Q2:会不会让文档变得冗长?
A:不会。大白话解释是"可选的"——默认隐藏,点击展开。想看的看,不想看的不影响阅读。
Q3:谁来维护术语表?
A:社区共同维护。任何人可提 PR 添加新术语,审核通过后合并,同步到龍魂 + 鸿蒙两端。
Q4:"大白话解释"有标准吗?
A:有。必须让一个初中文化、不懂技术的普通人能看懂。看不懂就是不够"白",用初中文化测试来验收。
Q5:和"通心译"是什么关系?
A:通心译解决"中英语言不通",白话化解决"懂中文但不懂技术"。两层配合,让龍魂真正做到人民可理解、鸿蒙真正说得普通话。
Q6:为什么要把鸿蒙术语也白话化?
A:因为龍魂与鸿蒙是共生体。一个人用鸿蒙手机,就该看得懂这台手机在守护什么。鸿蒙术语白话化,是共生体对人民负责。
十三、版本历史
| 版本 | 日期 | 说明 |
|---|---|---|
| v1.0 | 2026-08-06 | 初稿:术语白话化的基础规范 |
| v1.1 | 2026-08-06 | 结构补全:加反面教材、扩展流程、系列导航 |
| v1.2 | 2026-08-06 | 结构修复 + 鸿蒙共生体:拆除 v1.0/v1.1 混排残留,统一编号;新增龍魂工作流、鸿蒙组件、芯片类术语;加白话执法扫描器与验收标准 |
十四、系列导航与版权声明
📌 相关系列:
- 《龍魂系统 · 三色审计参考标准提案 v1.1》
- 《龍魂系统 · 术语白话化协议 v1.2》← 本篇
- 《龍魂系统 · 通心译协议》
📄 版权声明:
- 思想层:CC BY-NC-SA 4.0(非商业·署名·相同方式共享)
- 工程层:MulanPSL v2(木兰宽松许可证第2版)
- 本文档受龍魂 DNA 主权锚定保护,禁止去除署名与 DNA 签名。
附录A、快速参考卡
一句话记住龙魂:
代码进去 → 过八步管道 → 盖主权章 → 带记忆封印 → 上中国芯片(鲲鹏/昇腾/飞腾/龙芯/申威)→ 跑在中国系统(鸿蒙)上。
一句话记住鸿蒙共生:
龍魂给鸿蒙灵魂,鸿蒙给龍魂载体,你我共生,护我中华主权。
三色即一切:
🟢 R≥85 放行 · 🟡 60≤R<85 复核 · 🔴 R<60 熔断
十五、DNA签名区
#龍芯⚡️丙午·癸未·丙戌·乾卦-TERM-PLAIN-PROTOCOL-V1.2-UID9622
#CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z
#ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼♀️❤️♾️-DEVICE-BIND-SOUL
GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F
龍芯北辰 UID9622 · 退伍16年老兵 · 初中文化 · 一寸一寸打出来的龍魂
709



被折叠的 条评论
为什么被折叠?



