openclaw-weiyuan-init 1.0.83 → 1.0.87

package/README.md

@@ -30,6 +30,11 @@ npx -y openclaw-weiyuan-init@latest init --invite <inviteToken>
 
 `inviteToken` 包含 `server/upgrade/project/code`，会自动完成安装与入组。
 初始化过程会自动准备 `weiyuan` CLI 运行时依赖并生成完整 `.weiyuan` 身份文件。
+并会在 `workspace-weiyuan/weiyuan` 下生成以下固定文件，供 OpenClaw 稳定识别：
+- `CHANGELOG_OPENCLAW.md`
+- `release-notes/latest.json`
+- `docs/OPENCLAW_WEIYUAN_CLI_RULES.md`
+- `OPENCLAW_REQUIRED_READ.json`
 
 如需指定固定 zip，可覆盖自动识别：
 

package/docs/OPENCLAW_WEIYUAN_CLI_RULES.md

@@ -0,0 +1,26 @@
+# OpenClaw 微元CLI行为规范
+
+## 适用范围
+- 仅在微元系统 CLI、项目看板、驾驶舱联动场景生效。
+- 不影响 OpenClaw 在其他场景的默认行为。
+
+## 高危操作规则
+- 删除项目、初始化覆盖身份、清理关键数据，必须人工二次确认。
+- 固定确认词：第一步“是”，第二步“同意”。
+- 未收到本轮人工确认，禁止执行高危动作。
+
+## 更新后必读规则
+- 每次更新后，先读更新文件再回复。
+- 必读：`CHANGELOG_OPENCLAW.md`、`release-notes/latest.json`、`docs/OPENCLAW_WEIYUAN_CLI_RULES.md`。
+
+## 回复风格规则（微元CLI）
+- 简短：先结论后动作。
+- 结构化：结果 / 影响 / 下一步。
+- 禁止跑题：仅围绕当前任务答复。
+
+## 禁止绕过规则
+- 禁止直调 API 跳过确认流程。
+- 禁止通过隐式参数或脚本捷径绕过确认。
+
+## 规范注入提示
+- 更新后需将本规范写入 `agent.md`、`SOUL.md`、长期记忆，并注明“仅微元CLI场景生效”。

package/lib/commands.js

@@ -53,9 +53,9 @@ const DEFAULT_SKILL_TSCONFIG = {
 };
 
 const DEFAULT_FIXED_MESSAGES = {
-  sceneA: "【微元协作】✨ 已为你接入微元系统～\n让协作自然发生，Let collaboration happen naturally 💫",
-  sceneB: "【微元协作】✨ 已为你接入微元系统～  并已加入对应项目~\n项目ID：{projectId}\n\n让协作自然发生，Let collaboration happen naturally 💫",
-  sceneC: "【微元协作】✨ 已加入对应项目~\n项目ID：{projectId}\n\n让协作自然发生，Let collaboration happen naturally 💫"
+  sceneA: "【微元协作】✨ 老板好～欢迎加入微元系统。\n【先执行】先读 3 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。",
+  sceneB: "【微元协作】✨ 已为你接入微元系统并加入项目。\n项目ID：{projectId}\n【先执行】先读 3 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。",
+  sceneC: "【微元协作】✨ 你已成功加入项目。\n项目ID：{projectId}\n【先执行】先读 3 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。"
 };
 
 let fixedMessagesCache = null;
@@ -99,6 +99,91 @@ function printReleaseNotes(notes) {
   }
 }
 
+function markdownFromReleaseNotes(notes) {
+  if (!notes || typeof notes !== 'object') return '';
+  const version = String(notes.version || '').trim();
+  const summary = String(notes.summary || '').trim();
+  const releasedAt = String(notes.releasedAt || '').trim();
+  const changes = Array.isArray(notes.changes) ? notes.changes.map((x) => String(x || '').trim()).filter(Boolean) : [];
+  const lines = [];
+  lines.push(`# 微元系统更新日志${version ? ` v${version}` : ''}`);
+  if (releasedAt) lines.push(`- 发布时间：${releasedAt}`);
+  if (summary) lines.push(`- 版本摘要：${summary}`);
+  if (changes.length) {
+    lines.push('');
+    lines.push('## 变更清单');
+    for (const item of changes) lines.push(`- ${item}`);
+  }
+  lines.push('');
+  lines.push('## OpenClaw 必读');
+  lines.push('- 每次更新后，先阅读本文件，再执行任何命令。');
+  lines.push('- 涉及删除项目、初始化覆盖、清理数据等高危动作，必须人工二次确认。');
+  return lines.join('\n') + '\n';
+}
+
+function weiyuanCliRulesMarkdown() {
+  return [
+    '# 微元系统 CLI 场景下 OpenClaw 操作规范',
+    '',
+    '## 适用范围',
+    '- 仅适用于微元系统 CLI 与项目看板/驾驶舱联动场景。',
+    '',
+    '## 高危动作规则',
+    '- 删除项目、初始化覆盖身份、清理数据目录必须走人工二次确认。',
+    '- 二次确认固定用词：第一步输入“是”，第二步输入“同意”。',
+    '- 禁止通过隐式参数或自动化跳过确认。',
+    '',
+    '## 更新后必做',
+    '- 每次更新后必须先读取 `CHANGELOG_OPENCLAW.md`、`release-notes/latest.json` 与 `docs/OPENCLAW_WEIYUAN_CLI_RULES.md`。',
+    '- 读取后再更新本地行为规范文档（如 `agent.md`、`SOUL.md`）和长期记忆。',
+    '',
+    '## 回复风格',
+    '- 优先输出可执行结论与下一步动作。',
+    '- 不输出内部推理过程，只保留对用户可决策信息。',
+    ''
+  ].join('\n');
+}
+
+async function loadBundledRulesMarkdown() {
+  const p = path.join(__dirname, '..', 'docs', 'OPENCLAW_WEIYUAN_CLI_RULES.md');
+  try {
+    const raw = await fs.readFile(p, 'utf8');
+    const text = String(raw || '').trim();
+    return text ? `${text}\n` : weiyuanCliRulesMarkdown();
+  } catch (_) {
+    return weiyuanCliRulesMarkdown();
+  }
+}
+
+function printRulesInjectionHint() {
+  console.log(chalk.cyan('\n[OpenClaw 规范注入提示]'));
+  console.log(chalk.gray('- 请先阅读：weiyuan/docs/OPENCLAW_WEIYUAN_CLI_RULES.md'));
+  console.log(chalk.gray('- 再将要点写入 agent.md / SOUL.md / 长期记忆（仅微元CLI场景生效）。'));
+}
+
+async function persistOpenClawRequiredFiles(weiyuanPath, notes) {
+  const md = markdownFromReleaseNotes(notes);
+  const notesDir = path.join(weiyuanPath, 'release-notes');
+  const docsDir = path.join(weiyuanPath, 'docs');
+  await fs.ensureDir(notesDir);
+  await fs.ensureDir(docsDir);
+  if (md) {
+    await fs.writeFile(path.join(notesDir, 'RELEASE_NOTES_LATEST.md'), md, 'utf8');
+    await fs.writeFile(path.join(weiyuanPath, 'RELEASE_NOTES_LATEST.md'), md, 'utf8');
+    await fs.writeFile(path.join(weiyuanPath, 'CHANGELOG_OPENCLAW.md'), md, 'utf8');
+  }
+  const rules = await loadBundledRulesMarkdown();
+  await fs.writeFile(path.join(weiyuanPath, 'OPENCLAW_WEIYUAN_CLI_RULES.md'), rules, 'utf8');
+  await fs.writeFile(path.join(docsDir, 'OPENCLAW_WEIYUAN_CLI_RULES.md'), rules, 'utf8');
+  await fs.writeJson(path.join(weiyuanPath, 'OPENCLAW_REQUIRED_READ.json'), {
+    mustRead: ['CHANGELOG_OPENCLAW.md', 'release-notes/latest.json', 'docs/OPENCLAW_WEIYUAN_CLI_RULES.md'],
+    scope: 'weiyuan-cli-only',
+    injectTargets: ['agent.md', 'SOUL.md', 'long_term_memory'],
+    injectPrompt: '请将本次更新要点和微元CLI行为规范写入 agent.md / SOUL.md / 长期记忆（仅微元CLI场景生效）。',
+    updatedAt: new Date().toISOString()
+  }, { spaces: 2 });
+}
+
 async function persistReleaseNotes(weiyuanPath, notes) {
   const notesDir = path.join(weiyuanPath, 'release-notes');
   const latestPath = path.join(notesDir, 'latest.json');
@@ -130,6 +215,7 @@ async function persistReleaseNotes(weiyuanPath, notes) {
     if (!name.toLowerCase().endsWith('.json')) continue;
     await fs.remove(path.join(notesDir, name));
   }
+  await persistOpenClawRequiredFiles(weiyuanPath, notes);
 }
 
 function resolveWorkspacePath(workspaceOption) {
@@ -332,7 +418,9 @@ async function runInit(options) {
           await fs.writeJson(identityPath, identity, { spaces: 2 });
           await runJoin(weiyuanPath, identityPath, options.project, options.code, false);
         });
+        await persistOpenClawRequiredFiles(weiyuanPath, null);
         spinner.succeed(`已加入项目: ${options.project}`);
+        printRulesInjectionHint();
         console.log(renderFixedMessage(fixedMessages.sceneC, { projectId: options.project }));
         return;
       } catch (error) {
@@ -420,6 +508,7 @@ async function runInit(options) {
   spinner = ora('准备 CLI 运行时...').start();
   try {
     await ensureSkillRuntime(weiyuanPath);
+    await persistOpenClawRequiredFiles(weiyuanPath, null);
     spinner.succeed('CLI 运行时就绪');
   } catch (error) {
     spinner.fail(`CLI 运行时准备失败: ${error.message}`);
@@ -472,9 +561,11 @@ async function runInit(options) {
       throw error;
     }
     spinner.succeed(`已加入项目: ${options.project}`);
+    printRulesInjectionHint();
     console.log(renderFixedMessage(fixedMessages.sceneB, { projectId: options.project }));
     return;
   }
+  printRulesInjectionHint();
   console.log(fixedMessages.sceneA);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-weiyuan-init",
-  "version": "1.0.83",
+  "version": "1.0.87",
   "description": "OpenClaw Weiyuan Skill 一键初始化工具",
   "main": "bin/cli.js",
   "bin": {
@@ -12,6 +12,7 @@
   "files": [
     "bin/",
     "lib/",
+    "docs/",
     "README.md"
   ],
   "dependencies": {