opc-agent 5.0.0-rc.9 → 5.0.0

package/CHANGELOG.md

@@ -1,5 +1,105 @@
 # Changelog
 
+## [5.0.0-rc.22] - 2026-04-24
+
+### New Features
+- **read_file / write_file** — Agent 可以直接读写本地文件，支持路径安全检查（防止逃逸 workspace）、100KB 读取上限、二进制检测、append 模式
+- **语音合成 (Voice Reply)** — 集成 edge-tts，双通道实现（Python CLI + WebSocket 直连微软服务 fallback），默认中文语音 `zh-CN-XiaoxiaoNeural`
+- **`opc voice test "<文字>"`** — CLI 语音测试命令
+- **OAD Schema 扩展** — voice.tts 配置新增默认值（provider=edge-tts, voice=zh-CN-XiaoxiaoNeural, speed=1.0）
+
+## [5.0.0-rc.21] - 2026-04-24
+
+### New Features
+- **MCP 完整集成** — MCPClientManager（连接外部 MCP Server）+ MCPServer（暴露 OPC Agent builtin tools 给外部 MCP Client）+ CLI `opc mcp list/test/serve`
+- **spawn_subagents** — 并行子代理工具，支持多任务并行执行
+- **Ollama Embedding Hybrid Search** — DeepBrain 语义搜索（FTS5 + Ollama cosine similarity）
+- **execute_code** — JS/TS/Python 沙箱执行
+- **Skill→Tool** — 自动将 Skill 文件转换为可调用的 Tool
+- **Provider Failover 增强** — 含 gpt-4o-mini → Ollama-first 默认值修复
+- **handleMessageStream pipeline 修复**
+
+## [5.0.0-rc.14] - 2026-04-23
+
+### New Features
+- **OutputGuard** — Unified output sanitization pipeline with 6 rules: PII scrubbing, prompt-injection echo suppression, `<think>` reasoning block stripping, model identity self-disclosure detection (Claude/GPT/Gemini/etc.), jailbreak echo filtering, and sensitive-key redaction. Integrated into all 6 active channels (Telegram, Web, WeChat, Feishu, Discord, Slack) with full streaming support.
+
+## [5.0.0-rc.13] - 2026-04-23
+
+### New Features
+- **Hybrid FTS5 + Semantic Search** — DeepBrain now combines SQLite FTS5 full-text search with vector embeddings for higher-recall recall queries
+- **Skill Platform Filter** — Skills declare supported platforms; runtime skips unsupported tools automatically
+- **TUI LogStream** — Live structured log panel inside the terminal chat UI
+- **MCPClient stub** — MCP client interface wired into runtime (server connectivity TBD)
+- **WorkflowEngine** — DAG-based task orchestration with step dependencies and parallel branches
+- **SandboxManager** — Isolated execution environment for untrusted code steps
+- **Workstation Template system** — `opc init --template <id>` scaffolds a complete agent workspace (e.g. `opc init --template ceo-coach-socratic`)
+- **7-layer System Prompt Assembly** — Layered prompt construction: base identity → EGO.md → SOUL.md → CONTEXT.md → memory → skills → conversation history
+- **DeepBrain Auto-import** — Knowledge base is automatically populated on `opc brain learn`
+- **DeepBrain Recall in Conversations** — Every conversation turn runs a semantic prefetch against DeepBrain and injects relevant memories into context
+
+## [5.0.0-rc.12] - 2026-04-22
+
+### New Features
+- **FailoverProvider** — Automatic LLM provider failover with configurable priority order and circuit-breaker
+- **HeartbeatMonitor** — Per-provider liveness probes; removes unhealthy providers from rotation
+- **`create_skill` tool** — Agent self-writes new skills at runtime; persisted to disk and hot-reloaded
+- **InsightsExtractor** — Structured extraction of entities, decisions, and action items from conversation turns
+- **SubAgentManager** — Spawn, track, and aggregate results from parallel sub-agents
+- **SessionEventEmitter** — Internal event bus for session lifecycle hooks (start, turn, end, error)
+- **InjectionDetector** — Heuristic + pattern-based prompt injection detection layer
+- **ProgressiveDisclosure** — Truncates lengthy tool outputs; exposes `show more` expansion in TUI
+- **ContextCompressor V2** — Token-aware summarisation with configurable compression ratio and anchor preservation
+
+## [5.0.0-rc.11] - 2026-04-22
+
+### New Features
+- **Provider Failover** — LLM provider switching on transient errors; retries with exponential back-off
+- **Prompt Injection Detection** — Early-stage detection of adversarial inputs before they reach the model
+
+## [5.0.0-rc.10]
+
+### New Features
+- **P1 Orchestration** — Memory prefetch/sync, context window guard (auto-truncation before overflow), cron job delivery to channels, DeepBrain recall wired into every turn
+
+## [5.0.0-rc.9]
+
+### New Features
+- **P0 Orchestration** — SQLite conversation history persistence, context compaction (summarise-and-truncate), isolated cron scheduler
+- **Pipe Mode Tool Loop** — `opc run --pipe` accepts newline-delimited JSON tasks; agent executes tool loop and writes JSON results to stdout
+- **Skill Loader Integration** — Runtime discovers and loads skills from `~/.opc/skills/` and project-local `skills/` on startup
+
+## [5.0.0-rc.5]
+
+### Improvements
+- **Banner v2** — High-fidelity ASCII-art splash with version and hardware stats
+- **TUI Markdown Enhancement** — Tables, code fences, and inline styles rendered natively in terminal
+
+## [5.0.0-rc.3]
+
+### New Features
+- **TUI Markdown Rendering** — Full CommonMark rendering in `opc chat` terminal UI
+
+## [5.0.0-rc.2]
+
+### New Features
+- **Interactive Tool Calling** — Tools are confirmed and displayed live inside the TUI before execution
+
+## [5.0.0-rc.1] - 2026-04-20
+
+### Major Release — Complete v5 Rewrite
+- All-in-one architecture merging **DeepBrain** (knowledge) + **AgentKits** (model routing) + **Workstation** (templates) into a single package
+- 1114 tests passing
+- TypeScript 5.x, CommonJS module format, Node.js 18+ required
+- Declarative `oad.yaml` agent definition replaces legacy JSON config
+- New self-evolution engine: L1 Experience Compile → L2 Memory Consolidate → L3 Skill Discovery → L4 Group Evolution
+
+## [5.0.0-alpha.1]
+
+- Initial v5 alpha — early preview of the rewritten architecture
+
+---
+
 ## [4.2.0] - 2026-04-21
 
 ### New Features
@@ -36,7 +136,7 @@
 ### CLI Commands
 init, chat, run, dev, start, stop, status, jobs, skills, info, build, test, analytics, brain, logs, score, search, deploy, publish, install, plugin, tool, workflow, migrate
 
-## 1.4.0 (2026-04-18)
+## [1.4.0] - 2026-04-18
 - feat: wire Analytics into AgentRuntime (message timing, skill usage, error tracking)
 - feat: expose analytics snapshot on /health and /api/dashboard endpoints
 - feat: enhanced /health endpoint with agent name, version, uptime, memory type, skills, channels
@@ -44,16 +144,16 @@ init, chat, run, dev, start, stop, status, jobs, skills, info, build, test, anal
 - feat: WebChannel metadata setters (version, memory type, skills, channels, analytics provider)
 - feat: AgentRuntime.getAnalytics() and getConfig() accessors
 
-## 1.3.1 (2026-04-17)
+## [1.3.1] - 2026-04-17
 - fix: remove residual DTV/marketplace references
 - fix: duplicate WatchPattern export
 
-## 1.3.0 (2026-04-17)
+## [1.3.0] - 2026-04-17
 - feat: Traces collection (OpenTelemetry-style)
 - feat: DeepBrain exporter
 - feat: brain/logs/score CLI commands
 
-## 1.2.0
+## [1.2.0]
 - Initial public release
 - 11 channels, plugins, analytics
 - Declarative OAD configuration

package/CONTRIBUTING.md

@@ -1,36 +1,175 @@
-# Contributing
+# Contributing to OPC Agent
 
-Thanks for your interest in contributing!
+Thanks for your interest in contributing! This guide covers everything you need to get started.
 
-## Getting Started
+---
 
-1. Fork the repo
-2. Clone your fork
-3. Install dependencies: `npm install`
-4. Create a branch: `git checkout -b feat/my-feature`
-5. Make your changes
-6. Run tests: `npm test`
-7. Commit: `git commit -m "feat: description"`
-8. Push and open a PR
+## Development Setup
+
+```bash
+# 1. Fork and clone
+git clone https://github.com/Deepleaper/opc-agent.git
+cd opc-agent
+
+# 2. Install dependencies
+npm install
+
+# 3. Build (TypeScript → CommonJS)
+npx tsc
+
+# 4. Run tests
+npx vitest run
+```
+
+> **Note:** This is a **CommonJS** project (not ESM). All output goes to `dist/`. TypeScript 5.x is required. There are **no native dependencies** — the project uses `sql.js` (WASM) instead of `better-sqlite3` so it works on all platforms without compilation.
+
+---
+
+## Project Structure
+
+```
+src/
+  core/          # Agent loop, runtime, session management, OutputGuard
+  channels/      # One file per channel: telegram.ts, web.ts, slack.ts, …
+  memory/        # DeepBrainMemoryStore, InMemoryStore, vector search
+  tools/         # Built-in tools (file ops, web fetch, shell exec, etc.)
+  schema/        # Zod schemas and shared TypeScript types
+  skills/        # Skill loader, BaseSkill, SkillPlatformFilter
+  evolution/     # L1–L4 self-evolution engine
+  workflow/      # WorkflowEngine, SandboxManager, SubAgentManager
+  cli/           # CLI entry point and command handlers
+
+examples/        # Runnable usage examples
+test/            # Test files, co-located with source or in test/
+```
+
+---
+
+## Testing
+
+The project has **1114+ tests** covering unit, integration, and end-to-end scenarios.
+
+```bash
+# Run all tests
+npx vitest run
+
+# Run in watch mode during development
+npx vitest
+
+# Run a specific test file
+npx vitest run src/core/output-guard.test.ts
+```
+
+**Conventions:**
+- Test files live next to the code they test (`foo.ts` → `foo.test.ts`) or under `test/`.
+- Use `describe` / `it` / `expect` from Vitest — no Jest imports.
+- Mock at the boundary: stub external HTTP calls and file I/O, but don't mock internal modules unless unavoidable.
+- Every new feature or bug fix must include a corresponding test.
+
+---
+
+## Adding a Channel
+
+Channels live in `src/channels/`. Each channel extends `BaseChannel` and plugs into the `AgentRuntime`.
+
+1. **Create the file**: `src/channels/my-channel.ts`
+
+```typescript
+import { BaseChannel, type OutboundMessage } from '../core/base-channel';
+
+export class MyChannel extends BaseChannel {
+  readonly name = 'my-channel';
+
+  async start(): Promise<void> {
+    // Connect to the external service
+  }
+
+  async stop(): Promise<void> {
+    // Disconnect cleanly
+  }
+
+  protected async send(message: OutboundMessage): Promise<void> {
+    // Deliver the message — OutputGuard has already run at this point
+  }
+}
+```
+
+2. **Register it** in `src/core/runtime.ts` alongside existing channels.
+
+3. **Add a test** in `src/channels/my-channel.test.ts`.
+
+4. **Document it** in the CLI table in `README.md` and `README.zh-CN.md`.
+
+> OutputGuard runs automatically on every message before `send()` is called — you do not need to add sanitization logic in your channel.
+
+---
+
+## Adding a Built-in Tool
+
+Built-in tools live in `src/tools/`. Each tool implements the `BuiltinTool` interface and is auto-discovered at runtime.
+
+1. **Create the file**: `src/tools/my-tool.ts`
+
+```typescript
+import { type BuiltinTool, type ToolResult } from '../schema/tool';
+
+export const myTool: BuiltinTool = {
+  name: 'my_tool',
+  description: 'What this tool does, for the model to read',
+  parameters: {
+    type: 'object',
+    properties: {
+      input: { type: 'string', description: 'The input value' },
+    },
+    required: ['input'],
+  },
+  async execute(args: { input: string }): Promise<ToolResult> {
+    return { content: `Result: ${args.input}` };
+  },
+};
+```
+
+2. **Export it** from `src/tools/index.ts`.
+
+3. **Add a test** in `src/tools/my-tool.test.ts`.
+
+---
 
 ## Commit Convention
 
-- `feat:` New feature
-- `fix:` Bug fix
-- `docs:` Documentation
-- `test:` Tests
-- `refactor:` Refactoring
-- `chore:` Build/tooling
+| Prefix | Use for |
+|--------|---------|
+| `feat:` | New feature |
+| `fix:` | Bug fix |
+| `docs:` | Documentation only |
+| `test:` | Tests only |
+| `refactor:` | Code restructuring without behavior change |
+| `chore:` | Build, tooling, dependencies |
+
+Examples:
+```
+feat: add WeChat Work channel
+fix: OutputGuard false-positive on base64 strings
+docs: add channel mini-guide to CONTRIBUTING
+```
+
+---
 
-## Code Style
+## Pull Request Checklist
 
-- TypeScript
-- Run `npm run lint` before committing (if available)
+- [ ] `npx tsc` passes with no errors
+- [ ] `npx vitest run` — all tests pass, new tests added
+- [ ] No `.js` output files committed (build artifacts are gitignored)
+- [ ] Docs updated if you added or changed a public API or CLI command
+
+---
 
 ## Questions?
 
-Open a Discussion or Issue.
+Open a [Discussion](https://github.com/Deepleaper/opc-agent/discussions) for design questions or [Issues](https://github.com/Deepleaper/opc-agent/issues) for bugs.
+
+---
 
 ## License
 
-By contributing, you agree that your contributions will be licensed under Apache-2.0.
+By contributing, you agree that your contributions will be licensed under **Apache-2.0**.

package/README.md

@@ -1,190 +1,198 @@
 <div align="center">
 
-# ⚡ OPC Agent — 瞬知 Studio
+# ⚡ OPC Agent
 
-**Your AI workforce, running locally. Zero cloud cost to start.**
+**Your own AI employee — local, private, gets smarter over time.**
 
-One computer. One command. Your own AI agents — learning, evolving, working 24/7.
-
-[![npm](https://img.shields.io/npm/v/opc-agent/alpha)](https://www.npmjs.com/package/opc-agent)
+[![npm](https://img.shields.io/npm/v/opc-agent/alpha?label=opc-agent%40alpha)](https://www.npmjs.com/package/opc-agent)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
 [![Node](https://img.shields.io/badge/Node.js-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![Tests](https://img.shields.io/badge/tests-1226%2B-brightgreen)](tests/)
 
-[Quick Start](#-quick-start) · [Features](#-features) · [Architecture](#-architecture) · [CLI](#-cli-commands) · [中文](README.zh-CN.md)
+[中文文档](README.zh-CN.md)
 
 </div>
 
 ---
 
-## 🚀 Quick Start
+## Why OPC Agent?
+
+AI Agents are powerful, but hard to use for most people:
+
+- **Expensive** — Cloud agents charge per token. Costs add up fast.
+- **No memory** — Every conversation starts from scratch.
+- **Data privacy** — Your chats and documents live on someone else's servers.
+- **Can only chat** — Can't read files, search the web, or run code.
+
+**OPC Agent fixes all of this:**
+
+✅ Runs locally, zero cost (powered by Ollama)<br>
+✅ Gets smarter over time (automatic learning & evolution)<br>
+✅ Your data stays on your machine<br>
+✅ Can read/write files, search the web, execute code, use tools
+
+---
+
+## 🚀 Install
 
-### One-Line Install (recommended)
+Pick your OS, copy one line:
+
+### macOS / Linux
 
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+### Windows
+
+```powershell
 irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
 ```
 
-This automatically installs Node.js, OPC Agent, Ollama, and a recommended AI model based on your hardware.
+> The installer automatically sets up Node.js, OPC Agent, Ollama, and the best AI model for your hardware. No manual steps.
 
-### Or install manually
+### Manual install
 
 ```bash
 npm install -g opc-agent@alpha
-opc setup        # Interactive setup wizard
 ```
 
-### Get started in 30 seconds
+---
+
+## ⚡ Get started in 30 seconds
+
+### Step 1: Create your AI employee
 
 ```bash
-opc chat          # Chat in terminal
-opc studio        # Open web UI → localhost:4000
-opc run           # Start everything: Agent + Telegram + Web + Studio
+opc init my-agent
+cd my-agent
 ```
 
----
-
-## ✨ Features
+### Step 2: Start chatting
 
-| Feature | Description |
-|---------|-------------|
-| 🧠 **Self-Evolving** | 4-layer evolution engine: Experience → Memory → Skills → Group knowledge |
-| 💰 **Zero Cost Start** | Runs 100% locally with Ollama. No API key needed. |
-| 🎨 **Studio UI** | Web-based management at localhost:4000 — models, channels, knowledge, templates |
-| 📱 **Multi-Channel** | Telegram, Web, WeChat, Feishu, Discord, Slack, Email |
-| 🔧 **40 Built-in Skills** | File ops, web search, code execution, image generation, and more |
-| 🤖 **A2A Protocol** | Agent-to-agent communication for multi-agent workflows |
-| 📦 **All-in-One** | DeepBrain (knowledge) + AgentKits (models) + Workstation (templates) |
-| 🔒 **Privacy First** | Your data stays on your machine. No telemetry. |
+```bash
+opc chat
+```
 
----
+That's it. Your AI employee is ready.
 
-## 🏗 Architecture
+### More
 
-```
-┌──────────────────────────────────────────┐
-│              OPC Agent CLI               │
-│   opc chat · opc studio · opc run       │
-├──────────────────────────────────────────┤
-│  Agent Loop    │  Self-Evolution (L1-L4) │
-│  Context       │  L1 Experience Compile  │
-│  Assembly      │  L2 Memory Consolidate  │
-│                │  L3 Skill Discovery     │
-│                │  L4 Group Evolution     │
-├──────────────────────────────────────────┤
-│  DeepBrain     │ AgentKits  │Workstation │
-│  (Knowledge)   │ (Models)   │(Templates) │
-│  SQLite+FTS5   │ Ollama/API │ Industry   │
-├──────────────────────────────────────────┤
-│  Channels                                │
-│  Telegram │ Web │ WeChat │ Feishu │ ...  │
-└──────────────────────────────────────────┘
+```bash
+opc studio        # Web dashboard at localhost:4000
+opc run           # Start everything: chat + Telegram + web + dashboard
 ```
 
-### How it works
+---
 
-1. **You talk** → Agent receives message via any channel
-2. **Agent thinks** → Context assembly + tool selection + LLM reasoning
-3. **Agent acts** → Executes tools, calls APIs, generates content
-4. **Agent learns** → Every interaction feeds the evolution engine
-5. **Agent evolves** → Knowledge distills upward: experience → memory → skills
+## What can it do?
+
+OPC Agent isn't just a chatbot. It's an **AI employee that gets work done**:
+
+| Capability | Details |
+|-----------|---------|
+| 💬 **Chat** | Terminal or web interface |
+| 📁 **Read & write files** | Read your docs, write reports, organize notes |
+| 🔍 **Web search** | Real-time search for up-to-date information |
+| 🌐 **Read web pages** | Fetch and summarize any URL |
+| 💻 **Execute code** | Run JavaScript, TypeScript, Python |
+| 🧠 **Memory** | Remembers past conversations, gets smarter over time |
+| 🔧 **MCP tool extensions** | Connect GitHub, databases, Slack, and more |
+| 📱 **Telegram bot** | Add a bot token and chat via Telegram |
+| 🎙 **Voice synthesis** | Text-to-speech via edge-tts |
+| 👥 **Sub-agents** | Spawn parallel workers for complex tasks |
+| 🔄 **Provider failover** | Circuit breaker, automatic retry with fallback |
+| 📋 **20 workstation roles** | Pre-built templates: customer service, engineer, analyst, executive... |
+| ⏰ **Scheduled tasks** | Cron jobs auto-registered from templates |
 
 ---
 
-## 💻 CLI Commands
+## 🧠 Gets smarter over time
 
-| Command | Description |
-|---------|-------------|
-| `opc setup` | Interactive setup wizard |
-| `opc init [name]` | Create new agent project |
-| `opc chat` | Terminal chat with agent |
-| `opc studio` | Open Studio web UI (port 4000) |
-| `opc run` | Start all services (Agent + channels + Studio) |
-| `opc brain stats` | Show knowledge base statistics |
-| `opc brain recall <query>` | Semantic search in knowledge |
-| `opc brain learn <file>` | Import document into knowledge |
-| `opc doctor` | Diagnose installation issues |
+This is what makes OPC Agent different: **it evolves.**
+
+```
+You chat with your AI
+    ↓
+AI extracts knowledge from the conversation     ← automatic
+    ↓
+Knowledge is saved to a local database           ← on your machine
+    ↓
+Next conversation references that knowledge      ← it remembers
+    ↓
+Knowledge gradually refines and improves         ← gets better over time
+```
+
+All learning runs on local Ollama models. **Zero cost.**
+
+Knowledge is organized in three layers: **industry → job → workstation** — precise context for every role.
 
 ---
 
-## 🔧 Configuration
+## 🎨 Studio Dashboard
 
-After `opc setup`, all configuration lives in Studio UI (localhost:4000):
+```bash
+opc studio
+```
 
-- **Models** — Switch between Ollama models, add cloud API keys
-- **Channels** — Configure Telegram bot, WeChat, Feishu, etc.
-- **Knowledge** — Drag & drop documents, manage DeepBrain
-- **Templates** — Browse industry/job/workstation templates
-- **Agent Settings** — Edit personality, skills, model assignments
+Open `localhost:4000` in your browser to:
 
-Config files: `~/.opc/config.json` (global), `oad.yaml` (per agent)
+- **Models** — Switch AI models (local or cloud)
+- **Channels** — Configure Telegram bot
+- **Knowledge** — See what your agent has learned
+- **Settings** — Customize personality, skills, behavior
 
 ---
 
-## 📖 Model Support
+## 📖 Model support
+
+### Local (zero cost)
 
-### Local (Ollama) — Zero Cost
-Auto-detected and recommended based on your RAM:
+Auto-recommended based on your RAM:
 
-| RAM | Recommended Model | Size |
-|-----|------------------|------|
+| RAM | Model | Download |
+|-----|-------|----------|
 | ≤3 GB | qwen2.5:0.5b | 400MB |
 | ≤7 GB | qwen2.5:1.5b | 1.0GB |
 | ≤15 GB | qwen2.5:7b | 4.7GB |
 | ≤31 GB | qwen2.5:14b | 9.0GB |
 | 32+ GB | qwen2.5:32b | 19GB |
 
-### Cloud (via AgentKits)
-Configure in Studio → Models: OpenAI, DeepSeek, Anthropic, Qwen, Google Gemini
+### Cloud (optional)
 
----
+Add API keys in Studio: OpenAI, DeepSeek, Anthropic, Qwen, Google Gemini
 
-## 🌐 Multi-Channel
-
-| Channel | Setup |
-|---------|-------|
-| 💬 Web Chat | Built-in, localhost:3000 |
-| 📱 Telegram | Add bot token in Studio |
-| 💬 WeChat | Add app credentials in Studio |
-| 🐦 Feishu | Add app credentials in Studio |
-| 🎮 Discord | Add bot token in Studio |
-| 💼 Slack | Add bot token in Studio |
-| 📧 Email | Add SMTP config in Studio |
+Automatic failover with circuit breaker — if one provider goes down, the next one takes over instantly.
 
 ---
 
-## 🧬 Self-Evolution
-
-OPC Agent gets smarter over time through 4 layers of evolution:
+## 📋 Commands
 
-- **L1 — Experience Compilation**: Raw interactions → structured insights (local Ollama)
-- **L2 — Memory Consolidation**: Insights → refined knowledge (cloud AgentKits)
-- **L3 — Skill Discovery**: Patterns → auto-generated skills (cloud AgentKits)
-- **L4 — Group Evolution**: Individual knowledge → shared wisdom (local Ollama)
-
-All L1/L4 processing runs locally at zero cost. L2/L3 uses cloud models for higher quality.
+| Command | What it does |
+|---------|-------------|
+| `opc init [name]` | Create an AI employee |
+| `opc chat` | Chat in terminal |
+| `opc studio` | Open web dashboard |
+| `opc run` | Start all services |
+| `opc brain stats` | Knowledge base status |
+| `opc brain recall "query"` | Search knowledge |
+| `opc brain learn file.md` | Import a document |
+| `opc voice test "hello"` | Test voice synthesis |
+| `opc mcp list` | List connected tools |
+| `opc doctor` | Diagnose issues |
+| `opc init --role <name>` | Create from workstation template |
+| `opc init --list-roles` | See available roles |
+| `opc template check <path>` | Validate template quality |
+| `opc template test <path>` | Run template tests |
 
 ---
 
-## 📦 Project Structure
+## 🔒 Privacy
 
-```
-~/.opc/                     # Global config
-  config.json               # Settings
-  agents/                   # Agent data
-
-my-agent/                   # Agent workspace
-  EGO.md                    # Agent personality
-  DEEPBRAIN.md              # Knowledge summary
-  oad.yaml                  # Agent definition
-  .opc/
-    brain.db                # Knowledge database
-    skills/                 # Auto-generated skills
-    evolution/              # Evolution logs
-```
+- All data stored locally on your machine
+- No telemetry
+- Local Ollama models never touch the cloud
+- Your knowledge, conversations, and files stay private
 
 ---
 
@@ -195,7 +203,7 @@ git clone https://github.com/Deepleaper/opc-agent.git
 cd opc-agent
 npm install
 npx tsc                    # Build
-npx vitest run             # Test (1100+ tests)
+npx vitest run             # Test
 ```
 
 ---
@@ -208,8 +216,8 @@ Apache-2.0 © [Deepleaper](https://github.com/Deepleaper)
 
 <div align="center">
 
-**Built by [Deepleaper](https://www.deepleaper.com)** — Making AI work for everyone.
+**Built by [Deepleaper](https://www.deepleaper.com)**
 
-⭐ Star this repo if OPC Agent helps you!
+⭐ Star this repo if it helps you!
 
 </div>