0.1.15 继续优化补全
This commit is contained in:
@@ -1278,3 +1278,234 @@ VS Code 在插入**含换行的补全文本**时，会给新行套用当前行
|
||||
|
||||
版本 **0.1.11 → 0.1.13**（0.1.12 为中间版本，仅含锚点与尾随空格修复，
|
||||
未解决叠加；0.1.13 为最终修复）。
|
||||
|
||||
---
|
||||
|
||||
## 二十一、问题分析（第十六轮，2026-08-04）：元素文本内容（simple content）引用与 `<<` 补全
|
||||
|
||||
### 现象
|
||||
|
||||
用户样例（`ObjectCreationList` → `CreateObject` 内输入 `<`）：
|
||||
|
||||
1. 补全菜单出现 `CreateObject`，接受后变成 `<<CreateObject />`——两个尖括号
|
||||
非法 XML；
|
||||
2. 嵌套 `<CreateObject>` 被补全成自闭合 `<CreateObject />`，无法在标签内填
|
||||
单位的 id；正确写法应是 `<CreateObject>CrateDebris_01</CreateObject>`
|
||||
（原版 `SageXml\GlobalData\ObjectCreationLists.xml` 与 AttachTest
|
||||
`ObjectCreationList.xml` 均为此形态）；
|
||||
3. 手动改成 `<CreateObject>C</CreateObject>` 后，内容区不出现 C 开头的
|
||||
GameObject id 补全；
|
||||
4. 对 `<CreateObject>CrateDebris_01</CreateObject>` 的文本 hover 与
|
||||
Ctrl+点击导航均无效。
|
||||
|
||||
### 根因（三个独立缺陷叠加）
|
||||
|
||||
**A. 内容区补全没有处理“用户已输入 `<`”**
|
||||
|
||||
`<` 是补全触发字符（`extension.ts`）。`completion.ts` 的 `contentItems`
|
||||
返回子元素候选时既不设置 `range`，`insertText` 又是完整的 `<Name…>`，VS Code
|
||||
就把完整标签**追加**在已输入的 `<` 后面 → `<<Name />`。影响所有内容区子元素
|
||||
补全（`Offset`、`RequiredUpgrade` 等同样中招），不只 `CreateObject`。
|
||||
|
||||
**B. `elementSnippet` 不知道“simple type 元素要填文本”**
|
||||
|
||||
XSD 中 `CreateObjectNugget` 明确声明
|
||||
`<xs:element name="CreateObject" type="GameObjectWeakRef"/>`；`GameObjectWeakRef`
|
||||
是 simple type，标签内容是 GameObject id。`elementSnippet` 只区分顶层 / 有子
|
||||
元素的复杂类型 / 其他，simple type 落入 `<Name />` 分支，于是生成了永远填不了
|
||||
值的自闭合标签。
|
||||
|
||||
**C. 所有 feature 都只认属性值，不认元素文本内容**
|
||||
|
||||
- `contentItems` 对 simple type 元素查“子元素列表”得到空 → 内容区无补全；
|
||||
- `hover` 只检查属性名/属性值/元素名，文本区间不返回任何结果；
|
||||
- `provideDefinition` 找不到属性直接 `return null`；
|
||||
- `checkValueReferences` 只对属性做未解析引用检查；
|
||||
- Find All References 的正则只匹配 `["']id["']`。
|
||||
|
||||
### 类似情况盘点（模型统计）
|
||||
|
||||
XSD 模型中共 **371 处“子元素是 simple type”的声明（149 个不同元素名）**：
|
||||
|
||||
| 类别 | 数量 | 例子 |
|
||||
|---|---|---|
|
||||
| 带 `xas:refType` 的引用内容 | 291 | `CreateObject`→GameObject、`RequiredUpgrade`/`ForbiddenUpgrade`→UpgradeTemplate、`SpawnTemplate`→GameObject、`Filename`→AudioFile、`RequiredObject`→GameObject |
|
||||
| 无类型 `AssetReference`（isRef 无 refType） | 9 | `FXShaderConstantTexture@Value`、`RenderSubObjectReference@Mesh/CollisionBox` |
|
||||
| 枚举内容 | 22 | `SourceMustNotHaveBeenDisabledThisFrameByType` 等 |
|
||||
| 允许 `$DEFINE` 的内容 | 22 | 各类数值内容 |
|
||||
| 普通字符串 | 27 | `DisplayName` 等 |
|
||||
|
||||
关键取证：`FXShaderConstantTexture@Value` 在真实 XML 里填的是**贴图名、数值、
|
||||
布尔**（如 `AUMCV`、`1.000000`、`false`），`RenderSubObjectReference@Mesh`
|
||||
在 w3x 里填的是**同一模型文件内的子对象名**——它们虽然被 XSD 标成
|
||||
`AssetReference`（isRef），却不是全局资产 ID。因此**只有带 refType 的 simple
|
||||
内容**才按全局引用处理；无类型 `AssetReference` 与 `Poid` 一律不参与全局
|
||||
补全 / hover / 跳转 / 诊断，避免误报。
|
||||
|
||||
### 修复
|
||||
|
||||
1. **内容区 `<` 处理**（`completion.ts`）：`contentChildItems` 检测光标前是否
|
||||
已有 `<`（可带半截名字），有则把替换范围起点设为该 `<`，接受完整
|
||||
`<Name…>` 片段时是“替换”而非“追加”，从根上消灭 `<<`；`</` 输入不触发子元素
|
||||
补全。
|
||||
2. **simple type 元素片段**：`elementSnippet` 对 simple type 返回
|
||||
`<Name>$1</Name>`（带占位符），引用/枚举/define 内容在插入后自动弹值补全
|
||||
（`editor.action.triggerSuggest`）。
|
||||
3. **内容值补全**：`contentItems` 增加 simple-content 分支——元素自身类型是
|
||||
simple 时按“值”补全：refType 资产 ID（严格按类型过滤）、枚举、`$DEFINE`；
|
||||
替换范围只覆盖当前文本 token（`xmlParser.textContentTokenAt`）。
|
||||
4. **引用层纯函数**（`refs.ts`）：新增 `isReferenceContentType(typeName)`
|
||||
（simple + refType + 排除 Poid）与 `resolveContentReferenceTargets(...)`，
|
||||
复用属性引用的类型过滤/评分逻辑。
|
||||
5. **hover / 定义跳转 / 诊断 / Find All References**：均增加元素文本 token
|
||||
分支；Find All References 的搜索模式扩展为同时匹配属性值（`"id"`）与
|
||||
内容引用（`>id<`），并把结果范围裁剪到 id 本身。
|
||||
|
||||
### 举一反三的测试（113 → 121 全绿）
|
||||
|
||||
- `xmlParser.test.mjs`：`textContentTokenAt` 返回内容 token、边界与空白内容
|
||||
返回 null；
|
||||
- `refs.test.mjs`：`GameObjectWeakRef` 内容只解析到 GameObject（同名
|
||||
WeaponTemplate 排除）；`AssetReference` / `Poid` / `string` 不是全局内容
|
||||
引用；
|
||||
- `completion.test.mjs`：用户原始场景——`<` 后接受 CreateObject 的 range 覆盖
|
||||
`<`、`insertText` 为 `<CreateObject>$1</CreateObject>`、应用后不含 `<<`；
|
||||
`<CreateObject>C</CreateObject>` 内只补 C 开头的 GameObject（类型过滤 +
|
||||
token range）；
|
||||
- `contentFeatures.test.mjs`（新增）：hover 显示内容引用定义、Ctrl+点击跳到
|
||||
同文件精确定位、诊断只报“带 refType 的内容引用”且不误报 WeakReference
|
||||
内容。
|
||||
|
||||
版本 **0.1.13 → 0.1.14**。
|
||||
|
||||
### 补充（0.1.14 实机回归，2026-08-04）：真实文件里 `<` 后仍有闭合标签
|
||||
|
||||
单元测试最初只覆盖了“文件在 `<` 处结束”的形态，用户实机复测时 `<` 后面还有
|
||||
`</CreateObject>`，`<<` 依然出现（这次是 `<<Tag>（光标在中间）</Tag>`）。
|
||||
|
||||
**第二层根因**：解析器的 `findTagEnd` 扫描残缺开始标签时会一直找到**后面闭合
|
||||
标签的 `>`**，把它当成这个开始标签的结束，于是生成一个空名/半截名的伪元素
|
||||
（如 name 为 `""` 或 `"Cr"`）。光标落在该伪元素的 start tag 内 → 补全走
|
||||
`element-name` 分支，而该分支的替换范围只从 `<` **之后**开始，插入完整的
|
||||
`<Name>…</Name>` 片段就变成 `<<Name>`。
|
||||
|
||||
**修复**（两层）：
|
||||
|
||||
1. `findTagEnd` 在引号外遇到 `<`（在找到 `>` 之前）直接视为“未闭合开始标签”，
|
||||
走原有的行尾恢复路径：`<` 单独出现时不再产生伪元素，内容区保持 content
|
||||
上下文；`<Cr` 半截名则恢复为 `recoveredStartTag` 元素壳，仍由内容分支补全
|
||||
（该分支的 range 已包含 `<`）。
|
||||
2. `elementNameItems` 的替换范围改为从元素 `start`（即 `<`）开始，即使后续
|
||||
解析仍产生伪元素，也不会再 `<<`。
|
||||
|
||||
测试补 121 → 125：`<` 后跟闭合标签不吞掉闭合标签、半截名恢复为元素壳、真实
|
||||
文件形态（`<` 后有多行属性与闭合标签）接受 CreateObject 后不含 `<<`、半截名
|
||||
`<Cr` 同样不含 `<<`。
|
||||
|
||||
### 补充 2（0.1.14 实机回归）：`<<` 修掉后补全菜单反而消失
|
||||
|
||||
把 `<` 纳入替换范围后，单测直接调用 provider 全部通过，但 VS Code 实机里
|
||||
`<` 后**不再弹出任何补全**；`<CreateObject>C`（尚未输入闭合标签）也不触发，
|
||||
必须补上 `</CreateObject>` 才有候选。
|
||||
|
||||
**根因**：VS Code 用“替换范围内的文本”作为过滤前缀。范围包含 `<` 时，前缀
|
||||
就是 `<`，所有标签名都不匹配 → 菜单为空；范围为零宽且元素未闭合时，
|
||||
`textContentTokenAt` 因 `closeTagStart < 0` 返回 null，range 落在光标处、
|
||||
没有覆盖已输入的 `C`，同样过滤不到。
|
||||
|
||||
**修复**（回到标准补全模式）：
|
||||
|
||||
1. **已输入的 `<` 保留，不放进替换范围**：`contentChildItems` /
|
||||
`elementNameItems` 的 range 从 `<` **之后**开始，插入文本**不再带开括号**
|
||||
（`CreateObject>$1</CreateObject>`），应用结果仍是单个 `<`；没有输入 `<`
|
||||
（Ctrl+Space 内容补全）时才插入完整 `<Name>…</Name>`。这样过滤前缀是
|
||||
`""` / `Cr`，菜单正常显示。
|
||||
2. **未闭合元素也能提取内容 token**：`textContentTokenAt` 在
|
||||
`closeTagStart < 0` 时用 `el.end` 作为内容边界，`<CreateObject>C`（EOF）
|
||||
也能覆盖已输入的 `C` 并给出前缀过滤。
|
||||
|
||||
测试 125 → 128：三个真实形态（孤立 `<`、`<Cr` 半截名、未闭合
|
||||
`<CreateObject>C`）均断言插入文本不带开括号、range 覆盖正确文本、应用结果
|
||||
无 `<<`，并新增“未输入 `<` 时插入完整标签”用例。
|
||||
|
||||
---
|
||||
|
||||
## 二十二、问题分析（第十七轮，2026-08-04）：simple-content 补全变成属性补全；大列表截断后 CrateDebris 消失
|
||||
|
||||
### 现象
|
||||
|
||||
1. 接受 `<CreateObject>$1</CreateObject>` 片段后，弹出的不是 GameObject id
|
||||
补全，而是 `xai:joinAction` 与 `xmlns:xai` 两个属性名候选；
|
||||
2. 不接受这两个候选，直接在标签间输入 `C`：菜单要等较久才出现，且包含大量
|
||||
C 开头的候选，但 **CrateDebris_01 不在其中**；继续输入 `r` / `D` / `e` /
|
||||
`b` / `r` 后候选反而越来越少直至消失；
|
||||
3. 快速输入 `Cr`（不等第一次菜单）则 CrateDebris_01 正常出现。
|
||||
|
||||
### 根因（两个独立问题）
|
||||
|
||||
**A. `>` 之后的零宽光标被当成“还在 start tag 内”**
|
||||
|
||||
`analyzeContext` 原来用 `offset <= startTagEnd` 判定光标在开始标签内。补全
|
||||
片段 `<CreateObject>$1</CreateObject>` 接受后，`$1` 恰好落在
|
||||
`startTagEnd`（`>` 后一格）这个零宽位置，于是被分到 `attribute-name`，
|
||||
返回的自然是 `xai:joinAction` / `xmlns:xai`。
|
||||
|
||||
同类边界还有：已闭合元素的 `end` 之前也用了 `<=`，导致光标刚越过
|
||||
`</CreateObject>` 时仍被当作“在子元素内容里”，而不是父元素的内容区。
|
||||
|
||||
**B. 引用列表超过 400 条后被硬截断，且没有告诉 VS Code“列表不完整”**
|
||||
|
||||
`assetIdItems` 对匹配到的 id 排序后直接 `slice(0, 400)`。VS Code 收到列表后
|
||||
会在客户端按已输入的字符继续过滤这 400 条，**不会再次调用 provider**。
|
||||
于是：
|
||||
|
||||
- 输入 `C` 时 CrateDebris_01 若排在 400 名之后，它从一开始就不在列表里；
|
||||
- 继续输入 `r` 只是在这 400 条里过滤，CrateDebris_01 永远不会出现；
|
||||
- 快速输入 `Cr` 时第一次请求的前缀已经是 `Cr`，匹配数小于 400，所以能看到。
|
||||
|
||||
`includeSourceItems` 还有一个变体：先 `slice(0, 400)` 再排序，同样可能把
|
||||
真正优先级高的候选切掉；`defineItems` / `localIdItems` 也有同类截断隐患。
|
||||
|
||||
### 修复
|
||||
|
||||
1. **开始标签边界语义修正**（`context.ts` / `xmlParser.ts`）：
|
||||
- `>` 之后（`offset === startTagEnd`）一律视为内容区，只有 `>` 尚未输入
|
||||
的残缺开始标签仍保持 `attribute-name`；
|
||||
- 新增 `elementContainsOffset`：已闭合 / 自闭合元素的 `end` 为开区间，
|
||||
光标在 `</Child>` 之后回到父元素内容；未闭合元素在 EOF 仍算在元素内。
|
||||
2. **大列表标记 incomplete**（`completion.ts`）：`assetIdItems`、
|
||||
`includeSourceItems`、`defineItems`、`localIdItems` 一旦超过 400 条就返回
|
||||
`CompletionList(..., isIncomplete: true)`。VS Code 会在用户继续输入时重新
|
||||
请求 provider，窄前缀下 CrateDebris_01 这类“前 400 之外”的 id 不再丢失。
|
||||
3. **局部优先 + 避免全量排序**：当前文档局部 overlay 的资产（`stream:
|
||||
"local"`）在评分中额外降 0.4，先于全局项目候选；`topScoredDefs` 用
|
||||
大小堆只保留前 400，不再对全部匹配 id 做 `sort`，降低大项目首键延迟。
|
||||
4. **Include source 先排序再截断**：修掉“先 slice 后 sort”的顺序问题。
|
||||
|
||||
### 类似情况盘点
|
||||
|
||||
- 任何带 refType 的属性值 / `inheritFrom` / simple-content 引用，只要匹配数
|
||||
超过 400，都存在“越输越少但目标永不出现”的风险——本轮统一用 incomplete
|
||||
解决；
|
||||
- 光标紧贴 `>` 后的零宽位置（简单元素片段 `$1`）与紧贴 `</Child>` 后的位置
|
||||
是同一类“边界误归属”，本轮一并修掉；
|
||||
- `Include@source` 的“先截断后排序”是同一家族 bug，已修复。
|
||||
|
||||
### 举一反三的测试（128 → 136 全绿）
|
||||
|
||||
- `context.test.mjs`：`>` 后且有闭合标签 → content；`>` 后但闭合标签尚未
|
||||
输入 → content；`</Child>` 之后 → 父元素 content；
|
||||
- `xmlParser.test.mjs`：已闭合 / 自闭合元素的 `end` 为开区间；未闭合元素
|
||||
EOF 仍属于该元素；
|
||||
- `completion.test.mjs`：simple-content 片段 `$1` 位置返回值补全而不是
|
||||
`xai:joinAction` / `xmlns:xai`；450+ 候选时返回 incomplete 列表，窄前缀
|
||||
重请求后找到 CrateDebris_01；当前文件 local overlay 资产即使总数超过
|
||||
400 也保留在前 400。
|
||||
|
||||
版本 **0.1.14 → 0.1.15**。
|
||||
|
||||
### 遗留
|
||||
|
||||
若 Corona 上“输入 C 后菜单出现慢”仍然明显，下一个瓶颈大概率是
|
||||
`getScope()` 每次文档版本变化都重建完整局部 include 链 / 逻辑树；本轮先把
|
||||
候选截断与类型过滤造成的“列表错误”修掉，局部 scope 缓存优化留作独立一轮。
|
||||
|
||||
+35
-3
@@ -1,6 +1,6 @@
|
||||
# 调研结论与实施计划（已按最新代码同步更新）
|
||||
|
||||
> 说明：本文档随实现演进持续同步。最近一次同步（2026-08-04）对齐了实现过程中新增的模块与设计变更：BAB 精确搜索路径、manifest 类型/ID 推导、上下文感知元素类型、属性级 refType / Poid 局部引用（`id` 定义点）、精确跳转范围、嵌套 `xi:include`、注入式语法高亮、bit-flag 列表补全（空格触发 / 排除已用 / 追加模式）等。
|
||||
> 说明：本文档随实现演进持续同步。最近一次同步（2026-08-04）对齐了实现过程中新增的模块与设计变更：BAB 精确搜索路径、manifest 类型/ID 推导、上下文感知元素类型、属性级 refType / Poid 局部引用（`id` 定义点）、精确跳转范围、嵌套 `xi:include`、注入式语法高亮、bit-flag 列表补全（空格触发 / 排除已用 / 追加模式）、simple-content 元素文本引用（补全 / hover / 跳转 / 诊断 / Find All References）等。
|
||||
|
||||
## 一、调研结论（带证据）
|
||||
|
||||
@@ -85,7 +85,8 @@ src/
|
||||
existence.ts 文件集存在性快照（目录枚举 Set，替代逐路径 statSync）
|
||||
manifestParser.ts .manifest 二进制解析 + 类型/ID 推导（纯 TS）
|
||||
fileScanner.ts 目录遍历缓存 + Include source 候选收集
|
||||
refs.ts 引用目标解析（按 refType / isRef / inheritFrom 过滤，纯 TS）
|
||||
refs.ts 引用目标解析（属性 + 元素文本内容，按 refType / isRef /
|
||||
inheritFrom 过滤，纯 TS）
|
||||
shallowScan.ts 大体积美术资产（.w3x 等）顶层浅扫描（纯 TS，不建 DOM）
|
||||
records.ts 每文件紧凑索引记录（资产/Define/Include/xi + 行号）
|
||||
caches.ts 跨重建持久缓存（DocumentCache / IndexRecordsCache /
|
||||
@@ -233,6 +234,23 @@ test/
|
||||
第一个独占一行的完整属性作为规范缩进，插入换行时顺带吞掉触发补全留下的
|
||||
尾随空格；属性名补全改用 `SnippetString`（`$1` 成为真正占位符），并新增
|
||||
输出通道调试日志。
|
||||
27. **simple-content 元素文本引用（第十六轮，2026-08-04）**：simple type
|
||||
子元素（如 `ObjectCreationList` 内嵌套 `<CreateObject>`，类型
|
||||
`GameObjectWeakRef`）的**标签间文本**就是资产引用。内容区补全现在区分
|
||||
“复杂元素 → 子元素名”与“简单元素 → 值补全”；用户已输入 `<` 时替换范围从
|
||||
`<` 开始，杜绝 `<<`；simple type 元素片段固定为 `<Name>$1</Name>`（可填
|
||||
值）并自动触发值补全。hover / Ctrl 跳转 / 诊断 / Find All References
|
||||
均增加内容 token 分支。只有**带 `xas:refType`** 的 simple 内容按全局引用
|
||||
处理（291 处子元素声明）；无类型 `AssetReference`
|
||||
（`FXShaderConstantTexture@Value`、`RenderSubObjectReference@Mesh` 等
|
||||
真实数据是贴图/子对象名）与 `Poid` 不参与全局解析，避免误报。
|
||||
补充：真实文件中 `<` 后还有 `</…>` 时，`findTagEnd` 曾把闭合标签的 `>` 误
|
||||
当成残缺开始标签的结束，生成空名/半截名伪元素，补全走 element-name 分支
|
||||
导致 `<<`。修复为引号外遇到 `<` 即视为未闭合（行尾恢复），且
|
||||
`elementNameItems` 的替换范围包含 `<`。实机再回归：范围含 `<` 会让 VS Code
|
||||
用 `<` 做过滤前缀导致菜单为空——改为保留已输入的 `<`、range 从 `<` 之后
|
||||
开始、插入文本不带开括号；`textContentTokenAt` 对未闭合元素用 `el.end`
|
||||
作内容边界。
|
||||
|
||||
## 三、实施步骤
|
||||
|
||||
@@ -278,6 +296,18 @@ test/
|
||||
（编辑器自动补基础缩进，避免 3+3=6 式叠加）、完整属性锚点 + 首个独占一行
|
||||
属性为规范缩进、`$1` 改为 SnippetString 占位符、输出通道调试日志、尾随
|
||||
空格吞除；测试 111 → 113（版本 0.1.12–0.1.13）。
|
||||
19. [x] simple-content 文本引用修复（第十六轮，2026-08-04）：`<` 后补全范围
|
||||
覆盖 `<`、simple type 元素片段 `<Name>$1</Name>`、简单元素内容值补全、
|
||||
`refs.ts` 新增 `isReferenceContentType` / `resolveContentReferenceTargets`、
|
||||
hover / 定义跳转 / 诊断 / Find All References 内容分支；
|
||||
测试 113 → 121（版本 0.1.14）。实机回归补充：`findTagEnd` 引号外遇 `<`
|
||||
视为未闭合 + 插入文本不带开括号（range 从 `<` 之后开始）；测试 121 → 125，
|
||||
再回归 125 → 128（未闭合元素内容 token）。
|
||||
20. [x] simple-content 零宽边界与大列表补全（第十七轮，2026-08-04）：
|
||||
`>` 后光标归入内容区、已闭合元素 `end` 改为开区间；超过 400 条的
|
||||
id/define/local/include 候选返回 `isIncomplete` 让 VS Code 随输入重请求；
|
||||
当前文档 local 资产优先、候选 top-N 用堆避免全量排序、Include source
|
||||
先排序再截断；测试 128 → 136。
|
||||
|
||||
## 四、验证结果（实测）
|
||||
|
||||
@@ -300,7 +330,9 @@ test/
|
||||
`childTypeOf`、大小写规范化、属性级 refType、外来命名空间判定、`xs:list`
|
||||
枚举继承与 `isList` 标记）、引用过滤（`Weapon="X"` 只跳 `WeaponTemplate`、
|
||||
模块 `id` 定义点、Poid 局部引用、`xi:include` 不校验、`Side="Allies"` 命中
|
||||
manifest 的 `PlayerTemplate`）。
|
||||
manifest 的 `PlayerTemplate`）、simple-content 文本引用（`<` 后补全不产生
|
||||
`<<`、`<CreateObject>$1</CreateObject>` 片段、内容值按 refType 过滤、
|
||||
内容 hover / Ctrl 跳转 / 诊断）。
|
||||
|
||||
> 注：D: 盘移动硬盘已恢复连接；Corona 已在第八 / 九轮按上述新数据回归。
|
||||
|
||||
|
||||
@@ -41,9 +41,15 @@ XML 之间的组织靠 `<Include>` 标签，共有三种语义：
|
||||
- 枚举值（XSD `xs:enumeration`）；
|
||||
- `$DEFINE` 常量（如 `$CIV_HEALTH_SMALL`）；
|
||||
- `<Include source>` 补全可解析的文件路径（`DATA:` / `ART:` / `AUDIO:`）。
|
||||
- **元素文本内容（simple content）**：带 `xas:refType` 的简单内容元素
|
||||
（如 `<CreateObject>ID</CreateObject>`）在标签间补全对应类型的资产 ID、
|
||||
枚举或 `$DEFINE`；补全出的 simple-content 元素必须是可填值的成对标签
|
||||
（`<Name></Name>`），且内容区已输入 `<` 时不得产生 `<<`。
|
||||
3. **引用提示（Hover）**：元素/属性悬停显示 XSD 文档、类型、默认值；资产 ID 悬停显示定义位置；`$DEFINE` 悬停显示值与定义位置。
|
||||
- 元素文本内容（simple content 引用）悬停同样显示定义位置。
|
||||
4. **引用导航**：
|
||||
- 从引用型属性值跳转到对应资产定义（Go to Definition）；
|
||||
- 从 simple-content 引用元素（`<CreateObject>ID</CreateObject>`）的文本跳转到对应资产定义；
|
||||
- 查找某资产 ID 的所有引用（Find All References）；
|
||||
- `<Include source>` / `xi:include href` 直接打开目标文件；
|
||||
- `inheritFrom` 跳转到被继承元素；
|
||||
@@ -54,6 +60,7 @@ XML 之间的组织靠 `<Include>` 标签，共有三种语义：
|
||||
- 缺失必填 `id`（顶层资产）；
|
||||
- 重复 ID（同类型 + 同 id，mod 文件之间；覆盖原版 SageXml 不算冲突）；
|
||||
- 引用未解析（引用了不存在的资产 ID，可配置是否忽略原版 manifest 中的 ID）；
|
||||
- simple-content 引用元素的文本未解析（同属性引用规则，仅带 refType 的类型）。
|
||||
- `<Include>` 目标文件找不到、Include 循环；
|
||||
- `$DEFINE` 未定义。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user