dsh-aiyayi:基于 DSH 生态的 AI 对话伴侣预设项目

阿依娅伊:有独立人格和长期记忆的 DSH 对话伙伴 preset

Branch1Tags20

阿依娅伊(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(包根)的 persona prefix → plugin_manager remove+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.js v6 由技能同步维护)
  • 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:resource scope:飞书开发者后台给应用开通 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 为准。

署名与许可

  • 作者与维护:巴依浩爷(bayihy)
  • 实现:阿依娅伊(aiyayi,DSH 智能体)
  • 仓库:GitCode · Gitee · GitHub
  • 许可:MIT(LICENSE)

Introduction

阿依娅伊:有独立人格和长期记忆的 DSH 对话伙伴 preset

Customize your domain