feihong-code 0.2.1

package/docs//347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -0,0 +1,196 @@
+# 飞虹 Code 用户手册
+
+> 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+
+本手册面向**使用者**，讲解每个命令、工具与安全机制，并给出最佳实践。开发向内容见《架构与 API》《配置参考》。
+
+---
+
+## 1. 安装与初始化
+
+```bash
+git clone https://github.com/wch887292/feihong-code.git
+cd feihong-code && npm install && npm run build
+cp .env.example .env      # 然后编辑填入 FH_PROVIDERS
+```
+
+- 未配置 `FH_PROVIDERS` → 自动**离线模式**（内置 Mock 闭环，零成本）。
+- 已配置 `FH_PROVIDERS` → **真实模型模式**。
+- 环境变量可从 `.env` 自动加载（仅注入未设置的键），也可直接 `export`。
+
+---
+
+## 2. 命令详解
+
+### 2.1 单命令模式
+
+```bash
+fhcode "把 src/utils 的日期格式化抽成独立模块并补测试"
+```
+
+一次需求一次执行。编排器按 ReAct 循环：勘察 → 改码 → 测试/构建验证 → 总结。结束后打印最终结果、迭代次数、成本与日志路径。
+
+### 2.2 交互 REPL
+
+```bash
+fhcode          # 进入 REPL
+飞虹> 给登录页加一个表单校验
+飞虹> exit      # 退出
+```
+
+逐条输入需求，每条独立执行一次编排。适合探索式开发。
+
+### 2.3 多子代理并行 `--parallel`
+
+```bash
+fhcode --parallel "实现登录模块并且添加用户管理并且写集成测试"
+```
+
+- **分解**：按中文并列连词（`并且/同时/分别/以及` 等）拆分为多个子任务。
+- **隔离**：为每个子任务创建独立的 `git worktree`（独立目录 + 独立分支），子代理只在自己的 worktree 内读写，互不干扰。
+- **并发**：`Promise.allSettled` 并发执行；单子任务失败不影响其他。
+- **清理**：结束后强制移除所有 worktree，子代理产物不进入主仓库。
+- ⚠️ 真实模式下会并发调用 API，免费套餐易触发 429 限流（见 FAQ）。
+
+### 2.4 只读技能（不修改任何文件）
+
+| 命令 | 作用 | 示例 |
+| --- | --- | --- |
+| `/plan` | 生成结构化实现计划 | `fhcode /plan "实现登录并且添加支付"` |
+| `/grill` | 红队式代码审查（密钥/注入/穿越/校验/待办） | `fhcode /grill src` |
+| `/goal` | 分解并保存高层目标到 `~/.feihong-code/goals` | `fhcode /goal "搭建体系并且完善文档"` |
+
+三者均为只读，可放心在任何仓库运行。
+
+### 2.5 版本与帮助
+
+```bash
+fhcode --version   # 或 -v：版本 + 署名
+fhcode --help      # 或 -h：完整用法
+```
+
+### 2.6 恢复与审计（M3）
+
+每次任务都会把完整对话、迭代计数、成本、被改动文件落盘为会话检查点（`<runId>.session.json`），可随时恢复与审计。
+
+| 命令 | 作用 | 示例 |
+| --- | --- | --- |
+| `sessions` | 列出历史会话（状态 / 迭代 / 成本 / 文件数 / 更新时间） | `fhcode sessions` |
+| `resume <id>` | 从检查点重建对话并续跑中断任务（支持 8 位前缀） | `fhcode resume 6f7f734f` |
+| `diff [<id>]` | 展示会话作用域变更；省略 id 则显示当前工作区全量 diff | `fhcode diff 6f7f734f` |
+| `rollback <id> [--yes]` | 回滚会话产生的改动（**危险，必须 `--yes` 确认**） | `fhcode rollback 6f7f734f --yes` |
+
+**resume 适用场景**：进程崩溃、手动中断、达到最大迭代仍无结果。续跑会接着已有对话继续 ReAct 循环，直到产出最终答案，新过程仍写入同一 `runId` 的事件日志，审计连续。
+
+**diff / rollback 安全边界**：
+- 仅作用于本会话 `touchedFiles`（被 `write_file`/`edit_file` 创建或修改的文件），绝不整仓回滚。
+- `diff` 对已跟踪文件走 `git diff`，未跟踪文件走 `git diff --no-index` 展示新增内容。
+- `rollback` 对已跟踪文件 `git checkout --`，未跟踪文件直接删除；**未确认（`--yes`）或非 git 仓库时一律拒绝执行**，避免误删。
+
+### 2.7 企业能力（M4）
+
+企业模式默认开启（受 `FH_ENTERPRISE` 控制，设 `false` 即退回社区版无感行为）。开启后提供四类能力：
+
+| 命令 | 作用 | 示例 |
+| --- | --- | --- |
+| `whoami` | 查看当前租户 / 用户 / 角色 / 隔离目录 / 当日成本 | `fhcode whoami` |
+| `policy` | 渲染当前生效的策略矩阵（角色-工具、配额、黑名单） | `fhcode policy` |
+| `audit [--limit N]` | 查看审计链（脱敏后），`--limit` 控制条数 | `fhcode audit --limit 20` |
+| `audit verify` | 校验审计哈希链完整性，定位被篡改断点 | `fhcode audit verify` |
+| `tenants` | 列出所有租户及各自用量（成本/会话数，互不串台） | `fhcode tenants` |
+
+**权限（RBAC）**：四角色 `viewer / developer / operator / admin`，判定顺序 **deny 优先**：
+
+1. `run_shell` 命中危险命令（如 `rm -rf /`、`mkfs`、`curl|sh` 等 23 条）→ 直接拒绝；
+2. 访问敏感路径（`.env`、`.ssh`、`id_rsa`、`.git/config` 等 11 类）或越界沙箱 → 直接拒绝（**admin 也拦**）；
+3. 角色矩阵判定：deny / 需审批（approval）/ 允许；
+4. shell 白名单命中的命令免审批。
+
+**多租户隔离**：数据按 `<FH_HOME>/tenants/<tenantId>/{sessions,audit,goals}` 物理目录隔离，租户 ID 强制正则 `^[A-Za-z0-9._-]{1,64}$` 校验防穿越；未指定租户时兼容旧版 `<FH_HOME>/sessions`。
+
+**成本治理**：单任务 `maxCostUsd` 熔断（达上限即终止并给结论）+ 租户日预算 `FH_TENANT_BUDGET_USD` fail-fast（任务启动前拦截，超限返回 `QUOTA_EXCEEDED`）。
+
+**审计**：每次工具执行前由「守卫（guard）」一次性完成 *策略判定→人工审批→审计留痕*，写入按月切分的 `audit-YYYY-MM.jsonl`，采用 **sha256 哈希链（防篡改）**，敏感字段自动脱敏。可用 `audit verify` 检验链完整性。
+
+---
+
+## 3. 工具系统
+
+智能体在真实模式下可调用以下 8 个工具（离线模式用 Mock 模拟）：
+
+| 工具 | 用途 | 关键参数 | 安全约束 |
+| --- | --- | --- | --- |
+| `read_file` | 读文件 | `path` | 沙箱内 |
+| `write_file` | 写/覆盖文件 | `path`, `content` | 沙箱内，自动建父目录 |
+| `edit_file` | 精确替换 | `path`, `oldText`, `newText` | 沙箱内 |
+| `list_dir` | 列目录 | `path`（可选） | 沙箱内 |
+| `grep` | 递归搜索 | `pattern`, `path`（可选） | 忽略 node_modules/.git |
+| `run_shell` | 执行命令 | `command` | **白名单 + 审批** |
+| `run_tests` | 跑测试 | `command`（默认 `npm test`） | 同 run_shell 调度 |
+| `build_check` | 构建校验 | `command`（默认 `npm run build`） | 同 run_shell 调度 |
+
+所有工具入参经 zod 校验，异常归一为 `ToolError`，不会让进程崩溃。
+
+---
+
+## 4. 审批与安全模型
+
+- **路径沙箱**：任何文件操作只允许在 `cwd`（当前目录或子代理 worktree）内，越界（`../` 等）直接拒绝。
+- **Shell 白名单**：`run_shell` 仅当命令首词（如 `git`、`npm`）命中 `FH_SHELL_ALLOW` 才放行；否则直接拒绝。
+- **默认审批器**（非交互 CLI）：命中白名单者自动通过；未命中者拒绝并写日志。若设置 `FH_REQUIRE_APPROVAL=false` 则完全放开（不推荐）。
+- **交互式审批（M3）**：当运行在 TTY 终端时，危险操作（如 `run_shell`、写文件）会**逐条弹出 `y/n` 确认**，须用户显式批准才执行；非 TTY（CI / 管道）自动回退到上述白名单审批器。
+- **密钥脱敏**：日志中 `apikey/secret/token/...` 字段值一律 `[REDACTED]`；企业审计日志亦对 `apiKey=/secret=/sk-*` 等做 `***` 替换。
+- **`.env` 不入库**：`gitignore` + `package.json` 的 `files` 白名单双重保障。
+- **企业权限（M4）**：四角色 RBAC + deny 优先矩阵，危险命令/敏感路径在角色判定前即拦截（含 admin）。未注入企业 guard 时行为同社区版，可用 `FH_ENTERPRISE=false` 关闭。
+- **防篡改审计（M4）**：工具执行前由守卫统一留痕，审计日志按月切分并以 sha256 哈希链串联，任意篡改均会被 `audit verify` 定位断点。
+- **多租户隔离（M4）**：租户数据按物理目录隔离，ID 正则防穿越，成本与审计互不串台。
+- **成本熔断（M4）**：单任务成本上限 + 租户日预算双重熔断，超限直接拒绝不静默放行。
+
+---
+
+## 5. 真实模型接入（示例）
+
+已验证可用的 Agnes 网关配置（写入 `.env`）：
+
+```bash
+FH_PROVIDERS='[{"id":"agnes","type":"openai-compatible","baseURL":"https://api.agnes-ai.cn/v1","apiKey":"<你的key>","model":"agnes-2.5-flash","tags":["code-gen"],"costPer1k":0.001}]'
+FH_MODEL_STRATEGY=cost
+FH_SHELL_ALLOW=git,npm,node,ls,cat
+FH_REQUIRE_APPROVAL=true
+```
+
+更多供应商（DeepSeek / 通义 / Ollama）见《配置参考》。
+
+---
+
+## 6. 最佳实践
+
+1. **先只读探查**：大改前先 `/grill src` 看风险、`/plan "..."` 看方案。
+2. **注意 cwd**：真实模式下 `cwd = 当前目录`，文件写入/命令执行都作用于此。建议从**干净目录**或**专用仓库**运行，避免误改。
+3. **并行用隔离**：多模块任务优先 `--parallel`，物理隔离最安全。
+4. **白名单最小化**：`FH_SHELL_ALLOW` 只放确实需要的命令。
+5. **离线先验证**：CI 或演示用 `FH_OFFLINE=true`，零成本且确定性强。
+6. **看日志**：每次运行生成 `~/.feihong-code/sessions/<runId>.jsonl`，排错首选。
+
+---
+
+## 7. 典型工作流
+
+```
+# 1) 评估现状（只读）
+fhcode /grill src
+fhcode /plan "重构配置模块并且补集成测试"
+
+# 2) 并行推进（隔离）
+fhcode --parallel "重构配置模块并且补集成测试"
+
+# 3) 单点精修（真实改码）
+fhcode "把配置校验抽到 config.ts 并补单测"
+
+# 4) 目标跟踪
+fhcode /goal "Q3 完成模块化与测试覆盖率 80%"
+```
+
+---
+
+© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹

package/docs//351/203/250/347/275/262/346/214/207/345/215/227.md

@@ -0,0 +1,165 @@
+# 飞虹 Code 部署指南
+
+> 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+
+覆盖：环境要求、源码/全局安装、Docker、CI、npm 发布、内网部署。
+
+---
+
+## 1. 环境要求
+
+- **Node.js >= 18**（CI 与 Docker 均使用 18）。
+- **Git**：`--parallel` 依赖 `git worktree` 隔离，必须可用（Docker 镜像已内置）。
+- 仅需运行时依赖 `zod`（dev 依赖 typescript/tsx 仅构建期需要）。
+
+---
+
+## 2. 从源码部署
+
+```bash
+git clone https://github.com/wch887292/feihong-code.git
+cd feihong-code
+npm install
+npm run build
+node dist/cli/index.js --version
+```
+
+或直接用脚本：`bash install.sh`（自动 install + build + 全局安装）。
+
+---
+
+## 3. 全局安装
+
+```bash
+npm install -g .          # 从本地源码装为全局命令 fhcode
+fhcode --version
+```
+
+发布到 npm 后：`npm install -g feihong-code`。
+
+---
+
+## 4. Docker 部署
+
+```bash
+docker build -t feihong-code .
+```
+
+运行（离线）：
+
+```bash
+docker run --rm feihong-code --version
+```
+
+运行（真实模型，挂载密钥与日志）：
+
+```bash
+docker run --rm \
+  -v "$PWD/.env:/app/.env" \
+  -v feihong-data:/data/feihong-code \
+  feihong-code "把 src/utils 的日期格式化抽成独立模块并补测试"
+```
+
+- 镜像为多阶段构建：构建期装全依赖编译 `dist`，运行期仅 `npm install --omit=dev` + 复制 `dist`。
+- 运行期已 `apk add git`，支持 `--parallel` 的 worktree 隔离。
+- `FH_HOME` 默认 `/data/feihong-code`，建议挂载为卷以持久化目标与日志。
+
+---
+
+## 5. CI / CD（M4 三流水线）
+
+`.github/workflows/ci.yml` 在 `push`/`pull_request` 触发，**全离线、零 Secrets**，fork PR 安全。分为三个 job：
+
+### 5.1 `build` — 构建与离线闭环
+
+- Node 18 / 20 / 22 矩阵；
+- `npm run typecheck` → `npm run build`；
+- 离线冒烟：`FH_OFFLINE=true fhcode "..."`；只读技能 `/plan` `/grill` 校验；
+- 目的：保证多版本 Node 下可构建、社区闭环可跑。
+
+### 5.2 `enterprise` — 企业能力断言
+
+- 运行 `npm run verify:m4`（`scripts/verify-m4.mjs`，**41 项全离线断言**）：
+  - RBAC 矩阵(5) / deny 优先(4) / 策略覆盖(4) / 审计哈希链(7) / 守卫链路(11) / 多租户(7) / 配额(3)；
+- CLI 冒烟：`whoami` / `policy` / `audit` / `audit verify` / `tenants`；
+- **租户隔离断言**：用 `beta` 租户执行任务后，断言其 `sessions` 读不到 `acme` 租户会话（物理目录互不串台）。
+
+### 5.3 `security` — 发布安全
+
+- `npm pack --dry-run` 白名单校验：禁止 `.env` / `src` / `policy.json` / `.workbuddy` 进入产物；
+- 仓库明文密钥扫描（`git grep` 规则集）：杜绝 accidental secret 入库；
+- `npm audit`：依赖漏洞检查。
+
+> 本地完整校验：`npm run verify`（= typecheck + build + verify:m4）。
+
+- **企业模式不触碰密钥**：CI 仅做离线冒烟、企业断言与发布安全，**绝不**读取或回显任何 API key。
+- 真实联调建议在本地或带加密 secret 的受控环境执行，切勿把密钥明文写入 CI 日志。
+
+---
+
+## 5.1 企业合规部署建议（M4）
+
+- **多租户物理隔离**：为每个客户/团队分配独立 `FH_TENANT`，数据落 `<FH_HOME>/tenants/<tenantId>/`，互不串台。
+- **最小角色**：日常运行用 `developer`；仅可信运维用 `operator`/`admin`；只读巡检用 `viewer`。
+- **日预算硬上限**：为每个租户设 `FH_TENANT_BUDGET_USD`，超限即 `QUOTA_EXCEEDED` 拒绝，防成本失控。
+- **审计留存**：`audit-YYYY-MM.jsonl` 建议只读挂载或异地备份，并周期性 `fhcode audit verify` 巡检哈希链完整性。
+- **关闭企业模式**：纯社区/单机使用可设 `FH_ENTERPRISE=false`，行为与 M3 一致、零额外开销。
+
+---
+
+## 6. 发布到 npm
+
+`package.json` 已做好发布安全：
+
+- `files` 白名单：`dist` + `README.md` + `LICENSE` + `CONTRIBUTING.md` + `docs`（**绝不**包含 `.env` / `src` / `.workbuddy`）。
+- `prepublishOnly`: `npm run build`（发布前自动构建，保证 `dist` 最新）。
+- `.npmignore` 作为冗余保险。
+
+发布步骤：
+
+```bash
+npm run build
+npm version patch          # 或 minor/major
+npm publish                # 仅携带 files 白名单内容
+```
+
+> ⚠️ **密钥安全铁律**：`.env` 含 API key，已被 `.gitignore` 与 `files` 白名单双重排除，永远不会进入 npm 包或 Git 仓库。
+
+---
+
+## 7. 内网 / 离线部署建议
+
+- **完全离线**：不配 `FH_PROVIDERS`，用内置 Mock 闭环（演示/回归）。
+- **本地模型**：配 Ollama 供应商（`type: ollama`，`baseURL: http://<内网IP>:11434`），数据不出本机。
+- **代理网关**：OpenAI 兼容供应商的 `baseURL` 可指向企业内网网关。
+- **日志合规**：`FH_LOG_DIR` 指向受控存储，按敏感数据留存策略管理。
+
+---
+
+## 8. 作为后台服务（可选 systemd）
+
+```ini
+[Unit]
+Description=飞虹 Code Agent
+After=network.target
+
+[Service]
+WorkingDirectory=/opt/feihong-code
+ExecStart=/usr/bin/fhcode "守护型需求"
+Environment=FH_HOME=/var/lib/feihong-code
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+---
+
+## 9. 升级与回滚
+
+- 升级：`git pull && npm install && npm run build`（或 `npm update -g feihong-code`）。
+- 回滚：npm 包使用 `npm install -g feihong-code@<旧版本>`；源码用 `git checkout <tag>` 后重建。
+
+---
+
+© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹

package/docs//351/205/215/347/275/256/345/217/202/350/200/203.md

@@ -0,0 +1,127 @@
+# 飞虹 Code 配置参考
+
+> 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+
+所有配置通过**环境变量**提供，启动时集中校验（fail-fast）。`.env` 文件会被自动加载（仅注入未设置的键），但**切勿提交 `.env`**。
+
+---
+
+## 1. 环境变量总览
+
+| 变量 | 必填 | 说明 | 默认 |
+| --- | --- | --- | --- |
+| `FH_HOME` | 否 | 应用主目录（目标/日志根） | `~/.feihong-code` |
+| `FH_LOG_DIR` | 否 | 会话事件日志目录 | `~/.feihong-code/sessions` |
+| `FH_PROVIDERS` | 否* | 模型供应商 JSON 数组；为空则离线 | `[]` |
+| `FH_MODEL_STRATEGY` | 否 | 路由策略 | `cost` |
+| `FH_BUDGET_USD` | 否 | 单任务预算（美元，超限仅告警） | `0.5` |
+| `FH_SHELL_ALLOW` | 否 | shell 白名单（逗号分隔） | 空 |
+| `FH_REQUIRE_APPROVAL` | 否 | 危险操作是否需审批 | `true` |
+| `FH_OFFLINE` | 否 | 设为 `true` 强制离线 | 未设 |
+| `FH_ENTERPRISE` | 否 | 企业模式开关；`false` 退回社区版无感行为 | `true` |
+| `FH_TENANT` | 否 | 租户 ID（正则 `^[A-Za-z0-9._-]{1,64}$`），触发多租户物理目录隔离 | 未设（默认租户） |
+| `FH_USER` | 否 | 当前用户标识（写入审计与租户上下文） | 未设 |
+| `FH_ROLE` | 否 | 角色：`viewer` / `developer` / `operator` / `admin` | `developer` |
+| `FH_TENANT_BUDGET_USD` | 否 | 租户当日成本预算（USD），超限拒绝新任务（fail-fast） | 未设（取策略角色上限） |
+| `FH_POLICY` | 否 | 策略覆盖 JSON（仅能加严：黑名单取并集），优先级高于内置与文件策略 | 未设 |
+
+> *`FH_PROVIDERS` 缺省或 `[]` → 自动离线（Mock 闭环）；非空 → 真实模式。
+
+---
+
+## 2. FH_PROVIDERS 结构
+
+JSON 数组，每项一个供应商：
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `id` | string | ✅ | 唯一标识（用于日志/路由） |
+| `type` | `"openai-compatible"` \| `"ollama"` | ✅ | 供应商类型 |
+| `baseURL` | string | ✅ | API 基地址（不含末尾斜杠会被规范化） |
+| `apiKey` | string | 否 | OpenAI 兼容网关的 Bearer Token；Ollama 留空 |
+| `model` | string | 否 | 模型名（openai-compatible 必填；Ollama 指定本地模型） |
+| `tags` | `CapabilityTag[]` | ✅ | 能力标签，用于路由筛选 |
+| `costPer1k` | number | 否 | 每千 token 成本（USD），用于成本计量与 `cost` 策略 |
+
+### CapabilityTag 枚举
+
+`code-gen` · `reasoning` · `long-context` · `vision` · `cheap` · `local`
+
+编排器调用时默认带 `['code-gen']` 标签筛选；路由按策略对命中供应商打分选优。
+
+---
+
+## 3. 路由策略（FH_MODEL_STRATEGY）
+
+| 策略 | 选优逻辑 |
+| --- | --- |
+| `cost` | 优先 `costPer1k` 最低（默认，省钱） |
+| `capability` | 优先 `reasoning` + `code-gen` 标签命中 |
+| `latency` | 优先 `local`（Ollama 等本地模型） |
+
+多供应商时按策略排序，调用失败时**自动 fallback** 到下一个。
+
+---
+
+## 4. 供应商示例
+
+### 4.1 OpenAI 兼容（Agnes，已验证）
+
+```json
+[{"id":"agnes","type":"openai-compatible","baseURL":"https://api.agnes-ai.cn/v1","apiKey":"<key>","model":"agnes-2.5-flash","tags":["code-gen"],"costPer1k":0.001}]
+```
+
+### 4.2 DeepSeek
+
+```json
+[{"id":"deepseek","type":"openai-compatible","baseURL":"https://api.deepseek.com/v1","apiKey":"sk-xxx","model":"deepseek-chat","tags":["code-gen","cheap"],"costPer1k":0.0001}]
+```
+
+### 4.3 通义千问（DashScope 兼容模式）
+
+```json
+[{"id":"qwen","type":"openai-compatible","baseURL":"https://dashscope.aliyuncs.com/compatible-mode/v1","apiKey":"sk-xxx","model":"qwen-plus","tags":["code-gen","long-context"],"costPer1k":0.0002}]
+```
+
+### 4.4 Ollama（本地，零成本）
+
+```json
+[{"id":"ollama","type":"ollama","baseURL":"http://localhost:11434","apiKey":"","model":"qwen2.5-coder:7b","tags":["code-gen","local"],"costPer1k":0}]
+```
+
+### 4.5 多供应商（路由 + fallback）
+
+```json
+[
+  {"id":"deepseek","type":"openai-compatible","baseURL":"https://api.deepseek.com/v1","apiKey":"sk-xxx","model":"deepseek-chat","tags":["code-gen","cheap"],"costPer1k":0.0001},
+  {"id":"ollama","type":"ollama","baseURL":"http://localhost:11434","apiKey":"","model":"qwen2.5-coder:7b","tags":["code-gen","local"],"costPer1k":0}
+]
+```
+
+---
+
+## 5. 成本计量
+
+- 每次 `chat` 返回 `usage`（prompt/completion/total tokens），按 `costPer1k` 估算 `costUsd`。
+- 累加进任务总成本，打印在结果中。
+- 超过 `FH_BUDGET_USD` 仅**告警日志**，不阻断（避免半途中断）。
+- 离线模式成本为 `0`。
+
+---
+
+## 6. 安全配置建议
+
+1. `FH_SHELL_ALLOW` 遵循**最小权限**：只放确实需要的命令（如 `git,npm,node`）。
+2. 保持 `FH_REQUIRE_APPROVAL=true`；仅在完全可信的隔离环境才设 `false`。
+3. `.env` 权限设为仅本人可读：`chmod 600 .env`。
+4. 不要把 `.env` 提交到 Git（已被 `.gitignore` 排除）。
+5. 日志目录（`FH_LOG_DIR`）可能含任务上下文，按敏感数据处理。
+6. **企业模式（M4）**：`FH_ENTERPRISE` 默认开启；若仅作社区使用，设 `false` 即完全关闭 RBAC / 审计 / 租户隔离，行为与 M3 一致。
+7. **租户隔离（M4）**：生产部署务必为每个客户/团队设置独立 `FH_TENANT`；租户 ID 仅允许 `A-Za-z0-9._-`（1–64 位），任何非常规字符都会被拒绝以防目录穿越。
+8. **日预算（M4）**：`FH_TENANT_BUDGET_USD` 是硬上限，超限时新任务直接返回 `QUOTA_EXCEEDED`（HTTP 429 语义），不会静默放行；单任务 `maxCostUsd` 由策略角色上限控制，达上限即熔断并给出结论。
+9. **策略覆盖（M4）**：通过 `FH_POLICY` 或 `<FH_HOME>/policy.json`、`<租户>/policy.json` 注入的覆盖只能**加严**不能放宽——危险命令/敏感路径黑名单取并集，角色权限取交集，确保安全基线不被削弱。
+10. **审计留存（M4）**：`audit-YYYY-MM.jsonl` 为防篡改哈希链，建议只读挂载或异地备份；`audit verify` 可周期性巡检完整性。
+
+---
+
+© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "feihong-code",
+  "version": "0.2.1",
+  "description": "飞虹 Code — 终端 AI 编程智能体（对标 Muse Code），支持多模型路由、企业级 RBAC/审计、全自动 SWE Agent",
+  "bin": {
+    "fhcode": "dist/cli/index.js"
+  },
+  "main": "dist/cli/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
+    "AGENT-GUIDE.md",
+    "tool-schema.json",
+    "docs",
+    ".github"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/copy-web.cjs",
+    "start": "node dist/cli/index.js",
+    "dev": "tsx src/cli/index.ts",
+    "typecheck": "tsc --noEmit",
+    "verify:m4": "node scripts/verify-m4.mjs",
+    "test": "tsx --test tests/unit/*.test.ts",
+    "verify": "npm run typecheck && npm run build && npm run verify:m4",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "ai-agent",
+    "coding",
+    "cli",
+    "llm",
+    "large-language-model",
+    "muse-code",
+    "autonomous-agent",
+    "swe-agent",
+    "software-engineering",
+    "deepseek",
+    "ollama",
+    "openai",
+    "typescript",
+    "rbac",
+    "enterprise",
+    "multi-tenant",
+    "code-generation",
+    "test-generation"
+  ],
+  "author": "吴赐虹 <wch887292@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitcode.com/gcw_YuRlTP0G/feihong-code.git"
+  },
+  "homepage": "https://gitcode.com/gcw_YuRlTP0G/feihong-code#readme",
+  "bugs": {
+    "url": "https://gitcode.com/gcw_YuRlTP0G/feihong-code/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/wch887292"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^26.2.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "zod": "^4.4.3"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}