CM 朋友版:Windows 入门与手机访问说明 说明核对日期:2026-11-15 【先看这段】 这是可供朋友查看源码的 Windows x64 便携版,包含程序、配套运行环境和使用说明。 本次沿用已核验的程序版本,仅补充外层说明,没有修改程序代码。 交付包不包含发布者的私人资料库、账户设置、手机访问密钥或云端更新配置。 每位使用者需要新建自己的资料库,并自行配置希望使用的连接。 手机手工配置步骤已对照这份包的实际代码与 Tailscale 官方资料核对。 它不表示手机连接已经替你开通;朋友的新电脑和手机仍需按本文完成实际验证。 一键手机配置和云端历史版本选择尚未提供;这份包也未预设云端自动更新。 第一次使用建议每完成一小节就停下来确认,先让电脑正常运行,再配置手机。 压缩包解压后: 开始使用.txt —— 最短的启动步骤。 详细中文说明.txt —— 本文件,包含电脑、手机、常见问题与备份。 交付核对说明.txt —— 程序内容未改动的核对结果。 CM 文件夹 —— 完整程序。所有程序命令都在这个文件夹中执行。 一、CM、资料库和手机分别是什么 1. CM 是运行在你自己 Windows 电脑上的程序。 2. 资料库是你自己选择的一个文件夹,里面有 memory.sqlite3 和其他资料。 程序和资料分开放,换程序版本时更容易保留自己的内容。 3. 手机模式是:手机浏览器通过私人网络,访问这台电脑上的同一份资料库。 手机没有另建一份云端数据库;这不是云同步,也不是把资料自动传给开发者。 4. 电脑需要开机、联网、保持唤醒,CM 服务和 Tailscale 都要运行。 手机开流量或连其他 Wi-Fi 均可尝试;不要求与电脑连接同一个路由器。 5. 本文的手机访问指 Safari、Chrome 等浏览器。 它不等于 ChatGPT 手机应用接入了 MCP,也不会自动同步你的 ChatGPT 聊天。 AI 读取或保存 CM 资料需要另外配置支持的连接方式,并由你授权。 6. 每位朋友使用自己的资料目录、自己的 Tailscale 账户和自己的访问密钥。 同一个人可以在自己的电脑和手机登录自己的同一账户;不要把账户交给别人共用。 二、在 Windows 上第一次打开 准备:一台 Windows x64 电脑,以及完整下载的朋友版 ZIP。 建议先把 ZIP 留作原始安装副本。有随包校验值时,可以核对下载是否完整。 步骤 1:解压到一个新文件夹。 右键 ZIP,选择“全部解压”,选择一个新的程序文件夹。 不要在 ZIP 预览窗口里直接双击运行,也不要覆盖旧版本或别人的文件夹。 如果解压出现报错或文件被安全软件拦截,先停止并核对来源和提示;不要关闭安全软件绕过。 步骤 2:进入解压后的 CM 子文件夹。 这个 CM 文件夹就是本文所说的“程序目录”或“主文件夹”。里面应能看到 Start CM.cmd、cm.py、app 文件夹和 runtime 文件夹。 runtime 里包含配套 Python 运行环境,正常情况下不用另外安装 Python。 不要单独移动其中一个启动文件;请保留整个程序目录结构。 步骤 3:双击 CM 文件夹里的 Start CM.cmd。 打开的窗口标题为“CM 私人记忆库”。 首次使用,选择“新建空白资料库”。 步骤 4:选择自己的空白资料文件夹。 这个文件夹必须在程序目录之外,而且必须不存在或完全空白。 不要选择下载的程序文件夹,不要选择已经放有其他文档的目录。 也不要把别人的资料目录当作自己的空白库。 确认窗口中显示的路径正确,再确认新建。 请记住这个资料文件夹的完整路径。以后“打开已有资料库”和手机模式都要指向它。 若看到“所选目录缺少 memory.sqlite3”,通常是选错层级或选了尚未初始化的文件夹。 不要为了消除提示而在原资料位置反复新建空白库。 步骤 5:检查电脑网页。 浏览器会自动打开本机网页。刚建好的资料库应该没有你的历史记忆。 可以先浏览记忆列表、检索与导出等功能。 AI 连接需要单独配置,不会因为程序启动而自动读取其他软件的聊天。 保存内容时只填写自己有权保存的真实原文,来源和总结分别填写。 这一步确认:程序能打开、资料目录选对了、你知道资料保存在哪里。 现在先不配置手机,也不用购买任何服务。 三、平常在电脑上怎样使用 以后双击 Start CM.cmd,选择“打开已有资料库”,选回同一个资料文件夹。 不要每次都点“新建空白资料库”。 桌面模式会自动选择本机可用端口,所以浏览器地址中的数字可能每次不同。 用窗口里的“打开记忆库”进入即可,不要把上次的数字当成固定手机端口。 关闭浏览器标签页不等于停止 CM;关闭 CM 的启动窗口才会停止这次桌面服务。 如果只想在电脑上使用,做到这里即可。下面是可选的手机手工配置。 四、手机连接前,先安装自己的私人网络 Tailscale 是连接你自己设备的私人网络工具。它不会自动替你运行 CM。 本说明只使用私人 Serve,不启用公开的 Funnel。 步骤 1:电脑安装 Tailscale。 从官方页面下载安装程序: https://tailscale.com/docs/install/windows 安装后在任务栏右下角找到 Tailscale 图标;必要时点向上的小箭头。 右键图标,选择 Log in,由你本人在浏览器里登录并完成系统授权。 步骤 2:手机安装 Tailscale。 Android:从 Google Play 安装官方 Tailscale。 https://tailscale.com/docs/install/android iPhone / iPad:从 App Store 安装官方 Tailscale。 https://tailscale.com/docs/install/ios 首次启动时,系统会询问是否允许添加 VPN 配置。由你本人确认。 当前官方客户端要求 Android 8 或更新版本、iOS 16 或更新版本。 步骤 3:手机登录你本人同一个 Tailscale 身份,并连接同一个 tailnet。 tailnet 可以理解为“你的私人设备网络”。 确认设备列表中能看到自己的 Windows 电脑和手机,状态正常。 不要借用开发者的登录账户,不要让朋友共用你的登录验证码或密钥。 步骤 4:核对免费用途。 截至本稿核对日,当前新 Personal 方案适合非商业个人用途,最多 6 位用户,用户设备不限数量。 你自己的电脑和手机是一个用户的两台设备,不是两位用户。 旧账户可能仍保留旧套餐,以本人控制台显示为准。 自有域名邮箱注册可能先进入试用;如实际为个人用途,先核对适合自己的方案。 不要因为出现“试用”就直接填写付款方式或购买套餐;收费选择由你自己明确决定。 官方说明: https://tailscale.com/pricing 步骤 5:确认 MagicDNS 与 HTTPS。 MagicDNS 给设备一个容易使用的完整名字,例如“电脑名.网络名.ts.net”。 Serve 的 HTTPS 访问需要 MagicDNS 和 HTTPS 证书功能。 若已经启用,就保留现有设置;若未启用,后面的 Serve 命令会给出配置链接。 由你本人登录 Tailscale 控制台,阅读提示后决定是否启用。 特别注意:申请 HTTPS 证书会把设备完整的 ts.net 名称写入公开证书透明度日志。 这个公开记录是证书名称,不是你的 CM 内容;访问权限仍受私人网络限制。 因此设备名称不要放姓名、地址、密码等敏感信息。 没有理解或没有同意这个提示时,停在这里,不替别人确认。 本流程由 Serve 自动管理证书,不需要你手动复制证书,也不需要跳过浏览器证书警告。 https://tailscale.com/docs/how-to/set-up-https-certificates 五、现有包的手机手工配置 本节稍长;按顺序做,一次只做一段。不需要手机访问时可以跳过整节。 下列命令只应该在你自己的电脑、你自己的 CM 程序目录执行。 不需要把实际路径、登录名或访问密钥发给别人,也不要截图公开。 步骤 1:关闭桌面模式。 先关闭“CM 私人记忆库”启动窗口,结束前面的随机端口桌面服务。 如果另有程序正在使用同一份资料库,先确认它的状态;不要同时打开多个不明实例。 步骤 2:在 CM 主文件夹打开 PowerShell。 用文件资源管理器进入能看到 cm.py、runtime、Start CM.cmd 的那个文件夹。 点击文件资源管理器地址栏,输入 powershell,再按回车。 这会在当前文件夹打开一个命令窗口。 本文是 PowerShell 命令,不是在 Python 窗口里逐行输入,也不是粘贴到浏览器地址栏。 步骤 3:填写自己的资料目录。 复制下面这一行,回车;按提示粘贴第二节选定的资料文件夹完整路径,不加外层引号: $cmDataDir = Read-Host '粘贴自己的资料文件夹完整路径(不加引号)' 这里选择的是含有 memory.sqlite3 的资料文件夹,不是程序文件夹。 后面的检查若失败就停下核对,不要换成别人的路径。 步骤 4:读取自己真实的 Tailscale 名称与登录身份。 先确认电脑的 Tailscale 已登录、已连接,再把下面整段复制到 PowerShell: $cmTailscale = Join-Path $env:ProgramFiles 'Tailscale\tailscale.exe' $cmHostName = ''; $cmOwnerLogin = '' if (-not (Test-Path -LiteralPath $cmTailscale)) { throw '未找到 Tailscale,请先确认安装位置。' } $cmTsStatusText = & $cmTailscale status --json if ($LASTEXITCODE -ne 0) { throw '无法读取 Tailscale 状态,请先检查安装和登录。' } $cmTsStatus = $cmTsStatusText | ConvertFrom-Json if ($cmTsStatus.BackendState -ne 'Running') { throw 'Tailscale 尚未连接,请先登录连接。' } $cmTsUserId = [string]$cmTsStatus.Self.UserID $cmHostName = ([string]$cmTsStatus.Self.DNSName).TrimEnd('.').ToLowerInvariant() $cmOwnerLogin = [string]$cmTsStatus.User.PSObject.Properties[$cmTsUserId].Value.LoginName if (-not $cmHostName -or -not $cmOwnerLogin) { throw '没有取得有效的设备名称或本人身份。' } 'hostname = ' + $cmHostName 'allowed_login = ' + $cmOwnerLogin 屏幕会显示两项: hostname:这台电脑完整的 ts.net 名称,不含 https://、端口、路径或最后的点。 allowed_login:Tailscale 实际记录的本人登录名。 不要根据头像显示名、猜测的邮箱或别人的配置填写 allowed_login。 电脑和手机必须是你本人的同一 Tailscale 身份,实际登录名要匹配。 如果任何一项为空,或出现报错,先停止并检查安装、登录状态;安装后可以重开 PowerShell。 以上使用官方默认安装位置。若你自己改了安装位置,需把 $cmTailscale 改成实际的 tailscale.exe 路径。 重开窗口后要重新执行步骤 3 和步骤 4,前一个窗口的变量不会自动保留。 步骤 5:创建仅属于自己的 phone.json。 资料目录中若已经有 phone.json,不要覆盖、删除或随便重生成。 它可能是之前的有效配置;先保留,核对原来的设备名称和本人身份,再决定是否需要更新。 下面命令使用“只新建”方式,有同名文件就报错停止。 把下面整段复制到刚才的 PowerShell。它会使用步骤 3、4 的值,在你的资料目录中新建 phone.json, 并用 secrets.token_urlsafe(32) 随机生成本人的访问密钥。 文件使用 UTF-8、无 BOM;不需要在记事本里猜编码或手工输入 JSON 标点。 $cmPhoneSetup = @' import json, re, secrets, sys from pathlib import Path data = Path(sys.argv[1]) host, owner = sys.argv[2], sys.argv[3] if not data.is_absolute() or not (data / 'memory.sqlite3').is_file(): raise SystemExit('资料目录不正确:请选择已创建资料库的绝对路径。未写入配置。') if not re.fullmatch(r'[a-z0-9-]+\.[a-z0-9.-]+\.ts\.net', host): raise SystemExit('设备名称不正确:应为完整的小写 ts.net 名称。未写入配置。') if not owner or len(owner) > 320: raise SystemExit('没有取得有效的本人 Tailscale 登录名。未写入配置。') secret = secrets.token_urlsafe(32) config = dict(hostname=host, allowed_login=owner, secret=secret) with (data / 'phone.json').open('x', encoding='utf-8', newline='\n') as output: json.dump(config, output, ensure_ascii=False, indent=2) output.write('\n') print('已在自己的资料目录中新建 phone.json。启动 CM 后,请在电脑本机的 /phone 页面查看访问密钥。') '@ & '.\runtime\python.exe' -I -B -c $cmPhoneSetup $cmDataDir $cmHostName $cmOwnerLogin 正常结果:显示“已在自己的资料目录中新建 phone.json”。 密钥不会打印到命令窗口;启动 CM 后,在下一步的本机 /phone 页面本人查看。 如需另行保存,请使用自己的密码管理器等私人位置,不要截图公开或发到群里。 若出现 FileExistsError,表示已有 phone.json,命令没有覆盖它,先停下检查。 若出现其他错误,也先停下;不要把报错后仍继续执行当作配置完成。 供理解:phone.json 有 hostname、allowed_login、secret 三项。 它不是公共配置,不能复制给所有朋友共用,也不应放进公开源码或发行 ZIP。 步骤 6:在固定端口启动 CM 网页模式。 在同一个 PowerShell 中执行: & '.\runtime\python.exe' -I -B '.\cm.py' web --data-dir $cmDataDir --port 8765 这个窗口现在运行 CM 服务;保持打开。 若提示端口已占用,先确认是不是另一份 CM,不要直接结束不认识的程序。 在电脑浏览器打开 http://127.0.0.1:8765/ ,确认能看到自己的资料库。 再打开 http://127.0.0.1:8765/phone ,可在本机查看手机地址和访问密钥。 此页面含密钥,只给本人查看。 步骤 7:另开一个 PowerShell,检查已有 Serve。 保持上一个 CM 服务窗口打开,再另开一个 PowerShell。 先执行只读查看(新窗口需重新设置程序位置): $cmTailscale = Join-Path $env:ProgramFiles 'Tailscale\tailscale.exe' & $cmTailscale serve status 如果已有任何 Serve 或 Funnel 配置,先停下来核对,尤其注意同一 443 端口上的其他路径。 如发现现有 Funnel,不按本说明更改或关闭它,先找维护者确认用途。 只有原配置完全就是本说明的 CM 根路径、没有其他应用共用时,才可以直接沿用。 有其他映射或不确定用途时,不运行下面的新增或关闭命令,先找维护者核对;不要直接 reset。 没有冲突时执行: & $cmTailscale serve --bg --https=443 http://127.0.0.1:8765 这表示:仅在私人网络中,用默认 HTTPS 443 根路径访问 CM,再转到本机 8765。 不要加路径前缀,不要改成公开监听地址,不要改用 Funnel。 如出现 HTTPS 启用链接,回到第四节步骤 5,由本人阅读并确认后再继续。 不要加 --yes 跳过确认。 完成后再次执行 & $cmTailscale serve status。 应能看到你自己完整的 https://……ts.net 地址,代理目标为 http://127.0.0.1:8765。 以命令实际显示的网址为准,不要猜网址。 单有这段输出还不等于手机已经连通,下一节还要实际验证。 六、在手机上登录并验证 1. 手机打开 Tailscale,确认已连接到本人网络。 2. 用 Safari 或 Chrome 打开上一节显示的完整 https://……ts.net 地址。 地址不加 :8765,不填 localhost,不填 127.0.0.1,也不使用电脑的短名称代替完整名称。 3. 应出现“连接私人记忆库”的登录页面。输入自己的随机访问密钥。 这里不是 Tailscale 账户密码,也不是 ChatGPT 密码。 4. 登录后,查看一条你自己已保存的内容,并与电脑显示核对。 这是在访问同一台电脑上的同一份库,不需要额外导入一次。 5. 可暂时让手机使用移动数据,再打开同一网址,确认不是只在家中 Wi-Fi 下可用。 只有手机实际打开并正确显示自己的库,才算本次手机访问验证成功。 若页面显示 403,不要关闭身份检查或伪造 Tailscale 请求头来绕过。 程序会核对访问域名、来自本机代理的连接、Tailscale 本人身份和 CM 访问密钥。 网址的 Host 必须与 phone.json 的 hostname 完全匹配;本人身份头必须匹配 allowed_login。 因此,请使用完整 HTTPS 地址和本说明的根路径代理方式,不借用别人账户或复制别人的配置。 手机浏览器可按自己的习惯保存书签或添加到主屏幕。 它仍是网页入口,不会因此变成独立的离线手机数据库。 七、每天开启、停止与常见问题 【每天想在手机上用】 电脑开机后先连接 Tailscale,再在程序文件夹打开 PowerShell。 重新设置 $cmDataDir,然后用第五节步骤 6 的命令启动固定端口网页模式。 如果之前用 --bg 配置过 Serve,它会在 Tailscale 恢复后继续保留;仍要确认 CM 本身已经启动。 Serve 不会自动启动 CM,电脑睡眠或关机时也无法提供服务。 本稿没有替你添加自动启动任务或修改电脑电源设置。 【暂时停止 CM】 在运行 CM 的 PowerShell 窗口按 Ctrl+C;不再需要时可关闭这个窗口。 不必卸载 Tailscale,也不要删除自己的资料目录。 【停止本次默认 HTTPS 私人代理】 先查看 Serve 状态。只有确认 443 端口上的全部映射都属于本次 CM、没有其他应用或子路径共用时,才运行: & (Join-Path $env:ProgramFiles 'Tailscale\tailscale.exe') serve --https=443 off 该命令会停止整个 443 端口的 Serve 配置,不只是根路径,但不会删除资料库。 只要 443 上还有任何其他应用或子路径,或者看不懂当前配置,就不要执行;暂时只停止 CM 服务窗口即可。 【清空 Serve 的全部配置】 tailscale serve reset 会清空本机所有 Serve 配置,可能影响别的应用。 它不是普通排错的第一步;本说明不要求运行。 【电脑能用,手机打不开】 依次检查:电脑没有睡眠;CM 服务窗口还在;两端 Tailscale 已连接;手机使用的是完整 HTTPS 地址。 再执行 & (Join-Path $env:ProgramFiles 'Tailscale\tailscale.exe') serve status,检查目标是否是 127.0.0.1:8765。 不要通过关闭防火墙、开放公网端口、启用 Funnel 或跳过证书警告解决。 【显示“Host not allowed”】 核对完整 ts.net 名称,phone.json 不能带 https://、路径、端口或结尾的点。 设备改名后,旧名称可能不再匹配;先保留原配置,重新核对再处理。 【显示“This archive is private to its owner”】 核对手机和电脑是否登录本人同一个 Tailscale 身份,allowed_login 是否取自真实 LoginName。 昵称或邮箱别名不一定等于实际登录名。不要借用别人账户尝试。 【访问密钥不正确或需要重新登录】 密钥区分字符,注意复制时不要多带空格。 可回到电脑本机的 /phone 页面本人查看;不要把 phone.json 发给别人代查。 连续输错过多时会短暂限流,等候后再核对,不要不停重复尝试。 会话到期后重新登录即可,不表示资料丢失。 【资料看起来突然空了】 先看选中的资料路径,确认是否误开了另一个空白资料库。 不要立刻删除原目录、新建替代或覆盖备份。 【手机能登录,但 ChatGPT 手机应用不能读取】 本流程只建立网页访问,没有配置 ChatGPT MCP。 不要把手机网址或访问密钥当成已经完成 AI 接入。 八、资料备份与换电脑 1. 资料库不是自动云备份。电脑坏了或误删资料,手机网址不能把它找回来。 2. 重要操作和换版本前,先停止所有正在使用这份资料库的 CM 服务及相关 AI 连接。 确认没有继续读写后,把整个资料目录复制到自己保管的备份位置,不要只复制一个数据库文件。 如果引用的原件放在资料目录之外,也要单独保存这些原件,并记录位置。 如果还启用了单独的协作区,也要在停止相关连接后同时备份完整协作目录;只备份主资料库并不包含它。 3. 保留对应版本的完整程序 ZIP。资料备份与程序副本用途不同,二者都要知道在哪里。 4. 可再从“导出记忆”保存一份可读归档作为补充,但不要把一次 JSON 导出等同于所有附件、配置的完整备份。 5. 同一块硬盘上的另一个文件夹,不能防止整块硬盘故障;重要备份可放在本人另一个设备或离线存储中。 备份可能含真实对话、附件和 phone.json 访问密钥,不能发到群里或上传公开仓库。 6. 恢复时先放到一个新目录验证,不要直接覆盖唯一一份现有资料。 换电脑后的私人网络身份和设备名称可能变化,需要重新核对并授权手机连接。 九、更新、源码和转发范围 程序升级与资料同步是两件事。下载新程序不等于把资料上传到了云端。 这份交付包没有配置远程更新地址,因此不会自动从云端获取更新,默认也不会出现“软件更新”按钮。 不要复制别人的更新地址、公钥或私人网络配置来启用它。 本包没有“一键手机配置”和“选择云端历史版本”功能;后续是否提供,以正式交付说明为准。 以后收到新程序时,先核对来源和版本说明。将新包解压到新的程序目录,保留旧程序和完整资料备份。 新版本能否使用旧资料、旧版本能否读取较新的资料,都要按当次升级说明核验。 不能把“旧版本 ZIP 还能下载”当作“可以直接覆盖当前程序并回退”;也不要拿旧备份覆盖最近新增的资料。 这份朋友版包含可以查看的程序源码,不是闭源商业发行版。 可以按提供者与你约定的范围试用、查看源码;这不代表已经授予公开再分发或商业销售许可。 如要转给其他人,先与提供者确认范围。不要将自己用过的程序目录和资料目录重新打包公开。 安装 Tailscale、登录本人账户、启用私人 HTTPS 及系统 VPN 授权,均由使用者自己决定并完成。 十、官方参考资料 Windows 安装: https://tailscale.com/docs/install/windows Android 安装: https://tailscale.com/docs/install/android iPhone / iPad 安装: https://tailscale.com/docs/install/ios 设备连接与访问前提: https://tailscale.com/docs/how-to/connect-to-devices MagicDNS: https://tailscale.com/docs/features/magicdns HTTPS 证书与公开名称提示: https://tailscale.com/docs/how-to/set-up-https-certificates Serve 命令、后台运行、状态和关闭: https://tailscale.com/docs/reference/tailscale-cli/serve 私人 HTTPS 网页原理: https://tailscale.com/docs/use-cases/application-testing/share-local-dev-server-with-team 默认 HTTPS 代理的关闭示例: https://tailscale.com/docs/solutions/host-private-server-docker Personal 当前范围及用途: https://tailscale.com/pricing 说明核对依据:已交付源码包的 Start CM.cmd、cm.py、app/cm_launch.py、app/cosmo-memory-mini/memory.py。 验证边界:包内文件已做完整性核对;手机步骤已对照代码及官方资料,尚未在朋友的新设备上完成全流程实测。 实际操作卡在哪一步,就保留当前状态并检查该步;不要把中间提示当作全部配置成功。