Iambatman1928/dsh-xingye

星野 · DSH 聊天 Agent

test

星野把 DeepSeek Harness 的一个会话整体改造成聊天 agent：装上之后新开一个会话、agent preset 选「星野」，
你面对的就是星野本人。在她的会话里，你可以新建别的智能体（人物）、给他们写人设、为同一个人物开多条档案线分别聊天，
也可以给自己准备多套人设随时切换。所有内容都存在这台电脑上，不经过任何服务器。

我的角色 · 创作角色 · 我的人设 · 对话 · 档案

安装

dsh plugin --profile web add 'github:Iambatman1928/dsh-xingye'

装完 重启 DSH，然后：

1. 打开 设置 → 插件，确认 dsh-xingye 在列表里；
2. 新开一个会话，agent preset 选 星野 —— 这一步不能省，preset 决定这个会话的身份和工具；
3. 直接说话就行。星野会以出厂人设迎接你。

会话头部右上角有一个人物胶囊（头像 + 名字 + 当前档案）—— 点它打开「我的角色」整页。
那里能建角色、切人物、管档案、换你自己的人设。

为什么装插件的命令就够，却还要选 preset？
DSH 的 agent preset 只能靠文件系统发现，没有任何插件注册接口 —— 所以这个包在首次加载时会
把随包的 preset 复制到 /.agent-presets/xingye/（$DSH_HOME 默认 ~/.dsh）。
这一步只在目标缺失时发生，不会覆盖你已经改过的 preset，日志里会写明它做了什么。
不想让它自动写的话，把这个插件行的配置改成 installPreset: false，然后手工复制
node_modules/dsh-xingye/preset/ 到 ~/.dsh/.agent-presets/xingye/。

从源码安装：

每个 Release 都附一个预构建 tarball，
用它装可以免掉 pnpm 的构建授权步骤：

dsh plugin --profile web add 'https://github.com/Iambatman1928/dsh-xingye/releases/latest/download/dsh-xingye.tgz'

界面

按四张设计稿做的，色值、圆角、间距、阴影都是照抄的（暖白 #fffbf7、品牌紫 #8b5cf6、
卡片 16px 圆角、头像 56px、导航 64px）。五个页面：

| 页面 | 从哪进 | 能做什么 |
|---|---|---|
| 我的角色 | 点会话头部的人物胶囊 | 一行一个角色卡：头像 / 名字 / 标签 / 最近一句；点卡片＝切过去开聊；点右侧「N 档案」进档案页；右上「＋」去创作 |
| 创作角色 | 我的角色 → 右上「＋」 | 上传头像、名称、简介、性格设定、开场白、性格标签；保存后星野真的把人物建出来并按开场白开口 |
| 我的人设 | 底部导航「人设」 | 当前人设卡 + 可选列表（带勾选角标）；新建人设；「不用人设」 |
| 对话 | 关掉整页即是 | 头像 + 白色左侧气泡（星野）／紫色右侧气泡（你）；输入条右侧的「＋」是剧情工具（重说 / 回溯 / 重启 / 前情提要 / 撤销） |
| 档案 | 角色卡上的「N 档案」 | 一个人物的多条会话线：切过去接着聊、新建一条、删除人物（两次确认） |

怎么退出整页：再点一次当前 Tab、按 Esc、点和平板／桌面上的遮罩、或用头部的「⌄」按钮。

多端适配：手机（/xingye-data/（$DSH_HOME 默认 ~/.dsh）：

xingye-data/
index.json                     全局默认：上次用的人物 / 档案 / 用户人设
config.json                    保留策略（可手工改）
sessions.json                  会话 id → 人物 / 档案 / 用户人设 的绑定
ui-state.json                  界面读的快照（由插件写，别手改）
characters//
character.json
persona.md                   人设正文
source/                      导入文件的原始副本
avatar.* portrait.* background.*   角色形象（放文件即成）
archives//
archive.json
messages.jsonl             对话原文，回溯与撤销的数据源
summary.md                 定期清理后旧对话的梗概
trash.jsonl                被撤销的内容（可恢复）
eventbook.jsonl            事件簿
branches/.json       被剪掉的剧情
user-personas//
persona.json
persona.md

想备份就整个复制 xingye-data；想清空就从空目录重来。

数据根目录改法：这个包的 cordis.patch.yml 与 agent preset 的行配置各有一个 dataRoot，
留空时两边都落到 /xingye-data。要挪目录就得两处都写，否则界面读的是另一份数据。

出图服务（可选）

在 agent preset 行里配一个 OpenAI 兼容端点：

- id: xingye
name: './plugin/index.js'
config:
image:
baseURL: 'https://your-endpoint/v1'
apiKeyEnv: 'YOUR_API_KEY_ENV'
model: 'your-image-model'
size: '1024x1024'

model 留空就只存提示词不出图。key 从环境变量读，不落盘。

已知限制（重要，别被「撤销」两个字骗了）

DSH 的会话记录是 只追加、不可改写 的：没有删除、截断或回退历史事件的接口，
磁盘上的 session.jsonl.zstd 也没有删除路径。

所以「撤销最近 30 条」的准确语义是：

- 本地档案的记录被真正回滚 —— 这是星野自己的数据，删了就是删了（且可恢复）。
- 模型收到一份明确的作废声明 —— 撤销工具的结果会留在对话里，告诉星野那几条作废、不要引用、等用户重新说。
- 但 DSH 会话日志里那几条原始事件仍然存在（只是从这一轮起被宣告无效）。

其余限制：

- agent preset 必须选对。在别的 preset 的会话里，界面能看，但动作发不进去（星野的工具不在那个会话里）。
- 界面是全帧浮层，会盖在每一个会话上。未绑定到星野会话时，面板照常可看，但按钮不发指令，
并在顶部写明原因 —— 这是刻意的，免得把「用某某人设」这类指令塞进不相干的会话。
- 改了 client.js 要重新加载页面，改了 Host 半（index.js）要重启 DSH。

结构

dsh-xingye/
├─ index.js             Host 半：/xingye/api 路由 + 落 preset
├─ client.js            Client 半：四个整页 + 人物胶囊 + 剧情菜单
├─ cordis.patch.yml     bundle patch（把插件注册进 profile）
├─ preset/              随包发行的 agent preset xingye
│   ├─ agent.cordis.yml 会话组合：身份 + 工具清单
│   ├─ preset.yml       显示名与简介
│   └─ plugin/          17 个 xingye_* 工具（零依赖，只用 node: 内建模块）
└─ tools/               三套离线测试

两半的分工：preset 那半是后端（人物 / 档案 / 撤销 / 事件簿，全在 agent 平面上），
profile 插件那半是前端（界面 + 一个把界面动作送进会话的本地路由）。界面不重复实现业务逻辑，
只有一份真相 —— 这是为什么 preset/plugin/ 里的代码只允许 import node: 内建模块：
预设目录不在部署包的 node_modules 解析链上。

开发

node tools/verify.mjs                  # preset 插件全流程（假 ctx，不需要 DSH）
node tools/preset-install-test.mjs     # 随包 preset 的落盘行为（临时 DSH_HOME，不碰你的 ~/.dsh）
node tools/ui-client-render-test.mjs   # Client 半离线渲染（真 React + 迷你运行时跑 effect）
node tools/ui-host-route-test.mjs      # Host 半路由（假 req/res）

界面测试默认从本仓库根读 client.js，从 ~/.dsh/profiles/*/node_modules 之类的地方找 React。
要指到别处就传参数：node tools/ui-client-render-test.mjs  。

许可

MIT。与 DeepSeek 官方无隶属关系。