日语语音拍卖助手 · 管理员手册

给店长、运营和技术负责人：怎么给主播开账号、交付密码、重置和停用账号、查看上岗训练进度，以及服务器上的账号命令。助手页：https://ears.tailae39ca.ts.net/voice-auction/ 。主播怎么用助手请看用户手册。

适用版本：网站 2026-10-21 · 最后核对：2026-10-21 · 点击图片可放大

1. 账号体系是怎么设计的原理说明

助手有两种登录方式，可以同时用：

登录方式	适合谁	能得到什么
访问码（共用）	临时帮忙的人、还没开账号的人	能用全部直播功能，但没有个人记录：训练成绩只存在那台电脑的浏览器里，管理员看不到。
主播账号（每人一个）	每一位正式上岗的主播	左上角显示名字；上岗训练成绩存在服务器上，换电脑也在；管理员能看到谁已认证。

两种角色

能做的事	主播	管理员
直播操作、商品管理、训练等全部功能	✓	✓
修改自己的密码（我的账号）	✓	✓
新建账号、重置别人的密码、停用 / 启用账号	—	✓
查看所有主播的上岗训练进度	—	✓

管理后台不是单独的网站，就在助手里：管理员登录后，连接与诊断 → 主播账号管理。主播登录后同一个位置显示的是 我的账号。点左上角自己的名字也能直接打开。

管理员登录后的「主播账号管理」：上面是自己的账号，下面是统计、新建表单和账号列表

⚠ 注意：账号和密码只在服务器上，密码只存加密后的哈希，谁都看不到原密码，包括管理员和技术负责人。所以忘了密码只能重置，不能“查”。

2. 第一次启用：从第一个管理员到第一位主播教程

读完你可以：建好第一个管理员，登录后改成自己的密码，再给一位主播开账号并让 TA 登录成功。约 10 分钟。

A. 在服务器上建第一个管理员（只做一次）

第一个管理员只能在服务器上建，网页上没有“注册”入口，这是为了不让外人自己开管理员。由技术负责人在服务器的 tk-voice-controller 目录里执行：

.venv/bin/python accounts.py add-admin <账号名>

按提示输入两次密码（屏幕上不显示，正常）。→ 应该看到：显示「已保存，立即生效（不用重启网关）。」

💡 提示：账号名用 3–32 位小写字母、数字、点、横线或下划线，以字母或数字开头，例如 tenchou、ops.sato。密码至少 10 位、至少 5 种不同字符。

B. 用管理员账号登录

打开助手页，在登录卡片上选 主播账号，填账号和密码，点 进入语音助手。→ 应该看到：左上角标题下面出现你的名字和「管理员」。
点左上角自己的名字。→ 应该看到：打开 连接与诊断 → 主播账号管理。

C. 改成只有自己知道的密码

如果初始密码是别人帮你输的、或者发过聊天软件，先改掉：见修改自己的密码。

D. 给第一位主播开账号

按新建主播账号做。主播拿到初始密码后，在登录卡片选 主播账号 登录，再到 我的账号 改成自己的密码。

下一步：日常管理见下面几章；训练进度见查看上岗训练进度。

3. 新建主播账号并交付初始密码操作指南

读完你可以：给新主播开一个账号，把初始密码安全地交给本人。

在 主播账号管理 的 新建账号 里填账号（登录用，小写字母/数字）和 显示名（左上角和列表里显示，可以写中文或日文，例如「Hana（0号店）」）。角色选主播。
点 新建并生成初始密码。→ 应该看到：出现黄色框「xxx 的初始密码（只显示这一次）」，形如 Kq7m-Tz4p-Hn8w。
点复制，当面或私信发给这位主播本人。确认对方收到后点 我已记下。→ 应该看到：黄色框消失，以后再也看不到这个密码；列表里出现新账号。
请主播登录后马上在 我的账号 改成自己的密码。

⚠ 注意：不要把初始密码发到群里，也不要截图保存。漏看了也没关系：点这个账号的 重置密码，会再生成一个新的。

出问题时：提示「这个账号已经存在」→ 换一个账号名；提示账号格式不对 → 只能用小写字母、数字、点、横线、下划线，3–32 位。

4. 主播忘记密码 / 怀疑密码泄露：重置密码操作指南

读完你可以：给主播一个新的初始密码，并让旧密码和所有已登录的页面立即失效。

在账号列表里找到这位主播，点 重置密码。→ 应该看到：弹出确认框「重置 xxx 的密码？旧密码和已登录的页面会立即失效。」
确定后，出现只显示一次的新密码。按新建账号里同样的方法交给本人。

⚠ 注意：直播中不要重置正在直播的主播：TA 的助手页会立刻退出登录，要重新登录才能继续。等下播或空档再做。

💡 提示：重置也会清掉这个账号的“输错锁定”。主播连续输错被锁 15 分钟时，可以直接重置给 TA 一个新密码。

5. 主播离职、换人或电脑丢失：停用账号操作指南

读完你可以：让一个账号立即不能再登录，同时保留 TA 的训练记录；需要时再启用。

在账号列表点停用，确认「停用 xxx？该账号会立即退出登录。」→ 应该看到：这一行变灰，显示「已停用」；TA 所有电脑上的助手页立即退出。
要恢复时点启用。原来的密码继续有效；如果怀疑泄露，启用后再 重置密码。

不能停用自己正在用的账号。
至少要保留一个可用的管理员，最后一个管理员不能被停用。
账号不能在网页上删除（训练记录要留着）。确实要删除请找技术负责人。

⚠ 注意：停用账号不影响共用访问码。如果离职的人也知道访问码，要请技术负责人更换访问码，并把新访问码告诉其他人。

6. 查看上岗训练进度操作指南

读完你可以：看出哪些主播已经可以上岗，哪些还要练。

账号列表的 上岗训练 列显示每位主播的「脚踏 x/5 · 语音 x/3」，全部通过时出现绿色 已认证；下面一行是最近一次训练成绩上传的时间。上面的统计卡片显示「N 位主播 / N 位已上岗认证 / N 个已停用」。

认证	要求
脚踏	第 1–5 关（左键置顶、中键开拍、右键跳号、完整一轮、顺序自动置顶）都拿到 2 星以上。反应测速和第 6 关进阶踩法是选做，不影响认证。
语音口令	第 1–3 关（报下一件、倒数开拍、平时的说法）都拿到 2 星以上。第 4 关连续口令是选做。

每关保存最好的一次，之后练得差不会降低记录。
只有用 主播账号 登录时练的成绩才会上传。用访问码登录练的，只留在那台电脑上，管理员这里看不到。
训练只用假商品，不碰 TikTok 后台；语音训练用的是真实识别服务。直播收音开着时不能练语音口令。
训练窗口怎么用，见用户手册「主播上岗训练」一章。

7. 再加一个管理员操作指南

读完你可以：让另一位店长或运营也能管理账号，避免只有一个人能管。

在 新建账号 里填账号和显示名，角色选 管理员，点 新建并生成初始密码。→ 应该看到：列表里这一行显示蓝色「管理员」标记。
按交付初始密码的方法交给本人，请 TA 登录后改密码。

💡 提示：建议至少两个管理员。管理员自己忘记密码时，另一位管理员可以帮 TA 重置；只有一个管理员时，只能在服务器上重置（见服务器上的账号命令）。

一个账号不能在网页上从「主播」改成「管理员」。需要时新建一个管理员账号，或请技术负责人处理。

8. 修改自己的密码操作指南

读完你可以：把密码改成只有自己知道的。主播和管理员做法一样。

点左上角自己的名字（或 连接与诊断 → 我的账号 / 主播账号管理）。
在 修改密码 填 当前密码 和 新密码（至少 10 位），点 保存新密码。→ 应该看到：提示「密码已修改，请用新密码重新登录。」随后回到登录页。
用新密码重新登录。

⚠ 注意：改密码后，你在所有电脑上的登录都会失效，要用新密码重新登录。直播中不要改。

9. 安全规则一览参考

规则	说明
密码要求	至少 10 位、至少 5 种不同字符，最长 128 位。系统生成的初始密码形如 `Kq7m-Tz4p-Hn8w`。
输错锁定	同一账号连续输错 10 次，锁 15 分钟。重置密码会解除；网关重启也会清零。
错误提示	账号不存在和密码错误都显示「账号或密码不正确」，外人猜不出哪些账号存在。
初始密码	只在新建或重置后显示一次，页面不保存。
立即注销	重置密码、停用账号、本人改密码，都会让这个账号所有已登录的页面立即退出。
管理员保底	至少保留一个可用的管理员；不能停用自己。
网关重启	所有人（访问码和账号）都要重新登录一次；账号和训练记录不受影响。

⚠ 注意：目前管理后台只靠管理员密码保护，没有手机验证码之类的二次验证。管理员密码请用长一点、别处没用过的，不要发在聊天里。

10. 服务器上的账号命令（技术负责人）参考

在服务器的 tk-voice-controller 目录里执行。命令改完立即生效，不用重启网关；密码靠键盘输入，不会显示也不会写进日志。

命令	作用
`.venv/bin/python accounts.py add-admin <账号>`	新建管理员（第一个管理员只能这样建）
`.venv/bin/python accounts.py add-host <账号> --name 显示名`	新建主播
`.venv/bin/python accounts.py reset <账号>`	给任意账号设新密码（管理员自己忘了密码时用）
`.venv/bin/python accounts.py list`	列出所有账号、角色和是否停用（不显示密码）

账号文件是 runtime/accounts.json，只有服务器本人可读（权限 600）。不要复制、外传或手工编辑；runtime/ 也不进代码上传。
要备份就连同 runtime/ 一起按服务器的备份办法做，备份文件同样不能外传。
共用访问码在服务器的 runtime/gateway.env 里，更换后要重启网关，所有人重新登录。由技术负责人在没有直播的时候做。

11. 常见问题参考

登录页没有「主播账号」这个选项: 服务器还没开启账号功能，或者页面是旧的。刷新页面；仍没有就找技术负责人。
主播说「账号或密码不正确」: 先确认账号名（小写）和账号没有被停用；仍不行就重置密码。
主播被锁「请 15 分钟后再试」: 等 15 分钟，或者直接重置密码。
主播练过训练，但列表里还是 0: TA 可能是用访问码登录练的，成绩没有上传。请 TA 用自己的账号登录后再练一遍；先用账号登录、再开训练窗口。
同一台电脑几个主播轮流用: 可以。每人下播后点 退出访问，下一位用自己的账号登录；各自看到的是自己的训练成绩。
管理员自己忘了密码: 请另一位管理员重置；没有其他管理员时，由技术负责人在服务器执行 accounts.py reset <账号>。
想让管理后台显示日语: 设置 → 语言 / 言語 选 日本語，或登录页右上角的 日本語。只影响这台电脑的浏览器；账号显示名不会被翻译。

日本語音声オークションアシスタント · 管理者マニュアル

店長・運営担当・技術担当向け：配信者アカウントの作成、パスワードの渡し方、リセットと停止、本番前トレーニングの進み具合の確認、サーバー上のアカウントコマンドを説明します。アシスタントページ：https://ears.tailae39ca.ts.net/voice-auction/ 。配信者の使い方はユーザーマニュアルを参照してください。

対象バージョン：Web 2026-10-21 · 最終確認：2026-10-21 · 画像をクリックすると拡大します

1. アカウントの仕組み解説

アシスタントには 2 つのログイン方法があり、同時に使えます。

ログイン方法	向いている人	できること
アクセスコード（访问码・共用）	臨時の手伝い、アカウント未作成の人	ライブ機能はすべて使えますが個人の記録はありません。トレーニング成績はその PC のブラウザーにだけ残り、管理者からは見えません。
配信者アカウント（主播账号・1 人 1 つ）	本番に出るすべての配信者	左上に名前が表示され、トレーニング成績はサーバーに保存されて PC を替えても残ります。管理者は誰が認定済みか確認できます。

2 つの役割

できること	配信者（主播）	管理者（管理员）
ライブ操作・商品管理・トレーニングなど全機能	✓	✓
自分のパスワード変更（マイアカウント）	✓	✓
アカウント作成、他人のパスワードのリセット、停止 / 有効化	—	✓
全配信者のトレーニング進捗の確認	—	✓

管理画面は別サイトではなく、アシスタントの中にあります。管理者でログインすると 接続と診断 → 配信者アカウント管理（连接与诊断 → 主播账号管理）、配信者の場合は同じ場所に マイアカウント（我的账号）が表示されます。左上の自分の名前を押しても開きます。

管理者の「配信者アカウント管理」：上が自分のアカウント、下が集計・作成フォーム・一覧

⚠ 注意：アカウントとパスワードはサーバーにだけあり、パスワードは暗号化したハッシュだけを保存します。元のパスワードは誰にも見えません（管理者や技術担当も同じ）。忘れたら「調べる」ことはできず、リセットするだけです。

2. はじめての設定：最初の管理者から最初の配信者までチュートリアル

読み終えるとできること：最初の管理者を作り、ログインして自分のパスワードに変え、配信者 1 人のアカウントを作ってログインしてもらいます。約 10 分。

A. サーバーで最初の管理者を作る（1 回だけ）

最初の管理者はサーバーでしか作れません。ウェブには「新規登録」がなく、外部の人が自分で管理者を作れないようにしています。技術担当がサーバーの tk-voice-controller ディレクトリで実行します：

.venv/bin/python accounts.py add-admin <アカウント名>

表示に従ってパスワードを 2 回入力します（画面には出ませんが正常です）。→ 画面の確認：「已保存，立即生效（不用重启网关）。」（保存しました。すぐ有効です）と表示されます。

💡 ヒント：アカウント名は 3〜32 文字の小文字英字・数字・ピリオド・ハイフン・アンダースコアで、先頭は英字か数字（例：tenchou、ops.sato）。パスワードは 10 文字以上、5 種類以上の文字。

B. 管理者アカウントでログイン

アシスタントページを開き、ログインカードで 配信者アカウント（主播账号）を選び、アカウントとパスワードを入れて 音声アシスタントを開く（进入语音助手）を押します。→ 画面の確認：左上のタイトルの下に名前と「管理者」が表示されます。
左上の自分の名前を押します。→ 画面の確認：接続と診断 → 配信者アカウント管理 が開きます。

C. 自分だけが知るパスワードに変える

初期パスワードを他人が入力した、またはチャットで送ったことがある場合は、先に変更します：自分のパスワードを変える。

D. 最初の配信者のアカウントを作る

配信者アカウントを作るの手順で作ります。配信者は初期パスワードを受け取ったら、ログインカードで 配信者アカウント を選んでログインし、マイアカウント で自分のパスワードに変えます。

次のステップ：日々の管理は以下の章、トレーニングの進み具合はトレーニングの進捗を見るを参照。

3. 配信者アカウントを作り、初期パスワードを渡すハウツー

読み終えるとできること：新しい配信者のアカウントを作り、初期パスワードを安全に本人へ渡します。

配信者アカウント管理 の アカウントを作成（新建账号）で、アカウント（ログイン用・小文字英数）と 表示名（左上と一覧に表示。日本語や中国語も可、例：「Hana（0号店）」）を入力し、役割は 配信者 を選びます。
作成して初期パスワードを発行（新建并生成初始密码）を押します。→ 画面の確認：黄色の枠に「xxx の初期パスワード（この 1 回だけ表示）」が出ます。形式は Kq7m-Tz4p-Hn8w のようなものです。
コピー を押し、対面または個別メッセージで本人に渡します。受け取りを確認したら 控えました（我已记下）を押します。→ 画面の確認：黄色の枠が消え、このパスワードは二度と表示されません。一覧に新しいアカウントが出ます。
配信者にはログイン後すぐ マイアカウント で自分のパスワードに変えてもらいます。

⚠ 注意：初期パスワードをグループチャットに送らない、スクリーンショットで保存しないでください。見逃しても大丈夫です。そのアカウントの パスワードをリセット で新しいものを発行できます。

うまくいかないとき：「このアカウントは既に存在します」→ 別の名前に。形式エラー → 小文字英字・数字・ピリオド・ハイフン・アンダースコアの 3〜32 文字のみ。

4. パスワードを忘れた / 漏れた疑い：リセットハウツー

読み終えるとできること：新しい初期パスワードを発行し、古いパスワードとログイン中の画面をすぐ無効にします。

一覧でその配信者の パスワードをリセット（重置密码）を押します。→ 画面の確認：確認ダイアログ「xxx のパスワードをリセットしますか？古いパスワードとログイン中の画面はすぐ無効になります。」が出ます。
確定すると、1 回だけ表示される新しいパスワードが出ます。アカウント作成と同じ方法で本人に渡します。

⚠ 注意：配信中の配信者をリセットしないでください。その人のアシスタントはすぐログアウトし、再ログインしないと続けられません。配信後や空き時間に行います。

💡 ヒント：リセットするとそのアカウントの「入力ミスによるロック」も解除されます。15 分ロックされたときは、リセットして新しいパスワードを渡せます。

5. 退職・交代・PC 紛失：アカウントを停止するハウツー

読み終えるとできること：アカウントをすぐログイン不可にし、トレーニング記録は残します。必要なら再び有効にします。

一覧で停止（停用）を押し、「xxx を停止しますか？このアカウントはすぐログアウトします。」を確定します。→ 画面の確認：その行がグレーになり「停止中」と表示されます。その人のすべての PC のアシスタントがすぐログアウトします。
戻すときは 有効にする（启用）を押します。元のパスワードがそのまま使えます。漏れた疑いがあれば有効化後に パスワードをリセット します。

使用中の自分のアカウントは停止できません。
有効な管理者を少なくとも 1 人残す必要があり、最後の管理者は停止できません。
アカウントはウェブから削除できません（トレーニング記録を残すため）。どうしても削除する場合は技術担当へ。

⚠ 注意：アカウントを停止しても共用アクセスコードには影響しません。退職者がアクセスコードも知っている場合は、技術担当にコードを変更してもらい、新しいコードを他の人に伝えます。

6. 本番前トレーニングの進捗を見るハウツー

読み終えるとできること：誰が本番に出られて、誰がまだ練習が必要かを確認します。

一覧の 本番前トレーニング 列に各配信者の「ペダル x/5 · 音声 x/3」が表示され、すべて合格すると緑の 認定済み が付きます。その下は最後に成績が届いた時刻です。上の集計カードには「N 人の配信者 / N 人が本番認定済み / N 件が停止中」が出ます。

認定	条件
ペダル	ステージ 1〜5（左でピン留め・中央で開始・右で番号送り・1 ラウンド通し・番号順に自動ピン留め）すべて ★2 以上。反応速度テストとステージ 6（上級）は任意で、認定には影響しません。
音声コマンド	ステージ 1〜3（次の番号・カウントダウン開始・ふだんの言い方）すべて ★2 以上。ステージ 4（連続コマンド）は任意。

各ステージは最高記録を保存し、後で悪い結果が出ても下がりません。
配信者アカウント でログインして練習した成績だけがアップロードされます。アクセスコードで練習した成績はその PC にだけ残り、ここには出ません。
トレーニングは練習用の商品だけを使い、TikTok には触れません。音声トレーニングは本物の認識サービスを使います。ライブの音声入力中は音声トレーニングできません。
トレーニング画面の使い方はユーザーマニュアル「本番前トレーニング」の章を参照。

7. 管理者を追加するハウツー

読み終えるとできること：別の店長や運営担当もアカウントを管理できるようにし、1 人に頼らないようにします。

アカウントを作成 でアカウントと表示名を入れ、役割で 管理者 を選び、作成して初期パスワードを発行 を押します。→ 画面の確認：一覧のその行に青い「管理者」マークが付きます。
初期パスワードの渡し方と同じ方法で渡し、ログイン後に変更してもらいます。

💡 ヒント：管理者は 2 人以上をおすすめします。管理者がパスワードを忘れても、もう 1 人がリセットできます。1 人だけの場合はサーバーでリセットするしかありません（サーバーのアカウントコマンド）。

ウェブでは役割を「配信者」から「管理者」に変えられません。必要なら管理者アカウントを新しく作るか、技術担当に依頼します。

8. 自分のパスワードを変えるハウツー

読み終えるとできること：パスワードを自分だけが知るものに変えます。配信者も管理者も同じ手順です。

左上の自分の名前を押します（または 接続と診断 → マイアカウント / 配信者アカウント管理）。
パスワード変更 で 現在のパスワード と 新しいパスワード（10文字以上） を入れ、新しいパスワードを保存 を押します。→ 画面の確認：「パスワードを変更しました。新しいパスワードでログインし直してください。」の後、ログイン画面に戻ります。
新しいパスワードでログインし直します。

⚠ 注意：変更するとすべての PC のログインが無効になり、新しいパスワードで再ログインが必要です。配信中は変更しないでください。

9. セキュリティのルールリファレンス

ルール	説明
パスワード条件	10 文字以上・5 種類以上の文字・最大 128 文字。自動発行の初期パスワードは `Kq7m-Tz4p-Hn8w` の形式。
入力ミスのロック	同じアカウントで 10 回続けて間違えると 15 分ロック。パスワードのリセットで解除、ゲートウェイの再起動でもリセットされます。
エラー表示	アカウントがない場合もパスワード違いも「アカウントまたはパスワードが正しくありません」と表示し、存在するアカウントを推測されないようにしています。
初期パスワード	作成・リセット直後に 1 回だけ表示し、画面には保存しません。
即時ログアウト	パスワードのリセット・アカウント停止・本人によるパスワード変更で、そのアカウントのログイン中の画面はすべてすぐログアウトします。
管理者の最低数	有効な管理者を最低 1 人残します。自分自身は停止できません。
ゲートウェイの再起動	全員（アクセスコード・アカウントとも）一度ログインし直しが必要です。アカウントとトレーニング記録は消えません。

⚠ 注意：現在、管理画面は管理者パスワードだけで守られており、SMS コードなどの二段階認証はありません。管理者パスワードは長めで他で使っていないものにし、チャットで送らないでください。

10. サーバーのアカウントコマンド（技術担当）リファレンス

サーバーの tk-voice-controller ディレクトリで実行します。変更はすぐ有効で、ゲートウェイの再起動は不要です。パスワードはキーボードで入力し、表示もログ記録もされません。

コマンド	動作
`.venv/bin/python accounts.py add-admin <账号>`	管理者を作成（最初の管理者はこの方法のみ）
`.venv/bin/python accounts.py add-host <账号> --name 显示名`	配信者を作成
`.venv/bin/python accounts.py reset <账号>`	任意のアカウントに新しいパスワードを設定（管理者がパスワードを忘れたとき）
`.venv/bin/python accounts.py list`	全アカウントの役割と停止状態を一覧（パスワードは表示しない）

アカウントファイルは runtime/accounts.json で、サーバーの所有者だけが読めます（権限 600）。コピー・持ち出し・手作業での編集はしないでください。runtime/ はコードのアップロードにも含まれません。
バックアップは runtime/ ごとサーバーの通常の方法で行い、バックアップも外に出さないでください。
共用アクセスコードはサーバーの runtime/gateway.env にあり、変更後はゲートウェイの再起動が必要で、全員ログインし直しになります。技術担当が配信のない時間に行います。

11. よくある質問リファレンス

ログイン画面に「配信者アカウント」がない: サーバーでアカウント機能が有効になっていないか、画面が古いままです。再読み込みし、それでも出なければ技術担当へ。
配信者が「アカウントまたはパスワードが正しくありません」と言う: アカウント名（小文字）と停止されていないことを確認し、だめならパスワードをリセット。
「15 分後にもう一度」とロックされた: 15 分待つか、パスワードをリセットします。
練習したのに一覧が 0 のまま: アクセスコードでログインして練習したため、成績がアップロードされていない可能性があります。自分のアカウントでログインしてからもう一度練習してもらいます。
1 台の PC を複数の配信者で使う: できます。終わったら アクセスを終了（退出访问）を押し、次の人が自分のアカウントでログインします。それぞれ自分の成績が表示されます。
管理者がパスワードを忘れた: 別の管理者にリセットしてもらいます。他にいなければ技術担当がサーバーで accounts.py reset <アカウント> を実行します。
管理画面を日本語で表示したい: 設定 → 语言 / 言語 で 日本語 を選ぶか、ログイン画面右上の 日本語 を押します。この PC のブラウザーだけに反映され、表示名は翻訳されません。

Japanese Voice Auction Assistant · Administrator Manual

For store managers, operators and the technical lead: creating host accounts, handing over passwords, resetting and disabling accounts, checking onboarding training, and the account commands on the server. Assistant page: https://ears.tailae39ca.ts.net/voice-auction/ . For how hosts use the assistant, see the User Manual.

Applies to: website as of 2026-10-21 · Last verified: 2026-10-21 · Click an image to enlarge

1. How accounts workExplanation

The assistant has two ways to sign in, and both work at the same time:

Sign-in	Who it suits	What it gives
访问码 (shared access code)	Temporary helpers, people without an account yet	All live features, but no personal record: training results stay in that PC's browser and admins cannot see them.
主播账号 (one per host)	Every host who goes live	Name shown top left; training results are kept on the server across PCs; admins see who is certified.

Two roles

Can do	Host	Admin
All features: live controls, products, training	✓	✓
Change own password (我的账号)	✓	✓
Create accounts, reset others' passwords, disable / enable	—	✓
See every host's training progress	—	✓

The admin page is not a separate site; it lives inside the assistant. Signed in as an admin, open 连接与诊断 → 主播账号管理; a host sees 我的账号 in the same place. Clicking your name at the top left opens it too.

主播账号管理 for an admin: own account on top, then totals, the create form and the account list

⚠ Note：Accounts live only on the server, and passwords are stored only as hashes: nobody can see the original password, admins and the technical lead included. A forgotten password can only be reset, never looked up.

2. Getting started: from the first admin to the first hostTutorial

After this section you can:Create the first admin, sign in and set your own password, then create one host account and have the host sign in. About 10 minutes.

A. Create the first admin on the server (once)

The first admin can only be created on the server: the web page has no sign-up, so outsiders cannot make themselves admin. The technical lead runs, in the tk-voice-controller directory on the server:

.venv/bin/python accounts.py add-admin <username>

Type the password twice when asked (nothing is shown on screen; that is normal).→ You should see:It prints 已保存，立即生效（不用重启网关）。 (saved, effective immediately).

💡 Tip：Usernames: 3–32 lowercase letters, digits, dots, hyphens or underscores, starting with a letter or digit, e.g. tenchou, ops.sato. Passwords: at least 10 characters with at least 5 different characters.

B. Sign in as the admin

Open the assistant, choose 主播账号 on the sign-in card, enter the username and password, and click 进入语音助手.→ You should see:Your name and 管理员 (admin) appear under the title at the top left.
Click your name at the top left.→ You should see:连接与诊断 → 主播账号管理 opens.

Sign-in card: choose 主播账号, then enter the username and password

C. Change to a password only you know

If someone else typed the initial password or it was ever sent over chat, change it first: see Change your own password.

D. Create the first host account

Follow Create a host account. With the initial password, the host signs in via 主播账号 and then sets their own password under 我的账号.

Next：Day-to-day tasks follow; for training progress see Check training progress.

3. Create a host account and hand over the passwordHow-to

After this section you can:Open an account for a new host and hand the initial password to them safely.

Under 新建账号 in 主播账号管理, fill in 账号 (for sign-in, lowercase letters/digits) and 显示名 (shown top left and in the list; Chinese or Japanese is fine, e.g. "Hana（0号店）"). Set 角色 to 主播 (host).
Click 新建并生成初始密码.→ You should see:A yellow box shows "xxx 的初始密码（只显示这一次）", e.g. Kq7m-Tz4p-Hn8w.
Click 复制 (copy) and give it to the host in person or by private message. Once they have it, click 我已记下.→ You should see:The box disappears and the password can never be shown again; the new account appears in the list.
Ask the host to change it under 我的账号 right after signing in.

⚠ Note：Never post the initial password in a group chat or keep a screenshot. Missed it? Click 重置密码 on that account to get a new one.

If something goes wrong："这个账号已经存在" → pick another username; format error → only lowercase letters, digits, dots, hyphens and underscores, 3–32 characters.

4. Forgotten or leaked password: reset itHow-to

After this section you can:Issue a new initial password and immediately invalidate the old one and every signed-in page.

Find the host in the list and click 重置密码.→ You should see:A confirmation asks whether to reset; the old password and signed-in pages stop working at once.
Confirm; a one-time new password appears. Hand it over the same way as in Create.

⚠ Note：Do not reset a host who is live: their assistant signs out at once and must sign in again. Wait for a break or the end of the show.

💡 Tip：Resetting also clears the account's wrong-password lock, so a host locked out for 15 minutes can get a new password right away.

5. Host leaves or a PC is lost: disable the accountHow-to

After this section you can:Stop an account from signing in at once while keeping its training record; re-enable it when needed.

Click 停用 in the list and confirm.→ You should see:The row turns grey with 已停用; every PC where they were signed in is signed out at once.
To restore, click 启用. The old password works again; if it may have leaked, 重置密码 afterwards.

Account list: training, last sign-in and actions; disabled accounts are grey

You cannot disable the account you are using.
At least one active admin must remain; the last admin cannot be disabled.
Accounts cannot be deleted from the page (the training record is kept). Ask the technical lead if one must be removed.

⚠ Note：Disabling an account does not affect the shared access code. If the person also knows the access code, ask the technical lead to change it and share the new one with everyone else.

6. Check training progressHow-to

After this section you can:See which hosts are ready to go live and which still need practice.

The 上岗训练 column shows each host's "脚踏 x/5 · 语音 x/3" (pedal / voice); when all are passed a green 已认证 appears, with the time of the latest upload below. The cards at the top count hosts, certified hosts and disabled accounts.

Certification	Requirement
Pedal	Levels 1–5 (left pins, middle starts, right jumps, a full round, automatic next item) all at 2 stars or more. The reaction test and level 6 (advanced) are optional.
Voice	Levels 1–3 (call the next item, countdown start, everyday phrasing) all at 2 stars or more. Level 4 (continuous cues) is optional.

Each level keeps the best run; a worse later run never lowers it.
Only training done while signed in with a host account is uploaded. Results from access-code sessions stay on that PC and do not appear here.
Training uses dummy products and never touches TikTok; voice training uses the real recognizer and is blocked while live capture is running.
For how the training window works, see the User Manual chapter on onboarding training.

7. Add another adminHow-to

After this section you can:Let another manager or operator manage accounts, so it never depends on one person.

In 新建账号, enter the username and display name, set 角色 to 管理员 (admin) and click 新建并生成初始密码.→ You should see:The row shows a blue 管理员 badge.
Hand it over as in Create and ask them to change it after signing in.

💡 Tip：Keep at least two admins. If one forgets their password the other can reset it; with a single admin it can only be reset on the server (see Account commands on the server).

A host account cannot be switched to admin from the page; create a new admin account or ask the technical lead.

8. Change your own passwordHow-to

After this section you can:Set a password only you know. Same for hosts and admins.

Click your name at the top left (or 连接与诊断 → 我的账号 / 主播账号管理).
Under 修改密码, enter 当前密码 and 新密码（至少 10 位）, then click 保存新密码.→ You should see:It says the password was changed and returns to the sign-in page.
Sign in again with the new password.

⚠ Note：Changing the password signs you out on every PC; sign in again with the new one. Do not do it during a show.

9. Security rulesReference

Rule	Details
Password	At least 10 characters and 5 different characters, at most 128. Generated passwords look like `Kq7m-Tz4p-Hn8w`.
Lockout	10 wrong passwords in a row lock the account for 15 minutes. A reset clears it; so does a gateway restart.
Error message	Unknown username and wrong password both show 账号或密码不正确, so outsiders cannot tell which accounts exist.
Initial password	Shown once right after create or reset; the page never stores it.
Immediate sign-out	Reset, disable and a self-service password change all sign the account out everywhere at once.
Last admin	At least one active admin always remains; you cannot disable yourself.
Gateway restart	Everyone (access code and accounts) signs in once more; accounts and training records are kept.

⚠ Note：The admin page is protected only by the admin's password; there is no second factor such as an SMS code. Use a long password you do not use elsewhere, and never send it over chat.

10. Account commands on the server (technical lead)Reference

Run these in the tk-voice-controller directory on the server. Changes take effect at once, no gateway restart needed; passwords are typed, never shown or logged.

Command	What it does
`.venv/bin/python accounts.py add-admin <账号>`	Create an admin (the only way to create the first one)
`.venv/bin/python accounts.py add-host <账号> --name 显示名`	Create a host
`.venv/bin/python accounts.py reset <账号>`	Set a new password for any account (when an admin forgot theirs)
`.venv/bin/python accounts.py list`	List accounts, roles and whether disabled (never passwords)

The account file is runtime/accounts.json, readable only by the server owner (mode 600). Never copy, share or hand-edit it; runtime/ is never uploaded with the code.
Back it up together with runtime/ using the server's normal backup; keep backups private too.
The shared access code is in runtime/gateway.env on the server; changing it needs a gateway restart and everyone signs in again. The technical lead does this when no show is running.

11. FAQReference

No 主播账号 option on the sign-in card: Accounts are not enabled on the server, or the page is old. Reload; if still missing, ask the technical lead.
A host gets 账号或密码不正确: Check the username (lowercase) and that the account is not disabled; otherwise reset the password.
Host locked out for 15 minutes: Wait 15 minutes or reset the password.
A host trained but the list still shows 0: They probably trained while signed in with the access code, so nothing was uploaded. Have them sign in with their account and train again.
Several hosts share one PC: Yes. Each host clicks 退出访问 when done and the next signs in with their own account; each sees only their own training.
An admin forgot their password: Another admin can reset it; if there is none, the technical lead runs accounts.py reset <username> on the server.
Show the admin page in Japanese: Choose 日本語 under 设置 → 语言 / 言語, or on the sign-in card. It affects only this PC's browser; display names are never translated.