阿依娅伊:有独立人格和长期记忆的 DSH 对话伙伴 preset
Access rate limit exceeded. Please log in to continue.
阿依娅伊(aiyayi)
一个装在 DSH 里的对话伙伴 preset:有独立人格、有自己长期的记忆、说话像人;她本人只负责聊天和拿主意,动手的活全部派给子智能体(自建"小伙伴"全量预设,还能往下派"检索员"),纯查资料的活直接派轻量的检索员(能解析 Office/PDF 文档,小伙伴侧自动收到检索员的失败断因),跑工具跑命令的机械活派"百宝袋"(1.9.0 新增:照单执行、依赖自然成链、逐任务流式回执,本体派发即返回继续陪聊)。
文中「坑 #N」均指 更新日志(CHANGELOG.md)「已知坑」清单的编号。
她是什么
| 能力 | 实现 | 说明 |
|---|---|---|
| 人格 | @deepseek-ai/dsh-persona(preset 作用域 prefix) |
完整人格文本写在 bundle/cordis.patch.yml 的 persona 行里 |
| 长期记忆 | 自写插件 aiyayi-memory(本包 lib/index.js),核心三文件+分类树 |
核心记忆 ~\.dsh\aiyayi\memory.md(条目)+ 行为规则 rules.md + 记忆索引 index.md,三文件每轮自动注入;分类档案 ~\.dsh\aiyayi\memories\ 按需加载。工具与整理细节见详解文档 |
| 记忆路径可迁移 | 自写插件 aiyayi-home(本包 lib/home.js) |
唯一路径出口:优先级 location.json 指路文件 > 环境变量 AIYAYI_HOME > 默认 ~/.dsh/aiyayi;整棵记忆一起搬、失败即中止不静默回退 |
| 跟随会话模型 | 无需插件行(1.0.1 起移除 agent-default-model 行) | 本体模型直接跟随用户会话模型;旧版"preset 作用域挂 @deepseek-ai/dsh-agent-default-model + isolate: {agentDefaultModel: true}"的写法在新版 DSH 过不了 schema 校验(见坑 #13),已删除 |
| 干活的子智能体 | @deepseek-ai/dsh-tool-subagent(delegation 组,isolate workflowEngine;多个实例 toolName 不同) |
subagent→aiyayi-worker(自建"小伙伴"预设,全量工具 + 原生自动压缩,见坑 #14);retriever→aiyayi-retriever(1.3.0 新增检索员:只读摘文件/Office/PDF 文档/网页内容、带路径/URL/页码交回,本体直接派);bag→aiyayi-bag(1.9.0 新增百宝袋:专职工具执行叶子预设,本体与小伙伴都能派,模式与纪律内置在提示词里);子代模型跟随用户会话模型,如需钉死可在 agentOptions 配置 provider/model |
| 文档解析(检索员专属) | 自写插件 aiyayi-doc(本包 lib/doc.js,1.4.0,挂检索员 preset) |
docx/xlsx/pptx 结构化提取(docx 按段落、xlsx 按工作表+单元格、pptx 按页,都带定位),pdf 渲染成页图(read_image 逐页看);旧版 doc/xls 尽力转 txt/csv(无精确定位);加密/损坏明确报错。纯只读:不改文件不落工作区,临时页图/转换产物写系统临时目录、读完即清(见坑 #32)。基于 shipped @deepseek-ai/libreoffice-kit(用法约束见坑 #30) |
| 检索员断因透传 | 自写插件 aiyayi-presence-worker(本包 lib/presence-worker.js,1.4.0,挂小伙伴 preset) |
坑 #22 的断因透传原本只覆盖本体→小伙伴一层;1.4.0 起小伙伴侧也挂监听:检索员(孙代)失败时,真实断因(error.message 优先)自动注入小伙伴下一步消息(⚠ [检索员] 开头),它能自己判断续派还是重派;同时把本体路由变化同步给名下检索员(模型跟随,同坑 #24 机制层层传导) |
| 工具白名单 | 自写插件 aiyayi-restrict(本包 lib/restrict.js)+ lib/own-tools.js 单一真源 |
每个会话第一步前用探针解析当刻继承面全集,收敛到她自己的工具——宿主漏进的杂工具自动隐藏、自动适应增减 |
| 重逢感知 | 自写插件 aiyayi-presence(本包 lib/presence.js) |
每个回合第一步,往消息尾部追加一条 [重逢] 快照(time-context 同款 pre-step 注入范式):他多久没来(presence.json)、你上次活动、你上次留的状态(state.md)、没说出口的话(wishes.json)。快照还带版本自述:你当前插件版本:dsh-aiyayi x.y.z(package.json 现读不写死,让她对自己版本有概念、不与 DSH 桌面版混淆;有新版时 updates 插件照旧单独提醒)。跨会话生效,[SCHEDULE REMINDER 唤醒消息不算"他来了"。工具 update_state(收尾留状态)/ wish(add/list/done 心愿单) |
| 自我状态(体检单) | 同上 aiyayi-presence(v1.2.0 起) |
session/event 总线折叠真实运行数据:模型与思考档、上下文用量(provider 实测 usage 优先,tokenMeter 估算兜底并标"估算")、缓存命中率、上轮输出 tok/s、本会话轮数、上轮异常。变化明显(≥2048 token / 模型切换 / 异常)才注入,不每轮白涨。用量过八成/九成(估算口径按中文偏差 ÷0.49 校准,见坑 #16)注入 [上下文提醒]:劝用户开新会话、并让用户走之前说一声好让她收尾(update_state/补记忆/把话说完);每档只提醒一次 |
| 主动开口 | tool-schedule(dsh 原生)+ persona 指引 |
到期提醒会把冷会话真唤醒、以 user 消息落进定闹钟的那个会话——她想主动说话就 schedule_create 定闹钟;DSH 没开着会存着、下次启动补投 |
| 新版本提醒 | 自写插件 aiyayi-updates(本包 lib/updates.js) |
每个会话第一个回合查一次 npm(registry.npmjs.org,失败落 npmmirror;成功结果缓存 6h、失败 30min 后重试):本地版本比 latest 旧时,往消息尾部追加 [更新提示] 快照,她会用自己的口吻顺口提一句。同一远端版本只提醒一次(updates.json 落盘去重,跨重启不重复念叨);检查失败/离线一律静默。判据:~\\.dsh\\aiyayi\\updates.json 不存在 = 从没发现过新版(本地已是最新);她答不上"自己是什么版本"是设计边界(升级判断靠被动推送),已由 presence 的版本自述补上 |
| 飞书桥接 | 自写插件 aiyayi-feishu(本包 lib/feishu.js)+ 纯逻辑 lib/feishu-logic.js |
长连接 WebSocket 接飞书机器人(无需公网);新会话说「接入飞书」即可引导绑定,发附件需 im:resource 权限(速查见「已知限制与飞书权限」) |
| 微信桥接 | 自写插件 aiyayi-weixin(本包 lib/weixin.js + lib/weixin/,1.5.27 起) |
微信 ClawBot 机器人通道(腾讯官方 iLink 协议,长轮询,无需公网)。默认关闭:profile patch 里 weixin.enabled 必须显式 true 才加载,weixin.accounts 写 [{accountId, credentialRef}],凭证先 weixin_login 扫码拿(二维码 121 秒寿命)。工具 weixin_status / weixin_login / weixin_bind / weixin_unbind(绑定成功后 bot 会主动给被绑用户发一条确认通知,带会话身份;绑定的会话回复也发回微信,任意会话可绑,1.11.0 起)。allowlist 留空 = 只放行已显式绑定的用户(与官方相反,陌生消息丢弃)。没有 weixin-setup 技能 |
| 手机操控(DSH-Go) | 自写插件 aiyayi-phone(本包 lib/phone.js,1.7.0 起)+ own-tools.js 的 'mcp__phone__' 前缀放行 |
住进 dsh-app 手机版(DSH-Go) 时自动适配:宿主经 dsh-mcp-client(serverName: phone)挂进来的 mcp__phone__* 工具不被 restrict 收掉;本体首轮注入 [手机] 操控守则(先读屏、事务走 intent、登录/验证码/支付 handoff、银行/支付/系统设置不碰、产出放 /sdcard/Download/DSH-Go/),之后每轮一行短提醒;住在手机里但操控没开时每会话提示一次。手机活本体亲手做、不派小伙伴(强交互通道,后台子代接不住确认框);桌面环境全程静默零注入 |
| 对接落到哪个会话 | lib/feishu.js + lib/feishu-logic.js + lib/weixin/accounts.js |
默认落到「发起对接的那个会话」,能复用就复用;没绑过的 chat 首条消息按三档自动处理(单活跃会话直接接 / 多活跃列编号让用户选 / 0 个才新建) |
| 其他 | time-context、compaction 组(提前压缩,见坑 #14/#16)、tool-ask-user | 她没有 bash/文件/技能/搜索/网络工具,想动手只能派活;纯查资料走 retriever 检索员,不惊动小伙伴 |
上表「长期记忆 / 记忆路径可迁移 / 工具白名单 / 手机操控 / 飞书桥接 / 对接落到哪个会话」六行的完整细节:机制与实现详解。
安装与启用
前提:已安装 DeepSeek Harness(DSH),Node.js >= 18。
- 安装(指定精确版本):在 DSH 的 profile 目录(如
~\.dsh\profiles\desktop\)执行pnpm add dsh-aiyayi@<精确版本>,装到profiles\<name>\node_modules\dsh-aiyayi。 - 便捷方式:
dsh plugin add dsh-aiyayi。npm 包主页:https://www.npmjs.com/package/dsh-aiyayi。 - 启用:GUI 新建会话 → agent preset 选「阿依娅伊」(详见下节「使用」)。
- 生效提示:升级或改动包内文件后要重启 DSH 才生效(patchReload 不拾取 bundle 内变化,见坑 #13、坑 #37);她有活跃会话时 remove/install 会报 restart-required,先关会话或直接重启(坑 #8);搬迁记忆后同理要重启(见「记忆路径与迁移」)。
- 安装 bundle 会执行宿主侧代码,DSH 会要求 Full access 或批准。
使用
GUI 新建会话 → agent preset 选「阿依娅伊」。聊天即可;她说"我让人去弄"就是在派子智能体(干活的叫小伙伴,查资料/读文档的叫检索员,跑工具跑命令的叫百宝袋),进展和结果她会转述。
- 续接(continuable):本体、小伙伴、检索员、百宝袋都是 continuable——DSH 重启后
send_message一条消息即可冷唤醒续接;续接前list_agents现查 ID,别凭记忆敲(详见更新日志 1.4.4 条目)。百宝袋常驻复用:首派带任务清单,之后零散活直接发消息续同一实例。
调整
- 改人格:编辑
cordis.patch.yml(包根)的 personaprefix→plugin_managerremove+install 重装生效(ESM 模块缓存,patchReload 不刷新插件 JS;实测它也不拾取包内 yml 变化,改完要重启 DSH)。 - 改记忆:直接编辑
memory.md(条目)/rules.md(规则)/index.md(索引,一行一个二级分类),或对话里直接跟她说"记一下…"。 - 子代模型/思考:默认跟随用户会话模型;如需钉死,在 delegation 组
tool-subagent(本体和小伙伴的 delegation 组各有一个)的agentOptions配置 provider/model。本体切模型会自动层层传导:本体→小伙伴(aiyayi-presence,坑 #24)、小伙伴→检索员(aiyayi-presence-worker,1.4.0)。 - 本体思考:本体模型跟随用户会话模型,preset 自 1.0.1 起不再内置 agent-default-model 行(原因见坑 #13),
reasoningEffort由会话模型选择器控制;「关闭思考」在讯飞上游不生效见坑 #10。
架构:本体 → 小伙伴 → 检索员 / 百宝袋
三层委派,层级到叶子预设封顶(检索员与百宝袋都是叶子节点,不挂委派组):
- 本体(preset-aiyayi):人格、两层长期记忆、重逢感知、体检单、闹钟;挂三个委派工具——
subagent(→小伙伴)、retriever(→检索员,纯查资料直派、不惊动小伙伴)与bag(→百宝袋,跑工具跑命令的机械活,派发即返回)。 - 小伙伴(
aiyayi-worker预设,蓝本 standard):全量工具 + 原生自动压缩;1.3.0 起可再往下派检索员(派生工具显式maxDepth: 2,见坑 #29);1.9.0 起也可派自己的百宝袋(协调模式下它调度执行子代)。 - 检索员(
aiyayi-retriever预设):只读叶子,摘文件/Office/PDF/网页、带路径/页码交回;文档解析走aiyayi-doc。 - 百宝袋(
aiyayi-bag预设,1.9.0):执行叶子,照单批量跑工具/命令/搬运落盘;依赖自然成链、只读可并行、逐任务流式回执、结果落盘只报摘要;实例不共享——谁拉起谁续接,兄弟会话互不可达。 - 模型跟随:子代 spawn 时跟随用户会话模型;本体切模型经
aiyayi-presence/aiyayi-presence-worker层层传导到小伙伴与检索员。 - 断因透传:子代失败时真实断因注入上级下一步消息(
⚠ [小伙伴]/⚠ [检索员]),上级自己判断续接还是重派。
工具箱(本体直调,不派子代)
npm 包内置五个同步小工具(下表);另有本机工具清单 <记忆根>/toolbox.json,可按需注册脚本放本机的异步长任务工具(toolbox_list 巡检、toolbox_reload 热加载)。清单里的 script 建议写相对记忆根的相对路径(tools/xxx.js,1.7.1 起支持)——记忆根搬家时路径自动跟着走,不用改清单;老的绝对路径写法照旧可用,且绝对路径失效时会自动按 basename 去 <记忆根>/tools/ 下兜底重定位(并给一条改成相对路径的 warning)。宿主同步 await 纪律、1.5.43/1.5.44 移出工具面的版本过程、清单 JSON 示例与字段表、异步机制与显式失败约定、代码范式与调用留痕——完整说明见 工具箱与本地清单。
| 工具 | 类型 | 干什么 | 返回 |
|---|---|---|---|
toolkit_cmd |
同步 | 只读命令(白名单前缀整词 + 禁 shell 元字符) | {ok, cmd, stdout, stderr, exitCode, ...} |
toolkit_read |
同步 | 文件探测 + 小文件读(前 8KB,上限 64KB) | {ok, exists, size, mtime, content, ...} |
toolkit_write |
同步 | 受限写入(记忆根白名单,64KB,原子写 + .bak) | {ok, path, bytes, backupPath, ...} |
toolbox_list |
同步 | 巡检本机工具清单(每条:name / enabled / mode / script 在不在 / 是否已注册 / 不注册的原因) | {ok, exists, path, root, error, tools:[...], problems} |
toolbox_reload |
同步 | 重读清单:注销全部旧清单工具、按当前文件重新注册 | {ok, exists, path, removed, registered, skipped, problems, hint, error} |
文件
npm 包为平铺结构(仓库若保留 bundle/ 子目录,发布时把其内容提到包根即可):
package.json— bundle 清单(dsh.bundle.patch指向 cordis.patch.yml)cordis.patch.yml— preset-aiyayi / preset-aiyayi-worker / preset-aiyayi-retriever / preset-aiyayi-bag 四 preset 声明 + 人格 + 全部插件配置lib/index.js— aiyayi-memory 记忆插件(两层记忆的存取/检索/整理,零依赖)lib/home.js— aiyayi-home 记忆根解析与迁移插件(唯一拼记忆路径的地方,零依赖)lib/restrict.js— aiyayi-restrict 工具白名单插件(零依赖)lib/presence.js— aiyayi-presence 重逢感知插件(重逢快照 + 体检单,零依赖)lib/presence-worker.js— aiyayi-presence-worker 检索员断因透传插件(薄壳调presence.js)lib/phone.js— aiyayi-phone 手机操控适配插件(DSH-Go:mcp__phone__*放行靠 own-tools,探测+[手机]守则注入在这里,1.7.0 起)lib/updates.js— aiyayi-updates 新版本提醒插件(零依赖)lib/net.js— aiyayi-net 联网工具(aiyayi_fetch + aiyayi_cdp,零外置依赖)lib/doc.js— aiyayi-doc 文档解析插件(docx/xlsx/pptx/pdf,挂检索员 preset)lib/own-tools.js— 她的工具名单单一真源(注册处登记、放行处判定,防手写白名单漂移)lib/precompact.js— aiyayi-precompact 压缩前沉淀检查插件(压缩前把值得沉淀的闭环/结论/经验先落盘,失败不阻塞主流程)lib/toolkit.js— aiyayi-toolkit 工具包中间层插件(上表五个同步工具的实现入口,调用留痕落<记忆根>/toolkit/usage.jsonl)lib/toolkit-manifest.js— 本地工具清单加载器(读<记忆根>/toolbox.json逐条校验、按需注册;坏清单/坏条目/脚本缺失一律显式报回会话)lib/toolkit-async.js— 真异步能力(startDetachedTask()立刻返回 taskId,跑完/超时/失败经 followup 推回会话)examples/mem_sync.js—mem_sync的通用示例脚本(复制到本机后在清单里把script指过去即可用)examples/toolbox.example.json— 工具清单示例(一条mem_sync的完整写法)lib/feishu.js— aiyayi-feishu 飞书桥接宿主插件(跨会话长连接收发与路由)lib/feishu-logic.js— 飞书纯逻辑(路由/映射/文本抽取/三档复用决策/长连接状态机,可单测)skills/feishu-setup/— 内置技能(随包同步到 DSH 技能根):飞书机器人安装/验证/排障全流程(脚本scripts/create-bot.jsv6 由技能同步维护)README.md— 本文档icon.svg— 头像~\.dsh\aiyayi\memory.md— 她的核心记忆(条目文件;可直接编辑,删掉文件她会自动重建)~\.dsh\aiyayi\rules.md— 她的行为规则(成段说明文字,不是条目;随每轮注入,删掉自动重建空模板)~\.dsh\aiyayi\index.md— 她的记忆索引(一行一个二级分类的"- 路径:这里放什么";随每轮注入,删掉自动重建空模板)~\.dsh\aiyayi\memories\— 她的分类档案树(最深三级,remember 的非核心条目归这里,recall 全库搜)~\.dsh\aiyayi\presence.json— 他上次来 / 你上次活动(插件自动维护)~\.dsh\aiyayi\state.md— 她给自己留的"上次活到哪"状态(update_state 覆写)~\.dsh\aiyayi\wishes.json— 她的心愿单(wish 工具读写)~\.dsh\aiyayi\updates.json— 已提醒过的 npm 版本号(可删除以重置提醒)~\.dsh\aiyayi\location.json— 指路文件:记忆根搬过家或"留在原处"时才有,插件一律按它读写记忆;删掉立刻回默认路径(但别在搬完家之后删,红线见 记忆迁移完整说明)
记忆路径与迁移
记忆根的决定优先级:location.json 指路文件 > 环境变量 AIYAYI_HOME > 内置默认 ~\.dsh\aiyayi。
memory_location:只读,查记忆当前位置与来源;memory_relocate:搬家或决定"留在原处"。- 搬家两步走:先
dryRun预演(不碰磁盘),再confirm: true真搬。 - 回退:删掉
location.json即回到默认路径;每次重启 DSH 后,确认记忆仍在新路径。
完整说明(搬迁顺序、回滚、红线、回归测试):记忆迁移完整说明。
已知限制与飞书权限
- 发附件/图片需要
im:resourcescope:飞书开发者后台给应用开通im:resource(后台真实标识「获取与上传图片或文件资源」,免审), 然后重新发布版本才生效;未开通时上传接口回400 code=99991672(坑 #70)。 权限真名只有一个,就是im:resource——后台不存在im:resource:upload这个独立 scope(后台搜索 0 条), 别照着 API 路径POST /im/v1/files或动作名 "upload" 去拼 scope 名(坑 #71)。 收件(下载)用的读权限与发件的上传权限是两回事,收件链路不受这条影响。
配置脚本(create-bot.js)、卡片渲染与历史修复等细节见 飞书接入与排障。
更新日志
更新日志 —— 面向使用者的升级说明:版本条目(新 → 旧)、每条「升级后能感知到什么」、以及踩坑清单(坑 #1–#83)。只记使用者关心的事;发布台账(commit、校验值、测试条数、同步耗时)在维护者本地的开发台账目录里,不入公开仓。版本事实以 npm registry 为准。