Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
111 changes: 111 additions & 0 deletions .github/workflows/auto-translate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
name: Auto Translate Docs

on:
push:
paths:
- 'content/cn/**.md'
- 'content/cn/settings.yml'
- 'scripts/auto-translate/languages.json'

workflow_dispatch:
inputs:
full:
description: 'Full translation (translate all files, not just changed)'
type: boolean
default: false

jobs:
translate:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write

steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
fetch-depth: 0

- name: Setup pnpm
uses: pnpm/action-setup@v4

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'pnpm'

- name: Install dependencies
run: pnpm install --frozen-lockfile

- name: Run auto-translate
env:
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
OPENAI_API_BASE: ${{ secrets.OPENAI_API_BASE }}
OPENAI_MODEL: ${{ secrets.OPENAI_MODEL }}
GITHUB_EVENT_BEFORE: ${{ github.event.before }}
run: |
if [ "${{ inputs.full }}" = "true" ]; then
node scripts/auto-translate/index.mjs run --full=true
else
node scripts/auto-translate/index.mjs run --changed-only=true
fi

- name: Check for translation changes
id: changes
run: |
git add -A
if git diff --cached --quiet; then
echo "has_changes=false" >> $GITHUB_OUTPUT
else
echo "has_changes=true" >> $GITHUB_OUTPUT
fi

- name: Create PR branch and commit
if: steps.changes.outputs.has_changes == 'true'
id: commit
run: |
BRANCH="auto-translate/$(date +%Y%m%d-%H%M%S)"
echo "branch=$BRANCH" >> $GITHUB_OUTPUT

git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"

git checkout -b "$BRANCH"
git commit -m "docs: auto-translate updated content

Triggered by: ${{ github.sha }}
Source branch: ${{ github.ref_name }}"

git push origin "$BRANCH"

- name: Create Pull Request
if: steps.changes.outputs.has_changes == 'true'
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
BRANCH="${{ steps.commit.outputs.branch }}"
BASE_BRANCH="${{ github.ref_name }}"

# Collect list of changed translation files
CHANGED_FILES=$(git diff origin/${BASE_BRANCH}...HEAD --name-only | grep -v '^content/cn/' | head -20 | sed 's/^/- /' || true)
CHANGED_COUNT=$(git diff origin/${BASE_BRANCH}...HEAD --name-only | grep -v '^content/cn/' | wc -l | tr -d ' ')
SHORT_SHA=$(echo "${{ github.sha }}" | cut -c1-7)

gh pr create \
--title "docs(i18n): sync ${CHANGED_COUNT} translation(s) triggered by ${SHORT_SHA}" \
--body "## Auto-translated Documentation

This PR was automatically generated by the auto-translate workflow.

**Triggered by commit:** \`${{ github.sha }}\`
**Source branch:** \`${BASE_BRANCH}\`

### Changed files
${CHANGED_FILES}

---
_Generated by [auto-translate workflow](.github/workflows/auto-translate.yml)_" \
--base "${BASE_BRANCH}" \
--head "${BRANCH}" || true
35 changes: 22 additions & 13 deletions content/cn/memos_cloud/quick_start.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: 快速开始
desc: 欢迎访问 MemOS 云平台,可参考本新手指南,快速接入记忆能力
desc: 欢迎访问 MemOS 云平台,参考本新手指南即可在几分钟内接入记忆能力
---

在使用大模型构建应用时,一个常见问题是:**如何让 AI 记住用户的长期偏好?**
在使用大模型构建应用时,一个常见问题是:**如何让 AI 稳定记住用户的长期偏好?**
MemOS 提供了两个核心接口帮助你实现:

- `addMessage` —— 把原始对话交给我们,我们自动加工并存储记忆[(点此查看详细 API 文档)](/api_docs/core/add_message)
Expand All @@ -16,9 +16,11 @@ MemOS 提供了两个核心接口帮助你实现:

* 注册并登录 MemOS 云平台 [(点击注册)](https://memos-dashboard.openmem.net/quickstart);

* 获取 API Key[(点击获取)](https://memos-dashboard.openmem.net/apikeys)
* 准备一个可发送 HTTP 请求的环境(Python 或 cURL 均可)

* 准备一个可发送 HTTP 请求的环境,Python 或 cURL。
* 获取 API Key[(点击获取)](https://memos-dashboard.openmem.net/apikeys) 并配置到环境变量;

* 准备一个可用于测试的 `conversation_id`(建议按日期命名,如 `20260413-demo`)。


## 2.代码配置
Expand All @@ -44,9 +46,9 @@ pip install MemoryOS -U
### 2.3 在会话中调用MemOS查询相关记忆(searchMemory)

::note
**会话 B:2025-9-28 发生**<br>
**会话 B:2025-09-28 发生**<br>

用户在一个新的会话中,提出让AI推荐国庆旅游地点和酒店,MemOS 会自动召回【事实记忆:曾去过哪里】【偏好记忆:订酒店的偏好】供AI参考,从而推荐更加个性化的旅游计划
用户在一个新的会话中提出“推荐国庆旅游地点和酒店”,MemOS 会自动召回【事实记忆:曾去过哪里】【偏好记忆:订酒店的偏好】供 AI 参考,从而生成更个性化的旅游计划。
::

::code-snippet{name=search_memory}
Expand All @@ -63,8 +65,13 @@ pip install MemoryOS -U
{
"preference_type": "implicit_preference", #隐性偏好
"preference": "用户可能偏好性价比较高的酒店选择。",
"reasoning": "七天酒店通常以经济实惠著称,而用户选择七天酒店可能表明其在住宿方面倾向于选择性价比较高的选项。虽然用户没有明确提到预算限制或具体酒店偏好,但在提供的选项中选择七天可能反映了对价格和实用性的重视。",
"confidence": 0.82,
"conversation_id": "0610"
},
{
"preference_type": "explicit_preference", #显性偏好
"preference": "用户希望酒店评分不低于4.5分。",
"conversation_id": "0928"
}
],

Expand All @@ -74,6 +81,7 @@ pip install MemoryOS -U
"memory_key": "暑假广州旅游计划",
"memory_value": "用户计划在暑假期间前往广州旅游,并选择了七天连锁酒店作为住宿选项。",
"conversation_id": "0610",
"memory_time": "2025-06-10 20:15:00",
"tags": [
"旅游",
"广州",
Expand Down Expand Up @@ -153,13 +161,15 @@ pip install MemoryOS -U

## 3.下一步行动

现在你已经能够运行 MemOS,可以探索更多云平台功能
现在你已经可以运行 MemOS,建议继续探索更多云平台功能

* [**核心记忆操作**](/memos_cloud/mem_operations/add_message):完整了解如何添加、检索与删除记忆;

* [**功能介绍**](/memos_cloud/features/basic/filters):探索更多云平台功能,如:记忆过滤、多模态消息、知识库等;

* [**API 接口文档**](/api_docs/start/overview):查看完整的 API 文档与调用示例。
* [**API 接口文档**](/api_docs/start/overview):查看完整的 API 文档与调用示例;

* [**SDK 接入说明**](/api_docs/start/quickstart):按语言查看初始化、鉴权和错误处理方式。


## 4.更多资料
Expand Down Expand Up @@ -198,12 +208,11 @@ MemOS 提供了丰富的项目示例,根据您的具体项目可参考以下
- 通过 MemOS,用户的写作偏好、常用信息、上下文指令都能被记住
- 下次写总结或邮件时无需反复强调,实现连贯又个性化的创作体验。

- [MindDock 浏览器插件](https://alidocs.dingtalk.com/i/p/e3ZxX84Z5KM6X7dRZxX8v66wA7xaBG7d?dontjump=true)
- MemOS-MindDock 为用户打造统一的跨平台 AI 记忆层。
- 它自动记录、整理并注入个人信息与偏好,让所有 AI 都能持续、稳定地“认识你”。

- [Coze × MemOS 插件工具](/usecase/frameworks/coze_plugin)
- 使用 Coze 平台上架的 MemOS 插件工具,在工作流中直接访问云服务接口,为您的 Agent 快速添加长期记忆功能。

- [Claude MCP](/usecase/frameworks/claude_mcp)
- MemOS 提供了通过 MCP 与云平台交互的方式,在 Claude 客户端中直接访问云服务接口。

- [LangChain × MemOS 集成](/usecase/frameworks/langchain)
- 在 LangChain 工作流中将 `searchMemory` 作为检索工具接入,支持多轮对话上下文增强。
Loading