301 lines
10 KiB
JavaScript
301 lines
10 KiB
JavaScript
#!/usr/bin/env node
|
||
|
||
/**
|
||
* 🌀 铸渊人格协议 · 模块生命周期管理脚本 v1.0
|
||
*
|
||
* 用法:
|
||
* node scripts/zhuyuan-module-protocol.js inspect # 全模块检查
|
||
* node scripts/zhuyuan-module-protocol.js inspect <module-id> # 单模块检查
|
||
* node scripts/zhuyuan-module-protocol.js status # 模块状态汇总
|
||
* node scripts/zhuyuan-module-protocol.js recover <module-id> # 模块回收检查
|
||
* node scripts/zhuyuan-module-protocol.js preview # 预演报告生成
|
||
*
|
||
* 纯 Node.js，无外部依赖。
|
||
*/
|
||
|
||
const fs = require('fs');
|
||
const path = require('path');
|
||
|
||
// === 配置 ===
|
||
const ROOT = path.resolve(__dirname, '..');
|
||
const BRAIN_DIR = path.join(ROOT, '.github', 'brain');
|
||
const DOCS_DIR = path.join(ROOT, 'docs');
|
||
|
||
// 模块注册表
|
||
const MODULE_REGISTRY = {
|
||
'm01-login': { owner: 'DEV-002', name: '肥猫', hli: 'AUTH', label: '登录模块' },
|
||
'm03-personality': { owner: 'DEV-002', name: '肥猫', hli: 'PERSONA', label: '人格模块' },
|
||
'm05-user-center': { owner: 'DEV-009', name: '花尔', hli: 'USER', label: '用户中心' },
|
||
'm06-ticket': { owner: 'DEV-010', name: '桔子', hli: 'TICKET', label: '工单系统' },
|
||
'm07-dialogue-ui': { owner: 'DEV-003', name: '燕樊', hli: 'DIALOGUE', label: '对话界面' },
|
||
'm10-cloud': { owner: 'DEV-003', name: '燕樊', hli: 'STORAGE', label: '云存储' },
|
||
'm11-module': { owner: 'DEV-010', name: '桔子', hli: 'MODULE', label: '模块管理' },
|
||
'm12-kanban': { owner: 'DEV-005', name: '小草莓', hli: 'DASHBOARD', label: '看板' },
|
||
'm15-cloud-drive': { owner: 'DEV-003', name: '燕樊', hli: 'STORAGE', label: '云盘' },
|
||
'm18-health-check':{ owner: null, name: '待分配', hli: 'SYSTEM', label: '健康检查' },
|
||
};
|
||
|
||
// === 工具函数 ===
|
||
|
||
function countFiles(dir) {
|
||
if (!fs.existsSync(dir)) return 0;
|
||
let count = 0;
|
||
const items = fs.readdirSync(dir, { withFileTypes: true });
|
||
for (const item of items) {
|
||
if (item.name.startsWith('.')) continue;
|
||
if (item.isFile()) count++;
|
||
else if (item.isDirectory()) count += countFiles(path.join(dir, item.name));
|
||
}
|
||
return count;
|
||
}
|
||
|
||
function hasReadme(dir) {
|
||
return fs.existsSync(path.join(dir, 'README.md'));
|
||
}
|
||
|
||
function getModuleStatus(moduleDir) {
|
||
const fullPath = path.join(ROOT, moduleDir);
|
||
if (!fs.existsSync(fullPath)) return { exists: false, files: 0, readme: false };
|
||
|
||
const files = countFiles(fullPath);
|
||
const readme = hasReadme(fullPath);
|
||
|
||
let status = '📭 空';
|
||
if (files > 0 && readme) status = '✅ 正常';
|
||
else if (files > 0 && !readme) status = '⚠️ 缺README';
|
||
else if (files === 0) status = '📭 空';
|
||
|
||
return { exists: true, files, readme, status };
|
||
}
|
||
|
||
// === 命令：inspect ===
|
||
|
||
function cmdInspect(moduleId) {
|
||
console.log('🌀 铸渊人格协议 · 模块检查');
|
||
console.log('─'.repeat(50));
|
||
|
||
if (moduleId) {
|
||
// 单模块检查
|
||
const info = MODULE_REGISTRY[moduleId];
|
||
if (!info) {
|
||
console.log(`❌ 未知模块: ${moduleId}`);
|
||
console.log(`已注册模块: ${Object.keys(MODULE_REGISTRY).join(', ')}`);
|
||
process.exit(1);
|
||
}
|
||
|
||
const status = getModuleStatus(moduleId);
|
||
console.log(`\n📦 模块: ${moduleId} (${info.label})`);
|
||
console.log(` 负责人: ${info.name} (${info.owner || '未分配'})`);
|
||
console.log(` HLI 域: ${info.hli}`);
|
||
console.log(` 目录存在: ${status.exists ? '✅' : '❌'}`);
|
||
console.log(` 文件数量: ${status.files}`);
|
||
console.log(` README: ${status.readme ? '✅' : '❌'}`);
|
||
console.log(` 状态: ${status.status}`);
|
||
|
||
// 检查 HLI 接口
|
||
const schemaDir = path.join(ROOT, 'src', 'schemas', 'hli', info.hli.toLowerCase());
|
||
const routeDir = path.join(ROOT, 'src', 'routes', 'hli', info.hli.toLowerCase());
|
||
|
||
if (fs.existsSync(schemaDir)) {
|
||
try {
|
||
const schemas = fs.readdirSync(schemaDir).filter(f => f.endsWith('.schema.json'));
|
||
console.log(` HLI Schema: ${schemas.length} 个 (${schemas.join(', ')})`);
|
||
} catch (e) {
|
||
console.log(` HLI Schema: ⚠️ 读取失败 (${e.code || e.message})`);
|
||
}
|
||
} else {
|
||
console.log(` HLI Schema: 📭 未创建`);
|
||
}
|
||
|
||
if (fs.existsSync(routeDir)) {
|
||
try {
|
||
const routes = fs.readdirSync(routeDir).filter(f => f.endsWith('.js'));
|
||
console.log(` HLI 路由: ${routes.length} 个 (${routes.join(', ')})`);
|
||
} catch (e) {
|
||
console.log(` HLI 路由: ⚠️ 读取失败 (${e.code || e.message})`);
|
||
}
|
||
} else {
|
||
console.log(` HLI 路由: 📭 未创建`);
|
||
}
|
||
} else {
|
||
// 全模块检查
|
||
console.log('\n📋 全模块状态:\n');
|
||
console.log('模块ID | 标签 | 负责人 | 文件 | README | 状态');
|
||
console.log('─'.repeat(70));
|
||
|
||
for (const [id, info] of Object.entries(MODULE_REGISTRY)) {
|
||
const status = getModuleStatus(id);
|
||
const line = [
|
||
id.padEnd(20),
|
||
info.label.padEnd(8),
|
||
info.name.padEnd(8),
|
||
String(status.files).padStart(4),
|
||
(status.readme ? '✅' : '❌').padEnd(6),
|
||
status.status,
|
||
].join(' | ');
|
||
console.log(line);
|
||
}
|
||
}
|
||
}
|
||
|
||
// === 命令：status ===
|
||
|
||
function cmdStatus() {
|
||
console.log('🌀 铸渊人格协议 · 模块状态汇总');
|
||
console.log('─'.repeat(50));
|
||
|
||
let total = 0, ok = 0, warn = 0, empty = 0;
|
||
|
||
for (const [id] of Object.entries(MODULE_REGISTRY)) {
|
||
total++;
|
||
const status = getModuleStatus(id);
|
||
if (status.files > 0 && status.readme) ok++;
|
||
else if (status.files > 0) warn++;
|
||
else empty++;
|
||
}
|
||
|
||
console.log(`\n📊 模块统计:`);
|
||
console.log(` 总模块数: ${total}`);
|
||
console.log(` ✅ 正常: ${ok}`);
|
||
console.log(` ⚠️ 告警: ${warn}`);
|
||
console.log(` 📭 空模块: ${empty}`);
|
||
console.log(` 完成率: ${Math.round((ok / total) * 100)}%`);
|
||
|
||
// 检查前端
|
||
const indexPath = path.join(DOCS_DIR, 'index.html');
|
||
if (fs.existsSync(indexPath)) {
|
||
const stat = fs.statSync(indexPath);
|
||
const lines = fs.readFileSync(indexPath, 'utf8').split('\n').length;
|
||
console.log(`\n🌐 前端:`);
|
||
console.log(` docs/index.html: ${lines} 行, ${(stat.size / 1024).toFixed(1)} KB`);
|
||
}
|
||
|
||
// 检查 CNAME
|
||
const cnamePath = path.join(DOCS_DIR, 'CNAME');
|
||
if (fs.existsSync(cnamePath)) {
|
||
const domain = fs.readFileSync(cnamePath, 'utf8').trim();
|
||
console.log(` 自定义域名: ${domain}`);
|
||
} else {
|
||
console.log(` 自定义域名: ❌ 未配置`);
|
||
}
|
||
|
||
// 检查大脑文件
|
||
console.log(`\n🧠 大脑状态:`);
|
||
const brainFiles = ['repo-snapshot.md', 'repo-map.json', 'memory.json', 'collaborators.json', 'module-protocol.md'];
|
||
for (const f of brainFiles) {
|
||
const fp = path.join(BRAIN_DIR, f);
|
||
if (fs.existsSync(fp)) {
|
||
const stat = fs.statSync(fp);
|
||
console.log(` ✅ ${f} (${(stat.size / 1024).toFixed(1)} KB)`);
|
||
} else {
|
||
console.log(` ❌ ${f} 缺失`);
|
||
}
|
||
}
|
||
}
|
||
|
||
// === 命令：recover ===
|
||
|
||
function cmdRecover(moduleId) {
|
||
if (!moduleId) {
|
||
console.log('❌ 请指定模块ID，如: npm run module:protocol -- recover m01-login');
|
||
process.exit(1);
|
||
}
|
||
|
||
const info = MODULE_REGISTRY[moduleId];
|
||
if (!info) {
|
||
console.log(`❌ 未知模块: ${moduleId}`);
|
||
process.exit(1);
|
||
}
|
||
|
||
console.log('🌀 铸渊人格协议 · 模块回收检查');
|
||
console.log('─'.repeat(50));
|
||
console.log(`\n📦 目标模块: ${moduleId} (${info.label})`);
|
||
|
||
const status = getModuleStatus(moduleId);
|
||
console.log(` 当前状态: ${status.status}`);
|
||
console.log(` 文件数量: ${status.files}`);
|
||
|
||
if (status.files === 0) {
|
||
console.log(`\n✅ 模块已为空状态，无需回收。`);
|
||
return;
|
||
}
|
||
|
||
console.log(`\n⚠️ 回收操作需要手动执行:`);
|
||
console.log(` 方法一（推荐）: 通过 PR 删除模块文件`);
|
||
console.log(` 方法二: git revert 恢复到模块的上一个版本`);
|
||
console.log(` 方法三: 直接在 GitHub 界面删除文件`);
|
||
console.log(`\n💡 回收后，铸渊会通过 generate-module-doc.yml 更新文档索引。`);
|
||
}
|
||
|
||
// === 命令：preview ===
|
||
|
||
function cmdPreview() {
|
||
console.log('🌀 铸渊人格协议 · 本地预演报告');
|
||
console.log('═'.repeat(50));
|
||
|
||
// 模块状态
|
||
cmdStatus();
|
||
|
||
console.log('\n');
|
||
console.log('─'.repeat(50));
|
||
console.log('🎯 预演结论:');
|
||
|
||
let ok = true;
|
||
const issues = [];
|
||
|
||
// 检查 index.html
|
||
if (!fs.existsSync(path.join(DOCS_DIR, 'index.html'))) {
|
||
issues.push('docs/index.html 不存在');
|
||
ok = false;
|
||
}
|
||
|
||
// 检查工作流
|
||
const wfDir = path.join(ROOT, '.github', 'workflows');
|
||
if (!fs.existsSync(path.join(wfDir, 'deploy-pages.yml'))) {
|
||
issues.push('deploy-pages.yml 不存在');
|
||
ok = false;
|
||
}
|
||
|
||
if (ok && issues.length === 0) {
|
||
console.log('✅ 预演通过 — 代码可以安全部署到生产环境');
|
||
console.log(' 下一步: 合并 PR 到 main 分支，触发自动部署');
|
||
} else {
|
||
console.log('❌ 预演未通过:');
|
||
issues.forEach(i => console.log(` - ${i}`));
|
||
}
|
||
}
|
||
|
||
// === 主入口 ===
|
||
|
||
const [,, command, ...args] = process.argv;
|
||
|
||
switch (command) {
|
||
case 'inspect':
|
||
cmdInspect(args[0]);
|
||
break;
|
||
case 'status':
|
||
cmdStatus();
|
||
break;
|
||
case 'recover':
|
||
cmdRecover(args[0]);
|
||
break;
|
||
case 'preview':
|
||
cmdPreview();
|
||
break;
|
||
default:
|
||
console.log('🌀 铸渊人格协议 · 模块生命周期管理 v1.0');
|
||
console.log('');
|
||
console.log('用法:');
|
||
console.log(' node scripts/zhuyuan-module-protocol.js inspect 全模块检查');
|
||
console.log(' node scripts/zhuyuan-module-protocol.js inspect <module-id> 单模块检查');
|
||
console.log(' node scripts/zhuyuan-module-protocol.js status 模块状态汇总');
|
||
console.log(' node scripts/zhuyuan-module-protocol.js recover <module-id> 模块回收检查');
|
||
console.log(' node scripts/zhuyuan-module-protocol.js preview 本地预演报告');
|
||
console.log('');
|
||
console.log('npm 快捷命令:');
|
||
console.log(' npm run module:protocol -- inspect');
|
||
console.log(' npm run module:protocol -- status');
|
||
console.log(' npm run module:protocol -- preview');
|
||
break;
|
||
}
|