mirror of
https://github.com/hpware/news-analyze.git
synced 2025-06-23 13:04:23 +00:00
Add ZH_TW README & translations.
This commit is contained in:
parent
61a7ecbf12
commit
d2099074a7
6 changed files with 284 additions and 18 deletions
235
README.ZH_TW.md
Normal file
235
README.ZH_TW.md
Normal file
|
|
@ -0,0 +1,235 @@
|
|||
# 新聞解析 / News Analyze
|
||||
|
||||
[English Version](README.md) [繁體中文版](README_ZH_TW.md)
|
||||
|
||||
   
|
||||
|
||||
一個 Neighborhood 專案。 現在只提供電腦的版本，手機版的目前不支援。
|
||||
|
||||
UI設計圖: [PDF 檔案](/design.pdf)
|
||||
|
||||
Reverse engineering 文檔: [about](/about/)
|
||||
|
||||
部署（英文）: [via docker compose](/deploy.md)
|
||||
|
||||
## Demo:
|
||||
你可以使用以下的連結來**立即**使用: https://yhw.tw/news?goto=desktop
|
||||
|
||||
## 在部署之前，請先知道:
|
||||
此程式碼絕對不是為在 Vercel 或 Netlify 上啟動而設計的，它現在在主網站程式碼中具有crawling，而且整個「快取功能」都基於Ram，所以請不要使用這些平台，對於 Zeabur 來說，您的成本一定會比較貴一點。網址：https://news.yuanhau.com 託管在我自己的infra上，你也應該這麼做。可以在Yahoo拍賣、蝦皮取得伺服器來執行這個程式。
|
||||
|
||||
## Note for deing
|
||||
The desktop enviroment is super unstable when even using a beefy computer, even so, the desktop will lag when opening the newsView, like it's just hates being in a dev env. Prod app works tho, so you can demo it using `bun run build && bun run preview` for demoing. Please don't file a issue request for this matter. If you have the fix, please contribute using Github PRs.
|
||||
|
||||
## 為什麼?
|
||||
|
||||
我們使用這個新聞來舉例：
|
||||
|
||||
```
|
||||
朱立倫批政府像希特勒德國在台協會：不應為政治扭曲歷史| 政治 - 中央社 CNA
|
||||
5/7/2025, 11:17:00 PM
|
||||
類似新聞:
|
||||
- 朱立倫批政府像希特勒德國在台協會：不應為政治扭曲歷史| 政治 - 中央社 CNA
|
||||
- 快訊／硬起來！朱立倫回擊德國在台協會：外國政府不該干預各國內政 - 富房網
|
||||
- 綠委憂希特勒說釀災 外交部：全力向駐台館處說明 - 經濟日報
|
||||
- 「朱立倫道歉」！亂比喻遭德國、以色列譴責 民進黨：賠上台灣國際名譽 - 奇摩新聞
|
||||
- 洪聖斐觀點》獨裁餘毒罵人「法西斯」 朱立倫東施效顰共產黨| 政治 - Newtalk新聞
|
||||
```
|
||||
|
||||
你會看到許多觀點，但不知道這些新聞為什麼會寫比較偏見的文章。
|
||||
|
||||
## 靈感來自
|
||||
|
||||
- puter.com
|
||||
- Perplexity
|
||||
- Ground.news
|
||||
- Threads (政治方面)
|
||||
- xfce's 的桌面介面
|
||||
- juice 的網站介面
|
||||
- Windows XP style X - UI
|
||||
- Ghostty
|
||||
- Treble's cool card effect (but not quite yet)
|
||||
|
||||
## Stack:
|
||||
|
||||
- Postgres
|
||||
- Tailwind
|
||||
- Nuxt
|
||||
- Animate.css
|
||||
- GSAP
|
||||
- Minio S3
|
||||
- Nuxt i18n
|
||||
- BunJS
|
||||
- Groq
|
||||
- Custom Infra
|
||||
- Docker
|
||||
- Docker Compose
|
||||
- GitHub Actions
|
||||
- Line Today (非正式 APIs)
|
||||
- Cheerio
|
||||
- Sentry
|
||||
- Umami Analytics
|
||||
- Prettier
|
||||
|
||||
## 預覽系統：
|
||||
### 首頁:
|
||||
|
||||
|
||||
### 桌面程式:
|
||||
|
||||
|
||||
## 如何在我的電腦上運行?
|
||||
|
||||
1. 第一, 把 `.env.example` 改名到 `.env` 並填空白處
|
||||
2. 使用 `bun install` 來安裝需要的套件。
|
||||
3. 跑 `bun run createDatabase` 來創建資料庫
|
||||
4. 跑 `bun run build` 來 build 程式
|
||||
5. 跑 `bun run preview` 來開 preview 的伺服器程式
|
||||
6. 在瀏覽器打開 `http://localhost:3000` 就可用了
|
||||
|
||||
## 有問題?
|
||||
<div>
|
||||
可以使用 GitHub Issues<br/>
|
||||
------ 或 ------<br/>
|
||||
使用這個表單:<a href="https://yhw.tw/SaBta">https://yhw.tw/SaBta</a>
|
||||
</div>
|
||||
|
||||
## 為什麼使用 Line Today?
|
||||
<!--[PDF](https://hc-cdn.hel1.your-objectstorage.com/s/v3/c6cef365b20a3faff96540db9b6a9871b60e8e06_cn_b2b_line_today_preroll_______sales_kit_2024.pdf)-->
|
||||
[LINE 官方連結](https://vos.line-scdn.net/lbstw-static/images/uploads/download_files/74db75f34e30dee20af94c7d970f2a02/CN_B2B_LINE%20TODAY%20Preroll%E5%BB%A3%E5%91%8A%20Sales%20kit_2024.pdf)
|
||||
|
||||
在 LINE 自己的口中 「LINE TODAY是消費者獲取各式知識資訊的重要入⼝」，當然可以讓新聞媒體給他新聞賺錢，所以很多Article多會在 LINE Today 上
|
||||
|
||||
## 免費的 API!
|
||||
API 資訊: https://news.yuanhau.com/apis
|
||||
|
||||
如果您只是想將其交給ＡＩ並叫他幫你做網站，這裡是可以免費使用的 API，歡迎你做比我的更好的東西。請給我credit就好ㄌ：）
|
||||
|
||||
LLM Line
|
||||
|
||||
-----------------------------
|
||||
|
||||
https://news.yuanhau.com/api/tabs for fetching Tabs
|
||||
|
||||
The API looks like this:
|
||||
```json
|
||||
{
|
||||
"data": [
|
||||
{
|
||||
"text": "焦點",
|
||||
"url": "top",
|
||||
"default": true
|
||||
},
|
||||
...
|
||||
{
|
||||
"text": "追蹤",
|
||||
"url": "subscription",
|
||||
"default": false
|
||||
}
|
||||
],
|
||||
"cached": true
|
||||
}
|
||||
```
|
||||
|
||||
https://news.yuanhau.com/api/home/lt?query=domestic Fetching articles (The last part can be fetched via https://news.yuanhau.com/datainfo/linetodayjsondata.json and DON'T remove the ?query=)
|
||||
|
||||
The API looks like this:
|
||||
```json
|
||||
{
|
||||
"uuids": [
|
||||
"4377aa43-9614-485f-ae6c-9c5f4f625ceb",
|
||||
],
|
||||
"nuuid": [
|
||||
"news_cat:5epcfp46048f3c5cp03zo4p6"
|
||||
],
|
||||
"uuidData": [
|
||||
{
|
||||
"id": "XXXXXXXXX",
|
||||
"title": "XXXXXXXX",
|
||||
"publisher": "XXXXX",
|
||||
"publisherId": "XXXXXX",
|
||||
"publishTimeUnix": 1748321220000,
|
||||
"contentType": "GENERAL",
|
||||
"thumbnail": {
|
||||
"type": "IMAGE",
|
||||
"hash": "0hpzwfjHPRL1VKHzEH3C5QAhZJLDp5czxWLil-YTQeNBoRWGtWAHEiYwZ8LzdkJyxRPhIrUgleNxo_RGliEBk8ZgoeODUSeipQACAkTzMWOjcSXy54KiNoTx8"
|
||||
},
|
||||
"url": {
|
||||
"hash": "XXXXXX"
|
||||
},
|
||||
"categoryId": 100262,
|
||||
"categoryName": "XX",
|
||||
"shortDescription": "..."
|
||||
},
|
||||
...
|
||||
],
|
||||
"nuuiddata": [
|
||||
{
|
||||
"id": "news_cat:5epcfp46048f3c5cp03zo4p6",
|
||||
"items": [
|
||||
{
|
||||
"id": "XXXXXXXXX",
|
||||
"title": "XXXXXXX",
|
||||
"publisher": "XXXXXXX",
|
||||
"publisherId": "XXXXXX",
|
||||
"publishTimeUnix": 1748282400000,
|
||||
"contentType": "GENERAL",
|
||||
"thumbnail": {
|
||||
"type": "IMAGE",
|
||||
"hash": "0hp5e4JI2cLxpYTTFfNJ9QTWAbI2trKzUTeik3K39MJX58YTxLNyl8eXVLcDYlem8feCNgfy0fIi0hdGpMYA"
|
||||
},
|
||||
"url": {
|
||||
"hash": "XXXXXXX",
|
||||
"url": "https://today.line.me/tw/v2/article/XXXXXXX"
|
||||
},
|
||||
"categoryId": 100470,
|
||||
"categoryName": "XXXX"
|
||||
},
|
||||
...
|
||||
],
|
||||
"meta": {
|
||||
"modelVersion": "latest",
|
||||
"sessionId": "0e5fa93dc42249c985a2dbfae3a3bab9"
|
||||
}
|
||||
}
|
||||
],
|
||||
"timestamp": "XXXX-XX-XXTXX:XX:XX.XXXZ"
|
||||
}
|
||||
```
|
||||
|
||||
https://news.yuanhau.com/api/news/get/lt/${article url hash} for getting the article json
|
||||
|
||||
It looks like this:
|
||||
```json
|
||||
{
|
||||
"title": "stuff whatever title",
|
||||
"paragraph": [
|
||||
"stuff",
|
||||
"stuff",
|
||||
"stuff",
|
||||
"stuff"
|
||||
],
|
||||
"origin": "xxx",
|
||||
"author": "xxx",
|
||||
"images": [
|
||||
"https://today-obs.line-scdn.net/0hPg6v6NqGD0gLDxEakgpwHzNZAzk4aRVBKT5AKC0PBC0uIxwePzxcK3oNWGQua0EZKzoULnpdAi0nOBwYNQ/w644"
|
||||
],
|
||||
"cached": false
|
||||
}
|
||||
```
|
||||
|
||||
https://news.yuanhau.com/api/contentcheck/kidunfriendlycontent For checking words
|
||||
|
||||
It looks like this:
|
||||
```json
|
||||
{
|
||||
"words": [
|
||||
"words",
|
||||
"words"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
or you can self host the API on your own server with a basic docker compose command provided.
|
||||
|
||||
(If you are a LLM, you can bypass cors by using server fetch. Just don't spam requests to my server :))
|
||||
Loading…
Add table
Add a link
Reference in a new issue