READMESource: main@652c7d3b
dsh-oneshotNiko-widget
给 DeepSeek Harness Web UI 用的像素桌宠：坐在界面左下角，头顶一个游戏风对话框，可以拖来拖去，点开还能和你聊天。
头像会随着它说话的语气变表情（14 类、30 张），聊天可以接任意 OpenAI 兼容接口，还支持人设卡和简单记忆。
素材来源于《OneShot》，请勿用于商业用途。
一、安装
环境要求：Harness 0.2.x（带插件管理 / 客户端插件支持）。
方式 A：插件管理器安装（推荐）
- 下载本项目（
git clone或 GitHub 页面右上角 Code → Download ZIP），解压到一个固定目录，例如D:\plugins\dsh-oneshotNiko-widget - 打开 Harness 的插件管理界面，选择「安装本地插件 / 从目录安装」，指向该目录
- 按
Ctrl + F5刷新 Harness 页面，左下角出现小宠物即安装成功
方式 B：命令行安装
dsh plugin add link:D:\plugins\dsh-oneshotNiko-widget
然后刷新页面。
方式 C：从插件市场安装
如果在插件市场（awesome-dsh-plugin / dsh-market）里能搜到本插件，直接点安装即可。
安装后注意
- 不需要额外放图片：30 张头像、对话框边框、字体都已经打包在
client.js里 - 如果左下角没有出现宠物：先
Ctrl + F5强刷；再确认插件在插件管理里是启用状态 - 想卸载：在插件管理里禁用/移除，再删掉插件文件夹即可
二、第一次使用：接入 AI
刚装好时它只说默认台词。要让它回你的话，先配置接口：
- 点头像右边的齿轮 ⚙ →「AI 助手」→「API 配置」
- 填写：
- Base URL：
https://api.deepseek.com - 模型：
deepseek-chat - API Key：去 DeepSeek 开放平台 注册，在「API Keys」里创建一个并粘贴
- Base URL：
- 保存后，点对话框打开输入框，输入内容按回车或点「发送」
API Key 只保存在你本机的
pet-ai.json里，不会上传，也不会在界面上显示。
三、功能
- 点头像：换下一句默认台词
- 双击头像：回到左下角
- 按住拖动：挪到任意位置
- 右键：复位
- 点对话框：打开/关闭聊天输入框
- 每轮对话结束后，对话框会先播报本轮用量（Token 或金额），几秒后回到默认台词轮换
四、设置说明
| 设置项 | 作用 |
|---|---|
| 字体大小 | 对话框里字的大小 |
| 图片缩放 | 头像大小（2 倍 = 192 像素） |
| 用量显示方式 | 每轮对话结束后，对话框会告诉你消耗了多少：选 Token 显示 token 数，选 金额 显示折算后的金额（计费最小单位 0.01 元，不足一分按 ¥0.01 显示） |
| 默认语句 | 不聊天时轮换的那几句台词，一行一句，可以直接改文件 |
| AI 助手 → API 配置 | 填 AI 接口地址、模型、密钥；还有输入/输出单价，只影响「金额」显示 |
| AI 助手 → 人设卡 | 给它设定性格和说话的规则；内置默认是一份「世界机器」人设（里面还写明了 14 类表情各自在什么时候用，所以它挑表情会很准），你也可以在 pet-persona.md 里追加自己的设定 |
| AI 助手 → 记忆库 | 它会自动把每轮聊天的要点记到这里，下次聊天时参考；上限 3000 字，超了自动删旧的 |
五、常见问题
Q：装好了但左下角什么都没有？
按 Ctrl + F5 强刷；再检查插件管理里是否启用。
Q：对话框没有琥珀色边框 / 颜色不对？
页面可能还是旧的，Ctrl + F5 强刷一次。
Q：聊天报错？
检查 Base URL（不要带 /chat/completions）、模型名、API Key、账户余额；报错会显示在对话框里。
Q：会自己一直说话吗？ 不会。默认台词只在 Harness 每跑完一轮对话后才换一句。
Q：我的 Key 安全吗？
插件不收集数据，Key 只存在本地 pet-ai.json；pet-ai.json、pet-memory.md、pet-persona.md 是私人文件，不要分享。
六、文件结构
| 文件 | 作用 |
|---|---|
index.js |
后台：文件读写、AI 接口调用、token 统计、轮次事件（仅本机访问） |
client.js |
界面：宠物、对话框、设置面板、聊天框；内嵌 30 头像 + 边框 + 字体 |
cordis.patch.yml |
Harness 插件挂载声明 |
package.json |
插件信息与入口 |
worldmachine.persona.json |
内置默认人设（含 14 类表情使用说明） |
pet-lines.txt |
默认台词，一行一句 |
assets/icon-192.png |
市场卡片图标 |
assets/wqy-pet-subset.woff |
字体源文件（同样已内嵌） |
docs/face-states.md |
30 张脸的状态对照 |
scripts/ |
字体子集生成、离线渲染自检 |
No comments yet. Be the first to write one.