[init] 初始化功能

Author: VisualSJ

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: 'bug'
+assignees: ''
+---
+
+**Describe the bug**
+
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug_report_zh.md

@@ -0,0 +1,38 @@
+---
+name: 问题反馈
+about: 创建报告以帮助我们改进
+title: ''
+labels: 'bug'
+assignees: ''
+---
+
+**描述错误**
+
+对 bug 的简要概述。
+
+**复现**
+
+再现行为的步骤：
+1. 转到“…”
+2. 单击“….”
+3. 向下滚动至“….”
+4. 参见错误
+
+**预期行为**
+
+对你期望发生的事情进行清晰且简要的概述。
+
+**屏幕截图**
+
+如果可以，请添加屏幕截图以帮助解释您的问题。
+
+**桌面（请填写以下信息）：**
+
+- 操作系统：[例如iOS]
+- 系统版本：[例如windows11]
+- 浏览器：[例如chrome、safari]
+- 浏览器版本：[例如100]
+
+**附加上下文**
+
+在此处添加有关该问题的任何其他上下文。

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+<!-- 请勿删除注释，需要使用时请复制一遍 -->
+## PR 类型
+
+- [ ] 问题修复
+- [ ] 优化
+- [ ] 新功能
+- [ ] 测试用例
+
+<!-- 详细的描述这个修改的背景和原因 -->
+## PR 描述
+
+<!-- 请描述具体改动了哪些地方，为什么修改 -->
+### 修改说明
+1. 

.github/workflows/ci.yaml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push: {}
+  merge_group:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - ready_for_review
+    paths:
+      - 'source/**.ts'
+      - 'source/scripts/*.js'
+      - '.github/workfows/ci.yaml'
+
+permissions:
+  contents: read
+
+jobs:
+  check-tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18.x]
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Run CI
+        run: npm run ci

.gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+
+.temp
+tsconfig.tsbuildinfo

package-lock.json

@@ -0,0 +1,19 @@
+{
+  "name": "@itharbors/module",
+  "version": "0.1.1",
+  "description": "",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "npx tsc",
+    "test": "node --test ./test/*.spec.js",
+    "ci": "npm install && npm run build && npm run test"
+  },
+  "author": "VisualSJ",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}

package.json

@@ -0,0 +1,142 @@
+# Module System
+
+一个简易的模块管理系统，主要职责：
+1. 管理模块列表
+2. 管理模块的生命周期
+3. 定义模块间的交互方式
+
+# 模块设计文档: Module System
+
+[![NPM](https://img.shields.io/npm/v/@itharbors/module)](https://www.npmjs.com/package/@itharbors/module)
+[![CI Status](https://github.com/itharbors/module/actions/workflows/ci.yaml/badge.svg)](https://github.com/itharbors/module/actions/workflows/ci.yaml)
+
+一个简易的模块管理系统，主要职责：
+1. 管理模块列表
+2. 管理模块的生命周期
+3. 定义模块间的交互方式
+
+## 需求分析
+
+### 功能需求
+
+- 管理模块的生命周期函数
+    - register、load、unload、unregister
+- 管理模块对外暴露的方法
+    - 将所有方法收敛到一个出入口
+- 简易的数据管理
+    - 定义、修改数据
+    - 数据变化的监听
+- 对象上的缓存数据管理
+
+### 非功能需求
+
+- 无
+
+## 整体架构设计
+
+## 代码范例
+
+### 基础用法
+
+```ts
+import { generateModule } from '@itharbors/module';
+
+export const instance = generateModule({
+    stash(): {} {
+        return {};
+    },
+
+    data(): {} {
+        return {};
+    },
+
+    register() {
+
+    },
+
+    register() {
+
+    },
+
+    load() {
+
+    },
+
+    unload() {
+
+    },
+
+    method: {
+        async test(num: string) {
+            return num + 1;
+        }
+    },
+});
+
+
+instance.run('register');
+instance.run('load');
+instance.run('unload');
+instance.run('unregister');
+
+const num = await instance.execture('test', 1); // 2
+```
+
+```ts
+// params 是 initWorkflow 时传入的那个 params
+// 主要用于项目内控制部分流程，比如构建的时候只构建脚本、只构建样式等功能
+exports.remove = function(params) {
+    return ['./dist'];
+};
+exports.npm = function(params) {
+    return [{
+        message: '安装依赖',
+        path: './',
+        params: ['install'],
+        detail: '依赖安装失败，请检查网络和配置',
+    }];
+};
+exports.tsc = function(params) {
+    return ['./'];
+};
+```
+
+### 配置文件
+
+### 注册自定义任务
+
+```ts
+import { readFile } from 'fs';
+import { ModuleContainer, TModule } from '@itharbors/module';
+
+export class Plugin extends ModuleContainer {
+    public info: TPluginInfo;
+    public path: string;
+
+    constructor(path: string) {
+        const pkg = require(join(path, 'package.json'));
+        const module = require(pkg.main) as Partial<TModule>;
+        super({
+            stash: module.stash || function () { return {}; },
+            data: module.data || function () { return {}; },
+            method: module.method || {},
+        });
+    }
+}
+```
+
+## 决策点
+
+- 无
+
+## 异常处理设计
+
+- 无
+
+## 性能优化
+
+- 无
+
+## 附件与参考文档
+
+- 无

readme.md

@@ -0,0 +1,17 @@
+import type { TModule, TMethod, TData, TStash } from './types';
+
+import { ModuleContainer } from './module';
+
+/**
+ * 创建于一个模块容器
+ * @param module 
+ * @returns 
+ */
+export function generateModule<M extends TMethod, D extends () => TData, S extends () => TStash>(module: TModule<M, D, S>) {
+    const container = new ModuleContainer(module);
+    return container;
+}
+
+export type { TModule, TMethod, TData, TStash } from './types';
+
+export { ModuleContainer } from './module';