# 安装与首次接入

此包是 DeepSeek Harness 社区插件，支持精确版本 0.2.1-rc.2 / rc.3 / rc.4 / rc.5 / 0.2.2-rc.1；rc1 使用官方要求的 Node 24.9+，旧宿主仍可用 Node 22.13+，未上架 Harness 官方插件市场。长期分享同一个 npm 包名即可，新版本发布时更新 `latest`：

```text
@oxmumu3/dsh-family-assistant@latest
```

[npm 固定包页面](https://www.npmjs.com/package/@oxmumu3/dsh-family-assistant)提供当前版本；[正式仓库 Releases](https://github.com/oxmumu3/dsh-family-assistant/releases)保留带具体版本号的历史 tgz、安装说明和校验值。指定版本的 tgz 不会随新版发布改变。

## 当前可用：创造模式里一句安装

1. 点击左上角“新建会话”，在新会话页面点“标准模式”下拉，选择“创造模式”。无需开启开发者工具，也不需要进插件页找安装包。
2. 发送下面这句：

> 请从 npm 官方源安装并启用 @oxmumu3/dsh-family-assistant@latest。

Harness 会使用原生插件管理器安装并启用。如请求批准，按提示处理；完成后可从侧栏“家庭助手”进入。新安装默认暂停、成员为空，不自动扫码、发送消息或开启定时服务；每位家人仍需本人扫码。

安装句长期不变。新版发布到 npm 后更新 `latest`；已经装过旧版时，重复发送安装句不等于自动升级，见后面的升级步骤。

## 普通对话自动接续的状态

主交互目标仍是用户只在任意普通对话发一句，由 Harness 自动接续安装。当前官方 rc.3 的标准会话没有独立创建新会话的模型工具；实际调用子任务并指定 `agent_preset: cordis` 会被拒绝：`agent_preset selection is disabled for this tool instance`。这是新会话入口的工具限制，不能只用“当前会话预设锁定”解释，也不能把界面/SDK能创建会话当成模型已经能调用。

Host 层的受限安装样机已在隔离环境通过：真实标准会话保留默认权限和原生审批，合成模型只申请安装；非法动作和拒绝审批没有安装副作用，批准后实际从 npm 安装启用 preview.31，61 个源码文件与发行包一致，工作台路由可用。该补丁尚未由官方 Host 集成，未修改用户正式 App/profile/微信绑定，也未证明自动前端导航或真实模型理解成功率。当前可用安装不等待此增强完成。

<details>
<summary>另一种手工安装方式（备用）</summary>

在侧栏“插件 → 添加插件”的“包名或地址”中粘贴 `@oxmumu3/dsh-family-assistant@latest`，安装成功后“立即启用”，从“家庭助手”进入。此方式与当前对话预设无关，是手工备用方式，不代替普通对话自动安装目标。

</details>

## Web 端

```sh
dsh plugin --profile web add '@oxmumu3/dsh-family-assistant@latest'
dsh web
```

CLI 须与目标宿主版本一致。当前机器全局 `dsh` 可能是更旧版本，先 `dsh --version` 核对；不要让旧 CLI 修改桌面端的 profile。

若需指定独立存储，在该 profile 自己的 `cordis.patch.yml` 追加：

```yaml
- id: family-assistant
  config:
    storageDir: /absolute/private/family-assistant-data
```

一个数据目录只供一个运行中的 Host 使用。凭据以 0600 单独保存在每位成员的通道目录中；不应上传这个目录或把它作为插件资料分享。

## 首次验收顺序

先登记 Owner，在主对话描述长辈并保存 AI 整理的资料卡，再由本人分别扫码。配置 Harness 已授权模型后启用服务。

1. 三人分别发送不同内容，核对各自只收到自己的回复和记录。
2. 为一位长辈设置短时间的一次性提醒，核对后台接口回执，再由本人确认手机实际收信。
3. Owner 默认可直接查看乐乐与各家人保存的完整记录。另行选择自动简报包含哪些内容，预览并发送一次简报，核对只发 Owner。
4. 为需要日报的成员分别开启日报，设置时区和时间；Owner 单独开启服务简报。
5. 某一路断开时核对另外两路仍可使用；需要重新绑定时只操作那一位成员。
6. 从 Owner 微信或网页向已绑定的指定长辈发送“给妈妈发今天的日报”或“明早八点提醒爸爸给花浇水”；先核对生成的安排，再确认执行，检查目标、当地时间、后台执行记录和实际手机接收。没有对应成员、重名、时间不明确或绑定改变时，必须不产生跨成员操作。长辈微信不能给别人安排任务。

需要手机确认的是扫码、验证码以及实际收信／排版。任何 Agent 都不应通过截图、AX、鼠标键盘等自动化操作微信客户端来替本人验证。


## 从旧版升级

固定入口更新不会自动更新电脑上已经安装的插件。官方 rc.3 中，重复安装相同 npm 包名会提示已安装；隔离测试中，移除后再次安装 `@latest` 也曾仍得到旧版。因此升级时先在 [npm 页面](https://www.npmjs.com/package/@oxmumu3/dsh-family-assistant)核对当前版本，再使用精确版本，例如本轮已验证的 `@oxmumu3/dsh-family-assistant@0.2.0-preview.35`。

旧 tgz 的包名 `dsh-family-assistant` 与新 npm 包名 `@oxmumu3/dsh-family-assistant` 是两个安装身份，不能直接叠加启用。按下面顺序操作，始终沿用原 `storageDir`：

1. 等待当前扫码和发送结束，在家庭助手暂停服务，备份原数据目录；若使用自定义 `storageDir`，记下并继续使用它。
2. 在 Harness 插件管理移除旧的家庭助手插件包，保留数据目录。确认旧插件已停止；若宿主提示需要重启，先完全退出并重开 Harness，再继续安装。
3. 安装 npm 当前版本的精确包名，例如 `@oxmumu3/dsh-family-assistant@0.2.0-preview.35`，并启用。隔离验收使用 npm 官方源 `https://registry.npmjs.org/`；可在创造模式明确要求原生插件管理器使用这个源安装精确版本。
4. 完全退出并重新打开 Harness，确认只保留一个家庭助手插件，原成员与绑定还在，再恢复服务。

本轮在官方 rc.3 隔离环境验证了 scoped preview.21 升级和旧 tgz preview.30 迁移到 scoped preview.31；合成成员、绑定和聊天记录保持，未使用真实微信凭据或发送消息。真实微信登录是否仍有效还取决于微信平台；过期时需成员本人重新扫码。不要删除 `family.json`、成员通道目录或私有数据来更新插件。

管理对话、资料卡、经本人允许转达的请求与私有服务偏好保存在同一数据目录的 `workbench.json`；状态文件保持 0600。

preview.7 另外增加 `presentations.json` 与 `presentation-files/`，保存已开通成员的 PPT 任务和成果；不改变微信凭据路径。Owner 本地项目会话保存在 Harness，刷新只核对原请求。preview.15 为通用 Owner 对话登记独立的 `storageDir + "-owner-workspace"` 目录，沿用 `harness-tasks.json` 保存稳定会话和每轮请求；旧记录兼容，不迁移微信凭据。微信平台主动过期登录、手动重绑或删除数据仍可能需要重新扫码。

切勿在运行中手改 profile 或删除运行锁。升级不自动开启日报或简报。

## 语音输入

点击对话框下方“说话”；首次若显示“下载并准备”，点一次即可让家庭助手启用宿主自带的官方语音组件并准备本地模型。下载完成后再次点“说话”，按系统提示允许 Harness 使用麦克风。说完点“停止并转文字”，检查或修改草稿后点击发送。

用户无需另去插件页查找或安装语音包；家庭助手调用官方插件管理能力自动完成接入。语音模型没有塞入家庭助手 tgz，首次仍需联网下载并预留约 1 GB 磁盘/内存。宿主未自带组件时只使用官方插件目录提供的安装目标；宿主不支持则明确提示更新，不使用非官方下载源。此项已验证目标版本为 0.2.1-rc.2。

识别使用官方本地 SenseVoiceSmall INT8 服务，不切换宿主已有语音偏好，不把音频交给家庭对话模型或微信。音频只在内存处理；文字回填后与普通未发送草稿一样可编辑。识别期间继续打字会保留两份内容，需手动选择插入；切换家人或事项不会串入原来的录音。主窗口负责麦克风权限，工作台 iframe 只接收状态与文本。独立 npm start 预览不含宿主语音服务。

## 家人的默认能力与额外授权

连接微信后，家人可直接提出写稿、分析本人材料、改写已收到的日报、制作本人PPT和查询公开信息等需求，默认在该绑定独立的个人工作区处理。工具库用于预设快捷服务和定时投送；Owner本地项目另行选择共享范围，家人的普通请求不会继承Owner终端、全局记忆或其他家人的资料。明确禁止转告的内容不会作为Owner求助发送。

长任务可在原微信会话询问“进度”或要求“停止刚才的任务”。家人明确说“以后日报都这样写”时，偏好只作用于本人的后续服务稿，不改写Owner源项目。

## 重要事项主动提醒

全新安装默认关闭。在设置开启“重要事项主动提醒”，或在已绑定的 Owner 微信说“开启重要事项主动提醒”。从启用后新收到的家人文字开始判断，不补发旧记录。普通明确保密请求不自动转告；明确的本人当前即时人身危险有严格证据例外。

Owner 微信收到提醒后，可在同一话题直接说“我来处理”“已解决”“不再提醒这件事”或“告诉她：具体回复”。控制台“需要你留意”也可处理。关闭开关只停止自动判断，不影响正常对话和明确转告；原自动简报分享设置保持独立。提醒只是辅助，不保证识别所有重要情况。