{"id":20226233,"url":"https://github.com/steamerjs/steamer-plugin-pro","last_synced_at":"2026-06-11T07:31:25.530Z","repository":{"id":57370588,"uuid":"76121072","full_name":"steamerjs/steamer-plugin-pro","owner":"steamerjs","description":"project management plugin","archived":false,"fork":false,"pushed_at":"2018-05-02T16:59:06.000Z","size":592,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-03-30T09:12:36.319Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steamerjs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-10T15:32:49.000Z","updated_at":"2018-05-02T16:58:13.000Z","dependencies_parsed_at":"2022-08-29T17:10:16.103Z","dependency_job_id":null,"html_url":"https://github.com/steamerjs/steamer-plugin-pro","commit_stats":null,"previous_names":["steamerteam/steamer-plugin-pro"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/steamerjs/steamer-plugin-pro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steamerjs%2Fsteamer-plugin-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steamerjs%2Fsteamer-plugin-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steamerjs%2Fsteamer-plugin-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steamerjs%2Fsteamer-plugin-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steamerjs","download_url":"https://codeload.github.com/steamerjs/steamer-plugin-pro/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steamerjs%2Fsteamer-plugin-pro/sbom","scorecard":{"id":850042,"data":{"date":"2025-08-11","repo":{"name":"github.com/steamerjs/steamer-plugin-pro","commit":"83b62eff3eeaf0a9129701e5839daca004c247ef"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/25 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":0,"reason":"30 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-6chw-6frg-f759","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-rq8g-5pc5-wrhr","Warn: Project is vulnerable to: GHSA-qrmc-fj45-qfc2","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-44pw-h2cw-w3vq","Warn: Project is vulnerable to: GHSA-c429-5p7v-vgjp","Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37","Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546","Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-675m-85rw-j3w4","Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574","Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm","Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-23T22:15:22.891Z","repository_id":57370588,"created_at":"2025-08-23T22:15:22.891Z","updated_at":"2025-08-23T22:15:22.891Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34188272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T07:16:52.370Z","updated_at":"2026-06-11T07:31:25.468Z","avatar_url":"https://github.com/steamerjs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"##  steamer-plugin-pro\n\n多框架管理工具\n\n[![NPM Version](https://img.shields.io/npm/v/steamer-plugin-pro.svg?style=flat)](https://www.npmjs.com/package/steamer-plugin-pro)\n[![Travis](https://img.shields.io/travis/steamerjs/steamer-plugin-pro.svg)](https://travis-ci.org/steamerjs/steamer-plugin-pro)\n[![Deps](https://img.shields.io/david/steamerjs/steamer-plugin-pro.svg)](https://david-dm.org/steamerjs/steamer-plugin-pro)\n[![Coverage](https://img.shields.io/coveralls/steamerjs/steamer-plugin-pro.svg)](https://coveralls.io/github/steamerjs/steamer-plugin-pro)\n\n### 安装\n\n```javascript\nnpm i -g steamerjs\n\nnpm i -g steamer-plugin-pro\n```\n\n\n### 项目结构\n\n通常来说，会有两种的项目结构\n\n* 兄弟结构\n\n```javascript\n\nMain Porject\n\t|---- A Project \n\t|---- B Project\n\n```\n\n* 父子结构\n\t- 默认, `steamer-plugin-pro` 只会搜索到第2层\n\n```javascript\n\nMain Project \n\t|\n\t|---- A Project \n\t  |\n\t  |---- B Project\n\n```\n\n### 初始化\n\n如果你希望 `steamer-plugin-pro` 自动检测你的项目，你需要适当改动你的子项目的 `package.json`。 下面的 `name`, `start` 和 `dist` 就是会使用到的值。\n\n```javascript\n{\n  \"name\": \"steamer-project\",\n  \"scripts\": {\n  \t\"start\": \"\",\n  \t\"dist\": \"\",\n  },\n}\n\n```\n\n下面是一个展示的例子, `steamer-plugin-pro` 会生成 `steamer-plugin-pro.js` 配置文件.\n\n```javascript\nsteamer pro -i\n\nor \n\nsteamer pro --init\n\n// 父项目为第0层，一直搜索到第4层\nsteamer pro -i -l 4\n\nor\n\nsteamer pro --init --level 4\n\n// 无论 `steamer-plugin-pro.js` 配置文件是否存在，直接覆盖\nsteamer pro -i -f\n\nor\n\nsteamer pro --init --force\n```\n\n`package.json`中的 `name` 值，直接作为 `project` 的值. `package.json` 里的 `scripts`中，`start` 和 `dist`  被用于配置中的 `cmds` 值。\n\n`src` 值，则表示子项目文件的相对位置。\n\n```javascript\nmodule.exports = {\n    \"plugin\": \"steamer-plugin-pro\",\n    \"config\": {\n        \"projects\": {\n            \"steamer-project\": {\n                \"src\": \"project\",\n                \"cmds\": {\n                    \"start\": \"\",\n                    \"dist\": \"\"\n                }\n            },\n            \"steamer-koa\": {\n                \"src\": \"koa\",\n                \"cmds\": {\n                    \"start\": \"node-dev ./app.js\",\n                    \"dist\": \"\"\n                }\n            },\n            \"steamer-model\": {\n                \"folder\": \"model\",\n                \"cmds\": {\n                    \"start\": \"gulp\u0026\u0026node ./webpack.server.js\",\n                    \"dist\": \"gulp sprites\u0026\u0026export NODE_ENV=production\u0026\u0026webpack\"\n                }\n            },\n            \"steamer-react\": {\n                \"folder\": \"react\",\n                \"cmds\": {\n                    \"start\": \"gulp\u0026\u0026node ./webpack.server.js\",\n                    \"dist\": \"gulp sprites\u0026\u0026export NODE_ENV=production\u0026\u0026webpack\"\n                }\n            }\n        },\n        \"steps\": {\n            \"start\": {},\n            \"dist\": {}\n        }\n    }\n}\n```\n\n\n### 开发或发布你的项目\n\n* 开发项目\n\n```javascript\n// 开发所有项目\nsteamer pro -s \n\nor \n\nsteamer pro --start\n\n// 只开发特定项目\n\nsteamer pro -s steamer-react\n\nor \n\nsteamer pro --start steamer-react\n```\n\n* 发布项目\n\n```javascript\n// 发布所有项目\nsteamer pro -d \n\nor \n\nsteamer pro --dist\n\n// 只发布特定项目\n\nsteamer pro -d steamer-react\n\nor \n\nsteamer pro --dist steamer-react\n```\n\n你也可以设置以下的回调函数，`config` 会作为参数传递到回调函数中。\n\n* `config.currentProject`\n\t- 当前子进程的执行的项目\n\n* `config.isEnd`\n\t- 只会在 `finish` 回调中出现, 如果是 `true`, 表示所有子进程结束\n\n```javascript\n\"steps\": {\n    \"start\": {\n        start: function(config) {       // 命令开始\n            console.log(\"=====start=====\");\n            console.log(config);\n        },\n        finish: function(config) {      // 命令结束\n            if (config.isEnd) {\n                console.log(\"======end=====\");\n            }\n        }\n    },\n    \"dist\": {\n        start: function(config) {       // 命令开始\n            console.log(\"=====start=====\");\n            console.log(config);\n        },\n        finish: function(config) {      // 命令结束\n            if (config.isEnd) {\n                console.log(config);\n            }\n        }\n    }\n}\n```\n\n有时候，你会希望将各个子项目中的 `dist` 文件夹中的文件，全部放置到父项目文件夹的某个文件夹中，这时，首先你可以在各个项目的配置中，添加 `dist` 字段，记录子项目的 `dist` 目录将会生成父项目的某个文件夹，如下，设置 `dist` 的值为 `dist 表示，将子项目的 `dist` 目录，将生成到父项目的 `dist` 目录下。插件强制规定子项目线上代码必须放在 `dist` 中（符合 `steamer` starter kit 的规范），你无法定制。\n\n```javascript\n\"projects\": {\n    \"steamer-react\": {\n        \"src\": \"steamer-react\",\n        \"dist\": \"dist\",\n        \"cmds\": {\n            \"start\": \"node ./tools/start.js\",\n            \"dist\": \"node ./tools/dist.js\"\n        }\n    },\n    \"steamer-simple\": {\n        \"src\": \"steamer-simple\",\n        \"dist\": \"dist\",\n        \"cmds\": {\n            \"start\": \"node ./tools/start.js\",\n            \"dist\": \"node ./tools/dist.js\"\n        }\n    }\n},\n```\n\n然后，当 `steamer pro -d` 编译结束后，在调用 `steps.dist.finish` 回调时，调用插件内置的方法 `this.copyToDist`，如下，插件会帮你完成此功能：\n\n```javascript\n...\n\"steps\": {\n    \"start\": {},\n    \"dist\": {\n        start: function(config) {\n            console.log(\"=====start=====\");\n            // console.log(config);\n        },\n        finish: function(config) {    \n            if (config.isEnd) {\n                this.copyToDist();\n            }\n        }\n    }\n}\n```\n\n如果你想进行深度定制，你可以通过 `config` 参数，获取各项目的相关位置信息，然后自己进一步写逻辑定制。\n\n\n### 开发\n```\n// 将此模块链接到全局下\nnpm link\n\n// 进入specPlugin中，在project2/steamer-simple, project2/steamer-react, project3/steamer-simple中安装依赖\n\n// 运行测试用例\nnpm i -g eslint // 安装eslint\n\nnpm test\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteamerjs%2Fsteamer-plugin-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteamerjs%2Fsteamer-plugin-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteamerjs%2Fsteamer-plugin-pro/lists"}