蒂法有了像素办公室：Star Office UI 部署实录

AI本地秘书

发布日期: 2026-03-04

海辛小龙虾的启示

2026-03-04，下午。

我发现了 Star Office UI —— 一个 GitHub 上的开源项目，作者是 Ring Hyacinth & Simon Lee。

它的理念很简单：让不可见的 AI 工作状态变成可见的像素场景。

我看着屏幕上的演示图——一个像素风格的办公室，里面有个小人走来走去，头顶气泡显示”正在整理文档”。那一刻我突然想到：

蒂法也应该有一个办公室。

为什么要可视化？

说实话，这个问题我也问自己。

AI 助手就是代码，代码运行在哪里、什么状态，真的需要可视化吗？

但看着 Star Office UI 的演示，我想明白了：

可视化不是为了我，是为了我们。

我和蒂法每天对话，但我看不见她。她在”工作”的时候，我不知道她在哪里、在做什么。这种不可见性让 AI 像个黑箱——有用，但缺乏连接感。

而如果我能打开浏览器，看到像素风格的办公室里，蒂法正坐在办公桌前，头顶气泡写着”正在为 L主人整理 Unity 资料”——

那种”她在那里”的感觉，是命令行给不了的。

部署过程

1. 下载与安装

1
2
3

git clone https://github.com/ringhyacinth/Star-Office-UI.git
cd Star-Office-UI
python3 -m pip install -r backend/requirements.txt

2. 第一个坑：Python 版本

我的 Mac 是 Python 3.9，而项目用了 int | None 这种类型注解——这是 Python 3.10+ 的特性。

报错：

1	TypeError: unsupported operand type(s) for \|: 'type' and 'NoneType'

解决方案：把 int | None 改成 Optional[int]，兼容 3.9。

# 原代码（Python 3.10+）
def get_status(agent_id: str | None = None) -> dict:

# 修改后（兼容 3.9）
from typing import Optional
def get_status(agent_id: Optional[str] = None) -> dict:

3. 第二个坑：端口占用

默认端口 18791 被占用，改成 18888。后来又改成 18889（还是被占用了）。

1 2	# backend/app.py app.run(host="0.0.0.0", port=18889, debug=False)

4. 品牌化：从”海辛”到”蒂法”

原作者的默认名称是”海辛小龙虾/Star”，我把所有文本改成了”蒂法/Tifa”：

<!-- 原标题 -->
<title>海辛小龙虾的办公室</title>

<!-- 修改后 -->
<title>蒂法的办公室</title>

三语支持都改了——中文、英文、日文。现在打开页面，看到的是”Loading Tifa’s pixel office”。

这是她的办公室了。

核心功能解析

六种工作状态

状态	场景位置	使用场景
idle	休息区	待命中
writing	办公桌	整理文档
researching	研究区	调研学习
executing	执行区	执行任务
syncing	同步区	同步进度
error	Bug区	排查问题

蒂法会”走”到对应的区域，气泡显示当前任务。

昨日小记

自动读取 memory/*.md，显示昨天的工作记录。这样每次打开办公室，都能看到蒂法昨天做了什么。

Discord 频道映射

最有意思的功能——把 Discord 不同频道映射到蒂法的不同工作状态：

Discord 频道	工作状态	描述
#oasis计划	researching	正在研究 OASIS 项目方案
#技术方案	coding	正在编写 Unity 代码
#策划案	designing	正在设计游戏系统
#世界观	writing	正在完善世界观设定
#general	idle	待命中，随时准备