feihong-code 0.2.2 → 0.5.1

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

@@ -1,127 +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 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+# 飞虹 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

@@ -1,109 +1,114 @@
-{
-  "name": "feihong-code",
-  "version": "0.2.2",
-  "description": "fhcode（飞虹 Code）— 终端 AI 编程智能体，对标 Muse Code / Cursor CLI：多模型路由（DeepSeek/通义/Ollama/OpenAI）、企业级 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",
-    "terminal",
-    "developer-tools",
-    "productivity",
-    "agentic",
-    "vibe-coding",
-    "code-review",
-    "refactor",
-    "automation",
-    "mcp",
-    "tool-use",
-    "claude",
-    "copilot",
-    "chatgpt",
-    "devops",
-    "agent-framework",
-    "ai-tools",
-    "coding-assistant",
-    "self-improving",
-    "offline-ai",
-    "ai-coding",
-    "command-line",
-    "software-development",
-    "llm-agent",
-    "nodejs-cli",
-    "code-assistant",
-    "agentic-ai"
-  ],
-  "author": "吴赐虹 (晋江市飞虹智科技企业管理有限公司) <wch887292@gmail.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://gitcode.com/gcw_YuRlTP0G/feihong-code.git"
-  },
-  "homepage": "https://www.klai.top",
-  "bugs": {
-    "url": "https://gitcode.com/gcw_YuRlTP0G/feihong-code/issues"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "funding": {
-    "type": "company",
-    "url": "https://www.klai.top"
-  },
-  "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/"
-  }
-}
+{
+  "name": "feihong-code",
+  "version": "0.5.1",
+  "description": "fhcode（飞虹 Code）— 终端 AI 编程智能体，对标 Muse Code / Cursor CLI：多模型路由（DeepSeek/通义/Ollama/OpenAI）、企业级 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",
+    "verify:m6": "node scripts/verify-m6.mjs",
+    "verify:m7": "node scripts/verify-m7.mjs",
+    "verify:m8": "node scripts/verify-m8.mjs",
+    "verify:m9": "node scripts/verify-m9.mjs",
+    "eval": "node scripts/eval.mjs",
+    "test": "tsx --test tests/unit/*.test.ts",
+    "verify": "npm run typecheck && npm run build && npm run verify:m4 && npm run verify:m6 && npm run verify:m7 && npm run verify:m8 && npm run verify:m9",
+    "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",
+    "terminal",
+    "developer-tools",
+    "productivity",
+    "agentic",
+    "vibe-coding",
+    "code-review",
+    "refactor",
+    "automation",
+    "mcp",
+    "tool-use",
+    "claude",
+    "copilot",
+    "chatgpt",
+    "devops",
+    "agent-framework",
+    "ai-tools",
+    "coding-assistant",
+    "self-improving",
+    "offline-ai",
+    "ai-coding",
+    "command-line",
+    "software-development",
+    "llm-agent",
+    "nodejs-cli",
+    "code-assistant",
+    "agentic-ai"
+  ],
+  "author": "吴赐虹 (晋江市飞虹智科技企业管理有限公司) <wch887292@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wch887292/feihong-code.git"
+  },
+  "homepage": "https://www.klai.top",
+  "bugs": {
+    "url": "https://github.com/wch887292/feihong-code/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "funding": {
+    "type": "company",
+    "url": "https://www.klai.top"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@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/"
+  }
+}