VSCode One-Wes 二开工具
面向 One-Wes 仓储管理系统的 VS Code 集成扩展，帮助二开团队快速完成项目初始化、配置编辑与日常运维。在一个工作区内即可完成 manifest 编辑、菜单/页面设计、国际化管理、打印模板定制以及发布前的配置核对。
功能特点
- One-Wes 资源树：按业务域而非文件夹划分，快速定位扩展点、实体定义、菜单补丁、打印模板等资源。
- 可视化编辑器集成：内置 manifest、页面、插件、菜单补丁与打印模板 WebView 编辑器，支持在线预览与校验。
- 一键初始化与同步：帮助项目建立标准二开目录，提供 Git 同步与配置刷新命令。
- 多语言工具链：国际化文件校验命名格式，可视化切换文本/表格编辑视图。
- 发布准备支持：内置健康检查、配置更新与凭证管理，加快上线前的自检流程。
安装
- 在 VS Code 中打开扩展市场，搜索
One-Wes 或 orpheus customize。
- 点击 Install 安装本扩展。
- 安装完成后首开建议重载窗口，以保证所有 WebView 资源正确加载。
企业内部用户如需离线安装，可联系平台团队获取 .vsix 包，并通过命令面板执行 Extensions: Install from VSIX...。
快速开始
- 初始化项目：在 One-Wes 资源树中点击“初始化 One-Wes 项目”，按向导填写服务器地址、账户信息。
- 同步配置：执行命令
One-Wes: 同步配置，保持本地目录与服务器仓库一致。
- 编辑 manifest：选中
manifest.yml 并使用“打开 Manifest 编辑器”进入可视化界面，保存后自动写回文件。
- 维护菜单或页面：在树中定位目标资源，双击即可进入对应 WebView 编辑器，支持版本切换与预览。
- 管理 i18n：打开
i18n/*.properties 文件时将提示切换到可视化编辑，支持批量校验与导出。
常用命令
| 命令 |
作用 |
One-Wes: 初始化项目 |
克隆官方模板、写入 manifest 并建立标准二开目录 |
One-Wes: 打开 Manifest 编辑器 |
在 WebView 中编辑 manifest.yml 或 manifest.json |
One-Wes: 打开菜单补丁编辑器 |
可视化维护菜单补丁 Yaml，支持树结构预览 |
One-Wes: 打开页面设计器 |
可视化编辑 *.page.json 文件 |
One-Wes: 打开插件设计器 |
设计并管理 *.plugin.json 插件资源 |
One-Wes: 打印设计器 |
自定义打印模板（.print.json / .print.groovy） |
One-Wes: 同步配置 |
调用 git pull 同步服务器配置仓库 |
One-Wes: 更新凭证 |
更新服务器访问账号和密码 |
可通过 VS Code 命令面板（Ctrl+Shift+P 或 F1）检索上述命令。
资源树分类说明
| 分类 |
说明 |
默认扩展 |
| 扩展点增强 |
自定义 Groovy 扩展脚本 |
.groovy |
| 实体 |
实体扩展、数据映射与规则补丁 |
*-entity.xml, entity-extend.xml, mapping.yml, rules-extend.yml |
| 菜单 |
菜单补丁定义，支持 WebView 编辑 |
.yaml |
| 页面 |
页面布局与插件配置 |
.page.json, .plugin.json |
| 打印模板 |
打印视图与数据脚本 |
.print.json, .print.groovy |
| 国际化 |
多语言属性文件，强制遵循 name-lang.properties 命名 |
.properties |
兼容性与依赖
- 推荐 VS Code 版本：1.85.0 及以上
- 建议操作系统：Windows 10/11、macOS 13+ 或常见 Linux 桌面发行版
- 开发/参与贡献时需要 Node.js 18+ 与 npm
- 企业网络需允许访问 One-Wes 配置仓库与 API 服务
常见问题
安装后功能按钮灰显？ 请确认项目已初始化，并在资源树顶部选择正确的 One-Wes 项目目录。
WebView 空白或报 403？ 通常是 VS Code 未重载或网络代理拦截，重载窗口并检查防火墙设置。
不能新建映射文件？ mapping.yml 与 rules-extend.yml 为固定文件名，创建时需输入完整文件名；其他扩展（如 .groovy）需提供实体前缀。
反馈与支持
- 内部工单：Geekplus ServiceDesk → 应用交付 → One-Wes 二开工具
- 邮件支持：one-wes-dev@geekplus.com
- 文档与操作指南：请查阅公司内 Wiki（搜索 “One-Wes VSCode 插件”）
许可
版权所有 © 2025 Geekplus Technology Co., Ltd.
本扩展为公司内部软件，仅限获授权的 Geekplus 团队使用。禁止擅自复制、分发、商用或逆向工程。如需外部授权，请联系 legal@geekplus.com。
| |
