{"id":20806983,"url":"https://github.com/bddjr/clipcc-extension_simple_template","last_synced_at":"2025-05-11T17:32:02.564Z","repository":{"id":175290840,"uuid":"653649735","full_name":"bddjr/clipcc-extension_simple_template","owner":"bddjr","description":"别针扩展简单模板（轻量级）","archived":true,"fork":false,"pushed_at":"2023-06-17T14:49:37.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T03:43:47.600Z","etag":null,"topics":["ccext","ccx","clipcc","clipcc-extension"],"latest_commit_sha":null,"homepage":"","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/bddjr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-14T13:07:13.000Z","updated_at":"2023-10-27T04:41:10.000Z","dependencies_parsed_at":"2023-09-11T06:15:10.238Z","dependency_job_id":null,"html_url":"https://github.com/bddjr/clipcc-extension_simple_template","commit_stats":null,"previous_names":["bddjr/clipcc-extension_simple_template"],"tags_count":5,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bddjr%2Fclipcc-extension_simple_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bddjr%2Fclipcc-extension_simple_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bddjr%2Fclipcc-extension_simple_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bddjr%2Fclipcc-extension_simple_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bddjr","download_url":"https://codeload.github.com/bddjr/clipcc-extension_simple_template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253605002,"owners_count":21934923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ccext","ccx","clipcc","clipcc-extension"],"created_at":"2024-11-17T19:29:30.132Z","updated_at":"2025-05-11T17:32:02.558Z","avatar_url":"https://github.com/bddjr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clipcc extension simple template\n\n[If you want to read the English document, click here.](./README_EN.md)  \n\n别针扩展简单模板（轻量级）  \n\n\u003e 该作者与 ClipTeam 无关。  \n\u003e 使用这个轻量级的方法，无需 nodejs 就能编写并打包扩展。  \n\u003e 这种轻量级的打包方式不是标准的，但仍然可以被采纳，例如 \u003chttps://github.com/bddjr/clipcc-extension-restart_project\u003e 。  \n\u003e 仅用于单个 javascript 文件的场景。  \n\n***\n\n## 实现原理\n将 code 文件夹压缩为 zip 文件。  \n\n***\n## 编写扩展\n编辑文件 ./code/main.js 即可。  \n因为使用的是轻量级的打包方式，所以引入clipcc扩展api时必须使用这个方法：\n```javascript\nconst {api, type, Extension} = self[\"ClipCCExtension\"];\n```\n\n有关clipcc扩展api的使用方式请参考 \u003chttps://doc.codingclip.com/zh-cn/category/for-developers\u003e 。  \n若有扩展api使用的疑问，请自行参考其它扩展，或者到clipcc官方群聊询问。  \n\n***\n## 在 Windows 操作系统打包扩展\n请预先安装 [bandizip](https://cn.bandisoft.com/bandizip/) ，  \n再在这个文件夹下使用 powershell 运行如下命令：  \n```\n./packaging.ps1\n```\n\n如果你因为系统禁止运行此脚本而无法使用，请以管理员权限打开 powershell ，然后运行这个命令以允许执行ps1脚本：\n```powershell\nset-ExecutionPolicy RemoteSigned\n```\n\n如果你已经安装了 python 与 bandizip ，那么也可以使用这个命令打包：\n```\npython packaging.py\n```\n\n***\n## 在 Linux 操作系统打包扩展\n（待验证可行性）  \n请预先安装 zip 和 python3 ，  \n再在这个文件夹下运行如下命令：  \n```\npython3 packaging.py\n```\n\n***\n## 测试扩展\n在预览站上传自己的扩展（不提交扩展审核），以测试自己的扩展：  \n\u003chttps://codingclip.com/editor/stable/\u003e  \n\n***\n## 修改扩展ID与版本号\n假设我要  \n\u003e 将扩展的ID修改为 anonymous.example （如果你要提交审核，按照官方标准，扩展ID应当通过这个正则表达式验证 `^([a-z_0-9]+)\\.([a-z_0-9]+)$` ）   \n\u003e 版本修改为 1.0.0  \n\u003e 作者修改为 anonymous  \n\n\n那么我需要修改以下文件：  \n\n这个文件会在扩展上传至编辑器时用于识别扩展信息，是很关键的一步。  \n./code/info.json  \n```json\n{\n    \"id\": \"anonymous.example\",\n    \"author\": \"anonymous\",\n    \"version\": \"1.0.0\",\n    \"icon\": \"assets/icon.webp\",\n    \"inset_icon\": \"assets/inset_icon.svg\",\n    \"api\": 1\n}\n```\n\n这个文件是 javascript 程序，也是很关键的一步。  \n./code/main.js  \n```javascript\n// 此处填写扩展ID\nconst extension_id = 'anonymous.example';\n// 此处填写扩展的积木栏ID\nconst category_id = extension_id + '.category';\n```\n\n这个文件是用于英语的语言文件，当编辑器找不到对应语言的文件时，会在这个文件里查找。  \n./code/locales/en.json  \n```json\n{\n\"anonymous.example.name\": \"anonymous example extension\",\n\"anonymous.example.description\": \"Just a example extension.\",\n\n\"anonymous.example.category\": \"anonymous example extension\",\n\"anonymous.example.category.string\": \"String [VALUE]\"\n}\n```\n\n这个文件是用于简体中文的语言文件。  \n./code/locales/zh-cn.json  \n```json\n{\n\"anonymous.example.name\": \"匿名示范扩展\",\n\"anonymous.example.description\": \"只是一个示范扩展。\",\n\n\"anonymous.example.category\": \"匿名示范扩展\",\n\"anonymous.example.category.string\": \"字符串 [VALUE]\"\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbddjr%2Fclipcc-extension_simple_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbddjr%2Fclipcc-extension_simple_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbddjr%2Fclipcc-extension_simple_template/lists"}