# Kiokuko(記憶庫) DeepSeek Harness Plugin

[English](README.md) | [日本語](README.ja.md) | 简体中文 | [한국어](README.ko.md)

为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 添加项目记忆、任务规划和验证支持。
OrcaReplay 可记录模型和工具活动，查看记录并导出 HTML。


新的修改任务可以选择普通执行或役小角(enno-oduno)。役小角支持推荐模板，也可从DSH已配置的模型中为各角色选择模型。[模型选择与连接限制](docs/model-selection.md)。

自动记忆审查默认启用：每完成八个人类输入回合，使用会话模型保存或更新有用的项目记忆候选，无需关闭会话。使用 `/kioku-memory-review status` 查看状态，或用 `/kioku-memory-review exclude session` 排除整个会话。[设置、费用和恢复](docs/auto-memory-review.md)。

## 安装与使用

支持 **DSH 0.1.6-alpha.1**（[验证范围](docs/dsh-plugin.md#compatibility)）。

需要 Node.js **24.16.0 以上**和 pnpm。
在 DSH 源码目录中运行以下命令，安装已发布的 npm 包并启动：

```bash
pnpm dsh plugin --profile web add kiokuko-dsh
pnpm dsh web
```

如果使用全局安装的 `dsh` CLI，请省略各命令中的 `pnpm`。
启动后直接输入任务，无需额外的 Kiokuko setup 操作。
GitHub 和本地安装方式见[插件指南](docs/dsh-plugin.md)。

OrcaReplay 的功能配置会自动安装，**无需手动设置**。每次聊天都会在无需确认的情况下记录详细日志。
记录后，后续模型回复和工具执行结果将保存到会话工作目录的 `.orca/runs/`。决定按会话保存，因此执行过 `/kioku-orca stop` 的聊天保持不记录。若想在聊天开始时确认，请设置 `orca.askOnStart: true`。

- `/kioku-orca start`：手动开始记录，或在停止后重新开始。若该聊天未被停止，则无需执行。不会补录过去的活动。
- `/kioku-orca status`：简要显示记录状态、保存位置和下一步操作。诊断详情可用 `/kioku-orca status --json` 查看。

用 `/kioku-orca stop` 完成日志记录后，用 `list` 查看 run ID、`show <run ID>` 查看内容、`export <run ID>` 导出 HTML（均在 `/kioku-orca` 后输入）。
要禁用记录，请设置 `orca.enabled: false` 并重新加载。详见[记录设置与命令](docs/orca-recording.md)。

## 更新

先完成正在执行的任务并停止 DSH。更新通过 npm 安装的 Kiokuko：

```bash
pnpm dsh plugin --profile web update kiokuko-dsh --latest
pnpm dsh web
```

Kiokuko 更新频繁，而 pnpm 11 默认通过
[`minimumReleaseAge`](https://pnpm.io/settings/dependency-resolution#minimumreleaseage)
延迟选择发布不足24小时的版本。如果执行 `update --latest` 后仍停留在旧版本，请在
`~/.dsh/profiles/web/pnpm-workspace.yaml`（不是 `pnpm-lock.yaml`）的
`minimumReleaseAgeExclude` 中添加以下设置，然后重新执行更新命令：

```yaml
minimumReleaseAgeExclude:
  - kiokuko-dsh
```

启动时会将包括日语输出在内的全部9个内置 Skill 及其引用文件同步到 `~/.agents/skills/`，创建缺失文件并更新受管理的副本，不覆盖非受管理文件。其他代理需要重新加载 Skill 目录。

以上是完整包的默认行为。[核心与可选模块构建](docs/core-modules.md)仅打包所选资源；核心可独立处理对话、调研、写作和项目记忆，不包含 Enno/Lisp 运行时。

启动时也会更新启动目录中 `AGENTS.md` 的现有 Kiokuko 管理块，保留块外的指令。更新包后请重启 DSH。其他工作目录或旧副本的检查与修复请参阅[设置步骤](docs/dsh-plugin.md#what-setup-updates-and-when)。`kiokuko use` 不是 DSH 的设置命令。

Orca 发布 0.3.0 等新版本后，更新 Orca 相关依赖：

```bash
pnpm dsh plugin --profile web update --depth Infinity '@orcareplay/*'
pnpm dsh plugin --profile web why @orcareplay/core
pnpm dsh web
```

已安装的 Kiokuko 必须包含 `>=0.2.1` 依赖范围。该范围允许正式版 0.3.0 及后续版本，
但不会自动更新现有安装。更新后请检查记录和 HTML 导出。[更新详情](docs/dsh-plugin.md#update)

DSH 更新后若无法加载 Kiokuko，请参阅[启动恢复步骤](docs/dsh-plugin.md#startup-failure-after-a-dsh-update)，按对应 profile 更新或重新安装。请保留会话日志和 Kiokuko 数据库；重新安装不一定能解决 API 兼容性问题。

[文档](docs/README.md) · [权限](PERMISSIONS.md) · [MIT 许可证](LICENSE)