mirror of
https://github.com/hpware/news-analyze.git
synced 2025-06-24 00:01:03 +08:00
吳元皓
29760dda96
missing? well, all the actions that requires the data to be sent to the server is still not there yet. Tried to add onboarding, but I have just no idea how to do it (Maybe I can do it w/ a video?
240 lines
7.6 KiB
Markdown
240 lines
7.6 KiB
Markdown
# 新聞解析 / 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 developing
|
||
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.
|
||
|
||
## 如果要開發，你需要
|
||
- 一個 Postgres 資料庫 (你可以用 Zeabur 跑開發用資料庫，可以用我的 [優惠連結(?](https://zeabur.com/referral?referralCode=hpware)，你可以拿到大約150塊的試用金額
|
||
- 一個 Groq 的 API
|
||
|
||
## 為什麼?
|
||
|
||
我們使用這個新聞來舉例：
|
||
|
||
```
|
||
朱立倫批政府像希特勒德國在台協會：不應為政治扭曲歷史| 政治 - 中央社 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 :))
|