Document workspace ownership, resource semantics and agent lifecycle

This commit is contained in:
2026-10-09 18:06:25 +08:00
parent f7526ab2a0
commit 52f497671e
31 changed files with 748 additions and 232 deletions
+6 -5
View File
@@ -7,24 +7,25 @@
| UI | 函数返回的可渲染值、组件及展示效果 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md)、[UI 组件](../guide/12-ui-components.md) |
| 业务逻辑 | 函数、结果、调用组合及业务效果 | [函数与调用](../guide/09-functions-and-calls.md) |
| 数据结构与访问 | class、共享类型、读取与字段使用 | [类型与类](../guide/07-types-and-classes.md)、[数据读取](../guide/10-data-access.md) |
| Agent | 后续的能力、上下文、任务及行为模型 | [规范状态](specification-status.md#agent) |
| 媒体与空间内容 | 图片、视频、音频和 GIS 资源,统一导入表示与导出编码 | [资源、类型与类](../guide/07-types-and-classes.md) |
| Agent | agent 声明、工具实现、记忆、状态及运行控制 | [Agent](../guide/13-agents.md) |
## 跨领域调用
普通调用是共有语义。UI、业务逻辑或后续 Agent 代码可以在允许访问的前提下使用相应逻辑,而不为跨领域调用建立独立的 RPC 协议声明。
普通调用是共有语义。UI、业务逻辑或 agent 代码可以在允许访问的前提下使用相应逻辑,而不为跨领域调用建立独立的 RPC 协议声明。
类似 RPC 的体验指“调用逻辑并取得结果”。输入、输出、依赖和失败需要在语言中明确,传输客户端、连接方式和缓存由系统承担。
## 领域与 namespace
`alice:shop.ui`、`alice:shop.pricing`、`alice:shop.data` 和 `alice:shop.agents` 是组织示例,不是强制目录或具有特殊行为的保留路径。
`atelier:shop.ui`、`atelier:shop.pricing`、`atelier:shop.data` 和 `atelier:shop.agents` 是 workspace 内的组织示例,不是强制目录或具有特殊行为的保留路径。
namespace 的名称不自动决定逻辑在何处执行。一个 namespace 也不必只包含一种声明类别。
## Agent 范围
Agent 尚无具体源码语法。需要独立定义的内容包括能力、工具、上下文、任务、生命周期、权限,以及确定性代码和模型驱动行为的边界。
agent 是语言资源声明,可以在内部实现函数,也可以引用外部函数;其成员共用 Endorphin 的变量、类型和调用模型,并具有 agent 内部作用域及运行关联。
本书不为尚未定义的领域提供虚构关键字或 API;其扩展仍应共用语言已有的组织与调用模型。
工具、记忆、状态、路由、人工中断和上下文管理的职责见[Agent](../guide/13-agents.md)。声明骨架为提案,具体成员关联、任务入口、模型配置和权限语法仍按[规范状态](specification-status.md#agent)记录。
[目录](../README.md)
+4 -2
View File
@@ -4,7 +4,7 @@
## 独立代码段
代码分别存储为独立代码段,每段关联一个唯一用户和至少一级 namespace。S3 承担代码内容的存储职责,索引维护 namespace key 与代码段的成员关系。
代码分别存储为独立代码段,每段关联一个归属 workspace 和至少一级 namespace。S3 承担代码内容的存储职责,索引维护 namespace key 与代码段的成员关系;编写或修改代码的用户身份另行记录。
源码文件不作为代码身份或 module 边界。本书中的 Markdown 文件是文档章节,不对应语言中的源码组织单位。
@@ -31,7 +31,9 @@ S3 对象键不是语言中的 namespace key。bucket 名、对象键和存储
## namespace 制
namespace 同时表达归属与查找位置,使业务函数、类型、界面逻辑和后续 Agent 代码遵循一致的组织模型。第一级与后续层级具有相同语义。
namespace 同时表达归属与查找位置,使业务函数、类型、界面逻辑和 agent 定义遵循一致的组织模型。第一级与后续层级具有相同语义。
基础内容也纳入资源归属方向,但本附录的 S3 代码段约定不自动规定媒体、GIS 数据、对象或 agent 记忆的存储后端。代码视图与完整资源集合的区别见[namespace](../guide/03-namespaces.md)。
这一组织选择不自动决定检查边界、执行位置、权限继承或业务数据存储。相关语义需要由各自规则定义,而不是从 S3 物理布局推导。
+25 -4
View File
@@ -21,27 +21,46 @@
```ebnf
program = { use-decl }, declaration, { declaration }, EOF ;
declaration = class-decl | function-decl ;
declaration = class-decl | function-decl | agent-decl ;
use-decl = "use", namespace-key ;
namespace-key = user-handle, ":", namespace-path ;
namespace-key = workspace-handle, ":", namespace-path ;
namespace-path = identifier, { ".", identifier } ;
```
user-handle 是系统认可的唯一用户名,由身份规则提供,不等同于源码 identifier。代码自身的归属通过外部上下文提供,程序文法中没有自身 namespace 声明。
workspace-handle 是系统认可的唯一 workspace 名称,由平台命名规则提供,不等同于源码 identifier 或操作用户的登录标识。代码自身的归属通过外部上下文提供,程序文法中没有自身 namespace 声明。
相关说明:[namespace](../guide/03-namespaces.md)、[程序结构与导入](../guide/04-program-structure.md)。
角色和 r/w/x 是平台授权模型,不增加 use 参数、源码权限位或逐函数的权限声明。代码可视域的具体语法另行定义,见[用户身份与 workspace 权限](../guide/02-user-identity.md)。
## 类与类型
```ebnf
class-decl = "class", identifier, "{", { field-decl }, "}" ;
class-decl = "class", identifier, "{", { class-member }, "}" ;
class-member = field-decl | function-decl ;
field-decl = identifier, ":", type-name ;
type-name = identifier ;
```
相关说明:[类型与类](../guide/07-types-and-classes.md)。
成员函数沿用 function 声明骨架;接收者、实例关联和类内名称查找未由这条产生式确定。
## Agent 声明骨架
```ebnf
agent-decl = "agent", identifier, "{", { agent-member }, "}" ;
agent-member = field-decl | binding | function-decl
| class-decl | agent-decl ;
```
此骨架是复用共有成员的语法提案,不是完整 agent 文法。工具关联、memory、state、路由、中断和上下文处理的专门关系尚未定义,不将这些职责名自动列为关键字或固定字段。成员中的表达式通过绑定或函数体出现,不能从允许共有成员推导任意语句可出现在任意位置。
agent 和 class 内部的名称查找、可见性、成员初始化及实例关联另行定义。骨架能表达成员函数,但未决定工具暴露范围;binding 仍只说明初始绑定,不决定重新赋值或共享状态。
相关说明:[Agent](../guide/13-agents.md)、[规范状态](specification-status.md#agent)。
## 函数与绑定
```ebnf
@@ -57,6 +76,8 @@ return-stmt = "return", expression ;
本基本函数体文法只包含绑定和末尾返回,不覆盖完整控制流或独立表达式语句。
变量可以改变引用目标的语言模型已经确定,但可变变量声明、重新赋值和 let 可重绑性尚未确定,故不在此添加赋值产生式。
相关说明:[表达式与绑定](../guide/08-expressions-and-bindings.md)、[函数与调用](../guide/09-functions-and-calls.md)。
## 表达式
+24 -9
View File
@@ -3,24 +3,39 @@
| 术语 | 定义 | 详见 |
| --- | --- | --- |
| Endorphin | 用统一声明与调用模型描述前后端应用的云原生编程语言 | [语言概览](../guide/01-overview.md) |
| 用户名 / handle | 在系统内唯一标识用户并参与代码定位的名称 | [用户身份](../guide/02-user-identity.md) |
| 显示名 | 用于界面展示、可重复的姓名或昵称 | [用户身份](../guide/02-user-identity.md) |
| 归属用户 | namespace key 指定的代码所属用户 | [用户身份](../guide/02-user-identity.md) |
| 用户账号 | 用于登录、判断操作身份与记录作者的用户身份;不作为资源 key 前缀 | [用户身份与 workspace 权限](../guide/02-user-identity.md) |
| Workspace 显示名 | 用于界面展示、可重复的 workspace 名称 | [Workspace handle 与显示名](../guide/02-user-identity.md#21-workspace-handle-与显示名) |
| 归属 workspace | namespace key 指定的资源所属 workspace | [归属与操作身份](../guide/02-user-identity.md#24-归属-workspace操作用户与作者) |
| 操作用户 | 发起本次读取、修改或执行的身份 | [用户身份](../guide/02-user-identity.md) |
| namespace | 代码归属、组织与检索的单位 | [namespace](../guide/03-namespaces.md) |
| namespace key | 用户名与非空 namespace 路径组成的定位标识 | [namespace](../guide/03-namespaces.md) |
| workspace | 整体资源归属、协作与授权边界,内部通过 namespace 组织资源 | [Workspace 与平台用户系统](../guide/02-user-identity.md#25-workspace-与平台用户系统) |
| workspace handle | 在平台内唯一定位 workspace 的名称,作为 key 冒号前的部分 | [Workspace handle 与显示名](../guide/02-user-identity.md#21-workspace-handle-与显示名) |
| r/w/x | 读取、编辑资源与使用程序的操作类别;业务写入不自动要求调用者拥有编辑权 | [操作分工](../guide/02-user-identity.md#26-rwx-的操作分工) |
| workspace 角色 | 在 workspace 范围授予常用权限组合与管理能力的成员角色 | [Workspace 角色与授权](../guide/02-user-identity.md#27-workspace-角色与授权) |
| 代码可视域 | 声明可在什么程序位置被引用的范围,区别于平台用户权限 | [平台权限与代码可视域](../guide/02-user-identity.md#29-平台权限与代码可视域) |
| namespace | 资源归属、组织与检索的单位;代码资源形成可见代码视图 | [namespace](../guide/03-namespaces.md) |
| namespace key | workspace handle 与非空 namespace 路径组成的定位标识 | [namespace](../guide/03-namespaces.md) |
| 代码段 | 独立存储、具有明确归属的代码内容单位 | [代码存储与视图](code-storage-and-views.md) |
| 可见代码视图 | 由索引成员关系获得的 namespace 逻辑代码集合 | [代码存储与视图](code-storage-and-views.md) |
| use | 引用完整 namespace key 的声明 | [程序结构与导入](../guide/04-program-structure.md) |
| Preflight | 理解声明、检查程序并建立关联索引的执行准备阶段 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
| inflight | 使用实际输入执行逻辑并产生可观察结果的运行阶段 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
| 类型 | 描述值的结构及其允许用法的定义 | [类型与类](../guide/07-types-and-classes.md) |
| Preflight | 定义准备与检查阶段;定义生命周期覆盖创建、准备、持续可引用、更新与退出 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
| inflight | 实际执行阶段;运行时生命周期覆盖调用、实例、任务及保存的运行状态 | [Preflight 与 inflight](../guide/05-preflight-and-inflight.md) |
| 基础常量资源 | 数值、文本、媒体和 GIS 等不可原地修改的基础内容 | [资源、类型与类](../guide/07-types-and-classes.md#71-类型标注) |
| 统一数值 | 不按整数位宽或浮点编码分型的数值类别;本文暂用 Number 命名 | [资源、类型与类](../guide/07-types-and-classes.md#71-类型标注) |
| 格式归一化 | 接受的媒体和 GIS 格式导入后转写为内部标准格式,导出时再编码 | [资源、类型与类](../guide/07-types-and-classes.md#71-类型标注) |
| 类型 | 描述资源或值的结构及其允许用法的定义 | [资源、类型与类](../guide/07-types-and-classes.md) |
| 类型身份 | 由具体类型声明确定的身份;成员相同不自动使不同声明兼容 | [类型身份与兼容](../guide/07-types-and-classes.md#76-类型身份与兼容) |
| class | 数据结构声明 | [类型与类](../guide/07-types-and-classes.md) |
| class | 组织数据结构、字段和成员函数的声明 | [资源、类型与类](../guide/07-types-and-classes.md) |
| 表达式 | 描述计算并产生值的源码形式 | [表达式与绑定](../guide/08-expressions-and-bindings.md) |
| 绑定 | 将表达式结果关联到局部名称 | [表达式与绑定](../guide/08-expressions-and-bindings.md) |
| 变量 | 可改变目标的资源引用;具体声明和赋值形式待定 | [变量与资源引用](../guide/08-expressions-and-bindings.md#86-变量与资源引用) |
| 函数 | 定义输入、结果和执行逻辑的可调用声明 | [函数与调用](../guide/09-functions-and-calls.md) |
| 数据依赖 | 后续计算需要前一计算结果的关系 | [函数与调用](../guide/09-functions-and-calls.md) |
| agent | 复用共有成员并建立模型驱动执行与状态关联的语言资源声明 | [Agent](../guide/13-agents.md) |
| tool | 关联为模型可选能力的函数,可以是外部引用或内部成员函数 | [Tools 与逻辑实现](../guide/13-agents.md#133-tools-与逻辑实现) |
| memory | 信息保留与恢复的职责,包含会话记忆、检查点和长期记忆 | [Memory 与保存恢复](../guide/13-agents.md#134-memory-与保存恢复) |
| state | 当前业务及执行状态,可用于有限状态机与条件路由 | [State、有限状态机与路由](../guide/13-agents.md#135-state有限状态机与路由) |
| 执行检查点 | 保存恢复任务所需的状态、位置和待处理操作的运行时数据 | [Memory 与保存恢复](../guide/13-agents.md#134-memory-与保存恢复) |
| 人工在环 | 在指定操作前暂停,等待人类确认或修改后再恢复 | [人工在环与中断](../guide/13-agents.md#136-人工在环与中断) |
| 资源访问 | 定位并查看 namespace、声明或结果,或在输入就绪后发起调用的客户端行为 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
| 按类型呈现 | 客户端依据当前资源或结果的类型选择处理方式;顶级类型及契约待定 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
| 可渲染值 | 可由客户端作为界面呈现的结果值;正式类型及构造形式待定 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md) |
+95 -17
View File
@@ -7,18 +7,31 @@
| 主题 | 已确定内容 |
| --- | --- |
| 语言定位 | 前后端共用的云原生编程语言,UI 是应用领域之一 |
| 代码归属 | 每段代码属于唯一用户名和至少一级 namespace |
| 用户身份 | 使用唯一 handle 定位,不用显示名替代 |
| namespace | 各层语义一致;以外部 key 检索,不在正文声明自身归属 |
| key 形式 | `用户名:namespace路径`,冒号分隔用户与路径,点号分隔层级 |
| 资源归属 | 每项独立登记的资源属于一个 workspace 和至少一级 namespace;用户是操作与作者身份 |
| Workspace 命名 | workspace handle 在平台内唯一并参与 key,workspace 显示名可以重复;用户登录标识不作为资源归属前缀 |
| namespace | 各层语义一致;以外部 key 检索,不在正文声明自身归属;函数、class、agent 和独立保存的基础内容共用资源归属体系 |
| key 形式 | `workspace handle:namespace路径`,冒号分隔 workspace 与路径,点号分隔层级 |
| 用户与 workspace | 注册时创建默认个人 workspace,创建用户成为管理员;用户可以参与多个 workspace,workspace 可以包含多个用户 |
| 授权边界 | workspace 整体授权,内部 namespace、class 和函数不各自维护用户访问名单;代码可视域独立处理 |
| 角色基线 | 管理员与 Editor 具有 rwx,管理员另管理成员和授权;Reader 具有读取权,是否附带 x 仍待定 |
| use | 引用完整 namespace,不附加选择性名称列表 |
| 代码组织 | 独立代码段存储在 S3,由索引组装可见代码视图,不采用源码文件 module 制 |
| 数据结构目标 | 用 class 表达共享结构,通过类取得数据的具体形式另行定义 |
| 基础资源 | 数值、文本、图片、视频、音频和 GIS 数据等基础内容作为常量资源;完整类别与类型名另行定义 |
| 数值模型 | 统一数值类别,不区分 int32、float 等机器表示类型;平台选择可保存该数值的表示,允许使用大数并接受性能成本 |
| 媒体与 GIS | 接受的格式导入后转写为各自内部标准格式,导出时再编码;业务代码使用类型化内容,不按输入编码手动解析 buffer |
| 变量模型 | 变量是可改变目标的资源引用,可引用基础常量及高级结构;不要求裸指针和手动内存管理 |
| Agent 声明 | agent 是与 class、function 并列的语言资源,内部复用共有语法并建立成员作用域和运行关联 |
| Agent 职责 | tools 引用外部函数或内部实现;memory、state、条件路由、人工中断和上下文管理纳入语言模型 |
| Agent 编程 | agent 可以实现新逻辑并引用已有函数;提交新定义后须经过 Preflight 才能作为已就绪定义执行 |
| 人工在环 | 高风险操作执行前暂停,等待人类确认或修改意见,并保留恢复所需状态 |
| 类型兼容 | 用户声明的类型按声明身份区分,不仅凭字段或方法相同建立兼容或能力实现关系;不采用结构类型兼容 |
| 调用目标 | 普通逻辑调用表达输入、结果与依赖,系统组织执行 |
| 权限操作分工 | r 读取、w 编辑资源内容或定义、x 使用已定义的程序能力;程序按业务契约产生写入不要求调用者因此成为 Editor;执行不自动授予管理能力 |
| 官方组件 | 官方 UI 组件与用户库内容分别定义 |
| 阶段命名 | 执行准备与检查阶段为 Preflight,运行阶段为 inflight;名称本身不增加源码关键字 |
| 执行方向 | 平台解释执行代码,不要求独立构建步骤或字节码转译;Preflight 检查并建立关联索引 |
| 生命周期 | Preflight 生命周期覆盖定义的创建、检查、持续可引用、更新与退出;inflight 生命周期覆盖实际调用、实例、任务和运行状态的存续 |
| 界面表达 | 普通函数返回可渲染值表达界面,不采用独立 scene 声明或 render 块 |
| 资源访问 | 客户端可查看获准访问的资源,依据当前资源或调用结果的类型选择呈现方式 |
| 函数查看与调用 | 必填参数未就绪时查看函数本身;输入满足调用要求后可调用并呈现结果;执行等待不退回为定义查看 |
@@ -29,25 +42,44 @@
| 提案 | 正文位置 | 说明 |
| --- | --- | --- |
| 词法与字面量 | [第 6 章](../guide/06-lexical-structure.md) | 本书统一采用的标识符、字符串、数字和符号形式 |
| 类字段与类型标注 | [第 7 章](../guide/07-types-and-classes.md) | class 目标已确定,字段和类型体系仍为具体写法提案 |
| 类字段、成员与类型标注 | [第 7 章](../guide/07-types-and-classes.md) | 统一数值暂用 Number,文本沿用 String;类字段与成员函数的具体形式仍为提案 |
| 表达式与 let | [第 8 章](../guide/08-expressions-and-bindings.md) | 基础运算、成员访问与局部绑定 |
| function 与 return | [第 9 章](../guide/09-functions-and-calls.md) | 函数签名、基本函数体与调用组合 |
| Product.get | [第 10 章](../guide/10-data-access.md) | 读取体验提案,不是 class 自动附带的 API |
| 组件效果 | [第 12 章](../guide/12-ui-components.md) | 参数、布局与默认值的效果提案;构造表达式尚未定义 |
| agent 声明骨架 | [第 13 章](../guide/13-agents.md) | agent 语言地位已确定;共有成员骨架为提案,职责关联形式尚未定义 |
程序声明组合与[形式文法](formal-grammar.md)同样属于设计稿。正文中的陈述定义这些提案内部的用法,不将其确定程度提升为最终规范。
## 身份与权限
workspace 是资源归属与整体授权边界,用户负责操作和作者身份。主要定义见[用户身份与 workspace 权限](../guide/02-user-identity.md)。w 表示资源编辑,x 表示使用程序及其契约允许的业务效果。
尚未定义:
- 用户名的字符、长度、大小写、Unicode 归一化及身份范围扩展。
- handle 改名、旧名称复用、历史引用稳定性及账号生命周期。
- 代码的默认公开性、读取与执行权限,以及 namespace 权限继承。
- 协作、Agent 委托、操作身份记录与归属转移。
- 用户的登录标识、认证方式、展示名称及账号生命周期;这些信息不充当资源 key 前缀。
- 资源的默认公开性、匿名访问、读取与执行授权的具体授予方式。
- 操作身份、业务执行能力绑定、Agent 委托、操作记录与归属转移。
- 入口的授权操作范围和业务效果约束;x 不自动提供任意直接资源编辑或管理员能力。
定位信息不构成授权,是这些规则必须保留的边界。
## Workspace 名称与生命周期
workspace 归属、key 前缀和整体授权模型已确定。名称细节、配额及运行授权的具体机制仍需定义。
尚未确定:
- 默认 workspace handle 的生成,以及历史用户名 key 的迁移或兼容规则。
- workspace handle 的字符、大小写、唯一性比较、改名与复用、展示名称及稳定身份。
- workspace 的创建数量上限、计数归属、加入与创建的区别、停用和删除后的额度处理。
- 角色的正式名称、Reader 是否具有 x、仅执行授权的授予形式、公开或匿名访问及成员移除规则。
- 管理员交接、workspace 停用、账号注销后的归属与资源保留,以及管理操作的完整范围。
- 仅具有 x 时的调用接口信息范围,以及程序运行能力与资源编辑权限之间的具体执行机制。
- 角色变更和授权撤销对正在执行、暂停或恢复中的调用、实例与任务的影响。
正文的 atelier、market key 前缀均解释为 workspace handle;alice、bob 仅在成员和作者示意中代表用户。
## 引用与代码视图
尚未定义:
@@ -65,21 +97,50 @@
- 程序入口、空代码视图、客户端访问所用的定位形式与顶层绑定。
- 函数本身的完整类型表达、值形式与查看信息范围。
- 完整基础类型、数值范围、可选值、泛型及类型转换。
- 类构造、方法、默认值、继承和字段可见性。
- 完整类型命名、可选值、泛型及类型转换;基础资源的具体边界见下一节。
- 类构造、成员函数的接收者与实例关联、默认值、继承和字段可见性。
- 显式能力实现、类型兼容与转换关系的声明形式,以及类型推断规则。
- 代码更新和不同版本之间的类型身份比较规则。
- 重复声明、完整控制流、可变性、赋值和作用域细节。
- 重复声明、完整控制流、实例及字段可变性、赋值和作用域细节。
本文简单函数体仅收录 let 与末尾 return,不意味着整门语言只允许这两种语句。
## 基础资源与变量
基础常量、统一数值、格式归一化和变量引用的主要定义见[资源、类型与类](../guide/07-types-and-classes.md#71-类型标注)及[变量与资源引用](../guide/08-expressions-and-bindings.md#86-变量与资源引用)。
尚未定义:
- 基础类型的完整集合与正式名称;Number、String 为本文采用的类型名提案,媒体和 GIS 不补造正式名称。
- 数值精度、舍入、除法、特殊值、算术资源限制和数值相等性;使用大数不自动决定任意实数的精确表示。
- 每类媒体或 GIS 数据的内部标准格式、可接收和可导出的编码,以及精度、元数据、坐标系统和转换规则。
- 非代码资源的注册、导入、导出、成员定位及保存版本的源码或平台接口。
- 可变变量声明、重新赋值、let 可重绑性,以及变量引用的类型表达和可指向范围检查。
- 资源、引用和实例的相等性、别名关系、成员更新,以及常量去重或共享规则。
基础内容不可原地修改,变量可以改变引用目标;这不自动决定高级实例整体不可变,也不自动为所有临时值生成永久 namespace 名称。
## 生命周期与定义更新
主要定义见[Preflight 与 inflight](../guide/05-preflight-and-inflight.md#56-定义与运行时生命周期)。生命周期按定义与运行时实体区分,不能按保存时长区分。
尚未定义:
- 定义创建、更新与退出可用范围的接口,以及已有调用或实例对版本的选择。
- 多定义修改的一致性、协作冲突处理和运行中提交代码的可见时机。
- 定义删除对已有引用、对象和 agent 实例的影响。
- 临时值、不可达值与实例的回收时机,持久保存的数据及记忆的保留、归档与删除规则。
- 运行状态暂停、保存和恢复时引用与版本的一致性。
长期保存的对象、记忆和检查点仍属于 inflight;一次 Preflight 检查结束不终止定义的存续。
## 词法与表达式
尚未定义:
- 完整保留字集合、Unicode 版本与字符类别边界。
- 换行字符、字符串扩展转义、更多字面量和运算符。
- 数值溢出、除法、隐式转换与所有调用参数的求值顺序。
- 数值精度与舍入、除法、隐式转换与所有调用参数的求值顺序;不按固定机器位宽定义数值溢出。
正文中同级二元算术运算的组合顺序属于表达式提案,不规定所有调用的执行顺序。
@@ -115,19 +176,36 @@
保留待讨论:
- 顶级类型的名称、集合,以及界面、数据、代码与媒体的类别边界。
- 完整顶级类型的名称、集合及关系;已确定基础数值、文本、媒体和 GIS 类别,不代表完整类型层次已经确定。
- 顶级类型采用继承、接口、协议或其他机制的关系与声明形式。
- 可渲染类型的契约、普通类型的默认展示方式及自定义呈现。
- 同一资源具有多种呈现能力时的选择规则及未知类型的处理方式。
- 参数填写、默认或可省略参数、平台提供参数与访问触发调用的具体规则。
- 资源查看、显式调用、可执行入口与具有业务修改效果的操作之间的界限。
- 图片、字体等资源的标识、归属与类型约定。
- 图片、字体等资源的具体标识、正式类型名与登记形式;独立保存的基础资源已纳入 namespace 归属方向。
顶级类型尚未纳入基础类型表或形式文法;其定义待定不影响已确定的访问与结果呈现方向。
基础资源类别已在第 7 章说明;完整类型层次、展示契约和媒体构造形式仍待定,不因此向形式文法补写专用资源语法。
## Agent
Agent 是规划应用领域。声明、能力、工具、上下文、任务、生命周期、权限及模型驱动行为的边界尚未定义。
Agent 的语言资源地位、共有成员模型和核心职责已确定,主要定义见[Agent](../guide/13-agents.md)。具体保留的边界包括:
- agent 声明和职责关联的完整语法、成员可见性、名称查找、嵌套声明,以及共享成员与实例成员的区分。
- 内部成员函数与外部函数引用的工具关联、默认暴露范围、工具描述、参数转换及结果处理。
- memory 的类型、会话与长期记忆范围、检查点粒度、持久性、隔离、共享、保留和恢复规则。
- state 的类型表达、有限状态机、节点、迁移条件和条件路由语法,以及并发更新规则。
- 高风险操作的判定、审批关联、确认有效期、恢复接口和重复效果控制。
- 上下文预算、裁剪、增量总结、必须保留的信息、模型配置与失败处理。
- agent 的实例化、任务交付、对外入口、输入与结果契约、实例及任务标识。
- agent 修改 namespace 的授权、代码提交接口和生成代码的版本与依赖一致性。
成员函数是否默认向模型暴露为工具仍待定义;引用定义不自动启动实例或任务。MemorySaver 等外部库 API 不成为语言关键字或默认成员。
## 设计决定记录
2026-10-08 的用户设计决定明确了定义与运行时的 Preflight/inflight 生命周期、agent 作为语言结构及其核心职责,以及基础常量资源、统一数值、格式归一化和变量引用模型。未明确的关键字、成员关联、算术和编码选择继续保留为提案或未定义项。
同日确认 w 用于资源编辑,x 用于使用定义好的程序能力,业务调用产生写入不要求调用者成为 Editor。随后明确采用 workspace 归属模型:key 使用 workspace handle,注册创建默认个人 workspace,用户作为成员、操作用户及作者,权限按 workspace 整体管理。此决定替换原用户名归属模型;名称细节、迁移和仅执行授权等未定项不随之确定。
## 规范范围