myfreecode 5.2.8

package/assets/code-team.md

@@ -0,0 +1,110 @@
+# Code Team
+
+This configuration ships with a built-in virtual development team ("Code Team") of specialized subagents. When you mention **Code Team** or any of its members, invoke the corresponding built-in subagent:
+
+| 成员 | 职责 | 触发词 |
+|---|---|---|
+| code-reviewer | 代码审查，输出 APPROVE/REQUEST_CHANGES/NEEDS_DISCUSSION 结论 | review, cr, 代码检视, 代码审查, review一下, review 一下, codereview |
+| verification | 实现验证，输出 PASS/FAIL/PARTIAL 结论 | verify, 验证 |
+| Explore | 快速代码探索，只读搜索 | explore, 探索 |
+| Plan | 软件架构规划，只读 | plan, 规划 |
+| general-purpose | 通用任务代理 | research, 研究 |
+| statusline-setup | Claude Code 状态栏配置 | statusline, 状态栏 |
+| claude-code-guide | Claude Code/SDK/API 使用指南 | claude guide, claude code guide |
+
+## 触发词自动唤醒
+
+当用户消息包含以下触发词时，自动调用对应 subagent，无需手动 review：
+
+- `cr`, `codereview`, `review`, `代码检视`, `代码审查`, `review一下`, `review 一下` → `code-reviewer`
+- `verify`, `验证`, `验证一下`, `验证一下` → `verification`
+- `explore`, `探索`, `搜索代码` → `Explore`
+- `plan`, `规划`, `实现计划` → `Plan`
+
+## Code Team 成员详情
+
+### code-reviewer
+代码审查专家。审查维度：正确性、安全性、健壮性、测试覆盖。每个发现必须有文件:行号和证据支持。
+
+### verification
+验证专家。在实现完成前尝试打破它，运行构建、测试、检查，输出 PASS/FAIL/PARTIAL 结论。
+
+### Explore
+快速代码探索专家。只读搜索，可并行调用工具快速定位文件和问题。
+
+### Plan
+软件架构师。为复杂任务设计实现方案，识别关键文件和依赖关系。
+
+### general-purpose
+通用任务代理。处理搜索代码、分析架构、执行多步研究任务等。
+
+## 🚨 红线：禁止回滚未提交代码
+
+**这是一条不可逾越的红线。** 在执行清理、删除、回退等操作时，必须保护未提交的变更不被误删。
+
+### 绝对禁止的操作
+
+| 禁止命令 | 替代方案 |
+|---|---|
+| `git checkout -- <file>` | `git diff <file>` 先看变更内容，确认只影响目标文件 |
+| `git reset --hard` | 永远不要用，除非用户明确要求 |
+| `git clean -f` / `git clean -fd` | 永远不要用，除非用户明确要求 |
+| `git restore <file>` | 先 `git stash` 暂存，确认无误后再决定 |
+| `rm -rf` 未跟踪文件/目录 | 先检查是否包含未提交工作的依赖 |
+
+### 必须遵守的规则
+
+1. **清理前必须检查**: 删除或回退任何文件前，先 `git status` 确认当前变更范围
+2. **只删除目标文件**: 删除功能时只删除自己的产出，绝不可随手 `checkout` 或 `restore` 整个文件
+3. **文件级隔离**: 修改文件时用 `Edit` 精准替换，不用 `git checkout` 做清理
+4. **用 stash 代替 checkout**: 如果需要暂存变更，用 `git stash`，不要用 `git checkout --`
+5. **未提交 = 不可逆**: `git checkout -- <file>` 对未提交的修改是不可逆的，一旦执行永久丢失
+
+### 典型事故场景
+
+```
+❌ 危险操作：清理 echo 命令时
+git checkout -- src/commands.ts   # 把 goal 的注册也回退了！
+
+✅ 安全操作：清理 echo 命令时
+1. git status 确认涉及的文件
+2. Edit 工具精准删除 echo 的 import 和 COMMANDS 条目
+3. rm -rf src/commands/echo        # 只删 echo 目录
+4. 构建验证
+```
+
+### 为什么这是红线
+
+- `git checkout --` 是对整个文件生效的，文件内同时可能包含其他功能的未提交代码
+- 未提交的代码没有备份，丢失即永久不可恢复
+- 已经实际发生过多次事故（echo 清理导致 goal 被回退）
+
+# 作者署名规范
+
+## 规则
+
+本仓库所有 Java / 文档文件 `@author` 字段 + git 提交作者名 = **`Liang.Xu`**
+
+
+# AI 操作边界规则
+
+## Push / Commit 必须经用户明确指示
+
+**规则**：AI 在执行 `git push` 或 `git commit` 之前，必须等待用户发出**明确指示**（如"提交代码到远端吧"、"push 一下"、"commit"等显式动词）。**不**主动 push / commit，即便工作树有未提交变更且测试已通过。
+
+**Why**：push / commit 是不可逆或影响远端可见性的操作（特别是 push 到远端会污染 origin、影响协作）。用户保留最终决策权，AI 主动 push 可能把未达用户预期的代码推上远端。
+
+**How to apply**：
+
+- ✅ **允许**：完成编码 + 测试通过后，**只**做以下动作
+    - 在工作树留好变更
+    - 报告测试结果（如 `mvn test 286/286 通过`）
+    - 询问用户是否 push / commit（"是否需要提交并推送？"）
+- ✅ **触发条件**：用户消息含明确动词
+    - "提交代码到远端吧" / "push" / "commit" / "推到远端" / "提一下" / "发版" / "提交"
+    - 或 `/goal` workflow 中明确包含 push 步骤（按 workflow 自动执行）
+- ❌ **禁止**：在以下情况主动 push / commit
+    - "请继续" / "好的" / "OK" / "可以了" / "继续吧" 等泛化继续指令
+    - 仅完成一个 sub-task 就推测"应该也 push 一下"
+    - "跑测试" / "跑一下构建" 等测试指令不附带 push
+- ⚠️ **不适用**：`git add` / `git status` / `git diff` / `git log` 等只读操作不受限

package/assets/default-claude.template.json

@@ -0,0 +1,3 @@
+{
+  "hasCompletedOnboarding": true
+}

package/assets/default-settings.template.json

@@ -0,0 +1,137 @@
+{
+  "permissions": {
+    "allow": [
+      "Edit(*)",
+      "Write(*)",
+      "Read(*)",
+      "Glob(*)",
+      "Grep(*)",
+      "Agent(Explore)",
+      "Agent(code-reviewer)",
+      "Agent(security-reviewer)"
+    ],
+    "defaultMode": "acceptEdits"
+  },
+  "skipWebFetchPreflight": true,
+  "model": "MiniMax-M2.7",
+  "providerProfiles": [
+    {
+      "id": "volcengine-doubao",
+      "name": "火山引擎 Doubao",
+      "provider": "firstParty",
+      "baseUrl": "https://ark.cn-beijing.volces.com/api/coding",
+      "model": "doubao-seed-2.0-pro-260215",
+      "availableModels": [
+        "doubao-seed-2.0-pro-260215",
+        "kimi-k2.5"
+      ],
+      "customModels": [
+        {
+          "id": "doubao-seed-2.0-pro-260215",
+          "model": "doubao-seed-2.0-pro-260215",
+          "name": "Doubao Seed 2.0 Pro",
+          "description": "火山引擎最新编码模型"
+        },
+        {
+          "id": "kimi-k2.5",
+          "model": "kimi-k2.5",
+          "name": "Kimi K2.5",
+          "description": "Kimi K2.5 编码模型"
+        }
+      ],
+      "apiKeyEnv": "ANTHROPIC_API_KEY"
+    },
+    {
+      "id": "minimax",
+      "name": "MiniMax",
+      "provider": "firstParty",
+      "baseUrl": "https://api.minimaxi.com/anthropic",
+      "model": "MiniMax-M2.7",
+      "availableModels": [
+        "MiniMax-M2.7",
+        "MiniMax-M2.5-highspeed"
+      ],
+      "customModels": [
+        {
+          "id": "MiniMax-M2.7",
+          "model": "MiniMax-M2.7",
+          "name": "MiniMax-M2.7",
+          "description": "MiniMax 最新模型"
+        },
+        {
+          "id": "MiniMax-M2.5-highspeed",
+          "model": "MiniMax-M2.5-highspeed",
+          "name": "MiniMax-M2.5-highspeed",
+          "description": "MiniMax-M2.5-highspeed"
+        }
+      ],
+      "apiKeyEnv": "ANTHROPIC_API_KEY"
+    },
+    {
+      "id": "opencode-zen",
+      "name": "OpenCode Zen (免费模型)",
+      "provider": "openaiChat",
+      "baseUrl": "https://opencode.ai/zen/v1",
+      "model": "big-pickle",
+      "availableModels": [
+        "big-pickle",
+        "minimax-m2.5-free",
+        "ling-2.6-flash",
+        "hy3-preview-free",
+        "nemotron-3-super-free"
+      ],
+      "customModels": [
+        {
+          "id": "big-pickle",
+          "model": "big-pickle",
+          "name": "Big Pickle",
+          "description": "OpenCode Zen 免费编码模型"
+        },
+        {
+          "id": "minimax-m2.5-free",
+          "model": "minimax-m2.5-free",
+          "name": "MiniMax M2.5 Free",
+          "description": "MiniMax M2.5 免费版"
+        },
+        {
+          "id": "ling-2.6-flash",
+          "model": "ling-2.6-flash",
+          "name": "Ling 2.6 Flash",
+          "description": "Ling 2.6 快速模型"
+        },
+        {
+          "id": "hy3-preview-free",
+          "model": "hy3-preview-free",
+          "name": "Hy3 Preview Free",
+          "description": "Hy3 预览免费版"
+        },
+        {
+          "id": "nemotron-3-super-free",
+          "model": "nemotron-3-super-free",
+          "name": "Nemotron 3 Super Free",
+          "description": "Nemotron 3 Super 免费版"
+        }
+      ],
+      "apiKeyEnv": "OPENCODE_ZEN_API_KEY"
+    },
+    {
+      "id": "modal-glm",
+      "name": "Modal GLM-5.1",
+      "provider": "openaiChat",
+      "baseUrl": "https://api.us-west-2.modal.direct/v1",
+      "model": "zai-org/GLM-5.1-FP8",
+      "availableModels": [
+        "zai-org/GLM-5.1-FP8"
+      ],
+      "customModels": [
+        {
+          "id": "zai-org/GLM-5.1-FP8",
+          "model": "zai-org/GLM-5.1-FP8",
+          "name": "GLM-5.1",
+          "description": "智谱 GLM-5.1 模型 (通过Modal部署)"
+        }
+      ],
+      "apiKeyEnv": "MODAL_API_KEY"
+    }
+  ]
+}

package/bin/free-code.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+const { spawnSync } = require('child_process');
+const { platform, arch } = process;
+
+// Initialize config files if missing
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function initConfig() {
+  const homeDir = os.homedir();
+  const claudeDir = path.join(homeDir, '.claude');
+  const settingsPath = path.join(claudeDir, 'settings.json');
+  const claudeJsonPath = path.join(homeDir, '.claude.json');
+
+  // Create ~/.claude/ directory if not exists
+  if (!fs.existsSync(claudeDir)) {
+    fs.mkdirSync(claudeDir, { recursive: true });
+  }
+
+  // Copy default-settings.template.json if settings.json missing
+  if (!fs.existsSync(settingsPath)) {
+    try {
+      const templatePath = path.join(__dirname, '..', 'assets', 'default-settings.template.json');
+      fs.copyFileSync(templatePath, settingsPath);
+    } catch (e) {
+      // template not found, skip
+    }
+  }
+
+  // Copy default-claude.template.json if .claude.json missing
+  if (!fs.existsSync(claudeJsonPath)) {
+    try {
+      const templatePath = path.join(__dirname, '..', 'assets', 'default-claude.template.json');
+      fs.copyFileSync(templatePath, claudeJsonPath);
+    } catch (e) {
+      // template not found, skip
+    }
+  }
+
+  // Copy code-team.md to ~/.claude/rules/ if missing
+  const rulesDir = path.join(claudeDir, 'rules');
+  const codeTeamPath = path.join(rulesDir, 'code-team.md');
+  if (!fs.existsSync(codeTeamPath)) {
+    try {
+      fs.mkdirSync(rulesDir, { recursive: true });
+      const templatePath = path.join(__dirname, '..', 'assets', 'code-team.md');
+      fs.copyFileSync(templatePath, codeTeamPath);
+    } catch (e) {
+      // template not found, skip
+    }
+  }
+}
+
+initConfig();
+
+const binaryName = `cli-${platform}-${arch}${platform === 'win32' ? '.exe' : ''}`;
+const pkgName = `@myfreecode/cli-${platform}-${arch}`;
+
+try {
+  const binaryPath = require.resolve(`${pkgName}/bin/${binaryName}`);
+  const result = spawnSync(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: process.env,
+  });
+  process.exit(result.status ?? 0);
+} catch (e) {
+  console.error(`Platform ${platform}-${arch} is not supported by free-code.`);
+  console.error(`Tried to find: ${pkgName}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "myfreecode",
+  "version": "5.2.8",
+  "description": "myfreecode: a local-build-friendly Claude Code fork.",
+  "bin": {
+    "myfreecode": "./bin/free-code.js",
+    "free-code": "./bin/free-code.js",
+    "claude": "./bin/free-code.js"
+  },
+  "files": [
+    "bin/",
+    "assets/"
+  ],
+  "optionalDependencies": {
+    "@myfreecode/cli-darwin-x64": "5.2.8",
+    "@myfreecode/cli-darwin-arm64": "5.2.8",
+    "@myfreecode/cli-linux-x64": "5.2.8",
+    "@myfreecode/cli-linux-arm64": "5.2.8",
+    "@myfreecode/cli-win32-x64": "5.2.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "cli",
+    "coding"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yonggandewo12/free-code-public.git"
+  }
+}