# opencode-ext **Repository Path**: dxdbc/opencode-ext ## Basic Information - **Project Name**: opencode-ext - **Description**: opencode 下的功能扩展. 目标是把opencode变成一个底盘, 构建跨项目, 跨领域的超级虚拟员工. - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-07 - **Last Updated**: 2026-07-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # opencode-ext OpenCode 扩展功能源码——Agent 定义、Skill 文件。Harness 工程系统提供 AI 编码的完整控制面: 事件驱动多 Skill 编排 + L3 条件自主 + 知识自进化。 **当前版本**: v3.6.0(全量知识扫描 + 语义文件层) ## 模块 | 模块 | 说明 | |------|------| | [harness-coder/](harness-coder/) | **Harness-coder 工程系统** — Coder 调度中心 + 9 Skill 编排 + 12 Agent + 知识自进化 | | [harness-builder/](harness-builder/) | **Harness-builder 构建系统** — 项目初始化 (Harness-master) + 自升级 (harness-master-upgrade) | | [ppt-master/](ppt-master/) | AI 驱动的原生可编辑 PPTX 生成器 | | [skill-master/](skill-master/) | Skill 创建系统(strategist → executor → reviewer) | | [ui-design/](ui-design/) | **界面原型设计** — HTML/CSS 原型设计 + Click-Flash 协作预览 + Design Token 规范输出 | ## Harness-coder 工程系统 ### 开发全流程 ``` @Coder(开发调度中心,primary agent) │ ├─ design-flow(设计 → 知识嵌入 → 工件评审) ├─ dev-flow(apply + 测试门禁 + 降级前搜索) ├─ audit-flow(三阶段纯评审 + 知识上下文) └─ audit-fix-loop(非 OpenSpec 审修循环 + 降级前搜索) ``` **关键设计**:knowledge/ 只在 design-flow 加载一次,嵌入 tasks.md,后续全链路消费嵌入式引用。降级前自动搜索开源方案,减少人工介入。 ### Agent 列表 | Agent | 模式 | 职责 | |-------|:--:|------| | Coder | primary | **开发调度中心** — 事件驱动全流程编排 + 预编码四步 | | Auditor | all | 审计编排 — 调度 7 个 reviewer | | Chronicler | all | 知识复盘、巡检、规则提炼 | | spec-reviewer | subagent | OpenSpec 工件质量 | | architecture-reviewer | subagent | 架构硬约束 + 分层依赖 | | security-reviewer | subagent | 安全扫描 + 密钥/越权 | | code-quality-reviewer | subagent | 语言级质量(lint 工具验证) | | test-reviewer | subagent | 测试覆盖度 + 断言有效性 | | contracts-reviewer | subagent | 隐性约定逐条核对 | | functional-diff-reviewer | subagent | 覆盖度预检 + 行为差异 | ### Skill 列表 | Skill | 用途 | |-------|------| | design-flow | 设计编排:brainstorming→知识嵌入→/opsx-propose→工件评审 | | dev-flow | 执行编排:apply + 测试门禁 + 修复模式 + 降级前搜索 | | audit-flow | OpenSpec 三阶段纯评审(串行 spec-reviewer + 并行 reviewer) | | audit-fix-loop | 非 OpenSpec 审修循环:audit→fix→re-audit + 降级前搜索 | | full-scan | 全量知识扫描:四步骤语义提取 + 交叉去重 + 已有知识库备份覆写 | | iteration-review | 迭代复盘:增量提取 + 边界检查 + 语义复用 | | knowledge-health-check | 六维巡检:meta溯源/过时/空白/断链/漂移/纯度 | | rule-watch | 规则与知识双向分流(业务域→knowledge/rules/,通用→agent-spec/) | | skill-master | AI 驱动 Skill 创建与优化 | ### 知识管理(v3 四类目录) | 目录 | 核心问题 | 粒度约束 | |------|---------|---------| | `architecture/` | 对系统结构的理解会错在哪里? | 基类/接口,≤3 代表子类,≤5 节点流程 | | `standards/` | 完成任务时会跳过哪步? | 项目特有模式,≥2 实例 | | `rules/` | 会在什么情况下触发什么后果? | 业务域约束,不含通用编码规范 | | `implicit/` | 修改时不知道这条就会改错吗? | 合法违规,仅防改错不指引新代码 | | `semantics/` | 这个文件做了什么? | 每个源文件一个语义提炼 | ### v3.4 特性 - **嵌入式知识流**:knowledge/ 只在 design-flow 加载一次,嵌入 tasks.md,后续全链路消费 - **降级前搜索**:dev-flow + audit-fix-loop 在 ⛔降级前自动搜索 GitHub/Stack Overflow - **交叉去重**:full-scan §3.6 7 项强制检查,杜绝四类知识重复 - **粒度硬上限**:architecture 实体 ≤3 代表子类,流程 ≤5 节点 - **meta 溯源**:所有知识条目附带永久路径 source,禁止 staging/ 临时路径 - **隐藏知识收窄**:implicit/ 仅防改错("修改时会改错吗?"),不指引新代码 - **模板统一预下载**:Harness-master 初始化时一次性下载全部模板到 agent-spec/ - **业务/通用规则分流**:rule-watch 区分业务域规则(knowledge/rules/)vs 通用编码规范(agent-spec/) ## 公共技能 独立技能(部署到 `~/.config/opencode/skills/`): | 技能 | 用途 | 依赖 | |------|------|------| | [document-reader](skills/document-reader/) | DOCX/XLSX/PPTX/PDF/CSV → Markdown | Python venv | | [md2pdf](skills/md2pdf/) | Markdown → PDF,含 Mermaid 图表渲染 | Python venv + npm + bun | | [fireworks-tech-graph](skills/fireworks-tech-graph/) | 出版级技术图表生成(SVG+PNG) | Python venv (cairosvg) | | [文生图](skills/文生图/) | 通用文生图(Kolors) | `SILICONFLOW_API_KEY` | | [手绘画册](skills/手绘画册/) | 手绘风格技术配图(豆包) | `ARK_API_KEY` | | [opening-files](skills/opening-files/) | 系统默认应用打开文件 | 无 | | [rich-interaction](skills/rich-interaction/) | 讨论中图形化表达(Mermaid/ECharts) | 无(CDN) | | [lite-design](skills/lite-design/) | 轻量设计检查——无 OpenSpec 项目免器件设计评审 | 无 | | [recognizing-image-text](skills/recognizing-image-text/) | 图片 OCR:文字提取 / 流程图逻辑 / 图表数据 / Wiki 综合 | `SILICONFLOW_API_KEY` | | [session-checkpoint](skills/session-checkpoint/) | 会话 Checkpoint——带上下文的临时保存/恢复 | 无 | | [yao-bayesian-skill](skills/yao-bayesian-skill/) | 贝叶斯决策——模糊问题 → 概率分析 + HTML/MD 报告 | Python 3 标准库 | ## API Key 所有 API Key 从环境变量读取,**禁止硬编码**。 ### DeepSeek(OpenCode 全局) ppt-master 的 LLM 调用由 OpenCode Agent 自身完成,默认使用 `deepseek/deepseek-v4-pro`。DeepSeek Key 在 OpenCode 中配置即可,**无需各 Skill 单独设置**: 1. 获取 Key:前往 [DeepSeek 开放平台](https://platform.deepseek.com/) → API Keys 2. 在 OpenCode 中配置:`/config:model`,将 provider 设为 `deepseek`,填入 API Key 或在 `~/.config/opencode/opencode.json` 中配置 DeepSeek provider。 ### Skill 专用 Key | 变量名 | 平台 | 使用者 | 获取地址 | |--------|------|--------|----------| | `SILICONFLOW_API_KEY` | 硅基流动 (SiliconFlow) | 文生图(Kolors) | https://cloud.siliconflow.cn | | `ARK_API_KEY` | 火山引擎 (豆包) | 手绘画册、ppt-master | https://console.volcengine.com | 如使用 ppt-master 的其他文生图/搜索/音频后端,按提供商设置对应 Key(`OPENAI_API_KEY`、`GEMINI_API_KEY`、`ZHIPU_API_KEY`、`PEXELS_API_KEY`、`MINIMAX_API_KEY` 等),详见各 Skill 的 SKILL.md。 ### 设置方式 ```bash # === Linux / macOS === # 临时 export SILICONFLOW_API_KEY="sk-xxx" export ARK_API_KEY="xxx" # 持久化(bash) echo 'export SILICONFLOW_API_KEY="sk-xxx"' >> ~/.bashrc && source ~/.bashrc # 持久化(zsh) echo 'export SILICONFLOW_API_KEY="sk-xxx"' >> ~/.zshrc && source ~/.zshrc ``` ```bat :: === Windows === :: 临时(CMD) set SILICONFLOW_API_KEY=sk-xxx set ARK_API_KEY=xxx :: 临时(PowerShell) $env:SILICONFLOW_API_KEY="sk-xxx" $env:ARK_API_KEY="xxx" :: 持久化(CMD,管理员终端) setx SILICONFLOW_API_KEY "sk-xxx" setx ARK_API_KEY "xxx" :: 持久化(PowerShell) [Environment]::SetEnvironmentVariable("SILICONFLOW_API_KEY", "sk-xxx", "User") [Environment]::SetEnvironmentVariable("ARK_API_KEY", "xxx", "User") ``` ## 安装 各模块有独立的 `install.md`,在 OpenCode 中告诉 Agent: ``` 请按照 https://gitee.com/dxdbc/opencode-ext/raw/main/harness-coder/install.md 安装 Harness-coder 请按照 https://gitee.com/dxdbc/opencode-ext/raw/main/ppt-master/install.md 安装 PPT Master 请按照 https://gitee.com/dxdbc/opencode-ext/raw/main/ui-design/install.md 安装 UI Designer ``` ## 目录结构 ``` opencode-ext/ ├── harness-coder/ # Harness-coder 工程系统 │ ├── README.md │ ├── install.md │ ├── agents/ # 12 个 Agent(Coder/Auditor/Chronicler + 9 reviewer/subagent) │ ├── skills/ # 9 个 Skill(design/dev/audit flow + audit-fix-loop + 5 知识管理) │ ├── templates/ # 模板(coding-style/testing/architecture/verification-tools/review/knowledge) │ └── docs/ # 设计文档 ├── harness-builder/ # Harness-builder 构建系统 │ ├── agents/ # 1 个 Agent(Harness-master) │ └── skills/ # 1 个 Skill(harness-master-upgrade) ├── ppt-master/ # PPT 生成系统 ├── skill-master/ # Skill 创建系统 ├── ui-design/ # 界面原型设计 │ ├── AGENTS.md # 设计工作规范 │ ├── install.sh # 安装脚本 │ └── skills/ │ ├── ui-ux-pro-max/ # 设计智能数据库 │ ├── tools/click-flash/ # 点击-闪光预览服务 │ └── templates/ # 规范输出模板 ├── skills/ # 独立技能(document-reader 等) ├── agent-spec/ # 开发规范 + 知识层 ├── AGENTS.md # 开发上下文(含自主等级 L3 + 降级声明) └── review/ # Auditor 评审输出 ``` ## 版本 | 版本 | 里程碑 | |------|--------| | v3.6.0 | 全量知识扫描 — 306 源文件/173 语义/16 四类条目/交叉去重 + 语义复用 + harness-coder/install.md 重构 | | v3.5.0 | 公共 Skills 独立部署 + lite-design/session-checkpoint/recognizing-image-text 新增 | | v3.4.0 | v3 知识结构全链路对齐 — 嵌入式知识流 + 交叉去重 + 粒度控制 + 降级前搜索 + 隐藏知识收窄 | | v3.3.0 | L3 防御纵深就绪 — 独立验证层 + 架构守护 + 降级声明 | | v3.2.1 | fix: Auditor subagent 名称大小写对齐 | | v3.2.0 | L3 硬触发基础设施 — 自主写入 + checkpoint + 关键词索引 + audit-fix-loop | | v3.1.0 | Harness Batch 1 优化 | ## 开发 ```bash git clone https://gitee.com/dxdbc/opencode-ext.git ``` 详见 [AGENTS.md](AGENTS.md) 和 [agent-spec/](agent-spec/)。