用途:面向 Archi Online 构建三类产物——Scripting 面板中用户触发的 .ajs 脚本、可在 Extensions 面板编辑的源码扩展(命令、菜单、工具栏按钮、面板、事件、周期工作流),以及需要可移植或捆绑 JSON、文档、图片资源时打包的 .archi-ext(schema-v2 清单的 ZIP)。
主要能力与用法:通过 jArchi 包装器读写模型,不直接改动 app.model.current() 或原始存储状态;模型名称、属性、文件名、ID 与事件负载视为不可信,面板 UI 用 DOM 节点与 textContent 构建。需共享同一撤销步骤的模型变更应放在一次同步脚本运行或命令块内,先收集异步输入;异步确认后再批量变更时使用受保护的自派发模式。需 await app.storage、对话框、布局与 app.commands.run();存储为浏览器/配置文件本地,不得当作模型数据。显式处理空选择、无活动视图、无效关系、只读模型、过期包装器/预览与扩展重复加载。包路径保持相对、以 / 规范化、不含 . 或 .. 段,声明 schema 版本 2,包含 UTF-8 的 manifest.json 与主文件。可移植脚本优先用 var 与 function,不使用仅桌面端的 Java/Eclipse API、文件系统访问或 require()。
验证与打包:在技能目录运行 python scripts/artifact_tool.py check 检查 .ajs 或扩展文件夹,用 build 生成 .archi-ext 并再次 check。仓库内运行对应测试,如 npm test -- tests/jarchi.test.ts tests/jarchi-dts.test.ts 或 npm test -- tests/extensions.test.ts tests/extension-packages.test.ts tests/extension-examples.test.ts;打包源用 node extensions/build-archives.mjs;公开 API 变更需更新 wiki 并运行 npm run docs:check;交付前可运行 npm run lint、npm run typecheck,发布时用 npm run ci:check。独立产物通过 Scripting 面板导入 .ajs,或 Extensions > Import package 导入 .archi-ext,并验证成功、失败/空状态、撤销、重载与错误列表。
限制:Archi Online 在浏览器中运行受信任 JavaScript,仅暴露文档化全局变量作为稳定契约;检查器警告应视为审查提示而非正确性证明。具体收费、价格、平台与效果资料暂未提供。