---
title: "hitokoto：Claude Code 輸入框上方的一言"
url: "https://claudemods.dev/zh-tw/builds/hitokoto-cea84b"
source: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/hitokoto"
source_type: "github"
repo: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/hitokoto"
author: "hoobnn"
author_handle: "hoobnn"
stars: 8
category: "工具與整合"
categories: ["tools"]
tags: ["Claude Code", "mod"]
permission_level: 3
scan_complete: false
install: "claude plugin marketplace add hoobnn/hoobnn-agent-mods\nclaude plugin install hitokoto@hoobnn-agent-mods"
added: "2026-10-04T10:40:35.446Z"
updated: "2026-11-09T14:28:07Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# hitokoto：Claude Code 輸入框上方的一言

hitokoto：在輸入框上方顯示一句 Hitokoto（一言），可依定時、每個工作階段、每次傳送訊息或每天一句重新整理。

## Description

# hitokoto：Claude Code 輸入框上方的一言

**簡體中文** · [English](README.en.md)

在輸入框上方顯示一句[一言](https://hitokoto.cn)：詩詞、文學、動畫台詞或哲理短句，後面淡淡地附上作者和出處。等 Claude 幹活的時候，順便讀一句。

![hitokoto：輸入框上方的一句一言和出處](assets/preview.png)

## 功能

- **一句話加出處**：句子後面是作者和出處，點末尾的 `↻` 換一句（`daily` 模式下沒有這個按鈕）。
- **四種更換方式**：定時換（預設每 30 分鐘）、每天一句（所有工作階段同一句，過了零點換新的）、每個工作階段一句、每次傳訊息換一句。
- **依分類挑**：可以只要詩詞、文學、哲學等分類。
- **省流量、不空白**：橫條隱藏時不請求；同一時間只發一個請求，10 秒沒回應算失敗；上次取到的句子會儲存，新工作階段或離線時直接顯示它，不會空著。
- 在 `claude -p` 和 SDK 裡不請求。

## 安裝

```sh
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hitokoto@hoobnn-agent-mods
```

## 指令

- `/hitokoto`：立刻換一句（`daily` 模式下替換今天的這句）。
- `/hitokoto off`、`/hitokoto on`：隱藏或顯示橫條。這個設定會寫回 `/config`，以後的工作階段也會沿用；重新顯示時會先取一句新的。

## 選項

在 `/config` 裡修改，或寫在 `~/.claude/settings.json` 的 `pluginConfigs` 裡：

| 選項 | 作用 | 預設 |
| --- | --- | --- |
| `visible` | 顯示橫條（`/hitokoto off` / `on` 改的就是它） | 開 |
| `refreshMode` | `interval` 定時換、`daily` 每天一句、`session` 每個工作階段一句、`prompt` 每次傳訊息換一句 | `interval` |
| `categories` | 一言的分類字母，逗號分隔，留空不限。a 動畫、b 漫畫、c 遊戲、d 文學、e 原創、f 網路、g 其他、h 影視、i 詩詞、j 網易雲、k 哲學、l 抖機靈，例如 `d,i,k` | 空 |
| `intervalMinutes` | `interval` 模式下幾分鐘換一句（至少 1） | 30 |
| `language` | `/hitokoto` 回覆和報錯的語言：`auto`、`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru`（句子本身是中文） | `auto` |

`language` 為 `auto` 時，依次跟隨 Claude Code 的 `language` 設定和系統語言環境，都沒有的話用英語。

## 同系列 mod

[hoobnn-agent-mods](../../README.md) 裡還有狀態列 HUD（`hud`）、任務進度條（`todo-bar`）、回合回執（`receipt`）、執行動畫和寵物（`spinner`）和 Tailscale 節點狀態（`ts-band`），可以搭配使用。

## 開發

- `hooks/register.tsx`：鉤子（工作階段開始時的語言、`/hitokoto` 和對應模式的重新整理計畫，指令和橫條）。
- `hooks/config.ts`：選項，一次性讀成型別化的 `Config`。
- `hooks/parse.ts`：介面網址和回應內容的解析、出處和本機日期。
- `hooks/i18n.ts`：各語言文案。
- `hooks/kit/`：`claude-code/kit` 的副本；改原始檔後執行 `scripts/sync-kit.sh`。

## Install

```
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hitokoto@hoobnn-agent-mods
```

## Original README

# hitokoto：Claude Code 输入框上方的一言

**简体中文** · [English](README.en.md)

在输入框上方显示一句[一言](https://hitokoto.cn)：诗词、文学、动画台词或哲理短句，后面淡淡地附上作者和出处。等 Claude 干活的时候，顺便读一句。

![hitokoto：输入框上方的一句一言和出处](assets/preview.png)

## 功能

- **一句话加出处**：句子后面是作者和出处，点末尾的 `↻` 换一句（`daily` 模式下没有这个按钮）。
- **四种更换方式**：定时换（默认每 30 分钟）、每天一句（所有会话同一句，过了零点换新的）、每个会话一句、每次发消息换一句。
- **按分类挑**：可以只要诗词、文学、哲学等分类。
- **省流量、不空白**：横条隐藏时不请求；同一时间只发一个请求，10 秒没响应算失败；上次取到的句子会保存，新会话或离线时直接显示它，不会空着。
- 在 `claude -p` 和 SDK 里不请求。

## 安装

```sh
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hitokoto@hoobnn-agent-mods
```

## 命令

- `/hitokoto`：立刻换一句（`daily` 模式下替换今天的这句）。
- `/hitokoto off`、`/hitokoto on`：隐藏或显示横条。这个设置会写回 `/config`，以后的会话也会沿用；重新显示时会先取一句新的。

## 选项

在 `/config` 里修改，或写在 `~/.claude/settings.json` 的 `pluginConfigs` 里：

| 选项 | 作用 | 默认 |
| --- | --- | --- |
| `visible` | 显示横条（`/hitokoto off` / `on` 改的就是它） | 开 |
| `refreshMode` | `interval` 定时换、`daily` 每天一句、`session` 每个会话一句、`prompt` 每次发消息换一句 | `interval` |
| `categories` | 一言的分类字母，逗号分隔，留空不限。a 动画、b 漫画、c 游戏、d 文学、e 原创、f 网络、g 其他、h 影视、i 诗词、j 网易云、k 哲学、l 抖机灵，例如 `d,i,k` | 空 |
| `intervalMinutes` | `interval` 模式下几分钟换一句（至少 1） | 30 |
| `language` | `/hitokoto` 回复和报错的语言：`auto`、`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru`（句子本身是中文） | `auto` |

`language` 为 `auto` 时，依次跟随 Claude Code 的 `language` 设置和系统语言环境，都没有时用英语。

## 同系列 mod

[hoobnn-agent-mods](../../README.md) 里还有状态栏 HUD（`hud`）、任务进度条（`todo-bar`）、回合回执（`receipt`）、运行动画和宠物（`spinner`）和 Tailscale 节点状态（`ts-band`），可以搭配使用。

## 开发

- `hooks/register.tsx`：钩子（会话开始时的语言、`/hitokoto` 和对应模式的刷新计划，命令和横条）。
- `hooks/config.ts`：选项，一次性读成类型化的 `Config`。
- `hooks/parse.ts`：接口地址和返回内容的解析、出处和本地日期。
- `hooks/i18n.ts`：各语言文案。
- `hooks/kit/`：`claude-code/kit` 的副本；改源文件后运行 `scripts/sync-kit.sh`。
