Skip to content

feat(personas): 角色默认工作区——新对话开场即挂载 / persona default workspace - #49

Merged
sqfcyily merged 1 commit into
sqfcyily:merge/persona-default-workspacefrom
aloasut:feat/persona-default-workspace
Nov 17, 2026
Merged

sqfcyily merged 1 commit into
sqfcyily:merge/persona-default-workspacefrom
aloasut:feat/persona-default-workspace

Conversation

@aloasut

@aloasut aloasut commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

动机

角色(Persona)往往固定处理同一个项目目录的内容(代码助手对一个仓库、文档助手对一个资料库)。现状是每条新对话都要手动「挂载工作区」,不挂时模型一旦用相对路径读写或省略 path 扫描(list_dir/glob/grep),就命中「需要挂载工作区」卡片、回合挂起等用户处置——带附件的新对话里这几乎必然发生(模型按绝对路径之外的方式去看附件所在目录)。

给角色加一个默认工作区后,绑定该角色的新对话开场即挂载,挂载的全部好处自动生效:

  • 自动读项目说明:AGENTS.md 随系统提示词注入,角色开场即知项目约定;
  • 项目私有记忆生效:scope="project" 的经验随目录可读可写,角色越用越懂这个项目;
  • 相对路径有落点:read_file/write_file/grep 等不再触发挂载卡,回合不再中断;
  • 命令在项目根执行:run_command 的 cwd 落在项目里,git 等不再「not a git repository」。

设计要点(兼容优先)

  • 信任边界不放宽:默认工作区由主进程在 chat:create-session 从自己的 persona 记录解析并 trustRoot(目录是用户在编辑器经系统对话框挑选后落盘的),与 answerMount/chat:list-sessions 的落盘恢复同级信任来源;渲染层传值不采信。
  • 只是默认值:对话内挂/卸仍是会话级(chat:set-focus),不回写角色;未设置的角色(含种子/默认角色)行为零差异。
  • 目录失效静默降级:目录被删/搬移时按未挂载建档,不报错、不打扰;角色里保留原路径待用户更新。重启后受信根由既有 chat:list-sessions 恢复机制覆盖,无需新代码。
  • 旧文件零差异:workspace 是新增 frontmatter 可选字段,旧 .md(无此字段)解析为空串;种子改写走 spread 自动带回,幂等不破坏。
  • 名片创建的角色不带目录:propose_agent 铸的角色不设 workspace(目录只能由用户亲手挑)。

改动面(8 文件,+102/-1)

文件 改动
main/services/personas.ts PersonaRecord.workspace + frontmatter parse/serialize(fmScalar 引号化,路径含空格/中文安全)+ upsert 透传
main/services/chat.ts chat:create-session:缺省 focusRoot 且角色配置了有效目录 → 采用 + trustRoot;失效静默降级
preload/index.ts PersonaRecord.workspace / PersonaUpsertInput.workspace?
renderer ProfileView.tsx PersonaEditor「默认工作区」行(与现有表单同构:路径 + 选择…/清除 + hint)
renderer store/extensions.tsx record↔Persona 映射补字段
renderer mock/extensions.ts 渲染层 Persona 类型
renderer i18n/messages.ts zh/en 文案(语义明确「默认值,对话内可换可卸」)
redesign.css .cf-editor__wsrow 行样式(复用 cf-field/cf-btn 既有类)

验证

  • tsc 两套 tsconfig + electron-vite build 干净;
  • CDP 驱动真机冒烟(隔离 DEVA_HOME)10/10:有效目录角色新会话自动带 focusRoot、受信根生效(readDir 可读)、未受信目录仍被拒(边界未放宽)、失效目录/未配置角色静默不挂载(旧行为零差异)、round-trip 含空格路径、重启后 focusRoot 持久且受信根恢复;
  • 编辑器 UI 截图核对与现有表单风格一致。

@sqfcyily
sqfcyily changed the base branch from main to merge/persona-default-workspace November 17, 2026 07:58
@sqfcyily
sqfcyily merged commit 81a0459 into sqfcyily:merge/persona-default-workspace Nov 17, 2026
sqfcyily added a commit that referenced this pull request Nov 18, 2026
- 本版本参考了 #45 #46 #47 #49 #53 的设计 / this release draws on designs from #45 #46 #47 #49 #53

Co-authored-by: aloasut <1230048+aloasut@users.noreply.github.com>
Co-authored-by: miaocell <78256338+miaocell@users.noreply.github.com>
aloasut added a commit to aloasut/deva that referenced this pull request Nov 19, 2026
…rt (with knowledge base)

- 角色可打包为 zip:persona.md 磁盘原文 + 自定义头像 + 专属技能整目录 + 专属 MCP 配置(含解密密钥)+ 知识库目录(personas/knowledge/<id>/)+ manifest;Rail 角色右键导出(内置角色灰显拒绝)、花名册 + 菜单导入 / bundle a persona into a zip (raw persona.md, avatar, exclusive skill folders, exclusive MCP servers with decrypted secrets, knowledge directory) with export from the Rail context menu (builtins rejected) and import from the roster add-menu
- 导入 id 判定序:原 id 安全且空闲则沿用;已被占且 personas.imports 簿记在案(同源包)→ 就地更新;冲突/外来 id → makeId 铸新 id 绝不覆盖;内置 general/xiaomajiang 永不落位 / import keeps a safe free id, updates same-provenance bundles in place via the provenance ledger, mints fresh ids on conflicts, and never lands on builtin ids
- persona.md 经 writePersonaMdRaw 原样字节落盘,不做 frontmatter 重组——手改键与未来字段(sqfcyily#65 knowledge、sqfcyily#49 workspace)往返不丢失;删除角色级联清理头像、知识库目录与导入簿记 / persona.md is written verbatim via writePersonaMdRaw (no frontmatter recomposition, so hand-edited and future keys survive); persona deletion cascades avatar, knowledge dir and import bookkeeping
- 安全:zip-slip 逐段守卫 + 30MB/500 文件/10MB 单文件限额;目录收集 lstat 跳过符号链接(防环递归与越界拉取);MCP 密钥导出解密进包(开箱即用的明示取舍)、导入重加密回 secrets.json,加密不可用字段跳过并警告 / security: per-segment zip-slip guards with 30MB/500-file/10MB limits, lstat-based symlink skipping against loop recursion and out-of-tree pulls, MCP secrets decrypted into the bundle (explicit trade-off) and re-encrypted into secrets.json on import with warnings for undecryptable fields
- atomic-write 支持 Uint8Array 二进制原子写;preload personas 桥新增 exportBundle/importBundle;i18n 中英文案;随包 MCP 导入即启用并收窄为仅该角色,手机端经既有 WebPersona 推送自动可见 / binary-safe writeFileAtomic, exportBundle/importBundle on the preload personas bridge, bilingual i18n; bundled MCP servers import enabled and scoped to the persona, visible on phones via existing WebPersona pushes
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants