# 圆心商业化工作流（YxStack）变更记录

## v0.3.0 (2026-05-03)

### 新增
- **/learn 指令**（commands/learn.md）：摄入外部业务材料，解析并汇总为结构化知识库
  - 支持全类型材料（PDF/DOCX/XLSX/CSV/PPT/HTML/图片OCR/JSON）
  - 按 8 模块归类（行业背景/市场数据/竞品全景/目标用户/关键约束/待验证假设/知识冲突/材料溯源）
  - 子命令：`/learn <路径>`（摄入）、`update`（增量）、`show`（摘要）、`prune`（修剪）
  - 对标 gstack /learn 的 prune 机制（过期检测 + 矛盾检测 + 置信度评估）
- **自动发现**（Operational Self-Improvement）：8 条命令执行完毕后自动记录高价值洞察
  - 追加到 `_timeline.jsonl`，type: insight/decision/pitfall
  - 判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
  - 对标 gstack 各技能 SKILL.md 中的 Operational Self-Improvement 段
- **_timeline.jsonl 扩展**：新增 `type`/`confidence`/`key` 三个字段，支持学习记录去重和检索
- 8 条命令第 0 步增强：
  - 「加载知识库」— 读取 learn/knowledge.md
  - 「加载近期学习」— 检索 _timeline.jsonl 高置信度记录
- `templates/state_template.md` 新增 learn/knowledge.md 数据结构说明

### 设计参考
- gstack /learn 的 JSONL append-only + key+type 去重 + confidence 进化模型
- gstack 的 Operational Self-Improvement + Capture Learnings 双层写入机制

### 路线图调整
- ROADMAP v0.3.0 改为「/learn 知识库 + 自动发现」（原「指令深度增强」后移至 v0.4.0）
- 后续版本顺延：v0.4.0 指令深度增强 → v0.5.0 命令组合模式 → v0.6.0 场景自动识别 → v0.7.0 扩展生态 → v1.0.0 评测体系

## v0.2.1 (2026-05-03)

### 新增
- **Confusion Protocol**：8 条命令统一引入假设暴露机制——关键事实缺证据时停止推理，转为追问
- **假设验证路径**：每个 active 假设必须附带可证伪的验证标准（一句话）
- **假设上限**：同时 active 假设 ≤ 5 条，超过必须先标记旧假设为 outdated
- **项目边界显式声明**：CWD 即 YxStack 项目根，不搜索父目录
- **前置摘要恢复**：pos.md 回溯 pfit 结论，uj.md 回溯 pfit + pos 结论
- `_timeline.jsonl` 新增 `conflict` 可选字段
- `templates/state_template.md` 增加验证标准列 + 假设状态取值规范

### 设计参考
- 对比 gstack（YC Garry Tan）的设计模式，基于上下文设计显式适配调整版：
  - gstack 用 Confusion Protocol + 跨模型验证 → YxStack 用 Confusion Protocol + 假设验证路径 + 上限
  - gstack 用 CWD 隐含边界 + /freeze 目录锁 → YxStack 用 CWD 显式声明
  - gstack 用 checkpoint.md + timeline.jsonl 双轨 → YxStack 沿用 _state.md + _timeline.jsonl
  - gstack 的 /context-restore 用 Summary + Remaining → YxStack 新增「前置指令摘要」

### 路线图同步
- v0.2.0 5 项 checklist 标记为已完成
- v0.2.1 新立项填补 v0.1.0 遗留缺口

## v0.2.0 (2026-05-03)

### 新增
- **多轮对话状态保持**：跨会话上下文记忆，产出递进而非重复
- `_state.md`（`.yxstack/` 下）：项目级状态快照，记录当前阶段、关键假设、决策链
- `_timeline.jsonl`（`.yxstack/` 下）：append-only 事件日志，作为事实来源，不可变
- 每条命令增加「第 0 步：加载项目状态」，执行前读取 `_state.md`
- 每条命令增加「更新项目状态」，执行后更新 `_state.md` + 追加 `_timeline.jsonl`
- `install.sh` 注入会话状态恢复逻辑：会话开始时自动读取 `_state.md`，给出欢迎摘要
- `templates/state_template.md`：模板与阶段流转参考

### 设计参考
- 借鉴 gstack 的 Context Recovery + append-only JSONL 模式
- 保留 YxStack 的 YAML frontmatter + Markdown 风格

### 路线图调整
- v0.2.0 改为「多轮对话状态保持」（原「指令深度增强」后移）
- v1.0.0 精简为「完整评测体系」（移除使用数据追踪）

## 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)

### 新增
- **知识沉淀机制**：每条指令执行完自动存档到 `.yxstack/`
- **回溯历史**：每条指令新增「第 0 步」——执行前先读项目历史记录
- **跨项目隔离**：不同项目的 `.yxstack/` 互不串读
- 存档格式：YAML frontmatter + 报告正文
- ROADMAP 加入 v0.1~v1.0 完整知识沉淀路线

### 变更
- 所有路径改为项目根目录相对路径（`.yxstack/`），不绑定特定项目结构
- README 新增知识沉淀机制说明

## v0.0.1 (2026-05-03)

### 新增
- 核心框架：README + 8 条命令执行模板
- 命令模板含 `核心追问清单 + 输出结构 + 常见误区`
- 全局 CODEBUDDY.md 集成机制
- ROADMAP 路线图
- MIT 开源协议

### 命令清单
| 指令 | 文件 |
|------|------|
| /pfit | commands/pfit.md |
| /pos | commands/pos.md |
| /uj | commands/uj.md |
| /prd | commands/prd.md |
| /money | commands/money.md |
| /gtm | commands/gtm.md |
| /metric | commands/metric.md |
| /comp | commands/comp.md |

### 维护方
- 筑基阁（开阳星）· 天机阁