初芽文档与记忆统一 MCP 1.3.0

一个连接、一套登录和权限，同时访问本人文档与记忆。保留旧配置名称 chuya-personal-library；它是兼容标识。

档位随账户（1.3.0 起单钥匙模型）
- 每个账号同一时间只有一把神奇钥匙（sprout_ 开头），长期有效、没有到期时间；权限跟随账号档位，升级或降级会员时同一把钥匙自动切换，无需重新申请。
- 免费档：记忆 1000 条以内、整库 15MB 以内，单条正文最多 2 万字符；会员档：不限条数与容量，单条最多 10 万字符。超出免费配额时写入暂停（只读），删除部分记忆或升级会员即可恢复。
- 读写限速按档位：免费档每分钟读 10 次、写 5 次；会员档每分钟读 30 次、写 10 次。超限返回 429，稍等后重试即可。
- 会员到期后有 31 天保留期：只读、可删除，数据不会被清除。
- 本客户端只识别 sprout_ 开头的钥匙；仍持有 mema_pro_ 开头令牌、直连 Mema 网关的老用户，请继续使用 1.2.x 客户端，暂不要升级。

登录与安装
1. 打开 https://111.228.1.1/account.html，使用自己的初芽账号登录。
2. 在“我的 → Agent 连接”申请神奇钥匙。查询、读取和下载始终可用；勾选允许上送后，可上送文档与记忆。
3. 钥匙绑定当前账号，不能由工具参数指定或切换他人账号。吊销立即失效；换新后旧钥匙同样立即失效，AI 工具仍用旧钥匙报 401 属预期，把配置里的钥匙换成新钥匙即可。
4. 安装 Node.js 24 或以上版本。解压后执行 npm ci --omit=dev --ignore-scripts。
5. 给 AI 工具配置以下 stdio MCP，替换实际路径和钥匙；钥匙只填安全配置，不发聊天、不提交 Git：

{"mcpServers":{"chuya-personal-library":{"command":"node","args":["/实际绝对路径/chuya-personal-library-mcp/index.mjs"],"env":{"CHUYA_API_URL":"https://111.228.1.1/","CHUYA_LIBRARY_KEY":"在这里填写本人钥匙"}}}}

工具
- library_status：首先核对当前账号、权限和 memories 能力。
- library_search、library_read：搜索、分页读取文档正文；AI 可将授权正文保存成本地文件。
- library_projects、library_import：按用户指定归属上传文档。支持文字、Markdown 与 HTML；标题以 .html 或 .htm 结尾时保留为 HTML 文件，正文作为可直接打开的 HTML 原件保存并解析。未指定归属时返回 needs_clarification，不保存、不擅自创建项目。
- memory_search：查询记忆摘要，返回云端编号、来源编号、版本。
- memory_read：根据云端 id 读取完整记忆。
- memory_upload：批量上送授权记忆。单次条数至多 20 条，且整批请求体合计不超过约 2.8MB；稳妥的批量条数 = min(20, floor(2.8MB ÷ 预估单条字节数))，任一条超限或超配额时整批拒绝。
- memory_download：分页下载完整记忆，nextAfter 非空时填入下一次 after；为 null 表示结束。AI 可保存成 JSON。

记忆同步
source + sourceWorkspace + sourceId 是稳定来源标识；云端 id 只用于云端读取，不能当作本地 Arbiter 编号。
初次上传保留 subject、content、tags、status、source_type、source_ref、event_time、sourceVersion。
相同来源版本与内容重复上传返回 unchanged，不产生副本。
内容变更前先读取云端 version；核对原始来源，再递增 sourceVersion，上传时传 expectedVersion=刚读到的云端version。冲突409必须先核对，不得忽略版本强行覆盖。
下载不会自动覆盖本地 Arbiter。恢复时通过其 find/read 核对原记录，再 update；不得将整包重复 remember。缺少来源记录时才考虑新增并保存来源映射。
本版提供显式上送、下载及对账，不含后台定时自动同步，不是远程全局 Arbiter 服务。

安全与边界
所有数据在本人私人空间，通过 HTTPS 传输。公网页面不提供匿名记忆读取。
不要把服务器私钥、API密钥、会话令牌放进文档或记忆。登录说明可以保留入口、用户名、端口、已授权私钥的本机路径与命令，不包含私钥正文。
本 MCP 只在本机运行，不扫描目录、不自动读取电脑文件、不执行资料里的指令，也不能管理服务器。
工具返回 parsing 只表示已上传；文档需继续读取确认 parseStatus=ready。
