docs: settle host import leading-star and lookup label contract
All checks were successful
技能自动化发布 / release (push) Successful in 19s

This commit is contained in:
2026-10-23 17:31:11 +08:00
parent de127d7e71
commit 8a8fa3cb0c
12 changed files with 331 additions and 7 deletions

View File

@@ -38,6 +38,8 @@
- 可在技能安装/更新成功后静默调用 `python scripts/main.py init-db` 做幂等 ensure(内部即 `init_db()`);失败不影响安装结果
- 若技能启用了单元格呈现(见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)),读取旁路呈现数据并为格子 / 行 / 列 / 区域映射语义样式(`tone`);不猜测业务规则;整行色只涂表格行,不铺到详情字段
- **导入模板下拉(宿主能力)**:下载「Excel 模板」时,宿主按本表可导入列的元数据自动加 Excel 数据有效性下拉——凡列已有可选集合(`options_json` 静态枚举、schema 已解析的 lookup 选项、未写 options 的 `boolean` 默认「是/否」等)即加下拉;无选项的列仍为自由文本。下拉展示 **label**;导入写库时宿主(或 `replaces: import` 技能)再 **label → value**。CSV 模板**不能**带下拉,可选值仍写在导入弹窗「可导入字段说明」与 Excel「填写说明」页。技能**无需**自备带下拉的模板文件;把字段选项声明在 `_jiangchang_columns` 即可让所有技能受益。宿主不按技能名写死「只支持某几种业务字段」。
- **导入模板表头必填标记(宿主能力)**:Excel/CSV 表头对必填列统一加**前缀**红星(`*显示名` / `* 显示名`),与新增表单标签一致;**不是**后缀 `显示名*`。走 `replaces: import` 的技能必须按 [`ACTIONS.md`](ACTIONS.md)「导入表头与 lookup 单元格」剥前/后缀 `*` 后再对 `display_name`;推荐复用 [`scripts/service/table_file_import.py`](../scripts/service/table_file_import.py)。
- **导入模板 lookup 单元格**:用户从下拉选中的值常以 `{value} · {label}` 写入表格(与列表展示一致)。`replaces: import` 技能解析关联列时须能从该展示串取出编号(`optional_int`),不能只接受纯数字。
## 初始化入口