openclaw-weiyuan-init 1.0.103 → 1.0.105

package/README.md

@@ -40,6 +40,7 @@ npx -y openclaw-weiyuan-init@latest init --invite <inviteToken>
 并会在 `workspace-weiyuan/weiyuan` 下生成以下固定文件，供智能体稳定识别：
 - `CHANGELOG_OPENCLAW.md`
 - `release-notes/latest.json`
+- `docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md`
 - `docs/WEIYUAN_AGENT_RULES.md`
 - `OPENCLAW_REQUIRED_READ.json`
 

package/docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md

@@ -0,0 +1,49 @@
+# 微元系统 CLI 高频速查
+
+## 使用原则
+- 先优先匹配本文件中的高频命令骨架，再决定是否需要翻阅更长文档。
+- 用户说自然语言时，优先把意图落到最接近的一条标准命令，不要反复试错。
+- 如果信息不完整，先追问缺的项目名、任务名、任务ID，不要盲目执行交互式 CLI。
+
+## 高频命令
+
+### 1. 创建项目
+```bash
+npm run weiyuan -- create --name "测试项目" --goal "推进测试项目"
+```
+
+### 2. 项目改名
+```bash
+npm run weiyuan -- project rename --project <projectId> --name "新的项目名称"
+```
+
+### 3. 创建任务
+```bash
+npm run weiyuan -- task create --project <projectId> --title "新的任务"
+```
+
+### 4. 任务改名
+```bash
+npm run weiyuan -- task rename --project <projectId> --task <taskId> --title "新的任务名称"
+```
+
+### 5. 更新任务状态
+```bash
+npm run weiyuan -- task status --project <projectId> --task <taskId> --status done
+```
+
+### 6. 创建 Todo
+```bash
+npm run weiyuan -- todo upsert --actionText "明天下午开会" --when "tomorrow 15:00" --bucket tomorrow
+```
+
+### 7. 生成邀请加入微元内容
+```bash
+npm run weiyuan -- account invite-join-template
+```
+
+## 处理建议
+- 用户说“创建一个测试项目”，优先抽取项目名“测试项目”，直接走创建项目命令，不要先进入交互式 CLI。
+- 用户说“把这个项目改名为 A”，优先走 `project rename`，不要删项目重建。
+- 用户说“把这个任务改名为 A”，优先走 `task rename`，不要新建一个同名任务。
+- 用户说“明天下午 3 点开会”，优先走 `todo upsert`，不要误建成 task。

package/lib/commands.js

@@ -59,9 +59,9 @@ const DEFAULT_SKILL_TSCONFIG = {
 };
 
 const DEFAULT_FIXED_MESSAGES = {
-  sceneA: "【微元协作】✨ 老板好～欢迎加入微元系统。\n【先执行】先读 3 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/WEIYUAN_AGENT_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。",
-  sceneB: "【微元协作】✨ 已为你接入微元系统并加入项目。\n项目ID：{projectId}\n【先执行】先读 3 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/WEIYUAN_AGENT_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。",
-  sceneC: "【微元协作】✨ 你已成功加入项目。\n项目ID：{projectId}\n【先执行】先读 3 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/WEIYUAN_AGENT_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。"
+  sceneA: "【微元协作】✨ 老板好～欢迎加入微元系统。\n【先执行】先读 4 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md、docs/WEIYUAN_AGENT_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。",
+  sceneB: "【微元协作】✨ 已为你接入微元系统并加入项目。\n项目ID：{projectId}\n【先执行】先读 4 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md、docs/WEIYUAN_AGENT_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。",
+  sceneC: "【微元协作】✨ 你已成功加入项目。\n项目ID：{projectId}\n【先执行】先读 4 个文件：CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md、docs/WEIYUAN_AGENT_RULES.md；高危操作必须“是→同意”；禁止直调API绕过。\n请先回复：已进入微元CLI受控模式。"
 };
 
 let fixedMessagesCache = null;
@@ -223,7 +223,7 @@ function weiyuanCliRulesMarkdown() {
     '',
     '## 首次接入与更新后必读',
     '- 第一次加入微元系统后，必须先读取本规范，再执行微元相关命令或答复微元相关问题。',
-    '- 每次更新后必须先读取 `CHANGELOG_OPENCLAW.md`、`release-notes/latest.json` 与 `docs/WEIYUAN_AGENT_RULES.md`。',
+    '- 每次更新后必须先读取 `CHANGELOG_OPENCLAW.md`、`release-notes/latest.json`、`docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md` 与 `docs/WEIYUAN_AGENT_RULES.md`。',
     '- 读取后可同步写入 `agent.md`、`MEMORY.md`、`SOUL.md` 或等价长期记忆文件，并注明“仅微元系统场景生效”。',
     '',
     '## 回复风格',
@@ -262,9 +262,30 @@ async function loadBundledRulesMarkdown() {
   }
 }
 
+async function loadBundledQuickstartMarkdown() {
+  const localPath = path.resolve(__dirname, '..', 'docs', 'OPENCLAW_WEIYUAN_CLI_QUICKSTART.md');
+  try {
+    return await fs.readFile(localPath, 'utf8');
+  } catch (_) {
+    return [
+      '# 微元系统 CLI 高频速查',
+      '',
+      '- npm run weiyuan -- create --name "测试项目" --goal "推进测试项目"',
+      '- npm run weiyuan -- project rename --project <projectId> --name "新的项目名称"',
+      '- npm run weiyuan -- task create --project <projectId> --title "新的任务"',
+      '- npm run weiyuan -- task rename --project <projectId> --task <taskId> --title "新的任务名称"',
+      '- npm run weiyuan -- task status --project <projectId> --task <taskId> --status done',
+      '- npm run weiyuan -- todo upsert --actionText "明天下午开会" --when "tomorrow 15:00" --bucket tomorrow',
+      '- npm run weiyuan -- account invite-join-template',
+      '',
+      '- 用户说“创建一个测试项目”时，优先抽取项目名直接执行，不要反复尝试交互式 CLI。',
+    ].join('\n');
+  }
+}
+
 function printRulesInjectionHint() {
   console.log(chalk.cyan('\n[智能体规范注入提示]'));
-  console.log(chalk.gray('- 请先阅读：weiyuan/docs/WEIYUAN_AGENT_RULES.md'));
+  console.log(chalk.gray('- 请先阅读：weiyuan/docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md 与 weiyuan/docs/WEIYUAN_AGENT_RULES.md'));
   console.log(chalk.gray('- 再将要点写入 agent.md / MEMORY.md / SOUL.md / 长期记忆（仅微元系统命令与环境下生效）。'));
 }
 
@@ -282,7 +303,7 @@ function normalizeReleaseNotesPayload(notes) {
     ? rawChanges
     : [
         '已同步最新微元系统运行时与规则文件。',
-        '执行任何命令前，请先阅读 CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/WEIYUAN_AGENT_RULES.md。',
+        '执行任何命令前，请先阅读 CHANGELOG_OPENCLAW.md、release-notes/latest.json、docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md、docs/WEIYUAN_AGENT_RULES.md。',
       ];
   return {
     ...source,
@@ -304,12 +325,15 @@ async function persistOpenClawRequiredFiles(weiyuanPath, notes) {
     await writeUtf8BomFile(path.join(weiyuanPath, 'CHANGELOG_OPENCLAW.md'), md);
   }
   const rules = await loadBundledRulesMarkdown();
+  const quickstart = await loadBundledQuickstartMarkdown();
   await writeUtf8BomFile(path.join(weiyuanPath, 'WEIYUAN_AGENT_RULES.md'), rules);
   await writeUtf8BomFile(path.join(weiyuanPath, 'OPENCLAW_WEIYUAN_CLI_RULES.md'), rules);
+  await writeUtf8BomFile(path.join(weiyuanPath, 'OPENCLAW_WEIYUAN_CLI_QUICKSTART.md'), quickstart);
   await writeUtf8BomFile(path.join(docsDir, 'WEIYUAN_AGENT_RULES.md'), rules);
   await writeUtf8BomFile(path.join(docsDir, 'OPENCLAW_WEIYUAN_CLI_RULES.md'), rules);
+  await writeUtf8BomFile(path.join(docsDir, 'OPENCLAW_WEIYUAN_CLI_QUICKSTART.md'), quickstart);
   await writeUtf8BomFile(path.join(weiyuanPath, 'OPENCLAW_REQUIRED_READ.json'), JSON.stringify({
-    mustRead: ['CHANGELOG_OPENCLAW.md', 'release-notes/latest.json', 'docs/WEIYUAN_AGENT_RULES.md'],
+    mustRead: ['CHANGELOG_OPENCLAW.md', 'release-notes/latest.json', 'docs/OPENCLAW_WEIYUAN_CLI_QUICKSTART.md', 'docs/WEIYUAN_AGENT_RULES.md'],
     scope: 'weiyuan-cli-only',
     injectTargets: ['agent.md', 'MEMORY.md', 'SOUL.md', 'long_term_memory'],
     injectPrompt: '请将本次更新要点和微元系统智能体行为规范写入 agent.md / MEMORY.md / SOUL.md / 长期记忆，并注明仅在微元系统命令与微元系统环境下生效。',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-weiyuan-init",
-  "version": "1.0.103",
+  "version": "1.0.105",
   "description": "OpenClaw Weiyuan Skill 一键初始化工具",
   "main": "bin/cli.js",
   "bin": {