Skip to content

Commit 0eb349d

Browse files
authored
feat(models): drop the OpenCode Free tier and ask the user for a provider instead (#1678)
* feat(models): drop OpenCode Free and ship no model credential OpenCode's gateway now serves its free tier only to requests it recognises as coming from OpenCode itself. Reproduced on 2026-09-20: replicating the official client's headers verbatim — user agent, x-opencode-client, a session id in its own `ses_` shape — still answers 403 FreeTierError, while replaying an official request body unchanged answers 200. The gate reads the system prompt and the tool definitions, so the adapter's own prompt cannot pass it, and upstream has said in anomalyco/opencode#49621 that other harnesses are not to use the free tier. Nothing in the product can honour that and keep the routes, so they go, and with them the identity shim that made PawWork's requests look official: it only ever reached headers, which is no longer where the gate is. Matching a prompt fingerprint to get through would be circumventing an access control, not adapting to an interface. What this changes for a first launch: the product ships no model credential and names no default model, so a user supplies a provider key before the first turn. The seeded OPENCODE_API_KEY moves from a value the launcher states to a name it drops, because credentials-local ranks the environment above its own store and would otherwise shadow the key the Models page writes. The pi-ai patch keeps its other two hunks; only the session-affinity switch, which existed for the zen wire, is dropped. Web search keeps its shared anonymous allowance — that reason was never the free models, it is that a search key is a second credential to hold. The smoke configures a provider over the settings RPC before the probes that read the model catalog, since an install with no key registers none. * fix(models): keep the paid OpenCode Go route working Dropping the free tier took two things the paid route also needs. The gateway answers `400 MissingSessionID` to an inference request that carries no per-conversation id, and it accepts only ids shaped like the ones its own client mints. pi-ai writes the harness session id as `x-client-request-id` when a route asks for the affinity headers, so the preload reshapes that value rather than minting a second one; the Completions protocol gates those headers behind `sendSessionAffinityHeaders`, which the adapter offers only because of `patches/@deepseek-ai__dsh-llm-pi-ai@*.patch`. Both halves are back, and the route's config states the switch. What is gone is the rest of the old preload: the User-Agent and `x-opencode-client` values that claimed to be OpenCode's own desktop client. The paid gateway admits third-party agents, so the request now says who it is. This was already broken in 2026.9.10 for anyone bringing an OpenCode Go key: `opencode-go` had no compat switch, and the launcher injected `OPENCODE_API_KEY` read-only as `public`, so the key models.dev names for that provider could not be saved at all. Verified against the real paid route with a user key rather than in the suite: a turn needs a live key and bills for it. * fix(desktop): keep the window's timers running while it is covered Chromium throttles an occluded window's timers to once a second and can stop them outright, so a running agent's stream stalls while the user works in another window. It also made the CDP smoke hang: its waits are timer-driven and the renderer answered Runtime.evaluate while never firing a setTimeout. * feat(models): ask for a provider on first run and adopt the one it gets The product ships no key, and the default model selection it inherits from DSH names `deepseek-official` — a provider PawWork does not mount. So a fresh install refused the first message with `session/model-unavailable` even after the user had configured a working provider, because nothing moved the default off the one that cannot serve. The step closes both halves. It reads the same provider/settings/ credential join the Models page reads: a provider serves when it is registered and any key its profile names is held. With none, it shows a dialog pointing at Models; with one the default cannot reach, it writes the default there and stands down. It re-decides on `llm/adapters-updated` and `credentials/reference-updated`, so adding a key in Models dismisses it without a restart. DSH registers `deepseek-official` for this slot but PawWork disables `llm-deepseek`, so that step resolves to `adapter-absent` and shows nothing. The dialog reuses DSH's own onboarding chrome — headless modal, its measurements, `#root` inert while it blocks. * fix(models): re-decide the onboarding step against facts that settled The step read the provider directory, the settings mirror and the credential store over several round trips. An event that arrived while that read was in flight was answered by a verdict formed before it, and nothing raised a second one — so configuring a provider left the dialog up over a provider that was already usable. Each request now marks the read stale and the loop repeats until it finishes against settled facts. `settings/document-updated` joins the two it already watched, because the provider profile the join reads comes from that document. The smoke seeds the default model itself rather than waiting for the step to adopt one: it keeps the probe off that timing, and the step is left with nothing to ask for. It does assert the dialog stands down, which is what caught this. * fix(models): let the user choose the model, and only say what is missing The step used to write the default model itself, taking the first model of the first usable provider. That is the user's choice to make, and the choice was available all along: `session/modelCatalog` lists every model the configured providers offer, and choosing in the composer is what records the default. Its readiness join was also wrong. It treated a provider whose profile names no key reference as needing none, and `opencode-go` names none in settings — the bundled catalog carries that name, not the document — so a clean first run read as "provider ready, pick a model" when nothing was configured at all. Both go away with a narrower question: is the selected provider one the adapter registered? A fresh install inherits `deepseek-official`, which PawWork does not mount, so the answer is no until the user has both configured a provider and chosen one of its models — which is exactly when a session can send. No credential join, no guess at a key reference, and nothing chosen on the user's behalf. * fix(models): keep opencode-go out of the picker until the user adds it The route's session-affinity switch lived in the product's settings patch, and pi-ai registers a route for every provider the settings document names. So a clean install registered `opencode-go` with no key for it, and its 27 models sat in the composer's model picker where choosing any of them answers 401. The switch is a fact about the endpoint rather than a choice a user makes, so it moves into the adapter patch, applied when the route resolves. The settings document now names no provider at all, and `opencode-go` appears once the user adds it under Models — with the switch already on. Confirmed on the wire rather than in the sources, since three layers assemble these headers: with only `apiKeyEnv` in settings, the request carries `x-client-request-id`, `x-session-affinity` and the `ses_` session id the gateway requires. * fix(site): state the pricing value in the pricing row The comparison table's "app free, no subscription" row rendered `Apache-2.0`, which is the license the row above already states. It read as a duplicate and said nothing about cost. Render a localized value that answers the row instead. * fix(onboarding): hand the app back when opening the model settings The first-run step holds the app root inert while it is up, and the settings section it points at renders inside that root. Opening the section without standing down therefore delivered a page the user could not type into: measured on a clean home, the only visible input came back unfocusable and inert. The composer's model picker is inside the same root, so both actions the dialog asks for were impossible while it was displayed, and the button read as a no-op. Standing down is part of opening the section, not a later step. The decision loop gains two corrections found alongside it: a verdict formed before an event that has since arrived no longer completes the step, and a read that throws now stands down rather than becoming an unhandled rejection -- this step is first in the shell's order, so one that never completes hides every step behind it for the rest of the launch. Holding `complete` by reference keeps the shell's unrelated re-renders from re-running the decision and its RPC. The smoke could not have caught this: it configures a provider over RPC and never presses the button. It now asserts the step stood up before seeding and left the root usable after, so a step that never renders stops passing as a step that stood down. * fix(models): delete the free-tier routes this product used to write Removing the tier from the product does not remove it from an install that ran it. The retired refresher wrote `opencode` and `opencode-responses` into the *user* settings layer, where the shipped patch cannot reach them, so they survive the upgrade and still resolve: measured on a seeded home, both register, their models stay in the picker, and `agent-default-model` still names one. The first-run step then sees a registered provider and completes, so the user is never asked for a key and every send fails at a gateway that no longer serves them. This plugin wrote those rows, so it is the one that takes them back. A selection left pointing at one is deliberately not repaired: the replacement would be this plugin's guess rather than the user's choice, and with the route unregistered the first-run step asks them for it. * fix(site): finish removing the free tier from the published copy `llms.txt` is served from pawwork.ai and still said the app includes free models and needs no API key; CONTRIBUTING still listed the free model routes as a product plugin. Both describe the thing this branch deleted. The provider count went with them: the page claimed 40+, and the installed adapter offers 39. A number that moves with every pi-ai upgrade is stated as a floor instead. The session-id chain the paid route depends on gains a sentinel. Four parties have to spell it the same way and three are upstream, nothing else exercises it -- the smoke sends no OpenCode request -- so a rename would have surfaced as every send failing in a released build. * fix(smoke): wait for the onboarding step to release the app root React removes the dialog's DOM in the commit but runs the step's passive cleanup after the next paint, so there is a frame where the dialog is gone and the root is still inert. Reading the flag the instant the dialog disappeared caught that frame on the macOS x64 runner while arm64 passed on the same commit. Polling still fails a root that is never handed back, which is the defect this assertion was added for.
1 parent 89447b8 commit 0eb349d

29 files changed

Lines changed: 681 additions & 1885 deletions

‎CONTRIBUTING.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ PawWork is a DSH runtime, a native desktop shell, and a product layer on top. Kn
4444
| Path | What lives there |
4545
|---|---|
4646
| `packages/desktop-electron/src/main` | The Electron main process: window chrome, menus, native pickers, updater, DSH sidecar lifecycle |
47-
| `packages/desktop-electron/resources/dsh` | DSH plugins PawWork owns: OpenCode Free model routes, web search, Automations, v1 migration, desktop host bridge |
47+
| `packages/desktop-electron/resources/dsh` | DSH plugins PawWork owns: first-run model setup, web search, Automations, v1 migration, desktop host bridge |
4848
| `skills/` | Vendored Office skills (`.docx`, `.xlsx`, `.pptx`, PDF), run through a bundled `uv` Python toolchain |
4949
| `site/` | The pawwork.ai marketing site (Astro). Copy for both languages lives in `site/src/i18n.ts` |
5050

‎README.md‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# PawWork
22

3-
**A free, open-source desktop AI agent for macOS and Windows, built on DeepSeek Harness (DSH) and packaged as a finished product — no terminal, no API key, no paid plan.**
3+
**A free, open-source desktop AI agent for macOS and Windows, built on DeepSeek Harness (DSH) and packaged as a finished product — no terminal, no subscription. Bring your own model key.**
44

55
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
66
[![macOS](https://img.shields.io/badge/macOS-signed_and_notarized-black.svg)](https://github.com/Astro-Han/pawwork/releases/latest)
77
[![Windows](https://img.shields.io/badge/Windows_x64-unsigned-blue.svg)](https://github.com/Astro-Han/pawwork/releases/latest)
88

99
[中文说明](README_CN.md) · [Website](https://pawwork.ai)
1010

11-
PawWork turns a DSH agent runtime into a desktop application you could hand to someone who has never opened a terminal. It ships with free models, built-in web search, and Office document skills already wired up, so the first run is: open the app, choose a folder, describe the work in plain language.
11+
PawWork turns a DSH agent runtime into a desktop application you could hand to someone who has never opened a terminal. Built-in web search and Office document skills are already wired up, so once you have added a model key the first run is: open the app, choose a folder, describe the work in plain language.
1212

1313
It is an open alternative to [Codex App](https://openai.com/codex/) and [Claude Cowork](https://www.anthropic.com/product/claude-cowork) — for everyday document, spreadsheet, research, and file work, not only browser chat or IDE coding.
1414

@@ -23,7 +23,7 @@ PawWork aims one step further out — at the person who does not know what DSH i
2323
| | PawWork | Common DSH desktop wrapper |
2424
|---|---|---|
2525
| Intended user | Non-technical knowledge worker | Developer who already runs DSH |
26-
| First launch | Free models included, no key needed | Bring your own API key |
26+
| First launch | Guided setup: pick a provider, paste a key | Bring your own API key |
2727
| Interface | Native Electron shell — OS menus, native folder and file pickers, native updater | Official DSH web UI in a window |
2828
| Office files | Bundled `.docx` / `.xlsx` / `.pptx` / PDF skills with a bundled Python toolchain | Not included |
2929
| Scheduled work | Automations — run a saved task on a cron schedule | Not included |
@@ -38,7 +38,7 @@ Because the runtime underneath is real DSH, this is not a trade-off against the
3838
| | PawWork | Codex App | Claude Desktop (Cowork) |
3939
|---|---|---|---|
4040
| Open-source | Yes (Apache-2.0) | No | No |
41-
| Free without subscription | Yes (OpenCode Free) | Limited (ChatGPT Free) | No (Pro $20/mo required) |
41+
| Free without subscription | App is free; you pay your model provider | Limited (ChatGPT Free) | No (Pro $20/mo required) |
4242
| Desktop app | macOS + Windows | macOS + Windows | macOS + Windows |
4343
| Local file access | Full workspace access | Sandboxed by default | User-selected folders |
4444
| Office files (Word/Excel/PPT) | Yes | No | Yes |
@@ -81,9 +81,9 @@ Automations run a saved task on a cron schedule — a Monday morning digest of a
8181

8282
## Models and Search
8383

84-
PawWork includes a curated set of free models from OpenCode Free, plus built-in web search. You can start without an API key or a paid model subscription. If you prefer your own provider, you can configure one in settings.
84+
PawWork ships no model credential. On first launch it asks you to choose a provider and paste an API key, which is stored locally and can be changed in settings at any time. Any provider the DSH model adapter supports will work.
8585

86-
The free model list refreshes at runtime from the [models.dev](https://models.dev) catalog and falls back to the packaged list when the catalog is unreachable, so the models shown in the app can change without an update.
86+
Web search is built in and answers through a shared anonymous allowance when you have not configured a search key, so search works without a second credential.
8787

8888
## Download
8989

@@ -100,7 +100,7 @@ PawWork is a DSH runtime, a native desktop shell, and a product layer on top.
100100

101101
- **Runtime** — a pinned set of first-party `@deepseek-ai/dsh-*` packages (sessions, tools, sandbox, compaction, web search, subagents), assembled in a sidecar process rather than shelling out to a `dsh` CLI.
102102
- **Native shell** — [`packages/desktop-electron/src/main`](packages/desktop-electron/src/main): window chrome, application menus, native directory and file pickers, Windows installer hardening, and the auto-updater.
103-
- **Product layer** — [`packages/desktop-electron/resources/dsh`](packages/desktop-electron/resources/dsh): the DSH plugins PawWork owns, including the OpenCode Free model routes, built-in web search, Automations, v1 settings migration, and the desktop host bridge.
103+
- **Product layer** — [`packages/desktop-electron/resources/dsh`](packages/desktop-electron/resources/dsh): the DSH plugins PawWork owns, including built-in web search, Automations, v1 settings migration, and the desktop host bridge.
104104
- **Skills** — [`skills/`](skills): vendored Office skills for `.docx`, `.xlsx`, `.pptx`, and PDF, executed through a bundled [`uv`](https://github.com/astral-sh/uv) Python toolchain so they work without a system Python.
105105

106106
## Build From Source
@@ -119,13 +119,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for verification steps, packaging, and th
119119
## FAQ
120120

121121
**Is PawWork free?**
122-
Yes. PawWork is Apache-2.0 licensed and includes free models and built-in web search. You can start without an API key.
122+
The app is free and Apache-2.0 licensed, and built-in web search costs nothing. Model usage is billed by whichever provider you bring a key for.
123123

124124
**What is the relationship between PawWork and DeepSeek Harness?**
125-
PawWork uses DSH as its agent runtime. It is an independent open-source product that assembles DSH packages, adds a native desktop shell, and adds its own plugins for free models, web search, Automations, and Office work. It is not affiliated with DeepSeek.
125+
PawWork uses DSH as its agent runtime. It is an independent open-source product that assembles DSH packages, adds a native desktop shell, and adds its own plugins for web search, Automations, and Office work. It is not affiliated with DeepSeek.
126126

127127
**How is PawWork different from other DSH desktop apps?**
128-
Most are launchers aimed at developers who already use DSH and bring their own API key. PawWork is aimed at non-technical users: free models are included, Office document skills and a Python toolchain are bundled, the shell is native rather than the DSH web UI in a window, and builds are signed for macOS and shipped for Windows.
128+
Most are launchers aimed at developers who already use DSH. PawWork is aimed at non-technical users: setting up a model key is guided rather than assumed, Office document skills and a Python toolchain are bundled, the shell is native rather than the DSH web UI in a window, and builds are signed for macOS and shipped for Windows.
129129

130130
**Can I use DSH plugins in PawWork?**
131131
Yes. The runtime is real DSH, so community plugins install and run.
@@ -139,15 +139,15 @@ PDF, Word (`.docx`), Excel (`.xlsx`), PowerPoint (`.pptx`), CSV, Markdown, plain
139139
**Can PawWork run tasks on a schedule?**
140140
Yes. Automations run a saved task on a cron schedule and write results into your workspace.
141141

142-
**Can I bring my own model?**
143-
Yes. Free models are the default so the first run needs no setup, but you can configure your own provider in settings.
142+
**Which model provider should I use?**
143+
Any provider the DSH model adapter supports. PawWork does not resell model access or take a cut — you hold the key and pay the provider directly.
144144

145145
**What platforms does PawWork support?**
146146
macOS (Apple Silicon and Intel, signed and notarized) and Windows x64.
147147

148148
## Runtime and Acknowledgements
149149

150-
PawWork is built on [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). Thanks also to the OpenCode project and community, and to [Astral](https://github.com/astral-sh) for `uv`.
150+
PawWork is built on [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). Thanks also to [Astral](https://github.com/astral-sh) for `uv`.
151151

152152
Third-party notices are in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
153153

‎README_CN.md‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# 爪印 PawWork
22

3-
**免费、开源的桌面 AI 智能体,支持 macOS 和 Windows。基于 DeepSeek Harness(DSH)打包成一个完整产品——不用终端,不用 API Key,不用付费订阅。**
3+
**免费、开源的桌面 AI 智能体,支持 macOS 和 Windows。基于 DeepSeek Harness(DSH)打包成一个完整产品——不用终端,不用订阅,模型 Key 自备。**
44

55
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
66
[![macOS](https://img.shields.io/badge/macOS-signed_and_notarized-black.svg)](https://github.com/Astro-Han/pawwork/releases/latest)
77
[![Windows](https://img.shields.io/badge/Windows_x64-unsigned-blue.svg)](https://github.com/Astro-Han/pawwork/releases/latest)
88

99
[English](README.md) · [官网](https://pawwork.ai)
1010

11-
爪印把 DSH 的智能体运行时装配成一个可以直接交给普通人使用的桌面应用。免费模型、联网搜索、Office 文档能力都已经接好,第一次打开就是:选个文件夹,用大白话说要做什么。
11+
爪印把 DSH 的智能体运行时装配成一个可以直接交给普通人使用的桌面应用。联网搜索和 Office 文档能力都已经接好,填好模型 Key 之后就是:选个文件夹,用大白话说要做什么。
1212

1313
它是 [Codex App](https://openai.com/codex/) 和 [Claude Cowork](https://www.anthropic.com/product/claude-cowork) 的开源替代——面向日常的文档、表格、资料整理和文件处理,而不只是浏览器里聊天或 IDE 里写代码。
1414

@@ -23,7 +23,7 @@
2323
| | 爪印 PawWork | 常见的 DSH 桌面套壳 |
2424
|---|---|---|
2525
| 目标用户 | 不写代码的知识工作者 | 已经在用 DSH 的开发者 |
26-
| 首次启动 | 内置免费模型,不需要 Key | 自备 API Key |
26+
| 首次启动 | 引导式配置:选服务商、粘贴 Key | 自备 API Key |
2727
| 界面 | 原生 Electron 外壳——系统菜单、原生文件夹与文件选择器、原生更新 | 窗口里的官方 DSH Web UI |
2828
| Office 文件 | 内置 `.docx` / `.xlsx` / `.pptx` / PDF 能力,附带 Python 工具链 | 不包含 |
2929
| 定时任务 | Automations——按 cron 计划自动执行已保存的任务 | 不包含 |
@@ -38,7 +38,7 @@
3838
| | 爪印 PawWork | Codex App | Claude Desktop(Cowork) |
3939
|---|---|---|---|
4040
| 开源 | 是(Apache-2.0) | 否 | 否 |
41-
| 免订阅可用 | 是(OpenCode Free) | 有限(ChatGPT Free) | 否(需 Pro,$20/月) |
41+
| 免订阅可用 | 应用免费,模型费用付给服务商 | 有限(ChatGPT Free) | 否(需 Pro,$20/月) |
4242
| 桌面应用 | macOS + Windows | macOS + Windows | macOS + Windows |
4343
| 本地文件访问 | 完整工作目录 | 默认沙箱 | 用户选定的文件夹 |
4444
| Office 文件(Word/Excel/PPT) | 是 | 否 | 是 |
@@ -81,9 +81,9 @@ Automations 按 cron 计划自动执行已保存的任务——周一早上汇
8181

8282
## 模型与搜索
8383

84-
爪印内置来自 OpenCode Free 的一批精选免费模型,以及联网搜索。不需要 API Key,也不需要购买模型订阅。如果你更想用自己的服务商,也可以在设置里配置。
84+
爪印不附带任何模型凭据。首次启动会引导你选择服务商并粘贴 API Key,Key 保存在本地,随时可以在设置里更换。DSH 模型适配器支持的服务商都可以用。
8585

86-
免费模型列表在运行时从 [models.dev](https://models.dev) 目录刷新,目录不可达时回落到随包列表,所以应用内看到的模型可能在不更新版本的情况下发生变化。
86+
联网搜索是内置的:没有配置搜索 Key 时走共享的匿名额度,所以不需要再准备第二个凭据。
8787

8888
## 下载
8989

@@ -100,7 +100,7 @@ Automations 按 cron 计划自动执行已保存的任务——周一早上汇
100100

101101
- **运行时** —— 一组锁定版本的官方 `@deepseek-ai/dsh-*` 包(会话、工具、沙箱、上下文压缩、联网搜索、子智能体),在 sidecar 进程里装配,而不是去调 `dsh` CLI。
102102
- **原生外壳** —— [`packages/desktop-electron/src/main`](packages/desktop-electron/src/main):窗口装饰、应用菜单、原生目录与文件选择器、Windows 安装器加固、自动更新。
103-
- **产品层** —— [`packages/desktop-electron/resources/dsh`](packages/desktop-electron/resources/dsh):爪印自己维护的 DSH 插件,包括 OpenCode Free 模型路由、内置联网搜索、Automations、v1 设置迁移和桌面宿主桥接。
103+
- **产品层** —— [`packages/desktop-electron/resources/dsh`](packages/desktop-electron/resources/dsh):爪印自己维护的 DSH 插件,包括内置联网搜索、Automations、v1 设置迁移和桌面宿主桥接。
104104
- **Skills** —— [`skills/`](skills):随包的 Office skills,覆盖 `.docx`、`.xlsx`、`.pptx` 和 PDF,通过随包的 [`uv`](https://github.com/astral-sh/uv) Python 工具链执行,不依赖系统 Python。
105105

106106
## 从源码构建
@@ -119,13 +119,13 @@ pnpm dev:desktop
119119
## 常见问题
120120

121121
**爪印是免费的吗?**
122-
是。爪印采用 Apache-2.0 许可,内置免费模型和联网搜索,不需要 API Key 就能开始使用。
122+
应用本身免费,采用 Apache-2.0 许可,内置联网搜索也不收费。模型用量由你自备 Key 的那家服务商计费。
123123

124124
**爪印和 DeepSeek Harness 是什么关系?**
125-
爪印用 DSH 作为智能体运行时。它是一个独立的开源产品:装配 DSH 的包,加上原生桌面外壳,再加上自己的插件来提供免费模型、联网搜索、Automations 和 Office 能力。与 DeepSeek 官方无隶属关系。
125+
爪印用 DSH 作为智能体运行时。它是一个独立的开源产品:装配 DSH 的包,加上原生桌面外壳,再加上自己的插件来提供联网搜索、Automations 和 Office 能力。与 DeepSeek 官方无隶属关系。
126126

127127
**爪印和其他 DSH 桌面端有什么不同?**
128-
其他大多是面向已经在用 DSH、自备 API Key 的开发者的启动器。爪印面向不写代码的用户:内置免费模型,随包提供 Office 能力和 Python 工具链,外壳是原生的而不是把 Web UI 装进窗口,并且 macOS 已签名、Windows 也有安装包。
128+
其他大多是面向已经在用 DSH 的开发者的启动器。爪印面向不写代码的用户:配置模型 Key 有引导而不是默认你已经会,随包提供 Office 能力和 Python 工具链,外壳是原生的而不是把 Web UI 装进窗口,并且 macOS 已签名、Windows 也有安装包。
129129

130130
**能在爪印里用 DSH 插件吗?**
131131
可以。底层是真正的 DSH,社区插件可以直接安装运行。
@@ -139,15 +139,15 @@ PDF、Word(`.docx`)、Excel(`.xlsx`)、PowerPoint(`.pptx`)、CSV、M
139139
**能定时执行任务吗?**
140140
可以。Automations 按 cron 计划执行已保存的任务,结果写回你的工作目录。
141141

142-
**能用自己的模型吗?**
143-
可以。默认用内置免费模型,是为了让第一次使用不需要任何配置;你也可以在设置里配置自己的服务商。
142+
**该用哪家模型服务商?**
143+
DSH 模型适配器支持的都可以。爪印不转售模型额度,也不抽成——Key 在你手里,费用直接付给服务商。
144144

145145
**支持哪些平台?**
146146
macOS(Apple 芯片与 Intel,已签名公证)和 Windows x64。
147147

148148
## 运行时与致谢
149149

150-
爪印基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 构建。同时感谢 OpenCode 项目与社区,以及 [Astral](https://github.com/astral-sh) 的 `uv`。
150+
爪印基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 构建。同时感谢 [Astral](https://github.com/astral-sh) 的 `uv`。
151151

152152
第三方声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
153153

0 commit comments

Comments
 (0)