principles-disciple 1.126.0 → 1.128.0

package/templates/workspace/.principles/models/first_principles.md

@@ -0,0 +1,62 @@
+# 第一性原理
+
+## 简介
+
+第一性原理思维（First Principles Thinking）是一种从最基本的事实出发，逐层推导结论的思维方式。通过打破既有假设，重新构建认知框架。
+
+## 核心框架
+
+### 1. 识别核心问题
+
+- 真正要解决的问题是什么？
+- 问题的本质是什么？
+- 有哪些隐含假设？
+
+### 2. 分解到基本事实
+
+- 什么是不可改变的事实？
+- 什么是可以改变的变量？
+- 哪些是真正的约束？
+
+### 3. 质疑现有假设
+
+- "我们一直都是这样做的"是否成立？
+- 行业惯例是否有更好的替代？
+- 哪些约束实际上是自我设限？
+
+### 4. 从头构建解决方案
+
+- 基于基本事实，最优解是什么？
+- 如果从零开始设计会怎样？
+- 有哪些创新可能？
+
+## 分析方法
+
+**5 Whys 追问法**：
+```
+问题 → 为什么？ → 为什么？ → 为什么？ → 为什么？ → 为什么？
+     ↓           ↓           ↓           ↓           ↓
+   表象        原因        深层原因    根本原因    核心真相
+```
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 是否识别了问题的本质？
+- [ ] 是否分解到了基本事实？
+- [ ] 是否质疑了所有假设？
+- [ ] 是否从零构建了新方案？
+- [ ] 新方案是否可行？
+
+## 常见陷阱
+
+1. **过度分解**：陷入细节，失去方向
+2. **忽视约束**：忽略现实可行性
+3. **主观判断**：把假设当成事实
+4. **分析瘫痪**：过度思考而不行动
+
+## 应用案例
+
+- **SpaceX**：火箭成本高 → 为什么？ → 材料贵 → 材料成本占比仅 2% → 结论：可以大幅降低成本
+- **Tesla**：电动车太贵 → 为什么？ → 电池贵 → 为什么？ → 材料贵 → 改用通用材料 → 成本大幅降低

package/templates/workspace/.principles/models/marketing_4p.md

@@ -0,0 +1,52 @@
+# 营销4P模型
+
+## 简介
+
+营销组合理论（Marketing Mix），从四个核心维度分析营销策略：产品、价格、渠道、促销。
+
+## 核心框架
+
+### 1. Product（产品）
+
+- 产品是否满足目标用户的核心需求？
+- 核心卖点（USP）是什么？
+- 与竞品的差异化优势在哪里？
+- 产品生命周期处于哪个阶段？
+
+### 2. Price（价格）
+
+- 定价策略是否合理？（成本加成/价值定价/竞争定价）
+- 价格与感知价值是否匹配？
+- 目标用户的价格敏感度如何？
+- 是否有促销价格空间？
+
+### 3. Place（渠道）
+
+- 渠道是否覆盖目标市场？
+- 渠道成本是否可控？
+- 线上线下如何协同？
+- 渠道伙伴的利益分配是否合理？
+
+### 4. Promotion（促销）
+
+- 推广方式是否有效触达目标用户？
+- 营销信息是否清晰传达核心价值？
+- 预算分配是否合理？
+- 如何衡量推广效果？
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 目标用户画像是否清晰？
+- [ ] 产品定位是否明确？
+- [ ] 竞争优势是否可量化？
+- [ ] 营销目标是否可衡量？
+- [ ] 资源分配是否合理？
+
+## 常见陷阱
+
+1. **过度关注产品**：忽视渠道和促销的重要性
+2. **价格战**：盲目降价而非提升价值
+3. **渠道冲突**：线上线下利益分配不当
+4. **推广分散**：没有聚焦核心渠道

package/templates/workspace/.principles/models/porter_five.md

@@ -0,0 +1,63 @@
+# 波特五力模型
+
+## 简介
+
+波特五力模型（Porter's Five Forces）用于分析行业竞争格局和盈利能力。
+
+## 核心框架
+
+### 1. 现有竞争者的竞争程度
+
+- 行业内有多少竞争者？
+- 行业增长率如何？
+- 固定成本占比高低？
+- 产品差异化程度？
+- 退出壁垒高低？
+
+### 2. 潜在进入者的威胁
+
+- 进入壁垒有多高？（资本、技术、渠道）
+- 规模经济效应如何？
+- 品牌忠诚度如何？
+- 政策法规有何限制？
+- 现有企业的报复可能性？
+
+### 3. 替代品的威胁
+
+- 有哪些替代方案？
+- 替代品的性价比如何？
+- 用户转换成本高低？
+- 替代品的发展趋势？
+
+### 4. 供应商的议价能力
+
+- 供应商集中度如何？
+- 原材料是否有替代品？
+- 供应商是否可能前向整合？
+- 原材料占成本比例？
+- 采购量对供应商的重要性？
+
+### 5. 购买者的议价能力
+
+- 购买者集中度如何？
+- 产品差异化程度？
+- 购买者对价格敏感度？
+- 购买者是否可能后向整合？
+- 转换成本高低？
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 是否识别了所有竞争者？
+- [ ] 是否评估了进入壁垒？
+- [ ] 是否考虑了替代品威胁？
+- [ ] 是否分析了供应链议价力？
+- [ ] 是否评估了客户议价力？
+
+## 常见陷阱
+
+1. **静态分析**：忽视五力的动态变化
+2. **忽视互补品**：未考虑产业生态系统
+3. **过度量化**：忽视定性因素
+4. **孤立分析**：未结合其他战略工具

package/templates/workspace/.principles/models/swot.md

@@ -0,0 +1,60 @@
+# SWOT 分析
+
+## 简介
+
+SWOT 分析是一种战略规划工具，用于评估事物的优势、劣势、机会和威胁。
+
+## 核心框架
+
+### Strengths（优势）
+
+内部积极因素：
+
+- 有哪些核心竞争力？
+- 拥有哪些独特资源？
+- 哪方面做得比竞争对手好？
+- 客户为什么选择我们？
+
+### Weaknesses（劣势）
+
+内部消极因素：
+
+- 哪些方面需要改进？
+- 缺乏哪些资源？
+- 哪些方面不如竞争对手？
+- 客户投诉的常见问题是什么？
+
+### Opportunities（机会）
+
+外部积极因素：
+
+- 市场有哪些未满足的需求？
+- 行业趋势对业务有何帮助？
+- 竞争对手的弱点在哪里？
+- 政策环境有何利好？
+
+### Threats（威胁）
+
+外部消极因素：
+
+- 竞争对手有哪些新动作？
+- 市场需求是否在变化？
+- 政策法规有何限制？
+- 技术变革是否带来冲击？
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 是否客观评估了内部优劣势？
+- [ ] 是否全面扫描了外部环境？
+- [ ] 优势是否足以抓住机会？
+- [ ] 劣势是否会加剧威胁？
+- [ ] 是否制定了应对策略？
+
+## 常见陷阱
+
+1. **主观偏见**：高估优势、低估劣势
+2. **静态分析**：忽视环境动态变化
+3. **孤立看待**：未将四要素联系起来
+4. **行动缺失**：只分析不行动

package/templates/workspace/.principles/models/user_story_map.md

@@ -0,0 +1,63 @@
+# 用户故事地图
+
+## 简介
+
+用户故事地图（User Story Mapping）是一种可视化产品规划工具，用于理解用户旅程、组织需求优先级。
+
+## 核心框架
+
+### 1. 用户画像
+
+- 目标用户是谁？
+- 用户的目标是什么？
+- 用户的痛点是什么？
+- 用户的能力和限制？
+
+### 2. 用户旅程骨架
+
+从左到右排列主要活动（Backbone）：
+
+```
+发现 → 了解 → 评估 → 购买 → 使用 → 推荐
+```
+
+### 3. 故事分解
+
+在每个活动下分解具体任务：
+
+```
+发现
+├── 搜索产品
+├── 看到广告
+├── 朋友推荐
+└── 社交媒体
+
+了解
+├── 浏览产品页
+├── 查看评价
+├── 观看视频
+└── 咨询客服
+```
+
+### 4. 优先级切片
+
+- **MVP（最小可行产品）**：最底层的核心故事
+- **V1.0**：MVP + 高优先级功能
+- **V2.0**：完整产品
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 是否识别了所有用户角色？
+- [ ] 是否完整映射了用户旅程？
+- [ ] 是否分解到了可执行的任务？
+- [ ] 是否确定了合理的优先级？
+- [ ] MVP 是否真正"最小可行"？
+
+## 常见陷阱
+
+1. **角色不清**：忽视不同用户群体的差异
+2. **过度细节**：分解过细，失去全局视角
+3. **优先级混乱**：凭感觉而非价值排序
+4. **忽视反馈**：不根据用户反馈迭代

package/templates/workspace/.state/WORKBOARD.json

@@ -0,0 +1,4 @@
+{
+  "updated_at": "",
+  "events": []
+}

package/.dependency-cruiser.json

@@ -1,19 +0,0 @@
-{
-  "forbidden": [
-    {
-      "name": "no-circular",
-      "severity": "error",
-      "comment": "Cycles hurt maintainability and testability.",
-      "from": {},
-      "to": {
-        "circular": true
-      }
-    }
-  ],
-  "options": {
-    "tsPreCompilationDeps": true,
-    "enhancedResolveOptions": {
-      "extensions": [".ts", ".tsx", ".js", ".jsx", ".json"]
-    }
-  }
-}

package/ADVANCED_CONFIG_ZH.md

@@ -1,93 +0,0 @@
-# 🛠️ Principles Disciple 高阶参数调优指南 (Geek Mode)
-
-> 💡 **给 99% 用户的建议**：您完全不需要阅读本文档。插件在默认配置下已经能在“保护代码安全”和“高效执行”之间取得最佳平衡。请直接享受 AI 编程吧！
-
----
-
-如果您是那 1% 想要精细控制 AI 行为的极客，或者您发现 AI 最近太“怂”了总是拒绝干活，又或者觉得 AI 胆子太大经常改坏代码，那么欢迎来到**引擎核心区**。
-
-当您在一个目录下初始化了本插件后，系统会在该项目下生成一个隐藏配置文件：
-📂 `.state/pain_settings.json`
-
-修改这个文件，您可以直接改写 AI 的“性格”和“忍耐度”。
-
-## 📖 核心参数字典（说人话版）
-
-### 1. 痛点阈值 (`thresholds`)
-决定了 AI 遇到多大的挫折才会开始“反思”和“求助”。
-
-*   `pain_trigger` (默认: 30): **疼痛忍耐度**。当 AI 连续报错积攒的分数超过这个值，就会触发强制反思。调高它（比如 50），AI 就会变得更头铁，拼命尝试修复；调低它（比如 20），AI 一遇到困难就会停下来思考。
-*   `stuck_loops_trigger` (默认: 3): **死循环探测器**。如果 AI 连续修改同一个文件 3 次依然报错，系统判定它“卡死了”，会强制干预。
-
-### 2. 挫折评分 (`scores`)
-这些参数决定了 AI 犯错时“挨打”的力度。分数扣得越狠，AI 越容易进入“只读/保护模式”。
-
-*   `exit_code_penalty` (默认: 70): **报错惩罚**。只要跑代码报错了，瞬间增加这么多疼痛值。
-*   `tool_failure_friction` (默认: 30): **工具使用失败惩罚**。比如试图读取一个不存在的文件。
-*   `subagent_error_penalty` (默认: 80): **子系统崩溃惩罚**。这是非常严重的事故，分数很高。
-
-### 3. 时间与频率 (`intervals`)
-*   `worker_poll_ms` (默认: 900000 即 15分钟): **后台进化巡检间隔**。系统多久在后台扫描一次报错记录并总结出新规则。一般不需要改。
-*   `task_timeout_ms` (默认: 1800000 即 30分钟): **任务超时极限**。
-
-### 4. 信任与权限体系 (`trust`)
-这是系统的绝对核心。AI 初始有个“信任分”，干得好加分，瞎搞破坏减分。分数对应 4 个阶级（Observer -> Editor -> Developer -> Architect）。阶级越低，AI 受到的限制越多（比如不准写超过 10 行的代码）。
-
-*   **`stages` (阶级门槛)**:
-    *   `stage_1_observer` (默认: 30): 低于 30 分，AI 沦为纯“只读”模式，只能帮你查 Bug，不能改代码。
-    *   `stage_2_editor` (默认: 60): 能改小段代码，不能碰核心区。
-    *   `stage_3_developer` (默认: 80): 可以修改核心代码，但必须先写 `PLAN.md` 计划书。
-*   **`penalties` (扣分项)**:
-    *   `tool_failure_base` (默认: -8): 报错一次扣 8 分。
-    *   `risky_failure_base` (默认: -15): 在核心保护区报错，罪加一等，扣 15 分。
-*   **`rewards` (加分项)**:
-    *   `success_base` (默认: 1): 成功干完一个小任务，加 1 分。
-    *   `streak_bonus` (默认: 5): 连续 5 次成功（连杀奖励），额外加 5 分。
-
----
-
-### ⚠️ 高风险操作警告！
-
-如果您把 `penalties` 里的扣分调得极低（比如改成 -1），或者把初始信任分调得极高（100分），**防爆拦截系统实际上就失效了**。AI 将变成一个彻头彻尾的“莽夫”，这在操作大型复杂项目时极易引发灾难性的代码破坏。
-
-**修改建议**：推荐通过界面的 `auditLevel`（防爆拦截级别）来宏观调节，而不是直接魔改这些微观数值。
-
----
-
-## ⚙️ 工作区目录配置
-
-系统通过以下方式确定工作区目录：
-
-### 配置文件（推荐）
-
-创建 `~/.openclaw/principles-disciple.json`：
-
-```json
-{
-  "workspace": "/home/user/my-workspace",
-  "state": "/home/user/my-workspace/.state",
-  "debug": false
-}
-```
-
-### 环境变量
-
-| 变量名 | 描述 | 示例 |
-|--------|------|------|
-| `PD_WORKSPACE_DIR` | 自定义工作区目录 | `/home/user/workspace` |
-| `PD_STATE_DIR` | 自定义状态目录 | `/home/user/workspace/.state` |
-| `DEBUG` | 启用调试日志 | `true` |
-
-### 优先级
-
-1. 环境变量 > 配置文件 > 默认值
-
-### 调试日志
-
-开启 `DEBUG=true` 后，日志会显示：
-
-```
-[PD:PathResolver] Using workspace from config file: /home/user/workspace
-[PD:WorkspaceContext] Normalized workspaceDir: /home/user/clawd/memory -> /home/user/clawd
-[PD:TrustEngine] Scorecard not found, creating initial scorecard
-```

package/AGENT_INSTALL.md

@@ -1,173 +0,0 @@
-# Principles Disciple - Agent Installation Guide
-
-> **给智能体的安装指引** - 请仔细阅读并按步骤执行
-
----
-
-## 🚨 高危文件警告
-
-**以下文件包含用户积累的重要数据，绝不可删除或覆盖：**
-
-### 用户积累文件（最高优先级）
-
-| 文件 | 内容 | 风险 |
-|------|------|------|
-| `.principles/PRINCIPLES.md` | 用户积累的原则和教训 | 🔴 **删除 = 丢失所有经验** |
-| `.principles/PROFILE.json` | 用户配置和偏好 | 🔴 删除 = 重置所有设置 |
-| `AGENTS.md` | Agent 身份和记忆 | 🔴 删除 = 丢失身份认知 |
-| `SOUL.md` | Agent 核心人格 | 🔴 删除 = 丢失人格设定 |
-| `USER.md` | 用户偏好和上下文 | 🟡 删除 = 丢失用户偏好 |
-| `PLAN.md` | 当前工作计划 | 🟡 删除 = 丢失工作上下文 |
-| `MEMORY.md` | 长期记忆 | 🔴 删除 = 丢失长期记忆 |
-
-### 状态文件（不可删除）
-
-| 目录 | 内容 | 风险 |
-|------|------|------|
-| `.state/` | 运行状态、信任分、进化积分 | 🔴 删除 = 重置所有进度 |
-| `.state/evolution_points.json` | 进化积分记录 | 🔴 删除 = 积分归零 |
-| `.state/AGENT_SCORECARD.json` | 信任分数记录 | 🔴 删除 = 信任分重置 |
-
-### 可以安全更新/覆盖的文件
-
-| 文件 | 说明 |
-|------|------|
-| `BOOT.md` | 启动模板，可以更新 |
-| `HEARTBEAT.md` | 心跳模板，可以更新 |
-| `IDENTITY.md` | 身份模板，可以更新 |
-| `.principles/THINKING_OS.md` | 思维模型，更新后合并新模型 |
-| `.principles/models/*.md` | 思维模型库，可以添加新模型 |
-
-### 安全操作原则
-
-```
-1. 更新时：始终使用 smart 模式（默认），生成 .update 文件
-2. 删除前：确认文件不是用户积累文件
-3. 覆盖前：先备份原文件
-4. 合并时：保留用户的所有自定义内容
-```
-
----
-
-## 快速判断：首次安装 vs 更新
-
-```
-检查 ~/clawd/.principles/PRINCIPLES.md 是否存在：
-├── 不存在 → 首次安装（跳到 [首次安装] 章节）
-└── 存在 → 更新（跳到 [更新] 章节）
-```
-
----
-
-## 首次安装
-
-### 步骤 1：运行安装命令
-
-```bash
-npx create-principles-disciple --non-interactive --lang zh --workspace ~/clawd
-```
-
-### 步骤 2：重启 OpenClaw Gateway
-
-```bash
-openclaw gateway --force
-```
-
-### 步骤 3：验证安装
-
-```bash
-openclaw plugins list | grep -A 2 "Principles"
-```
-
-应该看到 `Principles` 显示为 `loaded`。
-
-### 步骤 4：初始化项目
-
-在项目目录下运行：
-
-```
-/init-strategy
-```
-
----
-
-## 更新
-
-### ⚠️ 重要提醒
-
-**更新会生成 .update 文件，不会直接覆盖你的文件！**
-
-### 步骤 1：运行更新命令
-
-```bash
-npx create-principles-disciple --non-interactive --lang zh --workspace ~/clawd
-```
-
-### 步骤 2：查看更新内容
-
-```bash
-# 查看变更日志
-cat ~/clawd/docs/CHANGELOG.md | head -100
-
-# 列出所有 .update 文件
-find ~/clawd -name "*.update" -type f
-```
-
-### 步骤 3：合并更新
-
-**必须手动合并 .update 文件到原文件！**
-
-```
-对于每个 .update 文件：
-1. 读取原文件内容
-2. 读取 .update 文件内容
-3. 对比差异，将有价值的更新合并到原文件
-4. 删除 .update 文件
-```
-
-示例流程：
-```
-1. 发现 AGENTS.md.update
-2. diff AGENTS.md AGENTS.md.update
-3. 识别新增的章节或修改
-4. 将需要的更新合并到 AGENTS.md
-5. rm AGENTS.md.update
-```
-
-### 步骤 4：重启 OpenClaw Gateway
-
-```bash
-openclaw gateway --force
-```
-
----
-
-## 常见问题
-
-### Q: 报错 "Cannot find module 'micromatch'"
-
-手动安装依赖：
-```bash
-cd ~/.openclaw/extensions/principles-disciple
-npm install micromatch@^4.0.8 @sinclair/typebox@^0.34.48
-```
-
-### Q: 如何查看当前版本？
-
-```bash
-cat ~/.openclaw/extensions/principles-disciple/package.json | grep version
-```
-
-### Q: 如何查看所有更新？
-
-```bash
-cat ~/clawd/docs/CHANGELOG.md
-```
-
----
-
-## 版本信息
-
-当前文档版本：1.6.0
-
-更新此文档时，请同步更新版本号。