更新日志
2026-10 文档按代码全量对齐(基于双版本路由源码)
以 Go 代码仓库(个人版 lite 构建 + 企业版 !lite 构建)为唯一权威依据,对全站文档做逐端点对账,消除文档与代码漂移:
- 幽灵端点清零:
/api/v1/longtask全系(含:taskID/{pause,resume,cancel,approve,reject})确认已随 LongTask 重构移除,全站 15 处引用改为「已移除 + 迁移提示」,任务查询改走/api/v4/tasks(新增 任务与目标 页)。 - DAG 口径精确化:企业版 DAG 组仅注册 3 条路由(
POST /api/v1/dag、GET /api/v1/dag、GET /api/v1/dag/:dagID);dag/stream与dag/:dagID/resume两版均不可用(企业版 handler 存在但未接线返回 404,个人版注册但恒 410 Gone)。此前「企业版全系可用」表述有误。 - 技能市场双路径:企业版
/api/v1/skills/marketplace/*(search/install/:name);个人版/api/v1/marketplace/*(skills/connectors/installed/sync 全套)。见 技能市场。 - MCP 子端点版本化:
/api/v1/mcp/{initialize,tools/list,tools/call,resources/list,prompts/list}REST 子端点为企业版独有;个人版仅POST /api/v1/mcpJSON-RPC 单入口。见 A2A 与 MCP。 - 自进化版本修正:基础面(status/rules/heal/audit/insights/skills)两者都提供;技能谱系、策展扫描、看门狗巡检与
workflows/*子组为个人版独有。见 自进化。 - 缺失能力面补录 8 个新 API 页:任务与目标、SATCOM 卫星协议、实例状态、计费、自进化、A2A 与 MCP、桌面 / 浏览器、企业管理(租户/用户/离职/GDPR/激活/卫星代理/OIDC/Webhook)。
- 侧边栏补齐:原 21 篇孤儿文档全部纳入侧边栏(含新增「更新日志」「工作流」分组),API 参考组扩至 23 页。
2026-09 文档二次对账修订(基于 Go 路由源码)
对 docs/api/* 与指南做一次逐端点代码对账(lyncore 仓库路由注册源码),修正多处与实现不符的声明:
- A2A:实为个人版与企业版均提供(个人版 AgentCard 为
lyncore-litev2.0,开启 Streaming,/.well-known/agent.json公开以便协议互发现,/a2a/*组需鉴权)。此前误标为「仅企业版」,已还原。 - 激活:
GET /api/v1/activation/status仍然存在(两者,纯读);仅activate/register/transfer随 v2 激活码体系退役(恒定 404)。此前「已移除 / 无独立端点」表述有误。 /api/v1/usage/stats:代码层面不存在(已于重构中移除),删除该幽灵端点文档(含 monitoring 页与概览表)。- 鉴权纠正:
/api/v1/briefing、/api/v1/mcp、/api/v4/tools/execute均需 Bearer 令牌(此前称「无鉴权」有误);其中/api/v4/tools/execute仅 dev 模式挂载,生产默认不注册(404);/api/v1/diagnostics亦需鉴权。个人版真正未挂鉴权的仅GET /api/v1/skills(列表)与/api/v1/knowledge/*组(公开)。 - DAG / 工作流(TP-FIX-B AC-13 统一口径):DAG 是个人版能力——作为对话式任务分解(
task_decompose)的内部执行引擎活跃;个人版/api/v1/dag独立路由全系返回 410 Gone(不暴露 HTTP 接口,非「无 DAG」);企业版由 Temporal 驱动并暴露工作流路由。DAG 无可视化画布。(注:此处曾记「长任务/api/v1/longtask两者都有」,后经 2026-10 对账确认该接口已随工作流重构移除,详见下条。)
2026-08 文档准确性修订
本次对全部文档做了基于源代码的准确性修订(此前文档为旧版本,与代码实现存在多处出入)。主要更正:
- 默认端口:统一为
19824(修正此前 FAQ 中8000的错误) - 离线与本地模型:纠正"完全离线 + 原生 Ollama"的表述。当前个人版需联网激活(6 小时心跳),出厂默认模型走官方中继网关
relay.lyncore.top;本地模型(如 Ollama)通过「自定义 OpenAI 兼容端点」接入,Lyncore 没有独立的 Ollama 开关 - 工具清单与名称:按代码真实注册名修订。删除不存在的工具名(
ddg_search、reminder、json_convert、image_gen),修正为真实工具(web_search/web_fetch、media、json、任务用todo等);python_exec/bash_exec标注为个人版独有 - 记忆层级:由「4 层」更正为 5 层(L1 上下文 / L2 偏好 / L3 历史 / L4 行为模式 / L5 长任务)
- DAG 工作流:明确当前没有可视化画布 / 拖拽,靠自然语言描述或 API 创建;企业版由 Temporal 驱动
- 双版本边界:明确游戏化(成就 / 徽章 / 排行 / 积分)为个人版独有;多租户 / RBAC 管理台 / 审计 / GDPR / OIDC / Temporal / gVisor 为企业版独有
- 设置页能力:修正此前"工具权限阈值 / 渠道 webhook / 备份还原"等不实描述;当前设置页仅含安全开关与配额,模型配置在独立页面,工具风险策略在代码侧硬编码
- 知识库格式:支持 TXT / JSON / PDF / CSV / XLS / XLSX(及 PNG/JPG 多模态),不支持 .md / .docx
- API 文档全面重写:
docs/api/*全部 15 篇按真实路由表重写。修正此前大量不存在的路由与错误端口(旧文档用8000与/api/...前缀)——例如会话接口实为/api/v1/chat/conversations(非/sessions)、模型接口在/api/v4/llm/models(非/models)、用户/租户管理在企业版/api/v1/admin/*与/api/v1/tenants/*、提醒与待办无独立 HTTP 接口(仅对话内 MCP 工具)、工作流实为/api/v1/dag与/api/v1/longtask(非/api/workflows/*;longtask已于后续重构移除,见顶部最新条目)、技能市场实为/api/v1/skills/marketplace/*(非/api/skillhub/*)、监控实为/metrics与/api/v1/usage/stats(非/api/monitor/*)。统一认证为 JWT Bearer、错误体为{"code":...,"message":...,"request_id":...}、SSE 为data: {json}帧 +[DONE]终止,并标注各端点「个人版独有 / 企业版独有」
v1.0 初始文档
- 首次发布的中文用户文档(快速开始、FAQ、使用指南、工具参考、API 参考)