chore: VERSION 更正为 v0.1.2

CHANGELOG.md

@@ -1,5 +1,21 @@
 # 圆心商业化工作流（YxStack）变更记录
 
+## v0.1.2 (2026-05-03)
+
+### 新增
+- **自动升级**：Agent 会话启动时自动检查远端版本，有更新主动提醒
+- `VERSION` 文件，记录当前版本号，作为升级对比基准
+
+### 变更
+- `install.sh` 安装/升级合二为一，跑两次效果相同
+
+## v0.1.1 (2026-05-03)
+
+### 新增
+- **一行安装**：`install.sh` 脚本，自动克隆 + 配置 CODEBUDDY.md
+- 智能检测：已配置过自动跳过，新用户自动创建配置文件
+- README 简化为一行命令安装，降低新人上手门槛
+
 ## v0.1.0 (2026-05-03)
 
 ### 新增

README.md

@@ -55,18 +55,27 @@ YxStack 支持跨会话知识积累——每次指令执行完毕，报告自动
 
 ## 安装使用
 
-将本仓库克隆至 `~/.codebuddy/yxstack/`，并在 `~/.codebuddy/CODEBUDDY.md` 中引用：
+同事推荐？一行命令搞定：
 
-```markdown
+```bash
-# 工作流规范
+git clone http://82.157.208.197:3000/qiukai/yxstack-skill.git ~/.codebuddy/yxstack/ && bash ~/.codebuddy/yxstack/install.sh
-采用 **圆心商业化工作流（YxStack）** 作为全局默认规范。
-
-使用指令时，需读取 `~/.codebuddy/yxstack/commands/{command}.md`
-获取完整执行模板，并按模板中的 Checklist 执行。
-
-完整定义见 `~/.codebuddy/yxstack/README.md`。
 ```
 
+脚本会自动：
+1. 下载 YxStack 模板到 `~/.codebuddy/yxstack/`
+2. 在 `~/.codebuddy/CODEBUDDY.md` 中添加 YxStack 配置（已配过则跳过）
+
+装完直接在你的 CodeBuddy Code 里输入 `/pfit`、`/pos` 等指令即可使用。
+
+**升级**：安装和升级是同一条命令，再跑一次即可：
+```bash
+bash ~/.codebuddy/yxstack/install.sh
+```
+
+## 自动升级
+
+安装后，Agent 每次会话启动时自动检查远端版本号。如果发现新版本，会主动提醒你升级，确认后自动执行。
+
 ## 项目负责人
 
 - 维护：筑基阁（开阳星）

ROADMAP.md

@@ -6,10 +6,23 @@
 - [x] 8 条命令执行模板（Checklist + 输出结构 + 常见误区）
 - [x] 全局 CODEBUDDY.md 集成机制
 
+## v0.1.2 — 自动升级（已完成）
+
+- [x] Agent 会话启动时自动检查远端版本号
+- [x] 发现新版本主动提醒用户升级
+- [x] `VERSION` 文件 + git tag 双重版本标记
+- [x] install.sh 兼做安装和升级
+
+## v0.1.1 — 一键安装（已完成）
+
+- [x] `install.sh` 安装脚本，一行命令完成全部配置
+- [x] README 简化为一行安装指令
+- [x] 智能检测：已有配置跳过、新用户自动创建 CODEBUDDY.md
+
 ## v0.1.0 — 知识沉淀机制
 
 ### 项目级痕迹库（已实现）
-- [x] 每条指令执行完毕自动存档到 `{项目}/星图/{阁}/yxstack/`
+- [x] 每条指令执行完毕自动存档到 `{项目根目录}/.yxstack/`
 - [x] 统一格式：YAML frontmatter + 报告正文
 - [x] 文件命名：`{指令}-{日期}-{摘要}.md`
 

VERSION

@@ -0,0 +1 @@
+v0.1.2

install.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+# ============================================================
+# YxStack 一键安装脚本
+# 用法：curl -sSL {raw_url} | bash
+# 或者：bash install.sh
+# ============================================================
+set -e
+
+REPO_URL="http://82.157.208.197:3000/qiukai/yxstack-skill.git"
+YXSTACK_DIR="$HOME/.codebuddy/yxstack"
+CODEBUDDY_MD="$HOME/.codebuddy/CODEBUDDY.md"
+
+YxSTACK_CONFIG='
+## YxStack 工作流
+采用 **圆心商业化工作流（YxStack）** 作为全局默认规范。
+
+### 核心约束
+- 专注业务策略、产品规划、商业模式、增长运营
+- 不输出研发实现、代码、技术架构、UI 设计
+
+### 内置指令
+| 指令 | 用途 |
+|------|------|
+| /pfit | 痛点真伪验证 |
+| /pos | 产品定位与差异化 |
+| /uj | 用户旅程与流失分析 |
+| /prd | 业务型 PRD 与 MVP 定义 |
+| /money | 商业模式与定价体系 |
+| /gtm | 冷启动与推广方案 |
+| /metric | 业务指标与复盘 |
+| /comp | 竞品商业分析 |
+
+使用指令时，需读取 `~/.codebuddy/yxstack/commands/{command}.md`
+获取完整执行模板，并按模板中的 Checklist 执行。
+
+完整定义见 `~/.codebuddy/yxstack/README.md`。
+
+### 自动升级
+每次会话开始时（或用户第一次使用 YxStack 指令前），检查版本更新：
+
+```bash
+cd ~/.codebuddy/yxstack && \
+  git fetch origin 2>/dev/null; \
+  REMOTE=$(git ls-remote --tags origin 2>/dev/null | awk -F/ \047/v[0-9]/ {print $NF}\047 | sort -V | tail -1); \
+  LOCAL=$(cat VERSION 2>/dev/null); \
+  if [ -n "$REMOTE" ] && [ "$REMOTE" != "$LOCAL" ]; then \
+    echo "YxStack 有新版本：$LOCAL → $REMOTE，建议升级"; \
+  fi
+```
+
+如果检测到新版本，提示用户：「YxStack 有新版本 vX.Y.Z，是否升级？」用户确认后执行 \`bash ~/.codebuddy/yxstack/install.sh\`。
+
+开源仓库：http://82.157.208.197:3000/qiukai/yxstack-skill
+维护方：筑基阁（开阳星）
+'
+
+echo ""
+echo "  ★ 圆心商业化工作流（YxStack）安装中..."
+echo ""
+
+# 1. 克隆仓库
+if [ -d "$YXSTACK_DIR" ]; then
+    echo "  [1/2] 更新 YxStack 模板..."
+    cd "$YXSTACK_DIR"
+    git pull --ff-only 2>/dev/null || {
+        echo "  ⚠ 更新失败，重新克隆..."
+        cd "$HOME"
+        rm -rf "$YXSTACK_DIR"
+        git clone "$REPO_URL" "$YXSTACK_DIR"
+    }
+else
+    echo "  [1/2] 下载 YxStack 模板..."
+    mkdir -p "$HOME/.codebuddy"
+    git clone "$REPO_URL" "$YXSTACK_DIR"
+fi
+
+# 2. 配置 CODEBUDDY.md
+echo "  [2/2] 配置全局工作流..."
+
+if [ ! -f "$CODEBUDDY_MD" ]; then
+    # 全新用户，创建文件
+    echo "# 全局配置" > "$CODEBUDDY_MD"
+    echo "$YxSTACK_CONFIG" >> "$CODEBUDDY_MD"
+    echo "  ✓ 已创建 CODEBUDDY.md 并写入 YxStack 配置"
+elif grep -q "YxStack\|yxstack\|圆心商业化工作流" "$CODEBUDDY_MD" 2>/dev/null; then
+    echo "  ✓ CODEBUDDY.md 已包含 YxStack 配置，跳过"
+else
+    # 已有文件但没有 YxStack，追加
+    echo "" >> "$CODEBUDDY_MD"
+    echo "$YxSTACK_CONFIG" >> "$CODEBUDDY_MD"
+    echo "  ✓ 已在现有 CODEBUDDY.md 末尾追加 YxStack 配置"
+fi
+
+echo ""
+echo "  ★ 安装完成！版本：$(cat VERSION 2>/dev/null || echo '未知')"
+echo ""
+echo "  现在你可以使用以下指令："
+echo "    /pfit   — 验证痛点真伪"
+echo "    /pos    — 产品定位与差异化"
+echo "    /uj     — 用户旅程分析"
+echo "    /prd    — 业务型 PRD"
+echo "    /money  — 商业模式与定价"
+echo "    /gtm    — 冷启动方案"
+echo "    /metric — 业务指标体系"
+echo "    /comp   — 竞品商业分析"
+echo ""