momo-ai 1.0.0 → 1.0.1

package/src/_template/LAIN/execute/admin-n-f-login.md

@@ -0,0 +1,56 @@
+# 管理型前端登录页开发执行步骤
+
+## 任务准备阶段
+
+1. 检查 `specification/.activities/` 目录下是否存在空闲的任务项目
+2. 若不存在，则创建新任务目录：`{actor}@{changeId}`
+3. 确认 `source/` 目录中是否有足够的项目副本
+4. 查看 `specification/changes/{changeId}/proposal.md` 了解需求背景
+5. 查看 `specification/changes/{changeId}/tasks.md` 明确任务清单
+
+## 任务执行阶段
+
+### 登录页开发
+
+1. 创建登录页组件
+2. 添加用户名输入框
+3. 添加密码输入框
+4. 添加登录按钮
+5. 配置路由
+6. 对接登录认证接口
+7. 实现表单验证
+8. 实现登录成功跳转
+9. 实现登录失败提示
+
+### 安全性考虑
+
+1. 确保密码输入框使用密码类型
+
+### 质量保证
+
+1. 确保代码符合项目规范
+2. 进行必要的代码检查
+
+## 任务完成阶段
+
+1. 提交代码到版本控制系统
+2. 使用命令执行任务：`momo:run -a {actor} -t {task}`
+3. 更新 `specification/changes/{changeId}/tasks.md` 中的任务状态
+4. 使用命令查看任务状态：`momo:tasks`
+5. 归档需求：`momo archive -n "{changeId}"`
+
+## 变更结构参考
+
+```
+specification/
+  changes/
+    {changeId}/
+      proposal.md     # 变更提案说明文件
+      tasks.md        # 变更任务列表说明
+      design.md       # 变更设计说明文件（可选）
+      tasks/          # 任务详细内容
+        M01-T001-01.md # 具体任务文件
+      specs/          # 能力变更详情
+        [capability]/
+          spec.md     # ADDED/MODIFIED/REMOVED需求
+```

package/src/_template/LAIN/specification/project-model.md

@@ -0,0 +1,13 @@
+# [项目名称] 概念模型
+
+## 实体模型
+
+[实体模型相关定义，对应底层数据表结构]
+
+## 关系模型
+
+[关系模型相关定义，描述实体相关关系（主要针对多对多）]
+
+## 常量模型
+
+[常量模型相关定义，常量、枚举、配置等]

package/src/_template/LAIN/specification/project.md

@@ -0,0 +1,73 @@
+# [项目名称]
+
+## 概述
+
+[在此处描述项目的总体情况，包括项目的核心价值、解决的问题以及主要功能]
+
+- 项目名称: [在此处填写项目名称]
+- 项目类型: [Web应用/移动应用/桌面应用/API服务/混合型等]
+- 项目范围: [描述项目的功能边界和涵盖的业务领域]
+- 项目目标: [列出项目的主要目标和预期成果]
+
+---
+
+## 技术栈
+
+[列出项目使用的主要技术栈信息]
+
+- 编程语言: [主要使用的编程语言]
+- 主要框架: [前端/后端框架]
+- 数据库: [数据库类型及名称]
+- 其他关键技术: [其他重要技术组件]
+
+## 代码风格
+
+[描述代码风格和规范]
+
+- 命名规范: [变量、函数、类等的命名约定]
+- 缩进规范: [使用的缩进方式]
+- 注释规范: [代码注释的要求和格式]
+- 其他代码质量要求: [其他代码质量标准]
+
+## 架构目标
+
+[描述架构设计的目标]
+
+- 可扩展性: [系统扩展性要求]
+- 可维护性: [代码可维护性目标]
+- 性能目标: [系统性能指标]
+- 安全性考虑: [安全相关要求]
+
+## 测试策略
+
+[描述测试策略和方法]
+
+- 单元测试覆盖率要求: [期望的代码覆盖率]
+- 集成测试策略: [模块间交互测试方法]
+- 端到端测试方法: [用户行为模拟测试]
+- 使用的测试框架: [测试工具选择]
+
+## 核心约束
+
+[描述项目的核心约束条件]
+
+- 部署环境: [服务器环境要求]
+- 浏览器兼容性要求: [需要支持的浏览器]
+- 第三方服务依赖: [外部服务依赖]
+- 法规合规要求: [法律法规遵循要求]
+
+## 外部依赖
+
+[列出项目的外部依赖]
+
+- API服务: [需要调用的API]
+- 云服务: [使用的云平台服务]
+- 开源库: [依赖的开源组件]
+
+---
+
+## 领域上下文
+
+[描述项目的业务领域背景，包括行业的特点、业务流程、专业术语等]
+
+[说明项目所属的行业领域以及解决的具体业务问题]

package/src/_template/LAIN/specification/requirement.md

@@ -0,0 +1,25 @@
+# [项目名称] 需求说明
+
+## 用户群描述
+
+[描述用户群，包括用户分类、用户画像、不同用户需求群的差异信息]
+
+## 场景描述
+
+[描述用户在使用产品时的典型场景，包括使用环境、使用频率、使用目的等]
+
+## 产品功能描述
+
+[描述产品的核心功能和附加功能，明确每个功能的具体需求和预期效果]
+
+## 设备对接
+
+[描述产品需要对接的硬件设备类型、通信协议、数据格式等技术细节]
+
+## 集成需求
+
+[描述产品需要集成的其他系统或平台，包括集成方式、数据交换要求等]
+
+## 性能需求
+
+[描述产品在性能方面的具体要求，如响应时间、处理能力、并发用户数等]

package/src/_template/PROMPT/add.md.ejs

@@ -0,0 +1,5 @@
+# 添加需求提示词
+
+<!-- BEGIN -->
+阅读 specification/project.md 中的基本需求信息，然后写新需求 <%= NAME %> 的详细需求内容，更改掉 specification/changes/<%= NAME %>/ 目录中的需求说明，并且生成任务清单和子任务清单（specification/changes/<%= NAME %>/tasks/目录下），项目本身的技术栈和数据模型可参考specification/project-model.md 文件。
+<!-- END -->

package/src/_template/PROMPT/plan.md.ejs

@@ -0,0 +1,5 @@
+# 添加需求提示词
+
+<!-- BEGIN -->
+阅读 specification/project.md 中的基本需求信息，根据 <%= NAME %> 的描述信息，重新制定需求的开发计划，更改掉 specification/changes/<%= NAME %>/ 目录中的需求说明，重新制定任务清单并且更新（子任务清单在specification/changes/<%= NAME %>/tasks/目录下），项目本身的技术栈和数据模型可参考 specification/project-model.md 文件。
+<!-- END -->

package/src/_template/PROMPT/run.md.ejs

@@ -0,0 +1,9 @@
+# 任务执行需求
+
+<!-- BEGIN -->
+在 source/<%= ROOT %> 目录下完成任务 <%= TASK %> 的开发工作（任务详情：specification/changes/<%= REQ %>/tasks/<%= TASK %>.md）。
+
+任务完成后，请记得删除以下两个锁文件：
+1. 任务锁文件: specification/changes/<%= REQ %>/tasks/<%= TASK %>.lock
+2. 任务空间锁文件: source/<%= ROOT %>.lock
+<!-- END -->

package/src/_template/PROMPT/tasks.md.ejs

@@ -0,0 +1,5 @@
+# 任务检查需求
+
+<!-- BEGIN -->
+specification/changes/<%= REQ %>/tasks/<%= TASK %> 任务有重复，检查所有的 specification/changes/ 下的需求，将重复的赋予新的任务号。
+<!-- END -->

package/src/commander/actor.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeActor",
+    "description": "创建或更新指定的AI角色信息！",
+    "command": "actor",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "角色名称！"
+        }
+    ]
+}

package/src/commander/actors.json

@@ -0,0 +1,6 @@
+{
+    "executor": "executeActors",
+    "description": "列出所有已存在的AI角色信息！",
+    "command": "actors",
+    "options": []
+}

package/src/commander/add.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeAdd",
+    "description": "（CV）添加新需求，并将 prompt 追加到剪切板中！",
+    "command": "add",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "需求名称或者需求文件的 .md 路径"
+        }
+    ]
+}

package/src/commander/archive.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeArchive",
+    "description": "将某个需求归档操作，会删除原始需求信息！",
+    "command": "archive",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "需求名称，不可以是 .md 的文档，而且需求必须存在！"
+        }
+    ]
+}

package/src/commander/env.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeEnv",
+    "description": "环境信息检查！",
+    "command": "env",
+    "options": [
+    ]
+}

package/src/commander/help.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeHelp",
+    "description": "显示帮助的详细信息！",
+    "command": "help",
+    "options": [
+    ]
+}

package/src/commander/init.json

@@ -0,0 +1,13 @@
+{
+    "executor": "executeInit",
+    "description": "初始化 Spec 工程！",
+    "command": "init",
+    "options": [
+        {
+            "name": "directory",
+            "alias": "d",
+            "description": "项目目录，如果不提供则是默认目录！",
+            "default": "."
+        }
+    ]
+}

package/src/commander/list.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeList",
+    "description": "列举所有需求列表！",
+    "command": "list",
+    "options": [
+    ]
+}

package/src/commander/open.json

@@ -0,0 +1,7 @@
+{
+    "executor": "executeOpen",
+    "description": "使用指定的AI工具打开当前项目！",
+    "command": "open",
+    "options": [
+    ]
+}

package/src/commander/plan.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executePlan",
+    "description": "（CV）生成新的需求计划，重写需求信息！",
+    "command": "plan",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "需求名称，不可以是 .md 的文档，而且需求必须存在！"
+        }
+    ]
+}

package/src/commander/repo.json

@@ -0,0 +1,18 @@
+{
+    "executor": "executeRepo",
+    "description": "Clone 仓库中的代码到工作区！",
+    "command": "repo",
+    "options": [
+        {
+            "name": "address",
+            "alias": "a",
+            "description": "当前项目的远程 Git 仓库地址！"
+        },
+        {
+            "name": "i",
+            "alias": "instance",
+            "description": "需要 Clone 的远程仓库的实例副本数量！",
+            "default": 10
+        }
+    ]
+}

package/src/commander/run.json

@@ -0,0 +1,18 @@
+{
+    "executor": "executeRun",
+    "description": "执行指定的任务！",
+    "command": "run",
+    "options": [
+        {
+            "name": "actor",
+            "alias": "a",
+            "description": "指定执行任务的 Actor 名称",
+            "default": "unknown"
+        },
+        {
+            "name": "task",
+            "alias": "t",
+            "description": "任务名称"
+        }
+    ]
+}

package/src/commander/show.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeShow",
+    "description": "显示指定需求的详细内容！",
+    "command": "show",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "需求名称！"
+        }
+    ]
+}

package/src/commander/tasks.json

@@ -0,0 +1,18 @@
+{
+    "executor": "executeTasks",
+    "description": "（CV）枚举所有任务信息！",
+    "command": "tasks",
+    "options": [
+        {
+            "name": "actor",
+            "alias": "a",
+            "description": "指定执行任务的 Actor 名称",
+            "default": "unknown"
+        },
+        {
+            "name": "task",
+            "alias": "t",
+            "description": "任务名称"
+        }
+    ]
+}

package/src/commander/unlock.json

@@ -0,0 +1,6 @@
+{
+    "executor": "executeUnlock",
+    "description": "解锁所有被占用的任务和工作空间！",
+    "command": "unlock",
+    "options": []
+}

package/src/commander/validate.json

@@ -0,0 +1,12 @@
+{
+    "executor": "executeValidate",
+    "description": "验证指定需求格式是否合法！",
+    "command": "validate",
+    "options": [
+        {
+            "name": "name",
+            "alias": "n",
+            "description": "需求名称！"
+        }
+    ]
+}

package/src/epic/history/ai.economy.impl.fn.excel.js

@@ -0,0 +1,148 @@
+const __LOG = require('../momo.fn.log');
+const __STR = require('./ai.export.interface.fn.string');
+const __IO = require('./ai.export.interface.io');
+const Excel = require('exceljs');
+const path = require("path");
+// ==========================================================
+// Excel
+// ==========================================================
+
+const excelLog = (index, message) => __LOG.info(`Zero AI `.cyan + `「${index}」`.red + message)
+const excelGenerate = async (config = {}, file, index, prefix) => {
+    const {role, out} = config;
+    excelLog(index, ` -> 加载数据中`);
+    const workbook = new Excel.Workbook();
+    await workbook.xlsx.readFile(file);
+    excelLog(index, ` 读取原始文件：${file.blue}`)
+    if (workbook) {
+        const worksheetRef = workbook.getWorksheet("DATA-PERM");
+        if (worksheetRef) {
+            const maxRow = worksheetRef['_rows'].length;
+            const maxColumn = worksheetRef['_columns'].length;
+            excelLog(index, ` 分析结果：最大行 - ${maxRow.toString().blue}，最大列 - ${maxColumn.toString().blue}。`);
+            worksheetRef.eachRow((rowRef, rowNumber) => {
+                rowRef.eachCell((cellRef, cellNumber) => {
+                    const original = cellRef.value;
+                    if ("#ROLE_ID#" === original) {
+                        cellRef.value = role;
+                    } else if ("e501b47a-c08b-4c83-b12b-95ad82873e96" === original) {
+                        cellRef.value = role;
+                    }
+                })
+            })
+            const segment = file.split(path.sep);
+            const filename = segment[segment.length - 1];
+            const target = prefix ? `${out}${path.sep}${prefix}.${filename}` : `${out}${path.sep}${filename}`;
+            excelLog(index, `创建新数据文件 ${target}`);
+            await workbook.xlsx.writeFile(target);
+        } else {
+            excelLog(index, `文件读取有问题：${file}`.red);
+        }
+    }
+}
+const excelRun = (config = {}) => {
+    __LOG.info(`Zero AI `.cyan + ` 1. 准备生成角色对应权限：ID = "${config.role.green}" ...`);
+    __IO.dirCreate(`${process.cwd()}${path.sep}${config.out}`);
+    // 1. 执行替换
+    const {files = [], filesInput = []} = config;
+    __LOG.info(`Zero AI `.cyan + ` 2. 生成 Zero Extension 权限...`.yellow);
+    files.forEach((file, index) => excelGenerate(config, file, index))
+    __LOG.info(`Zero AI `.cyan + ` 3. 生成 输入文件 权限...`.yellow);
+    filesInput.forEach((file, index) => excelGenerate(config, file, index, "input"))
+}
+const excelResource = async (config = {}, parameters = {}, pid = [], sheetName = "DATA-RES") => {
+    const workbook = new Excel.Workbook();
+    await workbook.xlsx.readFile(config.resource);
+    __LOG.info(`Zero AI `.cyan + ` 2.1. 数据加载中，替换原始文件……`);
+    if (workbook) {
+        const worksheetRef = workbook.getWorksheet(sheetName);
+        if (worksheetRef) {
+            const maxRow = worksheetRef['_rows'].length;
+            const maxColumn = worksheetRef['_columns'].length;
+            __LOG.info(`Zero AI `.cyan + ` 2.2. 分析结果：最大行 - ${maxRow.toString().blue}，最大列 - ${maxColumn.toString().blue}。`);
+
+            const pidSet = new Set();
+            const generate = 0 === pid.length
+            worksheetRef.eachRow((rowRef, rowNumber) => {
+                rowRef.eachCell((cellRef, cellNumber) => {
+                    const original = cellRef.value;
+                    if ("string" === typeof original) {
+                        if ("#GUID#" === original) {
+                            cellRef.value = __STR.strUuid();
+                        } else if ("#PID#" === original) {
+                            if (generate) {
+                                const permId = __STR.strUuid();
+                                cellRef.value = permId;
+                                pid.push(permId)
+                            } else {
+                                let found;
+                                for (let idx = 0; idx < pid.length; idx++) {
+                                    if (!pidSet.has(pid[idx])) {
+                                        pidSet.add(pid[idx]);
+                                        found = pid[idx];
+                                        break;
+                                    }
+                                }
+                                cellRef.value = found;
+                            }
+                        } else {
+                            cellRef.value = __STR.strExpr(original, parameters)
+                        }
+                    }
+                })
+            });
+            __LOG.info(`Zero AI `.cyan + ` 2.3. 正在解析表达式......`);
+            worksheetRef.eachRow((rowRef, rowNumber) => {
+                rowRef.eachCell((cellRef, cellNumber) => {
+                    const original = cellRef.value;
+                    if (original?.sharedFormula || original?.formula) {
+                        let formula;
+                        if (original.sharedFormula) {
+                            formula = original.sharedFormula;
+                        } else if (original.formula) {
+                            formula = original.formula;
+                        }
+                        const cell = worksheetRef.getCell(formula);
+                        if ("string" === typeof cell?.value) {
+                            original.result = cell.value;
+                            cellRef.value = original;
+                        }
+                    }
+                })
+            });
+            __LOG.info(`Zero AI `.cyan + ` 2.4. 创建新数据文件......`.rainbow);
+            const targetFile = `./${config.identifier}.xlsx`;
+            __LOG.info(`Zero AI `.cyan + ` 执行Worksheet：${targetFile.blue}。`);
+            await workbook.xlsx.writeFile(targetFile);
+        } else {
+            __LOG.info(`Zero AI `.cyan + ` ERROR，文件读取有错！！`.red);
+        }
+    }
+}
+const excelRes = (file = {}, parameters = {}) => {
+    __LOG.info(`Zero AI `.cyan + ` 1. 准备生成资源信息..., ${JSON.stringify(parameters)}`);
+    __LOG.info(`Zero AI `.cyan + ` 2. 生成 Zero Extension 资源文件...`.yellow);
+    const pid = []
+    excelResource(file, parameters, pid).then(result => {
+        __LOG.info(`Zero AI `.cyan + ` 3. 资源生成完成...`.green);
+        return Promise.resolve(result)
+    }).then(nil => {
+        __LOG.info(`Zero AI `.cyan + ` 4. 准备生成权限信息..., ${JSON.stringify(parameters)}`);
+        const res = {};
+        res.resource = file.auth;
+        res.identifier = "falcon." + file.identifier;
+        return excelResource(res, parameters, pid, "DATA-PERM");
+    }).then(nil => {
+        __LOG.info(`Zero AI `.cyan + ` 5. 权限文件生成完成...`.green);
+        const viewJson = __IO.ioJObject(file.json);
+        viewJson.data.identifier = file.identifier;
+        const targetFile = `./${file.identifier}.json`;
+        __IO.outJson(targetFile, viewJson);
+        __LOG.info(`Zero AI `.cyan + ` 执行完成...`.green);
+
+    });
+}
+module.exports = {
+    excelRun,
+    excelRes
+};

package/src/epic/history/ai.economy.impl.fn.execute.js

@@ -0,0 +1,117 @@
+const program = require('commander');
+const U = require('underscore');
+const co = require('co');
+const Immutable = require('immutable');
+const __LOG = require('../momo.fn.log');
+const __IT = require('./ai.uncork.fn.it.feature');
+const __FX = require('./ai.under.fn.fx.terminal');
+const __PR = require('./ai.export.impl.fn.parse');
+
+
+const _buildOption = (options = []) => {
+    let optionStr = "";
+    const optionItem = [];
+    options.forEach((option, index) => {
+        const keys = Object.keys(option);
+        const key0 = keys[0].toString();
+        const key1 = keys[1] ? keys[1].toString() : undefined;
+        if (key1) {
+            const short = key0.length < key1.length ? key0 : key1;
+            const long = key0.length > key1.length ? key0 : key1;
+            const key = `-${short}, --${long}`;
+            const opt = {};
+            opt.key = key;
+            opt.desc = option[short] ? option[short] : option[long];
+            optionItem.push(opt);
+            optionStr += key;
+            if (index < options.length - 1) {
+                optionStr += ' | ';
+            }
+        }
+    });
+    return {
+        item: optionItem,
+        usage: optionStr
+    };
+};
+
+const _validateArgs = (keys = []) => {
+    const commandArg = process.argv[2];
+    const skip = Immutable.fromJS(["-h", '-V', '--version', '--help']);
+    if (!skip.contains(commandArg)) {
+        const $keys = Immutable.fromJS(keys.concat(['help']));
+        const isError = !$keys.contains(commandArg);
+        // 检测未通过时，打印错误信息
+        __FX.fxError(isError, 10005, commandArg, keys);
+        return !isError;
+    } else {
+        // 直接跳过，检测未通过
+        return false;
+    }
+};
+/**
+ * ## `Ec.executeHeader`
+ *
+ * 执行命令时打印头信息
+ *
+ * @memberOf module:_epic
+ * @param {String} app 应用程序名
+ */
+const executeHeader = (app) => {
+    const appInfo = require('../../../package.json');
+    program.allowUnknownOption();
+    program.version(appInfo.version);
+    __LOG.info(`----------------- Rachel Momo / AI工具项  ------------------`.rainbow);
+    __LOG.info('应用名称: '.bold + app);
+    __LOG.info('工具主页: '.bold + appInfo.homepage.blue);
+    __LOG.info(`工具版本: ` + `${appInfo.version}`.red + '  ' + `( Node >= 22.x )`.yellow);
+    __LOG.info();
+    __LOG.info("----------------- AI 系统启动…… ----------------------------".rainbow);
+    if (3 > process.argv.length) {
+        __LOG.error("命令缺失，请输入正确的命令！");
+    }
+};
+/**
+ * ## `Ec.executeBody`
+ *
+ * 执行命令的主方法
+ *
+ * @memberOf module:_epic
+ * @param {Array} commanders 指令集
+ * @param {Object} Executor 指令执行集`field = Function`格式
+ */
+const executeBody = (commanders = [], Executor = {}) => {
+    if (_validateArgs(commanders.map(commander => commander.command))) {
+        __IT.itArray(commanders, (commander) => {
+            if (!commander.options) commander.options = [];
+            const executor = Executor[commander.executor];
+            __FX.fxError(!U.isFunction(executor), 10004, commander.command);
+            const option = _buildOption(commander.options);
+            const cmd = program.command(commander.command)
+                .description(commander.description)
+                .usage(`[options] [${option.usage}]`);
+            __FX.fxContinue(0 < commander.options.length, () => {
+                // 设置选项
+                commander.options.forEach(option => {
+                    cmd.option(`-${option.alias}`, option.description);
+                    cmd.option(`--${option.name}`, option.description);
+                })
+            });
+            cmd.action(() => co(() => executor(commander.options)));
+        });
+    }
+};
+/**
+ * ## `Ec.executeEnd`
+ *
+ * @memberOf module:_epic
+ * 执行命令时打印尾信息
+ */
+const executeEnd = () => {
+    program.parse(process.argv);
+};
+module.exports = {
+    executeHeader,
+    executeBody,
+    executeEnd,
+};