deepseek-harness-auth
适用于 DeepSeek Harness Web 配置文件的故障关闭式密码身份验证代理包
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add deepseek-harness-auth@0.4.1Deepseek Harness Auth 以 deepseek-harness-auth 发布，当前版本为 0.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness Web profile 的树外认证 Bundle。在不修改 Harness 主仓库的条件下，它将原 WebServer 固定到 127.0.0.1 随机端口，并在同一进程中启动唯一的公共认证代理；HTTP、SPA 静态文件、RPC、SSE 与 WebSocket upgrade 只有通过认证后才会转发到 Harness。
Browser -> public Auth Proxy -> authenticated -> 127.0.0.1:<random> Harness WebServer
browse 目录选择器，远程浏览器选择服务器工作区时不会在宿主桌面弹出 Zenity/KDialog。未安装本 Bundle 的 DSH profile 仍使用 Harness 原有的自动选择策略。scrypt 保存，状态目录权限为 0700，状态文件为 0600。DSH_AUTH_CAPTCHA_MODE 默认值。--dsw-* 配色和页面背景。新浏览器首次访问尚无快照时使用随系统明暗变化的 Harness 风格默认主题。localStorage 中记住确认；刷新或重新登录不再重复打扰，声明文案变化时仍会重新展示。secureCookie 由部署者选择。当前兼容基线为 DeepSeek Harness 0.1.x（@deepseek-ai/dsh-host-webserver >=0.1.0-rc.2）。旧 0.0.x WebServer 使用不同的服务名，不在支持范围内。
以下命令都假定已经安装并能运行 dsh。插件只安装到 DSH 的 web profile（默认位于 ~/.dsh/profiles/web），不是安装成系统全局 npm 包，也不会修改 DeepSeek Harness 主仓库。
npm 包已经包含构建好的 JavaScript，普通用户直接执行：
dsh plugin --profile web add deepseek-harness-auth@latest
如果需要固定版本，避免以后意外升级：
dsh plugin --profile web add deepseek-harness-auth@0.4.0
安装完成后初始化账号并启动 Web 模式：
dsh plugin --profile web exec dsh-auth init
dsh web
init 会在终端中交互式询问账号、密码和确认密码，密码不会出现在命令行参数或 shell history 中。浏览器访问终端输出的认证代理地址；默认监听端口是 3080。
适合测试尚未发布到 npm 的提交。建议锁定 tag 或完整 commit SHA，避免仓库后续更新改变实际安装内容：
dsh plugin --profile web add github:taichuy/deepseek-harness-auth#v0.4.0
# 或：github:taichuy/deepseek-harness-auth#<完整 commit SHA>
GitHub 安装拿到的是 TypeScript 源码，需要在安装时运行本仓库的 prepare 构建脚本。pnpm 10 及以上默认禁止依赖执行构建脚本；如果命令提示构建未被允许，请编辑：
~/.dsh/profiles/web/pnpm-workspace.yaml
在 allowBuilds 下加入：
allowBuilds:
deepseek-harness-auth: true
然后重新执行上面的 dsh plugin ... add github:... 命令。这个授权允许仓库源码在本机安装阶段执行，因此只应安装可信来源并锁定版本。
适合修改和调试插件。先克隆、安装开发依赖并构建：
git clone https://github.com/taichuy/deepseek-harness-auth.git
cd deepseek-harness-auth
corepack enable
pnpm install
pnpm run build
再把当前源码目录链接到 Web profile。请使用实际绝对路径：
dsh plugin --profile web add /absolute/path/to/deepseek-harness-auth
dsh plugin --profile web exec dsh-auth init
dsh web
例如本机仓库位于 /home/taichuy/git/deepseek-harness-auth：
dsh plugin --profile web add /home/taichuy/git/deepseek-harness-auth
源码修改后重新执行 pnpm run build，再重启 dsh web；本地链接不需要重复安装。
从 npm 升级到最新版：
dsh plugin --profile web add deepseek-harness-auth@latest
切换回指定版本：
dsh plugin --profile web add deepseek-harness-auth@0.4.0
卸载插件：
dsh plugin --profile web remove deepseek-harness-auth
升级或重新安装不会主动删除 $DSH_HOME/auth 中已有的账号、密码哈希和 IP 白名单。卸载也只会从 Web profile 移除插件依赖与 Bundle 层，不会删除认证状态文件。
无参数启动类似 xp 的交互菜单：
dsh plugin --profile web exec dsh-auth
也可使用子命令：
dsh plugin --profile web exec dsh-auth status
dsh plugin --profile web exec dsh-auth init
dsh plugin --profile web exec dsh-auth whitelist list
dsh plugin --profile web exec dsh-auth whitelist add localhost
dsh plugin --profile web exec dsh-auth whitelist add 192.168.1.0/24
dsh plugin --profile web exec dsh-auth whitelist remove 192.168.1.0/24
dsh plugin --profile web exec dsh-auth whitelist clear
dsh plugin --profile web exec dsh-auth revoke
localhost 会规范化为 127.0.0.0/8。若前方还有反向代理，必须只把实际代理地址加入 DSH_AUTH_TRUSTED_PROXIES，否则不会采信客户端提供的 X-Forwarded-For。不要在“前置代理从 loopback 连接、但未配置 trusted proxy”的部署中放行 loopback，否则所有公网请求都会被误判为本机白名单。
Bundle 通过环境变量提供部署配置，用户也可以在 $DSH_HOME/profiles/web/cordis.patch.yml 中覆盖 auth-center、auth-password 或 auth-proxy row 的完整 config。
| 环境变量 | 默认值 | 说明 |
|---|---|---|
DSH_AUTH_HOST | 0.0.0.0 | 公共认证代理监听地址 |
DSH_AUTH_PORT | 3080 | 公共认证代理端口 |
DSH_AUTH_PUBLIC_URL | 空 | 输出使用的公开 HTTP(S) URL |
DSH_AUTH_STATE_DIR | $DSH_HOME/auth | 账号、哈希和白名单目录 |
DSH_AUTH_MAX_ATTEMPTS | 6 | 锁定前最大失败次数 |
DSH_AUTH_LOCK_SECONDS | 30 | 锁定秒数 |
DSH_AUTH_SESSION_TTL_SECONDS | 86400 | 会话有效秒数 |
DSH_AUTH_CAPTCHA_MODE | off | off、always、after-failures |
DSH_AUTH_CAPTCHA_AFTER_FAILURES | 3 | 失败后验证码的触发次数 |
DSH_AUTH_SECURE_COOKIE | false | 是否给 Cookie 添加 Secure |
DSH_AUTH_TRUSTED_PROXIES | 空 | 逗号分隔的代理 IP/CIDR |
示例：
DSH_AUTH_PORT=8080 \
DSH_AUTH_CAPTCHA_MODE=after-failures \
DSH_AUTH_PUBLIC_URL=http://server.example:8080 \
dsh web
原 Harness --host、--port 不再代表公共入口：Bundle 会把它的内部 WebServer 固定为 127.0.0.1:0，公共监听由上表配置。
DSH_AUTH_CAPTCHA_MODE 是账号尚未在 Web 页面保存验证码策略时的初始默认值。一旦从“设置 → 账号与安全”保存，选择结果会写入认证状态并在后续重启时优先生效。
deepseek-harness-auth/center 提供 ctx.authCenter 和 provider registry；deepseek-harness-auth/password 是当前内置 provider。每种未来认证方式可以作为独立 Cordis row 注册并通过 profile patch 单独挂载、禁用或替换，不需要修改 Auth Proxy。
登录所需的 /auth/login 与 /auth/captcha 是未认证公共端点。其余请求未命中 IP 白名单且没有有效会话时统一拒绝；HTML navigation 重定向到登录页，API 返回 401，WebSocket upgrade 返回 401。
认证后的客户端还使用以下同源端点：
GET /auth/account：返回账号会话或 IP 白名单访问方式。PUT /auth/account/captcha：把登录验证码设为 off、after-failures 或 always；账号会话或已命中白名单的访问者均可调用。PUT /auth/account/whitelist：替换内置 provider 的 IP/CIDR 白名单；账号会话或已命中白名单的访问者均可调用，修改后撤销旧会话。POST /auth/account/password：验证当前密码并修改新密码，成功后撤销全部会话；只接受账号会话和带 X-DSH-Auth-Request: 1 的 JSON 请求。POST /auth/logout：撤销当前会话并清理 Cookie。登录页本身不能在未认证前读取 Harness 的受保护设置，因此任意第三方皮肤只能在该浏览器至少成功进入过一次 Harness 后同步到后续登录页；这不会为了主题展示而开放 Harness API。
corepack enable
pnpm install
pnpm run check
测试覆盖密码状态、权限、Web 密码修改、IP/CIDR、验证码、失败锁定、会话撤销、白名单热更新、登录主题脚本、客户端 Bundle、HTTP 代理、Host 改写和 upgrade 拒绝。
版本以 package.json#version 为唯一来源，遵循 SemVer：
pnpm version patch # 或 minor / major
git push origin main
.github/workflows/publish.yml 只在 main 上检测到版本变化时尝试发布。它会先执行完整检查并查询 npm；相同版本已存在时安全跳过。仓库尚未配置 NPM_TOKEN 时也会成功跳过发布，不会阻塞主分支。配置 secret 后，可手动运行一次 Publish npm workflow 发布当前尚未存在的版本；后续版本变化会自动发布并创建对应 Git tag 与 GitHub Release。
需要的仓库 secret：
NPM_TOKEN：对 deepseek-harness-auth 具有 publish 权限的 npm automation/access token。This project is licensed under the Apache-2.0 open-source license.