Nemos

中文 · English

这个仓库有两部分，授权不同：

部分	是什么	授权
Nemos Memory SDK sdk/typescript/src/	可嵌入的长期记忆内核：分层归档、结构化事实、失效与纠正、多路召回	PolyForm Noncommercial 1.0.0，商业用途需另行授权
小丑鱼（Clownfish） sdk/typescript/examples/companion/	用这套内核做成的本机优先 AI 工作应用，也是 SDK 的完整参考实现	保留全部权利，另行授权

完整授权说明见 LICENSING.md。下面先介绍应用，SDK 用法见作为记忆 SDK 使用。

小丑鱼

一款本机优先、带长期记忆的 AI 工作应用。从一条新对话开始，按需要完成任务或进入学习辅导；复杂工作可以继续交给能力、文件和工作中心。

现在能做什么

小丑鱼把四个常用入口放在同一套界面里：

入口	用户操作	当前实现
对话	直接新建、搜索、切换或删除独立对话，需要时切换为完成任务或学习辅导，并可上传图片或文件	内容自动命名、多任务并行、独立上下文、结果回到原对话
能力	直接描述目标，或直接选择一种能力	后台任务、实时进度、取消与重试、结果预览和下载
文件	打开 Word、PowerPoint、Excel、PDF、TXT 或 Markdown	统一转成 Markdown 处理、逐条列出转换损失、原文件保留可下载、原版式预览、版本记录
工作	查看任务、工作空间、自动化、协作、资料、结果、运行和记忆	多任务归类、定时执行、专家协作、本地资料、交付物和习惯管理

新用户不需要先创建项目，也不需要先理解工具名称。

任务：入口简单，工作方式按目标切换

首页默认只保留一个清楚的一对一入口：

• 直接聊聊适合问答、讨论、灵感和日常交流，默认使用更轻量的响应路径。
• 完成任务围绕明确目标持续推进，后台按需调用专业判断和能力，并形成可继续处理的结果。
• 学习辅导使用讲解、提问、练习和反馈帮助用户真正理解，不要求用户先认识或选择某位老师。

左侧采用常见工作应用的线程列表：产品名称位于图标下方，“新对话”固定在顶部，搜索按需展开。搜索覆盖全部对话并可跳回命中的准确消息；每条对话独立保存未发送草稿。首次发送后，系统会用日常轻量模型在后台提炼简短标题；模型不可用时改用本地规则命名，不阻塞回复，也不把标题请求写进长期记忆。

不同任务可以并行运行，各自保留对话、文件、进度和结果。专家与教学人设仅作为内部执行方式，不占据首页，也不要求用户配置。任务转交能力时，会同时保留用户原文和提炼后的上下文，而不是只传递最后一句话。

能力：说目标，也可以直接选

能力页有两条同等有效的路径：

1. 写下要完成的事情，由小丑鱼根据目标、附件格式和项目工作区选择合适能力；
2. 已经知道要做什么时，直接点击能力并填写要求。

选择后直接进入任务填写，不再增加“准备能力”之类的中间步骤。运行期间可以离开页面，进度和结果会保存在本机。

内置能力覆盖以下常见任务：

• 做 PPT
• 写正式文档
• 深度研究
• 查港股资料
• 梳理复杂问题
• 设计产品界面
• 开发项目
• 整理会议纪要
• 做网页报告
• 比较方案
• 推进商务合作
• 模拟市场机会
• 生成新能力

不同能力可以交付 PPTX、DOCX、PDF、XLSX、HTML、Markdown 或结构化数据。

文件：原文件、工作副本和结果不分家

文件页支持 DOCX、PPTX、XLSX、PDF、TXT 和 Markdown：

• 新建文件和打开文件位于最近文件列表上方；
• 默认只编辑本机工作副本，不会静默覆盖原文件；
• 文件工作副本同时保存到本地服务；多个窗口同时编辑时会阻止旧内容覆盖新内容；
• Markdown 提供目录、格式工具和实时预览，TXT 保持连续文本编辑；
• PDF 可显示原始版式，Office 文件提供结构化预览并保留原文件；
• 上传的文档统一转成 Markdown 再处理。Word、PowerPoint、Excel 和 PDF 打开后即转换；TXT 和 Markdown 本身直接编辑；
• 原文件完整保留、可下载、不会被改写。 转换结果是派生的工作文档，写回只对 TXT 和 Markdown 开放；
• 每次转换都会逐条列出这一份具体丢了什么：Word 的字体字号颜色对齐、页眉页脚、批注修订与图片；PowerPoint 的版式母版主题动画；Excel 的单元格样式、条件格式与图表；PDF 的版式与表格线。标题层级、段落、列表、表格和讲者备注会带过来；
• 转换后用 Markdown 编辑器处理：目录、格式工具、源码与实时预览双视图；
• 需要原版式时可以随时切回“原文件”页签查看，或用桌面 Office 打开原文件；
• 结果可导出 DOCX、PDF、PPTX、XLSX、HTML 和 Markdown——导出的是新文件，不是覆盖原件；
• TXT 与 Markdown 在用户明确授权后可以写回原文件；写回前会检查原文件是否已被其他程序修改；
• DOCX、PPTX、XLSX 和 PDF 可从文件页交给 Windows 已关联的桌面编辑器，保存后再将真实文件修改载入工作台；
• 编辑、自动检查点、工作副本版本、原文件历史、AI 处理进度和结果都留在当前页面；
• 文件列表支持名称搜索和格式筛选；工作副本被外部修改、重命名、移动或删除时会留下状态记录；
• 聊天附件、能力产物和文件工作台共用稳定文件编号；同一文件跨对话和任务流转时只增加关联，不再复制成多个无关文件；
• 从文件中选中一段内容交给能力时，会同时携带选段位置、原文、整份文件和稳定文件编号；
• 聊天或能力生成的结果可直接进入文件页，保存为本机工作副本继续编辑；
• 删除工作文件时先进入垃圾桶，可恢复，也可明确永久删除；
• 可以导出 DOCX、PDF、PPTX、XLSX、HTML 和 Markdown。

工作：持续任务和交付物集中管理

能力执行和需要持续推进的事情都会进入工作中心：

• 任务保存目标、计划、当前进展和下一步；
• 工作空间把同一件事下的多个任务和结果放在一起，可归档和恢复；
• 自动化集中管理每日或按使用频率执行的任务，可暂停、编辑或立即运行；
• 协作由小丑鱼按任务动态选择专家并行检查，用户不需要挑角色，最终仍由小丑鱼交付；
• 资料保存本地笔记、文本文件和链接，只有被明确选入任务的资料才会进入任务上下文；
• 结果集中查看能力生成的文件和报告；
• 运行保留每次执行的状态、日志和错误信息；
• 记忆管理小丑鱼整理出的事实、经历与习惯。

从对话或能力页启动的一次任务也会保留来源、执行状态和产物。完成后可以直接查看结果或继续交给其他能力，不必回头重新说明上下文；后续修改沿用同一任务并形成连续版本。失败时会保留原因和重试入口，一次任务也可以转为每日或按使用频率重复执行。

新用户仍可直接从对话开始，不需要先创建工作空间。只有同一件事出现多个任务时，才需要把它们归到一起。

资料库默认只保存在本机。微信资料、X 和联网搜索会如实显示“已连接、已启用但未连接”或不可用状态，不把预留接口宣传成已经接通。

记忆：少量、可见、由用户控制

小丑鱼使用同仓库的 Nemos Memory SDK 保存长期记忆。当前应用中的实际规则是：

• 用户内容与角色自身内容存放在不同命名空间，角色回复不会写入用户事实库；
• 原始对话进入受保护的归档层，分类记忆用于检索和长期适配；
• 普通对话按当前问题召回相关事实；
• 能力任务可以只召回交付偏好，从“习惯与做法”和“个人偏好”中最多选取 6 项；
• 任务记录会说明本次实际采用了哪些习惯，也可以对单次任务完全关闭习惯记忆；
• 用户可在工作页明确添加习惯，也可忘记单条分类记忆；
• 原始归档不会被“忘记”或“清理分类记忆”误删。

文笔、排版和格式偏好只作为补充，当前任务的明确要求始终优先。

记忆内核的结构、事实演化和召回接口见 TypeScript SDK 文档 与 v0.7 实现设计。

通用模型连接

打开 模型连接 面板后，选择服务商、模型名称并填写 API Key。系统会先验证连接，再保存配置。

小丑鱼会按服务商预设分配模型：支持独立日常对话模型的服务会自动分流，专家、能力、文件生成和复杂任务使用这里配置的任务模型；没有独立分流时，两类任务使用同一个模型。

当前预设包括智谱 GLM、OpenAI、Anthropic Claude、DeepSeek、通义千问、MiniMax 和自定义服务，支持 OpenAI 兼容与 Anthropic 兼容协议。识图、联网和向量能力取决于所选服务与模型。

Windows 下，密钥使用当前用户的 DPAPI 加密并保存在本机；接口不会回显完整密钥。离线模式可以浏览界面、管理本机内容和使用不依赖模型的功能。

数据与隐私边界

• 新安装的记忆数据库、任务、运行记录、文件工作副本和交付物默认位于 ~/.clownfish；检测到旧版 ~/.nemos-companion 数据时会继续沿用，避免迁移时丢失内容。
• 调用已配置的模型时，当前请求及必要上下文会发送给该模型服务商；新对话首次发送后还会使用同一服务商的轻量模型生成短标题；打开联网来源时会访问相应公开服务。
• 本机日志和运行记录会脱敏常见凭证字段，但仍不应把密钥或私人配置写入任务正文。
• 导出或分享备份与便携包前，应确认其中不包含用户数据目录。

当前验证状态

• TypeScript 构建通过；
• 590 项自动化测试全部通过；
• 首页、能力、文件、工作、记忆和模型连接已用全新本机数据目录重新截图核对；
• 能力产物严格区分已生成、已校验、已核验和已确认；演示文稿会用本机 Chromium 浏览器对关键页真实渲染截图并检查空白与画面层次，未执行真实复核时不会标为已核验；
• 生成能力升级会重新执行准入矩阵并保存合同指纹，触发边界冲突或夹具缺失时拒绝安装；外部安装能力也必须包含可执行步骤和结果约定；
• 三维验证基础设施会用本机 Blender 真实打开 .blend 文件，检查对象、网格和场景边界；这不会被宣传成已经提供 CAD 或仿真能力。

本地运行

需要 Node.js 22.19 或更高版本。

cd sdk\typescript
npm install
npm run companion

默认地址是 http://localhost:8787。可用 PORT 修改端口，用 CLOWNFISH_HOME 修改数据目录。

Windows 便携客户端

cd sdk\typescript
powershell -NoProfile -ExecutionPolicy Bypass -File examples\companion\client\Build-Clownfish.ps1

构建脚本会下载并校验 WebView2、沙箱 Node 和 Python 运行时。输出目录：

examples\companion\client\dist\portable\小丑鱼

作为记忆 SDK 使用

import { Nemos } from "@nemos/sdk";

const nemos = new Nemos({
  storage: { type: "sqlite", path: "./memory.db" },
  llm,
});

const memory = nemos.forUser(authenticatedUserId);
await memory.ingest("用户说：正式文档先给结论");
const context = await memory.getRelevantContext("起草一份方案");

userId 应来自服务端可信身份，不能直接相信客户端传入值。

文档入口

文档	内容
小丑鱼使用说明	启动、数据目录、桌面构建和接口
TypeScript SDK	当前可用的记忆 API
记忆架构	已实现结构与边界
运行架构	任务、工具、权限与恢复
路线图	当前版本和后续重点
文档导航	使用、集成、架构与研究资料入口
参与贡献	提交流程与入站授权条款
安全策略	漏洞报告方式

许可

本仓库采用双授权结构，完整说明见 LICENSING.md：

• Nemos Memory SDK（sdk/typescript/src/、spec/、rfcs/、bench/、docs/）采用 PolyForm Noncommercial License 1.0.0。允许非商业使用、修改和分发；商业用途需要另行授权。
• 小丑鱼应用（sdk/typescript/examples/companion/）保留全部权利，不在上述许可证覆盖范围内，另行授权，见该目录下的 LICENSE。