知更 Knower 文档

工具系统

Agent 可调用 8 个工具，每个工具有独立的输入模式（input_schema）、执行逻辑和超时设置。工具定义位于 agent/tools/。

工具清单

工具-阶段兼容矩阵

Router 在执行工具前会检查工具与当前 State 阶段的兼容性：

工具调用序列图

LLM 客户端（双协议架构）

系统同时支持 Anthropic 原生 API 和 OpenAI-compatible API，两个客户端实现统一接口。

统一接口规范

// 两个客户端都实现相同接口
interface LLMClient {
  chat({ system, messages, tools, maxTokens, temperature }): Promise<{
    content: ContentBlock[],    // Anthropic-style content blocks
    stopReason: 'tool_use' | 'end_turn',
    usage: { input_tokens, output_tokens }
  }>

  async *stream({ system, messages, tools, maxTokens, temperature, signal }): AsyncGenerator<
    | { type: 'text', text: string }
    | { type: 'final', content: ContentBlock[], stopReason, toolUseInputs, hasToolUse, usage }
  >
}复制

Anthropic 客户端

API 端点： POST /v1/messages

认证头： x-api-key: {apiKey}

流式协议： Server-Sent Events (SSE)，事件类型包括 content_block_start、content_block_delta、content_block_stop

OpenAI-Compatible 客户端

API 端点： POST /v1/chat/completions

认证头： Authorization: Bearer {apiKey}

流式协议： SSE，标准 OpenAI 格式（data: {choices: [{delta: {...}}]}）

格式转换层

OpenAI 客户端内部进行 Anthropic ↔ OpenAI 格式转换：

• 工具定义： Anthropic input_schema → OpenAI function.parameters
• 消息格式： Anthropic tool_result blocks → OpenAI role: 'tool' messages
• 工具调用： Anthropic tool_use blocks → OpenAI tool_calls 数组
• 输出归一化： OpenAI tool_calls → Anthropic-style tool_use content blocks

LLM 流式状态机

API 配置

在设置页面配置 LLM 服务。支持 Anthropic (Claude) 和 OpenAI-compatible 两种协议。

配置项说明

平台参数

数据库

使用 sql.js（WebAssembly 版 SQLite）本地数据库 knower.db。支持防抖写入（2s 延迟）和进程退出时强制刷盘。

写入策略

// 防抖写入：2s 内多次修改只写一次
let _dirty = false
let _saveTimer = null

function saveDb() {
  _dirty = true
  if (_saveTimer) return
  _saveTimer = setTimeout(() => {
    if (!_dirty || !db) return
    _dirty = false
    const data = db.export()      // 导出为 Uint8Array
    const buffer = Buffer.from(data)
    fs.writeFileSync(DB_PATH, buffer)
  }, 2000)
}

// 进程退出时强制刷盘
process.on('exit', flushDb)
process.on('SIGINT', () => { flushDb(); process.exit() })
process.on('SIGTERM', () => { flushDb(); process.exit() })复制

数据库模块导出 42+ 个函数，覆盖所有表的 CRUD 操作。

数据库 Schema

完整 Schema 包含 10 张表，支持多账号数据隔离。

accounts — 多创作者账号管理

CREATE TABLE IF NOT EXISTS accounts (
  id          TEXT PRIMARY KEY,
  name        TEXT NOT NULL,
  platform    TEXT NOT NULL,
  uid         TEXT DEFAULT '',
  avatar_url  TEXT DEFAULT '',
  description TEXT DEFAULT '',
  is_active   INTEGER DEFAULT 0,
  user_id     TEXT NOT NULL DEFAULT 'default',
  created_at  DATETIME DEFAULT (datetime('now','localtime')),
  updated_at  DATETIME DEFAULT (datetime('now','localtime'))
)复制

scripts — 脚本存储

CREATE TABLE IF NOT EXISTS scripts (
  id         INTEGER PRIMARY KEY AUTOINCREMENT,
  content    TEXT NOT NULL,
  analysis   TEXT,
  result     TEXT,
  account_id TEXT NOT NULL DEFAULT 'default',
  created_at DATETIME DEFAULT (datetime('now','localtime'))
)复制

conversations — 对话记录

CREATE TABLE IF NOT EXISTS conversations (
  id          INTEGER PRIMARY KEY AUTOINCREMENT,
  title       TEXT NOT NULL DEFAULT '新对话',
  is_pinned   INTEGER DEFAULT 0,
  account_id  TEXT NOT NULL DEFAULT 'default',
  created_at  DATETIME DEFAULT (datetime('now','localtime')),
  updated_at  DATETIME DEFAULT (datetime('now','localtime'))
)复制

messages — 消息

CREATE TABLE IF NOT EXISTS messages (
  id              INTEGER PRIMARY KEY AUTOINCREMENT,
  conversation_id INTEGER NOT NULL,
  role            TEXT NOT NULL,          -- 'user' | 'assistant' | 'system'
  content         TEXT NOT NULL,
  created_at      DATETIME DEFAULT (datetime('now','localtime')),
  FOREIGN KEY (conversation_id) REFERENCES conversations(id)
)复制

memories — Agent 记忆

CREATE TABLE IF NOT EXISTS memories (
  id          INTEGER PRIMARY KEY AUTOINCREMENT,
  account_id  TEXT NOT NULL DEFAULT 'default',
  type        TEXT NOT NULL,          -- 'style' | 'preference' | 'topic'
  key         TEXT NOT NULL,
  value       TEXT NOT NULL,
  evidence    TEXT,
  weight      REAL NOT NULL DEFAULT 0.5,
  created_at  TEXT NOT NULL,
  updated_at  TEXT NOT NULL
)复制

crawl_tasks — 爬取任务

CREATE TABLE IF NOT EXISTS crawl_tasks (
  id            INTEGER PRIMARY KEY AUTOINCREMENT,
  platform      TEXT NOT NULL,
  keywords      TEXT,
  crawler_type  TEXT DEFAULT 'search',
  status        TEXT DEFAULT 'pending',  -- 'pending' | 'running' | 'done' | 'error'
  result_json   TEXT,
  account_id    TEXT NOT NULL DEFAULT 'default',
  created_at    DATETIME DEFAULT (datetime('now','localtime')),
  completed_at  DATETIME
)复制

crawl_content — 爬取内容数据

CREATE TABLE IF NOT EXISTS crawl_content (
  id            INTEGER PRIMARY KEY AUTOINCREMENT,
  task_id       INTEGER,
  platform      TEXT NOT NULL,
  content_type  TEXT,
  content_id    TEXT,
  title         TEXT,
  "desc"        TEXT,
  author_name   TEXT,
  author_id     TEXT,
  like_count    INTEGER DEFAULT 0,
  comment_count INTEGER DEFAULT 0,
  share_count   INTEGER DEFAULT 0,
  play_count    INTEGER DEFAULT 0,
  created_at    TEXT,
  raw_json      TEXT,
  category      TEXT DEFAULT '未分类',
  source_uid    TEXT DEFAULT '',
  source_name   TEXT DEFAULT '',
  fetched_at    DATETIME DEFAULT (datetime('now','localtime')),
  FOREIGN KEY (task_id) REFERENCES crawl_tasks(id),
  UNIQUE(platform, content_id)
)复制

topic_suggestions — 选题建议

CREATE TABLE IF NOT EXISTS topic_suggestions (
  id          INTEGER PRIMARY KEY AUTOINCREMENT,
  account_id  TEXT NOT NULL DEFAULT 'default',
  title       TEXT NOT NULL,
  description TEXT,
  score       REAL DEFAULT 0,
  reasoning   TEXT,
  source      TEXT DEFAULT 'ai',
  status      TEXT DEFAULT 'pending',  -- 'pending' | 'approved' | 'rejected'
  created_at  DATETIME DEFAULT (datetime('now','localtime'))
)复制

content_notes — 创作者笔记

CREATE TABLE IF NOT EXISTS content_notes (
  id          INTEGER PRIMARY KEY AUTOINCREMENT,
  account_id  TEXT NOT NULL DEFAULT 'default',
  title       TEXT,
  content     TEXT NOT NULL,
  tags        TEXT,
  created_at  DATETIME DEFAULT (datetime('now','localtime')),
  updated_at  DATETIME DEFAULT (datetime('now','localtime'))
)复制

content_library — 内容素材库

CREATE TABLE IF NOT EXISTS content_library (
  id          INTEGER PRIMARY KEY AUTOINCREMENT,
  account_id  TEXT NOT NULL DEFAULT 'default',
  type        TEXT NOT NULL,          -- 'reference' | 'template' | 'asset'
  title       TEXT,
  content     TEXT NOT NULL,
  metadata    TEXT,
  created_at  DATETIME DEFAULT (datetime('now','localtime'))
)复制

IPC 通道全表

渲染进程通过 contextBridge 与主进程通信，安全配置：contextIsolation: true，nodeIntegration: false。所有 handler 使用 ipcMain.handle / ipcRenderer.invoke 模式。

设置存储

对话管理

消息管理

脚本管理

爬虫

账号管理

数据查询

选题管理

笔记与素材

记忆系统

窗口控制

事件流（M→R）

技术栈

项目结构

knower/
├── electron/
│   ├── main.ts              # 主进程：窗口创建(~48个IPC handler)
│   └── preload.ts           # contextBridge暴露~50个方法
├── src/
│   ├── App.tsx              # 页面路由 (useState<Page>)
│   ├── components/
│   │   ├── ChatView.tsx     # 创作台（Agent流式输出）
│   │   ├── Sidebar.tsx      # 侧边栏（导航+对话历史）
│   │   ├── AccountSwitcher.tsx  # 多账号切换
│   │   ├── MaterialCards.tsx # 物料卡片展示
│   │   ├── SettingsView.tsx # API配置页
│   │   ├── TopicsView.tsx   # 灵感库
│   │   └── DataView.tsx     # 数据分析
│   ├── contexts/
│   │   ├── ToastContext.tsx  # 全局Toast
│   │   ├── PlatformContext.tsx # 平台信息
│   │   └── AccountContext.tsx  # 账号状态
│   ├── lib/
│   │   └── gsap.ts          # 页面过渡动画
│   ├── types/
│   │   └── electron.ts      # IPC类型定义
│   └── index.css            # Tailwind组件样式
├── knower-agent/
│   ├── agent/
│   │   ├── core.js          # ReAct主循环(MAX_ITERATIONS=10)
│   │   ├── state.js         # 有限状态机(8状态)
│   │   ├── router.js        # 条件路由+工具兼容检查
│   │   ├── processor.js     # 工具结果处理+上下文构建
│   │   ├── cache.js         # 系统提示词缓存
│   │   └── tools/           # 8个工具实现
│   │       ├── analyze_script.js
│   │       ├── expand_script.js
│   │       ├── crawl_data.js
│   │       ├── crawl_data_batch.js
│   │       ├── query_data.js
│   │       ├── save_result.js
│   │       ├── request_user_input.js
│   │       └── suggest_topics.js
│   ├── llm/
│   │   ├── index.js         # LLM客户端工厂
│   │   ├── anthropic.js     # Anthropic SDK封装
│   │   └── openai-compat.js # OpenAI兼容(格式转换层)
│   ├── virality-score/
│   │   ├── index.js         # 统一入口
│   │   ├── metrics.js       # 12个指标计算
│   │   ├── normalizer.js    # 4种归一化器(fit-transform)
│   │   └── scorer.js        # 维度融合+置信度+解读
│   ├── db/
│   │   └── index.js         # SQLite WASM(10表,42+函数)
│   ├── lib/
│   │   └── crawler.js       # Python子进程桥接
│   └── crawler/             # MediaCrawler Python模块
├── tailwind.config.js       # 颜色和字体定义
├── vite.config.ts           # Vite + electron构建配置
└── tsconfig.json复制

系统架构图

分支约定

提交规范

提交格式：type(scope): 描述

贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 仓库并创建功能分支 feat/your-feature
2. 按照提交规范进行开发
3. 确保 npm run build 通过
4. 提交 Pull Request 到 dev 分支

许可证

知更 Knower 采用 MIT License 开源协议发布。

你可以自由地使用、修改和分发本软件，但需保留原始版权声明和许可证。