feat: 匠厂数据管理展示元数据规范——元数据表初始化/校验、display_order 契约、文档与测试

development/DEVELOPMENT.md

@@ -445,6 +445,8 @@ metadata:
 
 - `db/task_logs_repository.py`
   只做增删查改（模板默认表：`task_logs`）
+- `db/display_metadata.py`
+  创建 `_jiangchang_tables` / `_jiangchang_columns` 并幂等写入中文展示名（见 `references/SCHEMA.md`）
 
 不要在 `db` 层里：
 

development/REQUIREMENTS.md

@@ -150,6 +150,9 @@
 - 主命令（如 `run`）在 mock / simulator 档位可重复验证
 - `python tests/run_tests.py -v` 必跑测试全部通过
 - `task_logs` 写入和查询符合 `references/SCHEMA.md`
+- `init_db()` 已写入 `_jiangchang_tables` / `_jiangchang_columns`；用户可见表/字段具备中文 `display_name`
+- 字段展示顺序与 `PRAGMA table_info(task_logs)` 的 cid 一致；不依赖 `display_order`
+- `tests/test_display_metadata.py` 通过
 - 真实联调（如有）放在 `tests/integration/`，且默认套件不包含真实外联
 - 发布后 Gitea 工作流成功；匠厂技能市场可见最新版本；安装后可在“新建任务”中调用
 

development/RUNTIME.md

@@ -89,6 +89,9 @@ RPA 录屏成片（`RpaVideoSession`）、ffmpeg 路径、背景音乐探测均
 {...}/{skill_slug}.db
 ```
 
+- 业务表使用英文 snake_case；中文表名/字段名写入 `_jiangchang_tables` / `_jiangchang_columns`（见 `references/SCHEMA.md`）。
+- 界面字段顺序由 `CREATE TABLE` 列定义顺序决定，**不要**维护 `display_order` 来调整顺序。
+
 ## 明确禁止
 
 - **不得** vendored `scripts/jiangchang_skill_core/`

development/TESTING.md

@@ -28,6 +28,7 @@
 - 运行时：`runtime_paths` 与 **`JIANGCHANG_*` 隔离**；
 - `SKILL.md` YAML slug vs [`constants.SKILL_SLUG`](../scripts/util/constants.py)；
 - SQLite 骨架：`task_logs` 创建幂等与仓储读写；
+- 数据管理元数据：`_jiangchang_*` 幂等初始化、中文展示名、`PRAGMA table_info` 字段顺序（见 `test_display_metadata.py`）；
 - **adapter profile**：[`tests/test_adapter_profile_policy.py`](../tests/test_adapter_profile_policy.py) + [`adapter_test_utils`](../tests/adapter_test_utils.py) ——验证在未授权情况下绝不误判开启真实网络/RPA。
 - **发布打包守护**：[`tests/test_release_packaging_constraints.py`](../tests/test_release_packaging_constraints.py) ——`scripts/**/*.py` 单文件 < 1000 行、文本文件 UTF-8 without BOM。